# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ston.fi/developer-section/omniston/glossary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.