Sidiora-Labs/Paxeer-X-Network · 上手攻略

  • 仓库：Sidiora-Labs/Paxeer-X-Network
  • 链接：https://github.com/Sidiora-Labs/Paxeer-X-Network
  • 分类：区块链基础设施 · DeFi · Agent 支付网络
  • 作者：Tom
  • 更新：2026-10-05

是什么

Paxeer X 是一个分布式超状态机（Distributed HyperState Machine），用于支付、代码执行和意图路由，专为自主 AI Agent 设计。它通过一条仅追加的 Activity 日志作为唯一权威来源，实现可验证的确定性执行。

整个系统分为两层：

  • LayerX（执行层）：在确定性环境中执行普通 Agent 活动，包含序列化和全局排序，所有参与方对执行结果无争议
  • Paxeer（结算层）：LayerX 的周期检查点结算网络，持有资产保管、担保债券、挑战、提款、争议和紧急退出机制

架构核心哲学：一致性执行必须排除一切非确定性因素——不允许浮点数运算、本地时钟决定、数据库迭代顺序等，确保任何人重放日志都能得到完全相同的结果。

解决什么问题

  • 自主 Agent 的支付确定性：当 Agent 执行支付操作时，参与方需要对「是否付款成功」无争议地达成一致，Paxeer 通过签名的执行收据（receipt）提供可密码学验证的结果
  • 双重结算保障：LayerX 内部执行无需 Paxeer 交易，周期结算时才跨链，从而兼顾效率和安全性
  • 可审计的资产管理：所有余额变更都必须经过 Paxeer 链上的 402LXP 组件（唯一允许写余额的模块），其他模块只发出已验证的转账集合
  • 面向机器的结算：设计目标是服务于运行 Agent 的人类操作员，而非普通终端用户

快速安装

前置依赖

  • Git
  • Rust（用于构建 CLI，cargo build）
  • Python 3（用于某些测试脚本）
  • Docker/Kind（用于本地集群）

构建 LayerX CLI

git clone https://github.com/Sidiora-Labs/Paxeer-X-Network.git
cd Paxeer-X-Network

# 构建 CLI 工具
cargo build --manifest-path platform/cli/Cargo.toml

# 将 CLI 加入 PATH（或使用绝对路径 platform/target/debug/layerx）
export PATH="$PWD/platform/target/debug:$PATH"

启动本地 Beta 集群（推荐先走这一步）

# 使用 Makefile 启动本地测试集群
make platform-beta-cluster-up

启动成功后输出 environment exported to build/beta-cluster/env，随后需要：

# 加载环境变量（每次新终端都要执行）
source build/beta-cluster/env
# 或
. build/beta-cluster/env

集群默认端口分配：

服务 端口
Testnet 19443
Gateway 19444
Faucet（私网） 19445
Developer API 19450
Paxeer 结算 19449
Paxeer Observer 19452
Identity 19451
Agent 19447

Paxeer EVM Chain ID：125

渲染预览（不实际部署）

bash platform/hosted/tests/beta-cluster.sh render

关闭集群

bash platform/hosted/tests/beta-cluster.sh down

核心用法

1. 创建身份与钱包

⚠️ 公开网络上 layerx wallet create 会返回 wallet_registration_unavailable；公开钱包注册不通过 CLI，只能通过 custody credit 路径。以下为本地集群操作：

# 创建 Ed25519 签名密钥
layerx key create alice
layerx key default alice
layerx wallet list

记录输出的 DID 和公钥（64 位十六进制），不要暴露种子短语：

export WALLET_DID='<did from layerx wallet list>'
export WALLET_PUBLIC_KEY='<64-hex public key>'

⚠️ 无头（headless）环境需提前配置加密文件存储，见 platform/cli/README.md#headless-credential-storage。

2. 获得资金（本地集群水龙头）

本地集群有私网 faucet，无需真实资产：

# 通过 faucet 获取测试代币（参考 Quickstart 完整流程）
# 水龙头地址已由 . build/beta-cluster/env 自动配置

⚠️ 公开网络没有公开水龙头。账户资金需要通过 custody credit 路径：先在 Paxeer Chain 125 上向 custody 预编译合约存款，再通过 LayerX gateway 提交 credit 活动。

3. 提交 Activity 并验证收据

