**类别：** Portal API - EVM 核心 **用途：** 教导代理如何构建 EVM 跟踪的 SQD Portal Stream API 查询（内部事务和合约部署） ** ** ## 何时使用此技能当您需要执行以下操作时，请使用此技能： * 跟踪合约部署（CREATE/CREATE2 操作） * 监控内部ETH转账 * 分析合约之间的内部函数调用 * 跟踪代理模式委托调用 * 调查 MEV 机器人活动（多跳交换） * 查找特定地址部署的合约 **EVM 跟踪捕获未出现在交易表中的内部合约交互**。 ** ** ## 查询结构 **基本EVM跟踪查询结构：** { “类型”：“evm”， “来自区块”：19500000， “到块”：19500100， “痕迹”：[{ “类型”：[“呼叫”]， “callFrom”：[“0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45”]， “callSighash”：[“0x414bf389”] }], “字段”：{ “踪迹”：{ “类型”：真实， “callFrom”：正确， “callTo”：正确， “callValue”：真， “callSighash”：正确 } } } **字段说明：** * `type: "evm"` \- EVM 链必需 * `fromBlock/toBlock` \- 块范围（必填） * `traces` \- 跟踪过滤器对象数组 * `type` \- 跟踪类型：`call`、`create`、`suicide`、`reward` * 过滤器因跟踪类型而异（参见下面的示例） ** ** ## 了解跟踪类型 **EVM 有 4 种跟踪类型：** ### 1\. CALL - 内部函数调用内部合约到合约的函数调用（包括 ETH 转账）。 **关键字段：** * `callFrom` \- 呼叫者地址（已索引） * `callTo` \- 被叫方地址（已索引） * `callSighash` \- 函数选择器（索引） * `callValue` \- 转账的 ETH 金额 * `callType` \- 调用、静态调用、委托调用、调用代码 ### 2\.创建 - 合约部署通过 CREATE 或 CREATE2 操作码创建合约。 **关键字段：** * `createFrom` \- 部署者地址（已索引） * `createResultAddress` \- 部署的合约地址（INDEXED） * `createResultCode` \- 部署的字节码 * `createValue` \- ETH 发送到合约 ### 3\.自杀（自毁）- 合同毁坏合约自毁操作（已弃用，但仍然存在于链上）。 **关键字段：** * `suicideAddress` \- 合约被销毁（已索引） * `suicideRefundAddress` \- 接收剩余 ETH 的地址（已索引） * `suicideBalance` \- 退还的 ETH 金额 ### 4\.奖励 - 区块奖励挖矿/验证者奖励（主要是历史奖励，不在 PoS 链中使用）。 **关键字段：** * `rewardAuthor` \- 验证者地址（已索引） * `rewardValue` \- 奖励金额 * `rewardType` \- 块、叔叔等 ** ** ## 示例 ### 示例 1：按地址查找部署的合约 **用例：** 跟踪特定部署者地址部署的所有合约。 { “类型”：“evm”， “来自区块”：19000000， “到块”：19100000， “痕迹”：[{ “类型”：[“创建”]， “创建来自”：[“0x1234567890123456789012345678901234567890”] }], “字段”：{ “踪迹”：{ “类型”：真实， “创建自”：正确， “创建结果地址”：true， “创建结果代码”：true， “创造价值”：正确， “交易哈希”：true， “区块编号”：true } } } **数据集：** `ethereum-mainnet` **注释：** * `type: ["create"]` 用于 CREATE/CREATE2 操作的过滤器 * `createFrom` 是部署者地址 * `createResultAddress` 是新的合约地址 * `createResultCode` 包含部署的字节码（不是创建字节码） ** ** ### 示例 2：跟踪内部 ETH 转账 **用例：** 监控来自/到特定合约的内部 ETH 转账。 { “类型”：“evm”， “来自区块”：19500000， “到块”：19500100， “痕迹”：[{ “类型”：[“呼叫”]， “callFrom”：[“0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D”] }], “字段”：{ “踪迹”：{ “类型”：真实， “callFrom”：正确， “callTo”：正确， “callValue”：真， “呼叫类型”：真， “错误”：正确， “交易哈希”：true } } } **数据集：** `ethereum-mainnet` **合约：** Uniswap V2 Router **注释：** * 捕获来自路由器的内部呼叫 * `callValue` 显示 ETH 转移 * `错误：null` = 成功，`错误："..."` = 失败 * 用于跟踪路由器 → 配对传输 ** ** ### 示例 3：监控 Delegatecall 模式（代理合约） **用例：** 跟踪委托调用操作以进行代理模式分析。 { “类型”：“evm”， “来自区块”：19500000， “到块”：19500100， “痕迹”：[{ “类型”：[“呼叫”]， “callType”：[“delegatecall”] }], “字段”：{ “踪迹”：{ “类型”：真实， “callFrom”：正确， “callTo”：正确， “callSighash”：正确， “呼叫类型”：真， “交易哈希”：true } } } **注释：** * `callType: ["delegatecall"]` 专门针对 delegatecalls 进行过滤 * `callFrom` = 代理合约 * `callTo` = 执行合约 * 用于跟踪代理升级和实施使用情况 ** ** ### 示例 4：查找 CREATE2 部署 **用例：** 跟踪确定性合约部署 (CREATE2)。 { “类型”：“evm”， “来自区块”：19500000， “痕迹”：[{ “类型”：[“创建”]， “创建结果地址”：[“0x1234567890123456789012345678901234567890”] }], “字段”：{ “踪迹”：{ “类型”：真实， “创建自”：正确， “创建结果地址”：true， “创造价值”：正确， “交易哈希”：true， “区块编号”：true } } } **注释：** * 无法直接按 CREATE 与 CREATE2 进行过滤（两者都具有“create”类型） * 使用`createResultAddress`来查找具体的合约部署 * 检查交易输入的 CREATE2 操作码 (0xf5) ** ** ### 示例 5：跟踪多跳交换（MEV 分析） **用例：**分析复杂的交换路径（例如，代币 A → B → C）。 { “类型”：“evm”， “来自区块”：19500000， “到块”：19500100， “痕迹”：[{ “类型”：[“呼叫”]， “callSighash”：[“0x022c0d9f”] }], “字段”：{ “踪迹”：{ “类型”：真实， “callFrom”：正确， “callTo”：正确， “callSighash”：正确， “callInput”：真， “callOutput”：真， “交易哈希”：true } } } **数据集：** `ethereum-mainnet` **功能：** Uniswap V2 对上的 `swap(uint256,uint256,address,bytes)` **注释：** * 跟踪货币对之间的内部交换调用 * `callFrom` = 调用合约（路由器或前一对） * `callTo` = 配对合约 * 每笔交易的多个跟踪 = 多跳交换 ** ** ### 示例 6：合约自毁跟踪 **用例：** 监控被销毁的合约（罕见但重要）。 { “类型”：“evm”， “来自区块”：19000000， “到块”：19500000， “痕迹”：[{ “类型”：[“自杀”]， "自杀退款地址": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"] }], “字段”：{ “踪迹”：{ “类型”：真实， “自杀地址”：真实， “suicideRefundAddress”：true， “自杀平衡”：正确， “交易哈希”：true， “区块编号”：true } } } **注释：** * `suicideAddress` = 合约被销毁 * `suicideRefundAddress` = 剩余 ETH 的接收者 * `suicideBalance` = 退还的 ETH 金额 * 合并后：自毁已被弃用，但仍然有效 ** ** ## 关键概念 ### 1\.追踪与交易 **交易** = 提交到区块链的顶级操作 **痕迹** = 交易内执行的所有操作（包括内部调用） **示例：** 交易：用户调用 Uniswap Router.swap() ├─ 轨迹1：路由器调用Pair.swap() [内部调用] ├─ Trace 2: Pair 调用 Token.transfer() [内部调用] └─ 轨迹3：配对转账ETH【内部ETH转账】 **关键见解：** 一笔交易可以生成数十条痕迹。 ** ** ### 2\.按跟踪类型的索引字段 **调用痕迹：** * `callFrom` \- 索引（快速） * `callTo` \- 索引（快速） * `callSighash` \- 索引（快速） * `callType` \- 索引（快速） **创建痕迹：** * `createFrom` \- 索引（快速） * `createResultAddress` \- 索引（快速） **自杀痕迹：** * `suicideAddress` \- 索引（快速） * `suicideRefundAddress` \- 索引（快速） **奖励痕迹：** * `rewardAuthor` \- 索引（快速） * `rewardType` \- 索引（快速） **始终首先按 INDEXED 字段过滤以获得最佳性能。** ** ** ### 3\.调用类型解释 **EVM 中的 4 种调用类型：** **1.`call`（最常见）：** * 正常的外部函数调用 * 可以转账ETH * 被调用的合约在它自己的上下文中执行 * 示例：路由器调用 Pair 合约 **2.`静态调用`:** * 只读调用（不能修改状态） * 无法转账ETH * 用于查看/纯函数 * 示例：通过balanceOf()检查余额 **3.`委托调用`:** * 在调用者的上下文中执行代码 * 用于代理模式 * 存储变化影响调用者，而不是被调用者 * 示例：代理→实现模式 **4.`callcode`（已弃用）：** * 旧版本的 delegatecall * 在现代合约中很少使用 ** ** ### 4\.跟踪错误处理 **错误字段表示调用失败：** { "error": null // ✅ 调用成功 } { "error": "Out of Gas" // ❌ 调用失败 } { "error": "Reverted" // ❌ 调用已恢复（要求失败） } **关键见解：** * 失败的内部调用不会恢复事务，除非传播 * `错误：null` = 成功跟踪 * `错误：“...”` = 跟踪失败 * 即使某些跟踪失败，事务也可以成功（try/catch 模式） ** ** ### 5\.跟踪位置和顺序 **轨迹包括位置字段：** * `traceAddress` \- 指示调用树中位置的数组 * `transactionIndex` \- 交易在区块中的位置 * `subtraces` \- 子轨迹数 **跟踪树示例：** 交易0 ├─ 跟踪[0] - Router.swap() │ ├─ Trace [0, 0] - Pair.swap() │ │ └─ Trace [0, 0, 0] - Token.transfer() │ └─ Trace [0, 1] - 另一个内部调用 └─ 轨迹[1] - 并行调用 **`traceAddress` 值：** * `[]` \- 顶级调用（事务本身） * `[0]` \- 第一次内部调用 * `[0, 0]` \- 第一次调用中的第一次调用 * `[0, 1]` \- 第一次调用中的第二次调用 ** ** ## 常见错误 ### ❌ 错误 1：使用事务过滤器进行内部调用 { “交易”：[{ "to": ["0x..."] // ❌ 错过内部呼叫 }] } **修复：** 使用跟踪捕获内部调用： { “痕迹”：[{ “类型”：[“呼叫”]， "callTo": ["0x..."] // ✅ 捕获内部调用 }] } ** ** ### ❌错误2：按错误字段过滤CREATE { “痕迹”：[{ “类型”：[“创建”]， "callFrom": ["0x..."] // ❌ 错误字段（callFrom 用于 CALL 跟踪） }] } **修复：** 使用 CREATE 特定字段： { “痕迹”：[{ “类型”：[“创建”]， "createFrom": ["0x..."] // ✅ 正确的部署字段 }] } ** ** ### ❌错误 3：忽略跟踪类型 { “痕迹”：[{ "callFrom": ["0x..."] // ❌ 未指定类型 }] } **修复：** 始终指定跟踪类型： { “痕迹”：[{ "type": ["call"], // ✅ 显式类型 “callFrom”：[“0x...”] }] } ** ** ### ❌错误 4：期望所有交易都有踪迹 **并非所有交易都会生成痕迹：** * 简单的ETH转账（无代码执行）无痕迹 * 失败的交易可能没有痕迹 * 痕迹是由合约代码执行生成的 **解决方案：** 使用交易表进行简单转账，跟踪合约交互。 ** ** ### ❌错误 5：混淆创建字节码和运行时字节码 { “痕迹”：[{ “类型”：[“创建”] }], “字段”：{ “踪迹”：{ "createResultCode": true // 运行时字节码（已部署） } } } **注：** * `createResultCode` = 部署的字节码（运行时） * 创建字节码包括构造函数+运行时字节码 * 获取创建字节码，查询transaction.input字段 ** ** ## 响应格式 Portal 返回 **JSON 行**（每行一个 JSON 对象）： {“标头”：{“块编号”：19500000，“哈希”：“0x...”，“时间戳”：1234567890}} {“traces”：[{“type”：“call”，“callFrom”：“0xRouter...”，“callTo”：“0xPair...”，“callSighash”：“0x022c0d9f”，“callValue”：“0”，“callType”：“call”，“error”：null}]} {“traces”：[{“type”：“create”，“createFrom”：“0xFactory...”，“createResultAddress”：“0xNewContract...”，“createResultCode”：“0x6080...”，“createValue”：“0”}]} **解析：** 1. 通过换行符分割响应 2.将每一行解析为JSON 3.第一行是区块头 4. 后续行包含轨迹数组 ** ** ## 性能提示 ### 1\.过滤器选择性 **最具选择性到最不选择性：** 1.特定的 `createFrom` 或 `callFrom/To` \+ 类型（最好） 2.具体地址+类型 3.输入+叹息 4. 仅键入（宽泛） 5.无过滤器（避免） **示例：** // 最佳性能 { “痕迹”：[{ “类型”：[“呼叫”]， "callFrom": ["0x..."], “callSighash”：[“0x022c0d9f”] }] } ** ** ### 2\.微量体积注意事项 **痕迹是大容量数据：** * 复杂的 DeFi 交易可以生成 100 多个痕迹 * 使用窄块范围（1000-10000块） * 始终添加过滤器（类型+地址最小值） **避免：** { “来自块”：0， “到块”：19500000， "traces": [{}] // ❌ 数十亿条痕迹 } ** ** ### 3\.选地策略 **仅请求所需字段：** // 最小部署跟踪 { “字段”：{ “踪迹”：{ “类型”：真实， “创建自”：正确， “创建结果地址”：true } } } // 全迹分析 { “字段”：{ “踪迹”：{ “类型”：真实， “callFrom”：正确， “callTo”：正确， “callSighash”：正确， “callInput”：真， “callOutput”：真， “callValue”：真， “错误”：正确， “跟踪地址”：true } } } ** ** ## 相关技能 * **portal-query-evm-transactions** \- 查询生成跟踪的顶级事务 * **portal-query-evm-logs** \- 在跟踪调用期间发出的查询事件 * **portal-dataset-discovery** \- 为您的链查找正确的数据集名称 ** ** ## 其他资源 * **API 文档：** * **架构参考：** * **EVM 跟踪规范：** * **代理模式：** ## Subsquid 官方文档 ### 核心文档 * **[llms.txt]()** \- Portal API 跟踪查询快速参考 * **[llms-full.txt]()** \- 完整的门户文档 * **[skill.md]()** \- 综合痕迹查询指南 ### API 资源 * **[EVM OpenAPI Schema]()** \- 完整的跟踪查询规范 * **[可用数据集]()** \- 所有支持的 EVM 网络 * **[EVM Stream API]()** \- 跟踪查询文档

门户查询 Evm 跟踪

包含技能