@buildaureon/sdk 0.1.9 → 0.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +10 -10
- package/config/network.json +3 -3
- package/dist/index.d.ts +9 -9
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/docs/architecture.md +8 -8
- package/docs/auth.md +4 -4
- package/docs/client-api.md +5 -5
- package/docs/data-contracts.md +3 -1
- package/docs/integration-guide.md +1 -1
- package/docs/security.md +1 -1
- package/docs/transport.md +2 -2
- package/examples/ai-to-objective-to-portfolio/main.ts +1 -1
- package/examples/drift-detect-restore/main.ts +1 -1
- package/examples/e2e-policy-rebalance/main.ts +1 -1
- package/examples/e2e-policy-rebalance/underrun.ts +1 -1
- package/examples/e2e-policy-rebalance/verify-sizing.ts +1 -1
- package/examples/e2e-vault-flow/main.ts +1 -1
- package/examples/full-aureon-loop/main.ts +1 -1
- package/examples/green-vs-plan/main.ts +1 -1
- package/examples/market-event/main.ts +1 -1
- package/examples/portfolio-watch/main.ts +1 -1
- package/examples/quickstart/main.ts +1 -1
- package/examples/receipt-verification/main.ts +1 -1
- package/examples/sdk-demo-terminal/main.ts +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,15 @@ All notable changes to `@buildaureon/sdk` are documented in this file.
|
|
|
5
5
|
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
6
6
|
This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.1.10] — 2026-09-13
|
|
9
|
+
|
|
10
|
+
Published on npm as `@buildaureon/sdk@0.1.10`.
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- Omit `network` on the official host now selects **mainnet**. Pass `network: "testnet"` (or `AUREON_NETWORK=testnet`) to stay on testnet on the same host.
|
|
15
|
+
- Every request still sends `X-Aureon-Network`. Public Living Capital remains the testnet console; SDK default is mainnet.
|
|
16
|
+
|
|
8
17
|
## [0.1.9] — 2026-09-08
|
|
9
18
|
|
|
10
19
|
Published on npm as `@buildaureon/sdk@0.1.9`.
|
|
@@ -63,6 +72,7 @@ Public npm release.
|
|
|
63
72
|
|
|
64
73
|
Initial public npm release of `@buildaureon/sdk`.
|
|
65
74
|
|
|
75
|
+
[0.1.10]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.10
|
|
66
76
|
[0.1.9]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.9
|
|
67
77
|
[0.1.8]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.8
|
|
68
78
|
[0.1.7]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.7
|
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ Default network is **Robinhood Chain mainnet** (chain 4663). Confirm live vault
|
|
|
11
11
|
|
|
12
12
|
[](https://www.typescriptlang.org/)
|
|
13
13
|
[](#requirements)
|
|
14
|
-
[](https://github.com/buildaureon)
|
|
15
15
|
[](LICENSE)
|
|
16
16
|
[](#requirements)
|
|
17
17
|
|
|
@@ -170,15 +170,15 @@ flowchart TB
|
|
|
170
170
|
|
|
171
171
|
## Networks
|
|
172
172
|
|
|
173
|
-
Omitted `network` / omitted `baseUrl` uses the official API `https://api.aureonlabs.network` on Robinhood Chain **
|
|
173
|
+
Omitted `network` / omitted `baseUrl` uses the official API `https://api.aureonlabs.network` on Robinhood Chain **mainnet**. Pass `network: "testnet"` (or `AUREON_NETWORK=testnet`) to stay on testnet on the same official host. Set `baseUrl` / `AUREON_API_URL` only to override that host.
|
|
174
174
|
|
|
175
|
-
|
|
175
|
+
Public Living Capital at [app.aureonlabs.network](https://app.aureonlabs.network) is still the testnet console. SDK and MCP omit `network` / `AUREON_NETWORK` and send `X-Aureon-Network: mainnet`. Pass `testnet` to stay on testnet. Issue developer keys at that console. First use: an empty vault Automatic restore returns **409**; `prepareVaultDeposit` returns unsigned steps; the host wallet or MetaMask broadcasts; this SDK and MCP agents never broadcast deposits.
|
|
176
176
|
|
|
177
|
-
| |
|
|
177
|
+
| | Mainnet (default) | Testnet (`network: "testnet"`) |
|
|
178
178
|
| --- | --- | --- |
|
|
179
|
-
| Chain ID |
|
|
179
|
+
| Chain ID | 4663 | 46630 |
|
|
180
180
|
| API | `https://api.aureonlabs.network` | `https://api.aureonlabs.network` |
|
|
181
|
-
| Utility |
|
|
181
|
+
| Utility | Testnet console (Living Capital cutover next) | [app.aureonlabs.network](https://app.aureonlabs.network) |
|
|
182
182
|
|
|
183
183
|
---
|
|
184
184
|
|
|
@@ -350,8 +350,8 @@ async function run() {
|
|
|
350
350
|
const aureon = createAureonClient({
|
|
351
351
|
apiKey: process.env.AUREON_API_KEY!, // issued key from Developers console
|
|
352
352
|
});
|
|
353
|
-
// Default: official API https://api.aureonlabs.network (
|
|
354
|
-
//
|
|
353
|
+
// Default: official API https://api.aureonlabs.network (mainnet).
|
|
354
|
+
// Testnet: createAureonClient({ network: "testnet", apiKey })
|
|
355
355
|
|
|
356
356
|
const me = await aureon.me();
|
|
357
357
|
console.log("wallet", me.walletAddress);
|
|
@@ -541,7 +541,7 @@ await aureon.revokeApiKey(newKey.id);
|
|
|
541
541
|
|
|
542
542
|
| Parameter | Type | Default | Description |
|
|
543
543
|
| --- | --- | --- | --- |
|
|
544
|
-
| `network` | `"mainnet" \| "testnet"` | `"
|
|
544
|
+
| `network` | `"mainnet" \| "testnet"` | `"mainnet"` | Chain selector on the official API. Omit for mainnet. Pass `"testnet"` to stay on testnet. |
|
|
545
545
|
| `baseUrl` | `string` | `https://api.aureonlabs.network` | Leave unset. Override only if you must point at another host. |
|
|
546
546
|
| `apiKey` | `string` | `undefined` | Sent as `X-Aureon-Api-Key` |
|
|
547
547
|
| `authToken` | `string` | `undefined` | Static JWT bearer |
|
|
@@ -655,7 +655,7 @@ Long-form technical docs live under `docs/`:
|
|
|
655
655
|
| [docs/integration-guide.md](docs/integration-guide.md) | End-to-end integrator walkthrough |
|
|
656
656
|
| [docs/security.md](docs/security.md) | API key and token guidance |
|
|
657
657
|
| [docs/transport.md](docs/transport.md) | Retries, headers, transport edge cases |
|
|
658
|
-
| [CHANGELOG.md](CHANGELOG.md) | Published versions, including 0.1.
|
|
658
|
+
| [CHANGELOG.md](CHANGELOG.md) | Published versions, including 0.1.10 mainnet default |
|
|
659
659
|
|
|
660
660
|
---
|
|
661
661
|
|
package/config/network.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"defaultNetwork": "
|
|
3
|
-
"note": "Default API is https://api.aureonlabs.network
|
|
2
|
+
"defaultNetwork": "mainnet",
|
|
3
|
+
"note": "Default API is https://api.aureonlabs.network on mainnet. Pass network=testnet for testnet on the same official host. AUREON_API_URL overrides the host when set. Public Living Capital is still the testnet console.",
|
|
4
4
|
"mainnet": {
|
|
5
5
|
"baseUrl": "https://api.aureonlabs.network",
|
|
6
6
|
"chainId": 4663,
|
|
@@ -16,5 +16,5 @@
|
|
|
16
16
|
"explorer": "https://explorer.testnet.chain.robinhood.com"
|
|
17
17
|
},
|
|
18
18
|
"sdkPackage": "@buildaureon/sdk",
|
|
19
|
-
"sdkVersion": "0.1.
|
|
19
|
+
"sdkVersion": "0.1.10"
|
|
20
20
|
}
|
package/dist/index.d.ts
CHANGED
|
@@ -22,7 +22,7 @@ type AureonNetworkPreset = {
|
|
|
22
22
|
};
|
|
23
23
|
declare const AUREON_NETWORKS: Record<AureonNetwork, AureonNetworkPreset>;
|
|
24
24
|
type ResolveAureonNetworkInput = {
|
|
25
|
-
/** Omit for the official API
|
|
25
|
+
/** Omit for the official API on mainnet. Pass `testnet` to stay on testnet on the same host. */
|
|
26
26
|
network?: string | null;
|
|
27
27
|
/** Override the official API URL. Users should leave this unset. */
|
|
28
28
|
baseUrl?: string | null;
|
|
@@ -32,9 +32,9 @@ declare function inferAureonNetworkFromUrl(url: string): AureonNetwork | null;
|
|
|
32
32
|
/**
|
|
33
33
|
* Resolve network + URL + chainId as one bundle.
|
|
34
34
|
*
|
|
35
|
-
* - Neither set → official API,
|
|
35
|
+
* - Neither set → official API, mainnet.
|
|
36
36
|
* - Only `network` → official API + that chain.
|
|
37
|
-
* - Only `baseUrl` → that URL; official host stays
|
|
37
|
+
* - Only `baseUrl` → that URL; official host stays mainnet unless `network` is set.
|
|
38
38
|
* - Both set: official host is always allowed. Other known hosts must match.
|
|
39
39
|
*/
|
|
40
40
|
declare function resolveAureonNetwork(input?: ResolveAureonNetworkInput): AureonNetworkPreset;
|
|
@@ -821,8 +821,8 @@ declare function createConsoleLogger(prefix?: string): AureonLogger;
|
|
|
821
821
|
|
|
822
822
|
interface AureonClientOptions {
|
|
823
823
|
/**
|
|
824
|
-
* Chain selector. Omit for the official API on
|
|
825
|
-
* Pass `"
|
|
824
|
+
* Chain selector. Omit for the official API on mainnet.
|
|
825
|
+
* Pass `"testnet"` to stay on testnet on the same official host.
|
|
826
826
|
*/
|
|
827
827
|
network?: "mainnet" | "testnet";
|
|
828
828
|
/**
|
|
@@ -1316,8 +1316,8 @@ declare class AureonClient {
|
|
|
1316
1316
|
|
|
1317
1317
|
/**
|
|
1318
1318
|
* Factory for integrators. Omit `baseUrl` to use the official API
|
|
1319
|
-
* (https://api.aureonlabs.network).
|
|
1320
|
-
*
|
|
1319
|
+
* (https://api.aureonlabs.network). Omit `network` for mainnet. Pass
|
|
1320
|
+
* `network: "testnet"` to stay on testnet on the same host.
|
|
1321
1321
|
*/
|
|
1322
1322
|
declare function createAureonClient(options?: AureonClientOptions): AureonClient;
|
|
1323
1323
|
/**
|
|
@@ -1433,13 +1433,13 @@ declare const DEFAULT_API_BASE_URL = "https://api.aureonlabs.network";
|
|
|
1433
1433
|
/** Operator-only local process. Users should not set this. */
|
|
1434
1434
|
declare const LOCAL_API_BASE_URL = "http://127.0.0.1:8788";
|
|
1435
1435
|
declare const DEFAULT_TIMEOUT_MS = 30000;
|
|
1436
|
-
declare const SDK_VERSION = "0.1.
|
|
1436
|
+
declare const SDK_VERSION = "0.1.10";
|
|
1437
1437
|
declare const SDK_NAME = "@buildaureon/sdk";
|
|
1438
1438
|
declare const PRODUCT_NAME = "AUREON";
|
|
1439
1439
|
declare const PRODUCT_TAGLINE = "Financial Compass for Robinhood Chain";
|
|
1440
1440
|
/** HTTP header for product API keys. */
|
|
1441
1441
|
declare const API_KEY_HEADER = "X-Aureon-Api-Key";
|
|
1442
|
-
/** Per-request chain selector. Omit or `
|
|
1442
|
+
/** Per-request chain selector. Omit or `mainnet` → 4663. `testnet` → 46630. */
|
|
1443
1443
|
declare const NETWORK_HEADER = "X-Aureon-Network";
|
|
1444
1444
|
|
|
1445
1445
|
/**
|
package/dist/index.js
CHANGED
|
@@ -58,14 +58,14 @@ function mismatchMessage(network, baseUrl) {
|
|
|
58
58
|
function resolveAureonNetwork(input = {}) {
|
|
59
59
|
const networkRaw = input.network?.trim();
|
|
60
60
|
const networkSpecified = Boolean(networkRaw);
|
|
61
|
-
const network = networkSpecified ? parseNetwork(networkRaw) : "
|
|
61
|
+
const network = networkSpecified ? parseNetwork(networkRaw) : "mainnet";
|
|
62
62
|
const explicitUrl = input.baseUrl?.trim();
|
|
63
63
|
if (!explicitUrl) {
|
|
64
64
|
return { ...AUREON_NETWORKS[network] };
|
|
65
65
|
}
|
|
66
66
|
const baseUrl = stripSlash(explicitUrl);
|
|
67
67
|
if (isOfficialApi(baseUrl)) {
|
|
68
|
-
const resolvedNetwork2 = networkSpecified ? network : "
|
|
68
|
+
const resolvedNetwork2 = networkSpecified ? network : "mainnet";
|
|
69
69
|
const preset2 = AUREON_NETWORKS[resolvedNetwork2];
|
|
70
70
|
return {
|
|
71
71
|
network: resolvedNetwork2,
|
|
@@ -78,7 +78,7 @@ function resolveAureonNetwork(input = {}) {
|
|
|
78
78
|
if (networkSpecified && inferred && inferred !== network) {
|
|
79
79
|
throw new Error(mismatchMessage(network, baseUrl));
|
|
80
80
|
}
|
|
81
|
-
const resolvedNetwork = networkSpecified ? network : inferred ?? "
|
|
81
|
+
const resolvedNetwork = networkSpecified ? network : inferred ?? "mainnet";
|
|
82
82
|
const preset = AUREON_NETWORKS[resolvedNetwork];
|
|
83
83
|
return {
|
|
84
84
|
network: resolvedNetwork,
|
|
@@ -98,7 +98,7 @@ function resolveAureonNetworkFromEnv(env = process.env) {
|
|
|
98
98
|
var DEFAULT_API_BASE_URL = OFFICIAL_API_BASE_URL;
|
|
99
99
|
var LOCAL_API_BASE_URL = "http://127.0.0.1:8788";
|
|
100
100
|
var DEFAULT_TIMEOUT_MS = 3e4;
|
|
101
|
-
var SDK_VERSION = "0.1.
|
|
101
|
+
var SDK_VERSION = "0.1.10";
|
|
102
102
|
var SDK_NAME = "@buildaureon/sdk";
|
|
103
103
|
var PRODUCT_NAME = "AUREON";
|
|
104
104
|
var PRODUCT_TAGLINE = "Financial Compass for Robinhood Chain";
|