这是 Paxeer 的核心操作循环：

# 构造 activity（Activity 是签名的规范编码请求）
# 提交到 LayerX 节点
curl -X POST https://localhost:19444/rpc \
  --header 'Content-Type: application/json' \
  --header "Authorization: LayerX-Key $GATEWAY_KEY_ID:$GATEWAY_KEY_SECRET" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "lx_sendActivity",
    "params": ["<canonical-activity-hex>", "executed"]
  }'

# 验证收据（receipt）
# 收据包含执行结果和状态根的签名，可本地验证

Activity 的签名绑定：序列号（sequence）+ 时间戳 + 幂等标识，每次必须使用新的 activity 字节，不能复用历史字节。

4. 资产管理与转账

标准生命周期（四个步骤，顺序不得跳过）：

# ① 注册 Asset
# ② 打开账户（open）
# ③ 铸造（mint）
# ④ 发送（SEND）

每步都是独立的签名 Activity，都要等待 executed 结果后再构造下一步。参考 PaymentsQuickstart 中 Python 脚本 tests/bridge/custody_credit.py 配合 rpc_read/rpc_write 函数使用。

5. 部署 Programs（代码执行）

参考 docs/wiki/Programs.md，通过 CLI 或 HTTP 路由提交部署请求。

6. HTTP 402 支付路径

支持通过 HTTP 402（Payment Required）机制执行支付，具体流程见 docs/wiki/PaymentsQuickstart.md。

典型适用场景

  1. AI Agent 支付基础设施：为自主运行的 Agent 提供确定性的支付和结算，允许多方对执行结果无争议
  2. 多 Agent 协作的资产管理：多个 Agent 之间需要原子化地转移资产，且结果可密码学验证
  3. 意图路由（Intent Routing）：用户表达高层次的交易意图，系统通过确定性执行保证结果可预期
  4. 区块链基础设施研究者：理解「超状态机」架构和确定性执行的实际实现

坑与注意

  1. Beta 软件，API 可能Breaking Change：公开测试网（mainnet-beta）尚在活跃开发中，生产使用需谨慎
  2. 没有公开水龙头：无法像典型测试网那样直接领到免费代币，funding 需要通过 custody credit 路径，流程较复杂
  3. 序列号严格绑定：每次 activity 的签名都绑定当前 sequence，复制历史 activity 字节直接提交会失败
  4. 确定性执行约束：共识关键执行禁止浮点数、localclock、不确定迭代顺序，写合约时需确保所有计算可重现
  5. 无公开 DID 注册路由：CLI 的 wallet create 在公开网络不工作，DID 注册需要走专门的 custody 路径
  6. 需要 6 个独立端口（本地集群）：如果端口被占用会失败，需确保无其他服务占用 19443-19453 范围
  7. Rust 编译耗时：完整构建 CLI 需要 Rust 工具链，机器配置较低时可能需要数分钟
  8. 收据验证需自行实现：本地验证收据需要理解 receipt-policy JSON 结构（包含 protocol_version、network_id、sequencer_id、checkpoint_context_digest 等字段）

与同类对比

项目 架构特点 执行确定性 结算层 典型场景
Paxeer X 超状态机 + 双层架构 ✅ 严格确定性 Paxeer Chain Agent 支付/意图路由
Solana 并行执行 + Sealevel ✅ 确定性（乐观并行） Solana 本身 高性能 DApp
Hyperlane 跨链意图路由 ⚠️ 域特定 多链原链 跨链互操作
EigenLayer Restaking AVS ⚠️ AVS 设计决定 Ethereum 共享安全
Aptos/Sui Move 语言 + 并行 ✅ 确定性 各自链 Web3 应用
Fuel UTXO 执行模型 ✅ 确定性 Fuel 本身 执行层专注

Paxeer X 的独特性在于：把「可验证的确定性执行收据」作为一等公民，以及 Activity 日志即权威的设计哲学——数据库索引只是临时投影，重放日志可重建一切。

一句话推荐结论

如果你正在构建需要多方对 AI Agent 操作结果无争议的支付/执行系统，Paxeer X 的确定性执行架构值得深入研究；如果你只是想快速上手一个区块链开发框架，它的学习曲线可能过高，建议先看 spec 设计文档再决定是否入坑。