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.
| Symptom | Cause and fix |
|---|---|
| Agent office panel is grey | The pixel office isn't running. cd apps/office && npm run office |
| x402 payments fail | Gateway 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 gas | The operator account is out of CSPR. Send it more — it spends ~8 per execution |
| Signature rejected on settle | CEP18_TOKEN_NAME must match the token's on-chain name exactly |
| Wallet won't connect on mobile | Browser extensions don't exist on mobile. Use your wallet's in-app browser, or the CLI |