{"uid":"cap_OGpLkfw2K3n4IjFbJz8J0","slug":"veritap-locker-send-message-to-wallet-addressed-mailbox-f4e96988","name":"Veritap Locker – Send Message to Wallet-Addressed Mailbox","description":"Wallet-addressed mailbox + storage for AI agents. Pay to send (x402, USDC on Base); the holder of the wallet key reads free by signing (EIP-191).","url":"https://locker.veritap.dev/v1/mb/%7Baddress%7D/messages?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tag":{"type":"string","description":"Recipient-side filter tag"},"product":{"type":"string","description":"message (default) or receipt_vault (flat $0.02, 365d, <=32KB)"},"body_b64":{"type":"string","description":"Inline body, base64-encoded, up to 32KB. Larger: body_upload:true + size_bytes, then PUT to upload_url."},"producer":{"type":"string","description":"Who you are, so the recipient can filter"},"ttl_days":{"type":"number","description":"Retention, 1-365 days (default 30); priced per 90d extension"},"encrypted":{"type":"boolean","description":"Body is sealed-box ciphertext for the recipient directory key"},"size_bytes":{"type":"number","description":"Declared size when body_upload is true"},"body_upload":{"type":"boolean","description":"Large-body mode (up to 10MB)"},"content_type":{"type":"string","description":"MIME type of the message body"},"idempotency_key":{"type":"string","description":"Makes retries safe - strongly recommended"}}},"responseSchema":{"type":"json","example":{"expires_at":"2026-09-13T00:00:00.000Z","message_id":"lm_mssqfu37dsc32ksm"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ru-CUkV4WIa_1Xn3p2lY2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a message or file (up to 10MB) to a blockchain wallet address's mailbox, paid per send via x402/USDC on Base; the wallet key holder reads for free.","exampleAgentPrompt":"Send a message to wallet 0x318327234c2bEDD96C546b2b with body 'Invoice #1042 for $50 USDC — paid' (base64-encoded), tag it 'invoice', keep it for 90 days, and mark me as producer 'billing-agent'.","exampleUseCases":[{"title":"Agent-to-agent task notification","prompt":"Send a message to wallet 0xAbC123…'s Veritap mailbox saying 'Your data fetch job completed successfully — 4,200 rows exported', tag it 'job-status', retain it for 30 days, and identify the sender as 'orchestrator-agent'."},{"title":"Receipt vault for on-chain payment proof","prompt":"Store this payment receipt JSON (base64-encoded, 18KB) in wallet 0xDef456…'s receipt vault on Veritap Locker for 365 days — use the receipt_vault product so it's archived long-term."},{"title":"Encrypted private message to a wallet holder","prompt":"Deliver an encrypted message to 0x9F12…'s Veritap mailbox — the body is sealed-box ciphertext, mark encrypted as true, set content type to text/plain, tag it 'private', and keep it for 60 days."}],"resultDescription":"Returns a JSON object with a unique message_id (e.g. 'lm_mssqfu37dsc32ksm') and an expires_at ISO timestamp indicating when the message will be deleted. For large-body uploads, also returns an upload_url to PUT the file content directly.","failureModes":["Payment not received or insufficient USDC — x402 payment required error","Wallet address malformed or not registered — 404 or validation error","Body exceeds 32KB without body_upload:true — payload too large error","size_bytes mismatch with actual upload — upload rejected","TTL out of range (must be 1–365) — validation error","Duplicate send without idempotency_key leads to duplicate messages","upload_url expiry if PUT not performed promptly after POST"],"whenToPreferThis":"Choose this endpoint when you need to deliver a message, file, or receipt to a specific Ethereum/Base wallet address and want the recipient (a wallet key holder or AI agent) to pull it on their own schedule. Ideal for agent-to-agent async messaging, on-chain receipt archiving, or delivering encrypted payloads where only the private key holder should read. Prefer over email or traditional queues when the recipient is identified by wallet address rather than email or username, or when you need blockchain-native identity and x402 micropayment-gated delivery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:30:03.060Z","isFirstParty":false,"canonicalSlug":"veritap-locker-send-message-to-wallet-addressed-mailbox-887b4f90"}