PincerPay

PincerPay

エージェント経済のための決済ゲートウェイです。AI エージェントからの支払いを受け付けられます。数行のコードを追加するだけで、USDC で即座に決済できます。

加盟店向け：ブラウザーを使わず、2 分で登録

npx @pincerpay/cli signup
# email + password + 6-digit code from your inbox

npx @pincerpay/cli bootstrap-merchant --name "Acme Co" --chains "solana,polygon"
# → generates non-custodial wallets, creates merchant, mints API key
# → prints env vars ready to paste into `vercel env add`

これでオンボーディングは完了です。ターミナルだけで操作できます。Phantom および MetaMask 互換のウォレットがローカルで生成されます。PincerPay が秘密鍵を参照することはありません。詳細については、docs/onboarding と docs/cli をご覧ください。

アーキテクチャ

Agent → 402 Challenge → Sign USDC Transfer → PincerPay Facilitator → Blockchain → Merchant

PincerPay は、非カストディアル型の x402 ファシリテーターです。AI エージェントが加盟店の API にアクセスして HTTP 402 を受け取ると、エージェントは USDC の送金に署名します。PincerPay は署名を検証し、ブロックチェーンに送信して、決済の完了を確認します。

モノレポの構成

パッケージ	説明	ドキュメント
apps/facilitator	x402 ファシリテーターサービス（Hono + Node.js）
apps/dashboard	加盟店ダッシュボード（Next.js 15）
packages/merchant	Express + Hono ミドルウェアを備えた加盟店向け SDK	README
packages/agent	x402 決済を自動処理するエージェント向け SDK	README
packages/core	共通の型、チェーン設定、定数	README
packages/db	Drizzle ORM スキーマ + マイグレーション	README
packages/program	Solana 用 Anchor プログラムクライアント	README
packages/solana	Kora のガス代無料トランザクション + Squads スマートアカウント	README
packages/onboarding	非カストディアル型ウォレットの生成 + 加盟店の初期設定	README
packages/cli	ターミナルのみでの加盟店オンボーディング（npx @pincerpay/cli）	README
packages/mcp	AI アシスタント向け MCP サーバー（26 個のツール）	README
examples/	加盟店およびエージェントのアプリ例

クイックスタート

前提条件

• Node.js 22+
• pnpm 10+
• PostgreSQL（Supabase を推奨）

インストール

pnpm install

ビルド

pnpm build

開発

# Start all services
pnpm dev

# Start individual services
pnpm --filter @pincerpay/facilitator dev
pnpm --filter @pincerpay/dashboard dev

データベース

# Generate migrations from schema
pnpm db:generate

# Push schema to database
pnpm db:push

オンボーディングスクリプト

ダッシュボードをクリックして操作することなく、コマンドラインから加盟店をプロビジョニングできます。

# Generate non-custodial wallets only (no DB)
pnpm create-wallets

# End-to-end: generate wallets, create merchant, mint API key
DATABASE_URL=postgresql://... pnpm bootstrap-merchant \
  --name "My Merchant" --auth-user-id <supabase-uuid>

# Mint a key for an existing merchant
DATABASE_URL=postgresql://... pnpm create-api-key list
DATABASE_URL=postgresql://... pnpm create-api-key create --merchant <id|name> --label "Production"

同じフローは、@pincerpay/mcp の MCP ツール（bootstrap-wallets、bootstrap-merchant、create-api-key、list-merchants）としても利用できます。加盟店のオンボーディングをご覧ください。

加盟店向け SDK

import express from "express";
import { pincerpay } from "@pincerpay/merchant/express";

const app = express();

app.use(
  pincerpay({
    apiKey: process.env.PINCERPAY_API_KEY!,
    merchantAddress: "YOUR_SOLANA_ADDRESS",
    routes: {
      "GET /api/weather": {
        price: "0.01",
        chain: "solana",
        description: "Weather data",
      },
    },
  })
);

Hono ミドルウェア、マルチチェーン設定、API リファレンスの詳細については、@pincerpay/merchant README をご覧ください。

エージェント向け SDK

import { PincerPayAgent } from "@pincerpay/agent";

const agent = await PincerPayAgent.create({
  chains: ["solana"],
  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
});

// Automatic 402 handling
const response = await agent.fetch("https://api.example.com/weather");

支出ポリシー、マルチチェーン設定、Squads スマートアカウントについては、@pincerpay/agent README をご覧ください。

対応チェーン

チェーン	ネットワーク ID	ステータス
Base	eip155:8453	メインネット
Base Sepolia	eip155:84532	テストネット
Polygon	eip155:137	メインネット
Polygon Amoy	eip155:80002	テストネット
Solana	solana:mainnet	対応
Solana Devnet	solana:devnet	テストネット

デプロイ

サービス	URL
ファシリテーター	https://pincerpayfacilitator-production.up.railway.app
ダッシュボード	https://pincerpay.com

ファシリテーターは Docker 経由で Railway にデプロイされます。ダッシュボードは Vercel にデプロイされます。主要チェーンは Solana（devnet）です。Base と Polygon は、任意のセカンダリチェーンとして対応しています。

技術スタック

• ランタイム： Node.js 22（pnpm モノレポ + Turborepo）
• ファシリテーター： Hono + @x402/core + @x402/evm + @x402/svm + viem
• ダッシュボード： Next.js 15 + Tailwind CSS + Supabase Auth
• データベース： PostgreSQL（Supabase）+ Drizzle ORM
• CI： GitHub Actions（型チェック → テスト → ビルド）
• プロトコル： x402（Coinbase）

テスト

pnpm test

5つのスイート（core、agent、merchant、facilitator）にわたる47件のテストがあります。

例

例	説明
examples/express-merchant	PincerPay ミドルウェアを使用する Express マーチャント
examples/agent-weather	天気 API データの料金を支払う AI エージェント
pincerpay-agent-demo	スタンドアロンのエージェントデモリポジトリ

コミュニティ

• Discord
• X の @pincerpay

ライセンス

MIT