开发环境搭建

搭建本地开发环境，用于构建和测试 Nexus 商户集成。

前置条件

工具	版本	用途
Node.js	24+	商户 Agent 运行时
Foundry	最新版	智能合约交互
Docker	24+	本地服务编排
Git	最新版	版本控制

快速开始

1. 克隆并安装

git clone <your-merchant-agent-repo>
cd your-merchant-agent
npm install

2. 配置环境变量

创建 .env 文件，填入开发凭据：

# PlatON 开发网
PLATON_RPC=https://devnet3openapi.platon.network/rpc
CHAIN_ID=20250407

# 合约地址
USDC_ADDRESS=0xFF8dEe9983768D0399673014cf77826896F97e4d
ESCROW_ADDRESS=0xeB33a9C2b4c7D3F44Fd5514F90C355AF6bb79236

# 商户钱包
PRIVATE_KEY=your-dev-private-key

# Nexus Core（本地或远程）
NEXUS_CORE_URL=https://api.nexus.platon.network
PORTAL_TOKEN=your-portal-token

3. 获取测试 USDC

访问 Nexus Playground 水龙头 nexus.platon.network/#/playground 领取测试 USDC。

4. 运行 Agent

npm run dev

你的商户 Agent 现在应该可以通过 skill.md 清单被 Nexus Core 发现。

测试支付

使用 Playground 的快速支付测试模块，模拟端到端支付流程。

常见问题

问题	解决方案
交易卡在 pending	使用 Foundry 的 --legacy 标志。参见 PlatON 开发网 Skills
"Invalid signature" 错误	检查 EIP-712 domain — USDC version 为 "1"
未收到 Webhook	确认端点可公网访问