Skip to main content
Geodesics plugs into the wallet and signer a Virtuals ACP agent already has; nothing new is deployed and no keys are handed over. This page collects the one-time setup on the Virtuals side, from creating the agent to the values your integration needs.
1

Create the agent

Create an ACP agent at app.virtuals.io/acp/agents. This provisions the agent’s ACP wallet. Already have an agent with an ACP wallet? Skip ahead to the signer.
2

Add the swapping signer

On the Virtuals dashboard, open the agent’s Wallet tab, find the Signers section, and Add Key. Copy the private key shown at creation: a long base64 value starting MIG. It is shown only once; afterwards the dashboard displays only its public half, which will not work in the config. When you set up with geodesics init, this key goes into the OS keychain, encrypted at rest, not into a plaintext file.
Give that signer No Policy, or, for production, a custom allowlist scoped to the swap contracts. Under the default “Virtuals Only” policy, every swap pauses for manual owner approval, so a headless agent cannot swap unattended.
3

Collect the wallet details

Your integration identifies the wallet with two values from the dashboard:
  • AGENT_WALLET_ADDRESS: the agent’s EVM wallet address, 0x…
  • AGENT_WALLET_ID: the wallet’s Privy wallet id
For swaps to or from Solana, also note AGENT_SOLANA_WALLET_ADDRESS; Solana-origin swaps additionally need AGENT_SOLANA_WALLET_ID, which is a different Privy id than the EVM one. Both Solana values are shown on EconomyOS under the agent’s Wallet > Signers tab.
4

Create an API key

Sign in to the Geodesics console and create a key; it is self-service and works immediately. The key is shown once, so copy it as GEODESICS_API_KEY. Details in the Console guide.
5

Fund the wallet

Send the agent some USDC on Base. That is all it needs: gas and fees come out of the input token, so the wallet never needs ETH or any gas token on any EVM chain.
6

Pick an integration

With those values in hand, either path is a few minutes:
  • Agent skill and CLI: run geodesics init and it walks through the credentials, validates them, and installs the skill for your AI tools. Start at the Quickstart or the Agent skill page.
  • TypeScript SDK: the Virtuals walkthrough on the SDK page has a complete runnable example using the ACP adapter your agent already ships with.

​
If something goes wrong