Deployer

Deployment Workflow

1. Show disclaimer — Educational use warning (required)
2. Load configuration — Read and parse the JSON config file
3. Validate parameters — Run full validation checklist
4. Display deployment plan — Summary of what will be deployed
5. Request confirmation — Explicit user approval via AskUserQuestion
6. Provide Foundry commands — forge script commands with security guidance
7. Post-deployment steps — Call onTokensReceived() to activate

⚠️ Educational Use Disclaimer

Always display this before any deployment steps:

This skill provides educational guidance for deploying CCA smart contracts. Smart contract deployment involves real financial risk. Always:

• Test on testnet first (Sepolia or Base Sepolia)
• Audit your configuration before mainnet deployment
• Never share or expose your private key
• Understand that deployed contracts may be immutable

Ask the user to acknowledge before proceeding.

🔐 Private Key Security

⚠️ Never Do These

# NEVER — exposes key in shell history
forge script ... --private-key 0xYOUR_PRIVATE_KEY

# NEVER — key visible in process list
PRIVATE_KEY=0x... forge script ...

✅ Recommended Practices

Option 1: Hardware wallet (Ledger) — Most Secure

forge script script/Deploy.s.sol \
  --rpc-url $RPC_URL \
  --ledger \
  --broadcast

Option 2: Encrypted keystore

# Import key once
cast wallet import deployer --interactive

# Use in scripts
forge script script/Deploy.s.sol \
  --rpc-url $RPC_URL \
  --account deployer \
  --broadcast

Option 3: Environment variable (testing only)

# In .env file (never commit to git)
PRIVATE_KEY=0x...

# Load and use
source .env
forge script script/Deploy.s.sol \
  --rpc-url $RPC_URL \
  --private-key $PRIVATE_KEY \
  --broadcast

Testnet First

Always deploy to testnet before mainnet:

Deployment Guide

Factory Deployment

The CCA Factory is already deployed at a canonical address. You do not need to deploy the factory.

The factory is deployed on: Ethereum, Base, Arbitrum, Unichain, Sepolia, Unichain Sepolia.

Deploying an Auction Instance

Step 1: Clone the CCA repository

git clone https://github.com/Uniswap/continuous-clearing-auction
cd continuous-clearing-auction
forge install

Step 2: Set environment variables

# .env
RPC_URL=https://mainnet.base.org
FACTORY_ADDRESS=0xCCccCcCAE7503Cac057829BF2811De42E16e0bD5
TOKEN_ADDRESS=0x...
CURRENCY_ADDRESS=0x0000000000000000000000000000000000000000
TOTAL_SUPPLY=100000000000000000000000000
START_BLOCK=24321000
END_BLOCK=24327001
FLOOR_PRICE=7922816251426433759354395000
TICK_SPACING=79228162514264337593543950

Step 3: Deploy via forge script

forge script script/DeployAuction.s.sol \
  --rpc-url $RPC_URL \
  --account deployer \
  --broadcast \
  --verify

Step 4: Verify deployment

# Check auction was created
cast call $FACTORY_ADDRESS \
  "getAuction(address)(address)" \
  $TOKEN_ADDRESS \
  --rpc-url $RPC_URL

Alternative: Deploy via Constructor

For direct deployment without the factory:

ContinuousClearingAuction auction = new ContinuousClearingAuction(
    token,
    totalSupply,
    currency,
    startBlock,
    endBlock,
    floorPrice,
    tickSpacing,
    supplySchedule,
    recipients
);

Verification on Block Explorers

# Verify on Etherscan/Basescan
forge verify-contract \
  $AUCTION_ADDRESS \
  src/ContinuousClearingAuction.sol:ContinuousClearingAuction \
  --chain-id CHAIN_ID \
  --etherscan-api-key $ETHERSCAN_API_KEY

Post-Deployment: Activate the Auction

After deployment, the token issuer must transfer tokens to the auction contract:

# Transfer tokens to auction contract
cast send $TOKEN_ADDRESS \
  "transfer(address,uint256)" \
  $AUCTION_ADDRESS \
  $TOTAL_SUPPLY \
  --rpc-url $RPC_URL \
  --account deployer

The auction activates automatically when tokens are received (via onTokensReceived() callback).

Validation Rules

Run this checklist before deployment:

1. startBlock > current block number
2. endBlock > startBlock
3. endBlock - startBlock == supplySchedule.length
4. floorPrice > 0
5. floorPrice is a multiple of tickSpacing
6. tickSpacing > 0 and < floorPrice
7. totalSupply > 0 (in wei)
8. token is a valid ERC-20 contract
9. currency is zero address (ETH) or valid ERC-20
10. Recipient addresses are valid and non-zero
11. Recipient percentages sum to 100%
12. Deployer has enough ETH for gas
13. Token supply is minted and available for transfer

Technical Overview

Q96 Fixed-Point Math

All prices use Q96 format: value = human_price * 2^96

Q96 = 2 ** 96  # = 79228162514264337593543950336

# Convert human price to Q96
q96_price = int(human_price * Q96)

# Convert Q96 back to human price
human_price = q96_price / Q96

Auction Steps (Supply Issuance)

Each block in [startBlock, endBlock) is one auction step. The supply schedule determines what fraction of totalSupply is available at each step.

Key Contract Functions

Supported Chains

Troubleshooting

Common Issues

Validation Checklist

Before broadcasting, always simulate first:

forge script script/DeployAuction.s.sol \
  --rpc-url $RPC_URL \
  --account deployer
  # No --broadcast flag = simulation only

Additional Resources

• CCA Repository
• Uniswap CCA Docs
• CCA Configurator Skill — Configure parameters before deploying
• Foundry Book — Forge and cast documentation