@buildaureon/sdk 0.1.9 → 0.1.10

package/docs/architecture.md

@@ -186,18 +186,18 @@ flowchart TD
 
 ## 8. Network
 
-Default omitted SDK/MCP options use the official API `https://api.aureonlabs.network` on **testnet 46630**. Pass `network: "mainnet"` for chain **4663** on the same host. First use is the same on both networks: empty vault → restore 409 → unsigned `prepareVaultDeposit` → host wallet / MetaMask broadcasts. MCP agents never broadcast.
+Default omitted SDK/MCP options use the official API `https://api.aureonlabs.network` on **mainnet**. Pass `network: "testnet"` to stay on testnet on the same host. First use is the same on both networks: empty vault → restore 409 → unsigned `prepareVaultDeposit` → host wallet / MetaMask broadcasts. MCP agents never broadcast.
 
-| Item | Testnet (default) | Mainnet (`network: "mainnet"`) |
+| Item | Mainnet (default) | Testnet (`network: "testnet"`) |
 | --- | --- | --- |
-| Chain | Robinhood Chain testnet | Robinhood Chain mainnet |
-| Chain ID | `46630` | `4663` |
+| Chain | Robinhood Chain mainnet | Robinhood Chain testnet |
+| Chain ID | `4663` | `46630` |
 | API | `https://api.aureonlabs.network` | `https://api.aureonlabs.network` |
