How Cowboy keeps a transaction from taking effect twice
Introduction
This page describes how Cowboy ensures that a submitted transaction is applied at most once, and how protocol-driven message execution avoids duplicate state transitions. The description follows the Cowboy whitepaper and CIPs.
Idempotency on Cowboy is achieved via per-account nonces and a single canonical block order; protocol-delivered messages (timers, deferred callbacks) are serialized by consensus.
Definition and Scope
Idempotency refers to the guarantee that a transaction, once accepted and executed, cannot be executed again to produce additional state transitions.
The scope includes: user-submitted transactions, protocol-delivered timer messages (CIP-5), and deferred callbacks produced by the off-chain compute framework (CIP‑2).
Mechanisms
Account Nonce and Transaction Validation (Whitepaper)
The global state tracks per-address account data, including nonce (whitepaper: state contains balance and nonce).
During block processing, the state transition function validates each transaction’s signature, nonce, and balance before execution (whitepaper: “Validate signature, nonce, and balance.”).
Consequences for idempotency:
A replay of the same signed transaction is rejected once the sender’s nonce has advanced.
Out-of-order transactions are not executed until the correct nonce is present.
Deterministic Ordering and Single Inclusion (Whitepaper)
Cowboy employs a Simplex-based BFT protocol to produce a single canonical ordering of blocks. Within this ordering, nonce checks ensure that a user transaction can be accepted and executed at most once.
Timers and the Actor Scheduler (CIP-5)
The CIP-5 scheduler selects a bounded window from the oldest due height, preserving FIFO insertion order within that height. A complete resource request that cannot fit carries forward under the bounded carry/dead-letter rules. Expired or insufficiently funded timers are removed under the independent cleanup budget; bids do not affect admission.
Each admitted timer consumes its reserved authority once in that block. CIP-5 then applies its removal, failure-retry, or native re-arm rule. Deferral does not duplicate the selected record or promise execution before expiry or carry limits.
Deferred Transactions for Off‑chain Callbacks (CIP‑2)
After collecting the required number of results for an off‑chain task, the Result Verifier constructs and signs a deferred transaction containing the developer-specified callback. Validators include and execute this deferred transaction in a future block.
The chain pays the runners from the job’s escrow when it verifies the result, so the callback has nothing to settle and a result can’t be paid twice.
Practical Notes
User-submitted transactions rely on signature and nonce validation for replay protection and single execution.
Protocol-delivered messages (timers and deferred callbacks) are scheduled, included, and executed by consensus rules. When not executed, they are carried forward by protocol logic rather than duplicated within the same block.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cowboy","colors":{"primary":"#E58200","light":"#FFAD33","dark":"#A85700"},"logo":{"light":"https://mintcdn.com/cowboylabsllc/u0Vto4OWAOrYksul/assets/logo/cowboy.svg?fit=max\u0026auto=format\u0026n=u0Vto4OWAOrYksul\u0026q=85\u0026s=65684717438049441c7213ce03e2c68e","dark":"https://mintcdn.com/cowboylabsllc/u0Vto4OWAOrYksul/assets/logo/cowboy.svg?fit=max\u0026auto=format\u0026n=u0Vto4OWAOrYksul\u0026q=85\u0026s=65684717438049441c7213ce03e2c68e"},"favicon":"https://mintcdn.com/cowboylabsllc/u0Vto4OWAOrYksul/images/favicon.svg?fit=max\u0026auto=format\u0026n=u0Vto4OWAOrYksul\u0026q=85\u0026s=06511daeb0446c42cdfaa3d3d5b9045b","api":{"playground":{}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://cloud.cowboy.inc/login","label":"Sign in"}],"primary":{"type":"button","label":"Request an invite","href":"https://cowboy.inc/waitlist"}},"footer":{"socials":{"github":"https://github.com/cowboyinc/docs"},"links":[{"header":"Cowboy","items":[{"label":"cowboy.inc","href":"https://cowboy.inc"},{"label":"General Store","href":"https://cloud.cowboy.inc/general-store"},{"label":"Blog","href":"https://cowboy.inc/blog"}]},{"header":"Help","items":[{"label":"Support","href":"mailto:support@cowboy.inc"},{"label":"GitHub","href":"https://github.com/cowboyinc/docs"}]}]},"search":{"prompt":"Search"},"fonts":{"heading":{"family":"Season Mix VF","source":"fonts/SeasonMixVF.woff2","format":"woff2"},"body":{"family":"Season Sans VF","source":"fonts/SeasonSansVF.woff2","format":"woff2"}},"styling":{"codeblocks":"system","latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/cowboyinc/docs"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cowboylabsllc","hasAudioNarration":false,"actualSubdomain":"cowboylabsllc","customDomains":["docs.cowboy.inc"],"gitSource":{"type":"github","owner":"cowboyinc","repo":"cowboy","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afcc05fb8648d3ccfe28b72","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Reference","count":279},{"language":"default","tag":"Error Reference","count":179},{"language":"default","tag":"CLI","count":52},{"language":"default","tag":"E1700–E1799 CBSS","count":52},{"language":"default","tag":"CIPs","count":34},{"language":"default","tag":"Protocol and architecture","count":27},{"language":"default","tag":"E1200–E1299 Runtime / host API","count":25},{"language":"default","tag":"E1600–E1699 Runner / consensus / job","count":22},{"language":"default","tag":"Build Actors","count":20},{"language":"default","tag":"E1000–E1099 Transaction pre-checks","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"cowboy-theme.css","href":"/_mintlify/custom/cowboylabsllc/2510a544ec5c0a49/cowboy-theme.css"}],"page":{"pagePath":"architecture/tx/idempotency","slug":"/architecture/tx/idempotency","pageMetadata":{"title":"Idempotency","description":"How Cowboy keeps a transaction from taking effect twice","href":"/architecture/tx/idempotency"},"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: \"How Cowboy keeps a transaction from taking effect twice\"\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={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`introduction`,children:`Introduction`}),`\n`,_jsx(_components.p,{children:`This page describes how Cowboy ensures that a submitted transaction is applied at most once, and how protocol-driven message execution avoids duplicate state transitions. The description follows the Cowboy whitepaper and CIPs.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Idempotency on Cowboy is achieved via per-account nonces and a single canonical block order; protocol-delivered messages (timers, deferred callbacks) are serialized by consensus.`})}),`\n`,_jsx(Heading,{level:`2`,id:`definition-and-scope`,children:`Definition and Scope`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Idempotency refers to the guarantee that a transaction, once accepted and executed, cannot be executed again to produce additional state transitions.`}),`\n`,_jsx(_components.li,{children:`The scope includes: user-submitted transactions, protocol-delivered timer messages (CIP-5), and deferred callbacks produced by the off-chain compute framework (CIP‑2).`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`mechanisms`,children:`Mechanisms`}),`\n`,_jsx(Heading,{level:`3`,id:`account-nonce-and-transaction-validation-whitepaper`,children:`Account Nonce and Transaction Validation (Whitepaper)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The global state tracks per-address account data, including `,_jsx(_components.code,{children:`nonce`}),` (whitepaper: state contains `,_jsx(_components.code,{children:`balance`}),` and `,_jsx(_components.code,{children:`nonce`}),`).`]}),`\n`,_jsx(_components.li,{children:`During block processing, the state transition function validates each transaction’s signature, nonce, and balance before execution (whitepaper: “Validate signature, nonce, and balance.”).`}),`\n`,_jsxs(_components.li,{children:[`Consequences for idempotency:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A replay of the same signed transaction is rejected once the sender’s nonce has advanced.`}),`\n`,_jsx(_components.li,{children:`Out-of-order transactions are not executed until the correct nonce is present.`}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`deterministic-ordering-and-single-inclusion-whitepaper`,children:`Deterministic Ordering and Single Inclusion (Whitepaper)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cowboy employs a Simplex-based BFT protocol to produce a single canonical ordering of blocks. Within this ordering, nonce checks ensure that a user transaction can be accepted and executed at most once.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`timers-and-the-actor-scheduler-cip-5`,children:`Timers and the Actor Scheduler (CIP-5)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The CIP-5 scheduler selects a bounded window from the oldest due height, preserving FIFO insertion order within that height. A complete resource request that cannot fit carries forward under the bounded carry/dead-letter rules. Expired or insufficiently funded timers are removed under the independent cleanup budget; bids do not affect admission.`}),`\n`,_jsx(_components.li,{children:`Each admitted timer consumes its reserved authority once in that block. CIP-5 then applies its removal, failure-retry, or native re-arm rule. Deferral does not duplicate the selected record or promise execution before expiry or carry limits.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`deferred-transactions-for-off‑chain-callbacks-cip‑2`,children:`Deferred Transactions for Off‑chain Callbacks (CIP‑2)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`After collecting the required number of results for an off‑chain task, the Result Verifier constructs and signs a deferred transaction containing the developer-specified callback. Validators include and execute this deferred transaction in a future block.`}),`\n`,_jsx(_components.li,{children:`The chain pays the runners from the job’s escrow when it verifies the result, so the callback has nothing to settle and a result can’t be paid twice.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`practical-notes`,children:`Practical Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`User-submitted transactions rely on signature and nonce validation for replay protection and single execution.`}),`\n`,_jsx(_components.li,{children:`Protocol-delivered messages (timers and deferred callbacks) are scheduled, included, and executed by consensus rules. When not executed, they are carried forward by protocol logic rather than duplicated within the same block.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`further-reading`,children:`Further Reading`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/architecture/tx/tx-fields`,children:`Transaction Fields`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/architecture/scheduler/overview`,children:`Scheduler Overview`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/architecture/offchain/lifecycle`,children:`Off-Chain Lifecycle`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cips/cip-5-timers`,children:`CIP-5`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cips/cip-2-offchain-compute`,children:`CIP-2`})}),`\n`]})]})}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":"system","config":{},"pageMetadata":{"title":"Idempotency","description":"How Cowboy keeps a transaction from taking effect twice","href":"/architecture/tx/idempotency"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Introduction","slug":"introduction","depth":2,"children":[]},{"title":"Definition and Scope","slug":"definition-and-scope","depth":2,"children":[]},{"title":"Mechanisms","slug":"mechanisms","depth":2,"children":[{"title":"Account Nonce and Transaction Validation (Whitepaper)","slug":"account-nonce-and-transaction-validation-whitepaper","depth":3,"children":[]},{"title":"Deterministic Ordering and Single Inclusion (Whitepaper)","slug":"deterministic-ordering-and-single-inclusion-whitepaper","depth":3,"children":[]},{"title":"Timers and the Actor Scheduler (CIP-5)","slug":"timers-and-the-actor-scheduler-cip-5","depth":3,"children":[]},{"title":"Deferred Transactions for Off‑chain Callbacks (CIP‑2)","slug":"deferred-transactions-for-off‑chain-callbacks-cip‑2","depth":3,"children":[]}]},{"title":"Practical Notes","slug":"practical-notes","depth":2,"children":[]},{"title":"Further Reading","slug":"further-reading","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cowboylabsllc","siteName":"Cowboy","title":"Idempotency - Cowboy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T14:12:32.570Z","originalFileLocation":"architecture/tx/idempotency.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=\"How Cowboy keeps a transaction from taking effect twice\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cowboy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_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/cowboylabsllc/r3REUMykWa-twE89/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Idempotency - Cowboy\">\u003cmeta data-mint-head property=\"og:description\" content=\"How Cowboy keeps a transaction from taking effect twice\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cowboy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cowboy.inc/architecture/tx/idempotency\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cowboylabsllc.mintlify.site/_mintlify/api/og/v2?division=Transactions+%26+Message+Flow\u0026amp;title=Idempotency\u0026amp;description=How+Cowboy+keeps+a+transaction+from+taking+effect+twice\u0026amp;theme=70482cd297530a4132dadc59\u0026amp;signature=a1463767ea608352ec3219fe63d709f9bddc332e8d3e648d7cc400297305c9a4\">\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=\"Idempotency - Cowboy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How Cowboy keeps a transaction from taking effect twice\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cowboylabsllc.mintlify.site/_mintlify/api/og/v2?division=Transactions+%26+Message+Flow\u0026amp;title=Idempotency\u0026amp;description=How+Cowboy+keeps+a+transaction+from+taking+effect+twice\u0026amp;theme=70482cd297530a4132dadc59\u0026amp;signature=a1463767ea608352ec3219fe63d709f9bddc332e8d3e648d7cc400297305c9a4\">\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/cowboylabsllc/r3REUMykWa-twE89/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cowboy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E58200\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cowboy.inc/architecture/tx/idempotency\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/architecture/tx/idempotency.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cowboy.inc/#organization\",\"name\":\"Cowboy\",\"url\":\"https://docs.cowboy.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cowboylabsllc/u0Vto4OWAOrYksul/assets/logo/cowboy.svg?fit=max\u0026auto=format\u0026n=u0Vto4OWAOrYksul\u0026q=85\u0026s=65684717438049441c7213ce03e2c68e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cowboy.inc#website\",\"name\":\"Cowboy\",\"url\":\"https://docs.cowboy.inc\",\"publisher\":{\"@id\":\"https://docs.cowboy.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cowboy.inc/architecture/tx/idempotency#webpage\",\"url\":\"https://docs.cowboy.inc/architecture/tx/idempotency\",\"name\":\"Idempotency\",\"description\":\"How Cowboy keeps a transaction from taking effect twice\",\"dateModified\":\"2026-11-04T14:12:32.570Z\",\"isPartOf\":{\"@id\":\"https://docs.cowboy.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cowboy.inc/architecture/tx/idempotency#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cowboy.inc/architecture/tx/idempotency#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Protocol and architecture\",\"item\":\"https://docs.cowboy.inc/overview/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transactions \u0026 Message Flow\",\"item\":\"https://docs.cowboy.inc/architecture/tx/tx-fields\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Idempotency\",\"item\":\"https://docs.cowboy.inc/architecture/tx/idempotency\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cowboy.inc/architecture/tx/idempotency#article\",\"headline\":\"Idempotency\",\"name\":\"Idempotency\",\"description\":\"How Cowboy keeps a transaction from taking effect twice\",\"url\":\"https://docs.cowboy.inc/architecture/tx/idempotency\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cowboy.inc/architecture/tx/idempotency#webpage\"},\"dateModified\":\"2026-11-04T14:12:32.570Z\",\"publisher\":{\"@id\":\"https://docs.cowboy.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cowboy.inc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cowboy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cowboy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/architecture/tx/idempotency.md","siteName":"Cowboy","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/cowboyinc/docs"}]},"groups":[{"group":"Welcome","pages":[{"title":"The App Store for AI","sidebarTitle":"Overview","icon":"grip-vertical","href":"/index"},{"title":"What is Cowboy?","icon":"bars-staggered","href":"/introduction/what-is-cowboy"}]},{"group":"Hire Actors","pages":[{"title":"Hire an actor","icon":"store","href":"/getting-started/hire-from-the-store"},{"title":"After you hire","icon":"list-check","href":"/hire/after-you-hire"},{"title":"Your keys and your data","icon":"lock","href":"/hire/keys-and-data"},{"title":"Billing","icon":"credit-card","href":"/hire/billing"},{"title":"Hire from the CLI","icon":"terminal","href":"/hire/hire-from-the-cli"}]},{"group":"Build Actors","pages":[{"title":"Install the CLI","icon":"download","href":"/getting-started/install"},{"title":"Quickstart","icon":"layer-plus","href":"/getting-started/quickstart"},{"title":"Build your first actor","icon":"graduation-cap","href":"/developers/your-first-actor"},{"title":"Build with your coding agent","icon":"robot","href":"/build/coding-agent"},{"title":"Build with Lasso","icon":"terminal","href":"/build/lasso"},{"title":"Deploy and operate","icon":"rocket","href":"/build/deploy"},{"title":"Where your code runs","icon":"diagram-project","href":"/build/where-your-code-runs"},{"group":"Actor SDK guides","pages":[{"title":"The actor SDK","icon":"code","href":"/developers/sdk"},{"title":"What actor code can and can't do","icon":"lock","href":"/build/sdk/determinism"},{"title":"An actor's schedule","icon":"clock","href":"/build/sdk/schedule"},{"title":"Read a data feed","icon":"rss","href":"/build/sdk/feeds"},{"title":"Call models, the web and tools","icon":"satellite-dish","href":"/developers/submitting-jobs"},{"title":"An actor's wallet","icon":"wallet","href":"/build/sdk/wallet"},{"title":"An actor's files","icon":"folder-open","href":"/build/sdk/files"},{"title":"Call other actors","icon":"arrows-left-right","href":"/build/sdk/other-actors"},{"title":"Keep an actor safe","icon":"shield","href":"/build/sdk/safety"}]},{"title":"Test your actor","icon":"vial","href":"/developers/testing-actors"},{"title":"Run a web app or service","icon":"server","href":"/developers/ship-a-web-app"},{"title":"Call actors from your app","icon":"plug","href":"/build/call-from-apps"},{"title":"Examples","icon":"laptop-code","href":"/developers/examples"}]},{"group":"Sell in the Store","pages":[{"title":"Sell on Cowboy","icon":"tag","href":"/sell/list-an-actor"},{"title":"Walkthrough: sell a social metrics product","icon":"chart-line","href":"/sell/social-metrics-walkthrough"},{"title":"Bring existing code","icon":"code-merge","href":"/sell/bring-existing-code"},{"title":"Call an API with a key","icon":"key","href":"/sell/call-an-api-with-a-secret"},{"title":"Package and submit a listing","icon":"box","href":"/sell/package-and-submit"},{"title":"Pricing","icon":"dollar-sign","href":"/sell/pricing"}]},{"group":"Protocol and architecture","pages":[{"title":"Architecture Overview","icon":"instalod","href":"/overview/architecture"},{"title":"Design Principles","icon":"list","href":"/overview/design-principles"},{"group":"Actor VM \u0026 Determinism","pages":[{"title":"Actor VM Overview","href":"/architecture/actor-vm/overview"},{"title":"Actor Identity","href":"/architecture/actor-vm/actor-identity"},{"title":"Determinism \u0026 Sandboxing","href":"/architecture/actor-vm/determinism-and-sandbox"},{"title":"Resource Limits","href":"/architecture/actor-vm/resource-limits"},{"title":"PVM Reference","href":"/architecture/actor-vm/pvm-reference"}]},{"group":"Fee Model: Cycles \u0026 Cells","pages":[{"title":"Fee Model Overview","href":"/architecture/fees/overview"},{"title":"Dual EIP-1559 Basefee Mechanism","href":"/architecture/fees/dual-eip1559"},{"title":"Metering Points Reference","href":"/architecture/fees/metering-points"}]},{"group":"Timers \u0026 Actor Message Scheduler","pages":[{"title":"Timers \u0026 Scheduler Overview","href":"/architecture/scheduler/overview"},{"title":"Sequence Diagram","href":"/architecture/scheduler/sequence-diagram"},{"title":"DoS Protection Parameters","href":"/architecture/scheduler/dos-parameters"}]},{"group":"Verifiable Off-chain Compute","pages":[{"title":"Off-Chain Compute Overview","href":"/architecture/offchain/overview"},{"title":"Runners, Data Boundaries, and Settlement","icon":"network-wired","href":"/architecture/offchain/runners-data-boundaries"},{"title":"Off-Chain Task Lifecycle","href":"/architecture/offchain/lifecycle"},{"title":"Callback, Timeout \u0026 Challenge","href":"/architecture/offchain/callback-timeout-challenge"}]},{"group":"Transactions \u0026 Message Flow","pages":[{"title":"Transaction Fields","description":"Fields and signing rules for Cowboy transaction v3","href":"/architecture/tx/tx-fields"},{"title":"Idempotency","href":"/architecture/tx/idempotency"},{"title":"Reentrancy","description":"How Cowboy protects actors from reentrancy attacks","href":"/architecture/tx/reentrancy"}]},{"group":"Consensus","pages":[{"title":"Consensus","icon":"handshake","href":"/architecture/consensus/overview"}]},{"group":"State \u0026 Storage","pages":[{"title":"State \u0026 Storage Model","icon":"database","href":"/architecture/storage/overview"}]},{"group":"Block Lifecycle","pages":[{"title":"Block Lifecycle (Speculative Execution)","icon":"layers","href":"/architecture/execution/block-lifecycle"}]},{"group":"Entitlements","pages":[{"title":"Entitlements Overview","href":"/architecture/entitlements/overview"},{"title":"Entitlements Specification","href":"/architecture/entitlements/entitlements-specification"}]},{"group":"Keys \u0026 Wallets","pages":[{"title":"Key Format Specification","icon":"key","href":"/architecture/keys/key-format"}]},{"title":"Value Flows","icon":"pump-impeller","href":"/economics/flows"}]},{"group":"Reference","pages":[{"group":"CLI","pages":[{"title":"CLI overview","icon":"terminal","href":"/cli-specs/summary"},{"title":"Script the CLI","icon":"terminal","href":"/references/cli-json"},{"title":"Key Auto-Discovery","icon":"key","href":"/cli-specs/key-auto-discovery"},{"group":"Everyday","pages":[{"title":"cowboy init","icon":"folder-plus","href":"/cli-specs/cowboy-init"},{"title":"cowboy check","icon":"clipboard-check","href":"/cli-specs/cowboy-check"},{"title":"cowboy build","icon":"hammer","href":"/cli-specs/cowboy-build"},{"title":"cowboy run","icon":"play","href":"/cli-specs/cowboy-run"},{"title":"cowboy test","icon":"vial","href":"/cli-specs/cowboy-test"},{"title":"cowboy deploy","icon":"rocket","href":"/cli-specs/cowboy-deploy"},{"title":"cowboy verify-deploy","icon":"circle-check","href":"/cli-specs/cowboy-verify-deploy"},{"title":"cowboy actor","icon":"code","href":"/cli-specs/cowboy-actor"},{"title":"cowboy env","icon":"server","href":"/cli-specs/cowboy-env"},{"title":"cowboy wallet","icon":"wallet","href":"/cli-specs/cowboy-wallet"},{"title":"cowboy account","icon":"user","href":"/cli-specs/cowboy-account"},{"title":"cowboy status","icon":"activity","href":"/cli-specs/cowboy-status"}]},{"group":"Store and money","pages":[{"title":"cowboy store","icon":"store","href":"/cli-specs/cowboy-store"},{"title":"cowboy credit","icon":"gift","href":"/cli-specs/cowboy-credit"},{"title":"cowboy topup","icon":"credit-card","href":"/cli-specs/cowboy-topup"},{"title":"cowboy transfer","icon":"arrow-right-arrow-left","href":"/cli-specs/cowboy-transfer"},{"title":"cowboy session","icon":"handshake","href":"/cli-specs/cowboy-session"},{"title":"cowboy usage","icon":"gauge","href":"/cli-specs/cowboy-usage"},{"title":"cowboy billing","icon":"file-invoice","href":"/cli-specs/cowboy-billing"},{"title":"cowboy login","icon":"right-to-bracket","href":"/cli-specs/cowboy-login"},{"title":"cowboy whoami","icon":"user","href":"/cli-specs/cowboy-whoami"},{"title":"cowboy logout","icon":"right-from-bracket","href":"/cli-specs/cowboy-logout"},{"title":"cowboy dashboard","icon":"link","href":"/cli-specs/cowboy-dashboard"}]},{"group":"Secrets and data","pages":[{"title":"cowboy secrets","icon":"key","href":"/cli-specs/cowboy-secrets"},{"title":"cowboy volume","icon":"hard-drive","href":"/cli-specs/cowboy-volume"},{"title":"cowboy cbfs","icon":"database","href":"/cli-specs/cowboy-cbfs"},{"title":"cowboy watchtower","icon":"tower-observation","href":"/cli-specs/cowboy-watchtower"},{"title":"cowboy cbqs","icon":"layer-group","href":"/cli-specs/cowboy-cbqs"},{"title":"cowboy token","icon":"coins","href":"/cli-specs/cowboy-token"},{"title":"cowboy job","icon":"server","href":"/cli-specs/cowboy-job"},{"title":"cowboy entitlement","icon":"key","href":"/cli-specs/cowboy-entitlement"}]},{"group":"More","pages":[{"title":"cowboy workload","icon":"cubes","href":"/cli-specs/cowboy-workload"},{"title":"cowboy lib","icon":"book","href":"/cli-specs/cowboy-lib"},{"title":"cowboy cowchat","icon":"comments","href":"/cli-specs/cowboy-cowchat"},{"title":"cowboy rooms","icon":"door-open","href":"/cli-specs/cowboy-rooms"},{"title":"cowboy block","icon":"cube","href":"/cli-specs/cowboy-block"},{"title":"cowboy transaction","icon":"receipt","href":"/cli-specs/cowboy-transaction"},{"title":"cowboy faucet","icon":"faucet","href":"/cli-specs/cowboy-faucet"},{"title":"cowboy version","icon":"tag","href":"/cli-specs/cowboy-version"},{"title":"cowboy completions","icon":"terminal","href":"/cli-specs/cowboy-completions"}]},{"group":"Operators","pages":[{"title":"cowboy runner","icon":"server","href":"/cli-specs/cowboy-runner"},{"title":"cowboy relay","icon":"tower-broadcast","href":"/cli-specs/cowboy-relay"},{"title":"cowboy proxy","icon":"shield","href":"/cli-specs/cowboy-proxy"},{"title":"cowboy tee","icon":"microchip","href":"/cli-specs/cowboy-tee"},{"title":"cowboy container","icon":"box","href":"/cli-specs/cowboy-container"},{"title":"cowboy cluster","icon":"network-wired","href":"/cli-specs/cowboy-cluster"},{"title":"cowboy bridge","icon":"bridge","href":"/cli-specs/cowboy-bridge"},{"title":"cowboy deploy-code","icon":"file-code","href":"/cli-specs/cowboy-deploy-code"},{"title":"cowboy timer","icon":"clock","href":"/cli-specs/cowboy-timer"}]}]},{"group":"Actor SDK","pages":[{"title":"SDK Reference","href":"/developers/sdk-reference"},{"title":"Runtime functions","icon":"book","href":"/developers/runtime-api"},{"title":"Testing toolkit","icon":"vial","href":"/references/testing-toolkit"}]},{"title":"Project layout and cowboy.toml","icon":"folder-tree","href":"/developers/project-layout"},{"group":"Error Reference","pages":[{"title":"Error Codes","href":"/errors/overview"},{"group":"E1000–E1099 Transaction pre-checks","pages":[{"title":"E1001 — Invalid transaction signature","href":"/errors/E1001"},{"title":"E1002 — Nonce mismatch","href":"/errors/E1002"},{"title":"E1003 — Insufficient balance for value transfer","href":"/errors/E1003"},{"title":"E1004 — Insufficient balance for gas","href":"/errors/E1004"},{"title":"E1005 — Out of cycles","href":"/errors/E1005"},{"title":"E1006 — Out of cells","href":"/errors/E1006"},{"title":"E1007 — Gas calculation overflow","href":"/errors/E1007"},{"title":"E1008 — Basefee too low","href":"/errors/E1008"},{"title":"E1009 — Missing required signer","href":"/errors/E1009"},{"title":"E1010 — Actor account would exceed release receipt overdraft cap","href":"/errors/E1010"},{"title":"E1011 — Transaction chain_id does not match this chain","href":"/errors/E1011"},{"title":"E1012 — Deferred child persistence capacity exhausted","href":"/errors/E1012"},{"title":"E1013 — Actor-minted JobSubmit declared … CIP-9 attachments; an actor may declare at most …","href":"/errors/E1013"},{"title":"E1014 — Actor or reserved-system address used as a signer","href":"/errors/E1014"},{"title":"E1015 — Deferred payer … cannot fund the child's maximum fee: required …, available …","href":"/errors/E1015"},{"title":"E1060 — Invalid routes","href":"/errors/E1060"},{"title":"E1061 — Route admission cap","href":"/errors/E1061"}]},{"group":"E1100–E1199 PVM static validation","pages":[{"title":"E1101 — Non-deterministic actor code","href":"/errors/E1101"}]},{"group":"E1200–E1299 Runtime / host API","pages":[{"title":"E1201 — Out of gas inside the PVM","href":"/errors/E1201"},{"title":"E1202 — Invalid input to host API call","href":"/errors/E1202"},{"title":"E1203 — Host lookup not found","href":"/errors/E1203"},{"title":"E1204 — Backend storage error","href":"/errors/E1204"},{"title":"E1205 — Operation forbidden","href":"/errors/E1205"},{"title":"E1206 — Unclassified PVM-internal failure","href":"/errors/E1206"},{"title":"E1207 — Missing entitlement","href":"/errors/E1207"},{"title":"E1208 — Entitlement quota exceeded","href":"/errors/E1208"},{"title":"E1209 — Sandbox violation (forbidden syscall)","href":"/errors/E1209"},{"title":"E1210 — Generic PVM execution error","href":"/errors/E1210"},{"title":"E1211 — Caller is not authorized","href":"/errors/E1211"},{"title":"E1212 — Unsupported instruction/opcode","href":"/errors/E1212"},{"title":"E1213 — Input bytes failed schema validation","href":"/errors/E1213"},{"title":"E1214 — Serialization failure","href":"/errors/E1214"},{"title":"E1219 — Target actor is paused by the security council","href":"/errors/E1219"},{"title":"E1220 — Target actor does not exist","href":"/errors/E1220"},{"title":"E1221 — Actor already exists at target address","href":"/errors/E1221"},{"title":"E1222 — Target account does not exist","href":"/errors/E1222"},{"title":"E1223 — Account already exists at target address","href":"/errors/E1223"},{"title":"E1224 — Referenced message id does not exist","href":"/errors/E1224"},{"title":"E1225 — Duplicate message id","href":"/errors/E1225"},{"title":"E1226 — Target mailbox is full","href":"/errors/E1226"},{"title":"E1227 — Persistent store error","href":"/errors/E1227"},{"title":"E1228 — Actor destination is permanently claimed by a wallet","href":"/errors/E1228"},{"title":"E1230 — A cross-actor call targeted a handler the caller is not authorized to invoke","href":"/errors/E1230"}]},{"group":"E1300–E1399 Entitlements / manifest","pages":[{"title":"E1302 — Invalid manifest","href":"/errors/E1302"},{"title":"E1303 — Non-system actor declared a system-only entitlement","href":"/errors/E1303"},{"title":"E1304 — Entitlement conflict","href":"/errors/E1304"},{"title":"E1305 — Entitlement param invalid","href":"/errors/E1305"},{"title":"E1306 — Actor … already holds the maximum number of entitlements; cannot grant owner funding from …","href":"/errors/E1306"}]},{"group":"E1400–E1499 CIP-20 tokens","pages":[{"title":"E1401 — Token not found","href":"/errors/E1401"},{"title":"E1402 — Token already exists","href":"/errors/E1402"},{"title":"E1403 — Insufficient token balance","href":"/errors/E1403"},{"title":"E1404 — Insufficient token allowance","href":"/errors/E1404"},{"title":"E1405 — Token account is frozen","href":"/errors/E1405"},{"title":"E1406 — Not authorized for this token operation","href":"/errors/E1406"},{"title":"E1407 — Mint would exceed max_supply","href":"/errors/E1407"},{"title":"E1408 — Transfer hook rejected the transfer","href":"/errors/E1408"},{"title":"E1409 — Transfer hook attempted reentrancy","href":"/errors/E1409"},{"title":"E1410 — Transfer hook execution failed","href":"/errors/E1410"},{"title":"E1411 — Transfer hook exceeded gas cap","href":"/errors/E1411"},{"title":"E1412 — Transfer hook exceeded cell cap","href":"/errors/E1412"},{"title":"E1413 — Permit deadline has passed","href":"/errors/E1413"},{"title":"E1414 — Permit nonce does not match","href":"/errors/E1414"},{"title":"E1415 — Permit signature does not recover to the owner","href":"/errors/E1415"},{"title":"E1416 — Token_transfer_batch does not support hooked tokens; transfer individually","href":"/errors/E1416"},{"title":"E1417 — Token id format error (not a 32-byte CIP-20 token id)","href":"/errors/E1417"}]},{"group":"E1500–E1599 Timers / deferred / commit-reveal","pages":[{"title":"E1501 — Timer limit exceeded for actor","href":"/errors/E1501"},{"title":"E1502 — Invalid deferred transaction","href":"/errors/E1502"},{"title":"E1503 — Unauthorized timer mutation","href":"/errors/E1503"},{"title":"E1510 — Commitment mismatch","href":"/errors/E1510"},{"title":"E1511 — Commit window closed","href":"/errors/E1511"},{"title":"E1512 — Reveal window not yet open","href":"/errors/E1512"},{"title":"E1513 — Reveal window closed","href":"/errors/E1513"},{"title":"E1514 — Runner already committed for this job","href":"/errors/E1514"},{"title":"E1515 — No commitment found for this runner","href":"/errors/E1515"}]},{"group":"E1600–E1699 Runner / consensus / job","pages":[{"title":"E1601 — Runner already registered","href":"/errors/E1601"},{"title":"E1602 — Runner not found","href":"/errors/E1602"},{"title":"E1603 — Insufficient stake","href":"/errors/E1603"},{"title":"E1604 — Invalid job schema","href":"/errors/E1604"},{"title":"E1605 — Job not found","href":"/errors/E1605"},{"title":"E1606 — Runner not assigned to job","href":"/errors/E1606"},{"title":"E1607 — Insufficient runners available","href":"/errors/E1607"},{"title":"E1608 — No consensus reached","href":"/errors/E1608"},{"title":"E1609 — Threshold not met","href":"/errors/E1609"},{"title":"E1610 — Non-deterministic results","href":"/errors/E1610"},{"title":"E1611 — Unsupported verification mode","href":"/errors/E1611"},{"title":"E1612 — TEE required for deterministic mode","href":"/errors/E1612"},{"title":"E1613 — Runner has active jobs","href":"/errors/E1613"},{"title":"E1614 — Runner has active delegated stake","href":"/errors/E1614"},{"title":"E1615 — Runner deregister in dispute cooldown until block","href":"/errors/E1615"},{"title":"E1616 — Job already in a terminal state; settlement runs at most once","href":"/errors/E1616"},{"title":"E1617 — Runner already submitted a result for this job","href":"/errors/E1617"},{"title":"E1618 — TEE-required job result carries no attestation envelope (CAE)","href":"/errors/E1618"},{"title":"E1619 — Measurement binding registration requires a verified chip-root proof","href":"/errors/E1619"},{"title":"E1620 — Insufficient storage-capable runners","href":"/errors/E1620"},{"title":"E1621 — The chain reported that the awaited job terminated without a result","href":"/errors/E1621"},{"title":"E1622 — Job callback needs … CBY to resume (budget … cycles, … cells at the current basefee); …","href":"/errors/E1622"}]},{"group":"E1700–E1799 CBSS","pages":[{"title":"E1700 — Cbss slashing evidence already consumed for this proxy and fault class","href":"/errors/E1700"},{"title":"E1701 — Cbss committee binding mismatch: new_committee does not match pending committee","href":"/errors/E1701"},{"title":"E1702 — Cbss operator-level duplication: same operator owns multiple proxies in this set","href":"/errors/E1702"},{"title":"E1706 — CBSS: no secret metadata for (account, key_hash)","href":"/errors/E1706"},{"title":"E1707 — CBSS: this secret version was deleted by the owner","href":"/errors/E1707"},{"title":"E1708 — CBSS: override version awaits FinalizeSecretVersion","href":"/errors/E1708"},{"title":"E1709 — CBSS: ACL/entitlement does not permit this (actor, runner)","href":"/errors/E1709"},{"title":"E1710 — CBSS: policy.tee_required: runner needs a valid CIP-23 attestation","href":"/errors/E1710"},{"title":"E1711 — CBSS: hit a per-account/secret/ACL limit","href":"/errors/E1711"},{"title":"E1712 — CBSS: fewer than t proxies responsive at fetch time","href":"/errors/E1712"},{"title":"E1713 — CBSS: initial DKG ceremony for this scope is still in flight","href":"/errors/E1713"},{"title":"E1714 — CBSS: SetSecret default path with no AccountReleaseKey on file","href":"/errors/E1714"},{"title":"E1715 — CBSS: claimed wrap_epoch != release_key.committee_epoch at submission","href":"/errors/E1715"},{"title":"E1716 — CBSS: wrapped_dek AAD mismatch or malformed length","href":"/errors/E1716"},{"title":"E1717 — CBSS: wrapped_dek.version is not the supported envelope tag (2)","href":"/errors/E1717"},{"title":"E1718 — CBSS: runner_request recipient != SecretVersion.recipient","href":"/errors/E1718"},{"title":"E1719 — CBSS: request_block outside the REQUEST_FRESHNESS_BLOCKS window","href":"/errors/E1719"},{"title":"E1720 — CBSS: liveness challenge past LIVENESS_CHALLENGE_MAX_AGE_BLOCKS","href":"/errors/E1720"},{"title":"E1721 — CBSS: committee_epoch_at_serve neither current nor a retained prior","href":"/errors/E1721"},{"title":"E1722 — CBSS: proxy release-key committee_epoch != body.serve_epoch; re-issue","href":"/errors/E1722"},{"title":"E1723 — CBSS: reshare outbox full; retry in the next block","href":"/errors/E1723"},{"title":"E1724 — CBSS: runner_request.runner_sig failed verification","href":"/errors/E1724"},{"title":"E1725 — CBSS: proxy_sig failed verification","href":"/errors/E1725"},{"title":"E1726 — CBSS: malformed partial or BLS pairing check failed","href":"/errors/E1726"},{"title":"E1727 — CBSS: (release_id, proxy_id) already recorded","href":"/errors/E1727"},{"title":"E1728 — CBSS: served_at_block out of [request_block, submission_block]","href":"/errors/E1728"},{"title":"E1729 — CBSS: release set already has t entries; extra receipts rejected","href":"/errors/E1729"},{"title":"E1730 — CBSS: committee_epoch_at_serve != quorum/serve epoch; single-epoch required","href":"/errors/E1730"},{"title":"E1731 — CBSS: (release_id, proxy_id) already has an open challenge","href":"/errors/E1731"},{"title":"E1732 — CBSS: challenge before MIN_CHALLENGE_DELAY_BLOCKS elapsed","href":"/errors/E1732"},{"title":"E1733 — CBSS: AES-GCM auth-tag mismatch on wrapped_dek or object","href":"/errors/E1733"},{"title":"E1734 — Invalid library name","href":"/errors/E1734"},{"title":"E1735 — Library not found","href":"/errors/E1735"},{"title":"E1736 — Library cap exceeded","href":"/errors/E1736"},{"title":"E1737 — Unresolved import","href":"/errors/E1737"},{"title":"E1738 — Library code parse error","href":"/errors/E1738"},{"title":"E1739 — CBSS: tlock tag exceeds MAX_TLOCK_TAG_BYTES","href":"/errors/E1739"},{"title":"E1740 — CBSS: tlock target_height not beyond MIN_TLOCK_LEAD_BLOCKS","href":"/errors/E1740"},{"title":"E1741 — CBSS: tlock request already registered","href":"/errors/E1741"},{"title":"E1742 — CBSS: tlock registration cap for this block reached","href":"/errors/E1742"},{"title":"E1743 — CBSS: tlock request not registered","href":"/errors/E1743"},{"title":"E1744 — CBSS: tlock not yet releasable (head \u003c target_height)","href":"/errors/E1744"},{"title":"E1745 — CBSS: tlock partial already submitted for this proxy","href":"/errors/E1745"},{"title":"E1746 — CIP-34: auction grant expired","href":"/errors/E1746"},{"title":"E1747 — CIP-34: auction grant nonce already used","href":"/errors/E1747"},{"title":"E1748 — CIP-34: auction already open for this request","href":"/errors/E1748"},{"title":"E1749 — CIP-34: no open auction for this request","href":"/errors/E1749"},{"title":"E1750 — CIP-34: auction closed for bids (head >= reveal_height)","href":"/errors/E1750"},{"title":"E1751 — CIP-34: sealed bidder is not a registered solver","href":"/errors/E1751"},{"title":"E1752 — CIP-34: auction bid cap reached","href":"/errors/E1752"},{"title":"E1753 — CIP-34: auction not yet revealable (head \u003c reveal_height)","href":"/errors/E1753"},{"title":"E1754 — CIP-34: tlock key not yet released for this auction","href":"/errors/E1754"}]},{"group":"E1800–E1899 Watchtower stream access","pages":[{"title":"E1800 — Not a subscriber-paid stream","href":"/errors/E1800"},{"title":"E1801 — Invalid account key","href":"/errors/E1801"},{"title":"E1802 — Account key limit reached","href":"/errors/E1802"},{"title":"E1803 — Account key revoked","href":"/errors/E1803"},{"title":"E1804 — Invalid target key epoch","href":"/errors/E1804"},{"title":"E1805 — Acquire epoch range too large","href":"/errors/E1805"},{"title":"E1806 — Minimum purchase epochs not met","href":"/errors/E1806"},{"title":"E1807 — Insufficient CBY balance","href":"/errors/E1807"},{"title":"E1808 — One or more epochs not pre-wrapped","href":"/errors/E1808"},{"title":"E1809 — Wrapped key committee epoch mismatch","href":"/errors/E1809"},{"title":"E1810 — Wrapped DEK AAD does not match canonical layout","href":"/errors/E1810"},{"title":"E1811 — Committee selector is not supported for CIP-7 content keys","href":"/errors/E1811"},{"title":"E1812 — Insufficient token balance or allowance","href":"/errors/E1812"},{"title":"E1813 — Token account frozen","href":"/errors/E1813"},{"title":"E1814 — Token supply cap exceeded","href":"/errors/E1814"},{"title":"E1815 — Actor paused","href":"/errors/E1815"},{"title":"E1817 — Event payload schema does not match the declared schema","href":"/errors/E1817"}]},{"group":"E1900–E1999 Internal / fallback","pages":[{"title":"E1900 — Unclassified error / fallback","href":"/errors/E1900"}]},{"group":"E2000–E2099 CIP-9 RAS / storage volumes","pages":[{"title":"E2000 — Volume operation rejected (E_VOLUME_NAME_DUPLICATE)","href":"/errors/E2000"},{"title":"E2001 — Volume operation rejected (E_VOLUME_ESCROW_INSUFFICIENT)","href":"/errors/E2001"},{"title":"E2002 — Volume operation rejected (E_VOLUME_PARAM_INVALID)","href":"/errors/E2002"},{"title":"E2003 — Volume operation rejected (E_VOLUME_NOT_FOUND_FOR_OWNER)","href":"/errors/E2003"},{"title":"E2004 — Manifest commit rejected (E_COMMIT_EXPIRES_EPOCH_WINDOW)","href":"/errors/E2004"},{"title":"E2005 — Volume operation rejected (E_VOLUME_RELAY_FLOOR)","href":"/errors/E2005"},{"title":"E2006 — Volume operation rejected (E_VOLUME_RELAY_UNKNOWN)","href":"/errors/E2006"},{"title":"E2007 — Volume operation rejected (E_STORAGE_WITHDRAW_BELOW_FLOOR)","href":"/errors/E2007"},{"title":"E2008 — Volume operation rejected (E_STORAGE_WITHDRAW_EXCEEDS_RESERVE)","href":"/errors/E2008"},{"title":"E2009 — Volume operation rejected (E_STORAGE_AUTO_TOP_UP_INVALID)","href":"/errors/E2009"},{"title":"E2010 — Volume operation rejected (E_STORAGE_GROWTH_BELOW_FLOOR)","href":"/errors/E2010"}]},{"title":"Unknown error code","href":"/errors/unknown"}]},{"group":"CIPs","pages":[{"title":"CIP-1: Actor Message Scheduler","href":"/cips/cip-1-actor-scheduler"},{"title":"CIP-2: Verifiable Off-Chain Compute","href":"/cips/cip-2-offchain-compute"},{"title":"CIP-3: Dual-Metered Fee Model","icon":"gauge-high","href":"/cips/cip-3-fee-model"},{"title":"CIP-4: State Storage \u0026 Persistence","icon":"database","href":"/cips/cip-4-storage"},{"title":"CIP-5: Native Timer Mechanism","icon":"clock","href":"/cips/cip-5-timers"},{"title":"CIP-6: In-PVM Actor SDK (cowboy_sdk)","icon":"code","href":"/cips/cip-6-sdk"},{"title":"CIP-7: Watchtower","icon":"tower-broadcast","href":"/cips/cip-7-simple-stream-protocol"},{"title":"CIP-8: MPP Session (Retroactive)","icon":"arrow-rotate-left","href":"/cips/cip-8-mpp-session"},{"title":"CIP-9: Runner-Backed Storage (CBFS)","href":"/cips/cip-9-runner-storage"},{"title":"CIP-10: Runner Container Runtime","href":"/cips/cip-10-runner-containers"},{"title":"CIP-11: Runner Connectivity and Push Job Delivery (r1.6)","icon":"plug","href":"/cips/cip-11-runner-connectivity"},{"title":"CIP-12: On-Chain Governance \u0026 System Actor Upgrades","icon":"gavel","href":"/cips/cip-12-governance"},{"title":"CIP-13: Runner Stake Delegation (v2)","href":"/cips/cip-13-runner-delegation"},{"title":"CIP-14: DNS-Addressable Actors","href":"/cips/cip-14-dns-addressable-actors"},{"title":"CIP-15: Public Asset Hosting and HTTP Routing","icon":"image","href":"/cips/cip-15-public-asset-hosting"},{"title":"CIP-17: Verifiable State Read RPC","icon":"shield-check","href":"/cips/cip-17-verifiable-state-read"},{"title":"CIP-18: Payments","icon":"credit-card","href":"/cips/cip-18-payments"},{"title":"CIP-19: Gateway MCP Ingress (r2)","icon":"plug","href":"/cips/cip-19-gateway-mcp-ingress"},{"title":"CIP-20: Fungible Token Standard","icon":"coins","href":"/cips/cip-20-fungible-tokens"},{"title":"CIP-26: Account-Scoped Actor Libraries","icon":"package","href":"/cips/cip-26-account-libraries"},{"title":"CIP-28: Actor Spending Limits","href":"/cips/cip-28-cowboy-agent-banking"},{"title":"CIP-29: On-chain Event Hooks","href":"/cips/cip-29-on-chain-event-hooks"},{"title":"CIP-31: CBFS Rent Schedule","href":"/cips/cip-31-cbfs-rent-schedule"},{"title":"CIP-33: Actor Hiring \u0026 Distribution","href":"/cips/cip-33-actor-hiring-and-distribution"},{"title":"CIP-34: Cross-Chain Intent Settlement","icon":"right-left","href":"/cips/cip-34-cross-chain-settlement-near-intents"},{"title":"CIP-37: Sign in with Cowboy","icon":"key","href":"/cips/cip-37-sign-in-with-cowboy"},{"title":"CIP-39: Cowboy Queue System","href":"/cips/cip-39-cowboy-queue-system"},{"title":"CIP-42: Standardized Daemon Status (/statusz)","icon":"heart-pulse","href":"/cips/cip-42-statusz"},{"title":"CIP-43: Access Meter","icon":"gauge","href":"/cips/cip-43-access-meter"},{"title":"CIP-45: Structured LLM Output","href":"/cips/cip-45-structured-llm-output"},{"title":"CIP-49: Account Authorization Policy and Recovery","icon":"key","href":"/cips/cip-49-account-auth-policy-recovery"},{"title":"CIP-50: Network Activation Heights","icon":"code-branch","href":"/cips/cip-50-network-activation"},{"title":"CIP-51: Catalog Listings","icon":"table-list","href":"/cips/cip-51-catalog-listings"},{"title":"CIP-52: The User MCP Surface","icon":"plug","href":"/cips/cip-52-mcp-user-surface"}]},{"group":"APIs and Configuration","pages":[{"title":"RPC API Reference","icon":"tower-broadcast","href":"/references/rpc-api"},{"title":"CLI configuration","icon":"sliders","href":"/references/configuration"}]},{"title":"Networks","icon":"network-wired","href":"/getting-started/networks"},{"title":"Glossary","icon":"pen-to-square","href":"/style/glossary"},{"group":"Troubleshooting and FAQ","pages":[{"title":"Troubleshooting","icon":"wrench","href":"/getting-started/troubleshooting"},{"title":"FAQ","icon":"users","href":"/getting-started/faq"}]},{"group":"Whitepapers","pages":[{"title":"Cowboy: A Layer‑1 Blockchain for Autonomous Software","href":"/whitepaper/cowboy-technical-whitepaper"},{"title":"Cowboy: Design Decisions Overview","href":"/whitepaper/cowboy-design-decisions"}]},{"group":"Contributing","pages":[{"title":"Propose Improvements","icon":"cube","href":"/contributing/how-to-propose"},{"title":"CIP Template","icon":"file-lines","href":"/cips/cip-template"}]}]}]},"basePath":"","title":"Idempotency - Cowboy","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}