2つのマイクロペイメントフロー：リクエスト単位課金と前払い残高
エージェントがコールごとに支払うか残高を事前入金するかに関わらず、ゲートウェイがインボイス作成、オンチェーン検証、アップストリームプロキシを自動処理します。
リクエスト単位課金
クライアントがゲート付きエンドポイントにアクセスし、インボイス付きの402を受け取ります。オンチェーンで決済し、X-Payment-Proofヘッダー付きでリトライ。ゲートウェイがNeutaroでトランザクションを検証しアップストリームにプロキシします。
前払い残高
クライアントが/prepaid/deposit経由で一度NTMPIを入金。以降のリクエストはX-Client-Idヘッダーを含み、ゲートウェイがコールごとに残高から差し引きます — オンチェーン取引の繰り返し不要。
AIエージェントとマシン間取引のために構築
マシン間マイクロペイメントレイヤーに必要なすべて、それ以上は何もなし。
オンチェーン検証
アクセスを許可する前にNeutaro REST APIに問い合わせて支払い金額、メモ、ブロック確認を確認。
ルートレベル価格設定
デフォルト価格を設定し、GATEWAY_ROUTESでルートごとにオーバーライド。安い読み取り、高い書き込み。
管理API
内部ウォレット、トランザクション、軽量ブロックチェーン台帳のためのJWT保護エンドポイント。
リバースプロキシ
認証済みリクエストをアップストリームAPIに透過的に転送。どのバックエンド、どの言語でも対応。
SQLiteストレージ
インボイス、前払い残高、決済ログを単一ファイルにローカル保存。外部依存なし。
Docker対応
docker compose upのワンコマンドデプロイ。ベアメタル用Ubuntuデプロイスクリプト付属。
ゲートウェイAPIエンドポイントリファレンス
ヘルスチェック、インボイス確認、残高照会のための無料エンドポイント。それ以外はすべて402ゲートを通過。
無料 — 決済不要
| メソッド | パス | 説明 |
|---|---|---|
| GET | /health | ゲートウェイ設定付きヘルスチェック |
| GET | /invoices/:id | インボイスステータス確認（オンチェーン検証をトリガー） |
| POST | /prepaid/deposit | 入金登録（まずオンチェーンでtxを検証） |
| GET | /prepaid/balance/:clientId | 前払い残高確認 |
管理 — JWT保護
| メソッド | パス | 説明 |
|---|---|---|
| POST | /manage/auth/register | 管理者アカウント登録 |
| POST | /manage/auth/login | ログイン、JWTトークン取得 |
| POST | /manage/wallet | 内部ウォレット作成 |
| GET | /manage/wallet | ウォレット一覧 |
| GET | /manage/wallet/:id | IDでウォレット取得 |
| POST | /manage/transactions | 内部トランザクション作成 |
| GET | /manage/transactions/:id | IDでトランザクション取得 |
402ゲート — キャッチオール
| メソッド | パス | 説明 |
|---|---|---|
| ANY | /* | その他のリクエストはすべて決済または前払い残高が必要 |
エージェント統合：PythonとTypeScriptの例
数行で402フローを任意のエージェントに組み込み。ゲートウェイがインボイス発行と検証を処理します。コードは支払いとリトライだけ。
import requests, subprocess, os res = requests.get("http://gateway:4020/api/data") if res.status_code == 402: inv = res.json()["payment"] # Pay with ClawPurse subprocess.run([ "clawpurse", "send", inv["address"], inv["amount"], "--memo", inv["memo"], "--yes" ]) # Retry with proof res = requests.get( "http://gateway:4020/api/data", headers={"X-Payment-Proof": inv["invoiceId"]} ) data = res.json()
async function paidFetch(url: string) { let res = await fetch(url); if (res.status === 402) { const { payment } = await res.json(); // Pay with ClawPurse const { send, loadKeystore } = await import("clawpurse"); const { wallet, address } = await loadKeystore( process.env.CLAWPURSE_PASSWORD! ); await send( wallet, address, payment.address, payment.amount, { memo: payment.memo } ); // Retry with proof res = await fetch(url, { headers: { "X-Payment-Proof": payment.invoiceId } }); } return res.json(); }
1分以内にゲートウェイをインストール・実行
# Clone and install git clone https://github.com/mhue-ai/clawpurse-gateway.git cd clawpurse-gateway && npm install # Configure cp .env.example .env # Set GATEWAY_PAYMENT_ADDRESS and JWT_SECRET # Start a test upstream npm run test:upstream # Start the gateway npm run dev # Test the 402 flow curl http://localhost:4020/api/test # Pay, then retry with proof: curl -H "X-Payment-Proof: <invoiceId>" \ http://localhost:4020/api/test
TypeScriptマイクロサービスアーキテクチャ
集約されたTypeScriptコードベース — ゲートウェイロジック、4つの内部サービス、ミドルウェア。46のユニットテストが全レイヤーをカバー。
環境変数によるゲートウェイ設定
すべての設定は環境変数または.envファイル経由。
| 変数 | デフォルト | 説明 |
|---|---|---|
| PORT | 4020 | ゲートウェイリッスンポート |
| GATEWAY_UPSTREAM | http://localhost:3000 | プロキシ先のアップストリームAPI |
| GATEWAY_PAYMENT_ADDRESS | — | あなたのNeutaroウォレットアドレス（必須） |
| GATEWAY_DEFAULT_PRICE | 0.001 | リクエストあたりのデフォルト価格（NTMPI） |
| GATEWAY_ROUTES | — | ルート価格オーバーライド |
| GATEWAY_REST | https://api2.neutaro.io | Neutaro REST APIエンドポイント |
| GATEWAY_MIN_CONFIRMATIONS | 1 | 必要なブロック確認数 |
| GATEWAY_INVOICE_TTL | 300 | インボイス有効期間（秒） |
| GATEWAY_PREPAID | false | 前払い残高システムを有効化 |
| GATEWAY_DB | ./gateway.db | SQLiteデータベースパス |
| JWT_SECRET | — | 管理API JWT用シークレット（必須） |
Timpi、Neutaro、ClawPurseエコシステムの一部
ClawPurseウォレット
暗号化キーストア、ガードレール、ステーキング、送金先許可リスト付きのローカルNTMPIウォレット。ゲートウェイ経由での決済のリファレンスクライアント。
Neutaroブロックチェーン
NTMPIを支えるCosmos SDKチェーン。すべてのゲートウェイ決済はNeutaroのREST APIに直接検証 — オラクルなし、ブリッジなし。
Timpiネットワーク
プライバシーファーストの分散型検索とオープンデータAPI、DePINノード。ClawPurse GatewayはTimpiベースのサービスをマイクロペイメントで収益化できます。
Timpi Dripファウセット
CAPTCHAの代わりにプルーフオブワークチャレンジを使用するエージェントフレンドリーなNTMPIファウセット。OpenClaw認証エージェントはより高スループットのドリップを取得。
Ledger Timpi
Free NTMPI cost basis calculator and tax tool. Auto-fetches transfers, staking rewards, and node payouts from the Neutaro chain — calculates USD cost basis with FIFO/LIFO/HIFO and generates IRS Form 8949.
x402 Payment Protocol
Coinbase's open HTTP 402 standard routes every payment through a centralized facilitator that controls settlement. ClawPurse Gateway takes the opposite approach: peer-to-peer payments verified directly on Neutaro — no middleman, no EVM lock-in, no Coinbase SDK. Add prepaid balances for zero-latency repeat access, route-level pricing in one env var, and a full audit trail in SQLite. One Docker command to deploy; zero external dependencies to operate.
よくある質問
ClawPurse Gatewayとは？
Neutaroブロックチェーン上のNTMPIマイクロペイメントで任意のAPIをゲーティングする402 Payment Requiredステータスコードを実装するオープンソースHTTPリバースプロキシ。AIエージェント、自動化スクリプト、マシン間取引向けのリクエスト単位課金・前払い残高フローをサポート。
HTTP 402決済フローの仕組みは？
クライアントがゲート付きエンドポイントにリクエストし、invoiceId、amount、address、memoを含むインボイス付きの402レスポンスを受け取ります。ClawPurseまたはNeutaroウォレットでオンチェーン決済し、X-Payment-Proofヘッダー付きでリトライ。ゲートウェイがNeutaroでトランザクションを検証しアップストリームにプロキシ。
NTMPIとは何ですか？どうやって入手できますか？
NTMPIはNeutaroブロックチェーンのネイティブトークンで、 Timpi 分散型検索ネットワークの一部です。 Timpi Dripファウセットから無料のNTMPIを入手するか、 MEXC でNTMPI/USDTスポットペアから購入、またはGravity Bridge経由でOsmosisにブリッジしてKeplrまたはLeapウォレットでスワップできます。
AIエージェントはClawPurse Gatewayを自律的に使用できますか？
はい。ゲートウェイはエージェントAIとマシン間ワークロード向けに設計されています。エージェントは402インボイスをプログラマティックに解析し、 ClawPurseウォレットAPI経由でオンチェーン決済し、決済証明ヘッダー付きでリトライできます — すべて人間の介入なしで。
MhueにTimpiコーヒーをおごる ☕
ゲートウェイがスタック運用の時間を節約しているなら、ビルダーにチップを。
neutaro1e8xal8tqdegu4w48z3fphemd3hc07gech3pfek
メモは任意 — 何をシップしたか教えてください！