数据分析师如何分析合约代码

通常情况下，你开始研究一个协议时，会迅速找到一个调用 5 个以上合约并引发 20 个以上日志的示例交易。你去查看他们的文档（如果有的话），可能会看到这样的内容：

Aave v3 实际上还有 10 个合约，但图片太长

你如何浏览这些 Solidity 合约以找到你分析所需的答案和数据？我将在本指南中涵盖一个完整的示例以及我的提示和技巧。
我们将研究新的 Zora x Uniswap 合约，该合约于 2024 年 8 月初部署。

你应该先尝试在 Dune 上搜索 涉及某个协议的现有查询/仪表板，因为通常阅读/分叉现有 SQL 比直接阅读 Solidity 更容易。

从交易开始

每当你开始分析一个协议时，这里有你想找的两个示例交易：

• 主要合约部署交易（部署新的 NFT 或 Uniswap 池）
• 主要操作交易（交换、铸造等）

我说“主要”是因为通常有许多合约和操作，但它们通常都源于一个起始合约/操作。大多数情况下，你的实际起点来自某个地方的推文，你必须逐步找到这两个交易。

让我们以 Zora 在其协议上的新 Uniswap 扩展为例——本质上允许你创建一个可以在 Uniswap 上作为 ERC20 进行交易的 ERC1155，而不是在 OpenSea/Blur 上进行交易。他们发布了这份 简短概述指南，还发布了 他们在这个新协议上的第一次铸造。在真正的加密风格中，真正的文档通常要到很晚才会出现（有时甚至永远不会）。你仍然应该尝试先搜索文档，但这个示例将完全依赖链上数据进行侦查。

第一次铸造

我通常发现获取主要合约和交易的最简单方法是通过自己与产品互动。因此，当它首次上线时，我 铸造了一些 Limitless Zorb。

此交易为我提供了一个可以稍后用于交易量计算的主要操作，但更重要的是，它为我提供了两个主要合约的参考：

1. ZoraTimedSaleStrategyImpl：我知道这肯定是这个升级的新协议核心，因为它是主要的“目标”合约，可能是设置铸造/二级市场配置的地方。
2. Limitless Zorb：我知道这是一个 ERC1155 代币，某种程度上被转换为 ERC20 以便在 Uniswap 上交易。

区块浏览器上的合约页面总是有一个“创建交易哈希”链接（通常你首先会被带到代币页面，然后你必须再次点击合约才能到达合约页面）。

Limitless Zorb 集合合约

所以如果快速汇总一下我们所拥有的信息，我们得到：

• ZoraTimedSaleStrategy (ZTSS)
  • 创建交易 - 快速查看告诉我这不是一个工厂合约，因为它调用了一个“确定性调用者”合约，该合约用于 使用 CREATE2 部署，而不是 CREATE。这将其部署到一个确切的地址，通常是为了使同一合约在多个链上具有相同的地址。
• ERC1155/ERC20 集合 (Limitless Zorb)
  • 创建交易 - 我看到调用了一个“工厂”来部署这个，所以这可能是一个工厂创建的合约，每个集合都有自己的部署。
  • 铸造交易 - 我从产品界面发送的交易
  • 我们还没有二级市场/Uniswap 交易

考虑到这一基础，我们可以定义一个问题并深入代码。

深入合约

好了，一旦你对主要合约和交易有了大致了解，你就可以开始侦查了。你应该列出你的问题，并尝试浏览代码以回答每一个问题，对于本指南，我想回答的问题是：

问题：“铸造期结束后，Uniswap 池是如何启动的，谁控制第一个 LP 仓位，谁从中获得交换费用？”

我们可以猜测，销售的权限/功能与 ZoraTimedSaleStrategy (ZTSS) 合约相关，而不是与集合合约本身相关。有趣的是，我在集合创建交易中没有看到这个合约发出的任何事件——这对我来说是一个信号，表明你可以创建一个 ERC1155，并可能在之后附加 ERC20/定时销售组件。

