Neuronto Payments: x402 facilitator and API gateway

x402 スターター

HTTP ルートを有料化し、利用料金を支払うための、公式の x402 SDK を使った最短の動作例です。ここにある各ファイルはそのまま実行できます。変更が必要なのは、支払いを受け取るウォレットだけです。

x402 は HTTP の 402 Payment Required を復活させます。サーバーは未払いのリクエストに 402 と機械可読な条件を返し、クライアントはステーブルコインによる支払いに署名し、ファシリテーターが署名を検証してオンチェーンで決済します。サーバーが鍵を保持したり、ブロックチェーンと通信したりすることはありません。

いずれかを選ぶ

フォルダー	スタック	内容
express	Node、Express	有料の GET /premium ルートが 1 つ
hono	Node、Hono	同じルートを Hono で実装
next	Next.js App Router	有料の API ルート
fastapi	Python、FastAPI	同じルートを Python で実装
client	Node、Python	スクリプトまたはエージェントから 402 ルートに支払い

1 分で実行

cd express
npm install
export MERCHANT=0xYourWalletAddress      # where the money goes, on Base
npm start
curl -i localhost:3000/premium           # 402 with terms

次に、client のクライアントで支払うか、任意の x402 クライアントからアクセスします。

ファシリテーター

これらのスターターでは https://pay.neuronto.com をファシリテーターとして使用します。ファシリテーターとは、支払者の署名を検証して決済をブロードキャストするサービスです。各ファイルの 1 行に設定されており、任意の x402 ファシリテーターに置き換えられます。

new HTTPFacilitatorClient({ url: "https://pay.neuronto.com" })

Base メインネット（eip155:8453）はここで利用できます。GET https://pay.neuronto.com/supported には、現在決済可能なネットワーク、スキーム、バージョンがすべて表示されます。決済できないネットワークは、決済を拒否し始める前にこのリストから削除されるため、/supported を読み取るサーバーは、受け付けられない価格を提示しません。

費用をかけずにテスト

https://pay.neuronto.com/echo は、0.001 ドルを請求して、同じリクエスト内でそのまま送り返す稼働中のマーチャントです。そのため、クライアントを費用なしでエンドツーエンドに実行できます。

curl -i https://pay.neuronto.com/echo        # a real 402, with real terms

client にある任意のクライアントから、その URL にアクセスします。返金は自動で行われ、ガス代はかかりません。

必要なもの

• 支払いを受け取るウォレットアドレス。支払いを受け取るために、こちら側に何かをインストールする必要はありません。MERCHANT に指定したアドレスに USDC の送金として届きます。
• 支払いを行うクライアントの場合は、残高のある鍵が必要です。実際に使用する鍵をファイルに記載しないでください。すべてのサンプルで、鍵は環境変数から読み込みます。

ライセンス

Apache-2.0。