@buildaureon/sdk 0.1.7 → 0.1.8

package/docs/architecture.md

@@ -184,16 +184,18 @@ flowchart TD
 
 ---
 
-## 8. Network (early access testnet)
+## 8. Network
 
-| Item | Value |
-| --- | --- |
-| Chain | Robinhood Chain testnet |
-| Chain ID | `46630` |
-| API | `https://api.aureonlabs.network` |
-| Explorer | Configure via product / env (`AUREON_EXPLORER_BASE`) |
+Default omitted SDK/MCP options are the **isolated mainnet stack** (4663 + local 8788). Public `api.aureonlabs.network` is still **testnet 46630**.
+
+| Item | Mainnet (default) | Testnet (opt-in) |
+| --- | --- | --- |
+| Chain | Robinhood Chain mainnet | Robinhood Chain testnet |
+| Chain ID | `4663` | `46630` |
+| API | `http://127.0.0.1:8788` | `https://api.aureonlabs.network` |
+| Explorer | `https://robinhoodchain.blockscout.com` | `https://explorer.testnet.chain.robinhood.com` |
 
-Confirm live addresses and allowlisted symbols from the operator utility and API responses — do not hardcode stale addresses in agents.
+Production does **not** already sync 4663. Confirm live addresses from the API you actually call.
 
 ---
 

package/docs/auth.md

@@ -40,8 +40,9 @@ Control-plane calls (sync, objectives, health, restore, vault reads, prepare-*)
 import { createAureonClient } from "@buildaureon/sdk";
 
 const aureon = createAureonClient({
-  baseUrl: "https://api.aureonlabs.network",
   apiKey: process.env.AUREON_API_KEY!, // issued key from Developers
+  // omit network → mainnet 4663 / http://127.0.0.1:8788
+  // network: "testnet" → public host (still 46630)
 });
 
 const me = await aureon.me();
@@ -88,7 +89,7 @@ import { createAureonClient, createSessionTokenProvider } from "@buildaureon/sdk
 
 const session = createSessionTokenProvider(null);
 const aureon = createAureonClient({
-  baseUrl: "https://api.aureonlabs.network",
+  network: "testnet", // public host, still chain 46630
   apiKey: process.env.AUREON_API_KEY,
   getAccessToken: session.getAccessToken,
 });
@@ -143,7 +144,8 @@ session.clear();
 | Variable | Required | Description |
 | --- | --- | --- |
 | `AUREON_API_KEY` | Recommended | Issued developer key |
-| `AUREON_API_URL` | No | Defaults to `https://api.aureonlabs.network` |
+| `AUREON_NETWORK` | No | Omit for mainnet 4663 / `http://127.0.0.1:8788`. Set `testnet` for the public host (still 46630). |
+| `AUREON_API_URL` | No | Optional override. Must match `AUREON_NETWORK` if both are set. |
 | `AUREON_TOKEN` | No | Optional Bearer for CLI / scripts |
 
 CLI example:

package/docs/client-api.md

