核心用法
mpc-accept-crypto-payments 是面向商家的 Solana 链上加密货币收款工具，基于 MoonPay Commerce（原 Helio）官方 API 构建。核心能力包括：
- 支付链接创建：通过
POST /paylink/create生成可分享的收款链接，支持固定金额或动态定价，默认以 USDC 结算但允许付款人用任意 Solana 代币支付（自动兑换）。 - 收银台 URL：通过
POST /charge将支付链接转为可嵌入网页的结账页面。 - 交易追踪：实时查询特定支付链接的交易记录与状态。
- 多币种支持：支持 SOL、USDC 等主流代币，可通过
/currency端点获取完整列表。 - 生命周期管理：支持启用/禁用支付链接。
配置流程自动化程度高：运行 setup.sh 后，脚本自动验证凭证、获取钱包列表并选择默认收款地址，信息以 600 权限存储于 ~/.mpc/helio/config。
显著优点
1. 官方 API 直接对接：非第三方封装，数据来源权威，功能与官方文档同步。
2. 代币兑换灵活性：付款人可使用任意支持的 Solana 代币支付，后台自动转为 USDC，降低买家门槛。
3. 配置自动化：一键完成凭证验证、钱包获取与默认配置，减少手动操作。
4. 场景覆盖全：内置 PRODUCT、INVOICE、SUBSCRIPTION、EVENT 等模板，适应电商、订阅、票务等多元场景。
5. 安全存储：凭证文件权限 600，且通过交互式脚本输入避免历史记录泄露。
潜在缺点与局限性
- 单链限制：仅支持 Solana，EVM 或其他公链需另寻方案。
- 账户门槛：需注册 MoonPay Commerce 并完成 KYC 获取 API Key/Secret。
- 价格精度易错：
price字段需以 base units（如 USDC 的 10⁶）传入，小数位处理不当会导致订单金额错误。 - 区域合规：MoonPay 服务受地域监管限制，部分国家/地区商家可能无法开户。
- 依赖外部服务：链上状态查询与法币出入金依赖 MoonPay 基础设施，存在服务商宕机或政策调整风险。
适合人群
- Solana 生态的电商卖家、内容创作者、SaaS 服务商
- 需快速集成加密货币收款但不愿自建智能合约的小微企业
- 已有 MoonPay Commerce 账户、希望自动化支付流程的技术用户
常规风险
- API 凭证泄露：若
~/.mpc/helio/config被未授权读取，攻击者可创建恶意收款链接或查询交易历史。需确保文件权限 600 及运行环境可信。 - 价格输入错误：混淆
price的 base units 与实际金额可能导致定价失误（如少输 6 个零）。 - 链上确认延迟：Solana 网络拥堵时交易确认时间延长，需合理设置异步回调或轮询逻辑。
- 合规与税务：加密货币收款涉及资本利得税、增值税等合规义务，建议咨询专业顾问。