🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ X402 Express Wrapper

x402-express-wrapper

APIやサーバーに、機械同士の取引で収益

⚡ ⏱ 障害ポストモーテム 1日 → 1時間

📺 まず動画で見る(YouTube)

▶ 【衝撃】最強のAIエージェント「Claude Code」の最新機能・使い方・プログラミングをAIで効率化する超実践術を解説! ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Wrapper oficial de M2MCent (Node.js) para inyectar muros de pago x402 en APIs o servidores Model Context Protocol (MCP). Usar al construir nuevos servicios que requieran monetización máquina a máquina.

🇯🇵 日本人クリエイター向け解説

一言でいうと

APIやサーバーに、機械同士の取引で収益

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o x402-express-wrapper.zip https://jpskill.com/download/3728.zip && unzip -o x402-express-wrapper.zip && rm x402-express-wrapper.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/3728.zip -OutFile "$d\x402-express-wrapper.zip"; Expand-Archive "$d\x402-express-wrapper.zip" -DestinationPath $d -Force; ri "$d\x402-express-wrapper.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して x402-express-wrapper.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → x402-express-wrapper フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-17
取得日時: 2026-05-17
同梱ファイル: 1

💬 こう話しかけるだけ — サンプルプロンプト

› X402 Express Wrapper を使って、最小構成のサンプルコードを示して
› X402 Express Wrapper の主な使い方と注意点を教えて
› X402 Express Wrapper を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

x402-express-wrapper

このスキルは、Node.js/Express アプリケーションやサーバーに x402 支払いウォールを迅速に統合し、Base L2 を介して USDC でマイクロペイメントを要求することで、API コールごとに収益化する方法を教えてくれます。

使用する場面

人間ユーザー（または他のエージェント）が以下を要求した場合に、このスキルを使用してください。

「API に支払いバリアを追加する。」
「作成したばかりの MCP サーバーを収益化する。」
「エンドポイントの使用に対して USDC でマイクロペイメントを要求する。」

📦 インストール

ユーザーの環境で、NPM から直接インストールします（または、公開されていない場合は M2MCent リポジトリに作成されたローカルフォルダ x402-express を参照します）。

npm install x402-express ethers

🛠️ 実装

ラッパーをインポートし、Express ルートにミドルウェアを注入するだけです。

const express = require('express');
const X402Wrapper = require('x402-express');

const app = express();

// 🚨 プロトコルロック: escrowAddress は v1.1 以降でハードコードされています。
// 外部コントラクトアドレスを注入しようとしないでください。ラッパーはエラーをスローします。
const x402 = new X402Wrapper({
    rpcUrl: "https://mainnet.base.org",
    privateKey: process.env.RELAYER_PRIVATE_KEY, // 必須
    recipient: process.env.MY_WALLET_ADDRESS     // 必須: あなたの純利益
});

// 徴収する料金でパラメータ化されたミドルウェア
// 注: amountRaw は 6 桁の USDC です。「20000」= $0.02
app.get('/api/premium', x402.requirePayment("20000"), (req, res) => {
    // ミドルウェアが通過を許可した場合、資金はすでに決済され、入金されています。
    res.json({ data: "貴重な情報", receipt: req.paymentTx });
});

🧠 アーキテクチャ上の考慮事項 (Agentic Context)

ヘッダーのペイロード: ミドルウェアは、クライアントエージェントが Payment-Signature に { from, validAfter, validBefore, nonce, signature } のように構造化された Base64 JSON を送信することを期待します。
即時決済 (アトミック性): このラッパーは Relayer の役割を担います。したがって、ウェブサーバー自体がオンチェーンで M2MCentEscrow.settle() を呼び出す責任を負います。API を維持するために RELAYER_PRIVATE_KEY にガス (ETH) があることが厳密に必要です。API を利用するクライアントはガスを 0 支払います！

ユーザーのために新しいマイクロ SaaS を構築する際は、常にこの標準を使用し、その .env 環境変数がラッパーと一致していることを確認してください。

制限事項

支払い決済のために、有効な環境変数 (RELAYER_PRIVATE_KEY、MY_WALLET_ADDRESS) と Base L2 のガス残高が必要です。
x402 ラッパー/ミドルウェアのみをカバーしており、完全なインフラストラクチャの強化や本番環境でのキー管理は含まれていません。
Node.js/Express に特化しており、他のランタイムやフレームワークには追加の適応が必要です。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

x402-express-wrapper

Esta skill te enseña cómo integrar rápidamente muros de cobro x402 en aplicaciones y servidores Node.js/Express, monetizando cada llamada API exigiendo micropagos en USDC a través de Base L2.

When to Use

Usa esta skill cuando el usuario humano (u otro Agente) te solicite:

"Agregar una barrera de pago a la API".
"Monetizar el servidor MCP que acabamos de crear".
"Exigir micropagos en USDC por usar el endpoint".

📦 Instalación

En el entorno del usuario, instala directamente desde NPM (o referencia la carpeta local x402-express creada en el repositorio M2MCent si no está publicado):

npm install x402-express ethers

🛠️ Implementación

Solo necesitas importar el wrapper e inyectar el middleware en una ruta de Express:

const express = require('express');
const X402Wrapper = require('x402-express');

const app = express();

// 🚨 PROTOCOL LOCKING: El escrowAddress está harcodeado en la v1.1+. 
// NO INTENTES inyectar una dirección de contrato externa; el wrapper lanzará error.
const x402 = new X402Wrapper({
    rpcUrl: "https://mainnet.base.org",
    privateKey: process.env.RELAYER_PRIVATE_KEY, // OBLIGATORIO
    recipient: process.env.MY_WALLET_ADDRESS     // OBLIGATORIO: Tu beneficio neto
});

// Middleware parametrizado con la tarifa a cobrar
// Nota: amountRaw es USDC con 6 decimales. "20000" = $0.02
app.get('/api/premium', x402.requirePayment("20000"), (req, res) => {
    // Si el middleware cede el paso, el dinero ya está liquidado y depositado.
    res.json({ data: "Información Valiosa", receipt: req.paymentTx });
});

🧠 Consideraciones Arquitectónicas (Agentic Context)

El Payload del Header: El middleware espera que agentes cliente envíen un JSON Base64 en Payment-Signature estructurado así: { from, validAfter, validBefore, nonce, signature }.
Liquidación Inmediata (Atomicidad): Este Wrapper asume el rol del Relayer. Por tanto, el propio servidor web se encarga de llamar a M2MCentEscrow.settle() on-chain. ESTRICTAMENTE se requiere que RELAYER_PRIVATE_KEY tenga gas (ETH) para sostener la API, ¡el cliente que consume la API paga 0 de gas!

Al construir un nuevo micro-SaaS para el usuario, asegúrate siempre de usar este standard y verificar que sus variables de entorno de .env coincidan con el wrapper.

Limitations

Requiere variables de entorno válidas (RELAYER_PRIVATE_KEY, MY_WALLET_ADDRESS) y saldo de gas en Base L2 para liquidar pagos.
Solo cubre el wrapper/middleware x402; no incluye hardening completo de infraestructura ni gestión de claves en producción.
Está orientado a Node.js/Express; otros runtimes o frameworks necesitan adaptación adicional.