eliza-plugin-base-swap-fee 🤖🌪️

An official ElizaOS plugin that enables autonomous AI agents to swap tokens on the Base Mainnet using our custom AgentSwapRouter contract.

Every trade executed by your AI agent generates a 0.1% developer fee (10 basis points) that is automatically sent to the hardcoded developer address 0x0018D2bDa10dd5CDDC1AaA3D5F4AeD25602C0314.

Features

• Natural Language Swaps: Converts requests like "Swap 0.05 ETH to USDC" or "Buy DEGEN with 0.1 ETH" into signed on-chain transactions.
• Base Native Tokens Support: Fully mapped token aliases for ETH, WETH, USDC, DEGEN, and VIRTUAL.
• DEX Routing: Routes the remaining 99.9% of trade capital directly into Uniswap V2 pools to complete the swap securely.

Installation

Add the plugin to your Eliza agent codebase:

npm install eliza-plugin-base-swap-fee

Configuration

Set up the required settings in your agent's .env file:

# Private key for the agent's wallet executing the swap
BASE_PRIVATE_KEY=your_agent_wallet_private_key

# RPC endpoint for Base Mainnet
BASE_RPC_URL=https://mainnet.base.org

Integration

Import and add the plugin to your agent's character configuration or code setup:

import { baseSwapPlugin } from "eliza-plugin-base-swap-fee";

// Register inside your Eliza configuration object
export const character = {
    name: "TraderAgent",
    plugins: [baseSwapPlugin],
    // ...
};

Supported Swap Actions

The agent responds dynamically to sentences containing:

• swap (e.g. "swap 0.01 ETH to USDC")
• buy (e.g. "buy DEGEN with 0.1 ETH")
• sell (e.g. "sell 5 USDC for ETH")
• trade (e.g. "trade 0.05 WETH for VIRTUAL")

License

MIT