m2mcent

🛰️ M2MCent SDK — AI エージェント向け x402 決済ラッパー

AI エージェントと MCP サーバー向けの超軽量 x402 決済インターセプターです。3 行のコードであらゆる API を収益化できます。

🚀 クイックスタート

npm install m2mcent-sdk

import { X402Handler } from 'm2mcent-sdk';

const x402 = new X402Handler({
  rpcUrl: 'https://mainnet.base.org',
  privateKey: process.env.RELAYER_PRIVATE_KEY!,
  recipient: process.env.TREASURY_ADDRESS!
});

// Protect any Express endpoint with a USDC paywall
app.post('/api/analyze', x402.requirePayment("100000"), (req, res) => {
  res.json({ result: "Premium analysis complete", receipt: req.paymentTx });
});

📐 仕組み

M2MCent は、HTTP 402 に着想を得たマシンネイティブな決済標準である x402 Payment Protocol を実装しています。

1. エージェントがリクエストして保護されたエンドポイントにアクセスします
2. サーバーが応答し、402 Payment Required と決済メタデータ（Base64 エンコード）を返します
3. エージェントが署名して EIP-712 型付きデータの認証を行います（支払者のガス代は不要です）
4. サーバーが決済を確定し、M2MCent Escrow コントラクトを介してオンチェーンでアトミックに処理します
5. エージェントが受信し、プレミアムレスポンスとトランザクションのレシートを取得します

Agent ──► API Server ──► 402 + metadata
Agent ◄── signs EIP-712 authorization
Agent ──► API Server + Payment-Signature header
          └──► Escrow.settle() on Base L2
Agent ◄── Premium Response + tx hash

⚙️ 設定

パラメーター	説明	必須
rpcUrl	Base Mainnet RPC エンドポイント	✅
privateKey	リレイヤーウォレットの秘密鍵（決済確定用）	✅
recipient	支払いの受取先となるトレジャリーアドレス	✅

🔒 セキュリティ

• 非カストディアル：資金はオンチェーンエスクローを介して支払者からトレジャリーへ直接送金されます
• 支払者のガス代不要：EIP-3009 の transferWithAuthorization を使用します（ネイティブ USDC）
• 情報漏えいゼロ：決済確定後にエージェントのデータは保持されません
• アトミック：決済とサービス提供は単一のリクエストサイクルで行われます

🌐 ネットワーク詳細

パラメーター	値
ネットワーク	Base Mainnet（Chain ID: 8453）
USDC コントラクト	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
エスクローコントラクト	0xf3c3416A843d13C944554A54Ac274BB7fF264BcC
決済確定	アトミック、1 秒未満でファイナリティを実現

🧩 MCP サーバーとの統合

Model Context Protocol サーバーに最適です。

import express from 'express';
import { X402Handler } from 'm2mcent-sdk';

const app = express();
const x402 = new X402Handler({
  rpcUrl: process.env.BASE_RPC_URL!,
  privateKey: process.env.RELAYER_PRIVATE_KEY!,
  recipient: process.env.TREASURY_ADDRESS!
});

// Any MCP tool endpoint becomes monetizable
app.post('/api/tools/analyze', x402.requirePayment("50000"), async (req, res) => {
  const result = await runMCPTool(req.body);
  res.json({ ...result, paymentTx: req.paymentTx });
});

📊 エコシステム

M2MCent は Base Mainnet 上の 100 以上の本番 MCP サーバーを支え、AI 間コマース向けに実際の USDC マイクロペイメントを処理しています。

📄 ライセンス

MIT © M2MCent