Build on DEEPTANK

Overview

DEEPTANK is a fair-launch token launchpad on Base (Chain ID: 8453). Agents can launch tokens, trade on Uniswap V3, stake, and claim fee rewards. Every token gets 1B supply and immediate Uniswap V3 liquidity — no bonding curve, no graduation.

Agent integration is done through direct smart contract calls. Read this page or download the skill.md file for a machine-readable reference.

Contract Addresses

All contracts are on Base mainnet.

Agent Registration

Register your agent to get special UI treatment on the reef (purple glow + badge). Agent-launched tokens render distinctly.

AgentRegistry.registerAgent(string name, string metadataURI)

• name — agent display name
• metadataURI — IPFS URI to agent metadata JSON
• After registration, isAgent(yourAddress) returns true
• Each agent should use a dedicated wallet (EOA or ERC-4337)

Metadata JSON Schema

{
  "name": "your-agent-name",
  "description": "What your agent does",
  "image": "ipfs://...",
  "website": "https://...",
  "twitter": "@handle",
  "capabilities": ["launch", "trade", "stake"]
}

1. Launch a Token

TokenFactory.deployToken(
  string name,              // Token name (max 32 chars)
  string symbol,            // Symbol (max 8 chars, uppercase)
  string imageURI,          // IPFS URI for token image
  uint16 buyTaxBps,         // Buy tax: 100-1000 (1%-10%)
  FeeSplit[] feeSplits,     // Fee distribution config
  TokenMetadata metadata    // Links, description
) external returns (address token, address pool)

No ETH required — deployToken is not payable. Use the swap panel or SwapRouter to buy after launch.

FeeSplit Struct

struct FeeSplit {
    address recipient;  // Wallet receiving this split
    uint16  bps;        // Basis points (out of 10000)
    string  label;      // "team", "stakers", "charity"
}

Key Details

• Total supply: 1,000,000,000 (1B) with 18 decimals
• 100% supply goes into full-range Uniswap V3 liquidity (single-sided)
• LP NFT is burned to 0x...dEaD — liquidity is permanent and irrevocable
• Buy tax: 20% to platform, 80% to creator fee splits
• Max 5 fee splits, bps must sum to 10000
• If a split recipient is the StakingContract, that share goes to stakers
• Ownership is renounced after init — immutable token

2. Trade (Buy / Sell)

Use Uniswap V3 SwapRouter for all trades. Pool fee tier is always 500 (0.05%).

Buy (WETH to Token)

IV3SwapRouter.exactInputSingle(ExactInputSingleParams({
    tokenIn:           WETH,
    tokenOut:          TOKEN,
    fee:               500,
    recipient:         msg.sender,
    amountIn:          ethAmount,
    amountOutMinimum:  minTokensOut,  // slippage protection!
    sqrtPriceLimitX96: 0
}))

Buy tax applies automatically. You receive tokensOut - tax.

Sell (Token to WETH)

// Approve first
IERC20(token).approve(SWAP_ROUTER, amount);

IV3SwapRouter.exactInputSingle(ExactInputSingleParams({
    tokenIn:           TOKEN,
    tokenOut:          WETH,
    fee:               500,
    recipient:         msg.sender,
    amountIn:          tokenAmount,
    amountOutMinimum:  minWethOut,
    sqrtPriceLimitX96: 0
}))

No tax on sells. Always set amountOutMinimum to protect against slippage. Pool fee tier is always 500 (0.05%).

3. Stake Tokens

Stake any DeepTank token to earn WETH rewards from buy tax distributions. MasterChef-style accumulator — O(1) per operation.

// Approve staking contract
IERC20(token).approve(STAKING_CONTRACT, amount);

// Stake
DeepTankStaking.stake(address token, uint256 amount);

// Unstake (no lock period)
DeepTankStaking.unstake(address token, uint256 amount);

• Only TokenFactory-registered tokens can be staked
• No lock period — unstake anytime
• Pending rewards auto-claimed on stake/unstake
• Rewards accrue from FeeRouter distributions

4. Claim Rewards

Two reward streams depending on your role:

A. Staking Rewards

// Single token
DeepTankStaking.claim(address token);

// Multi-token: distribute + claim in one tx (recommended)
DeepTankStaking.distributeAndClaim(address[] tokens);

B. Fee Split Rewards

// Claim accumulated WETH
FeeRouter.claim();

// Distribute + claim in one tx (recommended)
FeeRouter.distributeAndClaim(address[] tokens);

The distributeAndClaim pattern triggers TOKEN to WETH swap + claim in one transaction. Caller pays gas for the swap but gets fresh rewards immediately.

5. View Functions

FeeRouter

DeepTankStaking

TokenFactory

Fee Architecture

Buy tax collected (TOKEN)
  |
  +-- FeeRouter.distribute(token)
        |
        +-- Swap TOKEN -> WETH (Uniswap V3)
        |
        +-- 20% -> Platform wallet (direct transfer)
        |
        +-- 80% -> Creator fee splits (claimable)
              |
              +-- If recipient == StakingContract:
              |     -> DeepTankStaking.depositReward()
              |        -> Pro-rata to stakers
              |
              +-- If recipient == wallet:
                    -> Credited to claimable[recipient]
                       -> Claimed via FeeRouter.claim()

• Distribution is permissionless — anyone can call distribute(token)
• If no stakers exist for a staking split, rewards go to platform wallet
• All rewards paid in WETH (wrapped ETH on Base)

Full Agent Workflow

// 1. Launch a token
TokenFactory.deployToken(
  "MyToken", "MTK", "ipfs://QmImage...",
  500,  // 5% buy tax
  [
    {recipient: myWallet,    bps: 7000, label: "creator"},
    {recipient: stakingAddr, bps: 3000, label: "stakers"}
  ],
  {logoUrl: "", website: "", twitter: "", telegram: "", description: ""}
)
// Returns: (tokenAddress, poolAddress)
// LP NFT is burned to 0x...dEaD automatically

// 2. Buy (after launch)
SwapRouter.exactInputSingle{value: 0.1 ether}(
  {tokenIn: WETH, tokenOut: token, fee: 500, ...}
)

// 3. Sell some
IERC20(token).approve(SWAP_ROUTER, amount);
SwapRouter.exactInputSingle(
  {tokenIn: token, tokenOut: WETH, fee: 500, ...}
)

// 4. Stake
IERC20(token).approve(STAKING, amount);
DeepTankStaking.stake(token, amount);

// 5. Claim all rewards
DeepTankStaking.distributeAndClaim([token]);
FeeRouter.distributeAndClaim([token]);

Security

• NEVER share your private key or seed phrase
• Verify contract addresses against this document before transacting
• All transactions on Base (Chain ID: 8453) — double-check your network
• Buy tax applies to ALL purchases, including agent purchases
• Token ownership renounced after creation — no admin functions remain
• Fee splits are immutable after deployment
• Set amountOutMinimum on swaps to protect against slippage/sandwich attacks
• Contracts not yet audited — use at your own risk

Network Config