Omniston Glossary

Definitions of Omniston terms and roles.

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.

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

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.

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.

Last updated 3 months ago