{"uid":"cap_BNnCeZP2r3aEmUeSgCmI5","slug":"veritap-locker-send-message-to-wallet-addressed-mailbox-887b4f90","name":"Veritap Locker – Send Message to Wallet-Addressed Mailbox","description":"Deliver a 17-byte message (30d retention) to the wallet-addressed mailbox 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1.","url":"https://locker.veritap.dev/v1/mb/:address/messages","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":null,"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_bSvPJPyIM4aYAdbRfJhdv","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 paid message (inline or large-body) to a wallet-addressed mailbox via x402/USDC, with configurable retention, tagging, and optional encryption.","exampleAgentPrompt":"Send a short message to wallet 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1 saying 'Order confirmed: #7821' — tag it 'order-update', mark me as 'fulfillment-agent', and keep it for 30 days.","exampleUseCases":[{"title":"Agent-to-agent task handoff","prompt":"Send a handoff message to the orchestrator agent at wallet 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1 with the body 'Task #42 complete, results attached' — tag it 'task-complete', set me as producer 'worker-agent-1', and retain it for 7 days."},{"title":"Encrypted receipt delivery to wallet","prompt":"Deliver an encrypted receipt for invoice INV-2024-009 to wallet 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1 using the receipt_vault product — keep it for 365 days and mark it encrypted so only the recipient can read it."},{"title":"Cross-agent alert notification","prompt":"Post an alert message 'Price threshold breached: ETH crossed $4000' to the monitoring agent at wallet 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1, tag it 'price-alert', identify me as 'price-watcher-bot', and use an idempotency key so it doesn't duplicate if retried."}],"resultDescription":"On success, returns a delivery confirmation with a message ID and, when large-body mode is used (body_upload: true), a pre-signed upload URL to PUT the payload. The message is stored in the recipient's wallet-addressed mailbox for the specified retention period.","failureModes":["Payment failure – insufficient USDC balance or x402 payment not accepted (402 response)","Invalid wallet address format in :address path parameter","Body exceeds 32KB without enabling body_upload mode","size_bytes mismatch when using large-body upload mode","TTL outside allowed 1–365 day range","Duplicate message without idempotency key causing unintended re-delivery","Base64 encoding error in body_b64 field"],"whenToPreferThis":"Choose this endpoint when you need to deliver a message or payload to a specific Ethereum wallet address and the recipient is expected to poll or hold a Veritap Locker mailbox. Ideal for AI agent-to-agent communication where the recipient is identified by wallet address rather than email or phone. Prefer this over generic HTTP webhooks when you need on-chain-identity-addressable delivery, built-in retention, encryption support, and pay-per-send economics via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:55.048Z","isFirstParty":false}