-| Cash park | Testnet catalog (see API) | USDG |
-| Explorer | `https://explorer.testnet.chain.robinhood.com` | `https://robinhoodchain.blockscout.com` |
-| Utility | [app.aureonlabs.network](https://app.aureonlabs.network) | [app.aureonlabs.network](https://app.aureonlabs.network) |
+| Cash park | USDG | Testnet catalog (see API) |
+| Explorer | `https://robinhoodchain.blockscout.com` | `https://explorer.testnet.chain.robinhood.com` |
+| Utility | Testnet console (Living Capital cutover next) | [app.aureonlabs.network](https://app.aureonlabs.network) |
 
-The official host still serves chain 46630 until that deployment is cut over. Confirm live addresses from the API you actually call.
+Confirm live addresses from the API you actually call. Public Living Capital is still the testnet console.
 
 ---
 

package/docs/auth.md

@@ -41,8 +41,8 @@ import { createAureonClient } from "@buildaureon/sdk";
 
 const aureon = createAureonClient({
   apiKey: process.env.AUREON_API_KEY!, // issued key from Developers
-  // omit network → official API / testnet 46630
-  // network: "mainnet" → chain 4663 on the same official host
+  // omit network → official API / mainnet
+  // network: "testnet" → stay on testnet on the same official host
 });
 
 const me = await aureon.me();
@@ -89,7 +89,7 @@ import { createAureonClient, createSessionTokenProvider } from "@buildaureon/sdk
 
 const session = createSessionTokenProvider(null);
 const aureon = createAureonClient({
-  network: "testnet", // public host, still chain 46630
+  network: "testnet", // opt-in testnet, chain 46630
   apiKey: process.env.AUREON_API_KEY,
   getAccessToken: session.getAccessToken,
 });
@@ -144,7 +144,7 @@ session.clear();
 | Variable | Required | Description |
 | --- | --- | --- |
 | `AUREON_API_KEY` | Recommended | Issued developer key |
-| `AUREON_NETWORK` | No | Omit for official API / testnet 46630. Set `mainnet` for chain 4663. |
+| `AUREON_NETWORK` | No | Omit for official API / mainnet. Set `testnet` to stay on testnet. |
 | `AUREON_API_URL` | No | Optional override of `https://api.aureonlabs.network`. |
 | `AUREON_TOKEN` | No | Optional Bearer for CLI / scripts |
 

package/docs/client-api.md

@@ -32,8 +32,8 @@ import {
 } from "@buildaureon/sdk";
 
 const aureon = createAureonClient({
-  // network defaults to official API / testnet 46630
-  // network: "mainnet" → chain 4663 on the same official host
+  // network defaults to official API / mainnet
+  // network: "testnet" → stay on testnet on the same official host
   apiKey: process.env.AUREON_API_KEY,
   getAccessToken: () => sessionToken,
   timeoutMs: 30_000,
@@ -45,7 +45,7 @@ const aureon = createAureonClient({
 
 | Option | Required | Default | Description |
 |--------|----------|---------|-------------|
-| `network` | no | `testnet` | Omit for official API / 46630. Pass `"mainnet"` for chain 4663. |
+| `network` | no | `mainnet` | Omit for official API / mainnet. Pass `"testnet"` to stay on testnet. |
 | `baseUrl` | no | `https://api.aureonlabs.network` | Leave unset. Override only if you must point at another host. |
 | `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. |
@@ -61,8 +61,8 @@ const aureon = createAureonClient({
 
 | Rule | Behavior |
 |------|----------|
-| Omitted `network` and `baseUrl` | Official API `https://api.aureonlabs.network`, chain 46630 |
-| `network: "mainnet"` | Same official host, chain 4663 |
+| Omitted `network` and `baseUrl` | Official API `https://api.aureonlabs.network`, chain 4663 |
+| `network: "testnet"` | Same official host, chain 46630 |
 | Explicit `baseUrl` | Override; official host is allowed with either network |
 | `network` + disagreeing non-official host | Throws |
 | Invalid `baseUrl` scheme | Throws via `assertBaseUrl` |

package/docs/data-contracts.md

@@ -579,7 +579,9 @@ export interface VaultPrepareResult {
 }
 ```
 
-#### JSON Representation Example
+#### JSON Representation Example (testnet sample)
+
+Labeled testnet: `chainId` 46630. Confirm live addresses from the API you actually call.
 ```json
 {
   "chainId": 46630,

package/docs/integration-guide.md

@@ -320,7 +320,7 @@ module.exports = {
       env: {
         NODE_ENV: "production",
         // omit AUREON_API_URL for official API https://api.aureonlabs.network
-        // AUREON_NETWORK: "mainnet"  // chain 4663 on the same official host
+        // AUREON_NETWORK: "testnet"  // stay on testnet on the same official host
         // AUREON_API_KEY from secret store / PM2 ecosystem secrets
       },
     },

package/docs/security.md

@@ -82,7 +82,7 @@ Never collapse staged into “confirmed on Robinhood Chain.”
 
 ## 5. Transport and logging hygiene
 
-- Default omitted client is the official API `https://api.aureonlabs.network` (currently testnet 46630). Use `network: "mainnet"` for chain 4663 on the same host. Do not call that host production until it is cut over.
+- Default omitted client is the official API `https://api.aureonlabs.network` on mainnet. Use `network: "testnet"` to stay on testnet on the same host. Public Living Capital is still the testnet console.
 - 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,8 +48,8 @@ Issued developer keys in `X-Aureon-Api-Key` are enough for control-plane identit
 
 ```ts
 createAureonClient({
-  // omit network → official API / testnet 46630
-  // network: "mainnet" → chain 4663 on the same official host
+  // omit network → official API / mainnet
+  // network: "testnet" → stay on testnet on the same official host
   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,7 +3,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:ai-to-objective-to-portfolio

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

@@ -5,7 +5,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:drift-detect-restore

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

@@ -4,7 +4,7 @@
  * Env:
  *   AUREON_API_KEY            issued developer key (required)
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key (required)
- *   AUREON_NETWORK            optional; omit for official API / testnet 46630; mainnet = chain 4663
+ *   AUREON_NETWORK            optional; omit for official API / mainnet; testnet = stay on testnet
  *   AUREON_API_URL            optional override
  *   AUREON_RPC_URL            optional (defaults from resolved chain)
  *   AUREON_CHAIN_ID           optional (defaults from resolved network)

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

@@ -4,7 +4,7 @@
  * Env:
  *   AUREON_API_KEY            issued developer key
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key
- *   AUREON_NETWORK            optional; omit for official API / testnet 46630; mainnet = chain 4663
+ *   AUREON_NETWORK            optional; omit for official API / mainnet; testnet = stay on testnet
  *   AUREON_API_URL            optional override
  *   AUREON_RPC_URL            optional (defaults from resolved chain)
  *   AUREON_CHAIN_ID           optional (defaults from resolved network)

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

@@ -4,7 +4,7 @@
  * Env:
  *   AUREON_API_KEY            issued developer key
  *   AUREON_WALLET_PRIVATE_KEY 0x… signing key
- *   AUREON_NETWORK            optional; omit for official API / testnet 46630; mainnet = chain 4663
+ *   AUREON_NETWORK            optional; omit for official API / mainnet; testnet = stay on testnet
  *   AUREON_API_URL            optional override
  *   AUREON_RPC_URL            optional (defaults from resolved chain)
  *   AUREON_CHAIN_ID           optional (defaults from resolved network)

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

@@ -3,7 +3,7 @@
  *
  * Env (integrators only — no local repo files):
  *   AUREON_API_KEY            issued developer key (required)
- *   AUREON_NETWORK            optional; omit for official API / testnet 46630; mainnet = chain 4663
+ *   AUREON_NETWORK            optional; omit for official API / mainnet; testnet = stay on testnet
  *   AUREON_API_URL            optional override
  *   AUREON_WALLET_PRIVATE_KEY 0x… key used to sign auth + broadcast vault txs (required)
  *   AUREON_RPC_URL            optional (defaults from resolved chain)

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

@@ -3,7 +3,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:full-aureon-loop

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

@@ -6,7 +6,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:green-vs-plan

package/examples/market-event/main.ts

@@ -3,7 +3,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm --filter @buildaureon/sdk example:market

package/examples/portfolio-watch/main.ts

@@ -3,7 +3,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:portfolio-watch

package/examples/quickstart/main.ts

@@ -3,7 +3,7 @@
  *
  * Env (required for integrators — nothing else):
  *   AUREON_API_KEY     issued key from Developers
- *   AUREON_NETWORK     optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK     optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL     optional override (must match network if both set)
  *
  *   pnpm --filter @buildaureon/sdk example:quickstart

package/examples/receipt-verification/main.ts

@@ -5,7 +5,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm example:receipt-verification

package/examples/sdk-demo-terminal/main.ts

@@ -3,7 +3,7 @@
  *
  * Env:
  *   AUREON_API_KEY  issued developer key (required)
- *   AUREON_NETWORK  optional; omit for official API / testnet 46630; set mainnet for chain 4663
+ *   AUREON_NETWORK  optional; omit for official API / mainnet; set testnet to stay on testnet
  *   AUREON_API_URL  optional override (must match network if both set)
  *
  *   pnpm --filter @buildaureon/sdk example:sdk-demo-terminal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildaureon/sdk",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Official TypeScript SDK for AUREON Financial Compass on Robinhood Chain",
   "type": "module",
   "main": "./dist/index.js",