thewallet.ai

書類を、ユーザーのウォレットへ直接届ける。

Wallet プロトコル（シンプルなAPIとWebhook）で、契約書・請求書・保険証券・通知・署名依頼を、ユーザーが信頼するウォレットに届けます。

ユーザーのウォレットに契約書を届ける
await wallet.assets.deliver({
  walletId,
  type: "contract",
  title: "Service Agreement",
  requireSignature: true,
  agentAssist: true
})

Wallet プロトコルの仕組み

1

配信を登録する

1 回の API 呼び出しで、契約書や請求書、通知を配信可能なウォレット資産として登録します。型・バージョン・追跡情報を持ちます。

2

ウォレットへ届ける

ユーザーは自分が信頼するウォレットで書類を受け取り、読んで、署名して、保管できます。

3

イベントを受け取る

開封・署名・検証などのイベントは、Webhook でリアルタイムにあなたのシステムへ通知されます。

API リファレンス（プレビュー）

Wallet プロトコルはシンプルな HTTPS API です。1 つのエンドポイントで型付きの書類をウォレットへ届け、その後の出来事は Webhook が通知します。

認証

API キーを x-api-key ヘッダーで渡します。キーはウォレットの「連携」ページでセルフサービス発行でき、連携ごとにスコープが分かれます。

x-api-key: wlt_live_xxxxxxxxxxxxxxxx

書類を届ける

envelope を POST するだけで契約書・請求書・保険証券・通知を届けられます。target はウォレットアドレス、ウォレット ID、デジタルアドレスに対応。idempotencyKey を付ければ安全に再試行できます。

POST https://service.icloudportal.com/api/theWallet.protocol.deliverAsset
x-api-key: wlt_live_xxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "protocolVersion": "2026-01",
  "idempotencyKey": "order-2026-0611-001",
  "source": { "system": "acme-billing", "organizationName": "Acme Ltd" },
  "target": { "walletAddress": "alex@wallet.thewallet.ai" },
  "asset": {
    "type": "contract",
    "title": "Service Agreement",
    "requiresSignature": true
  },
  "options": { "requireUserConfirmation": true }
}

レスポンス

{
  "status": 0,
  "data": {
    "deliveryId": "dlv_9f2…",
    "assetId": "ast_71c…",
    "inboxItemId": "inb_2ab…",
    "signatureRequestId": "sig_e04…",
    "status": "delivered",
    "requireUserConfirmation": true,
    "reused": false
  }
}

Webhook

「連携」ページで Webhook エンドポイントを登録すると、書類がウォレットに届いたときの asset.created などの配信イベントを受け取れます。署名と再送は自動です。

{
  "eventType": "asset.created",
  "data": {
    "assetId": "ast_71c…",
    "assetType": "contract",
    "walletId": "wlt_3d8…",
    "status": "received"
  }
}

AI エージェント連携（MCP）

The Wallet は MCP サーバーを提供しています。Claude などのエージェントフレームワークから書類の配信、署名依頼、ウォレット所有者への承認リクエストが行えます。準備はエージェント、確認は所有者。

{
  "mcpServers": {
    "thewallet": {
      "command": "npx",
      "args": ["@thewallet/mcp"],
      "env": { "THEWALLET_API_KEY": "wlt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

開発者キーを取得

まず無料でウォレットを作成すると、「連携」ページからセルフサービスで API キーを発行できます。ウォレット配信とフル API はプラットフォームプランに含まれます。

無料でウォレットを作成ウォレットをお持ちの方は連携ページへ

上記は API のプレビューです。先行アクセスと導入支援はお気軽にご相談ください。