一个创新的AI推理计费系统，通过Circle纳米支付和Arc测试网实现逐输出Token的USDC微支付，让AI服务的按Token计费首次在经济层面变得可行。

NanoPay LLM：基于Circle纳米支付的逐Token计费AI推理系统\n\n## 项目概述\n\nNanoPay LLM是一个突破性的AI推理计费系统，由ogazboiz团队为Agentic Economy on Arc黑客松（2026年4月20-26日）开发。该系统首次实现了逐输出Token的USDC计费，通过Circle纳米支付技术在Arc测试网上完成结算。这一创新让AI服务的按Token计费从理论概念转变为经济可行的商业模式。\n\n## 核心创新：逐Token微支付\n\n传统AI推理服务通常采用预付费或订阅模式，用户需要提前购买一定量的Token额度。NanoPay LLM彻底改变了这一模式，实现了真正的"用多少付多少"：\n\n- 每个输出Token单独计费：Gemini模型生成的每一个Token都会产生一次亚美分级别的USDC授权\n- 链下签名，链上结算：通过EIP-3009标准进行链下授权签名，再由Circle Gateway批量结算到链上\n- 即时启停：用户可以随时停止阅读回复，计费立即停止，实现真正的按实际使用量付费\n\n## 技术架构详解\n\n### 1. 支付流程设计\n\n一次500个Token的对话会产生500个链下授权，这些授权会聚合成一个批量链上结算。这种设计的精妙之处在于：\n\n- 单个Token成本趋近于零：通过批量结算，每个Token的链上结算成本被摊薄到几乎为零\n- Gemini 3 Flash输出Token价值约$0.00005：与以太坊主网单笔交易约$2.00的成本相比，成本比率高达40,000倍\n- Arc测试网+Gateway批量结算：实现亚美分级别的实际成本\n\n### 2. 四种演示模式\n\n项目提供了四种不同的演示场景，展示系统的灵活性和实用性：\n\n单流模式（Single Stream）：一次x402授权后，Gemini 3 Flash开始流式输出Token，并实时显示计数器。这是最基本的按Token付费场景。\n\n代理链模式（Agent Chain）：Gemini 3 Pro负责规划大纲，然后将任务交给Gemini 3 Flash起草内容。整个过程涉及两次独立的x402支付，展示了多代理协作场景下的计费机制。\n\n压力测试模式（Stress）：一键触发10/50/100/200次连续的x402授权，满足黑客松50+交易的要求，同时验证系统在高并发场景下的稳定性。\n\n代理功能调用模式（Agent Function Calling）：Gemini 3 Pro自主调用Circle API，包括get_gateway_balance（查询网关余额）、deposit_usdc_to_gateway（存入USDC到网关）、pay_for_inference（支付推理费用）等操作，实现完整的自动化支付闭环。\n\n### 3. 核心技术栈\n\nArc测试网（Chain ID: 5042002）：所有结算操作都在Arc测试网上完成，提供RPC接口和区块链浏览器支持。\n\nUSDC稳定币：采用ERC-20标准的USDC，6位小数精度，为所有计费提供稳定的价值锚定。\n\nCircle纳米支付：基于@circle-fin/x402-batching库，在服务端使用createGatewayMiddleware中间件，在客户端使用GatewayClient.pay()方法。\n\nCircle Gateway：提供deposit()存款、getBalances()查询余额、批量结算等核心功能。\n\nx402协议：Circle托管的支付 facilitator，地址为gateway-api-testnet.circle.com。\n\nERC-8004标准：Arc网络上的标准部署，包括：\n- IdentityRegistry（身份注册表）\n- ReputationRegistry（声誉注册表）\n- ValidationRegistry（验证注册表）\n\n服务器作为代理注册，并在每次完成的流上记录giveFeedback反馈。\n\nGemini 3系列模型：同时使用Gemini 3 Flash（流式输出）和Gemini 3 Pro Preview（支持Function Calling的代理功能）。\n\n## 经济可行性分析\n\n项目的"边际故事"（Margin Story）揭示了为什么这种计费模式在经济上是可行的：\n\n| 结算方式 | 单笔交易成本 | 与Token价值的比率 |\n|---------|------------|------------------|\n| Gemini 3 Flash输出Token | ~$0.00005 | 基准 |\n| 以太坊主网结算 | ~$2.00 | 40,000倍 |\n| Arc测试网+Gateway批量结算 | 亚美分，接近零 | 可接受范围 |\n\n这种巨大的成本差异说明：只有在Arc测试网配合Gateway批量结算的环境下，逐Token的链上计费才具备经济可行性。这也是目前唯一能让逐Token计费真正落地的技术方案。\n\n## 应用场景与商业价值\n\n### 1. 微服务AI API\n开发者可以构建按实际使用量计费的AI API服务，用户无需预付大额费用，降低了使用门槛。\n\n### 2. 内容创作平台\n写作助手、代码生成工具等可以精确计费，用户只为实际生成的内容付费，而不是购买固定的Token包。\n\n### 3. 多代理协作系统\n在复杂的AI代理工作流中，每个子任务都可以独立计费，实现精细化的成本控制和透明的费用分摊。\n\n### 4. 去中心化AI市场\n为去中心化AI服务市场提供基础设施，让模型提供者和服务消费者之间建立直接的微支付通道。\n\n## 技术实现细节\n\n### 项目结构\n\n\napps/server Express服务端 + Gateway中间件 + Gemini + Function Calling代理 + 压力测试运行器 + ERC-8004客户端\napps/web Next.js UI + 4种演示模式 + x402流程时间线 + 实时活动流\npackages/cli 外部买家CLI（余额/存款/购买/链上操作）使用GatewayClient\npackages/mcp MCP服务器将NanoPay暴露为代理工具\npackages/shared 共享TypeScript类型\ncontracts Foundry：ServiceRegistry、SpendingPolicy、Attestation（ERC-8004是规范的，未重新部署）\n\n\n### 快速开始\n\nbash\npnpm install\ncp apps/server/.env.example apps/server/.env\n# 设置GEMINI_API_KEY、SELLER_ADDRESS、DEMO_BUYER_PRIVATE_KEY（从https://faucet.circle.com获取资金）\npnpm dev:server # :8787\npnpm dev:web # :3000\n\n\n然后打开http://localhost:3000并点击任意演示模式。\n\n## 未来展望\n\nNanoPay LLM展示了区块链微支付与AI服务结合的潜力。随着Layer 2解决方案的成熟和交易成本的进一步降低，这种逐Token计费模式可能成为AI服务的主流商业模式。\n\n项目还提供了详细的文档支持：\n- SUBMISSION.md：黑客松提交内容、边际故事、反馈、视频脚本\n- DEMO.md：可复现的演示流程\n- ARCHITECTURE.md：流程图和组件角色\n- DEPLOY.md：Vercel + Railway部署说明\n\n## 结语\n\nNanoPay LLM不仅是一个技术演示，更是AI服务商业模式的一次重要探索。通过结合Circle的纳米支付技术和Arc测试网的高效结算，它证明了逐Token计费在技术和经济层面的可行性。对于希望构建精细化计费AI服务的开发者来说，这是一个极具参考价值的开源项目。

