Documentation

Common questions

Can I have more than one vault?

Yes. Every deploy creates a new, independent contract that you own. One thing to know: the shortcut name in your account (user_vault_package_hash) points at the most recent one, so if you deploy again you will need the older vault's address from your transaction history to reach it. The funds in it stay yours either way.

If I revoke the agent, what happens to my money?

Nothing. Revoking only removes the agent's permission to call execute_strategy. Your balance is untouched, withdrawing still works exactly as before, and you can grant the permission again later if you want to.

Does signing my policy cost gas?

No. That signature is stored off-chain — it tells the swarm which limits you chose. The limits that actually stop a trade live in your vault contract, and you set those on-chain with set-policy.

SymptomCause and fix
Agent office panel is greyThe pixel office isn't running. cd apps/office && npm run office
x402 payments failGateway port mismatch. Check GATEWAY in ahq-config.js matches PORT in .env
"Named key not found"A contract isn't deployed in your account. Deploy it, or set RECORDER_DISABLED=1
Executions fail on gasThe operator account is out of CSPR. Send it more — it spends ~8 per execution
Signature rejected on settleCEP18_TOKEN_NAME must match the token's on-chain name exactly
Wallet won't connect on mobileBrowser extensions don't exist on mobile. Use your wallet's in-app browser, or the CLI
Still stuck? Ask the support agent — it knows this system — or send a ticket and a human will reply.