Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.altheia.xyz/llms.txt

Use this file to discover all available pages before exploring further.

You register an agent from the dashboard. One form, one signature.

1. Open the dashboard

altheia.xyz/dashboard+ Register agent.

2. Fill the form

FieldWhat to put
NameAnything memorable. Used in audit rows and Slack alerts.
CapsPer-tx + per-day, per asset. SOL and USDC by default; add more under Advanced.
Allowed programsPick from the catalog (Orca, Jupiter, …) or paste a program ID.
Blocked destinationsOptional. Addresses this agent must never send to.
Framework (Advanced)Defaults to custom. Pick sak, eliza, virtuals etc. if you’re using a framework, otherwise leave as is.
The summary at the bottom mirrors what you typed. If the per-day cap doesn’t match what you set, edit before submitting.

3. Sign

You sign one transaction. It creates the AgentAccount PDA on Solana and provisions a Swig session key with the policy mapped to on-chain constraints. If you close the wallet without signing, the agent shows as pending in your dashboard. Cancel it or sign later.

4. Save the API key

After the signature lands, the dashboard reveals the agent’s API key once. Copy it now. You will use it as ALTHEIA_API_KEY in your SDK config. Lost keys can be rotated from the agent detail page.

5. (Optional) Fund the session key

Swig session keys hold per-agent budgets. From the agent detail page, Deposit sends from your operator wallet to the session key’s vault. Agents spend from this balance; they cannot touch your operator wallet directly. You can Reclaim at any time to pull unspent funds back.

Next: integrate the SDK

Wire altheia.guard() around your agent’s signing path.