我去查看 ZTSS 合约代码页面，我首先看到的是 它是一个代理。这意味着“代理”处理变量的存储，但有一个“实现”合约包含实际的合约逻辑。你通常需要转到“读取代理”或“写入代理”选项卡以获取实现地址：

实现地址

⚠ 警告：代理可以升级以指向不同的实现以更改逻辑。此示例中的代理在 2024 年 8 月 23 日升级为 此实现，但本指南的其余部分引用了 旧实现。这是为了引入 新的 launchMarket() 条件。

好了，现在我们有了一些进展…… ，查看代码浏览器，我可以看到这里实际上有数十个继承/引用的合约。

你可以直接忽略很多内容——但是最重要的是要关注“接口”。接口用于 让一个合约调用另一个合约的函数。我知道 Uniswap 实际上是一组不同的合约，所以我想寻找用于创建/向池添加流动性的 Uniswap 接口。

这就像在文件顶部的导入中按 ctrl+f “IUniswapV3Pool” 一样简单。我找到了 5 个匹配项，其中 2 个是导入行，3 个位于 285-290 行。

向上滚动一点，我可以看到调用的是这个 “launchMarket()” 函数。这里的说明说，任何人在主要销售结束后都可以调用它来创建 uniswap 池。

如果你已经有那个地址，你也可以通过查找 uniswap 池和池的创建 tx 哈希来找到这个。

现在如果我向下滚动，我会注意到实际上没有看到 uniswap 池被创建或流动性被添加 - 只是设置了一个价格。相反，函数的末尾调用了一个 “IERC20Z” 接口，并带有 “activate” 函数。

好的 - 所以现在我们知道必须以某种方式找到 ERC20Z 合约并检查 “activate” 函数的定义。你的思维应该希望转向寻找与Limitless zorb 收藏相关的 ERC20Z。有几种方法可以做到这一点：

• 期望在集合上有一个读取函数来获取 erc20 地址
• 查找集合创建 txn 中的某个事件以获取 erc20 地址
• 查找与集合合约相关的 ZTSS 中的某个事件/函数，以将 erc20 合约与集合合约关联

前两个实际上在这种情况下是死胡同，因为 erc20 是集合的可选组件。如果我去 ZTSS 代理页面和 “logs” 列，我可以看到一堆 SaleSet() 事件，似乎包含 “erc20zAddress” 和 “poolAddress” 字段。这并不总是最可靠的方法，我建议你将合约插入我的 EVM 快速入门仪表板 并检查最常发出的事件/函数的示例。

ZTSS proxy 的 Logs 页

我会点击最近的 SetSale() 交易之一，看看发生了什么。通过跟踪日志，我可以看到 ERC20z 和 uniswap 池实际上在销售扩展被激活时已经部署（CREATE2）！它只是还没有任何流动性，因此无法进行交易。

日志链接

ERC20z 也是从 ZTSS 合约部署的，所以我可以 100% 确定有某个读取函数可以搜索集合并获取其 ERC20z（和 uniswap 池）详细信息。果然，我们有一个 “sale()” 读取函数：

阅读“sale()”函数以及 Limitless Zorb 详细信息

我插入 Limitless Zorb 收藏地址和代币 ID（来自 URL）并获得我们的 erc20zAddress 和 poolAddress！如果你早些时候注意到它，你也可以通过 ctrl + f “IERC20Z” 在 ZTSS 实现代码中找到这个😉。

