XPR Network 开发者技能

本技能提供在 XPR Network 上进行开发所需的全面知识。XPR Network 是一条快速、零 Gas 费的区块链，原生支持 WebAuthn 钱包。

重要免责声明：AI 生成的智能合约代码

智能合约处理真实资产，且一旦部署即不可更改。由 AI（包括本技能生成）生成的代码，在部署至主网前，必须由经验丰富的开发者进行人工审查。

• 务必在测试网充分测试，再执行任何主网部署
• 代码须经熟悉 XPR Network / EOSIO 智能合约的人员审核
• 关键合约需接受安全审计 —— 对于管理高价值资产的合约，建议委托专业安全团队进行审计
• 务必完全理解所部署的代码 —— 切勿部署您尚未彻底掌握的代码

Claude 可加速开发进程并辅助设计模式，但无法替代规范的代码审查、测试与安全审计流程。

XPR Network 概览

XPR Network 是一条基于 EOS 的区块链，专为支付与身份场景优化：

品牌更名：Proton → XPR Network

该区块链于 2024 年完成品牌升级，由 Proton 正式更名为 XPR Network。您可能在以下位置见到遗留的 “Proton” 名称：

• 包名（@proton/cli、@proton/web-sdk、proton-tsc）
• GitHub 组织（XPRNetwork，原为 ProtonProtocol）
• 文档与代码注释中
• 区块浏览器（现为 explorer.xprnetwork.org，原为 protonscan.io 和 proton.bloks.io）

代币符号仍为 XPR，所有功能保持不变。

链 ID

渐进式披露

请根据当前任务按需加载专项模块：

核心开发

代币与身份

DeFi 与交易

集成模式

基础设施

安全与参考

关键提醒：修改合约前必读

请先阅读：safety-guidelines.md

• 切勿修改已存有数据的现有表结构（否则将导致反序列化失败）
• 部署前检查清单
• 故障恢复流程

速查参考

常用 CLI 命令

# 安装 CLI
npm i -g @proton/cli

# 设置网络
proton chain:set proton          # 主网
proton chain:set proton-test     # 测试网

# 查询账户信息
proton account myaccount -t      # 同时显示代币余额

# 查询链上表
proton table CONTRACT TABLE

# 执行操作（action）
proton action CONTRACT ACTION 'JSON_DATA' AUTHORIZATION

# 部署合约
proton contract:set ACCOUNT ./assembly/target

常用 RPC 查询

import { JsonRpc } from '@proton/js';
const rpc = new JsonRpc('https://proton.eosusa.io');

const { rows } = await rpc.get_table_rows({
  code: 'CONTRACT',
  scope: 'CONTRACT',
  table: 'TABLE',
  limit: 100
});

基础合约结构

import { Contract, Table, TableStore, Name, requireAuth } from 'proton-tsc';

@table("mydata")
class MyData extends Table {
  constructor(
    public id: u64 = 0,
    public owner: Name = new Name(),
    public value: string = ""
  ) { super(); }

  @primary
  get primary(): u64 { return this.id; }
}

@contract
class MyContract extends Contract {
  dataTable: TableStore = new TableStore(this.receiver);

  @action("store")
  store(owner: Name, value: string): void {
    requireAuth(owner);
    const row = new MyData(this.dataTable.availablePrimaryKey, owner, value);
    this.dataTable.store(row, this.receiver);
  }
}

基础前端登录

import '@proton/link';  // 移动端钱包支持必需
import ProtonWebSDK from '@proton/web-sdk';

const { link, session } = await ProtonWebSDK({
  linkOptions: {
    chainId: '384da888112027f0321850a169f737c33e53b388aad48b5adace4bab97f437e0',
    endpoints: ['https://proton.eosusa.io']
  },
  selectorOptions: { appName: 'My App' }
});

// session.auth 包含 { actor, permission }
// 使用 session.transact() 发起交易

核心依赖包

官方资源

• 文档: https://docs.xprnetwork.org
• GitHub: https://github.com/XPRNetwork
• 区块浏览器: https://explorer.xprnetwork.org
• 资源中心: https://resources.xprnetwork.org（购买 RAM 等）

安全提醒

1. 切勿修改已部署且含数据的表结构 —— 否则将破坏反序列化过程
2. 主网部署前务必在测试网完整验证
3. 部署前请确认目标账户正确无误 —— 错误账户将覆盖原有合约
4. 部署变更前请备份 ABI 文件
5. 新增功能请使用新表，避免修改已有表结构
6. DEX 充值必须使用空 memo（""） —— 任何非空 memo（如 "deposit"）将导致资金永久丢失且不可恢复。详见 metalx-dex.md。
7. 纯数字账户名（例如 333555）在调用 get_table_rows 时将引发静默数据丢失 —— 详见 rpc-queries.md 中的规避方案。