Bridge 读方法

本页是 Bridge 充提 相关 JSON-RPC 读方法（写操作见 写操作 §11，历史流水见 账户历史）。

Bridge 充提

getBridgeSettlement

全局结算闸门。无参数。

响应 data： { "settlement_paused": false }

响应示例：

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "height": 12345,
    "data": { "settlement_paused": false }
  }
}

getBridgeDeposit

按链上分配序号查询单笔充值。

参数	类型	必填	说明
seq	u64	是	链上充值序号（自增，严格连续）

响应 data： { "deposit": DepositResponse }

响应示例：

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "height": 12345,
    "data": {
      "deposit": {
        "seq": 101,
        "chain": "bsc",
        "external_seq": 50001,
        "tx_hash": [171, 205, 239, 1, 35, 69, 103, 137, 171, 205, 239, 1, 35, 69, 103, 137, 171, 205, 239, 1, 35, 69, 103, 137, 171, 205, 239, 1, 35, 69, 103, 137],
        "owner": "0x1111222233334444555566667777888899990000",
        "amount": "1000.000000",
        "bsc_block": 12345678,
        "bsc_ts": 1717200000,
        "status": "Credited",
        "recorded_at_block": 12340,
        "recorded_at_ms": 1717199000000,
        "credited_at_block": 12341,
        "credited_at_ms": 1717199100000
      }
    }
  }
}

getBridgeDepositByExternalRef

按外部链充值引用 (chain, seq) 查询充值单。用于 operator 判断某笔外部链充值是否已处理——未找到时 data 为 null。

参数	类型	必填	说明
chain	String	是	外部链标识（小写，如 "bsc" / "admin"）
seq	u64	是	外部链充值序号

响应 data： { "deposit": DepositResponse } 或 null

响应示例（未找到）：

{
  "jsonrpc": "2.0", "id": 1,
  "result": { "height": 12345, "data": null }
}

listBridgeDeposits

充值列表（seq 升序，可按 owner 过滤）。

参数	类型	必填	说明
owner	Address20	否	按 owner 过滤
offset	usize	否	默认 0
limit	usize	否	默认 100，最大 500

响应 data： DepositResponse[]（flat 数组，非 { deposits: [...] }）

响应示例：

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "height": 12345,
    "data": [{
      "seq": 101,
      "chain": "bsc",
      "external_seq": 50001,
      "tx_hash": null,
      "owner": "0x1111222233334444555566667777888899990000",
      "amount": "1000.000000",
      "bsc_block": 0,
      "bsc_ts": 0,
      "status": "Recorded",
      "recorded_at_block": 12340,
      "recorded_at_ms": 1717199000000,
      "credited_at_block": null,
      "credited_at_ms": null
    }],
    "page": { "offset": 0, "limit": 100, "total": 512 }
  }
}

getBridgeWithdrawal

按 ID 查询单笔提现。

参数	类型	必填	说明
id	u64	是	提现请求 ID

响应 data： { "withdrawal": WithdrawResponse }

响应示例：

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "height": 12345,
    "data": {
      "withdrawal": {
        "request_id": 2001,
        "owner": "0x1111222233334444555566667777888899990000",
        "amount": "500.000000",
        "chain": "bsc",
        "status": "Pending",
        "settle_tx_hash": null,
        "settle_bsc_block": null,
        "settle_bsc_ts": null,
        "reason_code": null,
        "requested_at_block": 12344,
        "requested_at_ms": 1717199500000,
        "finalized_at_block": null,
        "finalized_at_ms": null
      }
    }
  }
}

listBridgeWithdrawals

提现列表（可按 owner、status 过滤）。

参数	类型	必填	说明
owner	Address20	否	按 owner 过滤
status	String	否	pending/settled/refunded
offset	usize	否	默认 0
limit	usize	否	默认 100，最大 500

响应 data： WithdrawResponse[]（flat 数组）

DepositResponse 字段：

字段	类型	说明
seq	u64	链上充值序号（自增，排序键）
chain	String	外部链标识（小写，如 "bsc" / "admin"）
external_seq	u64	外部链充值序号（去重键）
tx_hash	[u8;32]?	BSC 交易哈希（JSON 序列化为字节数组，非 0x hex）
owner	Address20	充值账户
amount	String	充值金额（SCALE_6）
bsc_block	u64	BSC 块号（管理员补 0）
bsc_ts	u64	BSC 时间戳秒（管理员补 0）
status	DepositStatus	"Recorded" 已登记 · "Credited" 已入账
recorded_at_block	u64	登记链块高
recorded_at_ms	u64	登记时间（毫秒）
credited_at_block	u64?	入账块高（未入账为 null）
credited_at_ms	u64?	入账时间（未入账为 null）

WithdrawResponse 字段：

字段	类型	说明
request_id	u64	提现请求 ID
owner	Address20	提现账户
amount	String	提现金额（SCALE_6）
chain	String	用户选择的下提目标链（如 "bsc"）
status	WithdrawStatus	"Pending" · "Settled" · "Refunded"
settle_tx_hash	[u8;32]?	仅 Settled（JSON 字节数组）
settle_bsc_block	u64?	仅 Settled
settle_bsc_ts	u64?	仅 Settled
reason_code	u8?	仅 Refunded
requested_at_block	u64	请求所在块
requested_at_ms	u64	请求时间
finalized_at_block	u64?	null = Pending
finalized_at_ms	u64?	null = Pending

响应示例：

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "height": 12345,
    "data": [{
      "request_id": 2001,
      "owner": "0x1111222233334444555566667777888899990000",
      "amount": "500.000000",
      "chain": "bsc",
      "status": "Settled",
      "settle_tx_hash": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32],
      "settle_bsc_block": 12345700,
      "settle_bsc_ts": 1717200100,
      "reason_code": null,
      "requested_at_block": 12344,
      "requested_at_ms": 1717199500000,
      "finalized_at_block": 12346,
      "finalized_at_ms": 1717200001000
    }],
    "page": { "offset": 0, "limit": 100, "total": 128 }
  }
}

---