Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.keystoneos.xyz/llms.txt

Use this file to discover all available pages before exploring further.

What KeyStone does

KeyStone coordinates bilateral atomic settlement between institutions on different platforms and chains. One integration, every counterparty, any chain. Both counterparties submit settlement instructions independently via KeyStone’s REST API. KeyStone matches the instructions, runs compliance, and creates a settlement on-chain. From there, smart contracts handle everything autonomously - deposits, atomic execution, and finalization.
  • Bilateral atomic DvP - Delivery vs. Payment: both sides of a trade (the asset delivery and the payment) settle simultaneously, or neither does. No partial execution.
  • Cross-platform - Platform A’s seller and Platform B’s buyer in a single atomic settlement.
  • Cross-chain - Bond on Ethereum, USDC on Avalanche. Assets never bridge. LayerZero coordinates.
  • Autonomous post-compliance - After compliance clears, contracts handle deposits, execution, and finalization.
  • No custody - KeyStone never holds funds. Escrow contracts have no admin keys.

Architecture overview

Key concepts

ConceptDescription
SettlementA coordinated bilateral transaction between parties, enforced by on-chain contracts.
TemplateA reusable definition of a settlement workflow: states, transitions, gates, and roles.
PartyAn entity in a settlement with a specific role (buyer, seller). Details provided inline.
LegA single obligation within a settlement (asset delivery, payment).
InstructionOne side of a trade, submitted via the API. Two matching instructions create a settlement.

Next: Quickstart

Get your first settlement running in minutes.