Skip to main content
最小链路只需要两个进程:一个写节点和一个 leafage-evm。用 HTTP 模式直连,跳过 Kafka 和 S3。这足以验证代码改动、调试新链适配,或者直观理解数据是怎么流的。
生产链路走 Kafka + S3,见部署指南。本页的形态不具备水平扩展和一致性保障能力。

前置

步骤

1

构建 leafage-evm

也可以用镜像:public.ecr.aws/b2h7a5c4/chaintable/leafage-evm-x
2

启动写节点并开放 trace 命名空间

trace 命名空间提供 trace_debankBlock,leafage-evm 的 HTTP 模式依赖它。验证:
3

启动 leafage-evm

启动后它会轮询写节点,把新区块的状态差异应用到内存 StateTree。日志里 updater target 会显示追块进度。
4

发出第一个查询

执行一次合约调用:
返回值与写节点上同一次 eth_call 一致,说明链路已经打通。

几个会遇到的情况

请求的高度超出了 State 节点保留的状态范围。加 --archive 启动归档模式,或把查询目标改成 latest。生产环境由 nodex-proxy 自动转发到 Archive 节点。
这是预期行为。leafage-evm 不存交易数据,区块接口只返回 header。交易数据在 S3 外部桶的 BlockFile 里。
gas 估算的方法名是 estimateGas(无命名空间前缀),不是 eth_estimateGas。完整方法列表见 RPC 参考
HTTP 模式是串行轮询,速度受写节点 RPC 限制,只适合开发验证。生产环境用 Kafka + S3,可以并行拉取。

下一步

发送 RPC 请求

批量调用、blockCtx、gas 估算与模拟的完整示例。

核心概念

刚跑通的链路里,每个角色和术语分别是什么。

架构总览

理解五个组件如何协作。

部署指南

搭建带 Kafka + S3 的完整链路。

RPC 参考

可用方法与参数。

参与开发

仓库地图与构建命令。