> ## 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.
# 意图
> GeodeIntent 结构体、Permit2 签名、重放保护和意图生命周期。
## 什么是意图？
意图是一条签名消息，表示：*"我想将 X 代币交换为至少 Y 代币，在此截止时间之前。"* 它不是链上交易——它是一个无 Gas 签名，授权结算者在批量结算期间代表您执行交易。
**与交换的关键区别**：交换会立即对 AMM 执行。意图被收集、与其他意图批量处理，并以统一出清价格结算。您是与批次交易，而不是与池交易。
## GeodeIntent 结构体
每个意图包含以下字段：
```solidity theme={null}
struct GeodeIntent {
PoolId poolId; // 针对哪个池（跨池重放保护）
address owner; // 签名者地址（代币所有者）
address tokenIn; // 卖出的代币
address tokenOut; // 接收的代币
uint256 amountIn; // 卖出数量
uint256 minAmountOut; // 最低可接受输出（滑点保护）
uint256 deadline; // 过期时间戳
uint256 nonce; // Permit2 重放保护
}
```
### 隐含限价
意图没有明确的价格字段。限价从 `amountIn` 和 `minAmountOut` 推导：
* **买入限价** = `amountIn × Q128 / minAmountOut`（愿意支付的最高价格）
* **卖出限价** = `minAmountOut × Q128 / amountIn`（愿意接受的最低价格）
买入意图在限价 ≥ 出清价格时成交。卖出意图在限价 ≤ 出清价格时成交。不满足出清价格的意图被跳过——用户代币不会被移动。
## Permit2 集成
Geode 使用 [Permit2](https://github.com/Uniswap/permit2) 进行无 Gas 代币授权和转账。
### 工作方式
用户授权 Permit2 合约花费其代币（标准 ERC20 `approve`）。每个代币只需一次——Permit2 在所有协议间共享。
用户签署 Permit2 `PermitWitnessTransferFrom` 消息，包含：
* **Permitted**：代币地址、金额、nonce、截止时间（标准 Permit2 字段）
* **Witness**：poolId、tokenOut、minAmountOut（Geode 特定字段）
单个签名同时授权代币转账和交易参数。
在 `geodeSettleBatch()` 期间，Hook 为每个已成交意图调用 `permit2.permitWitnessTransferFrom()`。Permit2 验证签名、检查 nonce，并将代币从用户转到 PoolManager。
### Witness 类型
Geode 特定的 witness 仅包含不在 Permit2 `PermitTransferFrom` 中的字段：
```solidity theme={null}
bytes32 constant GEODE_WITNESS_TYPEHASH = keccak256(
"GeodeWitness(bytes32 poolId,address tokenOut,uint256 minAmountOut)"
);
```
## 重放保护
每个意图使用唯一的 Permit2 nonce。一旦使用，nonce 被消耗，签名变为无效。同一意图永远不能被执行两次。
`poolId` 是签名 witness 的一部分。为池 A 签署的意图不能在池 B 上重放。
每个意图都有过期时间戳。截止时间后，签名无效，代币无法被移动。
Permit2 的 EIP-712 域分隔符包含链 ID。以太坊主网签名不能在其他链上重放。
## 意图生命周期
用户在 UI 中配置交易并在钱包中签署 Permit2 消息。签名在本地产生——没有链上交易。
签名的意图被发送给结算者。结算者为当前批次窗口收集意图。
出清价格算法评估每个意图——限价兼容则**成交**，不满足则被**跳过**。
对于已成交的意图，Permit2 提取用户代币，结算通过内部撮合和/或 AMM 路由，输出代币分配到用户钱包。
## 如果我的意图没有成交怎么办？
如果出清价格不满足您的 `minAmountOut`，意图被跳过。代币不会被移动，Permit2 nonce 不会被消耗——可在未来批次中重用。
## 安全模型
Geode 使用 Permit2 的 **`SignatureTransfer`**（非 `AllowanceTransfer`）。每个意图签名都是一次性授权——nonce 消耗后签名永久失效。
### 有限的风险敞口
| 约束 | 字段 | 效果 |
| ------- | ------------------ | ------------------- |
| **金额** | `amountIn` | 可移动的最大代币数量 |
| **时间** | `deadline` | 签名到期后不可用 |
| **目标** | `spender`（Hook 地址） | 只有 Geode Hook 合约可使用 |
| **池** | `poolId`（witness） | 不能在不同池上重放 |
| **一次性** | `nonce` | 首次使用后永久失效 |
### 结算者不能做什么
* **不能更改金额** — Permit2 验证 `amountIn` 与签名匹配
* **不能更改接收者** — 输出代币发送到 `intent.owner`，硬编码在结算逻辑中
* **不能少付** — 出清价格不满足 `minAmountOut` 时意图被跳过
* **不能重放签名** — Permit2 nonce 被原子性消耗
* **不能抢跑** — 批次中所有意图获得相同的统一出清价格
**面向集成者**：意图可以使用任何 EIP-712 兼容库构建和签名。witness 类型字符串和 typehash 定义在 `GeodeTypes.sol` 中。