@agg-build/sdk 4.0.0 → 4.0.1

package/README.md

@@ -252,8 +252,7 @@ Call `client.destroy()` when you no longer need the client to release internal r
 | Method                        | Description                                          |
 | ----------------------------- | ---------------------------------------------------- |
 | `validateManaged(params)`     | Check balances and bridge requirements               |
-| `quoteManaged(params)`        | Request a 2-min TTL quote with execution steps       |
-| `executeManaged(params)`      | Execute a previously quoted trade                    |
+| `executeManaged(params)`      | Fill a quote from `getSmartRoute()` — see note below |
 | `withdrawManaged(params)`     | Withdraw from managed wallets to an external address |
 | `withdrawPreview(params)`     | Preview withdrawal receive amount and route fees     |
 | `getWithdrawalQuote(params)`  | Quote the maximum deliverable withdrawal amount      |
@@ -263,6 +262,18 @@ Call `client.destroy()` when you no longer need the client to release internal r
 | `getManagedBalances()`        | Get managed wallet balances per-chain + per-venue    |
 | `getDepositAddresses()`       | Get managed wallet deposit addresses (EVM + Solana)  |
 
+To quote and fill a managed trade, take the quote from `getSmartRoute()` and pass
+its `quoteId` to `executeManaged()`:
+
+```ts
+const route = await client.getSmartRoute({ venueMarketOutcomeId, side, amount });
+await client.executeManaged({ quoteId: route.quoteId });
+```
+
+> **Removed in v4.** `quoteManaged()` was deleted — its endpoint,
+> `POST /execution/quote`, does not exist on the API, so the call only ever
+> returned 404. Use the two-step flow above.
+
 #### Orders & positions
 
 | Method                           | Description                                  |
@@ -296,6 +307,33 @@ Call `client.destroy()` when you no longer need the client to release internal r
 | `mergeCandles`              | Merge live + historical candles, live-wins on collision         |
 | `mergeClosedCandles`        | Variant that merges only fully closed candles                   |
 | `TurnstileChallengeError`   | Thrown when an auth endpoint requires a Turnstile challenge     |
+| `AggApiError`               | Thrown for every non-2xx API response — see below               |
+| `isAggApiError`             | Type guard for `AggApiError`                                    |
+
+### Error handling
+
+Every non-2xx response is thrown as an `AggApiError` carrying `status`, and —
+when the API supplies them — `code`, `retryable` and per-field `errors`. Branch
+on `status`/`code` rather than matching message text; messages are human-facing
+and may be reworded.
+
+```ts
+import { isAggApiError } from "@agg-build/sdk";
+
+try {
+  await client.getPositions();
+} catch (err) {
+  if (isAggApiError(err)) {
+    if (err.status === 401) return promptReconnect(); // session lapsed
+    if (err.code === "unregistered_domain") {
+      // The signed SIWE `domain` is not in the app's allowedOrigins.
+      // Note this is NOT the Origin header — sign-in works with no Origin
+      // at all, which is what makes Node and React Native work.
+    }
+  }
+  throw err;
+}
+```
 
 ### `@agg-build/sdk/server`
 
@@ -350,8 +388,19 @@ Key behaviors:
 
 ## Peer dependencies
 
-None. `@agg-build/sdk` is dependency-light and bundles its own clients for `viem`, `ethers@5`,
-`@polymarket/clob-client`, and `@polymarket/builder-signing-sdk`.
+None — and as of v4, no runtime dependencies either. The only module the bundle
+imports is `node:crypto` (used by `@agg-build/sdk/server`), so a fresh install is
+under 1 MB with nothing transitive.
+
+Bring your own wallet library. The SDK builds SIWE/SIWS message strings and never
+signs anything itself, so `viem`, `ethers`, or any other signer works — you pass
+in a `signMessage` function.
+
+> **Changed in v4.** Earlier versions declared `viem`, `ethers@5`,
+> `@polymarket/clob-client` and `@polymarket/builder-signing-sdk` as runtime
+> dependencies. No code path ever imported them, but installers still paid for
+> them — roughly 100 MB of `node_modules` across their transitive trees. They
+> were removed in v4; nothing in the SDK's behaviour changed.
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Vanilla TypeScript client for the AGG prediction market aggregator (auth, markets, orderbooks, charts, trading, managed execution, WebSockets). Works in browsers, Node.js, and React Native.",
   "sideEffects": false,
   "license": "MIT",