Networks
Every organization has a Test environment and a Live environment. Live settles on Avalanche Fuji in test USDC. Test settles on Avalanche Fuji in test USDC, which has no value. The pairing is fixed: no setting moves an environment to the other network.
| Test | Live | |
|---|---|---|
| Chain | Avalanche Fuji, chain id 43113 | Avalanche Fuji, chain id 43113 |
| Token | test USDC, no value | test USDC |
| API keys | Start with kat_test_ | Start with kat_live_ |
| Model calls paid from | test USDC in your wallet, or the environment’s test credits | test USDC in your wallet, or Account Credits |
| Adding funds | The faucet: 5 test USDC a day; test credits: 5 a day from the portal | A transfer to your wallet, or Account Credits: the signup credit and card purchases |
| Explorer | https://testnet.snowtrace.io | https://testnet.snowtrace.io |
One address for both
Section titled “One address for both”The API is https://api.staging.katara.com/v1 for Test and Live alike, and the portal at https://platform.staging.katara.com holds both environments. The key decides the network: a request made with a Test key is served by providers on Avalanche Fuji and paid in test USDC, and one made with a Live key is served and paid on Avalanche Fuji. Code that works in Test runs in Live with nothing changed but the key.
Without a key, GET https://api.staging.katara.com/v1/models lists Katara Cortex with Live’s price ceiling, and https://api.staging.katara.com/test/v1/models with Test’s. Each network has its own providers, so its prices are its own. The fee is the same on both.
The chat app pays from Live: your wallet on Avalanche Fuji, or your Account Credits.
What Test pays with
Section titled “What Test pays with”A direct model call with a Test key pays in test USDC, from your wallet’s spending approval or prepaid balance on Avalanche Fuji, or with the environment’s test credits. Test credits have no value, are never bought, and pay only for that environment’s Test keys; Account Credits do not pay for Test calls. A key’s payment method is chosen when the key is made.
Test has no managed fallback. When no provider on Avalanche Fuji is free, a request for Katara Cortex gets a simulated reply: fixed text that says no model ran, marked "simulated": true in the reply’s katara object and served as katara/simulated@1. It is paid and settled in test USDC like any reply, so the payment works end to end while Test has no capacity.
An agent’s Test Compute is different. Its budget pays with Account Credits, which are real money, or in test USDC on Avalanche Fuji: from your wallet (Pay for runs from your wallet) or by x402 for each run (Pay for an agent run). Either way the payer consents and the run’s budget limits it. Simulation, the fixed scenarios a Test agent can run, is free. Define, test and inspect an agent explains the three.
Paying per request with a wallet signature and no key works on both networks: under https://api.staging.katara.com/v1 it pays in test USDC on Avalanche Fuji, and under https://api.staging.katara.com/test/v1 in test USDC on Avalanche Fuji, so you can try x402 without spending anything of value. Under https://api.staging.katara.com/test, a request with a Live key is refused with 403 wrong_environment.
Your wallet on both networks
Section titled “Your wallet on both networks”Your wallet has the same address on Avalanche Fuji and Avalanche Fuji. Its balance, its spending approval and its prepaid balance are separate on each, so approve spending once for Test and once for Live. The portal’s Test/Live switch shows the selected network’s balances, faucet and explorer links.
Providers
Section titled “Providers”A provider node serves one network. A Live node uses -gateway https://api.staging.katara.com and a Test node -gateway https://api.staging.katara.com/test, and each registers on its own network. Test jobs pay in test USDC. Running a node has the commands.
Contracts
Section titled “Contracts”Settlements and registrations are public. Check one on https://testnet.snowtrace.io for Live or https://testnet.snowtrace.io for Test.
Live contracts
Section titled “Live contracts”On Avalanche Fuji:
| Contract | Address |
|---|---|
| Settlement | 0xf1c96db439c1a880692ec0389adb87887a6c6846 |
| Token, test USDC | 0x3e4a2ad8e25ac7a0e602f4cc5713ce3e6c224907 |
| Provider registry | 0x220db3581bb87ca3c55eeb2af243f1ee0c06eb30 |
| Bundle registry | 0x0fb48a992c6463981499800ead0f86a705656d9d |
| Validator registry | 0x8dbeb77e331319b71803c795d6727b830bfbba8b |
Test contracts
Section titled “Test contracts”On Avalanche Fuji:
| Contract | Address |
|---|---|
| Settlement | 0x08a67f3401ad0ee682e367b03bccffdd7df1e338 |
| Token, test USDC | 0x37a06a848ee93b51d20a75a816af38250aff64c3 |
| Provider registry | 0x347c0204485962d28d85e8e3b5d8df3402b97bfb |
| Bundle registry | 0xe878c377b59fe0528eaef3ae74b633695ae5a0a3 |
| Validator registry | 0x8378e8d2133dbb2d60b7fbfaddd19c108a8d03ac |
| Faucet | 0x62562b06d4a0b925646ce7f8885e699c8c717741 |
A wallet without a Katara account can claim test USDC from the faucet: call claim() on 0x62562b06d4a0b925646ce7f8885e699c8c717741 from the wallet. It sends 5 test USDC to the caller once a day. The call needs a little Avalanche Fuji AVAX for gas.