Simulates the input, checks the wallet’s limits, then runs the judge against the wallet’s mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chance","description":"An AI harness for your money. Set up a Desk, connect your apps and wallets, and use crypto privately on Starknet.","colors":{"primary":"#0A01BD","light":"#0A01BD","dark":"#171717"},"logo":{"light":"https://mintcdn.com/chance/HYb9hteNOAOTB9WR/logo/light.png?fit=max\u0026auto=format\u0026n=HYb9hteNOAOTB9WR\u0026q=85\u0026s=4fd2723a7219bca29fde003c3c8ffb8c","dark":"https://mintcdn.com/chance/HYb9hteNOAOTB9WR/logo/dark.png?fit=max\u0026auto=format\u0026n=HYb9hteNOAOTB9WR\u0026q=85\u0026s=fc2255c6e35c4307126736f6b3667ab2","href":"https://docs.chance.cc"},"favicon":"https://mintcdn.com/chance/pGTENfLnNqMF6Oyr/favicon.png?fit=max\u0026auto=format\u0026n=pGTENfLnNqMF6Oyr\u0026q=85\u0026s=a57496ae2539ec1db9487d424374eeae","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#F5F5F5","dark":"#171717"}},"footer":{"socials":{"website":"https://chance.cc"}},"fonts":{"family":"Geist"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chance","hasAudioNarration":false,"actualSubdomain":"chance","customDomains":["docs.chance.cc"],"gitSource":{"type":"github","owner":"kryptopaul","repo":"chance-harness","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae9f35e05f836676fde9832","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"Chance Verification","count":48},{"language":"default","tag":"Payload adapters","count":18},{"language":"default","tag":"Use Chance","count":17},{"language":"default","tag":"HTTP endpoints","count":17},{"language":"default","tag":"Trading","count":9},{"language":"default","tag":"Wallets and payments","count":8},{"language":"default","tag":"Integrate","count":7},{"language":"default","tag":"Your Desk","count":7},{"language":"default","tag":"Chance verification","count":6},{"language":"default","tag":"Escrow wallets","count":6}]},"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":"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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--chance-ink: #171717;--chance-muted: #696969;--chance-page: #f5f5f5;--chance-white: #fff;--chance-blue: #0a01bd}body{font-feature-settings:\"cv03\", \"cv04\", \"cv09\", \"cv11\"}#page-title{color:var(--chance-ink);font-weight:600;letter-spacing:-0.035em;line-height:1.12}#content-area{--tw-prose-body: #3f3f3f;--tw-prose-headings: var(--chance-ink);--tw-prose-links: var(--chance-ink)}#content-area h2,#content-area h3{letter-spacing:-0.025em}#content-area a:not(.card):not(.chance-button){text-decoration-color:#a3a3a3;text-underline-offset:3px}#content-area .card{background:var(--chance-white);border:0;border-radius:26px;box-shadow:none;transition:background-color 140ms ease}#content-area .card:hover{background:#ededed}#content-area .card h2,#content-area .card h3{color:var(--chance-ink)}#content-area blockquote{background:var(--chance-white);border:0;border-radius:20px;padding:16px 22px;font-style:normal;color:var(--chance-ink)}#content-area blockquote p{margin:0}.chance-intro{display:flex;align-items:center;gap:28px;margin:24px 0 32px;padding:28px;background:var(--chance-white);border-radius:26px}.chance-intro>div{flex:1;min-width:0}.chance-intro p{margin:0 0 22px;font-size:18px;line-height:1.6}.chance-intro img{flex:0 0 176px;width:176px;height:176px;object-fit:contain;margin:0}.chance-intro-compact img{flex-basis:128px;width:128px;height:128px}.chance-intro-compact p{margin:0}#content-area .chance-button{display:inline-flex;align-items:center;justify-content:center;gap:16px;min-height:48px;padding:12px 22px;border-radius:999px;background:var(--chance-ink);color:var(--chance-white);font-size:16px;font-weight:550;text-decoration:none;white-space:nowrap;transition:background-color 140ms ease}#content-area .chance-button:hover{background:#303030}a:focus-visible,button:focus-visible{outline:2px solid var(--chance-ink);outline-offset:4px}.chance-requests{display:grid;gap:8px;margin:20px 0}.chance-requests p{margin:0;padding:14px 20px;border-radius:20px;background:var(--chance-white)}@media (max-width: 640px){.chance-intro{gap:16px;padding:22px;flex-direction:column-reverse;align-items:flex-start}.chance-intro img{flex:0 0 auto;width:112px;height:112px;align-self:center}.chance-intro p{font-size:17px}.chance-intro-compact{flex-direction:row}.chance-intro-compact img{width:80px;height:80px}.chance-intro-compact p{font-size:16px}}@media (prefers-reduced-motion: reduce){#content-area .card,#content-area .chance-button{transition:none}}#sidebar a[aria-current=\"page\"]{color:var(--chance-ink);background:var(--chance-white);border-radius:999px}"}],"page":{"pagePath":"api-reference/escrow-wallets/propose-a-transaction","slug":"/api-reference/escrow-wallets/propose-a-transaction","pageMetadata":{"title":"Propose a transaction","description":"Simulates the input, checks the wallet's limits, then runs the judge against the wallet's mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at `approvalUrl`. One credit when the judge runs; a proposal the limits block first is free.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/wallets/{id}/propose","href":"/api-reference/escrow-wallets/propose-a-transaction","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Simulates the input, checks the wallet’s limits, then runs the judge against the wallet’s mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at \", _jsx(_components.code, {\n children: \"approvalUrl\"\n }), \". One credit when the judge runs; a proposal the limits block first is free.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Propose a transaction","description":"Simulates the input, checks the wallet's limits, then runs the judge against the wallet's mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at `approvalUrl`. One credit when the judge runs; a proposal the limits block first is free.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/wallets/{id}/propose","href":"/api-reference/escrow-wallets/propose-a-transaction","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Escrow wallets"],"summary":"Propose a transaction","operationId":"proposeTransaction","description":"Simulates the input, checks the wallet's limits, then runs the judge against the wallet's mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at `approvalUrl`. One credit when the judge runs; a proposal the limits block first is free.","parameters":["16b888a5-5e97-4d54-88d4-f1e4fad31661"],"requestBody":"6388a8e4-04ce-4b01-a324-111e623fb0c6","responses":{"200":"ac4bb1a1-5d93-4733-8398-ce82612f6713","400":"99c3945b-9191-4917-8beb-5f8ae1ece775","401":"f3d43ebd-2fb5-4903-a8ee-1fa83c322f7d","402":"b2d10648-0d72-4ce7-975e-b45277c84502","404":"c4b03342-ae4f-4e3a-875d-600371ea2c2a","409":"31bf3ac3-f9fc-49d0-80db-ab83f2b3f926","500":"478a0758-4c7e-49c1-94c2-9cd682d018eb","502":"4f4eb2b8-5ccf-4a5b-aeb0-9afffb5444af"},"method":"post","type":"path","servers":["bfc22b5f-4ee3-4412-99b3-fdfde594f00f"],"security":["a4f688e3-d96d-45f1-bc7a-66801e7ff5c4","2902b8e5-cca2-4322-8bd2-bd6c6f3ad015"],"path":"/api/v1/wallets/{id}/propose","baseUrlOptions":["https://harness.chance.cc"],"title":"Propose a transaction","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"16b888a5-5e97-4d54-88d4-f1e4fad31661":{"name":"id","in":"path","required":true,"description":"The wallet's id (UUID) or its name.","schema":{"type":"string","isRequired":true,"description":"The wallet's id (UUID) or its name.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"oneOf":[{"type":"object","description":"One proposal. Send `caip2` or `chain`. `x402_payment` is refused here.","required":["kind","transaction"],"properties":{"kind":{"type":"string","enum":["evm_transaction"],"isRequired":true,"uniqueKey":"input.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"transaction":{"type":"object","additionalProperties":true,"description":"`{to, value?, data?}`. `from`, if sent, must be the wallet. `value` may be decimal or hex. Fee fields above 1 ETH are refused.","isRequired":true,"uniqueKey":"input.oneOf.0.transaction","typeLabel":"object"},"caip2":{"type":"string","enum":["eip155:1","eip155:8453","eip155:42161","eip155:10","eip155:137","eip155:4663","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","starknet:SN_MAIN"],"description":"Target network. Must match the wallet family; EVM wallets support the listed EVM networks.","uniqueKey":"input.oneOf.0.caip2","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","robinhood","solana","starknet"],"description":"Alternative to `caip2`.","uniqueKey":"input.oneOf.0.chain","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"input.oneOf.0","typeLabel":"object"},{"type":"object","description":"One proposal. Send `caip2` or `chain`. `x402_payment` is refused here.","required":["kind","calls"],"properties":{"kind":{"type":"string","enum":["evm_calls"],"isRequired":true,"uniqueKey":"input.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"calls":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"uniqueKey":"input.oneOf.1.calls.items.[INDEX]","typeLabel":"object"},"description":"Batch of `{to, value?, data?}` executed together.","isRequired":true,"uniqueKey":"input.oneOf.1.calls","typeLabel":"object[]"},"caip2":{"type":"string","enum":["eip155:1","eip155:8453","eip155:42161","eip155:10","eip155:137","eip155:4663","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","starknet:SN_MAIN"],"description":"Target network. Must match the wallet family; EVM wallets support the listed EVM networks.","uniqueKey":"input.oneOf.1.caip2","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","robinhood","solana","starknet"],"description":"Alternative to `caip2`.","uniqueKey":"input.oneOf.1.chain","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"input.oneOf.1","typeLabel":"object"},{"type":"object","description":"One proposal. Send `caip2` or `chain`. `x402_payment` is refused here.","required":["kind","transaction"],"properties":{"kind":{"type":"string","enum":["solana_transaction"],"isRequired":true,"uniqueKey":"input.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"transaction":{"type":"string","description":"Base64 serialized Solana transaction.","isRequired":true,"uniqueKey":"input.oneOf.2.transaction","typeLabel":"string"},"caip2":{"type":"string","enum":["eip155:1","eip155:8453","eip155:42161","eip155:10","eip155:137","eip155:4663","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","starknet:SN_MAIN"],"description":"Target network. Must match the wallet family; EVM wallets support the listed EVM networks.","uniqueKey":"input.oneOf.2.caip2","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","robinhood","solana","starknet"],"description":"Alternative to `caip2`.","uniqueKey":"input.oneOf.2.chain","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"input.oneOf.2","typeLabel":"object"},{"type":"object","description":"One proposal. Send `caip2` or `chain`. `x402_payment` is refused here.","required":["kind","calls"],"properties":{"kind":{"type":"string","enum":["starknet_calls"],"isRequired":true,"uniqueKey":"input.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"calls":{"type":"array","minItems":1,"items":{"type":"object","required":["contractAddress","entrypoint"],"properties":{"contractAddress":{"type":"string","isRequired":true,"uniqueKey":"input.oneOf.3.calls.items.[INDEX].contractAddress","typeLabel":"string"},"entrypoint":{"type":"string","isRequired":true,"uniqueKey":"input.oneOf.3.calls.items.[INDEX].entrypoint","typeLabel":"string"},"calldata":{"type":"array","items":{"type":"string","uniqueKey":"input.oneOf.3.calls.items.[INDEX].calldata.items.[INDEX]","typeLabel":"string"},"description":"Felts as 0x hex or decimal strings.","uniqueKey":"input.oneOf.3.calls.items.[INDEX].calldata","typeLabel":"string[]"}},"uniqueKey":"input.oneOf.3.calls.items.[INDEX]","typeLabel":"object"},"description":"Executed as one multicall.","isRequired":true,"uniqueKey":"input.oneOf.3.calls","typeLabel":"object[]"},"caip2":{"type":"string","enum":["eip155:1","eip155:8453","eip155:42161","eip155:10","eip155:137","eip155:4663","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","starknet:SN_MAIN"],"description":"Target network. Must match the wallet family; EVM wallets support the listed EVM networks.","uniqueKey":"input.oneOf.3.caip2","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","robinhood","solana","starknet"],"description":"Alternative to `caip2`.","uniqueKey":"input.oneOf.3.chain","typeLabel":"enum\u003cstring>"},"proof":{"type":"object","required":["facts","data"],"description":"STRK20 proof, only for calls to the privacy pool's `apply_actions`. Not stored and not part of `requestHash`.","properties":{"facts":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","uniqueKey":"input.oneOf.3.proof.facts.items.[INDEX]","typeLabel":"string"},"description":"Hex felts.","isRequired":true,"uniqueKey":"input.oneOf.3.proof.facts","typeLabel":"string[]"},"data":{"type":"string","description":"Base64 proof, under 4 MB.","isRequired":true,"uniqueKey":"input.oneOf.3.proof.data","typeLabel":"string"}},"uniqueKey":"input.oneOf.3.proof","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.3","typeLabel":"object"},{"type":"object","description":"One proposal. Send `caip2` or `chain`. `x402_payment` is refused here.","required":["kind","transfer"],"properties":{"kind":{"type":"string","enum":["transfer"],"isRequired":true,"uniqueKey":"input.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"transfer":{"type":"object","required":["asset","amount","to"],"properties":{"asset":{"type":"string","description":"Symbol, for example `USDC`. On Starknet: STRK, ETH, USDC or USDT.","isRequired":true,"uniqueKey":"input.oneOf.4.transfer.asset","typeLabel":"string"},"amount":{"type":"string","description":"Plain decimal in whole token units, greater than zero, for example `\"1.5\"`.","isRequired":true,"uniqueKey":"input.oneOf.4.transfer.amount","typeLabel":"string"},"to":{"type":"string","description":"Recipient address.","isRequired":true,"uniqueKey":"input.oneOf.4.transfer.to","typeLabel":"string"}},"isRequired":true,"uniqueKey":"input.oneOf.4.transfer","typeLabel":"object"},"caip2":{"type":"string","enum":["eip155:1","eip155:8453","eip155:42161","eip155:10","eip155:137","eip155:4663","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","starknet:SN_MAIN"],"description":"Target network. Must match the wallet family; EVM wallets support the listed EVM networks.","uniqueKey":"input.oneOf.4.caip2","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","robinhood","solana","starknet"],"description":"Alternative to `caip2`.","uniqueKey":"input.oneOf.4.chain","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"input.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"input","typeLabel":"object"},"note":{"type":"string","description":"Context for the judge, treated as untrusted narration. Cut at 2,000 characters.","uniqueKey":"note","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"transfer":{"title":"transfer","value":{"input":{"kind":"transfer","chain":"base","transfer":{"asset":"USDC","amount":"25","to":"0x1111111111111111111111111111111111111111"}},"note":"Monthly payment to the design contractor."}},"evm_transaction":{"title":"evm_transaction","value":{"input":{"kind":"evm_transaction","caip2":"eip155:8453","transaction":{"to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","value":"0","data":"0xa9059cbb000000000000000000000000111111111111111111111111111111111111111100000000000000000000000000000000000000000000000000000000017d7840"}}}},"evm_calls":{"title":"evm_calls","value":{"input":{"kind":"evm_calls","chain":"base","calls":[{"to":"0x…","data":"0x…"},{"to":"0x…","data":"0x…"}]}}},"solana_transaction":{"title":"solana_transaction","value":{"input":{"kind":"solana_transaction","chain":"solana","transaction":"AQAAAA…"}}},"starknet_calls":{"title":"starknet_calls","value":{"input":{"kind":"starknet_calls","chain":"starknet","calls":[{"contractAddress":"0x…","entrypoint":"transfer","calldata":["0x…","1000000","0"]}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ac4bb1a1-5d93-4733-8398-ce82612f6713":{"description":"The proposal outcome.","content":{"application/json":{"schema":{"type":"object","properties":{"txId":{"type":"string","description":"Escrow transaction id. Poll it at `/api/v1/escrow-transactions/{id}`.","uniqueKey":"txId","typeLabel":"string"},"status":{"type":"string","enum":["blocked","awaiting_user","executing","executed","failed"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"verdict":{"oneOf":[{"type":"string","description":"ALLOW, BLOCK or ESCALATE. `BLOCK` without a `scanId` means the wallet's limits refused it before the judge ran.","uniqueKey":"verdict.oneOf.0","typeLabel":"string"},{"type":"null","description":"ALLOW, BLOCK or ESCALATE. `BLOCK` without a `scanId` means the wallet's limits refused it before the judge ran.","uniqueKey":"verdict.oneOf.1","typeLabel":"null"}],"uniqueKey":"verdict","typeLabel":"string | null"},"reasoning":{"oneOf":[{"type":"string","uniqueKey":"reasoning.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reasoning.oneOf.1","typeLabel":"null"}],"uniqueKey":"reasoning","typeLabel":"string | null"},"requestHash":{"type":"string","description":"Hash of the canonical payload the wallet will sign. Execution recomputes it and refuses on a mismatch.","uniqueKey":"requestHash","typeLabel":"string"},"simulation":{"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"simulation.oneOf.0.ok","typeLabel":"boolean"},"status":{"type":"string","enum":["clean","reverted","unavailable"],"description":"Only `clean` can execute without the owner.","uniqueKey":"simulation.oneOf.0.status","typeLabel":"enum\u003cstring>"},"declared":{"type":"boolean","description":"True when the effects come from a named transfer rather than a trace.","uniqueKey":"simulation.oneOf.0.declared","typeLabel":"boolean"},"wouldRevert":{"oneOf":[{"type":"boolean","uniqueKey":"simulation.oneOf.0.wouldRevert.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"simulation.oneOf.0.wouldRevert.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.wouldRevert","typeLabel":"boolean | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.error","typeLabel":"string | null"},"caip2":{"type":"string","uniqueKey":"simulation.oneOf.0.caip2","typeLabel":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"direction":{"type":"string","enum":["in","out"],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].direction","typeLabel":"enum\u003cstring>"},"assetType":{"type":"string","enum":["native","erc20","erc721","erc1155","spl"],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].assetType","typeLabel":"enum\u003cstring>"},"changeType":{"oneOf":[{"type":"string","enum":["transfer","approve",null],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].changeType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["transfer","approve",null],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].changeType.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].changeType","typeLabel":"enum\u003cstring> | null"},"symbol":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].symbol.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].symbol","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].name","typeLabel":"string | null"},"contractAddress":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].contractAddress.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].contractAddress.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].contractAddress","typeLabel":"string | null"},"rawAmount":{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].rawAmount","typeLabel":"string"},"decimals":{"oneOf":[{"type":"integer","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].decimals.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].decimals.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].decimals","typeLabel":"integer | null"},"amount":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].amount.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].amount","typeLabel":"string | null"},"usdValue":{"oneOf":[{"type":"number","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].usdValue.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].usdValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].usdValue","typeLabel":"number | null"},"counterparty":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].counterparty.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].counterparty.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].counterparty","typeLabel":"string | null"},"logoUrl":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].logoUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].logoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX].logoUrl","typeLabel":"string | null"}},"uniqueKey":"simulation.oneOf.0.changes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"simulation.oneOf.0.changes","typeLabel":"object[]"},"totalUsdOut":{"oneOf":[{"type":"number","uniqueKey":"simulation.oneOf.0.totalUsdOut.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"simulation.oneOf.0.totalUsdOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.totalUsdOut","typeLabel":"number | null"},"totalUsdIn":{"oneOf":[{"type":"number","uniqueKey":"simulation.oneOf.0.totalUsdIn.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"simulation.oneOf.0.totalUsdIn.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.totalUsdIn","typeLabel":"number | null"},"gasUsed":{"oneOf":[{"type":"string","uniqueKey":"simulation.oneOf.0.gasUsed.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"simulation.oneOf.0.gasUsed.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.gasUsed","typeLabel":"string | null"},"logsExcerpt":{"type":"array","items":{"type":"string","uniqueKey":"simulation.oneOf.0.logsExcerpt.items.[INDEX]","typeLabel":"string"},"uniqueKey":"simulation.oneOf.0.logsExcerpt","typeLabel":"string[]"},"warnings":{"type":"array","items":{"type":"string","uniqueKey":"simulation.oneOf.0.warnings.items.[INDEX]","typeLabel":"string"},"uniqueKey":"simulation.oneOf.0.warnings","typeLabel":"string[]"},"simulatedAt":{"type":"string","format":"date-time","uniqueKey":"simulation.oneOf.0.simulatedAt","typeLabel":"string\u003cdate-time>"},"provider":{"oneOf":[{"type":"string","enum":["tatum","alchemy","starknet-rpc",null],"uniqueKey":"simulation.oneOf.0.provider.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["tatum","alchemy","starknet-rpc",null],"uniqueKey":"simulation.oneOf.0.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation.oneOf.0.provider","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"simulation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"simulation.oneOf.1","typeLabel":"null"}],"uniqueKey":"simulation","typeLabel":"object | null"},"approvalUrl":{"oneOf":[{"type":"string","description":"Set when the proposal waits for the owner. Send it to them; an API key cannot confirm.","uniqueKey":"approvalUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when the proposal waits for the owner. Send it to them; an API key cannot confirm.","uniqueKey":"approvalUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"approvalUrl","typeLabel":"string | null"},"txHash":{"oneOf":[{"type":"string","description":"Set when the proposal executed.","uniqueKey":"txHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when the proposal executed.","uniqueKey":"txHash.oneOf.1","typeLabel":"null"}],"uniqueKey":"txHash","typeLabel":"string | null"},"scanId":{"oneOf":[{"type":"string","description":"Verification id. Null when no judge ran.","uniqueKey":"scanId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Verification id. Null when no judge ran.","uniqueKey":"scanId.oneOf.1","typeLabel":"null"}],"uniqueKey":"scanId","typeLabel":"string | null"},"creditsRemaining":{"oneOf":[{"type":"integer","description":"Null when no credit was charged.","uniqueKey":"creditsRemaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Null when no credit was charged.","uniqueKey":"creditsRemaining.oneOf.1","typeLabel":"null"}],"uniqueKey":"creditsRemaining","typeLabel":"integer | null"},"proof":{"oneOf":[{"type":"object","description":"Null when no judge ran.","properties":{"transcriptRoot":{"oneOf":[{"type":"string","description":"Head of the transcript hash chain.","uniqueKey":"proof.oneOf.0.transcriptRoot.oneOf.0","typeLabel":"string"},{"type":"null","description":"Head of the transcript hash chain.","uniqueKey":"proof.oneOf.0.transcriptRoot.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.transcriptRoot","typeLabel":"string | null"},"outputHash":{"oneOf":[{"type":"string","description":"keccak256 of the judge's full output text.","uniqueKey":"proof.oneOf.0.outputHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"keccak256 of the judge's full output text.","uniqueKey":"proof.oneOf.0.outputHash.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.outputHash","typeLabel":"string | null"},"signature":{"oneOf":[{"type":"string","description":"EIP-191 signature by the judge key over the run digest.","uniqueKey":"proof.oneOf.0.signature.oneOf.0","typeLabel":"string"},{"type":"null","description":"EIP-191 signature by the judge key over the run digest.","uniqueKey":"proof.oneOf.0.signature.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.signature","typeLabel":"string | null"},"judge":{"oneOf":[{"type":"string","description":"Address of the judge key.","uniqueKey":"proof.oneOf.0.judge.oneOf.0","typeLabel":"string"},{"type":"null","description":"Address of the judge key.","uniqueKey":"proof.oneOf.0.judge.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.judge","typeLabel":"string | null"},"attested":{"type":"boolean","description":"True when the signing key's attestation mode is Azure SEV-SNP.","uniqueKey":"proof.oneOf.0.attested","typeLabel":"boolean"},"anchorTx":{"oneOf":[{"type":"string","description":"Anchor transaction hash. Null when anchoring was skipped or failed.","uniqueKey":"proof.oneOf.0.anchorTx.oneOf.0","typeLabel":"string"},{"type":"null","description":"Anchor transaction hash. Null when anchoring was skipped or failed.","uniqueKey":"proof.oneOf.0.anchorTx.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.anchorTx","typeLabel":"string | null"},"anchorVerified":{"type":"boolean","description":"True when the registry confirmed the record after the anchor transaction.","uniqueKey":"proof.oneOf.0.anchorVerified","typeLabel":"boolean"},"transcriptUri":{"type":"string","description":"`/api/runs/{runId}/transcript`. Owner-only: send the owning account's API key, or open `/verify/{runId}` signed in.","uniqueKey":"proof.oneOf.0.transcriptUri","typeLabel":"string"},"explorerTx":{"oneOf":[{"type":"string","description":"Explorer link for the anchor: basescan.org for Base, voyager.online for Starknet.","uniqueKey":"proof.oneOf.0.explorerTx.oneOf.0","typeLabel":"string"},{"type":"null","description":"Explorer link for the anchor: basescan.org for Base, voyager.online for Starknet.","uniqueKey":"proof.oneOf.0.explorerTx.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof.oneOf.0.explorerTx","typeLabel":"string | null"}},"uniqueKey":"proof.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"proof.oneOf.1","typeLabel":"null"}],"uniqueKey":"proof","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"txId":"\u003cstring>","status":"blocked","verdict":"\u003cstring>","reasoning":"\u003cstring>","requestHash":"\u003cstring>","simulation":{"ok":true,"status":"clean","declared":true,"wouldRevert":true,"error":"\u003cstring>","caip2":"\u003cstring>","changes":[{"direction":"in","assetType":"native","changeType":"transfer","symbol":"\u003cstring>","name":"\u003cstring>","contractAddress":"\u003cstring>","rawAmount":"\u003cstring>","decimals":123,"amount":"\u003cstring>","usdValue":123,"counterparty":"\u003cstring>","logoUrl":"\u003cstring>"}],"totalUsdOut":123,"totalUsdIn":123,"gasUsed":"\u003cstring>","logsExcerpt":["\u003cstring>"],"warnings":["\u003cstring>"],"simulatedAt":"2023-11-07T05:31:56Z","provider":"tatum"},"approvalUrl":"\u003cstring>","txHash":"\u003cstring>","scanId":"\u003cstring>","creditsRemaining":123,"proof":{"transcriptRoot":"\u003cstring>","outputHash":"\u003cstring>","signature":"\u003cstring>","judge":"\u003cstring>","attested":true,"anchorTx":"\u003cstring>","anchorVerified":true,"transcriptUri":"\u003cstring>","explorerTx":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"99c3945b-9191-4917-8beb-5f8ae1ece775":{"description":"Invalid body or input, or an action this wallet cannot take. No credit charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"e0":{"title":"e0","value":{"error":"invalid JSON body"}},"e1":{"title":"e1","value":{"error":"input is required"}},"e2":{"title":"e2","value":{"error":"invalid_input","message":"input.transfer.amount must be a plain decimal string in whole token units (e.g. \"1.5\"); got \"1e3\""}},"e3":{"title":"e3","value":{"error":"propose_failed","message":"action targets Base but this wallet is on Starknet"}}},"exampleType":"examples"}},"exampleType":"examples"},"f3d43ebd-2fb5-4903-a8ee-1fa83c322f7d":{"description":"No API key, or the key is unknown or revoked.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"e0":{"title":"e0","value":{"error":"missing API key (send x-api-key)"}},"e1":{"title":"e1","value":{"error":"invalid or revoked API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"b2d10648-0d72-4ce7-975e-b45277c84502":{"description":"Out of credits. The proposal is recorded as blocked.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"propose_failed","message":"No credits remaining. …"},"examples":{"Example":{"title":"Example","value":{"error":"propose_failed","message":"No credits remaining. …"}}},"exampleType":"examples"}},"exampleType":"examples"},"c4b03342-ae4f-4e3a-875d-600371ea2c2a":{"description":"No such wallet on this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"not_found"},"examples":{"Example":{"title":"Example","value":{"error":"not_found"}}},"exampleType":"examples"}},"exampleType":"examples"},"31bf3ac3-f9fc-49d0-80db-ab83f2b3f926":{"description":"The wallet cannot transact: archived, or a safe wallet from before self-custodial safe mode.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"propose_failed","message":"wallet is not active"},"examples":{"Example":{"title":"Example","value":{"error":"propose_failed","message":"wallet is not active"}}},"exampleType":"examples"}},"exampleType":"examples"},"478a0758-4c7e-49c1-94c2-9cd682d018eb":{"description":"Unexpected failure.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"propose_failed","message":"…"},"examples":{"Example":{"title":"Example","value":{"error":"propose_failed","message":"…"}}},"exampleType":"examples"}},"exampleType":"examples"},"4f4eb2b8-5ccf-4a5b-aeb0-9afffb5444af":{"description":"The judge run failed. The credit was refunded and the proposal is blocked.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"An error code (for example `out_of_credits`) or a short sentence (for example `intent is required`).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detail, when present.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"propose_failed","message":"…"},"examples":{"Example":{"title":"Example","value":{"error":"propose_failed","message":"…"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a4f688e3-d96d-45f1-bc7a-66801e7ff5c4":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"An API key (`chance_sk_live_…`) from https://harness.chance.cc/keys.","scopes":[],"schemeName":"ApiKeyAuth"}},"2902b8e5-cca2-4322-8bd2-bd6c6f3ad015":{"BearerAuth":{"type":"http","scheme":"bearer","description":"The same API key sent as `Authorization: Bearer \u003ckey>`. If both headers are sent, `x-api-key` is used.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"bfc22b5f-4ee3-4412-99b3-fdfde594f00f":{"url":"https://harness.chance.cc","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"An API key (`chance_sk_live_…`) from https://harness.chance.cc/keys.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"An API key (`chance_sk_live_…`) from https://harness.chance.cc/keys.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"The same API key sent as `Authorization: Bearer \u003ckey>`. If both headers are sent, `x-api-key` is used.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The same API key sent as `Authorization: Bearer \u003ckey>`. If both headers are sent, `x-api-key` is used.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"chance","siteName":"Chance","title":"Propose a transaction - Chance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T00:41:01.344Z","originalFileLocation":"api-reference/escrow-wallets/propose-a-transaction.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Simulates the input, checks the wallet\u0026#x27;s limits, then runs the judge against the wallet\u0026#x27;s mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_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/chance/xc4kUFXxmiygn3ck/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Propose a transaction - Chance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Simulates the input, checks the wallet\u0026#x27;s limits, then runs the judge against the wallet\u0026#x27;s mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chance.mintlify.site/_mintlify/api/og/v2?division=Escrow+wallets\u0026amp;title=Propose+a+transaction\u0026amp;description=Simulates+the+input%2C+checks+the+wallet%27s+limits%2C+then+runs+the+judge+against+the+wallet%27s+mandate.+An+autonomous+wallet+executes+an+ALLOW+with+a+clean%2C+verifiab\u0026amp;theme=0072fa2952a8a9cb5de618d8\u0026amp;signature=f5659a3c245a64e38b0fd606d34dc4aa971f9d112ae2a4783cd373fc7e87eb45\">\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=\"Propose a transaction - Chance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Simulates the input, checks the wallet\u0026#x27;s limits, then runs the judge against the wallet\u0026#x27;s mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chance.mintlify.site/_mintlify/api/og/v2?division=Escrow+wallets\u0026amp;title=Propose+a+transaction\u0026amp;description=Simulates+the+input%2C+checks+the+wallet%27s+limits%2C+then+runs+the+judge+against+the+wallet%27s+mandate.+An+autonomous+wallet+executes+an+ALLOW+with+a+clean%2C+verifiab\u0026amp;theme=0072fa2952a8a9cb5de618d8\u0026amp;signature=f5659a3c245a64e38b0fd606d34dc4aa971f9d112ae2a4783cd373fc7e87eb45\">\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/chance/xc4kUFXxmiygn3ck/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A01BD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/escrow-wallets/propose-a-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chance.cc/#organization\",\"name\":\"Chance\",\"url\":\"https://docs.chance.cc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chance/HYb9hteNOAOTB9WR/logo/light.png?fit=max\u0026auto=format\u0026n=HYb9hteNOAOTB9WR\u0026q=85\u0026s=4fd2723a7219bca29fde003c3c8ffb8c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chance.cc#website\",\"name\":\"Chance\",\"url\":\"https://docs.chance.cc\",\"publisher\":{\"@id\":\"https://docs.chance.cc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction#webpage\",\"url\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction\",\"name\":\"Propose a transaction\",\"description\":\"Simulates the input, checks the wallet's limits, then runs the judge against the wallet's mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.\",\"dateModified\":\"2026-10-12T00:41:01.344Z\",\"isPartOf\":{\"@id\":\"https://docs.chance.cc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"HTTP endpoints\",\"item\":\"https://docs.chance.cc/api-reference/verification/verify-an-action\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Escrow wallets\",\"item\":\"https://docs.chance.cc/api-reference/escrow-wallets/list-wallets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Propose a transaction\",\"item\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction#apireference\",\"headline\":\"Propose a transaction\",\"name\":\"Propose a transaction\",\"description\":\"Simulates the input, checks the wallet's limits, then runs the judge against the wallet's mandate. An autonomous wallet executes an ALLOW with a clean, verifiable simulation. Everything else that is not blocked waits for the owner at approvalUrl. One credit when the judge runs; a proposal the limits block first is free.\",\"url\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chance.cc/api-reference/escrow-wallets/propose-a-transaction#webpage\"},\"dateModified\":\"2026-10-12T00:41:01.344Z\",\"publisher\":{\"@id\":\"https://docs.chance.cc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chance.cc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chance\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Chance\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/escrow-wallets/propose-a-transaction.md","siteName":"Chance","nav":{"global":null,"tabs":[{"tab":"Use Chance","pages":[{"title":"Use Chance","href":""}]},{"tab":"Privacy","pages":[{"title":"Privacy","href":"/privacy/overview"}]},{"tab":"Chance Verification","groups":[{"group":"Integrate","pages":[{"title":"API overview","sidebarTitle":"Overview","href":"/api-reference/introduction"},{"title":"Verify an action","href":"/api-reference/quickstart"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Connectors","href":"/connectors"},{"title":"Local MCP server","href":"/mcp-local"},{"title":"MCP tools","href":"/api-reference/mcp-tools"},{"title":"Wallet API","href":"/api-reference/escrow-wallets"}]},{"group":"Chance verification","pages":[{"title":"Verification","href":"/concepts/verification"},{"title":"Verification request","href":"/api-reference/verification-request"},{"title":"Receipts","href":"/concepts/proofs"},{"title":"Private records","href":"/concepts/private-records"},{"title":"Balance and top-ups","sidebarTitle":"API billing","href":"/concepts/credits"},{"title":"x402 payments","href":"/x402/verifier"}]},{"group":"Payload adapters","pages":[{"title":"Venue adapters","href":"/venues/overview"},{"group":"Trading","pages":[{"title":"Hyperliquid","href":"/venues/hyperliquid"},{"title":"Polymarket","href":"/venues/polymarket"},{"title":"Limitless","href":"/venues/limitless"},{"title":"Dimes","href":"/venues/dimes"},{"title":"Myriad Markets","href":"/venues/myriad"},{"title":"Orderly Network","href":"/venues/orderly"},{"title":"Derive","href":"/venues/derive"},{"title":"Liquid","href":"/venues/liquid"},{"title":"Robinhood","href":"/venues/robinhood"}]},{"group":"Wallets and payments","pages":[{"title":"LI.FI","href":"/venues/lifi"},{"title":"Uniswap","href":"/venues/uniswap"},{"title":"Alchemy","href":"/venues/alchemy"},{"title":"Solana","href":"/venues/solana"},{"title":"Starknet","href":"/venues/starknet"},{"title":"Meow","href":"/venues/meow"},{"title":"AgentCard","href":"/venues/agentcards"},{"title":"x402","href":"/venues/x402"}]}]},{"group":"HTTP endpoints","pages":[{"group":"Verification","pages":[{"title":"Verify an action","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/intent","href":"/api-reference/verification/verify-an-action"},{"title":"Get a verification","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/intent/{id}","href":"/api-reference/verification/get-a-verification"}]},{"group":"Credits","pages":[{"title":"Get balance and top-up terms","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/credits","href":"/api-reference/credits/get-balance-and-top-up-terms"},{"title":"Add account balance with x402","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/credits/topup","href":"/api-reference/credits/add-account-balance-with-x402"},{"title":"Get the top-up guide","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/credits/topup/guide","href":"/api-reference/credits/get-the-top-up-guide"}]},{"group":"Escrow wallets","pages":[{"title":"List wallets","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/wallets","href":"/api-reference/escrow-wallets/list-wallets"},{"title":"Create a wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/wallets","href":"/api-reference/escrow-wallets/create-a-wallet"},{"title":"Get wallet balances","description":"Live token balances. Free.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/wallets/{id}/balances","href":"/api-reference/escrow-wallets/get-wallet-balances"},{"title":"Propose a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/wallets/{id}/propose","href":"/api-reference/escrow-wallets/propose-a-transaction"},{"title":"Propose a swap","description":"Quotes the swap on the Uniswap Trading API, builds the batch (an approval for exactly the sell amount when needed, then the swap) and proposes it like `/propose`. For supported EVM routes. Jupiter and LI.FI use separate MCP tools. One credit when the judge runs.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/wallets/{id}/swap","href":"/api-reference/escrow-wallets/propose-a-swap"},{"title":"Get a proposal's status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/escrow-transactions/{id}","href":"/api-reference/escrow-wallets/get-a-proposals-status"}]},{"group":"Trader","pages":[{"title":"Report trader status","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/trader/heartbeat","href":"/api-reference/trader/report-trader-status"},{"title":"List trader instances","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/trader/instances","href":"/api-reference/trader/list-trader-instances"}]},{"group":"Gas sponsorship","pages":[{"title":"Prepare a sponsored transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/gas/prepare","href":"/api-reference/gas-sponsorship/prepare-a-sponsored-transaction"},{"title":"Submit a sponsored transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/gas/submit","href":"/api-reference/gas-sponsorship/submit-a-sponsored-transaction"},{"title":"Get sponsored transaction status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/gas/status","href":"/api-reference/gas-sponsorship/get-sponsored-transaction-status"}]},{"group":"Status","pages":[{"title":"Get deployment status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/status","href":"/api-reference/status/get-deployment-status"}]}]}]}]},"basePath":"","title":"Propose a transaction - Chance","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}