@@ -32,7 +32,8 @@ import {
 } from "@buildaureon/sdk";
 
 const aureon = createAureonClient({
-  // baseUrl defaults to https://api.aureonlabs.network
+  // network defaults to mainnet (4663 / http://127.0.0.1:8788)
+  // network: "testnet" → public host (still chain 46630)
   apiKey: process.env.AUREON_API_KEY,
   getAccessToken: () => sessionToken,
   timeoutMs: 30_000,
@@ -44,7 +45,8 @@ const aureon = createAureonClient({
 
 | Option | Required | Default | Description |
 |--------|----------|---------|-------------|
-| `baseUrl` | no | `https://api.aureonlabs.network` | Absolute `http://` or `https://` URL. |
+| `network` | no | `mainnet` | `mainnet` = 4663 / `http://127.0.0.1:8788`. `testnet` = public host (still 46630). |
+| `baseUrl` | no | mainnet local API | Absolute `http://` or `https://` URL. Wins when set; mismatch with `network` throws. |
 | `apiKey` | SDK / CLI | N/A | Sent as `X-Aureon-Api-Key`. Issued developer keys also identify the bound wallet (no Bearer required). Env bootstrap keys are product-gate only. Utility uses wallet Bearer only. |
 | `getAccessToken` | no | N/A | Optional Bearer getter. Wins over API-key identity when present. |
 | `authToken` | no | N/A | Static Bearer string when `getAccessToken` is omitted. |
@@ -59,8 +61,12 @@ const aureon = createAureonClient({
 
 | Rule | Behavior |
 |------|----------|
-| Omitted `baseUrl` | Uses production default |
+| Omitted `network` and `baseUrl` | Local mainnet `http://127.0.0.1:8788`, chain 4663 |
+| `network: "testnet"` | Public `https://api.aureonlabs.network` (still 46630) |
+| Explicit `baseUrl` | Wins; infer network from known hosts |
+| `network` + disagreeing `baseUrl` | Throws |
 | Invalid `baseUrl` scheme | Throws via `assertBaseUrl` |
+| `aureon.network` / `aureon.chainId` | Resolved bundle |
 | Both `authToken` and `getAccessToken` | Transport uses `getAccessToken` only |
 | `aureon.baseUrl` getter | Returns resolved base (no trailing slash) |
 

package/docs/error-model.md

@@ -134,7 +134,7 @@ flowchart TD
 | --- | --- |
 | Invalid / paused key | Stop loop; operator rotates Developers key |
 | Bootstrap key alone | Switch to issued key |
-| Vault empty on restore | Prepare deposit → broadcast → sync → retry |
+| Vault empty on restore | Expected first use. Call `prepareVaultDeposit`, return unsigned steps, wait for the **user/host** to broadcast. Agents do not fund the vault. |
 | Locked field on update | Recreate objective |
 | Conflict mid-restore | Back off; read timeline / executions |
 | Staged settlement returned | Do not treat as on-chain success |
@@ -186,7 +186,7 @@ import {
 
 test("empty objective name fails validation", async () => {
   const client = createAureonClient({
-    baseUrl: "https://api.aureonlabs.network",
+    network: "testnet",
     apiKey: "test",
   });
 

package/docs/integration-guide.md

@@ -11,8 +11,11 @@ Integrate `@buildaureon/sdk` into server-side agents and automated rebalancing l
 ```mermaid
 flowchart TD
   Init[1_issued_API_key_client] --> Sync[2_sync_Capital_Book]
-  Sync --> Fund[3_fund_vault_if_empty]
-  Fund --> Obj[4_create_Auto_objective]
+  Sync --> Empty{vault empty?}
+  Empty -->|yes| FourOhNine[restore 409]
+  FourOhNine --> Prep[prepareVaultDeposit unsigned]
+  Prep --> User[user/host signs when they use it]
+  Empty -->|no| Obj[create Auto objective]
   Obj --> Loop[5_watchdog_heartbeat]
   Loop -->|breach| Plan[6_restore_plan]
   Plan --> Restore[7_restoreObjective]
@@ -22,10 +25,12 @@ flowchart TD
 ### Step 1 — Client
 
 ```ts
-import { createAureonClient } from "@buildaureon/sdk";
+import { createAureonClient, resolveAureonNetworkFromEnv } from "@buildaureon/sdk";
 
+const resolved = resolveAureonNetworkFromEnv();
 export const aureon = createAureonClient({
-  baseUrl: process.env.AUREON_API_URL || "https://api.aureonlabs.network",
+  network: resolved.network,
+  baseUrl: resolved.baseUrl,
   apiKey: process.env.AUREON_API_KEY!, // issued Developers key
   timeoutMs: 30_000,
   maxRetries: 2,
@@ -39,11 +44,17 @@ console.log("operating as", me.walletAddress);
 Optional Bearer (usually unnecessary with an issued key):
 
 ```ts
-import { createAureonClient, createSessionTokenProvider } from "@buildaureon/sdk";
+import {
+  createAureonClient,
+  createSessionTokenProvider,
+  resolveAureonNetworkFromEnv,
+} from "@buildaureon/sdk";
 
+const resolved = resolveAureonNetworkFromEnv();
 const session = createSessionTokenProvider(process.env.AUREON_TOKEN ?? null);
 export const aureon = createAureonClient({
-  baseUrl: process.env.AUREON_API_URL || "https://api.aureonlabs.network",
+  network: resolved.network,
+  baseUrl: resolved.baseUrl,
   apiKey: process.env.AUREON_API_KEY ?? null,
   getAccessToken: session.getAccessToken,
 });
@@ -62,28 +73,19 @@ console.log({
 
 Prefer `syncPortfolio()` over hand-seeded books in production. Use `setPortfolio` only for controlled rehearsals.
 
-### Step 3 — Fund vault when needed
+### Step 3 — Empty vault is first use (do not fund for the user)
 
-Automatic restores require vault capital. Prepare returns **unsigned** steps — your host signs and broadcasts.
+Automatic restore on an empty vault must **409**. That is the same path as testnet. The SDK/MCP process does **not** broadcast a deposit. When the user actually uses the product, their host wallet signs `prepareVaultDeposit` steps.
 
 ```ts
 import type { VaultPrepareResult } from "@buildaureon/sdk";
 
-async function ensureVaultFunded(
-  symbol: string,
-  amount: string,
-  broadcast: (step: VaultPrepareResult["steps"][number]) => Promise<string>
-) {
-  const status = await aureon.getVaultStatus();
-  if (!status.empty && status.canRestore) return status;
-
-  const prep = await aureon.prepareVaultDeposit({ symbol, amount });
-  for (const step of prep.steps) {
-    const hash = await broadcast(step);
-    console.log(step.label, hash);
-  }
-
-  return aureon.getVaultStatus();
+const status = await aureon.getVaultStatus();
+if (status.empty) {
+  // restoreObjective must 409 here — do not treat that as a bug
+  const prep = await aureon.prepareVaultDeposit({ symbol: "USDG", amount: "0.05" });
+  // prep.steps are UNSIGNED. Return them. The user broadcasts when they fund.
+  return prep;
 }
 ```
 
@@ -317,7 +319,8 @@ module.exports = {
       autorestart: true,
       env: {
         NODE_ENV: "production",
-        AUREON_API_URL: "https://api.aureonlabs.network",
+        // omit AUREON_API_URL for local mainnet 8788 / 4663
+        // AUREON_NETWORK: "testnet"  // public host, still 46630
         // AUREON_API_KEY from secret store / PM2 ecosystem secrets
       },
     },
@@ -380,7 +383,7 @@ Never log API keys, Bearer tokens, or private keys.
 | --- | --- | --- |
 | 401 invalid key | Wrong / paused / revoked key | Rotate in Developers |
 | 401 need issued key | Env bootstrap key alone | Use an issued Developers key |
-| Vault empty / cannot restore | No vault capital | `prepareVaultDeposit` → broadcast → sync |
+| Vault empty / cannot restore | First use — no user deposit yet | `prepareVaultDeposit` (unsigned). User/host broadcasts when they fund. Agents do not. |
 | Update rejects symbol/mode | Locked at create | Recreate objective |
 | Restore receipt `staged` | Ledger-local path | Do not claim on-chain |
 | Health still violated after restore | Prices / sizing / liquidity | Re-read plan, vault balances, timeline |

package/docs/receipt-validation.md

@@ -9,12 +9,15 @@ Phase 2 receipts must follow honest settlement rules. Use the SDK validator afte
 ```ts
 import {
   createAureonClient,
+  resolveAureonNetworkFromEnv,
   validateExecutionReceipt,
   assertValidExecutionReceipt,
 } from "@buildaureon/sdk";
 
+const resolved = resolveAureonNetworkFromEnv();
 const client = createAureonClient({
-  baseUrl: process.env.AUREON_API_URL!,
+  network: resolved.network,
+  baseUrl: resolved.baseUrl,
   apiKey: process.env.AUREON_API_KEY!,
 });
 

package/docs/security.md

@@ -82,7 +82,7 @@ Never collapse staged into “confirmed on Robinhood Chain.”
 
 ## 5. Transport and logging hygiene
 
-- Prefer HTTPS production base URL `https://api.aureonlabs.network`.
+- Default omitted client is local mainnet `http://127.0.0.1:8788` (4663). Use `network: "testnet"` for the public host (still 46630). Do not call that host production.
 - Do not log raw `Authorization` or `X-Aureon-Api-Key`.
 - Redact prepare step calldata in public logs if it includes sensitive amounts in your threat model.
 - Set `timeoutMs` / `maxRetries` deliberately for agent loops (see [transport.md](./transport.md)).

package/docs/transport.md

@@ -48,7 +48,8 @@ Issued developer keys in `X-Aureon-Api-Key` are enough for control-plane identit
 
 ```ts
 createAureonClient({
-  baseUrl: "https://api.aureonlabs.network",
+  // omit network → local mainnet 8788 / 4663
+  // network: "testnet" → public host (still 46630)
   apiKey: process.env.AUREON_API_KEY!,
   timeoutMs: 30_000,   // per attempt
   maxRetries: 2,        // extra attempts after first failure

package/examples/ai-to-objective-to-portfolio/main.ts

@@ -3,14 +3,15 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_API_URL  optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK  optional; omit for mainnet (4663 / 8788); set testnet for public host (still 46630)
+ *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:ai-to-objective-to-portfolio
  */
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   formatWeight,
   isAureonError,
   parseFinancialIntent,
@@ -54,8 +55,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });
 

package/examples/audit-trail/main.ts

@@ -11,7 +11,7 @@
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   formatAuditTrailLines,
   isAureonError,
 } from "../../src/index.js";
@@ -22,8 +22,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });
 

package/examples/drift-detect-restore/main.ts

@@ -5,14 +5,15 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_API_URL  optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK  optional; omit for mainnet (4663 / 8788); set testnet for public host (still 46630)
+ *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:drift-detect-restore
  */
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   formatWeight,
   isAureonError,
   type DriftRestoreFlow,
@@ -75,8 +76,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });
 

package/examples/e2e-policy-rebalance/main.ts

@@ -4,9 +4,10 @@
  * Env:
  *   AUREON_API_KEY            issued developer key (required)
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key (required)
- *   AUREON_API_URL            optional (default https://api.aureonlabs.network)
- *   AUREON_RPC_URL            optional
- *   AUREON_CHAIN_ID           optional (default 46630)
+ *   AUREON_NETWORK            optional; omit for mainnet 8788 / 4663; testnet = public host (still 46630)
+ *   AUREON_API_URL            optional override
+ *   AUREON_RPC_URL            optional (defaults from resolved chain)
+ *   AUREON_CHAIN_ID           optional (defaults from resolved network)
  *
  *   pnpm --filter @buildaureon/sdk example:e2e-policy
  */
@@ -25,7 +26,7 @@ import { privateKeyToAccount } from "viem/accounts";
 import {
   createAureonClient,
   createSessionTokenProvider,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   isAureonError,
 } from "../../src/index.js";
 
@@ -61,11 +62,14 @@ function log(step: string, data?: unknown) {
 }
 
 async function main() {
-  const baseUrl = process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL;
+  const resolved = resolveAureonNetworkFromEnv();
+  const baseUrl = resolved.baseUrl;
+  const chainId = Number(process.env.AUREON_CHAIN_ID ?? resolved.chainId);
   const rpcUrl =
     process.env.AUREON_RPC_URL?.trim() ||
-    "https://rpc.testnet.chain.robinhood.com";
-  const chainId = Number(process.env.AUREON_CHAIN_ID ?? 46630);
+    (chainId === 4663
+      ? "https://rpc.mainnet.chain.robinhood.com"
+      : "https://rpc.testnet.chain.robinhood.com");
   const apiKey = requireEnv("AUREON_API_KEY");
 
   const account = privateKeyToAccount(loadKey());
@@ -73,7 +77,7 @@ async function main() {
   const walletClient = createWalletClient({ account, transport: http(rpcUrl) });
   const chain = {
     id: chainId,
-    name: "Robinhood Chain Testnet",
+    name: chainId === 4663 ? "Robinhood Chain" : "Robinhood Chain Testnet",
     nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
     rpcUrls: { default: { http: [rpcUrl] } },
   } as const;
@@ -82,6 +86,7 @@ async function main() {
 
   const session = createSessionTokenProvider(null);
   const aureon = createAureonClient({
+    network: resolved.network,
     baseUrl,
     apiKey,
     getAccessToken: session.getAccessToken,

package/examples/e2e-policy-rebalance/underrun.ts

@@ -4,9 +4,10 @@
  * Env:
  *   AUREON_API_KEY            issued developer key
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key
- *   AUREON_API_URL            optional (default https://api.aureonlabs.network)
- *   AUREON_RPC_URL            optional
- *   AUREON_CHAIN_ID           optional (default 46630)
+ *   AUREON_NETWORK            optional; omit for mainnet 8788 / 4663; testnet = public host (still 46630)
+ *   AUREON_API_URL            optional override
+ *   AUREON_RPC_URL            optional (defaults from resolved chain)
+ *   AUREON_CHAIN_ID           optional (defaults from resolved network)
  */
 
 import {
@@ -20,7 +21,7 @@ import { privateKeyToAccount } from "viem/accounts";
 import {
   createAureonClient,
   createSessionTokenProvider,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   isAureonError,
 } from "../../src/index.js";
 
@@ -36,22 +37,26 @@ if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {
 }
 
 const account = privateKeyToAccount(key);
+const resolved = resolveAureonNetworkFromEnv();
+const chainId = Number(process.env.AUREON_CHAIN_ID || resolved.chainId);
 const rpc =
   process.env.AUREON_RPC_URL?.trim() ||
-  "https://rpc.testnet.chain.robinhood.com";
-const chainId = Number(process.env.AUREON_CHAIN_ID || 46630);
+  (chainId === 4663
+    ? "https://rpc.mainnet.chain.robinhood.com"
+    : "https://rpc.testnet.chain.robinhood.com");
 const publicClient = createPublicClient({ transport: http(rpc) });
 const walletClient = createWalletClient({ account, transport: http(rpc) });
 const chain = {
   id: chainId,
-  name: "Robinhood Chain Testnet",
+  name: chainId === 4663 ? "Robinhood Chain" : "Robinhood Chain Testnet",
   nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
   rpcUrls: { default: { http: [rpc] } },
 } as const;
 
 const session = createSessionTokenProvider(null);
 const aureon = createAureonClient({
-  baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+  network: resolved.network,
+  baseUrl: resolved.baseUrl,
   apiKey: requireEnv("AUREON_API_KEY"),
   getAccessToken: session.getAccessToken,
 });

package/examples/e2e-policy-rebalance/verify-sizing.ts

@@ -4,9 +4,10 @@
  * Env:
  *   AUREON_API_KEY            issued developer key
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key
- *   AUREON_API_URL            optional (default https://api.aureonlabs.network)
- *   AUREON_RPC_URL            optional
- *   AUREON_CHAIN_ID           optional (default 46630)
+ *   AUREON_NETWORK            optional; omit for mainnet 8788 / 4663; testnet = public host (still 46630)
+ *   AUREON_API_URL            optional override
+ *   AUREON_RPC_URL            optional (defaults from resolved chain)
+ *   AUREON_CHAIN_ID           optional (defaults from resolved network)
  */
 
 import {
@@ -20,7 +21,7 @@ import { privateKeyToAccount } from "viem/accounts";
 import {
   createAureonClient,
   createSessionTokenProvider,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
 } from "../../src/index.js";
 
 function requireEnv(name: string): string {
@@ -35,22 +36,26 @@ if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {
 }
 
 const account = privateKeyToAccount(key);
+const resolved = resolveAureonNetworkFromEnv();
+const chainId = Number(process.env.AUREON_CHAIN_ID || resolved.chainId);
 const rpc =
   process.env.AUREON_RPC_URL?.trim() ||
-  "https://rpc.testnet.chain.robinhood.com";
-const chainId = Number(process.env.AUREON_CHAIN_ID || 46630);
+  (chainId === 4663
+    ? "https://rpc.mainnet.chain.robinhood.com"
+    : "https://rpc.testnet.chain.robinhood.com");
 const publicClient = createPublicClient({ transport: http(rpc) });
 const walletClient = createWalletClient({ account, transport: http(rpc) });
 const chain = {
   id: chainId,
-  name: "Robinhood Chain Testnet",
+  name: chainId === 4663 ? "Robinhood Chain" : "Robinhood Chain Testnet",
   nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
   rpcUrls: { default: { http: [rpc] } },
 } as const;
 
 const session = createSessionTokenProvider(null);
 const aureon = createAureonClient({
-  baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+  network: resolved.network,
+  baseUrl: resolved.baseUrl,
   apiKey: requireEnv("AUREON_API_KEY"),
   getAccessToken: session.getAccessToken,
 });

package/examples/e2e-vault-flow/main.ts

@@ -3,10 +3,11 @@
  *
  * Env (integrators only — no local repo files):
  *   AUREON_API_KEY            issued developer key (required)
- *   AUREON_API_URL            optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK            optional; omit for mainnet 8788 / 4663; testnet = public host (still 46630)
+ *   AUREON_API_URL            optional override
  *   AUREON_WALLET_PRIVATE_KEY 0x… key used to sign auth + broadcast vault txs (required)
- *   AUREON_RPC_URL            optional (default Robinhood testnet RPC)
- *   AUREON_CHAIN_ID           optional (default 46630)
+ *   AUREON_RPC_URL            optional (defaults from resolved chain)
+ *   AUREON_CHAIN_ID           optional (defaults from resolved network)
  *
  *   pnpm --filter @buildaureon/sdk example:e2e
  */
@@ -21,7 +22,7 @@ import { privateKeyToAccount } from "viem/accounts";
 import {
   createAureonClient,
   createSessionTokenProvider,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   isAureonError,
 } from "../../src/index.js";
 
@@ -48,12 +49,15 @@ function log(step: string, data?: unknown): void {
 }
 
 async function main(): Promise<void> {
-  const baseUrl = process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL;
+  const resolved = resolveAureonNetworkFromEnv();
+  const baseUrl = resolved.baseUrl;
   const apiKey = requireEnv("AUREON_API_KEY");
+  const chainId = Number(process.env.AUREON_CHAIN_ID ?? resolved.chainId);
   const rpcUrl =
     process.env.AUREON_RPC_URL?.trim() ||
-    "https://rpc.testnet.chain.robinhood.com";
-  const chainId = Number(process.env.AUREON_CHAIN_ID ?? 46630);
+    (chainId === 4663
+      ? "https://rpc.mainnet.chain.robinhood.com"
+      : "https://rpc.testnet.chain.robinhood.com");
 
   const account = privateKeyToAccount(loadPrivateKey());
   const publicClient = createPublicClient({ transport: http(rpcUrl) });
@@ -63,13 +67,14 @@ async function main(): Promise<void> {
   });
   const chain = {
     id: chainId,
-    name: "Robinhood Chain Testnet",
+    name: chainId === 4663 ? "Robinhood Chain" : "Robinhood Chain Testnet",
     nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
     rpcUrls: { default: { http: [rpcUrl] } },
   } as const;
 
   const session = createSessionTokenProvider(null);
   const aureon = createAureonClient({
+    network: resolved.network,
     baseUrl,
     apiKey,
     getAccessToken: session.getAccessToken,

package/examples/full-aureon-loop/main.ts

@@ -3,14 +3,15 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_API_URL  optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK  optional; omit for mainnet (4663 / 8788); set testnet for public host (still 46630)
+ *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:full-aureon-loop
  */
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   formatWeight,
   isAureonError,
   type FullAureonLoopFlow,
@@ -64,8 +65,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });
 

package/examples/green-vs-plan/main.ts

@@ -6,14 +6,15 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_API_URL  optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK  optional; omit for mainnet (4663 / 8788); set testnet for public host (still 46630)
+ *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:green-vs-plan
  */
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   formatWeight,
   isAureonError,
   type AllocationComparisonRow,
@@ -70,8 +71,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });
 

package/examples/market-event/main.ts

@@ -3,14 +3,15 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_API_URL  optional (default https://api.aureonlabs.network)
+ *   AUREON_NETWORK  optional; omit for mainnet (4663 / 8788); set testnet for public host (still 46630)
+ *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm --filter @buildaureon/sdk example:market
  */
 
 import {
   createAureonClient,
-  DEFAULT_API_BASE_URL,
+  resolveAureonNetworkFromEnv,
   isAureonError,
 } from "../../src/index.js";
 
@@ -20,8 +21,10 @@ async function main(): Promise<void> {
     throw new Error("Set AUREON_API_KEY to an issued developer key.");
   }
 
+  const resolved = resolveAureonNetworkFromEnv();
   const aureon = createAureonClient({
-    baseUrl: process.env.AUREON_API_URL?.trim() || DEFAULT_API_BASE_URL,
+    network: resolved.network,
+    baseUrl: resolved.baseUrl,
     apiKey,
   });