timestamping
Hash-in provenance timestamping. The file itself is never uploaded. Instead, only its SHA-256 hash and metadata. This is the 'notary' posture: spArxx.io keeps no copies of the original file, ever.
Timestamp a file's hash on-chain (hash-in only, no upload)
Compute the SHA-256 hash of the file locally - the file itself is never uploaded, and spArxx.io never stores it. Call this with that hash plus basic file metadata to register a provenance timestamp. This deducts spArks from the account (dynamic cost. Call get_pricing or get_balance first if you want to pre-check spend; a 402 response here means insufficient balance, which only the account-holder can resolve on web/mobile). Calls made via an MCP agent key are automatically charged the agentic flat rate (currently 20 spArks) instead of the standard rate (currently 25). And, get_pricing's timestamp_register_agentic field already reflects this, no separate parameter needed to opt in. The response is a 202 Accepted with the new evidence_id, not a finished proof. The timestamp job runs asynchronously. Poll get_evidence with the returned evidence_id until status is 'submitted', then save the full receipt kit (get_evidence's response) alongside the original file. There is no separate upload step and nothing further to send. This call is the entire timestamping action.
Timestamp a file's hash on-chain (hash-in only, no upload) › Request Body
file_nameThe file's name as the caller knows it (e.g., 'final_mix.wav'). Used for display and is included in the receipt kit. Required; not used to derive mime_type or validate the hash.
file_hashSHA-256 hex digest of the file, computed locally. Alias: client_hash.
client_hashAlias for file_hash, used by some clients. Provide one or the other, not both.
original_file_nameOptional: the file's original name, if different from file_name (e.g., before local renaming). Purely informational, stored with the evidence record.
file_sizeFile size in bytes. Alias: file_size_bytes.
file_size_bytesAlias for file_size.
mime_typeOptional MIME type of the file (e.g., 'audio/wav', 'image/png'), if known. Purely informational, and stored with the evidence record, not independently verified against file content.
codenameOptional human-friendly label for the timestamped item.
disclose_identityPer-transaction override for whether this certificate's verify page/API/manifest discloses the account's name and email together, or withholds both. Omit to inherit the account's stored disclose_identity_default preference (defaults to true if never set). Ghost/guest accounts always withhold identity regardless of this value ... there is no toggle for them.
Timestamp a file's hash on-chain (hash-in only, no upload) › Responses
Accepted - spArks deducted, evidence record created, timestamp job queued. Not yet on-chain; poll get_evidence for final status.
statusmessagecorrelation_idList all timestamp evidence records for the authenticated account
Returns every evidence item owned by the calling account, newest first, as a summary (no full receipt data, call get_evidence for the complete receipt kit on a specific item). Use this to find an evidence_id when the caller only knows a file name, or to check on recent timestamping activity.
List all timestamp evidence records for the authenticated account › Responses
Get the full receipt kit for one timestamped item
Returns the complete receipt kit for a single evidence item: hash, file metadata, status, and once the on-chain job has settled, the blockchain transaction hash and explorer URL. Poll this after create_timestamp until status is 'submitted', then save the full response alongside the original file as the durable proof-of-timestamp record. This is the self-custody artifact (spArxx.io does not keep a separate copy for the caller).
path Parameters
idevidence_id returned by create_timestamp or list_evidence.
Get the full receipt kit for one timestamped item › Responses
OK
The receipt kit: everything an agent needs to prove a hash was timestamped, without ever holding the original file. Save this alongside the original file, as it is the MCP equivalent of the browser's forced certificate download.