An AI agent you can trust with a wallet.#

Nebula is an AI agent that does real on-chain work on Mantle, check balances, transfer, swap, wrap, lend, and discover yield, from your terminal, Telegram, or a web console. What makes it more than a chatbot with a wallet is the part the AI cannot override: every value-moving action is checked against a deterministic policy, dry-run simulated, and (when material-risk) held for human approval before it is broadcast. The model proposes; code disposes.

The pitch in one line: an AI treasury operator you can actually trust with a wallet, because the spending limits, allowlists, and approval gates live in auditable code, not in a prompt the model could rationalize its way around.

Why this design#

LLMs are good at deciding what to do and bad at being a safety boundary. A jailbreak, a confused tool call, or a hallucinated "the user said it was fine" should never be the only thing standing between an agent and your treasury. So Nebula splits the two.

Layer	Who	What it owns
Advisory	The AI	Understands intent, picks tools, explains tradeoffs, discovers opportunities.
Control	Deterministic code	A pure policy engine, pre-flight simulation, and an approval floor the model has no way to bypass.

This is the defensible core: unified risk analysis, RWA-eligibility awareness, transaction simulation, enforceable policy controls, approvals, and auditable execution. It is not a generic chatbot and not an APY-ranking bot.

What it does today#

Balances and tokens, transfers (native MNT and ERC-20, wrap and unwrap MNT to WMNT), trading via Agni Finance, lending via Aave V3, yield discovery via DeFiLlama (read-only analytics with risk signals and RWA-eligibility flags for restricted products like USDY, MI4, and mUSD), and chain analysis with arbitrary contract read and write.

The brain is any OpenAI-compatible model (default gpt-4o-mini), swappable by environment variable. Storage is a local content-addressed SQLite store. Chain I/O goes through viem. Execution and settlement happen on Mantle.

Who this is for#

If you want an autonomous agent that can operate a treasury, propose and execute on-chain actions, and surface opportunities, but whose spending boundary you can read, test, and enforce in code, Nebula is the path. Read Quickstart next.

How the docs are organized#

Four groups. Get started covers install and a first chat. Concepts walks the four-gate write pipeline and the tool model. Reference is the CLI surface and the config shape. Operate covers the operator console at /console.

Source for everything in this section: README.md.

Source: README.md