create-x402-app

Conflux x402 脚手架，用于快速生成可运行的支付项目。

快速开始

npx create-x402-app

向导会让你选择：

• 项目名
• 模板预设（core / core+identity）
• 网络（Mainnet/Testnet）
• 包管理器（pnpm/npm/yarn）

模板预设

core（默认推荐）

生成核心支付链路：

• packages/chain-config
• packages/facilitator
• packages/express-middleware
• examples/sandbox
• tools/client

core+identity

在 core 基础上增加身份相关组件：

• packages/attestor
• packages/contracts
• packages/identity-cli

生成后如何运行

cd <your-project>
cp .env.example .env
pnpm install
pnpm build
pnpm dev:facilitator
pnpm dev:sandbox
pnpm start:client

兼容命令：dev:server 是 dev:sandbox 的别名。

可选能力（重点）

这些能力对商家都不是强制的，默认可按最小配置跑通。

1. Auth / Identity（可选）

默认（不启用）：

• AUTH_MODE=none
• AUTH_ENABLED=false

启用后（需要 identity 组件）：

• AUTH_MODE=domain_gate
• AUTH_ENABLED=true
• IDENTITY_REGISTRY_ADDRESS=0x...

2. Refund（可选）

默认（不启用）：

• REFUND_DEFAULT=off

启用后：

• REFUND_DEFAULT=on
• SERVER_PRIVATE_KEY=0x...

3. 实际链上结算（可选）

默认安全模式：

• VERIFY_ONLY_MODE=true（只校验，不执行链上 settle）

需要真实结算时改为：

• VERIFY_ONLY_MODE=false

4. Discovery / Bazaar（可选）

如需链上发现能力，配置：

• AGENT_REGISTRY_ADDRESS=0x...

并可使用：

• pnpm register:chart-agent

v0.2.0 结构变更

• 服务入口从 packages/server 切换为 examples/sandbox
• 保留 dev:server 兼容旧命令

本仓库开发（维护脚手架本身）

pnpm install
pnpm build
pnpm test