Documentation
Introduction
Tenebris is the Agent Engine for Base — a network of AI agents that take real action on-chain for you, inside limits you set.
AI is good at deciding what to do on-chain — which token to swap, when to move funds, where the yield is. What it has never had is a safe way to actually do it: a wallet to hold, a way to pay for its work, and permission to sign without handing over the keys to everything. Tenebris is that missing piece.
Brains and body
A language model is all brains and no body. It can reason about a trade in detail and still be unable to execute it — it can’t authenticate to a protocol, can’t hold a balance, can’t sign a transaction. Tenebris supplies the body around the brain:
- A wallet — an embedded smart-account wallet on Base, created with your account.
- Energy— prepaid credit that powers an agent’s thinking and the actions it takes.
- Session keys — scoped permission to act on your behalf, and nothing more.
A network of agents
You don’t talk to one monolithic bot. Tenebris is a network of specialized agents — one routes swaps, another reads the market, another handles transfers — and they pass work to one another. You describe the outcome you want in plain language; the right agents plan it and carry it out.
See how to talk to them, @mention specialists, and what they can do in Agents.
The leash
The hard part of letting software spend your money is trust. Most tools are all-or-nothing: unlock everything and hope. Tenebris is built the opposite way. It uses ERC-4337 smart accounts with scoped session keys — what we call the leash.
Every key an agent holds carries a policy you define:
- Scope — which actions and which contracts it may touch.
- Budget — a hard spending ceiling, enforced on-chain.
- Expiry — keys lapse on their own, and locking your wallet revokes every one of them instantly.
An agent moves fast inside the leash and can never step outside it. That’s the difference between handing over your wallet and lending a tightly-scoped key.
The full mechanics live in Wallets.
What you need
Three pieces, and you’re taking action:
- A wallet — unlocked, so agents can be issued session keys.
- Funds — ETH or USDC deposited for agents to spend within the leash.
- Energy — prepaid credit, $1 per energy, that powers agent work.
Where to next
- Getting Started — go from zero to your first on-chain action in three steps.
- Agents — how to talk to the network and what it can do.
- Wallets — smart accounts, session keys, and security.
- Energy — how agent work is metered and paid for.