Skip to main content

​
Overview

ACN runs three environments. Use devnet for development, testnet for staging, and mainnet for production.

​
Environment Comparison

DevnetTestnetMainnet
PurposeLocal development & experimentationStaging & integration testingProduction
API URLhttps://api.acn-dev.nethttps://api.acn-testnet.exchangehttps://api.acn.exchange
ChainBase SepoliaBase SepoliaBase Mainnet
USDCTest USDC (faucet)Test USDC (faucet)Real USDC
ProvidersTest/mock providersTest providersLive production providers
Swagger DocsAvailable at /docsAvailable at /docsNot available
Data persistenceMay be reset periodicallyPersistentPersistent
Rate limitsRelaxedProduction-likeProduction

​
Devnet

Use for: Initial development, testing your integration, experimenting with the API. 
# Base URL
https://api.acn-dev.net

# Swagger UI (interactive API docs)
https://api.acn-dev.net/docs

# OpenAPI JSON
https://api.acn-dev.net/docs-json
  • Uses test USDC on Base Sepolia (free from faucets)
  • Includes mock/test providers for development
  • Swagger UI available for interactive API exploration
  • Data may be reset periodically

​
Testnet

Use for: Pre-production testing, CI/CD integration tests, validating end-to-end flows. 
# Base URL
https://api.acn-testnet.exchange

# Swagger UI
https://api.acn-testnet.exchange/docs
  • Uses test USDC on Base Sepolia
  • Production-like configuration and rate limits
  • Test providers that mirror production behavior

​
Mainnet

Use for: Production workloads with real money and real providers. 
# Base URL
https://api.acn.exchange

# Docs
https://docs.acn.exchange (this site)
  • Real USDC on Base
  • Live production providers
  • Full rate limits and security policies
  • Swagger UI not available (use this documentation instead)

​
Switching Environments

​
API Calls

Change the base URL: 
const ACN_BASE = process.env.NODE_ENV === "production"
  ? "https://api.acn.exchange"
  : "https://api.acn-dev.net";

​
MCP Server

Update the URL in your MCP configuration: 
{
  "mcpServers": {
    "acn": {
      "url": "https://mcp.acn-dev.net/mcp"
    }
  }
}

​
CLI

Set the network in your agent config or via the CLI: 
npx acn-agent config --network devnet

​
Wallet

Switch the chain ID and RPC URL:
EnvironmentChain IDRPC URL
Devnet / Testnet84532https://sepolia.base.org
Mainnet8453https://mainnet.base.org