Neuronto Payments: x402 facilitator and API gateway

x402 入门示例

使用官方 x402 SDK 收取 HTTP 路由费用并支付费用的最简可运行方式。这里的每个文件都可以直接运行；你只需更改收款钱包。

x402 重新启用了 HTTP 402 Payment Required。服务器收到未付款请求时会返回 402 和机器可读的条款，客户端签署稳定币付款，支付协调器验证签名并在链上结算。服务器无需持有密钥，也无需与区块链交互。

选择一个

文件夹	技术栈	内容
express	Node、Express	一个收费的 GET /premium 路由
hono	Node、Hono	使用 Hono 实现相同的路由
next	Next.js App Router	一个收费的 API 路由
fastapi	Python、FastAPI	使用 Python 实现相同的路由
client	Node 和 Python	使用脚本或 Agent 为 402 路由付款

一分钟内运行一个

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 作为支付协调器：负责验证付款方签名并广播结算交易的服务。每个文件中都只有一行配置，可替换为任意 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。退款会自动完成；燃料费不由你承担。

你需要准备

• 一个用于收款的钱包地址。你无需安装任何软件来接收款项：付款会以 USDC 转账的形式到达你在 MERCHANT 中填写的地址。
• 对于付款客户端，需要一个有资金的密钥。切勿将真实密钥写入文件：这里的每个示例都会从环境中读取密钥。

许可证

Apache-2.0。