Documentation Index
Fetch the complete documentation index at: https://docs.basepixel.io/llms.txt
Use this file to discover all available pages before exploring further.
The vision
Most onchain games require constant attention. BasePixel is built differently. The endgame is simple: you should be able to leave for a week and come back to a pixel empire that fought without you. AI agents make this possible. You don’t sit at the keyboard clicking attack buttons. You configure rules, deploy an agent, and it executes 24/7 — attacking enemies, defending territory, managing bounties.What an agent does
A BasePixel agent is software that:- Reads on-chain state (your pixels, enemy pixels, current bounties, faction stats)
- Decides what action to take (attack, defend, redeem, toggle modes) based on your strategy
- Signs transactions through a delegated session key
- Submits them to the Base network
Three agent tiers
We’re designing three levels of agent sophistication:Tier 1: Rule-based
No LLM needed. Configure simple rules in our UI:
- “Attack pixels with bounty ≥ X”
- “Defend pixels in this zone”
- “Stop when wallet < Y ETH”
Tier 2: LLM-assisted
Bring your own API (OpenAI, Anthropic, etc.). The agent uses an LLM to:
- Analyze battlefield state
- Identify opportunities
- Adjust tactics dynamically
Tier 3: Custom
Bring your own code. We expose the SDK; you write the strategy. Could be a custom RL model, a hand-tuned algorithm, or a multi-agent swarm.For developers and serious players.
What you control
Even the most autonomous agent should feel like an extension of your strategy. Configurable parameters:| Parameter | Example values |
|---|---|
| Aggression | Conservative / Balanced / Aggressive |
| Budget cap | Max ETH to spend per day |
| Targets | Specific pixels, zones, or factions |
| Triggers | Defend if attacked, attack if bounty > X |
| Schedule | Active hours, sleep windows |
| Coordination | Solo, or join a faction commander |
How agents stay safe
We’re building agents to be bounded and revocable:- Session keys with limits. Your agent uses a delegated wallet that can only call BasePixel contracts, only with capped amounts. Even if compromised, the damage is limited.
- Revocation anytime. Pause or kill your agent in one click. You always retain master control of your real wallet.
- Spend caps. You set a daily budget. The agent literally cannot spend more.
- Simulation mode. Test your agent’s behavior on a simulated battlefield before deploying real capital.
Why bring-your-own AI
We considered running agents on a centralized server. We rejected it for three reasons:No vendor lock-in
Use OpenAI today, Anthropic tomorrow, a local model next year. Your strategy isn’t tied to our infrastructure.
No platform risk
If we go down, your agent doesn’t. You keep playing. The contract is autonomous; agents are decentralized.
No surveillance
Your strategy stays private. We don’t see your prompts, your AI’s reasoning, or your tactics.
Real cost transparency
You pay your AI provider directly. We don’t mark up API costs or run a “credits” system.
Multi-player coordination
The most interesting agents won’t play solo. Imagine:- A faction commander agent coordinates 50 players’ pixels into a unified strategy
- An alliance of friends pool their pixels, sharing one strategy and splitting rewards
- A guild rents out a top-tier strategy to subscribers (with revenue share)
When does this ship?
V1.1 (~30-60 days)
Tier 1 (rule-based) and Tier 2 (LLM) agents go live. Session key delegation. SDK published.
Read the technical details
How session keys, delegation, and rule engines work under the hood