market-configurable-skills

# Configurable Crypto Price Prediction Market Skill

## 1. Protocol and contract overview

- **Market contract**: `contracts/contracts/GouGouBiMarketConfigurable.sol`
- **Factory contract**: `contracts/contracts/GouGouBiMarketConfigurableFactory.sol`
- **Model**: Polymarket-style CPMM YES/NO prediction market. Each round has its own YES/NO outcome tokens and uses a constant product market maker.
- **Key features**:
  - Uses Uniswap V3 pool prices as the oracle and computes time-windowed average prices.
  - Configurable to predict `token0/token1` or the reverse (`reverseOrder`).
  - Supports native coin or arbitrary ERC20 as the liquidity token.
  - Automatically starts a new round on schedule, and supports expiry handling and abnormal price handling (surfaced via events).

> This skill only describes the **contract APIs and calling patterns**. The actual deployment network and addresses should be provided by the product layer (for example via dApp config files or OpenClow workflow parameters).

---

## 2. Factory contract `GouGouBiMarketConfigurableFactory`

### 2.1 Core roles and state

- `owner`: factory admin, manages the creator whitelist.
- `marketImplementation`: implementation contract being cloned (`GouGouBiMarketConfigurable`).
- `isWhitelistedCreator[address]`: whether an address is allowed to call `createMarket`.
- `markets[]`: list of all created market addresses.
- `marketIndex[market]`: index of a market address (starting from 1, 0 means not created by this factory).
- `marketRecords[index]`: creation records (see below).

### 2.2 `MarketRecord` structure (read-only)

For each market created by the factory:

- `market`: market contract address
- `creator`: creator address
- `marketName`: market name
- `uniswapV3Pool`: Uniswap V3 pool address
- `liquidityToken`: liquidity token address, `address(0)` means native coin
- `feeRecipient`: fee recipient address
- `feeRate`: fee rate (denominator 10000)
- `createdAt`: creation timestamp
- The following fields...