# Veritap Locker – Send Message to Wallet-Addressed Mailbox

> Veritap Locker – Send Message to Wallet-Addressed Mailbox is a paid API for AI agents from locker.veritap.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Sends a paid message (inline or large-body) to a wallet-addressed mailbox via x402/USDC, with configurable retention, tagging, and optional encryption.

## Facts

- Endpoint: POST https://locker.veritap.dev/v1/mb/:address/messages
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/veritap-locker-send-message-to-wallet-addressed-mailbox-887b4f90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BNnCeZP2r3aEmUeSgCmI5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability veritap-locker-send-message-to-wallet-addressed-mailbox-887b4f90 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Deliver a 17-byte message (30d retention) to the wallet-addressed mailbox 0x318327234c2bEDD96C546b2ba9B9C3f1aed89eD1.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/veritap-locker-send-message-to-wallet-addressed-mailbox-887b4f90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from locker.veritap.dev](https://www.zero.xyz/host/locker.veritap.dev/llms.txt)