Before you begin¶
Five minutes of setup saves a frustrating first run. Have these ready before you install the plugin.
1. uv¶
The plugin runs on uv, Astral's Python runner. Install it first:
The plugin's first launch resolves its environment with uv (downloads dependencies) and can take a minute or two — that pause is normal, not a hang.
2. Claude Desktop¶
Install Claude Desktop (macOS or Windows). The plugin is a Desktop Extension you add under Settings → Extensions.
3. A wallet (for browser signing)¶
The default signing mode is browser: your own wallet approves every trade. Have a browser wallet (MetaMask, Rabby, …) installed in your default browser. The plugin opens a local page and your wallet signs there.
Not using browser signing?
On a shared machine or a headless setup, use aws (an AWS KMS key) or privatekey (a dedicated dev wallet key) instead. See Configure the plugin and Signing modes.
4. A network, and funds on it¶
Pick where you'll trade:
| Network | Use it for |
|---|---|
dev |
Internal development |
testnet |
Start here — test funds, no real value at risk |
mainnet |
Real funds |
Fund the wallet you'll sign with on the network you chose, and start on testnet until the whole flow behaves as you expect.
5. A verified Digital Identity¶
Trading is gated by an on-chain Digital Identity (DID) tied to KYC. Your signing wallet must be verified and have its DID minted before any trade will go through — reads (prices, balances) work without it, but swaps do not. See Log in & claim a Digital Identity.
Ready? → Install the plugin