The contract should emit versioned events such as settlement created, funded, claim enabled, claimed, refund initiated, refunded, disputed, and resolved. An indexer must store ledger/transaction identity, event position, contract ID, network, event version, payload, and ingestion checkpoint so replay is deterministic.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Oynk","description":"Oynk cross-border settlement architecture, product capabilities, blockchain indexing, and Stellar/Soroban roadmap.","colors":{"primary":"#DB5D73","light":"#F08A9C","dark":"#A83E55"},"logo":{"light":"https://mintcdn.com/oynk/jJ_LQfIAzbrNx5fj/logo/light.svg?fit=max\u0026auto=format\u0026n=jJ_LQfIAzbrNx5fj\u0026q=85\u0026s=d959e6ee01662b552bc1a6a138cfbc08","dark":"https://mintcdn.com/oynk/jJ_LQfIAzbrNx5fj/logo/dark.svg?fit=max\u0026auto=format\u0026n=jJ_LQfIAzbrNx5fj\u0026q=85\u0026s=88e5c1705a98b6c88f2ec4c26ef34a1e","href":"https://oynk.io"},"favicon":"https://mintcdn.com/oynk/jJ_LQfIAzbrNx5fj/logo/favicon.svg?fit=max\u0026auto=format\u0026n=jJ_LQfIAzbrNx5fj\u0026q=85\u0026s=2c74016638f50eb99a03a8eb14ba0ae6","api":{"playground":{"display":"none"}},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://oynk.io/dashboard","label":"Activity dashboard"},{"href":"https://console.oynk.io","label":"Operations console"}],"primary":{"type":"button","label":"Visit Oynk","href":"https://oynk.io"}},"footer":{"socials":{"website":"https://oynk.io"},"links":[{"header":"Product","items":[{"label":"Oynk","href":"https://oynk.io"},{"label":"Console","href":"https://console.oynk.io"}]},{"header":"Documentation","items":[{"label":"Full technical architecture","href":"/full-technical-architecture"},{"label":"Stellar \u0026 Soroban","href":"/stellar-soroban/overview"},{"label":"Operations","href":"/operations/runbook"}]}]},"seo":{"indexing":"all"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"oynk","hasAudioNarration":false,"actualSubdomain":"oynk","customDomains":["docs.oynk.io"],"gitSource":{"type":"github","owner":"oynk-io","repo":"oynk-platform","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af35af3a8a50bb95e4f363e","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Documentation","count":32},{"language":"default","tag":"HTTP Reference","count":9},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Stellar \u0026 Soroban","count":5},{"language":"default","tag":"Architecture","count":4},{"language":"default","tag":"How Oynk works","count":4},{"language":"default","tag":"Start here","count":4},{"language":"default","tag":"Indexing \u0026 analytics","count":4},{"language":"default","tag":"Operate Oynk","count":4},{"language":"default","tag":"Platform","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"stellar-soroban/settlement-contract","slug":"/stellar-soroban/settlement-contract","pageMetadata":{"title":"Settlement contract design","description":"A proposed Soroban settlement state machine, records, transitions, and events.","icon":"file-code-2","href":"/stellar-soroban/settlement-contract"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"A proposed Soroban settlement state machine, records, transitions, and events.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Mermaid,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:`No contract implementation or audit exists yet. The structures below are requirements for specification and review, not an ABI.`}),`\n`,_jsx(Heading,{level:`2`,id:`proposed-state-machine`,children:`Proposed state machine`}),`\n`,_jsx(Mermaid,{chart:`stateDiagram-v2\n [*] --> Created\n Created --> Funded: eligible asset committed\n Created --> Cancelled: requester cancels before funding\n Funded --> Claimable: off-chain policy authorizes destination claim\n Funded --> Refunding: deadline/cancellation policy\n Funded --> Disputed: authorized dispute\n Claimable --> Claimed: destination provider claims\n Claimable --> Disputed: claim challenged before final window\n Refunding --> Refunded: origin refund succeeds\n Disputed --> Claimed: resolution awards destination\n Disputed --> Refunded: resolution awards origin\n Claimed --> [*]\n Refunded --> [*]\n Cancelled --> [*]`}),`\n`,_jsx(Heading,{level:`2`,id:`minimum-settlement-record`,children:`Minimum settlement record`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`settlement_id`})}),_jsx(_components.td,{children:`Stable, non-personal identifier shared with the control plane`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`asset`}),` and `,_jsx(_components.code,{children:`amount`})]}),_jsx(_components.td,{children:`Exact Stellar asset and committed integer amount`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`origin`}),` / `,_jsx(_components.code,{children:`destination`})]}),_jsx(_components.td,{children:`Authorized account or contract addresses`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`created_at`}),`, `,_jsx(_components.code,{children:`fund_by`}),`, `,_jsx(_components.code,{children:`claim_by`})]}),_jsx(_components.td,{children:`Ledger-aware deadlines with explicit semantics`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`route_commitment`})}),_jsx(_components.td,{children:`Hash/reference to versioned off-chain route terms`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`evidence_commitment`})}),_jsx(_components.td,{children:`Optional privacy-preserving commitment to evidence`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`state`})}),_jsx(_components.td,{children:`Current enumerated lifecycle state`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`authorization policy`})}),_jsx(_components.td,{children:`Which principals may fund, authorize, claim, cancel, refund, dispute, or resolve`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`transition-invariants`,children:`Transition invariants`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A settlement ID is unique and cannot be reused with different terms.`}),`\n`,_jsx(_components.li,{children:`Funding accepts only the configured asset and exact allowed amount.`}),`\n`,_jsx(_components.li,{children:`Claim and refund are mutually exclusive terminal outcomes.`}),`\n`,_jsx(_components.li,{children:`Deadlines are checked against ledger time under documented tolerances.`}),`\n`,_jsx(_components.li,{children:`Every state transition verifies the necessary Soroban authorization entries.`}),`\n`,_jsx(_components.li,{children:`Repeated submissions are idempotent or reject without changing value.`}),`\n`,_jsx(_components.li,{children:`Events contain stable IDs and state, but no names, phone numbers, bank data, or raw compliance evidence.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`events`,children:`Events`}),`\n`,_jsx(_components.p,{children:`The contract should emit versioned events such as settlement created, funded, claim enabled, claimed, refund initiated, refunded, disputed, and resolved. An indexer must store ledger/transaction identity, event position, contract ID, network, event version, payload, and ingestion checkpoint so replay is deterministic.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Settlement contract design","description":"A proposed Soroban settlement state machine, records, transitions, and events.","icon":"file-code-2","href":"/stellar-soroban/settlement-contract"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Proposed state machine","slug":"proposed-state-machine","depth":2,"children":[]},{"title":"Minimum settlement record","slug":"minimum-settlement-record","depth":2,"children":[]},{"title":"Transition invariants","slug":"transition-invariants","depth":2,"children":[]},{"title":"Events","slug":"events","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"oynk","siteName":"Oynk","title":"Settlement contract design - Oynk","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-13T01:00:21.514Z","originalFileLocation":"stellar-soroban/settlement-contract.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"A proposed Soroban settlement state machine, records, transitions, and events.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Oynk\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Settlement contract design - Oynk\">\u003cmeta data-mint-head property=\"og:description\" content=\"A proposed Soroban settlement state machine, records, transitions, and events.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Oynk\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.oynk.io/stellar-soroban/settlement-contract\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://oynk.mintlify.site/_mintlify/api/og/v2?division=Stellar+%26+Soroban\u0026amp;title=Settlement+contract+design\u0026amp;description=A+proposed+Soroban+settlement+state+machine%2C+records%2C+transitions%2C+and+events.\u0026amp;theme=0c8d0a8083cc74509e31a49e\u0026amp;signature=93a092cbae99f3802c993b7696368f8a36d36969f2c6ee10dd9a69719dfa0eb1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Settlement contract design - Oynk\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A proposed Soroban settlement state machine, records, transitions, and events.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://oynk.mintlify.site/_mintlify/api/og/v2?division=Stellar+%26+Soroban\u0026amp;title=Settlement+contract+design\u0026amp;description=A+proposed+Soroban+settlement+state+machine%2C+records%2C+transitions%2C+and+events.\u0026amp;theme=0c8d0a8083cc74509e31a49e\u0026amp;signature=93a092cbae99f3802c993b7696368f8a36d36969f2c6ee10dd9a69719dfa0eb1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/oynk/q5vqh4uOKstRNIGK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Oynk\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DB5D73\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.oynk.io/stellar-soroban/settlement-contract\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/stellar-soroban/settlement-contract.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.oynk.io/#organization\",\"name\":\"Oynk\",\"url\":\"https://docs.oynk.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/oynk/jJ_LQfIAzbrNx5fj/logo/light.svg?fit=max\u0026auto=format\u0026n=jJ_LQfIAzbrNx5fj\u0026q=85\u0026s=d959e6ee01662b552bc1a6a138cfbc08\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.oynk.io#website\",\"name\":\"Oynk\",\"url\":\"https://docs.oynk.io\",\"publisher\":{\"@id\":\"https://docs.oynk.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.oynk.io/stellar-soroban/settlement-contract#webpage\",\"url\":\"https://docs.oynk.io/stellar-soroban/settlement-contract\",\"name\":\"Settlement contract design\",\"description\":\"A proposed Soroban settlement state machine, records, transitions, and events.\",\"dateModified\":\"2026-08-13T01:00:21.514Z\",\"isPartOf\":{\"@id\":\"https://docs.oynk.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.oynk.io/stellar-soroban/settlement-contract#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.oynk.io/stellar-soroban/settlement-contract#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Stellar \u0026 Soroban\",\"item\":\"https://docs.oynk.io/stellar-soroban/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Settlement contract design\",\"item\":\"https://docs.oynk.io/stellar-soroban/settlement-contract\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.oynk.io/stellar-soroban/settlement-contract#article\",\"headline\":\"Settlement contract design\",\"name\":\"Settlement contract design\",\"description\":\"A proposed Soroban settlement state machine, records, transitions, and events.\",\"url\":\"https://docs.oynk.io/stellar-soroban/settlement-contract\",\"mainEntityOfPage\":{\"@id\":\"https://docs.oynk.io/stellar-soroban/settlement-contract#webpage\"},\"dateModified\":\"2026-08-13T01:00:21.514Z\",\"publisher\":{\"@id\":\"https://docs.oynk.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.oynk.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Oynk\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Oynk\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/stellar-soroban/settlement-contract.md","siteName":"Oynk","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Start here","pages":[{"title":"Oynk documentation","icon":"network","href":""},{"title":"Current implementation status","icon":"circle-check-big","href":"/get-started/current-status"},{"title":"Quickstart","icon":"rocket","href":"/get-started/quickstart"},{"title":"Glossary","icon":"book-a","href":"/get-started/glossary"}]},{"group":"How Oynk works","pages":[{"title":"How Oynk works","icon":"waypoints","href":"/concepts/overview"},{"title":"Participants and responsibilities","icon":"users-round","href":"/concepts/participants"},{"title":"Payment lifecycle","icon":"route","href":"/concepts/payment-lifecycle"},{"title":"Value and metric semantics","icon":"chart-no-axes-combined","href":"/concepts/value-and-metrics"}]},{"group":"Architecture","pages":[{"title":"Oynk full technical architecture","mode":"wide","href":"/full-technical-architecture"},{"title":"System design","icon":"boxes","href":"/architecture/system-design"},{"title":"Trust boundaries","icon":"shield-check","href":"/architecture/trust-boundaries"},{"title":"Data model","icon":"database","href":"/architecture/data-model"}]},{"group":"Stellar \u0026 Soroban","pages":[{"title":"Stellar and Soroban architecture","description":"Why Oynk targets Stellar/Soroban and how it fits into the broader cross-border settlement system.","icon":"sparkles","href":"/stellar-soroban/overview"},{"title":"Settlement contract design","icon":"file-code-2","href":"/stellar-soroban/settlement-contract"},{"title":"Smart accounts and authorization","description":"The planned Soroban smart-account boundary for passkeys, delegates, spending limits, nonces, and recovery.","icon":"key-round","href":"/stellar-soroban/smart-accounts"},{"title":"Stellar asset and payment model","icon":"coins","href":"/stellar-soroban/asset-and-payment-model"},{"title":"Soroban security and operations","icon":"shield-alert","href":"/stellar-soroban/security"}]},{"group":"Platform","pages":[{"title":"Accounts and access","icon":"user-round-check","href":"/platform/accounts-and-access"},{"title":"Compliance architecture","icon":"badge-check","href":"/platform/compliance"},{"title":"Provider network","icon":"landmark","href":"/platform/provider-network"},{"title":"Operations console","icon":"layout-dashboard","href":"/platform/operations-console"}]},{"group":"Indexing \u0026 analytics","pages":[{"title":"Indexing pipeline","icon":"scan-search","href":"/infrastructure/indexing"},{"title":"BNB Smart Chain indexing","icon":"blocks","href":"/infrastructure/bsc"},{"title":"Solana indexing","icon":"waves","href":"/infrastructure/solana"},{"title":"Reliability and observability","icon":"heart-pulse","href":"/infrastructure/reliability"}]},{"group":"Operate Oynk","pages":[{"title":"Configuration","icon":"settings-2","href":"/operations/configuration"},{"title":"Operations runbook","icon":"clipboard-list","href":"/operations/runbook"},{"title":"Deployment","icon":"cloud","href":"/operations/deployment"},{"title":"Production readiness","icon":"list-checks","href":"/operations/production-readiness"}]},{"group":"Reference","pages":[{"title":"HTTP API overview","icon":"braces","href":"/reference/http-api"},{"title":"Repository map","icon":"folder-tree","href":"/reference/repository"},{"title":"Roadmap","icon":"milestone","href":"/reference/roadmap"}]}]},{"tab":"HTTP Reference","icon":"square-terminal","pages":[{"title":"HTTP Reference","href":"/api-reference/get-aggregate-settlement-metrics-timeline-and-recent-transactions"}]}]},"basePath":"","title":"Settlement contract design - Oynk","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}