npx skills add ...
npx skills add uniswap/uniswap-ai --skill configurator
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.
npx skills add uniswap/uniswap-ai --skill configurator
Configure Continuous Clearing Auction (CCA) smart contract parameters for fair and transparent token distribution.
Runtime Compatibility: This skill uses
AskUserQuestionfor interactive prompts. IfAskUserQuestionis not available in your runtime, collect the same parameters through natural language conversation instead.
When 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.
Rule 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.
token, currency, tokensRecipient, fundsRecipient, validationHook): MUST match ^0x[a-fA-F0-9]{40}$ — reject otherwise^[0-9]+\.?[0-9]*$https://-scheme and MUST NOT contain any metacharacter or whitespace from the rule below before it reaches the curl command in Fetch Block Number. "It came from the user, not the table" is not an exemption.;, |, &, $, `, (, ), >, <, \, ', ", 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.A 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.
Collect parameters in these batches:
Question 1: Task Type
After collection: If not "Configure auction parameters", skip to appropriate section.
Question 1: Network
chainId, blockTime, rpcUrl, currencyDecimals (for selected currency)Question 2: Token Address
tokenQuestion 3: Total Supply
totalSupplyQuestion 4: Currency
currencyAfter collection: Validate all inputs, show summary of basic configuration.
Question 1: Auction Duration
auctionBlocksQuestion 2: Prebid Period
prebidBlocksQuestion 3: Floor Price
Q96 * ratio / 10^(tokenDecimals - currencyDecimals)Q96 * ratio / 10^12Q96 * ratio / 10^0 = Q96 * ratiofloorPriceRatio, floorPrice (Q96), tokenDecimals, currencyDecimalsQuestion 4: Tick Spacing
tickSpacing = int(floorPrice * percentage)roundedFloorPrice = (floorPrice // tickSpacing) * tickSpacingroundedFloorPrice % tickSpacing == 0 must be truetickSpacingPercentage, tickSpacing (Q96), roundedFloorPriceAfter collection: Validate inputs, verify floor price divisibility, calculate and display Q96 values, show timing summary.
Question 1: Tokens Recipient
tokensRecipientQuestion 2: Funds Recipient
fundsRecipientQuestion 3: Start Time
startBlockendBlock = startBlock + prebidBlocks + auctionBlocks, claimBlock = endBlockQuestion 4: Minimum Funds Required
requiredCurrencyRaisedAfter collection: Validate addresses, fetch current block from RPC, calculate full block timeline.
Question 1: Validation Hook
validationHookAfter collection: Validate hook address if provided.
If MCP server is not running, provide instructions to start it:
Once 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:
Replace the values with the actual auctionBlocks and prebidBlocks collected from the user.
If the MCP tool is unavailable, use the fallback Python algorithm directly (see Supply Schedule Configuration section).
Store: supplySchedule
After collecting all parameters and generating the supply schedule, display the complete JSON configuration in the CLI output:
Do NOT automatically create a file. Let the user copy the JSON or specify a filepath to save it.
Show the user a comprehensive formatted summary including:
Ask the user what they want to do:
script/auction-config.json)Q96 * ratio / 10^(tokenDecimals - currencyDecimals)roundedFloorPrice = (floorPrice // tickSpacing) * tickSpacingroundedFloorPrice % tickSpacing == 0Store these for quick reference:
Python equivalent:
CCA (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.
Key features:
| Task... | Use This Section |
|---|---|
| Configure auction parameters | Configuration Guide |
| Generate supply schedule | Supply Schedule Configuration |
| Understand auction mechanics | Technical Overview |
CCA auctions are configured through the AuctionParameters struct:
Create a JSON configuration file (e.g., script/auction-config.json):
| Parameter | Type | Description |
|---|---|---|
token | address | Token being auctioned |
totalSupply | number | Total tokens to auction (wei/smallest unit) |
currency | address | Purchase token (USDC, etc.) or address(0) for ETH |
tokensRecipient | address | Where unsold tokens go |
fundsRecipient | address | Where raised funds go |
| Parameter | Type | Description | Constraint |
|---|---|---|---|
startBlock | number | When auction starts | startBlock < endBlock |
endBlock | number | When auction ends | endBlock <= claimBlock |
claimBlock | number | When tokens can be claimed | claimBlock >= endBlock |
Block times by network:
| Parameter | Type | Description |
|---|---|---|
floorPrice | number | Minimum price (Q96 format) |
tickSpacing | number | Price tick increment (Q96 format) |
validationHook | address | Optional validation contract (use 0x0 if none) |
requiredCurrencyRaised | number | Minimum funds needed (0 if no minimum) |
| Parameter | Type | Description |
|---|---|---|
supplySchedule | array | Array of {mps, blockDelta} objects |
CCA uses Q96 fixed-point format for precise pricing. The base value 2^96 (79228162514264337593543950336) represents a 1:1 price ratio.
CRITICAL: Account for decimal differences between token and currency.
Key Point: USDC has 6 decimals on all networks, so you must divide by 10^12 when using USDC with 18-decimal tokens.
Tick spacing governs where bids can be placed. Choose AT LEAST 1 basis point of the floor price. 1% or 10% is also reasonable.
Floor price MUST be evenly divisible by tick spacing. Round DOWN to ensure exact divisibility:
Example:
Warning: Setting too small of a tick spacing will make the auction extremely gas inefficient and can result in DoS attacks.
Supply schedules use MPS = 1e7 (10 million), where each unit represents one thousandth of a basis point.
The supply schedule defines the token issuance rate over time. Each step contains:
mps: Tokens released per block (in mps units)blockDelta: Number of blocks this rate appliesThe plugin includes an MCP server that generates supply schedules using a normalized convex curve with the following properties:
sum(mps * blockDelta) across every step. mps is a per-block release rate, not a
per-step amount, so the mps column by itself does not sum to 10,000,000.Use the MCP tool generate_supply_schedule to generate this standard distribution:
MCP Tool Call:
The algorithm automatically calculates:
sum(mps * blockDelta) is exactly 10,000,000 MPSBase uses 2s blocks, so 2 days = 86400 blocks.
Call generate_supply_schedule with:
Output (normalized convex distribution):
Notice:
sum(mps * blockDelta) is exactly 10,000,000 MPS (the mps column alone sums to far less)Add a prebid period where no tokens are released (mps=0). The prebid is prepended to the schedule.
Call generate_supply_schedule with:
Output:
Notice: The prebid phase is simply prepended with mps: 0. The auction portion still uses the same normalized convex distribution.
For custom distribution, manually define the schedule:
Important: The last block should sell a significant amount of tokens (typically 30%+) to prevent price manipulation.
After 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.
For each element in the supply schedule:
mps value (left padded)blockDelta value (left padded)encodePacked (concatenate bytes)0x prefixUse the encode_supply_schedule MCP tool to encode a supply schedule:
Input:
Output:
When using the configurator skill:
generate_supply_schedule MCP toolencode_supply_schedule MCP toolauctionStepsData parameterThe encoded bytes string is what gets passed to the Factory's initializeDistribution function as part of the configData parameter.
Use public RPCs to fetch current block for startBlock configuration:
| Network | RPC URL |
|---|---|
| Mainnet | https://ethereum-rpc.publicnode.com |
| Unichain | https://unichain-rpc.publicnode.com |
| Base | https://mainnet.base.org |
| Arbitrum | https://arb1.arbitrum.io/rpc |
| Sepolia | https://ethereum-sepolia-rpc.publicnode.com |
Response:
Convert hex to decimal for block number.
Before generating configuration, ensure:
startBlock < endBlock <= claimBlockdocs/TechnicalDocumentation.md in repodocs/DeploymentGuide.md in repodocs/assets/whitepaper.pdf in repodocs/audits/README.md in repo