@buildaureon/sdk 0.1.7 → 0.1.9
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 +71 -0
- package/README.md +673 -655
- package/config/network.json +17 -7
- package/dist/index.d.ts +71 -14
- package/dist/index.js +109 -10
- package/dist/index.js.map +1 -1
- package/docs/architecture.md +210 -206
- package/docs/auth.md +176 -174
- package/docs/client-api.md +788 -782
- package/docs/data-contracts.md +3 -3
- package/docs/error-model.md +217 -217
- package/docs/integration-guide.md +400 -397
- package/docs/receipt-validation.md +66 -63
- package/docs/security.md +120 -120
- package/docs/transport.md +143 -142
- package/examples/ai-to-objective-to-portfolio/main.ts +6 -3
- package/examples/audit-trail/main.ts +4 -2
- package/examples/drift-detect-restore/main.ts +6 -3
- package/examples/e2e-policy-rebalance/main.ts +431 -426
- package/examples/e2e-policy-rebalance/underrun.ts +143 -138
- package/examples/e2e-policy-rebalance/verify-sizing.ts +155 -150
- package/examples/e2e-vault-flow/main.ts +221 -216
- package/examples/full-aureon-loop/main.ts +6 -3
- package/examples/green-vs-plan/main.ts +6 -3
- package/examples/market-event/main.ts +6 -3
- package/examples/portfolio-watch/main.ts +6 -3
- package/examples/quickstart/main.ts +75 -72
- package/examples/receipt-verification/main.ts +6 -3
- package/examples/sdk-demo-terminal/main.ts +6 -4
- package/package.json +26 -23
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@buildaureon/sdk` are documented in this file.
|
|
4
|
+
|
|
5
|
+
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
6
|
+
This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [0.1.9] — 2026-09-08
|
|
9
|
+
|
|
10
|
+
Published on npm as `@buildaureon/sdk@0.1.9`.
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- Default API is the official host `https://api.aureonlabs.network`. Omit `network` for testnet **46630**. Pass `network: "mainnet"` for chain **4663** on the same host.
|
|
15
|
+
- Every request sends `X-Aureon-Network` so one hosted API can serve both chains.
|
|
16
|
+
- `OFFICIAL_API_BASE_URL` exported. `createLocalAureonClient()` remains operator-only (`http://127.0.0.1:8788`).
|
|
17
|
+
- Official host is allowed with either network. Ports are no longer a product switch.
|
|
18
|
+
|
|
19
|
+
## [0.1.8] — 2026-09-08
|
|
20
|
+
|
|
21
|
+
Published on npm as `@buildaureon/sdk@0.1.8`.
|
|
22
|
+
|
|
23
|
+
### Added
|
|
24
|
+
|
|
25
|
+
- Optional `network` on `createAureonClient`: `"mainnet"` (default) or `"testnet"`.
|
|
26
|
+
- `resolveAureonNetwork()` and `resolveAureonNetworkFromEnv()` for shared SDK and MCP resolution.
|
|
27
|
+
- Named exports `MAINNET_API_BASE_URL` and `TESTNET_API_BASE_URL`.
|
|
28
|
+
- Local helper `createLocalAureonClient()` bound to `http://127.0.0.1:8788` / chain 4663 (rejects `network: "testnet"`).
|
|
29
|
+
|
|
30
|
+
### Changed
|
|
31
|
+
|
|
32
|
+
- Omitted `network` and omitted `baseUrl` now resolve to **Robinhood Chain mainnet** (chain **4663**, API `http://127.0.0.1:8788`, explorer `https://robinhoodchain.blockscout.com`). Cash park on this path is **USDG**.
|
|
33
|
+
- `network: "testnet"` (or `AUREON_NETWORK=testnet`) selects the public host `https://api.aureonlabs.network`, which remains chain **46630**.
|
|
34
|
+
- Mixed known host and `network` values throw instead of silently picking one.
|
|
35
|
+
- Explicit `baseUrl` / `AUREON_API_URL` still win when they agree with `network`.
|
|
36
|
+
- `DEFAULT_API_BASE_URL` remains the **testnet public-host export**. The omitted client default is 8788 / 4663. Both are documented.
|
|
37
|
+
|
|
38
|
+
### First use (same as testnet)
|
|
39
|
+
|
|
40
|
+
- Empty vault Automatic restore returns **409**. The client does not treat that as a successful restore.
|
|
41
|
+
- `prepareVaultDeposit` / `prepareVaultWithdraw` return **unsigned** calldata.
|
|
42
|
+
- The host wallet or MetaMask broadcasts. MCP agents never broadcast deposits. End users fund the vault when they use the product.
|
|
43
|
+
|
|
44
|
+
### Documentation
|
|
45
|
+
|
|
46
|
+
- README networks table, first-use restore path, and version badge **0.1.8**.
|
|
47
|
+
- Architecture, auth, client-api, transport, security, and integration-guide aligned to mainnet default and 409-then-prepare.
|
|
48
|
+
- Removed a stale contract address from the README intro. Confirm live addresses from the API you call.
|
|
49
|
+
|
|
50
|
+
## [0.1.7] — 2026-09-07
|
|
51
|
+
|
|
52
|
+
Previous public npm release. Typed client for the AUREON Financial Compass: wallet session, Capital Book, objectives, health, vault prepare, restore receipts, and CLI.
|
|
53
|
+
|
|
54
|
+
## [0.1.2] — 2026-08-14
|
|
55
|
+
|
|
56
|
+
Public npm release.
|
|
57
|
+
|
|
58
|
+
## [0.1.1] — 2026-07-23
|
|
59
|
+
|
|
60
|
+
Public npm release.
|
|
61
|
+
|
|
62
|
+
## [0.1.0] — 2026-07-16
|
|
63
|
+
|
|
64
|
+
Initial public npm release of `@buildaureon/sdk`.
|
|
65
|
+
|
|
66
|
+
[0.1.9]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.9
|
|
67
|
+
[0.1.8]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.8
|
|
68
|
+
[0.1.7]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.7
|
|
69
|
+
[0.1.2]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.2
|
|
70
|
+
[0.1.1]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.1
|
|
71
|
+
[0.1.0]: https://www.npmjs.com/package/@buildaureon/sdk/v/0.1.0
|