好的，现在我们 erc20z 地址 - 所以现在让我们回到寻找 “activate()” 函数。它是一个代理，所以我再次选择 “读取合约” → “实现” 以获取实际代码。然后我只需 ctrl + f 查找 “function activate(“，因为这就是在 solidity 中定义函数的方式。

合约代码

在该函数中，我看到这一关键行，通过接口调用 Uniswap 仓位管理器(Position Manager)以创建第一个流动性仓位：

它实际上指向一个 “royalties” 地址！好的，再次 ctrl + f 查找 royalties 的定义。

这是一个公共变量，这意味着它自动获得一个读取函数。我去读取合约 “royalties()” 以获取版税合约地址：

我们现在离目标很近 - 接下来让我们去查看版税合约代码。这个合约很简单，因为只有两个相关的公共函数：claim() 和 claimFor()，它将流动性池仓位的费用传递给代币的创建者。这里的复杂性在于读取 “内部” 函数， 这些基本上是无法在合约外部调用的函数 ，并在外部函数中调用。

我通常将代码粘贴到 chatgpt 中，并问它：“这是一个 solidity 合约。你能画出一个节点图，显示所有函数调用的调用流吗？将公共/外部函数显示为橙色，内部函数显示为浅蓝色，接口函数显示为灰色。将其显示为从左到右的树状图，其中函数调用的开始在左侧。增大图形大小以适应所有节点。”

调用图链接

所以我们感兴趣的函数调用流看起来像这样：

• claim() → _claim() → _collect() / _transfer()

你只会在交易跟踪中看到 “claim()” 被调用，因为合约内调用没有跟踪（除了memory traces
，但我们不讨论这个）。_collect() 通过调用position manager
uniswap 接口从池中获取费用，而 _transfer() 将这些费用传递给创建者。

值得注意的是，_transfer() 函数有一部分费用归 Zora 团队所有。

Royalties 合约

我们可以在 getFee() 函数中找到一个公共变量 feeBps，所以我们从合约的 “读取” 页面读取它：

它以 “bps” 为单位，这意味着基点，其中 100 个基点等于 1 个百分点。2500/100 是 25，因此他们从初始 LP 奖励中收取 25% 的费用！如果你去 uniswap 池，你会看到它在所有交换中收取 1% 的费用。因此，实际上，创建者在所有交换中收取 0.75% 的费用，而 Zora 收取 0.25% 的费用。

值得注意的是，合约中没有任何提取 LP 仓位的函数 - 因此该 LP 仓位永远无法从池中提取。创建者（和 Zora）也无法 rug 池，尽管这些 ERC20/ETH LP 代币现在也无法认领（除非你买下整个曲线）。

总的来说，我们现在得到了答案：

• Uniswap 池在铸造期结束后是如何启动的？ launchMarket() 函数，任何人都可以调用它。池已经在 SetSale() 事件中与 erc20z 一起部署。
• 谁控制第一个 LP 仓位？ 没有人，它归版税合约所有并被销毁。版税合约仍然可以从该仓位收取费用。
• 谁获得了交换费用？ 费用在 Zora 和创作者之间分配，分别为 0.25%和 0.75%。

合约精通

多么奇妙的旅程！如果你跟随了这里的一切，那么你确实掌握了如何在合约、接口、代理和交易之间导航。仅依靠区块浏览器和像 Dune 这样的工具来做到这一点将使你成为超级分析师。

再次强调，所有这些都是为了回答“在铸造期结束后，Uniswap 池是如何启动的，谁控制第一个 LP 仓位，以及谁获得了交换费用？”

我们在这段旅程中找到的资源列表：

• ZoraTimedSaleStrategy (ZTSS), (impl)
  • 创建交易 - 快速查看告诉我这不是一个工厂合约。所以它必须在所有集合之间共享。
  • SaleSet ERC20/池创建交易
• ERC1155/ERC20 集合（Limitless Zorb）
  • 创建交易 - 我看到调用了一个“工厂”来部署这个，所以这可能是一个工厂创建的合约，每个集合都有自己的部署。
  • 铸造交易 - 我从产品界面发送的那个
  • erc20z 地址 (impl)
• 版税合约（不是代理）

你会在深入数据时发现函数结构和系统参数、部署管理等模式。在进行研究时保持像我上面那样的笔记清单会让你的生活轻松很多。