PincerPay

PincerPay

面向 Agent 经济的支付网关。接受来自 AI Agent 的付款。只需添加几行代码，即可通过 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 Agent 调用商家 API 并收到 HTTP 402 响应时，Agent 会对一笔 USDC 转账进行签名。PincerPay 会验证签名、向区块链广播交易，并确认结算。

Monorepo 结构

包	说明	文档
apps/facilitator	x402 交易协调服务（Hono + Node.js）
apps/dashboard	商家控制台（Next.js 15）
packages/merchant	商家 SDK，包含 Express + Hono 中间件	README
packages/agent	Agent SDK，支持自动处理 x402 付款	README
packages/core	共享类型、链配置和常量	README
packages/db	Drizzle ORM 架构 + 迁移	README
packages/program	Solana 的 Anchor 程序客户端	README
packages/solana	Kora 免 Gas 交易 + Squads 智能账户	README
packages/onboarding	非托管钱包生成 + 商家初始化	README
packages/cli	仅通过终端完成商家入驻（npx @pincerpay/cli）	README
packages/mcp	面向 AI 助手的 MCP 服务（26 个工具）	README
examples/	商家和 Agent 应用示例

快速开始

前置条件

• 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。

Agent 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 Agent
pincerpay-agent-demo	独立的 Agent 演示仓库

社区

• Discord
• X 上的 @pincerpay

许可证

MIT