How signing works
Wallet connection and account management run through Para. Signing still happens locally in your connected wallet through wagmi-compatible connectors. Aomi constructs and proposes transactions; your wallet signs them. The private key never leaves your device.Simulation: the safety guardrail
Before any transaction reaches your wallet, Aomi simulates it on a forked network. This is a deliberate guardrail for AI-generated transactions: the model cannot send anything to your wallet without first passing through simulation. It runs in four steps:- Aomi forks the current network state with Anvil.
- The transaction runs against the fork, not the real chain.
- The exact outcome is captured: token balance changes, gas cost, and every contract call.
- The result is shown to you before you are asked to sign.
Authorized and agentic signing
Aomi supports authorized signing, so an agent can act for a user within the limits the App sets. The wallet still signs locally and the simulate step still runs first. The non-custodial guarantee does not change: Aomi never holds keys.Supported chains
Simulation and transaction execution are supported on Ethereum Mainnet, Base, Arbitrum One, and the major testnets such as Sepolia. You choose which chains your frontend exposes when you configure the wallet providers below.Wallet setup
Aomi widgets use the Para plus wagmi provider tree. If you installed the widget throughnpx shadcn add https://aomi.dev/r/aomi-frame.json, the wallet UI is already included. Use this setup when you want to wire Para-based auth and external wallets in your own host app.
useSwitchChain. The widget’s auth bridge syncs the change to the Aomi runtime automatically; you can also set it manually with setUser({ chainId }) from @aomi-labs/react.
Wire it into your app
The setup above is the wallet layer. The pieces that consume it, the connect button, the transaction and EIP-712 request handler, and the wallet utilities, live in the frontend guides:Widget installation
Drop in
<AomiFrame /> with the wallet UI and the ConnectButton already wired.Headless library
Handle transaction and EIP-712 requests, and use the wallet utilities, in a fully custom interface.
Next Steps
- What is Aomi?: understand Apps and API keys
- Security: the full safety model and threat model
- Simulation Reference: the technical deep dive on simulation