> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geode.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# 什么是 Geode？

> Uniswap v4 Hook 代币的交易场所和发射台——由意图驱动执行、MEV 保护和无许可结算提供支持。

<Frame>
  <img src="https://mintcdn.com/geode/Ha7eagrqfiVWWVHI/geodeguy.png?fit=max&auto=format&n=Ha7eagrqfiVWWVHI&q=85&s=fd240b16e01eafc2abccf2fb48931714" alt="Geodeguy" className="w-48 mx-auto" title="" width="1000" height="1000" data-path="geodeguy.png" />
</Frame>

## 理念

Uniswap v4 引入了 Hook——可编程的智能合约，能在池级别拦截和修改交换行为。这解锁了全新的 **Hook 代币**类别：具有自定义链上机制的代币，如联合曲线、动态费率、重基准等。

Geode 是这些资产的**交易场所**。它提供发行 Hook 代币、以一流的执行方式交易它们以及在一个地方发现它们的基础设施。

<Info>
  **核心理念**：Hook 代币因其链上机制本身就新奇有趣。Geode 使它们可发行、可交易、可发现、可路由，并且执行体验更好。
</Info>

## 执行优势

Geode 的执行层是使交易场所运作的关键。与其逐笔对 AMM 执行每个交换（MEV 机器人在其中提取价值），Geode 收集签名的交易意图，并以单一**统一出清价格**进行批量结算。

### 实际效果

| 属性       | 传统 AMM       | Geode              |
| -------- | ------------ | ------------------ |
| **执行方式** | 顺序执行，逐笔交易    | 批量执行，一次性结算         |
| **价格**   | 取决于区块中的位置    | 整个批次统一价格           |
| **MEV**  | 三明治攻击有利可图    | 批量处理使三明治攻击不可能      |
| **撮合**   | 每笔交易都经过 AMM  | 反向流量在内部交叉，无 AMM 价差 |
| **结算**   | 每笔交换支付全部 Gas | 一笔交易结算整个批次         |

这个执行层不是 Geode 上每个代币的身份——它是交易场所的优势。每个 Hook 代币都受益于意图驱动执行、内部撮合和 MEV 保护，无论其具体机制如何。

## 架构

Geode 作为 **Uniswap v4 Hook** 构建——一个智能合约，拦截 Uniswap v4 池上的交换调用，同时驱动执行层和资产机制。

### 关键组件

<AccordionGroup>
  <Accordion title="GeodeHook.sol — 核心协议">
    主合约（约 1,190 行）实现了 Uniswap v4 `IHooks` 接口。它通过 `beforeSwap` 拦截交换，通过 `BEFORE_SWAP_RETURNS_DELTA` 处理曲线池的直接联合曲线交换，为标准池收取费用，并通过 `geodeSettleBatch()` 提供批量结算。

    **不可变量**：PoolManager、Permit2、协议金库、工厂地址。

    **状态**：每池配置、批次追踪、永久曲线状态、盈余余额。
  </Accordion>

  <Accordion title="ClearingPriceLib.sol — 标准模式结算">
    用于**标准模式**池（具有 AMM 流动性）的纯函数库。使用 AMM 的现货价格作为统一出清价格，确定哪些意图被成交，并计算内部匹配量和剩余路由。

    对于**曲线池**，`ConstantProductCurveLib` 代替处理结算——出清价格来自联合曲线，剩余流量通过 Hook 的储备路由。
  </Accordion>

  <Accordion title="Permit2 — 无 Gas 代币授权">
    意图被签名为 Permit2 `permitWitnessTransferFrom` 消息。用户只需签名一次；结算者在结算期间代表用户提取代币。无需单独的授权交易。
  </Accordion>

  <Accordion title="GeodeFactory.sol — 代币发行">
    无许可的工厂合约，部署 Hook 代币 ERC20、将全部供应量铸造给 Hook、将 v4 池初始化为空壳，并配置永久联合曲线。单笔交易发行，无需预先流动性。
  </Accordion>
</AccordionGroup>

## 资产类型

### Hook 代币 (Geocurve)

Geode 的首个资产模板：**联合曲线代币**，灵感来自 SATO 等代币开创的 Hook 格式。全部供应量预铸给 Hook——买入从 Hook 储备中分发代币，卖出将其吸收回去。曲线处理一级发行，同时独立的二级池可以涌现，创造自然的**价差动态**——曲线价格与二级市场价格之间的背离就是这个游戏。

<Steps>
  <Step title="创建代币">
    部署者调用 `GeodeFactory.launch()`。部署一个新的 ERC20，全部供应量转入 Hook，v4 池作为空壳初始化，联合曲线激活。
  </Step>

  <Step title="双路径交易">
    曲线从第一天起就支持**直接交换**（通过 `beforeSwap` 即时执行）和**基于意图的批量结算**。Hook 通过 `BEFORE_SWAP_RETURNS_DELTA` 充当做市商——v4 池没有流动性；Hook 处理所有定价。
  </Step>

  <Step title="价差动态">
    曲线是永久的一级市场。随着二级池在其他场所出现，曲线价格与市场价格之间的价差成为一个新兴的交易游戏。随着每笔交换费用的一部分被添加到 ETH 储备中，地板价随时间上升。
  </Step>
</Steps>

### 标准池

适用于任何具有现有 AMM 流动性的 Uniswap v4 池。Hook 附加后在其上添加基于意图的批量结算。

## 关键属性

<CardGroup cols={2}>
  <Card title="不可变" icon="lock">
    没有管理员密钥，没有可升级性，没有特权角色。协议部署后完全不可变。
  </Card>

  <Card title="无许可" icon="door-open">
    任何人都可以结算批次。任何人都可以发行代币。没有守门人。
  </Card>

  <Card title="纯链上" icon="link-simple">
    没有链下状态依赖。每个功能都从链上状态运行。没有排序器，没有中继者，没有受信任的基础设施。
  </Card>

  <Card title="Uniswap v4 原生" icon="cubes">
    不是分叉或包装器。是一个原生的 v4 Hook，直接与 PoolManager 的闪电记账系统组合。
  </Card>
</CardGroup>

<Note>
  **深入了解**：阅读[工作原理](/cn/how-it-works)了解结算流程，[Geocurve](/cn/geocurve) 了解联合曲线机制，或[经济学](/cn/economics)了解费用模型和防刷单机制。
</Note>
