读取 Ripples 市场

全部规则

• 两个区块边界都包含在内。fromBlock=10&toBlock=15 覆盖区块 10 至 15。
• 一个窗口最多 1000 个区块，两端都计入。超出范围会返回 400 invalid_request，消息中会写明上限。请把你的分块大小设为不超过这个值。
• Every response is a single named key, with no success or data wrapper and no top-level metadata.
• Every amount is an exact decimal string of up to 50 decimal places, never a JSON number. JSON 数字是双精度浮点数，一个 18 位小数的代币在第一笔交易时就会用尽它的有效位数。
• /latest-block 是索引器自己的游标，从来不是链本身的高度。The head is the lowest indexed cursor across every source writing the chain, and /events stops at it, so a block is never served twice and never skipped. 只要读到这个头部区块就停下，就永远不会碰到截断。
• 没有事件的窗口会返回空列表，而不是报错。
• 额度为每 60 秒 600 次请求（按调用方计），是每两秒轮询一次的十倍。如果需要更高的额度，请告诉我们，这只是一项设置。

按顺序拉取一个市场

共四次调用。先取头部区块，再取一个窗口内的交易，然后是市场及其两种资产。下面每个 URL 都是 Robinhood 数据接口的真实地址。

# Ask how far the feed has indexed. Never read past this block.
https://api.ripples.run/v1/dex/robinhood/latest-block
# block.blockNumber is the head. Everything below stops there.

# Read a window of trades. Both bounds are inclusive.
https://api.ripples.run/v1/dex/robinhood/events?fromBlock=57699981&toBlock=57700000
# Each event carries pairId, the legs, priceNative and reserves.

# Look up the market an event names. Its record is fixed at creation, so read it once.
https://api.ripples.run/v1/dex/robinhood/pair?id=0x…poolId
# asset0Id is the launch token and asset1Id is what it is priced in.

# Look up each side of the market, for decimals and supply.
https://api.ripples.run/v1/dex/robinhood/asset?id=0x…token
# decimals is always present. Supplies are exact decimal strings.

已达到目标金额的市场仍会在 /pair 上返回。在 Robinhood 上，它继续在同一个池中、在永久流动性之下交易，所以它的交易会继续出现在 /events 中。

每个 Ripples 池都使用相同的池键：fee = 0 和 tickSpacing = 200，所有发行都一样。两者都是 Hook 合约中的常量，部署无法更改它们，可以放心硬编码。池本身不收取任何费用，所有费用都由 Hook 合约收取。

PoolManager 上的事件

• Initialize. The pool exists. Its block is the market's creation for every aggregator that dates a pair.
• ModifyLiquidity. The launch's own position. The seed is the only one before graduation.
• Swap. Every trade. The amounts are the pool's, before the hook's cut: read TradeFeeCharged, CreatorTaxCharged and SnipeTaxCharged from the hook in the same transaction and subtract all of them to get what the trader received. TradeFeeCharged is emitted once per payee, so one trade lands two of them whenever the launch pays a creator as well as the treasury.

一个会让你的数字出错的地方

Hook 合约在兑换内部收取手续费，所以 PoolManager 的 Swap 事件中的金额会比交易者实际收到的多，差额正好是所收取的手续费。手续费以兑换的非指定货币计：精确输入的买入是发行代币，精确输入的卖出是市场的计价资产，精确输出的兑换则是兑换者支付的那种货币，在其指定金额之上另外收取。请从事件中读取货币，而不要根据方向推断。从同一笔交易中读取 TradeFeeCharged、CreatorTaxCharged，以及开盘税期间的 SnipeTaxCharged，然后全部减去。每个事件都携带金额和货币，而不是费率，这样读取方就永远不需要重建费率表。它们都不会把代币转到任何外部地址：它们是保存在 PoolManager 内部的债权，直到被领取。

TradeFeeCharged 按每个收款方各触发一次，所以当发行既向创作者付款也向国库付款时，一笔交易会产生两个这样的事件，手续费是两者之和。CreatorTaxCharged 是按另一个费率收取的另一项费用：交易手续费与国库分配，创作者税则不分配；在设置了创作者税的发行上交易，两者都要支付。

发行 Hook 合约上的事件

工厂合约上的事件

除了主题，还要按发出事件的地址筛选。两个工厂合约并列部署、分别轮换，它们有 10 个管理事件的签名逐字节相同。只按主题读取的程序，会把其中一个工厂合约的管理操作算到另一个头上。

代币发行工厂合约上的读取

合集工厂合约上的读取

发行 Hook 合约上的读取

LaunchLens 合约上的读取

launchesOf 由一个单独的合约应答，已部署的链在上面按链列出了它的地址。它不持有任何状态、资金或权限：它返回的每个字段都读取自上面五个 Hook 只读函数和 PoolManager，所以不想信任它的读取方，可以从这两个地址自行得出相同的结果。部署记录公布的每条链都有一个这样的合约。列表中没有 LaunchLens 合约的链不支持批量读取：请通过上面的工厂合约调用枚举它的发行，并通过 Hook 只读函数读取每个市场。

下单交易

Ripples 市场就是普通的 Uniswap v4 池，所以任何支持 v4 的路由合约都能交易它。只有一种规模的订单需要用我们的路由合约。发行的流动性是单一有界价格区间上的单一头寸，Hook 合约会拒绝任何结束价格落在该区间之外的兑换，所以如果路由合约以宽松的价格限制下单，一笔超过市场剩余量的买入会直接被拒绝。整笔订单会回滚，而不是成交现有的部分。

地址为 0x22DB9B2c6C6DB56ABC3fc196E4bC1FBb9c4338a6 的 LaunchRouter 可以承接这类订单。swapExactIn(key, zeroForOne, amountIn, minAmountOut, recipient, deadline) 以区间端点作为价格限制下单，所以池会成交到曲线末端后停止，并返回 (spent, amountOut)。它只通过 Permit2 从调用方转出 spent，市场无法承接的那部分订单资金不会移动。minAmountOut 是一个价格，而不是数量：路由合约保证 spent * minAmountOut <= amountIn * amountOut，对于全额成交的订单，这等同于 amountOut >= minAmountOut；对于部分成交的订单，成交部分也按同样的比率计算。

从 Filled(poolId, sender, recipient, zeroForOne, amountIn, spent, amountOut) 读取成交结果。spent 小于 amountIn 表示部分成交，且市场已到达曲线末端。PoolManager 的 Swap 只报告成交的部分，不涉及未成交的部分，所以想知道差额的读取方必须从这里获取。CurveEndReached 是市场已无可售代币时的回滚错误，它表示“这个发行可以毕业了”，而不是故障。

本页的地址都属于当前这一代合约。更早的代币发行工厂合约仍保有它创建的发行，这些市场也仍在交易，所以它仍会为这些发行响应 launchCount 和 launches。要覆盖 Robinhood 上所有 Ripples 市场的索引器，需要读取这两个工厂合约，两者都在地址列表中列出。两个工厂合约创建的所有市场都共用同一个发行 Hook 合约和同一个池键，所以按 Hook 合约筛选的读取方无需知道哪个市场由哪个工厂合约创建，就能看到全部市场。

同一份文档的 JSON 版本见 /integrate/manifest.json。如果这里的某个地址与链上不一致，以链上为准，也请告诉我们：通过支持页面可以联系到我们。