> For the complete documentation index, see [llms.txt](https://ston-fi.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ston-fi.gitbook.io/docs/developer-section/omniston/glossary.md).

# Omniston Glossary

This glossary defines the key terms used throughout the Omniston protocol, including its documentation, SDKs, and resolver integrations.

## Actors

* **Trader** — protocol participant that requests quotes, creates swaps or orders, and provides the **Input asset**.
* **Resolver** — protocol participant that provides quotes and settles trades by delivering the **Output asset**.
* **Protocol** — the Omniston system, including its API, routing logic, and settlement contracts.
* **Integrator** — external application or partner that brings flow into the protocol and may receive an integrator fee.

## Assets

* **Input asset** — asset provided by the **Trader** to start a trade.
* **Input amount** — amount of the **Input asset** involved in a quote and a trade.
* **Output asset** — asset the **Trader** expects to receive as the result of a trade.
* **Output amount** — amount of the **Output asset** involved in a quote and a trade.
* **Source blockchain** — blockchain on which the **Input asset** is provided and the trade is initiated.
* **Destination blockchain** — blockchain on which the **Output asset** is delivered to the **Trader**.

## RFQ Protocol

* **RFQ** — request for quote sent by the **Trader** to ask resolvers for trade terms.
* **Quote** — resolver-specific offer that defines trade amounts, fees, and settlement data for a given **RFQ**.
* **Swap settlement** — settlement mode in which the trade is executed immediately through one or more swap routes.
* **Order settlement** — settlement mode in which the trade is represented as an order or position that can be filled by a **Resolver**.

## Swap settlement

* **Swap route** — complete path used to convert the **Input asset** into the **Output asset**.
* **Swap step** — one asset-to-asset conversion inside a **Swap route**.
* **Swap chunk** — the smallest executable part of a **Swap step**, typically bound to a specific liquidity source or protocol.

## Order settlement

* **Order** — trade object created from a quote and exposed for filling, fully or partially, by one or more resolvers.
* **Signed Order** — blockchain-specific signed payload that authorizes settlement without first depositing funds into an escrow position.
* **Order details** — off-chain structure whose hash is embedded into settlement transactions to verify the trade intent.
* **Execution** — individual fill attempt or fill fragment within an **Order**.
* **Input position** — position on the **Source blockchain** that holds or represents the **Input asset** for an **Execution**.
* **Output position** — position on the **Destination blockchain** that holds or represents the **Output asset** for an **Execution**.

## Contracts

* **Protocol contract** — smart contract used by the protocol to enforce settlement rules on a blockchain.
* **Escrow factory contract** — contract that creates or manages escrow positions for **Order settlement**.
* **Escrow position contract** — contract instance that stores the assets and state of a particular escrow-backed position.
* **Vault contract** — contract that stores the funds of participants for later use in settlement flows.

## Operations

* **Order cancellation** — operation by which the **Trader** stops an **Order** and withdraws the remaining funds from the **Escrow position**.
* **Execution completion** — successful finalization of an **Execution**, in which the exchange is completed according to protocol rules.
* **Execution rollback** — unsuccessful finalization of an **Execution**, in which assets are returned according to protocol rules.
