地址标签（address_labels）

{db}.address_labels 给 Robinhood Chain（chain id 4663）上一批"已知地址"打标签，配合 一个把标签 JOIN 到 transactions.from/transactions.to 的视图，方便写 SQL 时不用记 一长串 hex 地址。

SQL：schema/clickhouse/derived/011_address_labels.sql。

安装与补算Copy Anchor Link

sed 's/{db}/robinhood/g' schema/clickhouse/derived/011_address_labels.sql \
  | clickhouse-client --multiquery

只需要执行一次即可建表 + 灌入种子数据 + 建视图。这张表不是由物化视图从 {db}.logs/{db}.transactions 实时派生的，而是人工核对后的静态参考表，所以没有 "补算历史区间"的概念——直接重跑这份 SQL 就是唯一的更新方式。

重新灌入 / 修正某条标签：改这份 .sql 文件里的 INSERT 那一行，重跑整份文件即可。 address_labels 用 ReplacingMergeTree(added_at)、以 address 为排序键，added_at 更新的行会替换旧行（读的时候要 FINAL，见下）——所以重跑是幂等的，不会插出重复的 同地址标签行。这张表不涉及 is_deleted/reorg：这里的每一行描述的是"这个地址是什么" 这件事实，不是某条链上事件，链重组不会让一个地址的身份跟着回滚。

表结构Copy Anchor Link

已收录的地址（22 条，2026-09-25 核对）Copy Anchor Link

Arbitrum / ArbOS 协议预编译（precompile，12 条）Copy Anchor Link

这些地址是 ArbOS 协议本身规定的固定地址，不是 Robinhood Chain 专属，任何 Arbitrum Nitro 链上都一样。参考： Arbitrum 官方 Precompiles Reference。

未采纳：0x...67（文档/搜索结果对这个地址目前是"ArbBLS（已禁用）"还是别的 东西说法不一致，eth_getCode 虽然非空但没法用它区分身份，为避免打错标签，这次 没有把它收进种子数据）。任务原始描述里给出的 ArbosTest→0x67、 ArbRetryableTx→0x68、ArbGasInfo→0x69 这组映射经核实是记错的，上表是修正后 的真实映射。

系统地址（system / sequencer，2 条）Copy Anchor Link

L2 代币桥 gateway/router（bridge_gateway，3 条）Copy Anchor Link

来源：Robinhood Chain 官方 Protocol Contracts 文档（"Robinhood Chain" 列，即 L2 主网）。

同一份文档里的 Delayed Inbox / Sequencer Inbox / Bridge / Outbox / Rollup 都是 L1 （Ethereum）合约，在 Robinhood Chain 的 RPC 上 eth_getCode 全部返回空——这次没有 把它们收进 address_labels（这张表只标 L2 上真实存在代码的地址）。

代币与知名跨链部署（token / well_known_deployment，5 条）Copy Anchor Link

任务里提到的另一个候选 create2 部署工厂地址，因为没能从可靠来源确认它在这条链上 具体对应哪个已知工厂实现，这次没有收录——宁可少标一个，也不在证据不足时瞎猜名字。

独立验证：真实回填数据 e2e 核对Copy Anchor Link

用节点 RPC 对创世区块段 [0, 200) 做了一次真实 chain-indexer backfill --sink clickhouse（临时 scratch 库，验证完已 DROP），核对 v_transactions_labeled：

-- 独立算法 A：不经过视图，直接对 transactions FINAL 按 address_labels 做子查询过滤
SELECT count() FROM {db}.transactions FINAL
WHERE is_deleted = 0 AND block_number < 200
  AND (`from` IN (SELECT address FROM {db}.address_labels FINAL)
    OR `to` IN (SELECT address FROM {db}.address_labels FINAL));
-- 结果：242

-- 算法 B：通过视图统计 from_label/to_label 非空的行数
SELECT count() FROM {db}.v_transactions_labeled
WHERE block_number < 200 AND (from_label != '' OR to_label != '');
-- 结果：242（与算法 A 精确相等）

区间内总交易数 401，与 backfill 命令输出的 blocks=200 txs=401 logs=370 一致。抽样看 到的真实标注例子（block 1-3，来自这次真实回填的数据，不是编的）：

• block 1, tx 0：from/to 都被标为 "ArbOS 内部交易的系统发送方"（type=0x6a）
• block 1, tx 1：to 被标为 "ArbRetryableTx"
• block 3, tx 2：to 被标为 "L2 Gateway Router"
• block 11, tx 1：to 被标为 "ArbOwner"

address_labels 里 22 条按 category 分布：precompile 12、bridge_gateway 3、 well_known_deployment 3、token 2、system 1、sequencer 1。

查询示例Copy Anchor Link

-- 某个区块区间内，所有打到过"已知系统/桥/代币地址"的交易
SELECT block_number, hex(hash), from_label, `to`, to_label
FROM {db}.v_transactions_labeled
WHERE block_number >= {lo} AND block_number < {hi}
  AND (from_label != '' OR to_label != '')
ORDER BY block_number, tx_index;

-- 按标签统计交易量（务必带 block_number 范围，否则是全表 FINAL 扫描）
SELECT to_label, count() AS tx_count
FROM {db}.v_transactions_labeled
WHERE block_number >= {lo} AND block_number < {hi} AND to_label != ''
GROUP BY to_label
ORDER BY tx_count DESC;