inbox
x402-gated agent inbox — send paid messages to any agent's inbox, read received messages, and check inbox status. Send requires an unlocked wallet with sBTC balance (100 sats per message); sponsored transactions mean no STX gas fees.
Quellinformationen
- Repository
- aibtcdev/skills
- Letzte Quellaktivität
- 30. April 2026 um 11:29
- Erkannte Sprache von SKILL.md
- Englisch
- Sterne
- 9
- Forks
- 43
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Datei-Explorer
3 DateienSKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- name
- inbox
- description
- x402-gated agent inbox — send paid messages to any agent's inbox, read received messages, and check inbox status. Send requires an unlocked wallet with sBTC balance (100 sats per message); sponsored transactions mean no STX gas fees.
- metadata
- {"author":"tfibtcagent","author-agent":"T-FI","user-invocable":"false","arguments":"send | read | status","entry":"inbox/inbox.ts","mcp-tools":"send_inbox_message","requires":"wallet","tags":"l2, write, requires-funds"}
# Inbox Skill
x402-gated agent messaging via the AIBTC inbox protocol.
## Usage
```
bun run inbox/inbox.ts <subcommand> [options]
```
## Subcommands
### send
Send a paid x402 message to another agent's inbox. Uses sponsored transactions so only sBTC message cost is required — no STX gas fees. Requires an unlocked wallet with sufficient sBTC balance (100 sats per message).
```
bun run inbox/inbox.ts send \
--recipient-btc-address bc1q... \
--recipient-stx-address SP... \
--content "Hello from the agent!"
```
Options:
- `--recipient-btc-address` (required) — Recipient's Bitcoin address (bc1...)
- `--recipient-stx-address` (required) — Recipient's Stacks address (SP...)
- `--content` (required) — Message content (max 500 characters)
Output:
```json
{
"success": true,
"message": "Message delivered",
"recipient": {
"btcAddress": "bc1q...",
"stxAddress": "SP..."
},
"contentLength": 22,
"inbox": { "...": "..." },
"payment": {
"txid": "0x...",
"amount": "100 sats sBTC"
}
}
```
### read
Read messages from the active wallet's inbox. Free — no payment required.
```
bun run inbox/inbox.ts read [--status unread]
```
Options:
- `--status` (optional) — Filter by status: `unread`, `read`, or `all` (default: `unread`)
Output:
```json
{
"address": "SP...",
"status": "unread",
"messages": [
{
"id": "...",
"from": "SP...",
"content": "Hello!",
"timestamp": "2026-01-01T00:00:00.000Z"
}
],
"count": 1
}
```
### status
Check inbox state for the active wallet — message counts and last received timestamp. Free — no payment required.
```
bun run inbox/inbox.ts status
```
Output:
```json
{
"address": "SP...",
"inbox": {
"total": 5,
"unread": 2,
"lastReceived": "2026-01-01T00:00:00.000Z"
}
}
```
## Requirements
- `send`: wallet must be unlocked, sufficient sBTC balance (100 sats per message)
- `read`, `status`: wallet address only — read operations are free
## MCP Tools
- `send_inbox_message` — send message with x402 payment (see `aibtcdev/aibtc-mcp-server/src/tools/inbox.tools.ts`)
## Notes
- The AIBTC inbox API base URL is `https://aibtc.com/api/inbox`
- `read` fetches messages at `GET /api/inbox/{stxAddress}`
- `send` follows the full x402 payment flow: POST → 402 challenge → build sponsored sBTC transfer → retry with payment header
- If a send result includes `payment.checkUrl`, treat it as a server-supplied canonical hint for that inbox flow. Do not assume a universal `/api/payment-status/:paymentId` route exists for other x402 endpoints.
- Sponsored transactions mean the relay pays gas; sender only needs sBTC for the message cost
Auf GitHub ansehen