Connect an EVM-compatible wallet (such as MetaMask or a WalletConnect-supported wallet) to the StableFX Console for signing trades and funding settlements onchain. The console uses Dynamic.xyz for wallet connection and supports any wallet that can sign EIP-712 typed data.Documentation Index
Fetch the complete documentation index at: https://developers.circle.com/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin:- You have a Circle account with StableFX access. Contact your Circle representative if you do not have one.
- You have an EVM-compatible wallet (such as MetaMask or any WalletConnect-supported wallet).
- You have the wallet browser extension installed and unlocked, or a mobile wallet with WalletConnect support.
Supported wallets
The console supports wallets that are compatible with the EVM and can sign EIP-712 typed data (a standard for structured, human-readable signing requests used by DeFi applications). Common options include:- MetaMask (browser extension or mobile)
- WalletConnect-compatible wallets (Rainbow, Trust Wallet, Coinbase Wallet, etc.)
- Hardware wallets connected through MetaMask (Ledger, Trezor)
Network requirements
Your wallet must be configured for the correct network:| Environment | Network | Chain ID | RPC URL |
|---|---|---|---|
| Testnet | Arc Testnet | 5042002 | https://rpc.testnet.arc.network |
| Production | Arc Mainnet | — | Contact Circle for details |
If your wallet does not have the Arc network configured, the console may
prompt you to add it automatically. Alternatively, you can add it manually in
your wallet’s network settings.
Connect during a trade flow
The most common way to connect your wallet is during the trade flow:Start a trade
Open the trade form and configure your trade (currencies, amount, and
tenor—the settlement period for the trade). Click Continue.
Choose your wallet
Select your wallet provider from the list. If using a browser extension like
MetaMask, the extension popup appears. If using WalletConnect, scan the QR
code with your mobile wallet.
Token requirements
Before you can sign and fund trades, your wallet needs:Sufficient token balance
Your wallet must hold enough tokens to cover:- The trade amount (the currency you are selling)
- The collateral (risk buffer), if applicable
Permit2 approval
StableFX uses the Permit2 contract for gas-efficient token transfers. You must approve the Permit2 contract to spend your tokens.- First-time setup: The console detects if you have not approved Permit2 and prompts you to do so during the trade flow. Your wallet displays a standard ERC-20 approval transaction.
- One-time per token: You only need to approve Permit2 once per token. After approval, all subsequent trades use Permit2 signatures (no additional onchain approval transactions).
- Manual approval: You can also approve Permit2 ahead of time. See Grant USDC allowance to Permit2.
0x000000000022D473030F116dDEE9F6B43aC78BA3.
Wallet persistence
Your wallet connection persists across page loads in the same browser session. If you close the browser or clear cookies, you will need to reconnect. The wallet address used for a trade is recorded as the signer address in the trade details. You must use the same wallet to fund the trade.Troubleshooting
| Issue | Solution |
|---|---|
| Wallet not appearing in selector | Ensure the browser extension is installed and unlocked, or refresh the page. |
| Wrong network | Switch your wallet to the Arc network (testnet or mainnet). The console may prompt you to switch automatically. |
| Insufficient balance | Add tokens to your wallet. On testnet, use the Circle Faucet to obtain USDC and EURC. |
| Permit2 approval fails | Ensure you have enough ETH (or the native Arc token) for gas fees. Try resetting your wallet’s transaction history if the nonce is stale. |
| Signature rejected | If you reject a signature in your wallet, the console displays an error. You can retry by clicking the sign button again. |