Canonical, normative specification of Cowboy’s entitlements system.
This document is the canonical specification for the Cowboy Entitlements system. It defines the data model, lifecycle, enforcement rules, and the normative entitlement registry.
1. Scope and Goals
Goals
Least privilege by default.
Deterministic enforcement.
Declarative and composable permissions.
Auditable on-chain state and history.
Non-goals
UX design for entitlement configuration.
Runner market mechanisms and pricing.
Non-canonical, custom entitlement namespaces (reserved for a future release).
2. Terminology
Entitlement: A permission granting access to a capability or resource.
Actor entitlements: The set of entitlements an actor requires to execute correctly.
Runner entitlements: The set of entitlements a runner provides to off-chain jobs.
Attested entitlement: A runner entitlement that requires verifiable evidence (e.g., TEE, region).
Inheritable entitlement: An entitlement that may be passed to child actors on spawn.
Quota-bearing entitlement: An entitlement that supports parameterized limits or allowlists.
3. Canonical Data Model
Entitlements are represented as grants with a canonical structure.
Runner attestations are signed payloads to provide on-chain auditability.Canonical serialization: CBOR (RFC 8949 canonical CBOR) is used to serialize the attestation payload prior to signing.Signature: Runner EOA signs the CBOR-encoded payload using secp256k1.Deterministic ordering: Maps MUST be encoded with lexicographic key ordering as specified by canonical CBOR. Arrays MUST be sorted lexicographically by entitlement id prior to signing.
5. On-chain Storage
Actors: required entitlements are stored in the actor deployment manifest (on-chain).
Runners: provided entitlements are stored in an on-chain RunnerAttestation record.
evidence_hash MAY commit to off-chain evidence (e.g., a TEE quote bundle). The canonical attestation record is the single source of truth for scheduler matching.Time base: valid_from and valid_until are block heights (u64), not timestamps. An attestation is valid when valid_from <= current_block_height <= valid_until.
6. Enforcement Lifecycle
Deployment-Time Check (MUST)
The actor deployment transaction MUST be rejected if it declares unknown or invalid entitlements (see Section 10).
Scheduler Match (MUST)
A runner may be assigned to a job only if:
Actor.requires ⊆ Runner.provides
with parameter compatibility as defined in Section 8.
VM Syscall Gate (MUST)
Sensitive syscalls MUST fail deterministically if the corresponding entitlement is missing or its quota is exceeded.
Attestation Validity (MUST)
The scheduler MUST ignore runner attestations that are expired or invalidly signed.
7. Inheritance Rules
Only entitlements explicitly marked inheritable in the registry MAY be inherited by child actors.
Inheritance is a strict subset: child entitlements MUST be within the parent’s inheritable entitlements.
7.1 Actor Immutability
Actor code is immutable after deployment. Regular actors cannot upgrade their code.
Entitlements are immutable after deployment. Any change to entitlements requires redeployment.
To “upgrade” a regular actor, deploy a new actor at a new address. The old actor MAY implement a migration pattern (e.g., forwarding calls to the new address).
System actors (e.g., governance, bridge, blob storage) MAY be upgraded in-place if they hold the sys.upgrade entitlement. See Section 9.2.
8. Parameter Compatibility
When an entitlement has parameters, a runner provides a superset of an actor’s requirements. Examples:
allowlist_domains: actor set must be a subset of runner’s allowlist, or runner uses *.
max_* quotas: runner’s quota must be greater than or equal to actor’s requirement.
8.1 Parameter Types and Units
Unless otherwise specified in the registry:
All max_* and min_* parameters are unsigned integers.
max_amount is measured in base CBY units (integer).
max_bytes is measured in bytes (integer).
max_tokens counts model tokens (integer).
min_vram_gb is measured in GiB (integer).
8.2 Domain Matching
Domains are case-insensitive and MUST be normalized to ASCII punycode.
* denotes all domains.
*.example.com matches any subdomain of example.com but not the apex domain unless explicitly listed.
Exact matches (api.example.com) MUST match the normalized host.
8.3 Set and Range Matching
For set parameters (e.g., allowlist_domains, allowlist_assets, allowlist_contracts), the actor’s set MUST be a subset of the runner’s set, or the runner MUST provide *.
For range parameters (e.g., max_requests, max_tokens, max_bytes), the runner’s value MUST be greater than or equal to the actor’s value.
For equality parameters (e.g., region, tee_type), the values MUST be equal.
8.4 Domain Sets
domain_set references a curated set of domains defined by governance.
If both domain_set and allowlist_domains are provided, the effective allowlist is their union.
Runner matching MUST be performed against the effective allowlist.
A runner providing allowlist_domains: ["*"] is a superset of all domain sets and explicit allowlists. Wildcard always satisfies any actor domain requirement.
9. Normative Entitlement Registry
The following registry is canonical for v1. Any entitlement not listed here is invalid.
9.1 Execution & Lifecycle
ID
Description
Inheritable
Attested
Quota
Params
exec.spawn
Allow spawning child actors.
✅
❌
✅
max_children
9.2 System (Governance-Controlled)
ID
Description
Inheritable
Attested
Quota
Params
sys.upgrade
Actor may upgrade its own code hash in-place.
❌
❌
❌
—
The sys.upgrade entitlement is reserved for system actors. Only addresses in the System Deployer Allowlist (defined in the genesis config at genesis.system_deployers) may deploy actors with this entitlement. Deployments from other addresses MUST be rejected. This entitlement cannot be revoked once granted.
9.3 Networking (HTTP Egress)
ID
Description
Inheritable
Attested
Quota
Params
http.fetch
HTTP(S) egress via runner.
✅
✅
✅
allowlist_domains, domain_set, max_requests
9.3.1 Networking (HTTP Ingress)
Added by CIP-14 (DNS-Addressable Actors §6.1). Enforced at the Gateway and Route Registry, not within the PVM.
ID
Description
Inheritable
Attested
Quota
Params
ingress.http
Actor may receive inbound HTTP requests via Gateway.
Dispatch a CIP-10 container job (runner.container); with secrets.read, the job’s secret_env names are released into the sandbox.
✅
✅
✅
max_requests
9.6 Security & Privacy
ID
Description
Inheritable
Attested
Quota
Params
sec.tee_required
Require execution in TEE.
✅
✅
❌
tee_type
sec.data_residency
Require data to remain in a region.
✅
✅
❌
region
9.7 Economics & Funds
ID
Description
Inheritable
Attested
Quota
Params
econ.hold_balance
Actor may hold a persistent CBY balance across executions. Without this, actors can only pass through funds within a single transaction.
✅
❌
❌
—
econ.transfer
Actor may transfer CBY.
❌
❌
✅
max_amount, max_per_block
9.8 Timers & Scheduling
ID
Description
Inheritable
Attested
Quota
Params
timer.schedule
Actor may schedule timers.
✅
❌
✅
max_timers
9.9 Interoperability (Ethereum)
ID
Description
Inheritable
Attested
Quota
Params
bridge.asset
Bridge assets to/from Ethereum.
❌
❌
✅
allowlist_assets
bridge.subscribe_event
Subscribe to Ethereum events.
❌
❌
✅
allowlist_contracts
9.10 Registry Governance and Versioning
The entitlement registry is defined by the protocol specification for a given protocol version.
Changes to the registry require governance approval and a protocol version update.
Nodes MUST reject any entitlement ID not present in the registry for their protocol version.
9.11 Entitlement Deprecation and Removal
When an entitlement is scheduled for removal, the following deprecation process applies:
Deprecation announcement: A governance proposal marks the entitlement as deprecated starting at block height H.
Deprecation window: For blocks H to H + DEPRECATION_WINDOW, the entitlement remains functional but:
New actor deployments using the deprecated entitlement emit a warning event.
The entitlement is flagged in on-chain queries and explorer UIs.
Removal: At block H + DEPRECATION_WINDOW + 1:
The entitlement is removed from the registry.
Actors still holding the entitlement become non-executable until redeployed with a valid entitlement set.
Scheduler MUST NOT assign jobs to non-executable actors.
DEPRECATION_WINDOW: The minimum deprecation window is defined by governance, with a recommended default of 604,800 blocks (~7 days at 1s block time).Non-executable state: An actor in non-executable state:
Retains its on-chain state and balance.
Cannot process messages or be scheduled.
Can be redeployed by its owner with an updated manifest.
Emits ActorNonExecutable event at the block of removal.
9.12 Parameter Schemas
Param
Type
Description
max_children
u64
Max child actors that may be spawned.
allowlist_domains
array<string>
Hostnames or * wildcard.
domain_set
string
Name of curated domain set.
max_requests
u64
Max HTTP, LLM, or container requests per execution.
max_bytes
u64
Byte limit for storage or blob I/O.
max_tokens
u64
Max tokens per LLM request within a single execution.
min_vram_gb
u64
Minimum GPU VRAM in GiB.
tee_type
string
TEE type identifier (see Section 9.13).
region
string
Region identifier (see Section 9.14).
max_amount
u64
Max CBY amount per transfer (base units).
max_per_block
u64
Max CBY total per block (base units).
max_timers
u64
Max active timers per actor.
allowlist_assets
array<string>
Asset identifiers (e.g., token addresses).
allowlist_contracts
array<Address>
Contract addresses permitted for subscriptions.
allowlist_methods
array<string>
HTTP methods the actor accepts for ingress; * permits all.
max_request_bytes
u64
Maximum ingress request body size in bytes.
max_response_bytes
u64
Maximum ingress response body size in bytes.
max_query_cycles
u64
Maximum PVM cycles per query-path ingress request.
9.13 Canonical TEE Types
Valid tee_type values are:
sgx
sev
tdx
9.14 Canonical Regions
Valid region values are:
us
eu
uk
cn
apac
10. Validation Rules
Unknown entitlements are invalid (custom entitlements are not allowed in v1).
Parameter schemas are mandatory when the registry lists params.
Duplicate entitlements MUST be rejected (only one grant per ID).
Invalid parameter types or units MUST be rejected.
Non-canonical domain formats MUST be rejected.
Entitlement lists MUST be sorted lexicographically by id.
sys.upgrade is restricted: Deployments including sys.upgrade from addresses not in genesis.system_deployers MUST be rejected with ERR_SYSTEM_ENTITLEMENT_UNAUTHORIZED.
11. Errors and Determinism
Missing entitlements and quota violations MUST result in deterministic VM traps:
{"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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/entitlements/entitlements-specification","slug":"/architecture/entitlements/entitlements-specification","pageMetadata":{"title":"Entitlements Specification","description":"Canonical, normative specification of Cowboy's entitlements system.","href":"/architecture/entitlements/entitlements-specification"},"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: \"Canonical, normative specification of Cowboy’s entitlements system.\"\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={br:`br`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This document is the canonical specification for the Cowboy Entitlements system. It defines the data model, lifecycle, enforcement rules, and the normative entitlement registry.`}),`\n`,_jsx(Heading,{level:`2`,id:`1-scope-and-goals`,children:`1. Scope and Goals`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Goals`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Least privilege by default.`}),`\n`,_jsx(_components.li,{children:`Deterministic enforcement.`}),`\n`,_jsx(_components.li,{children:`Declarative and composable permissions.`}),`\n`,_jsx(_components.li,{children:`Auditable on-chain state and history.`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Non-goals`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`UX design for entitlement configuration.`}),`\n`,_jsx(_components.li,{children:`Runner market mechanisms and pricing.`}),`\n`,_jsx(_components.li,{children:`Non-canonical, custom entitlement namespaces (reserved for a future release).`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`2-terminology`,children:`2. Terminology`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Entitlement`}),`: A permission granting access to a capability or resource.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Actor entitlements`}),`: The set of entitlements an actor `,_jsx(_components.strong,{children:`requires`}),` to execute correctly.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Runner entitlements`}),`: The set of entitlements a runner `,_jsx(_components.strong,{children:`provides`}),` to off-chain jobs.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Attested entitlement`}),`: A runner entitlement that requires verifiable evidence (e.g., TEE, region).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Inheritable entitlement`}),`: An entitlement that may be passed to child actors on spawn.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quota-bearing entitlement`}),`: An entitlement that supports parameterized limits or allowlists.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`3-canonical-data-model`,children:`3. Canonical Data Model`}),`\n`,_jsxs(_components.p,{children:[`Entitlements are represented as `,_jsx(_components.strong,{children:`grants`}),` with a canonical structure.`]}),`\n`,_jsx(Heading,{level:`3`,id:`3-1-entitlement-id`,children:`3.1 Entitlement ID`}),`\n`,_jsx(_components.p,{children:`An entitlement ID is a dotted string:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`http.fetch`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`storage.kv`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`econ.transfer`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`sec.tee_required`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`3-2-entitlement-grant`,children:`3.2 Entitlement Grant`}),`\n`,_jsx(_components.p,{children:`An entitlement grant has the following fields:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`EntitlementGrant {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id: string`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` params?: map\u003cstring, value>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`params`}),` MAY be omitted if the entitlement has no parameters. Parameter schemas are defined in the registry in Section 9.`]}),`\n`,_jsx(Heading,{level:`3`,id:`3-3-actor-manifest-requires`,children:`3.3 Actor Manifest (Requires)`}),`\n`,_jsxs(_components.p,{children:[`Actor deployment manifests MUST declare entitlements as a list of `,_jsx(_components.code,{children:`EntitlementGrant`}),`:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"entitlements\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"econ.transfer\", \"params\": {\"max_amount\": 1000}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"http.fetch\", \"params\": {\"allowlist_domains\": [\"api.coingecko.com\"]}}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`3-4-runner-attestation-provides`,children:`3.4 Runner Attestation (Provides)`}),`\n`,_jsxs(_components.p,{children:[`Runner capability attestations MUST declare entitlements as a list of `,_jsx(_components.code,{children:`EntitlementGrant`}),`:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"capabilities\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"http.fetch\", \"params\": {\"allowlist_domains\": [\"*\"]}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"sec.tee_required\"}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`4-serialization-and-signing`,children:`4. Serialization and Signing`}),`\n`,_jsx(_components.p,{children:`Runner attestations are signed payloads to provide on-chain auditability.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Canonical serialization`}),`: CBOR (RFC 8949 canonical CBOR) is used to serialize the attestation payload prior to signing.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Signature`}),`: Runner EOA signs the CBOR-encoded payload using `,_jsx(_components.code,{children:`secp256k1`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deterministic ordering`}),`: Maps MUST be encoded with lexicographic key ordering as specified by canonical CBOR. Arrays MUST be sorted lexicographically by entitlement `,_jsx(_components.code,{children:`id`}),` prior to signing.`]}),`\n`,_jsx(Heading,{level:`2`,id:`5-on-chain-storage`,children:`5. On-chain Storage`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Actors`}),`: required entitlements are stored in the actor deployment manifest (on-chain).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Runners`}),`: provided entitlements are stored in an on-chain `,_jsx(_components.code,{children:`RunnerAttestation`}),` record.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`5-1-runnerattestation-record`,children:`5.1 RunnerAttestation Record`}),`\n`,_jsx(CodeBlock,{numberOfLines:`9`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`RunnerAttestation {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` runner_id: Address`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` capabilities: [EntitlementGrant]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_from: u64`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_until: u64`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` evidence_hash?: Hash`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` signature: Signature`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`evidence_hash`}),` MAY commit to off-chain evidence (e.g., a TEE quote bundle). The canonical attestation record is the single source of truth for scheduler matching.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Time base`}),`: `,_jsx(_components.code,{children:`valid_from`}),` and `,_jsx(_components.code,{children:`valid_until`}),` are `,_jsx(_components.strong,{children:`block heights`}),` (`,_jsx(_components.code,{children:`u64`}),`), not timestamps. An attestation is valid when `,_jsx(_components.code,{children:`valid_from \u003c= current_block_height \u003c= valid_until`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`6-enforcement-lifecycle`,children:`6. Enforcement Lifecycle`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deployment-Time Check (MUST)`}),_jsx(_components.br,{}),`\n`,`The actor deployment transaction MUST be rejected if it declares unknown or invalid entitlements (see Section 10).`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scheduler Match (MUST)`}),_jsx(_components.br,{}),`\n`,`A runner may be assigned to a job only if:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Actor.requires ⊆ Runner.provides`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`with parameter compatibility as defined in Section 8.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`VM Syscall Gate (MUST)`}),_jsx(_components.br,{}),`\n`,`Sensitive syscalls MUST fail deterministically if the corresponding entitlement is missing or its quota is exceeded.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Attestation Validity (MUST)`}),_jsx(_components.br,{}),`\n`,`The scheduler MUST ignore runner attestations that are expired or invalidly signed.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`7-inheritance-rules`,children:`7. Inheritance Rules`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Only entitlements explicitly marked `,_jsx(_components.strong,{children:`inheritable`}),` in the registry MAY be inherited by child actors.`]}),`\n`,_jsx(_components.li,{children:`Inheritance is a strict subset: child entitlements MUST be within the parent’s inheritable entitlements.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`7-1-actor-immutability`,children:`7.1 Actor Immutability`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Actor code is immutable after deployment.`}),` Regular actors cannot upgrade their code.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Entitlements are immutable after deployment.`}),` Any change to entitlements requires redeployment.`]}),`\n`,_jsx(_components.li,{children:`To “upgrade” a regular actor, deploy a new actor at a new address. The old actor MAY implement a migration pattern (e.g., forwarding calls to the new address).`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`System actors`}),` (e.g., governance, bridge, blob storage) MAY be upgraded in-place if they hold the `,_jsx(_components.code,{children:`sys.upgrade`}),` entitlement. See Section 9.2.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`8-parameter-compatibility`,children:`8. Parameter Compatibility`}),`\n`,_jsxs(_components.p,{children:[`When an entitlement has parameters, a runner provides a `,_jsx(_components.strong,{children:`superset`}),` of an actor’s requirements. Examples:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allowlist_domains`}),`: actor set must be a subset of runner’s allowlist, or runner uses `,_jsx(_components.code,{children:`*`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`max_*`}),` quotas: runner’s quota must be greater than or equal to actor’s requirement.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`8-1-parameter-types-and-units`,children:`8.1 Parameter Types and Units`}),`\n`,_jsx(_components.p,{children:`Unless otherwise specified in the registry:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`All `,_jsx(_components.code,{children:`max_*`}),` and `,_jsx(_components.code,{children:`min_*`}),` parameters are `,_jsx(_components.strong,{children:`unsigned integers`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`max_amount`}),` is measured in `,_jsx(_components.strong,{children:`base CBY units`}),` (integer).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`max_bytes`}),` is measured in `,_jsx(_components.strong,{children:`bytes`}),` (integer).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`max_tokens`}),` counts `,_jsx(_components.strong,{children:`model tokens`}),` (integer).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`min_vram_gb`}),` is measured in `,_jsx(_components.strong,{children:`GiB`}),` (integer).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`8-2-domain-matching`,children:`8.2 Domain Matching`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Domains are `,_jsx(_components.strong,{children:`case-insensitive`}),` and MUST be normalized to ASCII punycode.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`*`}),` denotes all domains.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`*.example.com`}),` matches any subdomain of `,_jsx(_components.code,{children:`example.com`}),` but not the apex domain unless explicitly listed.`]}),`\n`,_jsxs(_components.li,{children:[`Exact matches (`,_jsx(_components.code,{children:`api.example.com`}),`) MUST match the normalized host.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`8-3-set-and-range-matching`,children:`8.3 Set and Range Matching`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`For set parameters (e.g., `,_jsx(_components.code,{children:`allowlist_domains`}),`, `,_jsx(_components.code,{children:`allowlist_assets`}),`, `,_jsx(_components.code,{children:`allowlist_contracts`}),`), the actor’s set MUST be a subset of the runner’s set, or the runner MUST provide `,_jsx(_components.code,{children:`*`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`For range parameters (e.g., `,_jsx(_components.code,{children:`max_requests`}),`, `,_jsx(_components.code,{children:`max_tokens`}),`, `,_jsx(_components.code,{children:`max_bytes`}),`), the runner’s value MUST be greater than or equal to the actor’s value.`]}),`\n`,_jsxs(_components.li,{children:[`For equality parameters (e.g., `,_jsx(_components.code,{children:`region`}),`, `,_jsx(_components.code,{children:`tee_type`}),`), the values MUST be equal.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`8-4-domain-sets`,children:`8.4 Domain Sets`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`domain_set`}),` references a curated set of domains defined by governance.`]}),`\n`,_jsxs(_components.li,{children:[`If both `,_jsx(_components.code,{children:`domain_set`}),` and `,_jsx(_components.code,{children:`allowlist_domains`}),` are provided, the effective allowlist is their `,_jsx(_components.strong,{children:`union`}),`.`]}),`\n`,_jsx(_components.li,{children:`Runner matching MUST be performed against the effective allowlist.`}),`\n`,_jsxs(_components.li,{children:[`A runner providing `,_jsx(_components.code,{children:`allowlist_domains: [\"*\"]`}),` is a `,_jsx(_components.strong,{children:`superset of all domain sets and explicit allowlists`}),`. Wildcard always satisfies any actor domain requirement.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`9-normative-entitlement-registry`,children:`9. Normative Entitlement Registry`}),`\n`,_jsx(_components.p,{children:`The following registry is canonical for v1. Any entitlement not listed here is invalid.`}),`\n`,_jsx(Heading,{level:`3`,id:`9-1-execution-\u0026-lifecycle`,children:`9.1 Execution \u0026 Lifecycle`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`exec.spawn`})}),_jsx(_components.td,{children:`Allow spawning child actors.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`max_children`})})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-2-system-governance-controlled`,children:`9.2 System (Governance-Controlled)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sys.upgrade`})}),_jsx(_components.td,{children:`Actor may upgrade its own code hash in-place.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{children:`—`})]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`sys.upgrade`}),` entitlement is reserved for system actors. Only addresses in the `,_jsx(_components.strong,{children:`System Deployer Allowlist`}),` (defined in the genesis config at `,_jsx(_components.code,{children:`genesis.system_deployers`}),`) may deploy actors with this entitlement. Deployments from other addresses MUST be rejected. This entitlement cannot be revoked once granted.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`9-3-networking-http-egress`,children:`9.3 Networking (HTTP Egress)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`http.fetch`})}),_jsx(_components.td,{children:`HTTP(S) egress via runner.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`allowlist_domains`}),`, `,_jsx(_components.code,{children:`domain_set`}),`, `,_jsx(_components.code,{children:`max_requests`})]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-3-1-networking-http-ingress`,children:`9.3.1 Networking (HTTP Ingress)`}),`\n`,_jsx(_components.p,{children:`Added by CIP-14 (DNS-Addressable Actors §6.1). Enforced at the Gateway and Route Registry, not within the PVM.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ingress.http`})}),_jsx(_components.td,{children:`Actor may receive inbound HTTP requests via Gateway.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`allowlist_methods`}),`, `,_jsx(_components.code,{children:`max_request_bytes`}),`, `,_jsx(_components.code,{children:`max_response_bytes`}),`, `,_jsx(_components.code,{children:`max_query_cycles`})]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-4-storage-\u0026-state`,children:`9.4 Storage \u0026 State`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`storage.kv`})}),_jsx(_components.td,{children:`Access to actor KV store.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`max_bytes`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`storage.blob`})}),_jsx(_components.td,{children:`Blob I/O via system blob actor.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`max_bytes`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-5-off-chain-compute`,children:`9.5 Off-chain Compute`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`oracle.llm`})}),_jsx(_components.td,{children:`Request LLM inference.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`max_tokens`}),`, `,_jsx(_components.code,{children:`max_requests`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`accel.gpu`})}),_jsx(_components.td,{children:`Require GPU for execution.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`min_vram_gb`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`container.run`})}),_jsxs(_components.td,{children:[`Dispatch a CIP-10 container job (`,_jsx(_components.code,{children:`runner.container`}),`); with `,_jsx(_components.code,{children:`secrets.read`}),`, the job’s `,_jsx(_components.code,{children:`secret_env`}),` names are released into the sandbox.`]}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`max_requests`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-6-security-\u0026-privacy`,children:`9.6 Security \u0026 Privacy`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sec.tee_required`})}),_jsx(_components.td,{children:`Require execution in TEE.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`tee_type`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sec.data_residency`})}),_jsx(_components.td,{children:`Require data to remain in a region.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`region`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-7-economics-\u0026-funds`,children:`9.7 Economics \u0026 Funds`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`econ.hold_balance`})}),_jsx(_components.td,{children:`Actor may hold a persistent CBY balance across executions. Without this, actors can only pass through funds within a single transaction.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`econ.transfer`})}),_jsx(_components.td,{children:`Actor may transfer CBY.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`max_amount`}),`, `,_jsx(_components.code,{children:`max_per_block`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-8-timers-\u0026-scheduling`,children:`9.8 Timers \u0026 Scheduling`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`timer.schedule`})}),_jsx(_components.td,{children:`Actor may schedule timers.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`max_timers`})})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-9-interoperability-ethereum`,children:`9.9 Interoperability (Ethereum)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ID`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Inheritable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Attested`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Quota`}),_jsx(_components.th,{children:`Params`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bridge.asset`})}),_jsx(_components.td,{children:`Bridge assets to/from Ethereum.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_assets`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bridge.subscribe_event`})}),_jsx(_components.td,{children:`Subscribe to Ethereum events.`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`❌`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✅`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_contracts`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-10-registry-governance-and-versioning`,children:`9.10 Registry Governance and Versioning`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The entitlement registry is defined by the protocol specification for a given protocol version.`}),`\n`,_jsx(_components.li,{children:`Changes to the registry require governance approval and a protocol version update.`}),`\n`,_jsx(_components.li,{children:`Nodes MUST reject any entitlement ID not present in the registry for their protocol version.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`9-11-entitlement-deprecation-and-removal`,children:`9.11 Entitlement Deprecation and Removal`}),`\n`,_jsx(_components.p,{children:`When an entitlement is scheduled for removal, the following deprecation process applies:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Deprecation announcement`}),`: A governance proposal marks the entitlement as `,_jsx(_components.code,{children:`deprecated`}),` starting at block height `,_jsx(_components.code,{children:`H`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Deprecation window`}),`: For blocks `,_jsx(_components.code,{children:`H`}),` to `,_jsx(_components.code,{children:`H + DEPRECATION_WINDOW`}),`, the entitlement remains functional but:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`New actor deployments using the deprecated entitlement emit a warning event.`}),`\n`,_jsx(_components.li,{children:`The entitlement is flagged in on-chain queries and explorer UIs.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Removal`}),`: At block `,_jsx(_components.code,{children:`H + DEPRECATION_WINDOW + 1`}),`:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The entitlement is removed from the registry.`}),`\n`,_jsxs(_components.li,{children:[`Actors still holding the entitlement become `,_jsx(_components.strong,{children:`non-executable`}),` until redeployed with a valid entitlement set.`]}),`\n`,_jsx(_components.li,{children:`Scheduler MUST NOT assign jobs to non-executable actors.`}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`DEPRECATION_WINDOW`}),`: The minimum deprecation window is defined by governance, with a recommended default of 604,800 blocks (~7 days at 1s block time).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Non-executable state`}),`: An actor in non-executable state:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Retains its on-chain state and balance.`}),`\n`,_jsx(_components.li,{children:`Cannot process messages or be scheduled.`}),`\n`,_jsx(_components.li,{children:`Can be redeployed by its owner with an updated manifest.`}),`\n`,_jsxs(_components.li,{children:[`Emits `,_jsx(_components.code,{children:`ActorNonExecutable`}),` event at the block of removal.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`9-12-parameter-schemas`,children:`9.12 Parameter Schemas`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Param`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_children`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max child actors that may be spawned.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_domains`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cstring>`})}),_jsxs(_components.td,{children:[`Hostnames or `,_jsx(_components.code,{children:`*`}),` wildcard.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`domain_set`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Name of curated domain set.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_requests`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max HTTP, LLM, or container requests per execution.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_bytes`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Byte limit for storage or blob I/O.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_tokens`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max tokens per LLM request within a single execution.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`min_vram_gb`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Minimum GPU VRAM in GiB.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tee_type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`TEE type identifier (see Section 9.13).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`region`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Region identifier (see Section 9.14).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_amount`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max CBY amount per transfer (base units).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_per_block`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max CBY total per block (base units).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_timers`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Max active timers per actor.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_assets`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cstring>`})}),_jsx(_components.td,{children:`Asset identifiers (e.g., token addresses).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_contracts`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cAddress>`})}),_jsx(_components.td,{children:`Contract addresses permitted for subscriptions.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`allowlist_methods`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cstring>`})}),_jsxs(_components.td,{children:[`HTTP methods the actor accepts for ingress; `,_jsx(_components.code,{children:`*`}),` permits all.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_request_bytes`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Maximum ingress request body size in bytes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_response_bytes`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Maximum ingress response body size in bytes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_query_cycles`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`u64`})}),_jsx(_components.td,{children:`Maximum PVM cycles per query-path ingress request.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`9-13-canonical-tee-types`,children:`9.13 Canonical TEE Types`}),`\n`,_jsxs(_components.p,{children:[`Valid `,_jsx(_components.code,{children:`tee_type`}),` values are:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`sgx`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`sev`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`tdx`})}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`9-14-canonical-regions`,children:`9.14 Canonical Regions`}),`\n`,_jsxs(_components.p,{children:[`Valid `,_jsx(_components.code,{children:`region`}),` values are:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`us`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`eu`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`uk`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cn`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`apac`})}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`10-validation-rules`,children:`10. Validation Rules`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unknown entitlements are invalid`}),` (custom entitlements are not allowed in v1).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Parameter schemas are mandatory`}),` when the registry lists params.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Duplicate entitlements`}),` MUST be rejected (only one grant per ID).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Invalid parameter types or units`}),` MUST be rejected.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Non-canonical domain formats`}),` MUST be rejected.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Entitlement lists MUST be sorted`}),` lexicographically by `,_jsx(_components.code,{children:`id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`sys.upgrade`}),` is restricted`]}),`: Deployments including `,_jsx(_components.code,{children:`sys.upgrade`}),` from addresses not in `,_jsx(_components.code,{children:`genesis.system_deployers`}),` MUST be rejected with `,_jsx(_components.code,{children:`ERR_SYSTEM_ENTITLEMENT_UNAUTHORIZED`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`11-errors-and-determinism`,children:`11. Errors and Determinism`}),`\n`,_jsx(_components.p,{children:`Missing entitlements and quota violations MUST result in deterministic VM traps:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`ERR_MISSING_ENTITLEMENT`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`ERR_ENTITLEMENT_QUOTA_EXCEEDED`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`ERR_ENTITLEMENT_PARAM_INVALID`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ERR_ACTOR_NON_EXECUTABLE`}),` (actor holds deprecated/removed entitlement)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ERR_SYSTEM_ENTITLEMENT_UNAUTHORIZED`}),` (non-system deployer requested `,_jsx(_components.code,{children:`sys.upgrade`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`12-examples`,children:`12. Examples`}),`\n`,_jsx(Heading,{level:`3`,id:`12-1-trading-bot-actor-manifest`,children:`12.1 Trading Bot (Actor Manifest)`}),`\n`,_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"entitlements\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"econ.transfer\", \"params\": {\"max_amount\": 1000}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"http.fetch\", \"params\": {\"allowlist_domains\": [\"api.coingecko.com\"]}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"oracle.llm\", \"params\": {\"max_tokens\": 2000}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"storage.kv\", \"params\": {\"max_bytes\": 1048576}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"timer.schedule\", \"params\": {\"max_timers\": 10}}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`12-2-runner-attestation`,children:`12.2 Runner Attestation`}),`\n`,_jsx(CodeBlock,{numberOfLines:`13`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"runner_id\": \"0x...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"capabilities\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"http.fetch\", \"params\": {\"allowlist_domains\": [\"*\"]}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"oracle.llm\", \"params\": {\"max_tokens\": 100000}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"sec.tee_required\", \"params\": {\"tee_type\": \"sgx\"}}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"valid_from\": 1700000000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"valid_until\": 1710000000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"evidence_hash\": \"0x...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"signature\": \"0x...\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`appendix-a-cddl-schema`,children:`Appendix A: CDDL Schema`}),`\n`,_jsx(_components.p,{children:`The following CDDL (RFC 8610) schema defines the canonical wire format for entitlements.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`44`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`44`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Entitlement grant`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`entitlement-grant = {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id: tstr,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ? params: param-map`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Parameter map (keys and values depend on entitlement)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`param-map = {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` * tstr => param-value`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`param-value = uint / tstr / [* tstr] / [* address]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Address is a 20-byte value`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`address = bstr .size 20`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Hash is a 32-byte value`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`hash = bstr .size 32`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Signature is a 65-byte secp256k1 recoverable signature`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`signature = bstr .size 65`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Actor manifest entitlements array (sorted by id)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`actor-entitlements = [* entitlement-grant]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Runner attestation record`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`runner-attestation = {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` runner_id: address,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` capabilities: [* entitlement-grant],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_from: uint,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_until: uint,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ? evidence_hash: hash,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` signature: signature`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`; Signing preimage (excludes signature field)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`runner-attestation-preimage = {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` capabilities: [* entitlement-grant],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ? evidence_hash: hash,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` runner_id: address,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_from: uint,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` valid_until: uint`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`appendix-b-cbor-signing-preimage`,children:`Appendix B: CBOR Signing Preimage`}),`\n`,_jsxs(_components.p,{children:[`The runner attestation is signed over the CBOR-encoded payload below. Keys are sorted lexicographically, and arrays are sorted by entitlement `,_jsx(_components.code,{children:`id`}),`:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"capabilities\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"http.fetch\", \"params\": {\"allowlist_domains\": [\"*\"]}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"oracle.llm\", \"params\": {\"max_tokens\": 100000}},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` {\"id\": \"sec.tee_required\", \"params\": {\"tee_type\": \"sgx\"}}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"evidence_hash\": \"0x...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"runner_id\": \"0x...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"valid_from\": 1700000000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"valid_until\": 1710000000`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}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":"Entitlements Specification","description":"Canonical, normative specification of Cowboy's entitlements system.","href":"/architecture/entitlements/entitlements-specification"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Scope and Goals","slug":"1-scope-and-goals","depth":2,"children":[]},{"title":"2. Terminology","slug":"2-terminology","depth":2,"children":[]},{"title":"3. Canonical Data Model","slug":"3-canonical-data-model","depth":2,"children":[{"title":"3.1 Entitlement ID","slug":"3-1-entitlement-id","depth":3,"children":[]},{"title":"3.2 Entitlement Grant","slug":"3-2-entitlement-grant","depth":3,"children":[]},{"title":"3.3 Actor Manifest (Requires)","slug":"3-3-actor-manifest-requires","depth":3,"children":[]},{"title":"3.4 Runner Attestation (Provides)","slug":"3-4-runner-attestation-provides","depth":3,"children":[]}]},{"title":"4. Serialization and Signing","slug":"4-serialization-and-signing","depth":2,"children":[]},{"title":"5. On-chain Storage","slug":"5-on-chain-storage","depth":2,"children":[{"title":"5.1 RunnerAttestation Record","slug":"5-1-runnerattestation-record","depth":3,"children":[]}]},{"title":"6. Enforcement Lifecycle","slug":"6-enforcement-lifecycle","depth":2,"children":[]},{"title":"7. Inheritance Rules","slug":"7-inheritance-rules","depth":2,"children":[{"title":"7.1 Actor Immutability","slug":"7-1-actor-immutability","depth":3,"children":[]}]},{"title":"8. Parameter Compatibility","slug":"8-parameter-compatibility","depth":2,"children":[{"title":"8.1 Parameter Types and Units","slug":"8-1-parameter-types-and-units","depth":3,"children":[]},{"title":"8.2 Domain Matching","slug":"8-2-domain-matching","depth":3,"children":[]},{"title":"8.3 Set and Range Matching","slug":"8-3-set-and-range-matching","depth":3,"children":[]},{"title":"8.4 Domain Sets","slug":"8-4-domain-sets","depth":3,"children":[]}]},{"title":"9. Normative Entitlement Registry","slug":"9-normative-entitlement-registry","depth":2,"children":[{"title":"9.1 Execution \u0026 Lifecycle","slug":"9-1-execution-\u0026-lifecycle","depth":3,"children":[]},{"title":"9.2 System (Governance-Controlled)","slug":"9-2-system-governance-controlled","depth":3,"children":[]},{"title":"9.3 Networking (HTTP Egress)","slug":"9-3-networking-http-egress","depth":3,"children":[]},{"title":"9.3.1 Networking (HTTP Ingress)","slug":"9-3-1-networking-http-ingress","depth":3,"children":[]},{"title":"9.4 Storage \u0026 State","slug":"9-4-storage-\u0026-state","depth":3,"children":[]},{"title":"9.5 Off-chain Compute","slug":"9-5-off-chain-compute","depth":3,"children":[]},{"title":"9.6 Security \u0026 Privacy","slug":"9-6-security-\u0026-privacy","depth":3,"children":[]},{"title":"9.7 Economics \u0026 Funds","slug":"9-7-economics-\u0026-funds","depth":3,"children":[]},{"title":"9.8 Timers \u0026 Scheduling","slug":"9-8-timers-\u0026-scheduling","depth":3,"children":[]},{"title":"9.9 Interoperability (Ethereum)","slug":"9-9-interoperability-ethereum","depth":3,"children":[]},{"title":"9.10 Registry Governance and Versioning","slug":"9-10-registry-governance-and-versioning","depth":3,"children":[]},{"title":"9.11 Entitlement Deprecation and Removal","slug":"9-11-entitlement-deprecation-and-removal","depth":3,"children":[]},{"title":"9.12 Parameter Schemas","slug":"9-12-parameter-schemas","depth":3,"children":[]},{"title":"9.13 Canonical TEE Types","slug":"9-13-canonical-tee-types","depth":3,"children":[]},{"title":"9.14 Canonical Regions","slug":"9-14-canonical-regions","depth":3,"children":[]}]},{"title":"10. Validation Rules","slug":"10-validation-rules","depth":2,"children":[]},{"title":"11. Errors and Determinism","slug":"11-errors-and-determinism","depth":2,"children":[]},{"title":"12. Examples","slug":"12-examples","depth":2,"children":[{"title":"12.1 Trading Bot (Actor Manifest)","slug":"12-1-trading-bot-actor-manifest","depth":3,"children":[]},{"title":"12.2 Runner Attestation","slug":"12-2-runner-attestation","depth":3,"children":[]}]},{"title":"Appendix A: CDDL Schema","slug":"appendix-a-cddl-schema","depth":2,"children":[]},{"title":"Appendix B: CBOR Signing Preimage","slug":"appendix-b-cbor-signing-preimage","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cowboylabsllc","siteName":"Cowboy","title":"Entitlements Specification - Cowboy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T13:24:50.809Z","originalFileLocation":"architecture/entitlements/entitlements-specification.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=\"Canonical, normative specification of Cowboy\u0026#x27;s entitlements system.\">\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=\"Entitlements Specification - Cowboy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Canonical, normative specification of Cowboy\u0026#x27;s entitlements system.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cowboy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification\">\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=Entitlements\u0026amp;title=Entitlements+Specification\u0026amp;description=Canonical%2C+normative+specification+of+Cowboy%27s+entitlements+system.\u0026amp;theme=70482cd297530a4132dadc59\u0026amp;signature=dad743bb058e7c8aa047e2871e714fa32c9a7a82b0b90b2a92a90c4315e1e718\">\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=\"Entitlements Specification - Cowboy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Canonical, normative specification of Cowboy\u0026#x27;s entitlements system.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cowboylabsllc.mintlify.site/_mintlify/api/og/v2?division=Entitlements\u0026amp;title=Entitlements+Specification\u0026amp;description=Canonical%2C+normative+specification+of+Cowboy%27s+entitlements+system.\u0026amp;theme=70482cd297530a4132dadc59\u0026amp;signature=dad743bb058e7c8aa047e2871e714fa32c9a7a82b0b90b2a92a90c4315e1e718\">\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/entitlements/entitlements-specification\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/architecture/entitlements/entitlements-specification.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/entitlements/entitlements-specification#webpage\",\"url\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification\",\"name\":\"Entitlements Specification\",\"description\":\"Canonical, normative specification of Cowboy's entitlements system.\",\"dateModified\":\"2026-11-04T13:24:50.809Z\",\"isPartOf\":{\"@id\":\"https://docs.cowboy.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Protocol and architecture\",\"item\":\"https://docs.cowboy.inc/overview/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Entitlements\",\"item\":\"https://docs.cowboy.inc/architecture/entitlements/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Entitlements Specification\",\"item\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification#article\",\"headline\":\"Entitlements Specification\",\"name\":\"Entitlements Specification\",\"description\":\"Canonical, normative specification of Cowboy's entitlements system.\",\"url\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cowboy.inc/architecture/entitlements/entitlements-specification#webpage\"},\"dateModified\":\"2026-11-04T13:24:50.809Z\",\"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/entitlements/entitlements-specification.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","href":"/architecture/tx/tx-fields"},{"title":"Idempotency","href":"/architecture/tx/idempotency"},{"title":"Reentrancy","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","description":"Understanding Cowboy's declarative permissions system for actors and runners.","href":"/architecture/entitlements/overview"},{"title":"Entitlements Specification","href":"/architecture/entitlements/entitlements-specification"}]},{"group":"Keys \u0026 Wallets","pages":[{"title":"Key Format Specification","description":"How Cowboy stores, encodes and backs up private keys","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":"Entitlements Specification - Cowboy","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}