Alignment Skill

Private-key-free Clanker fee burn pipeline using Bankr API.

What This Does

The Alignment skill runs the complete Clanker fee burn pipeline for ANY agent with a Bankr API key. No private keys needed — all transactions are signed and submitted via Bankr's secure API.

The Pipeline (Exact Order)

1. Claim Fees — Two separate TXs to Clanker fee contract: one for WETH, one for the token
2. Price Assets — WETH from CoinGecko, token from DexScreener
3. Rebalance 50/50 — Only swap the VALUE difference (e.g. $1100 WETH + $1000 token → swap $50 WETH→token)
4. Burn ALL Tokens — Transfer entire token balance to 0x000...dEaD
5. Split Remaining WETH — 50% → USDC, 50% → BNKR, send both to treasury
6. Report — JSON output with all transaction details

Critical Rules

• NEVER convert fee tokens to WETH/USDC first — keep them, top up
• NEVER convert everything to USDC — only swap the gap
• The rebalance swap is SMALL — only the value difference
• Burn creates buy pressure (small swap) + removes supply
• 50/50 by VALUE, not by amount

Usage

Basic Run

node alignment.mjs \
  --token 0xf3ce5ddaab6c133f9875a4a46c55cf0b58111b07 \
  --treasury 0x19fe674a83e98c44ad4c2172e006c542b8e8fe08 \
  --bankr-key YOUR_API_KEY

Environment Variable

export BANKR_API_KEY=your_key_here
node alignment.mjs --token 0x... --treasury 0x...

Dry Run (Simulation)

node alignment.mjs \
  --token 0x... \
  --treasury 0x... \
  --bankr-key YOUR_API_KEY \
  --dry-run

Custom Pool Parameters

node alignment.mjs \
  --token 0x... \
  --treasury 0x... \
  --bankr-key YOUR_API_KEY \
  --hooks 0xCustomHooksAddress \
  --fee 0x1000000 \
  --tick-spacing 100

Arguments

Argument	Required	Default	Description
--token	✅	-	Token address (Clanker token)
--treasury	✅	-	Treasury address for USDC+BNKR
--bankr-key	✅*	BANKR_API_KEY env	Bankr API key
--currency0	❌	WETH	V4 pool currency0
--fee	❌	0x800000	V4 pool fee
--tick-spacing	❌	200	V4 pool tick spacing
--hooks	❌	0xb429...	V4 pool hooks address
--dry-run	❌	false	Simulate without transactions

*Required unless set as environment variable

Key Innovation

This skill requires NO private keys. Any agent with a Bankr API key can run the alignment pipeline for their Clanker tokens. The Bankr wallet signs and submits all transactions via secure API.

Bankr API Integration

Getting Wallet Address

The skill automatically gets your wallet address from Bankr's sign endpoint at startup.

Transaction Submission

All on-chain operations go through Bankr's /agent/submit endpoint with:

• Transaction data encoding
• Human-readable descriptions
• Automatic confirmation waiting
• Error handling and retries

Supported Chains

• Base (chainId: 8453) — primary chain for Clanker tokens

Contract Addresses (Base)

Contract	Address
Clanker Fee	0xf3622742b1e446d92e45e22923ef11c2fcd55d68
WETH	0x4200000000000000000000000000000000000006
USDC	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
BNKR	0x22aF33FE49fD1Fa80c7149773dDe5890D3c76F3b
SwapRouter02	0x2626664c2603336E57B271c5C0b26F421741e481
Universal Router	0x6ff5693b99212da76ad316178a184ab56d299b43
Dead Address	0x000000000000000000000000000000000000dEaD

Output Example

{
  "fees_claimed": {
    "weth": "0.0521",
    "token": "15420.531",
    "weth_usd": "126.43",
    "token_usd": "123.18"
  },
  "rebalance": {
    "swapped_amount": "0.0067",
    "direction": "WETH→TOKEN",
    "tx_hash": "0x..."
  },
  "burned": {
    "amount": "16089.442",
    "tx_hash": "0x..."
  },
  "treasury": {
    "usdc_amount": "62.15",
    "usdc_tx": "0x...",
    "bnkr_amount": "1847.32",
    "bnkr_tx": "0x..."
  },
  "total_burned_to_date": "8420691.331",
  "burn_percentage": "8.4207%"
}

Error Handling

• No fees available: Exits gracefully with clear message
• Network issues: Automatic retries with exponential backoff
• Bankr API errors: Detailed error messages with response codes
• Price feed failures: Fallback to alternative sources
• Transaction failures: Full transaction hash and error details

Security

• No private key storage — uses Bankr's secure signing
• Read-only RPC — uses public Base RPC for blockchain reads
• Input validation — validates all addresses and amounts
• Dry-run mode — test before executing real transactions

Wrapper Script

Use the included wrapper script for easy configuration:

./scripts/alignment.sh --token 0x... --treasury 0x...

The wrapper sources your config and handles environment setup automatically.