Schemas
InsufficientCreditsError
errorcoderequired_costspArks cost of the attempted operation.
balanceCurrent spArks balance.
EvidenceSummary
idstatusfile_nameoriginal_file_namefile_hashSHA-256 hex digest, 64 characters.
file_sizemime_typecreated_atblockchain_tx_hashexplorer_urlPublic block-explorer link for blockchain_tx_hash. Null until the timestamp job has settled on-chain.
origin_channelSet to 'mcp_agent' when this item was created via an MCP agent key; otherwise null.
EvidenceDetail
idstatuscustody_statusCustody tier. MVP is self-custody only (the client is responsible for keeping this receipt with the original file).
origin_channelSet to 'mcp_agent' when this item was created via an MCP agent key.
created_atreceipt_dataStructured receipt payload (shape varies: includes identity_claim block also surfaced publicly via verify_certificate).
Present only once status is 'submitted' and a transaction hash exists.
public_verify_urlHuman-viewable, Cloudflare Turnstile-protected confirmation page. Hand this to the human to open in their own browser. Do not fetch it programmatically, as it is not meant for agent traffic and will likely be blocked.
verification_instructionsStep-by-step instructions for an agent to independently confirm the timestamp using only public blockchain data (recompute the hash locally, fetch the transaction, decode its calldata). Requires no trust in spArxx.io beyond the public chain itself. Present only once blockchain data is available.
disclose_identityWhether this specific timestamp's certificate/manifest/verify page discloses the account's name and email together, or withholds both. Frozen at creation time. Does not change retroactively if the account's default preference changes later.