> For the complete documentation index, see [llms.txt](https://axon-finance.gitbook.io/axon-finance-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axon-finance.gitbook.io/axon-finance-docs/huang-pi-shu-fu-lu/appendix-datastructures.md).

# 附录 III · 核心数据结构

> **设计状态**：proposed design。以下为说明性定义，字段与编码随实现调整；类型记号仅表意（`u64` = 64 位无符号整数等）。

## 区块 Block

```
Block := {
  header : BlockHeader
  txs    : [ Tx ]              // seqNo 连续区间（B.2.4）
}

BlockHeader := {
  parent_hash  : Hash         // 父块哈希
  height       : u64          // 区块高度
  view         : u64          // 共识视图 r
  tx_root      : Hash         // Merkle(txs)
  state_root   : Hash         // 执行后状态承诺（B.3.3）
  log_head     : Hash         // Entry-Log 哈希链头 h_k（B.4.5）
  timestamp    : u64
  leader       : ValidatorId
  leader_vrf   : VrfProof     // 领导者合法性证明（B.2.3）
  justify_qc   : QuorumCert   // 对 parent 的 QC（B.1.2）
}
```

## Quorum Certificate

```
QuorumCert := {
  block_hash : Hash           // 被认证的区块
  height     : u64
  view       : u64
  agg_sig    : BlsAggSig      // 聚合投票签名（A.2.3）
  signers    : Bitmap         // 参与验证者位图（用于恢复权益）
}
// 有效性：signers 对应权益 > (2/3)·S 且 agg_sig 验证通过
```

## 交易 Tx

```
Tx := {
  sender    : Addr
  nonce     : u64             // 反重放（B.3.2）
  calls     : [ Call ]        // 批量原子调用（C.1.3）
  auth      : AuthData        // 验证器所需授权（签名 / 会话密钥证明）
  gas       : GasParams
  paymaster : PaymasterRef?   // 可选费用代付（C.3.2）
}

Call := { target: Addr, asset: AssetId?, amount: u128?, data: bytes? }

GasParams := { limit: u64, price_params: FeeParams }
```

## 账户 Account

```
Account := {
  nonce        : u64
  balances     : Map<AssetId, u128>   // 多资产一等余额（D.1.2）
  verifier     : VerifierRef          // 可编程验证逻辑（C.1.2）
  policy_root  : Hash?                // 会话密钥/授权策略承诺（C.2.2）
  code         : Hash?                // 可选：WASM 策略/合约承诺（C.3）
  storage_root : Hash?                // 可选：账户存储子树根
}
```

## 会话密钥策略 SessionPolicy

```
SessionPolicy := {
  session_id : Hash
  pubkey     : PubKey                 // 会话密钥公钥
  scope : {
    L_total   : u128                  // 总限额（累计）
    L_tx      : u128                  // 单笔上限
    window    : (t0: u64, t1: u64)    // 时间窗
    allowlist : [ Addr ]              // 白名单 W
    assets    : [ AssetId ]           // 资产范围 S
    rate      : (max: u32, per: u64)  // 频率 ρ
    calls     : [ CallPattern ]       // 调用范围 F
  }
  state : {                           // 链上认证的会话状态（C.2.3）
    spent : u128
    count : u32
    revoked : bool
  }
}
```

## 带单场次 CopyRound

```
CopyRound := {                        // 官方带单场次（E.3.3）
  round_id   : Hash
  asset      : SymbolId               // 标的（市值前 100 或核心 ETF）
  t_cat      : u64                    // 确定性催化剂时点
  g          : Ratio                  // 保底率 ∈ [1%,3%]（E.3.5）
  cap        : u128                   // 单场跟单总额上限
  tier_min   : u8                     // 最低参与等级（银/金/钻）
  window     : (t_open: u64, t_settle: u64)   // 结算窗口 2–24h
  state      : Open | Locked | Settling | Settled | Aborted | Refunded  // E.3.4
  max_loss   : u128                   // 对冲后最大可能损失 χ·P（E.4.2）
}
```

## 托管专户 EscrowAccount

```
EscrowAccount := {                    // 按单托管，Escrow/Conditional 实例（D.1 / E.3.4）
  round_id   : Hash
  principals : Map<Addr, u128>        // 各跟单人本金 p_i
  total_P    : u128                   // 跟单总额 ΣP_i ≤ cap
  release    : Predicate              // 释放谓词 = 「预言机证明该场已结算」
  isolation  : { user, desk, treasury 严格隔离 }   // E.3.2 不变式
}
```

## 结算证明 SettlementAttestation

```
SettlementAttestation := {            // 链下结算结果上链证明（E.3.5）
  round_id   : Hash
  net_pnl    : i128                   // 已证明的链下净收益
  price_ref  : PriceProof             // 结算价：多源中位数 + MAD（D.2）
  sig        : AttestSig              // 量化台签名，Vrf_attest 验证（D.3.4）
  challenge  : (until: u64, disputed: bool)   // 争议窗口 Δ_chal
}
```

## 带单准备金池 ReservePool

```
ReservePool := {                      // 带单准备金池 R_ct（E.4.3）
  balance    : u128                   // 池内资金
  open_loss  : u128                   // Σ MaxLoss(ρ)，所有未结场次
  coverage   : Ratio                  // Ξ = balance / open_loss ≥ 150%
  index      : u128                   // rebasing 份额指数（借 E.1.2）
  state      : Normal | Throttled | Halted | Protection   // E.4.4
}
```

## 状态证明 Proof

```
InclusionProof := {                   // 包含证明（A.2.4 / B.3.4）
  key   : Key
  value : bytes
  path  : [ Node ]                    // Merkle 路径
}
// 验证：Vrf_trie(state_root, key, value, path) → {0,1}

ExclusionProof := { key: Key, path: [Node] }   // 不存在证明
```

## Entry-Log 条目

```
LogEntry := {
  seqNo : u64                         // 全局单调序号（B.4.1）
  tx    : Tx
  hash  : Hash                        // h_k = H(h_{k-1} ‖ seqNo ‖ tx)（B.4.2）
}
```

***

> **文档结束。** 本黄皮书描述 AXON Finance 的 proposed design；具体实现、参数与选型以测试网、安全评审与治理结论为准。返回：[黄皮书导言](/axon-finance-docs/ji-shu-huang-pi-shu-technical-yellowpaper/yellowpaper.md) · [白皮书首页](/axon-finance-docs/readme.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://axon-finance.gitbook.io/axon-finance-docs/huang-pi-shu-fu-lu/appendix-datastructures.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.