Basecatbot Documentation
Welcome to the technical documentation for Basecatbot — the autonomous AI cat agent, terminal runtime, and telemetry ecosystem native to Base Chain.
What is Basecatbot?
Basecatbot is an on-chain AI agent protocol designed specifically for Base Layer-2. It provides autonomous agent execution, sub-second DEX & transaction telemetry, and a developer-first SDK to deploy and interact with decentralized AI bots seamlessly.
Agent Architecture Overview
Basecatbot operates through a modular 4-tier architecture designed for sub-second on-chain AI workflows:
Base RPC Telemetry
Listens directly to Base Sequencer block events, pending mempool transactions, and Aerodrome/Uniswap swaps in <10ms.
Autonomous Decision Engine
Processes on-chain conditions, arbitrage triggers, whale alerts, and risk telemetry through localized agent scripts.
Base L2 Contract Calls
Executes gas-optimized smart contract calls, swaps, or state updates with optimistic rollup finality.
Social & Telegram Relay
Streams telemetry updates to @basecatbot channels, Web3 webhooks, and decentralized terminal clients.
Quickstart Guide
Get started interacting with the Basecatbot ecosystem in minutes.
Step 1: Install the CLI / SDK
npm install -g @basecatbot/cliStep 2: Initialize Your Agent Workspace
basecatbot init --network=baseStep 3: Run Interactive Telemetry
basecatbot scan --dex=aerodromeBasecatbot TypeScript SDK
Define modular autonomous AI agent routines using our lightweight SDK.
import { defineAgent } from '@basecatbot/sdk'
export default defineAgent({
name: 'base-cat-sentinel',
network: 'base-mainnet',
chainId: 8453,
triggers: {
onBlockMined: true,
onDexSwap: ['Aerodrome', 'UniswapV3'],
},
async onDexSwap({ pair, amountUsd }, ctx) {
ctx.log(`🐾 Cat Agent detected swap on ${pair}: $${amountUsd}`)
}
})CLI Terminal & Commands
The Basecatbot terminal provides direct command-line access to on-chain telemetry, DEX pool monitoring, and AI agent routines.
Base Chain Infrastructure
Coinbase Base (Chain ID: 8453)
Base is an Ethereum Layer 2 (L2) incubated by Coinbase offering ultra-low transaction fees (~0.002 gwei) and instant block finality, making it the ideal host for high-frequency AI bot swarms and telemetry.
Token Roadmap ($BASECAT)
The official $BASECAT token has not launched yet. There is currently no active token address or public trading pair. Be cautious of unofficial copycat contracts or fake presales.
Community & Official Links
Join the community and follow official updates regarding the Basecatbot protocol and upcoming milestones.