NanoPay LLM：基于Circle纳米支付的逐Token计费AI推理系统\n\n项目概述\n\nNanoPay LLM是一个突破性的AI推理计费系统，由ogazboiz团队为Agentic Economy on Arc黑客松（2026年4月20-26日）开发。该系统首次实现了逐输出Token的USDC计费，通过Circle纳米支付技术在Arc测试网上完成结算。这一创新让AI服务的按Token计费从理论概念转变为经济可行的商业模式。\n\n核心创新：逐Token微支付\n\n传统AI推理服务通常采用预付费或订阅模式，用户需要提前购买一定量的Token额度。NanoPay LLM彻底改变了这一模式，实现了真正的"用多少付多少"：\n\n- 每个输出Token单独计费：Gemini模型生成的每一个Token都会产生一次亚美分级别的USDC授权\n- 链下签名，链上结算：通过EIP-3009标准进行链下授权签名，再由Circle Gateway批量结算到链上\n- 即时启停：用户可以随时停止阅读回复，计费立即停止，实现真正的按实际使用量付费\n\n技术架构详解\n\n1. 支付流程设计\n\n一次500个Token的对话会产生500个链下授权，这些授权会聚合成一个批量链上结算。这种设计的精妙之处在于：\n\n- 单个Token成本趋近于零：通过批量结算，每个Token的链上结算成本被摊薄到几乎为零\n- Gemini 3 Flash输出Token价值约$0.00005：与以太坊主网单笔交易约$2.00的成本相比，成本比率高达40,000倍\n- Arc测试网+Gateway批量结算：实现亚美分级别的实际成本\n\n2. 四种演示模式\n\n项目提供了四种不同的演示场景，展示系统的灵活性和实用性：\n\n单流模式（Single Stream）：一次x402授权后，Gemini 3 Flash开始流式输出Token，并实时显示计数器。这是最基本的按Token付费场景。\n\n代理链模式（Agent Chain）：Gemini 3 Pro负责规划大纲，然后将任务交给Gemini 3 Flash起草内容。整个过程涉及两次独立的x402支付，展示了多代理协作场景下的计费机制。\n\n压力测试模式（Stress）：一键触发10/50/100/200次连续的x402授权，满足黑客松50+交易的要求，同时验证系统在高并发场景下的稳定性。\n\n代理功能调用模式（Agent Function Calling）：Gemini 3 Pro自主调用Circle API，包括get_gateway_balance（查询网关余额）、deposit_usdc_to_gateway（存入USDC到网关）、pay_for_inference（支付推理费用）等操作，实现完整的自动化支付闭环。\n\n3. 核心技术栈\n\nArc测试网（Chain ID: 5042002）：所有结算操作都在Arc测试网上完成，提供RPC接口和区块链浏览器支持。\n\nUSDC稳定币：采用ERC-20标准的USDC，6位小数精度，为所有计费提供稳定的价值锚定。\n\nCircle纳米支付：基于@circle-fin/x402-batching库，在服务端使用createGatewayMiddleware中间件，在客户端使用GatewayClient.pay()方法。\n\nCircle Gateway：提供deposit()存款、getBalances()查询余额、批量结算等核心功能。\n\nx402协议：Circle托管的支付 facilitator，地址为gateway-api-testnet.circle.com。\n\nERC-8004标准：Arc网络上的标准部署，包括：\n- IdentityRegistry（身份注册表）\n- ReputationRegistry（声誉注册表）\n- ValidationRegistry（验证注册表）\n\n服务器作为代理注册，并在每次完成的流上记录giveFeedback反馈。\n\nGemini 3系列模型：同时使用Gemini 3 Flash（流式输出）和Gemini 3 Pro Preview（支持Function Calling的代理功能）。\n\n经济可行性分析\n\n项目的"边际故事"（Margin Story）揭示了为什么这种计费模式在经济上是可行的：\n\n| 结算方式 | 单笔交易成本 | 与Token价值的比率 |\n|---------|------------|------------------|\n| Gemini 3 Flash输出Token | ~$0.00005 | 基准 |\n| 以太坊主网结算 | ~$2.00 | 40,000倍 |\n| Arc测试网+Gateway批量结算 | 亚美分，接近零 | 可接受范围 |\n\n这种巨大的成本差异说明：只有在Arc测试网配合Gateway批量结算的环境下，逐Token的链上计费才具备经济可行性。这也是目前唯一能让逐Token计费真正落地的技术方案。\n\n应用场景与商业价值\n\n1. 微服务AI API\n开发者可以构建按实际使用量计费的AI API服务，用户无需预付大额费用，降低了使用门槛。\n\n2. 内容创作平台\n写作助手、代码生成工具等可以精确计费，用户只为实际生成的内容付费，而不是购买固定的Token包。\n\n3. 多代理协作系统\n在复杂的AI代理工作流中，每个子任务都可以独立计费，实现精细化的成本控制和透明的费用分摊。\n\n4. 去中心化AI市场\n为去中心化AI服务市场提供基础设施，让模型提供者和服务消费者之间建立直接的微支付通道。\n\n技术实现细节\n\n项目结构\n\n\napps/server Express服务端 + Gateway中间件 + Gemini + Function Calling代理 + 压力测试运行器 + ERC-8004客户端\napps/web Next.js UI + 4种演示模式 + x402流程时间线 + 实时活动流\npackages/cli 外部买家CLI（余额/存款/购买/链上操作）使用GatewayClient\npackages/mcp MCP服务器将NanoPay暴露为代理工具\npackages/shared 共享TypeScript类型\ncontracts Foundry：ServiceRegistry、SpendingPolicy、Attestation（ERC-8004是规范的，未重新部署）\n\n\n快速开始\n\nbash\npnpm install\ncp apps/server/.env.example apps/server/.env\n设置GEMINI_API_KEY、SELLER_ADDRESS、DEMO_BUYER_PRIVATE_KEY（从https://faucet.circle.com获取资金）\npnpm dev:server :8787\npnpm dev:web :3000\n\n\n然后打开http://localhost:3000并点击任意演示模式。\n\n未来展望\n\nNanoPay LLM展示了区块链微支付与AI服务结合的潜力。随着Layer 2解决方案的成熟和交易成本的进一步降低，这种逐Token计费模式可能成为AI服务的主流商业模式。\n\n项目还提供了详细的文档支持：\n- SUBMISSION.md：黑客松提交内容、边际故事、反馈、视频脚本\n- DEMO.md：可复现的演示流程\n- ARCHITECTURE.md：流程图和组件角色\n- DEPLOY.md：Vercel + Railway部署说明\n\n结语\n\nNanoPay LLM不仅是一个技术演示，更是AI服务商业模式的一次重要探索。通过结合Circle的纳米支付技术和Arc测试网的高效结算，它证明了逐Token计费在技术和经济层面的可行性。对于希望构建精细化计费AI服务的开发者来说，这是一个极具参考价值的开源项目。