结算者机器人

什么是结算者？

结算者是一个链下服务，从用户收集签名的交易意图，按池分批，并在 GeodeHook 合约上调用 geodeSettleBatch()。作为回报，结算者从协议中赚取结算费用和 Gas 报销。

结算是无许可的 — 任何人都可以运行结算者。给定结算窗口中第一个提交的有效批次赢得费用。

架构

用户签署意图 (Permit2)          结算者机器人
        │                     ┌─────────────────────┐
        └──── POST /intents ──►  意图队列            │
                              │  (按池分组)           │
                              │       │              │
  索引器 (indexer.geode.ag)   │  每 2 秒             │
        │                     │       │              │
        └──── GET /tokens ───►│  自动发现池           │
              (每 30 秒)      │       ▼              │
                              │  geodeSettleBatch()  │
                              │       │              │
                              │  ┌────┴────┐         │
                              │  ▼         ▼         │
                              │ 费用    Gas 报销      │
                              │ (0.1%)  (来自盈余)    │
                              └─────────────────────┘

快速开始

克隆仓库

git clone https://github.com/Geode-vAMM/geode-settler.git
cd geode-settler

安装依赖

npm install

结算者只有三个依赖：express、ethers 和 cors。

配置环境

cp .env.example .env

编辑 .env 并设置：

SETTLER_PRIVATE_KEY — 您的结算者钱包私钥
HOOK_ADDRESS — 已部署的 GeodeHook 合约地址
RPC_URL — 您的以太坊 JSON-RPC 端点

启动结算者

npm start

结算者将打印配置，启动结算循环，并在端口 3003 上监听意图。

配置

变量	必需	默认值	描述
`SETTLER_PRIVATE_KEY`	✅	—	结算者钱包的私钥。必须有 ETH 用于 Gas。
`HOOK_ADDRESS`	⚠️	—	已部署的 GeodeHook 地址。没有则禁用自动结算。
`RPC_URL`	否	`http://localhost:8545`	JSON-RPC 端点
`SETTLE_INTERVAL_MS`	否	`2000`	检查待处理意图的频率（毫秒）
`PORT`	否	`3003`	HTTP API 端口

永远不要提交您的 .env 文件。 结算者的私钥控制着持有 ETH 的钱包。在生产环境中使用环境变量或密钥管理器。

API 参考

提交意图

POST /intents
Content-Type: application/json

查看待处理意图

GET /intents/:poolId

强制结算

POST /settle/:poolId

列出池

GET /pools

健康检查

GET /health

经济学

结算费用

每个已成交意图输入金额的 0.1%。 在路由前扣除——结算者直接从 PoolManager 取得未路由的费用存款。

Gas 报销

Gas 成本 × 1.5，每批次上限 0.01 ETH。 从池的累积直接交换费用盈余中提取。

源代码

GitHub: Geode-vAMM/geode-settler
依赖: express, ethers v6, cors
运行时: Node.js ≥ 18

入门指南

协议

资源

结算者机器人

什么是结算者？

架构

快速开始

配置

API 参考

提交意图

查看待处理意图

强制结算

列出池

健康检查

经济学

结算费用

Gas 报销

源代码

​什么是结算者？

​架构

​快速开始

​配置

​API 参考

​提交意图

​查看待处理意图

​强制结算

​列出池

​健康检查

​经济学

结算费用

Gas 报销

​源代码

什么是结算者？

架构

快速开始

配置

API 参考

提交意图

查看待处理意图

强制结算

列出池

健康检查

经济学

源代码