Frequently Asked Questions
General
What is AgentaOS?
The financial OS for the agent economy. AgentaOS gives AI agents sovereign accounts — their own Ethereum addresses where the private key never exists. Agents can transact autonomously under human-set guardrails, accept payments, and hire other agents. Three shares. Any 2 sign. The key never materializes.
Is this custodial?
No. No third party holds your keys or shares. AgentaOS gives each agent a sovereign account — the private key never exists, and no single party can access your funds.
How much does it cost?
Free to start on the managed plan at app.agentaos.ai. No license fees, no per-transaction charges, no usage limits. The open-source SDK is available on GitHub.
How is this different from a multisig?
Multisig (like Gnosis Safe) is a smart contract — it lives on-chain, costs gas for every signature, and works on one chain at a time. Agenta is off-chain threshold signing. Same Ethereum address works on every EVM chain. No extra gas. No on-chain setup.
How is this different from Fireblocks or Privy?
Fireblocks charges 50k−500k/yr and you trust their infrastructure. Privy embeds wallets but they hold keys on your behalf. AgentaOS is free to start and open source. No vendor lock-in. No custody risk. Your agents get sovereign accounts where the private key never exists.
What chains does Agenta support?
Any EVM chain. Ethereum, Base, Arbitrum, Optimism, Polygon, and all their testnets. Bitcoin and Solana support is planned. See Supported Networks.
Security
What happens if my server gets hacked?
The attacker gets one share (the server share). One share alone cannot sign anything. You still have the signer share and user share. Revoke the compromised signer, spin up a new one, move your funds.
What happens if I lose a share?
Any 2 of 3 shares can still sign. Lose the signer share? Use User + Server from the dashboard. Server down? Use Signer + User offline. Losing one share does not lock your funds.
Can the server see my private key?
No. The private key never exists — not on the server, not on your machine, not anywhere. The server holds one share and participates in a signing protocol. It never learns the other shares or the full key.
What if someone steals my .secret file?
The .secret file contains one share, encrypted with your passphrase. Without the passphrase, it’s useless. Even with the passphrase, one share alone cannot sign. The attacker would also need access to the server share or user share.
Is the cryptography audited?
The signing protocol (CGGMP24) is implemented by the LFDT-Lockness/cggmp21 Rust crate, which is MIT/Apache 2.0 licensed. The protocol is based on a published, peer-reviewed paper with formal security proofs.
Technical
What is the signing latency?
Under 500ms for Signer + Server signing on a local network. The protocol runs 2-3 rounds over HTTPS.
Do I need Docker?
No. The managed platform at app.agentaos.ai handles everything. For the CLI and SDK, just npm install -g agentaos.
Can I use Agenta with Hardhat or Foundry?
Yes. The agenta proxy command starts a local JSON-RPC proxy. Point Foundry or Hardhat at it. See Foundry Integration.
Can I use Agenta with AI frameworks?
Yes. Agenta has integrations for:
- Vercel AI SDK — use as a tool in
generateText()
- LangChain — use as a
DynamicStructuredTool
- MCP — expose signing to Claude, Cursor, or any MCP client
See SDK and MCP Server.
What happens when the server restarts?
Signing sessions are stateful. If the server restarts mid-signing, the session is lost and the client retries. Shares stored in Vault persist across restarts. No data is lost.
In development mode, Vault stores data in memory. A Vault restart wipes all server shares. Use persistent storage in production.
Can I run multiple signers?
Yes. Each signer is an independent identity with its own Ethereum address, its own shares, and its own guardrails. Create as many as you need.