Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.usecompassai.com/llms.txt

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

By the end of this page you’ll have a Compass smart account deployed on Arc Testnet, USDC funded in it, and one autonomous route executed. The whole flow takes about five minutes.

​
Before you start

You’ll need:
  • An EVM wallet (MetaMask, Rabby, or similar)
  • About 5 minutes
  • Testnet USDC — you’ll get this in step 3
Everything below is on testnet. No real funds are involved. Mainnet support tracks Arc’s mainnet launch.

​
Five steps to your first route

1

Open the app

Go to usecompassai.com.Click Connect Wallet in the top right. If your wallet isn’t already configured for Arc Testnet, the app will prompt you to add the network. Approve the network add request.
2

Deploy your smart account on Arc

On first connect, the app shows a one-time Deploy account screen.Click Deploy. Your wallet will prompt you to sign one transaction. This deploys a Diamond smart account on Arc at a deterministic address. Deployment takes under a second.Diamonds on other supported chains are lazy-deployed — the first time a route stakes USDC on another supported chain, the account is deployed there automatically, at the same address (via CREATE2). You don’t need to do anything per-chain ahead of time.See Diamond account.
3

Fund with testnet USDC

Open faucet.circle.com in a new tab. Pick Arc Testnet, paste your smart account address (not your wallet address — the app shows both), and request USDC.Switch back to Compass. You should see the new balance within a few seconds.
4

Set your rules

The app will walk you through a one-time setup of:
  • Risk band — a slider from 1 to 10
  • Protocol whitelist — pick from the supported list
  • Chain whitelist — pick from the supported list
For your first run, the defaults are fine. You can change any of these later. See Set your rules for details on what each control does.Click Save rules. Your wallet will sign one transaction to commit the policy on-chain.
5

Run your first route

Open the chat panel and type something like:
move 5 USDC to the best lending venue on an L2
The agent will:
  1. Show you a proposed plan (source chain, target chain, target protocol, expected APR).
  2. Wait for you to Approve it.
  3. Execute: cross-chain transfer via Circle Gateway, then a deposit call on the target protocol. The whole route typically settles in under a second.
When it’s done, the dashboard shows the new position with an on-chain tx hash for every step.

​
What you can do now

After your first route:
  • Watch the agent work. It will tick on its own and propose new routes when better yield appears inside your rules.
  • Pause anytime. The Pause button stops the agent from initiating new routes. Existing positions stay put.
  • Withdraw anytime. Withdraw All returns USDC to your owner wallet. The agent has no permission to block this.
  • Read the audit trail. Every tick — including the ones that didn’t produce a transaction — is logged. See Audit trail.

​
Common issues

“Account deployment failed”
Usually a temporary RPC issue on Arc Testnet. Refresh and try again. If it persists, check status.usecompassai.com. “Faucet sent USDC but the app shows zero balance”
Make sure you funded the smart account address, not your wallet address. The app displays both — they are different addresses. “Plan rejected: out of policy”
The chat agent proposed a route that fails your rules — wrong chain, wrong protocol, or over your per-route cap. The chat panel shows which rule was hit. Either adjust the prompt or update your rules. “Route stuck in pending”
Cross-chain settlement via Gateway is usually sub-second, but indexers can lag. The deterministic loop retries automatically. If a route is still pending after a few minutes, the dashboard will show it as Paused rather than silently failing.

​
Next steps

Set your rules

The full breakdown of risk band, protocol, and chain whitelists.

How it works

What happens under the hood after you hit Approve.

Trust & security

What the agent can do, what it can’t, and why.

System overview

The full architecture, if you want to go deeper.