# AIResolver.sol

`AIResolver` 合约管理由 AI 结算的市场。它继承 `FlapAIConsumerBase`，与 FLAP AI 预言机交互，并通过 liveness window 与挑战机制实现乐观结算模式。

## 概览

* 持有在市场创建时存入的 BNB 预言机费用。
* 在市场到期时向 FLAP AI 预言机发送 prompts。
* 接收预言机回调，其中包含 LLM 的二元选择。
* 在最终确认前强制执行 30 分钟 liveness window。
* 支持使用 0.1 BNB bond 发起挑战，并进入 24-hour 管理员 review。

## State

```solidity
mapping(uint256 => uint256) 公开requestToMarket;      // requestId => factoryMarketId
mapping(uint256 => AIMarketConfig) 公开aiMarkets;     // factoryMarketId => config
mapping(uint256 => ProposedResolution) 公开proposals; // factoryMarketId => proposal

uint256 公开constant LIVENESS_PERIOD = 30 minutes;
uint256 公开constant CHALLENGE_PERIOD = 24 hours;
uint256 公开constant CHALLENGE_BOND = 0.1 ether;
uint256 公开constant CHALLENGER_REWARD = 0.01 ether;
```

### AI 市场 Config

```solidity
struct AIMarketConfig {
    string prompt;
    uint8 modelId;
    uint256 oracleFee;  // BNB amount locked at creation
    bool pending;       // true while awaiting oracle callback
}
```

### ProposedResolution

```solidity
struct ProposedResolution {
    uint8 choice;          // 0 = YES, 1 = NO
    uint256 livenessEnd;   // timestamp when liveness expires
    address challenger;    // non-zero if challenged
    uint256 challengeEnd;  // 0 unless challenged
    bool finalized;
}
```

## 函数

| Function                                                | Access              | Description                                                  |
| ------------------------------------------------------- | ------------------- | ------------------------------------------------------------ |
| `depositFee(uint256 marketId)`                          | `payable`           | MarketFactory 在创建 AI 市场时调用。存储 BNB 预言机费用。                     |
| `resolveMarket(uint256 marketId)`                       | `KEEPER_ROLE`       | 使用已存入费用向 FLAP AI 预言机发送 prompt。                               |
| `challenge(uint256 marketId)`                           | `payable` (0.1 BNB) | 在存活窗口内提交 challenge bond，并延长到 24h review。                     |
| `finalise(uint256 marketId)`                            | Anyone              | 在无挑战且 liveness window 结束后最终确认结算，并调用 `factory.setResolved()`。 |
| `confirmResolution(uint256 marketId)`                   | `admin`             | 在挑战后确认原始 AI 结果。Bond 进入 treasury。                             |
| `overrideResolution(uint256 marketId, bool newOutcome)` | `admin`             | 覆盖 AI 结果。挑战者获得 bond 与 0.01 BNB reward。                       |
| `withdraw()`                                            | `admin`             | 紧急提取 BNB。                                                    |

### Internal（预言机 Callbacks）

| Function                                             | Description                               |
| ---------------------------------------------------- | ----------------------------------------- |
| `_fulfillReasoning(uint256 requestId, uint8 choice)` | 预言机回调。记录 proposed 结算，并启动 liveness window。 |
| `_onFlapAIRequestRefunded(uint256 requestId)`        | 预言机退款回调。重置 pending 标志，使 keeper 可以重试。      |

## 事件

```solidity
event AIResolutionRequested(uint256 indexed marketId, uint256 requestId);
event AIResolutionProposed(uint256 indexed marketId, uint256 requestId, uint8 choice, uint256 livenessEnd);
event AIResolutionChallenged(uint256 indexed marketId, address challenger, uint256 challengeEnd);
event AIResolutionConfirmed(uint256 indexed marketId, uint8 choice);
event AIResolutionOverridden(uint256 indexed marketId, uint8 oldChoice, bool newOutcome);
event AIResolutionRefunded(uint256 indexed marketId, uint256 requestId);
```

## 访问控制

| Role                          | 授予对象           | 目的                                               |
| ----------------------------- | -------------- | ------------------------------------------------ |
| `KEEPER_ROLE`                 | Keeper 钱包      | 在市场到期时调用 `resolveMarket()`                       |
| MarketFactory 中的 `ADMIN_ROLE` | AIResolver     | 通过 factory 调用 `setResolved()` 和 `setResolving()` |
| `admin` (AIResolver)          | 部署者 / multisig | 确认或覆盖被挑战的结算                                      |

## FlapAIConsumerBase Pattern

`AIResolver` 继承自 `FlapAIConsumerBase`，该基类提供：

* `_getFlapAIProvider()` — 返回预言机 provider 地址。
* `reason{value}(modelId, prompt, numChoices)` — 使用 BNB payment 发送 reasoning request。
* `_fulfillReasoning(requestId, choice)` — virtual 回调，由 AIResolver override。
* `_onFlapAIRequestRefunded(requestId)` — virtual 退款回调。

预言机通常会在约 90 seconds 后响应。`_fulfillReasoning` 回调转发约 1M Gas，因此应只执行 storage writes，不应进行 external 调用。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.strike.pm/zh/zhi-neng-he-yue/ai-resolver.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.