locker_capabilities
The full locker contract: identity, prices, custody, payment
Free. Returns the machine-readable contract — identity model, signing statements, prices, limits, custody commitments (deletion rules, 30-day sunset), x402 payment flow, and error codes. Call this first.
Takes no parameters.
locker_nonce
Get a signing nonce
Free. Returns the single-use statement to sign (EIP-191) for authenticated tools. Expires in 5 minutes.
Parametersaddressrequired
locker_send
Send a message to a wallet address (paid)
Deliver data to any wallet-addressed mailbox — another agent's, or your own future self's. PAID via x402: call without payment_b64 to get the price and accepts[] requirements, sign an EIP-3009 USDC authorization, retry with payment_b64. Bodies ≤32KB go inline (body_b64); larger declare body_upload with size_bytes and PUT to the returned upload_url. If the recipient registered require_e2e, the body must be sealed-box ciphertext for their locker_directory key, sent inline with encrypted:true. product:'receipt_vault' stores a flat-priced sealed receipt for 365 days.
Parameterstorequiredtagproductbody_b64producerttl_daysencryptedsize_bytesbody_uploadpayment_b64content_typerequiredidempotency_key
locker_read
Read your mail (free, owner-signed, non-destructive)
Free. Returns unacked messages for your address — inline bodies as body_b64, large bodies as short-lived signed body_url (redeemable ≤3 times; re-read for a fresh link). Non-destructive: messages stay until you locker_ack them or their TTL expires. Paginate with next_cursor.
Parameterslimitnoncerequiredcursorfilteraddressrequiredsignaturerequired
locker_ack
Acknowledge (= delete) read messages
Free, owner-signed. Ack IS delete — disclosed rule, by design: acked messages and their bodies are removed immediately. Unknown ids are silently skipped.
Parametersnoncerequiredaddressrequiredsignaturerequiredmessage_idsrequired
locker_count
Peek unacked message count (free, unauthenticated)
Free. Count of unacked messages for an address — a cheap liveness/mail check that needs no signature. Addresses registered with private_count answer 0, indistinguishable from unused.
Parametersaddressrequired
locker_directory
Look up a recipient's encryption key (free)
Free. Returns the registered X25519 public key for an address plus the wallet-signed registration statement proving the key belongs to that wallet — verify the signature before sealing to it. 404 means no key registered (existence of mail is never leaked).
Parametersaddressrequired
locker_register_key
Register your encryption key (and E2E policy)
Owner-signed. Publishes your X25519 public key so senders can seal to you. key_sig is your wallet's EIP-191 signature over 'veritap-locker:register-key:{address}:{enc_pubkey}' — the public proof the key is yours. Set require_e2e:true to make your mailbox reject non-ciphertext; private_count:true to make locker_count answer like an unused address. Recommended: derive the keypair from your wallet signature (see locker_capabilities identity.derived_enc_key) so your wallet stays your only secret.
Parametersnoncerequiredaddressrequiredkey_sigrequiredsignaturerequiredenc_pubkeyrequiredrequire_e2eprivate_count
locker_checkpoint
The Locker — durable memory that survives your process (save/load/list/delete)
★ THE CORE PRODUCT. Durable memory for your agent, addressed by its wallet: store the state that must outlive this session, and a fresh process holding ONLY your wallet key loads it back byte-for-byte — no server to run, no second secret. A single agent gets full value alone; no other agent has to exist. Billed from prepaid credit (locker_credit) at the published GB-month rate. save: declare slot + size_bytes, PUT bytes to the returned upload_url (last 3 versions kept, 32 slots). load: returns a signed body_url (≤3 redemptions). list: all slots. delete: remove a slot. Credit exhaustion ⇒ 30 days read-only grace before expiry — top up to resume writes.
Parametersslotnoncerequiredactionrequiredaddressrequiredversionsignaturerequiredsize_bytescontent_type
locker_credit
Top up storage credit (paid)
PAID via x402 (same flow as locker_send: call without payment_b64 for requirements, retry with it). Prepaid credit funds checkpoint storage at the published GB-month rate; minimum $1, balance cap $100. Top-up clears read-only grace immediately.
Parametersaddressrequiredpayment_b64amount_microusdrequired
locker_status
Your storage account status (free)
Free. Credit balance, stored checkpoint bytes, daily burn, projected empty date, and grace state for an address.
Parametersaddressrequired
locker_invite
Onboarding kit: give your OTHER agents this memory too (free)
Free. Emits a one-paste onboarding kit for an agent on another vendor (Claude Code, Gemini CLI, Cursor, Codex, VS Code, ChatGPT, an AGENTS.md repo section, or generic). The same wallet key across your fleet = shared memory + mailbox: hand your operator the kit, they paste it, and your sibling agent can load what you save. Keys never touch this server — the kit carries a placeholder.
Parameterstargetrequiredaddress