Clanker Fee Burn Skill

Purpose: Automated end-to-end Clanker fee claim → rebalance → burn → treasury pipeline.

What It Does

Executes a complete burn cycle for Clanker tokens in one command:

1. Claims fees — WETH + token from Clanker fee contract
2. Gets prices — WETH from CoinGecko, token from DexScreener
3. Rebalances — Swaps only the value difference to reach 50/50 WETH/token split
4. Burns tokens — Sends ALL token balance to 0xdead
5. Treasury split — Swaps remaining WETH 50/50 into USDC + BNKR, sends to treasury
6. Reports — JSON output with full pipeline results

Usage

Basic Command

node burn.mjs \
  --token 0xf3ce5ddaab6c133f9875a4a46c55cf0b58111b07 \
  --treasury 0x19fe674a83e98c44ad4c2172e006c542b8e8fe08

With Custom Pool Parameters

node burn.mjs \
  --token 0xf3ce5ddaab6c133f9875a4a46c55cf0b58111b07 \
  --treasury 0x19fe674a83e98c44ad4c2172e006c542b8e8fe08 \
  --hooks 0xCustomHooksAddress \
  --fee 0x800000 \
  --tick-spacing 200

Dry Run (Simulate)

node burn.mjs \
  --token 0xf3ce5ddaab6c133f9875a4a46c55cf0b58111b07 \
  --treasury 0x19fe674a83e98c44ad4c2172e006c542b8e8fe08 \
  --dry-run

CLI Flags

Environment Variables

NET_PRIVATE_KEY=0x...     # Wallet private key
BASE_RPC_URL=https://...  # Base RPC endpoint (optional)

Output

Prints a JSON report with:

{
  "fees_claimed": {
    "weth": "0.05",
    "token": "1000000",
    "weth_usd": "125.50",
    "token_usd": "50.25"
  },
  "rebalance": {
    "swapped_amount": "0.015",
    "direction": "WETH→TOKEN",
    "tx_hash": "0x..."
  },
  "burned": {
    "amount": "1050000",
    "tx_hash": "0x..."
  },
  "treasury": {
    "usdc_amount": "62.75",
    "usdc_tx": "0x...",
    "bnkr_amount": "1250.50",
    "bnkr_tx": "0x..."
  },
  "total_burned_to_date": "5000000000",
  "burn_percentage": "5.0000%"
}

Error Handling

• Stops immediately if any step fails
• Prints what succeeded and what failed
• Never continues to burn if rebalance failed
• Never continues to treasury if burn failed
• Use --dry-run to test before live execution

Critical Rules

⚠️ DO NOT:

• Convert fee tokens to WETH/USDC first — keep them and top up
• Convert everything to USDC as intermediate
• Swap more than the value difference

✅ DO:

• Only swap the small gap to reach 50/50 value
• Burn creates buy pressure (small swap) + removes supply
• Always test with --dry-run first

When to Use

Regular burn cycles:

# Every week/month, claim fees and execute burn
node burn.mjs --token 0x... --treasury 0x...

Pre-flight check:

# Always dry-run first to verify amounts
node burn.mjs --token 0x... --treasury 0x... --dry-run

Agent Instructions

When asked to "burn Clanker fees" or "run burn cycle":

1. Verify environment — Check NET_PRIVATE_KEY is set
2. Dry run first — Always simulate before live execution
3. Review output — Check amounts make sense
4. Execute live — Remove --dry-run flag
5. Report results — Share JSON output with human

Example Agent Flow

# Step 1: Dry run
cd /Users/melted/Github/axiom-public/agent-skills/skills/clanker-burn
node burn.mjs --token 0xf3ce... --treasury 0x19fe... --dry-run

# Step 2: Review output, confirm with human

# Step 3: Execute live
node burn.mjs --token 0xf3ce... --treasury 0x19fe...

# Step 4: Share report JSON

Dependencies

• viem — Ethereum interactions
• yargs — CLI parsing
• @ethersproject/abi — ABI encoding for V4 swaps

Install:

npm install viem yargs @ethersproject/abi

Contracts Used

Troubleshooting

"No fees to claim"

• No fees available yet — wait for more volume

"V4 swap reverted"

• Check pool parameters (currency0, hooks, fee, tick-spacing)
• Verify pool has liquidity

"Insufficient balance"

• Fees were lower than expected — check claimed amounts

Approvals failing

• RPC issue — wait and retry
• Gas too low — increase gas limit

Safety

• Uses --dry-run for safe testing
• Only burns tokens AFTER successful rebalance
• Only sends to treasury AFTER successful burn
• All steps logged with transaction hashes
• No destructive actions without confirmation in dry-run mode