[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6GRCFHFXVVPRG0C2E30DF3N":3,"skill-same:01M6GRCFHFXVVPRG0C2E30DF3N":86},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":55,"ownerDescription":56,"updatedAt":57,"install":58,"resources":71},"01M6GRCFHFXVVPRG0C2E30DF3N","configurator",null,"Configure CCA (Continuous Clearing Auction) smart contract parameters through an interactive bulk form flow. Use when user says \"configure auction\", \"cca auction\", \"setup token auction\", \"auction configuration\", \"continuous auction\", or mentions CCA contracts.","jiayaoqijia\u002Fcryptoskill","jiayaoqijia","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1453879?v=4","01M6GMYTX7Q7S504VC6E756ENR","YQ","01M6GMYV1QKJ1CC75MTTGT9PR0",81,"MIT","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Funiswap-official-cca-configurator\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Funiswap-official-cca-configurator\u002FSKILL.md",[],[5,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"auction","when","smart contract","opus","supply","bulk","form","uniswap","contract","token","generate","contracts","use","interactive","edit","write","read","schedule","configure","Bash","flow","2026-11-10 10:12:30",false,"---\nname: configurator\ndescription: Configure CCA (Continuous Clearing Auction) smart contract parameters through an interactive bulk form flow. Use when user says \"configure auction\", \"cca auction\", \"setup token auction\", \"auction configuration\", \"continuous auction\", or mentions CCA contracts.\nallowed-tools: Read, Write, Edit, Glob, Grep, Bash(curl:*), WebFetch, AskUserQuestion, cca-supply-schedule__generate_supply_schedule, cca-supply-schedule__encode_supply_schedule\nmodel: opus\nlicense: MIT\nmetadata:\n  author: uniswap\n  version: '1.0.0'\n---\n\n# CCA Configuration\n\nConfigure Continuous Clearing Auction (CCA) smart contract parameters for fair and transparent token distribution.\n\n> **Runtime Compatibility:** This skill uses `AskUserQuestion` for interactive prompts. If `AskUserQuestion` is not available in your runtime, collect the same parameters through natural language conversation instead.\n\n## Instructions for Claude Code\n\nWhen the user invokes this skill, guide them through a **bulk interactive form configuration flow** using AskUserQuestion. Collect parameters in batches to minimize user interaction rounds.\n\n### Bulk Interactive Form Rules\n\n1. **Batch questions** - Ask up to 4 questions at once using a single AskUserQuestion call\n2. **Allow direct input** - For fields requiring custom values (addresses, numbers):\n   - Provide a \"Not available yet\" or \"Skip for now\" option\n   - The \"Other\" option (automatically provided) allows direct custom input\n   - **NEVER** ask \"Do you have X?\" as a separate question\n3. **Store answers** - Keep track of all collected values in a configuration object\n4. **Validate after collection** - After each batch, validate all inputs before proceeding\n5. **Show progress** - After each batch, show which parameters are collected and which remain\n\n### Input Validation Rules\n\nRule 4 above says validate after each batch. This is what validating means. Most values below arrive by selecting one of the preset options, but any of them can instead arrive as free text: through the \"Other\" option, which `AskUserQuestion` provides on every question, and through plain conversation whenever `AskUserQuestion` is unavailable and the runtime-compatibility fallback above applies. A custom RPC endpoint is the clearest case, because the Network question lists named networks and no endpoint field, yet a user who rejects the public endpoints still supplies one through \"Other\" or in conversation. Validate every value against the checks below before writing it into the configuration file or interpolating it into a `curl` command. Do not look for an exemption: a value that really is one of the presets this skill offered passes every check trivially, and under the conversational fallback there is no way to establish where a value came from in the first place.\n\n- **Ethereum addresses** (`token`, `currency`, `tokensRecipient`, `fundsRecipient`, `validationHook`): MUST match `^0x[a-fA-F0-9]{40}$` — reject otherwise\n- **Chain IDs**: MUST be from the supported chains list (1, 130, 1301, 8453, 42161, 11155111)\n- **Numeric values** (supply, prices, blocks, MPS, block deltas): MUST be non-negative and match `^[0-9]+\\.?[0-9]*$`\n- **RPC endpoint URL**: prefer a public endpoint from the [Available Public RPCs](#available-public-rpcs) table. A custom endpoint, however it arrives, MUST be `https:\u002F\u002F`-scheme and MUST NOT contain any metacharacter or whitespace from the rule below before it reaches the `curl` command in [Fetch Block Number](#fetch-block-number). \"It came from the user, not the table\" is not an exemption.\n- **REJECT** any input containing shell metacharacters or whitespace: `;`, `|`, `&`, `$`, `` ` ``, `(`, `)`, `>`, `\u003C`, `\\`, `'`, `\"`, spaces, tabs, newlines. `$(...)` and backticks execute even inside double quotes, and a space splits one value into extra `curl` flags, so neither is ever safe to interpolate. Abort and report which value and which character failed rather than stripping the offending characters and continuing.\n- **Never** pass raw user input directly to a shell command without validation, and always double-quote the interpolation in any command shown to the user.\n\nA value that fails any check is never written to the configuration file either. The `deployer` skill reads that file and interpolates its fields into `forge` and `cast` commands, so an unvalidated value stored here becomes an injected command there.\n\n### Configuration Flow\n\nCollect parameters in these batches:\n\n#### Batch 1: Task Selection (1 question)\n\n**Question 1: Task Type**\n\n- Prompt: \"What would you like to do with CCA?\"\n- Options: \"Configure auction parameters\", \"Generate supply schedule only\", \"Review existing config\", \"Deploy existing config\"\n\n**After collection:** If not \"Configure auction parameters\", skip to appropriate section.\n\n---\n\n#### Batch 2: Basic Configuration (4 questions)\n\n**Question 1: Network**\n\n- Prompt: \"Which network to deploy on?\"\n- Options: \"Ethereum Mainnet\", \"Unichain (Mainnet)\", \"Unichain Sepolia (Testnet)\", \"Base\", \"Arbitrum\", \"Sepolia\"\n- Store: `chainId`, `blockTime`, `rpcUrl`, `currencyDecimals` (for selected currency)\n\n**Question 2: Token Address**\n\n- Prompt: \"Token to be auctioned?\"\n- Options: \"Token not deployed yet\" (placeholder), Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `token`\n\n**Question 3: Total Supply**\n\n- Prompt: \"How many tokens to auction?\"\n- Options: \"100 million tokens (18 decimals)\", \"1 billion tokens (18 decimals)\", \"10 billion tokens (18 decimals)\", Custom (via \"Other\")\n- Validation: Must be \u003C= 1e30 wei\n- Store: `totalSupply`\n\n**Question 4: Currency**\n\n- Prompt: \"What currency should bidders use?\"\n- Options: \"ETH (Native)\", \"USDC on [network]\", \"USDT on [network]\", Custom ERC20 (via \"Other\")\n- Validation: Must be 42 chars starting with 0x or address(0)\n- Store: `currency`\n\n**After collection:** Validate all inputs, show summary of basic configuration.\n\n---\n\n#### Batch 3: Timing & Pricing (4 questions)\n\n**Question 1: Auction Duration**\n\n- Prompt: \"How long should the auction run?\"\n- Options: \"1 day\", \"2 days\", \"3 days\", \"7 days\", Custom blocks (via \"Other\")\n- Calculate blocks based on network block time\n- Store: `auctionBlocks`\n\n**Question 2: Prebid Period**\n\n- Prompt: \"Include a prebid period? (time when no tokens are sold)\"\n- Options: \"No prebid period (0 blocks)\", \"12 hours\", \"1 day\", Custom blocks (via \"Other\")\n- Calculate blocks based on network block time\n- Store: `prebidBlocks`\n\n**Question 3: Floor Price**\n\n- Prompt: \"Starting floor price? (ratio of currency per token)\"\n- Options: \"0.10x (10% of 1:1 ratio)\", \"0.01x (1% of 1:1 ratio)\", \"0.001x (0.1% of 1:1 ratio)\", Custom ratio (via \"Other\")\n- Calculate Q96 value accounting for decimal differences: `Q96 * ratio \u002F 10^(tokenDecimals - currencyDecimals)`\n- For USDC (6 decimals) and 18-decimal token: `Q96 * ratio \u002F 10^12`\n- For native ETH (18 decimals) and 18-decimal token: `Q96 * ratio \u002F 10^0 = Q96 * ratio`\n- Store: `floorPriceRatio`, `floorPrice` (Q96), `tokenDecimals`, `currencyDecimals`\n\n**Question 4: Tick Spacing**\n\n- Prompt: \"Tick spacing as percentage of floor price?\"\n- Options: \"1% of floor price (Recommended)\", \"10% of floor price\", \"0.1% of floor price\", Custom percentage (via \"Other\")\n- Calculate: `tickSpacing = int(floorPrice * percentage)`\n- **CRITICAL**: Round floor price DOWN to be evenly divisible by tick spacing:\n  - `roundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing`\n  - Verify: `roundedFloorPrice % tickSpacing == 0` must be true\n- Validate: Tick spacing must be >= 1 basis point of floor price\n- Store: `tickSpacingPercentage`, `tickSpacing` (Q96), `roundedFloorPrice`\n\n**After collection:** Validate inputs, verify floor price divisibility, calculate and display Q96 values, show timing summary.\n\n---\n\n#### Batch 4: Recipients & Launch (4 questions)\n\n**Question 1: Tokens Recipient**\n\n- Prompt: \"Where should unsold tokens be sent?\"\n- Options: \"Same as funds recipient\", Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `tokensRecipient`\n\n**Question 2: Funds Recipient**\n\n- Prompt: \"Where should raised funds be sent?\"\n- Options: \"Same as tokens recipient\", Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `fundsRecipient`\n\n**Question 3: Start Time**\n\n- Prompt: \"When should the auction start?\"\n- Options: \"In 1 hour\", \"In 6 hours\", \"In 24 hours\", Custom block number (via \"Other\")\n- Fetch current block number from RPC and calculate\n- Store: `startBlock`\n- Calculate: `endBlock = startBlock + prebidBlocks + auctionBlocks`, `claimBlock = endBlock`\n\n**Question 4: Minimum Funds Required**\n\n- Prompt: \"Require minimum currency raised for graduation?\"\n- Options: \"No minimum (0)\", \"100 ETH\", \"1000 ETH\", Custom amount in wei (via \"Other\")\n- Store: `requiredCurrencyRaised`\n\n**After collection:** Validate addresses, fetch current block from RPC, calculate full block timeline.\n\n---\n\n#### Batch 5: Optional Hook (1 question)\n\n**Question 1: Validation Hook**\n\n- Prompt: \"Use a validation hook contract?\"\n- Options: \"No validation hook\", Custom hook address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x (if provided)\n- Store: `validationHook`\n\n**After collection:** Validate hook address if provided.\n\n---\n\n#### Step 6: Generate Supply Schedule\n\n**If MCP server is not running**, provide instructions to start it:\n\n```bash\n# Navigate to MCP server directory\ncd packages\u002Fplugins\u002Funiswap-cca\u002Fmcp-server\u002Fsupply-schedule\n\n# Run setup script (first time only)\nchmod +x setup.sh\n.\u002Fsetup.sh\n\n# Start the MCP server\npython3 server.py\n```\n\nOnce the MCP server is running, call the `cca-supply-schedule__generate_supply_schedule` MCP tool with the collected parameters. The tool expects a JSON object:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\nReplace the values with the actual `auctionBlocks` and `prebidBlocks` collected from the user.\n\nIf the MCP tool is unavailable, use the fallback Python algorithm directly (see Supply Schedule Configuration section).\n\nStore: `supplySchedule`\n\n#### Step 7: Generate and Display Configuration\n\nAfter collecting all parameters and generating the supply schedule, display the complete JSON configuration in the CLI output:\n\n```json\n{\n  \"[chainId]\": {\n    \"token\": \"...\",\n    \"totalSupply\": ...,\n    \"currency\": \"...\",\n    \"tokensRecipient\": \"...\",\n    \"fundsRecipient\": \"...\",\n    \"startBlock\": ...,\n    \"endBlock\": ...,\n    \"claimBlock\": ...,\n    \"tickSpacing\": ...,\n    \"validationHook\": \"...\",\n    \"floorPrice\": ...,\n    \"requiredCurrencyRaised\": ...,\n    \"supplySchedule\": [...]\n  }\n}\n```\n\n**Do NOT automatically create a file.** Let the user copy the JSON or specify a filepath to save it.\n\n#### Step 8: Display Summary\n\nShow the user a comprehensive formatted summary including:\n\n- Network and chain ID\n- Token and currency details\n- Block timeline (start, end, claim) with human-readable times\n- Pricing (floor price, tick spacing) in both Q96 and ratio formats\n- Recipients (tokens, funds)\n- Supply schedule summary (total phases, final block percentage)\n- Validation checklist (all validation rules passed\u002Ffailed)\n\n#### Step 9: Next Steps\n\nAsk the user what they want to do:\n\n- \"Save to file\" (ask for filepath, default: `script\u002Fauction-config.json`)\n- \"View deployment instructions\" (suggest using the deployer skill)\n- \"Modify configuration\"\n- \"Exit\" (just end, they can copy the JSON from CLI output)\n\n### Important Notes\n\n- **Validate in batches** - Validate all inputs after each batch collection\n- **Fetch current block number** from RPC when calculating start\u002Fend blocks\n- **Calculate Q96 values** correctly for floor price and tick spacing:\n  - **CRITICAL**: Account for decimal differences: `Q96 * ratio \u002F 10^(tokenDecimals - currencyDecimals)`\n  - USDC is 6 decimals on all networks - divide by 10^12 for 18-decimal tokens\n  - Native ETH is 18 decimals - no adjustment needed for 18-decimal tokens\n- **Round floor price** to be evenly divisible by tick spacing:\n  - `roundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing`\n  - **MUST verify**: `roundedFloorPrice % tickSpacing == 0`\n- **Use the MCP tool** for supply schedule generation (provide setup instructions if not running)\n- **Minimize interaction rounds** - Collect as many params as reasonable per batch\n\n### Network-Specific Constants\n\nStore these for quick reference:\n\n```typescript\nconst NETWORKS = {\n  1: {\n    name: 'Mainnet',\n    blockTime: 12,\n    rpc: 'https:\u002F\u002Fethereum-rpc.publicnode.com',\n    usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n  },\n  130: {\n    name: 'Unichain',\n    blockTime: 1,\n    rpc: 'https:\u002F\u002Fmainnet.unichain.org',\n    usdc: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',\n  },\n  1301: {\n    name: 'Unichain Sepolia (Testnet)',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Fsepolia.unichain.org',\n    usdc: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',\n  },\n  8453: {\n    name: 'Base',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Fmainnet.base.org',\n    usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n  },\n  42161: {\n    name: 'Arbitrum',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Farb1.arbitrum.io\u002Frpc',\n    usdc: '0xaf88d065e77c8cc2239327c5edb3a432268e5831',\n  },\n  11155111: {\n    name: 'Sepolia',\n    blockTime: 12,\n    rpc: 'https:\u002F\u002Fethereum-sepolia-rpc.publicnode.com',\n    usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',\n  },\n};\n\n\u002F\u002F Q96 = 2^96 (JavaScript BigInt notation)\nconst Q96 = 79228162514264337593543950336n;\n```\n\nPython equivalent:\n\n```python\n# Q96 = 2**96\nQ96 = 79228162514264337593543950336\n```\n\n## Overview\n\nCCA (Continuous Clearing Auction) is a novel auction mechanism that generalizes the uniform-price auction into continuous time. It provides fair price discovery for bootstrapping initial liquidity while eliminating timing games and encouraging early participation.\n\nKey features:\n\n- **Fair price discovery**: Continuous clearing with no timing games\n- **Transparent distribution**: Supply released on a predetermined schedule\n- **Flexible configuration**: Customizable auction parameters and schedules\n- **Multi-chain support**: Canonical deployment across EVM chains\n- **Factory deployment**: Consistent addresses via CREATE2\n\n## Quick Decision Guide\n\n| Task...                      | Use This Section              |\n| ---------------------------- | ----------------------------- |\n| Configure auction parameters | Configuration Guide           |\n| Generate supply schedule     | Supply Schedule Configuration |\n| Understand auction mechanics | Technical Overview            |\n\n---\n\n## Configuration Guide\n\n### Auction Parameters\n\nCCA auctions are configured through the `AuctionParameters` struct:\n\n```solidity\nstruct AuctionParameters {\n    address currency;              \u002F\u002F Token to raise funds in (address(0) for ETH)\n    address tokensRecipient;       \u002F\u002F Address to receive leftover tokens\n    address fundsRecipient;        \u002F\u002F Address to receive all raised funds\n    uint64 startBlock;             \u002F\u002F Block when auction starts\n    uint64 endBlock;               \u002F\u002F Block when auction ends\n    uint64 claimBlock;             \u002F\u002F Block when tokens can be claimed\n    uint256 tickSpacing;           \u002F\u002F Fixed granularity for prices (Q96)\n    address validationHook;        \u002F\u002F Optional hook (use 0x0 if none)\n    uint256 floorPrice;            \u002F\u002F Starting floor price (Q96)\n    uint128 requiredCurrencyRaised; \u002F\u002F Minimum funds to graduate\n    bytes auctionStepsData;        \u002F\u002F Packed supply issuance schedule\n}\n```\n\n### Configuration File Format\n\nCreate a JSON configuration file (e.g., `script\u002Fauction-config.json`):\n\n```json\n{\n  \"1\": {\n    \"token\": \"0x...\",\n    \"totalSupply\": 1e29,\n    \"currency\": \"0x0000000000000000000000000000000000000000\",\n    \"tokensRecipient\": \"0x...\",\n    \"fundsRecipient\": \"0x...\",\n    \"startBlock\": 24321000,\n    \"endBlock\": 24327001,\n    \"claimBlock\": 24327001,\n    \"tickSpacing\": 79228162514264337593543950,\n    \"validationHook\": \"0x0000000000000000000000000000000000000000\",\n    \"floorPrice\": 7922816251426433759354395000,\n    \"requiredCurrencyRaised\": 0,\n    \"supplySchedule\": [\n      { \"mps\": 1000, \"blockDelta\": 6000 },\n      { \"mps\": 4000000, \"blockDelta\": 1 }\n    ]\n  }\n}\n```\n\n### Parameter Details\n\n#### Basic Configuration\n\n| Parameter         | Type    | Description                                       |\n| ----------------- | ------- | ------------------------------------------------- |\n| `token`           | address | Token being auctioned                             |\n| `totalSupply`     | number  | Total tokens to auction (wei\u002Fsmallest unit)       |\n| `currency`        | address | Purchase token (USDC, etc.) or address(0) for ETH |\n| `tokensRecipient` | address | Where unsold tokens go                            |\n| `fundsRecipient`  | address | Where raised funds go                             |\n\n#### Block Configuration\n\n| Parameter    | Type   | Description                | Constraint             |\n| ------------ | ------ | -------------------------- | ---------------------- |\n| `startBlock` | number | When auction starts        | startBlock \u003C endBlock  |\n| `endBlock`   | number | When auction ends          | endBlock \u003C= claimBlock |\n| `claimBlock` | number | When tokens can be claimed | claimBlock >= endBlock |\n\n**Block times by network:**\n\n- Mainnet, Sepolia: 12s per block\n- Unichain, Base, Arbitrum: 2s per block\n\n#### Pricing Parameters\n\n| Parameter                | Type    | Description                                    |\n| ------------------------ | ------- | ---------------------------------------------- |\n| `floorPrice`             | number  | Minimum price (Q96 format)                     |\n| `tickSpacing`            | number  | Price tick increment (Q96 format)              |\n| `validationHook`         | address | Optional validation contract (use 0x0 if none) |\n| `requiredCurrencyRaised` | number  | Minimum funds needed (0 if no minimum)         |\n\n#### Supply Schedule\n\n| Parameter        | Type  | Description                        |\n| ---------------- | ----- | ---------------------------------- |\n| `supplySchedule` | array | Array of {mps, blockDelta} objects |\n\n---\n\n## Price Calculations (Q96 Format)\n\nCCA uses Q96 fixed-point format for precise pricing. The base value `2^96` (79228162514264337593543950336) represents a 1:1 price ratio.\n\n### Floor Price Calculation\n\n**CRITICAL: Account for decimal differences between token and currency.**\n\n```python\n# Base value for 1:1 ratio\nQ96 = 79228162514264337593543950336\n\n# Formula: Q96 * (human price ratio) \u002F 10^(token_decimals - currency_decimals)\n\n# Example 1: USDC (6 decimals) per 18-decimal token at $0.10 ratio\ntoken_decimals = 18\ncurrency_decimals = 6  # USDC has 6 decimals\ndecimal_adjustment = 10 ** (token_decimals - currency_decimals)  # 10^12\n\nfloorPrice = Q96 * 0.1 \u002F decimal_adjustment\n# Result: 7922816251426433759354395 (approximately)\n\n# Example 2: Native ETH (18 decimals) per 18-decimal token at 0.1 ratio\ntoken_decimals = 18\ncurrency_decimals = 18  # Native ETH has 18 decimals\ndecimal_adjustment = 10 ** (18 - 18)  # 10^0 = 1\n\nfloorPrice = Q96 * 0.1 \u002F 1\n# Result: 7922816251426433759354395034\n```\n\n**Key Point:** USDC has 6 decimals on all networks, so you must divide by 10^12 when using USDC with 18-decimal tokens.\n\n### Tick Spacing Calculation\n\nTick spacing governs where bids can be placed. Choose **AT LEAST 1 basis point of the floor price**. 1% or 10% is also reasonable.\n\n```python\n# Example: 1% of floor price\ntickSpacing = int(floorPrice * 0.01)\n\n# For floorPrice = 7922816251426433759354395000\n# Result: 79228162514264337593543950\n```\n\n### Rounding Floor Price (CRITICAL)\n\n**Floor price MUST be evenly divisible by tick spacing.** Round DOWN to ensure exact divisibility:\n\n```python\n# Calculate tick spacing first\ntickSpacing = int(floorPrice * 0.01)  # 1% of floor price\n\n# Round floor price DOWN to be evenly divisible\nroundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing\n\n# VERIFY divisibility (must be True)\nassert roundedFloorPrice % tickSpacing == 0, \"Floor price must be divisible by tick spacing!\"\n```\n\n**Example:**\n\n```python\nQ96 = 79228162514264337593543950336\nraw_floor_price = int(Q96 * 0.0001)  # 0.0001 ETH per token\n# Result: 7922816251426434139029504\n\ntick_spacing = int(raw_floor_price * 0.01)  # 1%\n# Result: 79228162514264350785536\n\nrounded_floor_price = (raw_floor_price \u002F\u002F tick_spacing) * tick_spacing\n# Result: 7843588088912170727768064\n\n# Verify: 7843588088912170727768064 \u002F 79228162514264350785536 = 99 (exact)\n# Remainder: 0 ✓\n```\n\n**Warning**: Setting too small of a tick spacing will make the auction extremely gas inefficient and can result in DoS attacks.\n\n---\n\n## Supply Schedule Configuration\n\n### Understanding MPS (Milli-Basis Points)\n\nSupply schedules use **MPS = 1e7** (10 million), where each unit represents one thousandth of a basis point.\n\nThe supply schedule defines the token issuance rate over time. Each step contains:\n\n- `mps`: Tokens released per block (in mps units)\n- `blockDelta`: Number of blocks this rate applies\n\n### Standard Schedule Generator\n\nThe plugin includes an MCP server that generates supply schedules using a **normalized convex curve** with the following properties:\n\n- **12 steps** (default, configurable) for gradual release\n- **Equal token amounts** per step (5.8333% for 70% gradual release)\n- **Decreasing block durations** (convex curve property)\n- **Large final block** receives remaining tokens (~30%, configurable 20-40%)\n- **Total**: the released supply is always exactly 10,000,000 MPS, computed as\n  `sum(mps * blockDelta)` across every step. `mps` is a per-block release rate, not a\n  per-step amount, so the `mps` column by itself does not sum to 10,000,000.\n\nUse the MCP tool `generate_supply_schedule` to generate this standard distribution:\n\n**MCP Tool Call:**\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\nThe algorithm automatically calculates:\n\n1. Equal token amounts per step (e.g., 5.8333% for 12 steps with 70% gradual)\n2. Time boundaries from normalized curve C(t) = t^α (default α = 1.2)\n3. Block durations that DECREASE over time (convex curve property)\n4. Final block adjustment so that `sum(mps * blockDelta)` is exactly 10,000,000 MPS\n\n### Example: 2-day auction on Base\n\nBase uses 2s blocks, so 2 days = 86400 blocks.\n\nCall `generate_supply_schedule` with:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\n**Output (normalized convex distribution):**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 },\n    { \"mps\": 75, \"blockDelta\": 7803 },\n    { \"mps\": 79, \"blockDelta\": 7373 },\n    { \"mps\": 83, \"blockDelta\": 7068 },\n    { \"mps\": 85, \"blockDelta\": 6835 },\n    { \"mps\": 88, \"blockDelta\": 6647 },\n    { \"mps\": 90, \"blockDelta\": 6490 },\n    { \"mps\": 92, \"blockDelta\": 6356 },\n    { \"mps\": 94, \"blockDelta\": 6238 },\n    { \"mps\": 95, \"blockDelta\": 6136 },\n    { \"mps\": 97, \"blockDelta\": 6043 },\n    { \"mps\": 2988006, \"blockDelta\": 1 }\n  ],\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0,\n  \"total_phases\": 13,\n  \"summary\": {\n    \"total_mps\": 10000000,\n    \"target_mps\": 10000000,\n    \"final_block_mps\": 2988006,\n    \"final_block_percentage\": 29.88,\n    \"num_steps\": 12,\n    \"alpha\": 1.2,\n    \"main_supply_pct\": 70.0,\n    \"step_tokens_pct\": 5.8333\n  }\n}\n```\n\n**Notice:**\n\n- Block durations DECREASE: 10894 → 8517 → 7803 → ... → 6043\n- Token amounts per step are approximately equal (~5.8333% each)\n- Final block contains 29.88% of all tokens\n- `sum(mps * blockDelta)` is exactly 10,000,000 MPS (the `mps` column alone sums to far less)\n\n### Example: With prebid period\n\nAdd a prebid period where no tokens are released (mps=0). The prebid is prepended to the schedule.\n\nCall `generate_supply_schedule` with:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 43200\n}\n```\n\n**Output:**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 0, \"blockDelta\": 43200 },\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 },\n    ...\n    { \"mps\": 2988006, \"blockDelta\": 1 }\n  ],\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 43200,\n  \"total_phases\": 14,\n  \"summary\": {\n    \"total_mps\": 10000000,\n    \"target_mps\": 10000000,\n    \"final_block_mps\": 2988006,\n    \"final_block_percentage\": 29.88,\n    \"num_steps\": 12,\n    \"alpha\": 1.2,\n    \"main_supply_pct\": 70.0,\n    \"step_tokens_pct\": 5.8333\n  }\n}\n```\n\n**Notice:** The prebid phase is simply prepended with `mps: 0`. The auction portion still uses the same normalized convex distribution.\n\n### Custom Schedule\n\nFor custom distribution, manually define the schedule:\n\n```json\n{\n  \"supplySchedule\": [\n    { \"mps\": 100, \"blockDelta\": 5000 },\n    { \"mps\": 200, \"blockDelta\": 5000 },\n    { \"mps\": 500, \"blockDelta\": 4400 }\n  ]\n}\n```\n\n**Important**: The last block should sell a significant amount of tokens (typically 30%+) to prevent price manipulation.\n\n---\n\n## Encoding Supply Schedule for Onchain Deployment\n\nAfter generating a supply schedule, it must be encoded into a bytes format for the onchain `AuctionParameters` struct. The encoding packs each `{mps, blockDelta}` element into a uint64.\n\n### Encoding Algorithm\n\nFor each element in the supply schedule:\n\n1. **Create uint64** (64 bits \u002F 8 bytes) where:\n   - First 24 bits: `mps` value (left padded)\n   - Next 40 bits: `blockDelta` value (left padded)\n2. **Pack all uint64s** together via `encodePacked` (concatenate bytes)\n3. **Return** as hex bytes string with `0x` prefix\n\n### Encoding Formula\n\n```solidity\n\u002F\u002F Solidity equivalent\nuint64 packed = (uint64(mps) \u003C\u003C 40) | uint64(blockDelta);\nbytes memory auctionStepsData = abi.encodePacked(packed1, packed2, ...);\n```\n\n### Value Constraints\n\n- **mps**: Must fit in 24 bits (max: 16,777,215)\n- **blockDelta**: Must fit in 40 bits (max: 1,099,511,627,775)\n\n### Using the MCP Tool\n\nUse the `encode_supply_schedule` MCP tool to encode a supply schedule:\n\n**Input:**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 0, \"blockDelta\": 43200 },\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 }\n  ]\n}\n```\n\n**Output:**\n\n```json\n{\n  \"encoded\": \"0x0000000000a8c00000003600002aa60000004400002145...\",\n  \"length_bytes\": 112,\n  \"num_elements\": 14\n}\n```\n\n### Manual Encoding Example (Python)\n\n```python\ndef encode_supply_schedule(schedule):\n    \"\"\"Encode supply schedule to bytes.\"\"\"\n    encoded_bytes = b''\n\n    for item in schedule:\n        mps = item['mps']\n        block_delta = item['blockDelta']\n\n        # Validate bounds\n        assert mps \u003C 2**24, f\"mps {mps} exceeds 24-bit max\"\n        assert block_delta \u003C 2**40, f\"blockDelta {block_delta} exceeds 40-bit max\"\n\n        # Pack into uint64: mps (24 bits) \u003C\u003C 40 | blockDelta (40 bits)\n        packed = (mps \u003C\u003C 40) | block_delta\n\n        # Convert to 8 bytes (big-endian)\n        encoded_bytes += packed.to_bytes(8, byteorder='big')\n\n    return '0x' + encoded_bytes.hex()\n\n# Example\nschedule = [\n    {\"mps\": 0, \"blockDelta\": 43200},\n    {\"mps\": 54, \"blockDelta\": 10894}\n]\nencoded = encode_supply_schedule(schedule)\nprint(encoded)  # 0x0000000000a8c00000003600002aa6\n```\n\n### Integration with Configuration Flow\n\nWhen using the configurator skill:\n\n1. **Generate schedule** via `generate_supply_schedule` MCP tool\n2. **Encode schedule** via `encode_supply_schedule` MCP tool\n3. **Include encoded bytes** in final configuration output\n4. **Pass to deployment** script as `auctionStepsData` parameter\n\nThe encoded bytes string is what gets passed to the Factory's `initializeDistribution` function as part of the `configData` parameter.\n\n---\n\n## Getting Current Block Number\n\nUse public RPCs to fetch current block for `startBlock` configuration:\n\n### Available Public RPCs\n\n| Network  | RPC URL                                       |\n| -------- | --------------------------------------------- |\n| Mainnet  | \u003Chttps:\u002F\u002Fethereum-rpc.publicnode.com>         |\n| Unichain | \u003Chttps:\u002F\u002Funichain-rpc.publicnode.com>         |\n| Base     | \u003Chttps:\u002F\u002Fmainnet.base.org>                    |\n| Arbitrum | \u003Chttps:\u002F\u002Farb1.arbitrum.io\u002Frpc>                |\n| Sepolia  | \u003Chttps:\u002F\u002Fethereum-sepolia-rpc.publicnode.com> |\n\n### Fetch Block Number\n\n```bash\ncurl -X POST \"https:\u002F\u002Fmainnet.base.org\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"eth_blockNumber\",\n    \"params\": [],\n    \"id\": 1\n  }'\n```\n\n**Response:**\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"result\": \"0x123abc\"\n}\n```\n\nConvert hex to decimal for block number.\n\n---\n\n## Validation Rules\n\nBefore generating configuration, ensure:\n\n1. **Block constraints**: `startBlock \u003C endBlock \u003C= claimBlock`\n2. **Valid addresses**: All addresses are valid Ethereum addresses (0x + 40 hex chars)\n3. **Non-negative values**: All numeric values >= 0\n4. **Floor price alignment**: Floor price must be a multiple of tick spacing\n5. **Tick spacing**: At least 1 basis point of floor price (1%, 10% recommended)\n6. **Supply schedule**: Last block sells significant tokens (~30%+)\n7. **Total supply bounds**: Max 1e30 wei (1 trillion 18-decimal tokens)\n8. **No FoT tokens**: Fee-on-transfer tokens not supported\n9. **Minimum decimals**: Do not use tokens with \u003C 6 decimals\n\n---\n\n## Additional Resources\n\n- **CCA Repository**: \u003Chttps:\u002F\u002Fgithub.com\u002FUniswap\u002Fcontinuous-clearing-auction>\n- **Technical Documentation**: See `docs\u002FTechnicalDocumentation.md` in repo\n- **Deployment Guide**: See `docs\u002FDeploymentGuide.md` in repo\n- **Whitepaper**: See `docs\u002Fassets\u002Fwhitepaper.pdf` in repo\n- **Audits**: See `docs\u002Faudits\u002FREADME.md` in repo\n- **Uniswap Docs**: \u003Chttps:\u002F\u002Fdocs.uniswap.org\u002Fcontracts\u002Fliquidity-launchpad\u002FCCA>\n- **Bug Bounty**: \u003Chttps:\u002F\u002Fcantina.xyz\u002Fcode\u002Ff9df94db-c7b1-434b-bb06-d1360abdd1be\u002Foverview>\n","# CCA Configuration\n\nConfigure Continuous Clearing Auction (CCA) smart contract parameters for fair and transparent token distribution.\n\n> **Runtime Compatibility:** This skill uses `AskUserQuestion` for interactive prompts. If `AskUserQuestion` is not available in your runtime, collect the same parameters through natural language conversation instead.\n\n## Instructions for Claude Code\n\nWhen the user invokes this skill, guide them through a **bulk interactive form configuration flow** using AskUserQuestion. Collect parameters in batches to minimize user interaction rounds.\n\n### Bulk Interactive Form Rules\n\n1. **Batch questions** - Ask up to 4 questions at once using a single AskUserQuestion call\n2. **Allow direct input** - For fields requiring custom values (addresses, numbers):\n   - Provide a \"Not available yet\" or \"Skip for now\" option\n   - The \"Other\" option (automatically provided) allows direct custom input\n   - **NEVER** ask \"Do you have X?\" as a separate question\n3. **Store answers** - Keep track of all collected values in a configuration object\n4. **Validate after collection** - After each batch, validate all inputs before proceeding\n5. **Show progress** - After each batch, show which parameters are collected and which remain\n\n### Input Validation Rules\n\nRule 4 above says validate after each batch. This is what validating means. Most values below arrive by selecting one of the preset options, but any of them can instead arrive as free text: through the \"Other\" option, which `AskUserQuestion` provides on every question, and through plain conversation whenever `AskUserQuestion` is unavailable and the runtime-compatibility fallback above applies. A custom RPC endpoint is the clearest case, because the Network question lists named networks and no endpoint field, yet a user who rejects the public endpoints still supplies one through \"Other\" or in conversation. Validate every value against the checks below before writing it into the configuration file or interpolating it into a `curl` command. Do not look for an exemption: a value that really is one of the presets this skill offered passes every check trivially, and under the conversational fallback there is no way to establish where a value came from in the first place.\n\n- **Ethereum addresses** (`token`, `currency`, `tokensRecipient`, `fundsRecipient`, `validationHook`): MUST match `^0x[a-fA-F0-9]{40}$` — reject otherwise\n- **Chain IDs**: MUST be from the supported chains list (1, 130, 1301, 8453, 42161, 11155111)\n- **Numeric values** (supply, prices, blocks, MPS, block deltas): MUST be non-negative and match `^[0-9]+\\.?[0-9]*$`\n- **RPC endpoint URL**: prefer a public endpoint from the [Available Public RPCs](#available-public-rpcs) table. A custom endpoint, however it arrives, MUST be `https:\u002F\u002F`-scheme and MUST NOT contain any metacharacter or whitespace from the rule below before it reaches the `curl` command in [Fetch Block Number](#fetch-block-number). \"It came from the user, not the table\" is not an exemption.\n- **REJECT** any input containing shell metacharacters or whitespace: `;`, `|`, `&`, `$`, `` ` ``, `(`, `)`, `>`, `\u003C`, `\\`, `'`, `\"`, spaces, tabs, newlines. `$(...)` and backticks execute even inside double quotes, and a space splits one value into extra `curl` flags, so neither is ever safe to interpolate. Abort and report which value and which character failed rather than stripping the offending characters and continuing.\n- **Never** pass raw user input directly to a shell command without validation, and always double-quote the interpolation in any command shown to the user.\n\nA value that fails any check is never written to the configuration file either. The `deployer` skill reads that file and interpolates its fields into `forge` and `cast` commands, so an unvalidated value stored here becomes an injected command there.\n\n### Configuration Flow\n\nCollect parameters in these batches:\n\n#### Batch 1: Task Selection (1 question)\n\n**Question 1: Task Type**\n\n- Prompt: \"What would you like to do with CCA?\"\n- Options: \"Configure auction parameters\", \"Generate supply schedule only\", \"Review existing config\", \"Deploy existing config\"\n\n**After collection:** If not \"Configure auction parameters\", skip to appropriate section.\n\n---\n\n#### Batch 2: Basic Configuration (4 questions)\n\n**Question 1: Network**\n\n- Prompt: \"Which network to deploy on?\"\n- Options: \"Ethereum Mainnet\", \"Unichain (Mainnet)\", \"Unichain Sepolia (Testnet)\", \"Base\", \"Arbitrum\", \"Sepolia\"\n- Store: `chainId`, `blockTime`, `rpcUrl`, `currencyDecimals` (for selected currency)\n\n**Question 2: Token Address**\n\n- Prompt: \"Token to be auctioned?\"\n- Options: \"Token not deployed yet\" (placeholder), Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `token`\n\n**Question 3: Total Supply**\n\n- Prompt: \"How many tokens to auction?\"\n- Options: \"100 million tokens (18 decimals)\", \"1 billion tokens (18 decimals)\", \"10 billion tokens (18 decimals)\", Custom (via \"Other\")\n- Validation: Must be \u003C= 1e30 wei\n- Store: `totalSupply`\n\n**Question 4: Currency**\n\n- Prompt: \"What currency should bidders use?\"\n- Options: \"ETH (Native)\", \"USDC on [network]\", \"USDT on [network]\", Custom ERC20 (via \"Other\")\n- Validation: Must be 42 chars starting with 0x or address(0)\n- Store: `currency`\n\n**After collection:** Validate all inputs, show summary of basic configuration.\n\n---\n\n#### Batch 3: Timing & Pricing (4 questions)\n\n**Question 1: Auction Duration**\n\n- Prompt: \"How long should the auction run?\"\n- Options: \"1 day\", \"2 days\", \"3 days\", \"7 days\", Custom blocks (via \"Other\")\n- Calculate blocks based on network block time\n- Store: `auctionBlocks`\n\n**Question 2: Prebid Period**\n\n- Prompt: \"Include a prebid period? (time when no tokens are sold)\"\n- Options: \"No prebid period (0 blocks)\", \"12 hours\", \"1 day\", Custom blocks (via \"Other\")\n- Calculate blocks based on network block time\n- Store: `prebidBlocks`\n\n**Question 3: Floor Price**\n\n- Prompt: \"Starting floor price? (ratio of currency per token)\"\n- Options: \"0.10x (10% of 1:1 ratio)\", \"0.01x (1% of 1:1 ratio)\", \"0.001x (0.1% of 1:1 ratio)\", Custom ratio (via \"Other\")\n- Calculate Q96 value accounting for decimal differences: `Q96 * ratio \u002F 10^(tokenDecimals - currencyDecimals)`\n- For USDC (6 decimals) and 18-decimal token: `Q96 * ratio \u002F 10^12`\n- For native ETH (18 decimals) and 18-decimal token: `Q96 * ratio \u002F 10^0 = Q96 * ratio`\n- Store: `floorPriceRatio`, `floorPrice` (Q96), `tokenDecimals`, `currencyDecimals`\n\n**Question 4: Tick Spacing**\n\n- Prompt: \"Tick spacing as percentage of floor price?\"\n- Options: \"1% of floor price (Recommended)\", \"10% of floor price\", \"0.1% of floor price\", Custom percentage (via \"Other\")\n- Calculate: `tickSpacing = int(floorPrice * percentage)`\n- **CRITICAL**: Round floor price DOWN to be evenly divisible by tick spacing:\n  - `roundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing`\n  - Verify: `roundedFloorPrice % tickSpacing == 0` must be true\n- Validate: Tick spacing must be >= 1 basis point of floor price\n- Store: `tickSpacingPercentage`, `tickSpacing` (Q96), `roundedFloorPrice`\n\n**After collection:** Validate inputs, verify floor price divisibility, calculate and display Q96 values, show timing summary.\n\n---\n\n#### Batch 4: Recipients & Launch (4 questions)\n\n**Question 1: Tokens Recipient**\n\n- Prompt: \"Where should unsold tokens be sent?\"\n- Options: \"Same as funds recipient\", Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `tokensRecipient`\n\n**Question 2: Funds Recipient**\n\n- Prompt: \"Where should raised funds be sent?\"\n- Options: \"Same as tokens recipient\", Custom address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x\n- Store: `fundsRecipient`\n\n**Question 3: Start Time**\n\n- Prompt: \"When should the auction start?\"\n- Options: \"In 1 hour\", \"In 6 hours\", \"In 24 hours\", Custom block number (via \"Other\")\n- Fetch current block number from RPC and calculate\n- Store: `startBlock`\n- Calculate: `endBlock = startBlock + prebidBlocks + auctionBlocks`, `claimBlock = endBlock`\n\n**Question 4: Minimum Funds Required**\n\n- Prompt: \"Require minimum currency raised for graduation?\"\n- Options: \"No minimum (0)\", \"100 ETH\", \"1000 ETH\", Custom amount in wei (via \"Other\")\n- Store: `requiredCurrencyRaised`\n\n**After collection:** Validate addresses, fetch current block from RPC, calculate full block timeline.\n\n---\n\n#### Batch 5: Optional Hook (1 question)\n\n**Question 1: Validation Hook**\n\n- Prompt: \"Use a validation hook contract?\"\n- Options: \"No validation hook\", Custom hook address (via \"Other\")\n- Validation: Must be 42 chars starting with 0x (if provided)\n- Store: `validationHook`\n\n**After collection:** Validate hook address if provided.\n\n---\n\n#### Step 6: Generate Supply Schedule\n\n**If MCP server is not running**, provide instructions to start it:\n\n```bash\n# Navigate to MCP server directory\ncd packages\u002Fplugins\u002Funiswap-cca\u002Fmcp-server\u002Fsupply-schedule\n\n# Run setup script (first time only)\nchmod +x setup.sh\n.\u002Fsetup.sh\n\n# Start the MCP server\npython3 server.py\n```\n\nOnce the MCP server is running, call the `cca-supply-schedule__generate_supply_schedule` MCP tool with the collected parameters. The tool expects a JSON object:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\nReplace the values with the actual `auctionBlocks` and `prebidBlocks` collected from the user.\n\nIf the MCP tool is unavailable, use the fallback Python algorithm directly (see Supply Schedule Configuration section).\n\nStore: `supplySchedule`\n\n#### Step 7: Generate and Display Configuration\n\nAfter collecting all parameters and generating the supply schedule, display the complete JSON configuration in the CLI output:\n\n```json\n{\n  \"[chainId]\": {\n    \"token\": \"...\",\n    \"totalSupply\": ...,\n    \"currency\": \"...\",\n    \"tokensRecipient\": \"...\",\n    \"fundsRecipient\": \"...\",\n    \"startBlock\": ...,\n    \"endBlock\": ...,\n    \"claimBlock\": ...,\n    \"tickSpacing\": ...,\n    \"validationHook\": \"...\",\n    \"floorPrice\": ...,\n    \"requiredCurrencyRaised\": ...,\n    \"supplySchedule\": [...]\n  }\n}\n```\n\n**Do NOT automatically create a file.** Let the user copy the JSON or specify a filepath to save it.\n\n#### Step 8: Display Summary\n\nShow the user a comprehensive formatted summary including:\n\n- Network and chain ID\n- Token and currency details\n- Block timeline (start, end, claim) with human-readable times\n- Pricing (floor price, tick spacing) in both Q96 and ratio formats\n- Recipients (tokens, funds)\n- Supply schedule summary (total phases, final block percentage)\n- Validation checklist (all validation rules passed\u002Ffailed)\n\n#### Step 9: Next Steps\n\nAsk the user what they want to do:\n\n- \"Save to file\" (ask for filepath, default: `script\u002Fauction-config.json`)\n- \"View deployment instructions\" (suggest using the deployer skill)\n- \"Modify configuration\"\n- \"Exit\" (just end, they can copy the JSON from CLI output)\n\n### Important Notes\n\n- **Validate in batches** - Validate all inputs after each batch collection\n- **Fetch current block number** from RPC when calculating start\u002Fend blocks\n- **Calculate Q96 values** correctly for floor price and tick spacing:\n  - **CRITICAL**: Account for decimal differences: `Q96 * ratio \u002F 10^(tokenDecimals - currencyDecimals)`\n  - USDC is 6 decimals on all networks - divide by 10^12 for 18-decimal tokens\n  - Native ETH is 18 decimals - no adjustment needed for 18-decimal tokens\n- **Round floor price** to be evenly divisible by tick spacing:\n  - `roundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing`\n  - **MUST verify**: `roundedFloorPrice % tickSpacing == 0`\n- **Use the MCP tool** for supply schedule generation (provide setup instructions if not running)\n- **Minimize interaction rounds** - Collect as many params as reasonable per batch\n\n### Network-Specific Constants\n\nStore these for quick reference:\n\n```typescript\nconst NETWORKS = {\n  1: {\n    name: 'Mainnet',\n    blockTime: 12,\n    rpc: 'https:\u002F\u002Fethereum-rpc.publicnode.com',\n    usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n  },\n  130: {\n    name: 'Unichain',\n    blockTime: 1,\n    rpc: 'https:\u002F\u002Fmainnet.unichain.org',\n    usdc: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',\n  },\n  1301: {\n    name: 'Unichain Sepolia (Testnet)',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Fsepolia.unichain.org',\n    usdc: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',\n  },\n  8453: {\n    name: 'Base',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Fmainnet.base.org',\n    usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n  },\n  42161: {\n    name: 'Arbitrum',\n    blockTime: 2,\n    rpc: 'https:\u002F\u002Farb1.arbitrum.io\u002Frpc',\n    usdc: '0xaf88d065e77c8cc2239327c5edb3a432268e5831',\n  },\n  11155111: {\n    name: 'Sepolia',\n    blockTime: 12,\n    rpc: 'https:\u002F\u002Fethereum-sepolia-rpc.publicnode.com',\n    usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',\n  },\n};\n\n\u002F\u002F Q96 = 2^96 (JavaScript BigInt notation)\nconst Q96 = 79228162514264337593543950336n;\n```\n\nPython equivalent:\n\n```python\n# Q96 = 2**96\nQ96 = 79228162514264337593543950336\n```\n\n## Overview\n\nCCA (Continuous Clearing Auction) is a novel auction mechanism that generalizes the uniform-price auction into continuous time. It provides fair price discovery for bootstrapping initial liquidity while eliminating timing games and encouraging early participation.\n\nKey features:\n\n- **Fair price discovery**: Continuous clearing with no timing games\n- **Transparent distribution**: Supply released on a predetermined schedule\n- **Flexible configuration**: Customizable auction parameters and schedules\n- **Multi-chain support**: Canonical deployment across EVM chains\n- **Factory deployment**: Consistent addresses via CREATE2\n\n## Quick Decision Guide\n\n| Task...                      | Use This Section              |\n| ---------------------------- | ----------------------------- |\n| Configure auction parameters | Configuration Guide           |\n| Generate supply schedule     | Supply Schedule Configuration |\n| Understand auction mechanics | Technical Overview            |\n\n---\n\n## Configuration Guide\n\n### Auction Parameters\n\nCCA auctions are configured through the `AuctionParameters` struct:\n\n```solidity\nstruct AuctionParameters {\n    address currency;              \u002F\u002F Token to raise funds in (address(0) for ETH)\n    address tokensRecipient;       \u002F\u002F Address to receive leftover tokens\n    address fundsRecipient;        \u002F\u002F Address to receive all raised funds\n    uint64 startBlock;             \u002F\u002F Block when auction starts\n    uint64 endBlock;               \u002F\u002F Block when auction ends\n    uint64 claimBlock;             \u002F\u002F Block when tokens can be claimed\n    uint256 tickSpacing;           \u002F\u002F Fixed granularity for prices (Q96)\n    address validationHook;        \u002F\u002F Optional hook (use 0x0 if none)\n    uint256 floorPrice;            \u002F\u002F Starting floor price (Q96)\n    uint128 requiredCurrencyRaised; \u002F\u002F Minimum funds to graduate\n    bytes auctionStepsData;        \u002F\u002F Packed supply issuance schedule\n}\n```\n\n### Configuration File Format\n\nCreate a JSON configuration file (e.g., `script\u002Fauction-config.json`):\n\n```json\n{\n  \"1\": {\n    \"token\": \"0x...\",\n    \"totalSupply\": 1e29,\n    \"currency\": \"0x0000000000000000000000000000000000000000\",\n    \"tokensRecipient\": \"0x...\",\n    \"fundsRecipient\": \"0x...\",\n    \"startBlock\": 24321000,\n    \"endBlock\": 24327001,\n    \"claimBlock\": 24327001,\n    \"tickSpacing\": 79228162514264337593543950,\n    \"validationHook\": \"0x0000000000000000000000000000000000000000\",\n    \"floorPrice\": 7922816251426433759354395000,\n    \"requiredCurrencyRaised\": 0,\n    \"supplySchedule\": [\n      { \"mps\": 1000, \"blockDelta\": 6000 },\n      { \"mps\": 4000000, \"blockDelta\": 1 }\n    ]\n  }\n}\n```\n\n### Parameter Details\n\n#### Basic Configuration\n\n| Parameter         | Type    | Description                                       |\n| ----------------- | ------- | ------------------------------------------------- |\n| `token`           | address | Token being auctioned                             |\n| `totalSupply`     | number  | Total tokens to auction (wei\u002Fsmallest unit)       |\n| `currency`        | address | Purchase token (USDC, etc.) or address(0) for ETH |\n| `tokensRecipient` | address | Where unsold tokens go                            |\n| `fundsRecipient`  | address | Where raised funds go                             |\n\n#### Block Configuration\n\n| Parameter    | Type   | Description                | Constraint             |\n| ------------ | ------ | -------------------------- | ---------------------- |\n| `startBlock` | number | When auction starts        | startBlock \u003C endBlock  |\n| `endBlock`   | number | When auction ends          | endBlock \u003C= claimBlock |\n| `claimBlock` | number | When tokens can be claimed | claimBlock >= endBlock |\n\n**Block times by network:**\n\n- Mainnet, Sepolia: 12s per block\n- Unichain, Base, Arbitrum: 2s per block\n\n#### Pricing Parameters\n\n| Parameter                | Type    | Description                                    |\n| ------------------------ | ------- | ---------------------------------------------- |\n| `floorPrice`             | number  | Minimum price (Q96 format)                     |\n| `tickSpacing`            | number  | Price tick increment (Q96 format)              |\n| `validationHook`         | address | Optional validation contract (use 0x0 if none) |\n| `requiredCurrencyRaised` | number  | Minimum funds needed (0 if no minimum)         |\n\n#### Supply Schedule\n\n| Parameter        | Type  | Description                        |\n| ---------------- | ----- | ---------------------------------- |\n| `supplySchedule` | array | Array of {mps, blockDelta} objects |\n\n---\n\n## Price Calculations (Q96 Format)\n\nCCA uses Q96 fixed-point format for precise pricing. The base value `2^96` (79228162514264337593543950336) represents a 1:1 price ratio.\n\n### Floor Price Calculation\n\n**CRITICAL: Account for decimal differences between token and currency.**\n\n```python\n# Base value for 1:1 ratio\nQ96 = 79228162514264337593543950336\n\n# Formula: Q96 * (human price ratio) \u002F 10^(token_decimals - currency_decimals)\n\n# Example 1: USDC (6 decimals) per 18-decimal token at $0.10 ratio\ntoken_decimals = 18\ncurrency_decimals = 6  # USDC has 6 decimals\ndecimal_adjustment = 10 ** (token_decimals - currency_decimals)  # 10^12\n\nfloorPrice = Q96 * 0.1 \u002F decimal_adjustment\n# Result: 7922816251426433759354395 (approximately)\n\n# Example 2: Native ETH (18 decimals) per 18-decimal token at 0.1 ratio\ntoken_decimals = 18\ncurrency_decimals = 18  # Native ETH has 18 decimals\ndecimal_adjustment = 10 ** (18 - 18)  # 10^0 = 1\n\nfloorPrice = Q96 * 0.1 \u002F 1\n# Result: 7922816251426433759354395034\n```\n\n**Key Point:** USDC has 6 decimals on all networks, so you must divide by 10^12 when using USDC with 18-decimal tokens.\n\n### Tick Spacing Calculation\n\nTick spacing governs where bids can be placed. Choose **AT LEAST 1 basis point of the floor price**. 1% or 10% is also reasonable.\n\n```python\n# Example: 1% of floor price\ntickSpacing = int(floorPrice * 0.01)\n\n# For floorPrice = 7922816251426433759354395000\n# Result: 79228162514264337593543950\n```\n\n### Rounding Floor Price (CRITICAL)\n\n**Floor price MUST be evenly divisible by tick spacing.** Round DOWN to ensure exact divisibility:\n\n```python\n# Calculate tick spacing first\ntickSpacing = int(floorPrice * 0.01)  # 1% of floor price\n\n# Round floor price DOWN to be evenly divisible\nroundedFloorPrice = (floorPrice \u002F\u002F tickSpacing) * tickSpacing\n\n# VERIFY divisibility (must be True)\nassert roundedFloorPrice % tickSpacing == 0, \"Floor price must be divisible by tick spacing!\"\n```\n\n**Example:**\n\n```python\nQ96 = 79228162514264337593543950336\nraw_floor_price = int(Q96 * 0.0001)  # 0.0001 ETH per token\n# Result: 7922816251426434139029504\n\ntick_spacing = int(raw_floor_price * 0.01)  # 1%\n# Result: 79228162514264350785536\n\nrounded_floor_price = (raw_floor_price \u002F\u002F tick_spacing) * tick_spacing\n# Result: 7843588088912170727768064\n\n# Verify: 7843588088912170727768064 \u002F 79228162514264350785536 = 99 (exact)\n# Remainder: 0 ✓\n```\n\n**Warning**: Setting too small of a tick spacing will make the auction extremely gas inefficient and can result in DoS attacks.\n\n---\n\n## Supply Schedule Configuration\n\n### Understanding MPS (Milli-Basis Points)\n\nSupply schedules use **MPS = 1e7** (10 million), where each unit represents one thousandth of a basis point.\n\nThe supply schedule defines the token issuance rate over time. Each step contains:\n\n- `mps`: Tokens released per block (in mps units)\n- `blockDelta`: Number of blocks this rate applies\n\n### Standard Schedule Generator\n\nThe plugin includes an MCP server that generates supply schedules using a **normalized convex curve** with the following properties:\n\n- **12 steps** (default, configurable) for gradual release\n- **Equal token amounts** per step (5.8333% for 70% gradual release)\n- **Decreasing block durations** (convex curve property)\n- **Large final block** receives remaining tokens (~30%, configurable 20-40%)\n- **Total**: the released supply is always exactly 10,000,000 MPS, computed as\n  `sum(mps * blockDelta)` across every step. `mps` is a per-block release rate, not a\n  per-step amount, so the `mps` column by itself does not sum to 10,000,000.\n\nUse the MCP tool `generate_supply_schedule` to generate this standard distribution:\n\n**MCP Tool Call:**\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\nThe algorithm automatically calculates:\n\n1. Equal token amounts per step (e.g., 5.8333% for 12 steps with 70% gradual)\n2. Time boundaries from normalized curve C(t) = t^α (default α = 1.2)\n3. Block durations that DECREASE over time (convex curve property)\n4. Final block adjustment so that `sum(mps * blockDelta)` is exactly 10,000,000 MPS\n\n### Example: 2-day auction on Base\n\nBase uses 2s blocks, so 2 days = 86400 blocks.\n\nCall `generate_supply_schedule` with:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0\n}\n```\n\n**Output (normalized convex distribution):**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 },\n    { \"mps\": 75, \"blockDelta\": 7803 },\n    { \"mps\": 79, \"blockDelta\": 7373 },\n    { \"mps\": 83, \"blockDelta\": 7068 },\n    { \"mps\": 85, \"blockDelta\": 6835 },\n    { \"mps\": 88, \"blockDelta\": 6647 },\n    { \"mps\": 90, \"blockDelta\": 6490 },\n    { \"mps\": 92, \"blockDelta\": 6356 },\n    { \"mps\": 94, \"blockDelta\": 6238 },\n    { \"mps\": 95, \"blockDelta\": 6136 },\n    { \"mps\": 97, \"blockDelta\": 6043 },\n    { \"mps\": 2988006, \"blockDelta\": 1 }\n  ],\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 0,\n  \"total_phases\": 13,\n  \"summary\": {\n    \"total_mps\": 10000000,\n    \"target_mps\": 10000000,\n    \"final_block_mps\": 2988006,\n    \"final_block_percentage\": 29.88,\n    \"num_steps\": 12,\n    \"alpha\": 1.2,\n    \"main_supply_pct\": 70.0,\n    \"step_tokens_pct\": 5.8333\n  }\n}\n```\n\n**Notice:**\n\n- Block durations DECREASE: 10894 → 8517 → 7803 → ... → 6043\n- Token amounts per step are approximately equal (~5.8333% each)\n- Final block contains 29.88% of all tokens\n- `sum(mps * blockDelta)` is exactly 10,000,000 MPS (the `mps` column alone sums to far less)\n\n### Example: With prebid period\n\nAdd a prebid period where no tokens are released (mps=0). The prebid is prepended to the schedule.\n\nCall `generate_supply_schedule` with:\n\n```json\n{\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 43200\n}\n```\n\n**Output:**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 0, \"blockDelta\": 43200 },\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 },\n    ...\n    { \"mps\": 2988006, \"blockDelta\": 1 }\n  ],\n  \"auction_blocks\": 86400,\n  \"prebid_blocks\": 43200,\n  \"total_phases\": 14,\n  \"summary\": {\n    \"total_mps\": 10000000,\n    \"target_mps\": 10000000,\n    \"final_block_mps\": 2988006,\n    \"final_block_percentage\": 29.88,\n    \"num_steps\": 12,\n    \"alpha\": 1.2,\n    \"main_supply_pct\": 70.0,\n    \"step_tokens_pct\": 5.8333\n  }\n}\n```\n\n**Notice:** The prebid phase is simply prepended with `mps: 0`. The auction portion still uses the same normalized convex distribution.\n\n### Custom Schedule\n\nFor custom distribution, manually define the schedule:\n\n```json\n{\n  \"supplySchedule\": [\n    { \"mps\": 100, \"blockDelta\": 5000 },\n    { \"mps\": 200, \"blockDelta\": 5000 },\n    { \"mps\": 500, \"blockDelta\": 4400 }\n  ]\n}\n```\n\n**Important**: The last block should sell a significant amount of tokens (typically 30%+) to prevent price manipulation.\n\n---\n\n## Encoding Supply Schedule for Onchain Deployment\n\nAfter generating a supply schedule, it must be encoded into a bytes format for the onchain `AuctionParameters` struct. The encoding packs each `{mps, blockDelta}` element into a uint64.\n\n### Encoding Algorithm\n\nFor each element in the supply schedule:\n\n1. **Create uint64** (64 bits \u002F 8 bytes) where:\n   - First 24 bits: `mps` value (left padded)\n   - Next 40 bits: `blockDelta` value (left padded)\n2. **Pack all uint64s** together via `encodePacked` (concatenate bytes)\n3. **Return** as hex bytes string with `0x` prefix\n\n### Encoding Formula\n\n```solidity\n\u002F\u002F Solidity equivalent\nuint64 packed = (uint64(mps) \u003C\u003C 40) | uint64(blockDelta);\nbytes memory auctionStepsData = abi.encodePacked(packed1, packed2, ...);\n```\n\n### Value Constraints\n\n- **mps**: Must fit in 24 bits (max: 16,777,215)\n- **blockDelta**: Must fit in 40 bits (max: 1,099,511,627,775)\n\n### Using the MCP Tool\n\nUse the `encode_supply_schedule` MCP tool to encode a supply schedule:\n\n**Input:**\n\n```json\n{\n  \"schedule\": [\n    { \"mps\": 0, \"blockDelta\": 43200 },\n    { \"mps\": 54, \"blockDelta\": 10894 },\n    { \"mps\": 68, \"blockDelta\": 8517 }\n  ]\n}\n```\n\n**Output:**\n\n```json\n{\n  \"encoded\": \"0x0000000000a8c00000003600002aa60000004400002145...\",\n  \"length_bytes\": 112,\n  \"num_elements\": 14\n}\n```\n\n### Manual Encoding Example (Python)\n\n```python\ndef encode_supply_schedule(schedule):\n    \"\"\"Encode supply schedule to bytes.\"\"\"\n    encoded_bytes = b''\n\n    for item in schedule:\n        mps = item['mps']\n        block_delta = item['blockDelta']\n\n        # Validate bounds\n        assert mps \u003C 2**24, f\"mps {mps} exceeds 24-bit max\"\n        assert block_delta \u003C 2**40, f\"blockDelta {block_delta} exceeds 40-bit max\"\n\n        # Pack into uint64: mps (24 bits) \u003C\u003C 40 | blockDelta (40 bits)\n        packed = (mps \u003C\u003C 40) | block_delta\n\n        # Convert to 8 bytes (big-endian)\n        encoded_bytes += packed.to_bytes(8, byteorder='big')\n\n    return '0x' + encoded_bytes.hex()\n\n# Example\nschedule = [\n    {\"mps\": 0, \"blockDelta\": 43200},\n    {\"mps\": 54, \"blockDelta\": 10894}\n]\nencoded = encode_supply_schedule(schedule)\nprint(encoded)  # 0x0000000000a8c00000003600002aa6\n```\n\n### Integration with Configuration Flow\n\nWhen using the configurator skill:\n\n1. **Generate schedule** via `generate_supply_schedule` MCP tool\n2. **Encode schedule** via `encode_supply_schedule` MCP tool\n3. **Include encoded bytes** in final configuration output\n4. **Pass to deployment** script as `auctionStepsData` parameter\n\nThe encoded bytes string is what gets passed to the Factory's `initializeDistribution` function as part of the `configData` parameter.\n\n---\n\n## Getting Current Block Number\n\nUse public RPCs to fetch current block for `startBlock` configuration:\n\n### Available Public RPCs\n\n| Network  | RPC URL                                       |\n| -------- | --------------------------------------------- |\n| Mainnet  | \u003Chttps:\u002F\u002Fethereum-rpc.publicnode.com>         |\n| Unichain | \u003Chttps:\u002F\u002Funichain-rpc.publicnode.com>         |\n| Base     | \u003Chttps:\u002F\u002Fmainnet.base.org>                    |\n| Arbitrum | \u003Chttps:\u002F\u002Farb1.arbitrum.io\u002Frpc>                |\n| Sepolia  | \u003Chttps:\u002F\u002Fethereum-sepolia-rpc.publicnode.com> |\n\n### Fetch Block Number\n\n```bash\ncurl -X POST \"https:\u002F\u002Fmainnet.base.org\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"eth_blockNumber\",\n    \"params\": [],\n    \"id\": 1\n  }'\n```\n\n**Response:**\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"result\": \"0x123abc\"\n}\n```\n\nConvert hex to decimal for block number.\n\n---\n\n## Validation Rules\n\nBefore generating configuration, ensure:\n\n1. **Block constraints**: `startBlock \u003C endBlock \u003C= claimBlock`\n2. **Valid addresses**: All addresses are valid Ethereum addresses (0x + 40 hex chars)\n3. **Non-negative values**: All numeric values >= 0\n4. **Floor price alignment**: Floor price must be a multiple of tick spacing\n5. **Tick spacing**: At least 1 basis point of floor price (1%, 10% recommended)\n6. **Supply schedule**: Last block sells significant tokens (~30%+)\n7. **Total supply bounds**: Max 1e30 wei (1 trillion 18-decimal tokens)\n8. **No FoT tokens**: Fee-on-transfer tokens not supported\n9. **Minimum decimals**: Do not use tokens with \u003C 6 decimals\n\n---\n\n## Additional Resources\n\n- **CCA Repository**: \u003Chttps:\u002F\u002Fgithub.com\u002FUniswap\u002Fcontinuous-clearing-auction>\n- **Technical Documentation**: See `docs\u002FTechnicalDocumentation.md` in repo\n- **Deployment Guide**: See `docs\u002FDeploymentGuide.md` in repo\n- **Whitepaper**: See `docs\u002Fassets\u002Fwhitepaper.pdf` in repo\n- **Audits**: See `docs\u002Faudits\u002FREADME.md` in repo\n- **Uniswap Docs**: \u003Chttps:\u002F\u002Fdocs.uniswap.org\u002Fcontracts\u002Fliquidity-launchpad\u002FCCA>\n- **Bug Bounty**: \u003Chttps:\u002F\u002Fcantina.xyz\u002Fcode\u002Ff9df94db-c7b1-434b-bb06-d1360abdd1be\u002Foverview>\n",{"name":5,"model":23,"license":15,"metadata":46,"description":7,"allowed-tools":48},{"author":27,"version":47},"1.0.0","Read, Write, Edit, Glob, Grep, Bash(curl:*), WebFetch, AskUserQuestion, cca-supply-schedule__generate_supply_schedule, cca-supply-schedule__encode_supply_schedule","main","3df1d0d67b30ff15236561f8c0f9f06d33f42dfd","skills\u002Fdefi\u002Funiswap-official-cca-configurator",17,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia","https:\u002F\u002Feth2030.com","Hardcore infra. Building @alt-research and applied cryptography.","2026-11-12 02:28:42",{"source":8,"skillName":5,"commands":59,"prompt":69,"zipAvailable":70},[60,63,66],{"tool":61,"command":62},"npx","npx skills add jiayaoqijia\u002Fcryptoskill --skill configurator",{"tool":64,"command":65},"bunx","bunx skills add jiayaoqijia\u002Fcryptoskill --skill configurator",{"tool":67,"command":68},"pnpm","pnpm dlx skills add jiayaoqijia\u002Fcryptoskill --skill configurator","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Funiswap-official-cca-configurator\u002FSKILL.md",true,[72,76,82],{"path":73,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":16},"LICENSE","许可证",1069,{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},"SOURCE.md","REFERENCE","参考文档",160,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Funiswap-official-cca-configurator\u002FSOURCE.md",{"path":83,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":84,"sourceHtmlUrl":85},"TRUST.auto.yaml",2070,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Funiswap-official-cca-configurator\u002FTRUST.auto.yaml",[87,114,137,155,168,178],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":41},"01M712C436EQYE43342Q4E7GG1","recipe-performance","Diagnose a specific MetaMask user flow's real-app performance and Sentry critical-user-flow telemetry with deterministic mm-harness recipes. Use for CUF boundaries, cold\u002Fwarm\u002Fbackground-resume behavior, latency regressions, lifecycle tags, duplicate or blocking network requests, long tasks, layout\u002Fpaint cost, screen redraws, React rerenders, or browser trace analysis where tests alone cannot prove the real app.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fwallets\u002Fmetamask-official-recipe-performance\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fwallets\u002Fmetamask-official-recipe-performance\u002FSKILL.md",[],[95,96,97,98,99,100,101,102,103,40,104,105,106,107,108,109,110,111,112,113],"performance","recipe performance","recipe","mm","sentry","harness","app","deterministic","recipes","cold","critical","analysis","tasks","react","browser","layout","screen","network","metamask",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":118,"licenseFileUrl":119,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":41},"01M70XT2F8A5CQZ81JBP98KSW3","mexc-spot-websocket","MEXC Spot WebSocket workflows for public streams, protobuf handling, depth maintenance, listen keys, and private streams without exposing API keys.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-websocket\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-websocket\u002FSKILL.md",[],[123,124,125,126,127,128,129,130,131,132,133,134,135,136],"mexc spot websocket","spot","websocket","api","workflows","public","listen","streams","depth","keys","for","api keys","maintenance","protobuf",{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":118,"licenseFileUrl":141,"sourceHtmlUrl":142,"categories":143,"keywords":144,"publishedAt":41},"01M70XT0MBXN3WZY1BKN0CPNKR","mexc-spot-rest","MEXC Spot REST workflows for public data, signed account requests, orders, wallet\u002Fadmin actions, and secure signing without exposing API keys.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-rest\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-rest\u002FSKILL.md",[],[145,124,146,147,148,149,150,134,133,132,151,152,153,128,154,127,126],"mexc spot rest","REST","admin","signing","Wallet","requests","actions","secure","data","orders",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":118,"licenseFileUrl":159,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":41},"01M70XSYSVZ2N0N91XCAR2CAK0","mexc-futures-websocket","MEXC Futures WebSocket workflows for public streams, private account\u002Forder\u002Fposition streams, ping\u002Fpong, subscriptions, and depth maintenance.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-futures-websocket\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-futures-websocket\u002FSKILL.md",[],[163,164,125,165,166,135,133,167,131,130,128,127],"mexc futures websocket","futures","position","ping","subscriptions",{"skillNo":169,"name":170,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":171,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":41},"01M6H0ZWHVE5W04WG2DKQE2SQC","0xklen-version-and-refresh-sanctions-lists","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-version-and-refresh-sanctions-lists\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-version-and-refresh-sanctions-lists\u002FSKILL.md",[],[175,176,177],"refresh","0xklen version and refresh sanctions lists","version",{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":182,"sourceHtmlUrl":183,"categories":184,"keywords":185,"publishedAt":41},"01M6H0Z28Q3R8J0S799GJQWXM3","verify-tests-cover-changed-lines","Use when a PR adds code that the existing suite may not exercise. Measures patch coverage — the share of newly changed lines hit by tests — before approving.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-verify-tests-cover-changed-lines\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-verify-tests-cover-changed-lines\u002FSKILL.md",[],[186,187,188,189,190,191,192,32,193,194,195],"tests","cover","verify tests cover changed lines","verify","coverage","pr","exercise","patch","code","share"]