@trustware/sdk-staging 1.1.11-staging.2 → 1.1.12-staging.1

package/dist/{blockchain-BxAFzp0s.d.cts → blockchain-DmCPxnxr.d.cts}

@@ -47,10 +47,34 @@ type TokenPageResult = {
     data: TokenDef[];
     pageInfo: TokenPageInfo;
 };
+/**
+ * Terminal state of an address balance scan.
+ *
+ * `partial` is the one field a caller cannot reconstruct from the chunks: the
+ * backend scans every configured chain and reports `partial: true` when any of
+ * them failed, so "no balance on chain X" and "we could not reach chain X" look
+ * identical in the rows themselves. Rendering an empty wallet off a partial
+ * scan is the failure this exists to prevent.
+ */
+type BalanceStreamSummary = {
+    address: string;
+    partial: boolean;
+    /** Chains that reported a result — equal to `total` on a complete scan. */
+    completed: number;
+    total: number;
+    /** Server-side scan duration. Absent on the buffered path, which does not report it. */
+    elapsedMs?: number;
+};
 type BalanceStreamOptions = {
     stream?: boolean;
     signal?: AbortSignal;
     strict?: boolean;
+    /**
+     * Called once per scan with its terminal state, on the streamed and buffered
+     * paths alike — including when a stream fails and falls back — so a consumer
+     * can trust `partial` without knowing which path served it.
+     */
+    onSummary?: (summary: BalanceStreamSummary) => void;
 };
 type GetBalancesOptions = {
     /** Bypass the in-memory balance cache and re-fetch fresh data from the network. */
@@ -111,4 +135,4 @@ type TokenWithBalance = TokenDef & {
     balance?: bigint;
 };
 
-export type { BalanceRow as B, ChainDef as C, GetBalancesOptions as G, NativeCurrency as N, TokenDef as T, WalletAddressBalanceWrapper as W, BalanceStreamOptions as a, ChainMeta as b, ChainType as c, TokenMeta as d, TokenPageInfo as e, TokenPageOptions as f, TokenPageResult as g, TokenType as h, TokenWithBalance as i };
+export type { BalanceRow as B, ChainDef as C, GetBalancesOptions as G, NativeCurrency as N, TokenDef as T, WalletAddressBalanceWrapper as W, BalanceStreamOptions as a, BalanceStreamSummary as b, ChainMeta as c, ChainType as d, TokenMeta as e, TokenPageInfo as f, TokenPageOptions as g, TokenPageResult as h, TokenType as i, TokenWithBalance as j };

package/dist/{blockchain-BxAFzp0s.d.ts → blockchain-DmCPxnxr.d.ts}

@@ -47,10 +47,34 @@ type TokenPageResult = {
     data: TokenDef[];
     pageInfo: TokenPageInfo;
 };
+/**
+ * Terminal state of an address balance scan.
+ *
+ * `partial` is the one field a caller cannot reconstruct from the chunks: the
+ * backend scans every configured chain and reports `partial: true` when any of
+ * them failed, so "no balance on chain X" and "we could not reach chain X" look
+ * identical in the rows themselves. Rendering an empty wallet off a partial
+ * scan is the failure this exists to prevent.
+ */
+type BalanceStreamSummary = {
+    address: string;
+    partial: boolean;
+    /** Chains that reported a result — equal to `total` on a complete scan. */
+    completed: number;
+    total: number;
+    /** Server-side scan duration. Absent on the buffered path, which does not report it. */
+    elapsedMs?: number;
+};
 type BalanceStreamOptions = {
     stream?: boolean;
     signal?: AbortSignal;
     strict?: boolean;
+    /**
+     * Called once per scan with its terminal state, on the streamed and buffered
+     * paths alike — including when a stream fails and falls back — so a consumer
+     * can trust `partial` without knowing which path served it.
+     */
+    onSummary?: (summary: BalanceStreamSummary) => void;
 };
 type GetBalancesOptions = {
     /** Bypass the in-memory balance cache and re-fetch fresh data from the network. */
@@ -111,4 +135,4 @@ type TokenWithBalance = TokenDef & {
     balance?: bigint;
 };
 
-export type { BalanceRow as B, ChainDef as C, GetBalancesOptions as G, NativeCurrency as N, TokenDef as T, WalletAddressBalanceWrapper as W, BalanceStreamOptions as a, ChainMeta as b, ChainType as c, TokenMeta as d, TokenPageInfo as e, TokenPageOptions as f, TokenPageResult as g, TokenType as h, TokenWithBalance as i };
+export type { BalanceRow as B, ChainDef as C, GetBalancesOptions as G, NativeCurrency as N, TokenDef as T, WalletAddressBalanceWrapper as W, BalanceStreamOptions as a, BalanceStreamSummary as b, ChainMeta as c, ChainType as d, TokenMeta as e, TokenPageInfo as f, TokenPageOptions as g, TokenPageResult as h, TokenType as i, TokenWithBalance as j };

package/dist/constants.cjs

@@ -30,7 +30,7 @@ __export(constants_exports, {
 });
 module.exports = __toCommonJS(constants_exports);
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.1.11-staging.2";
+var SDK_VERSION = "1.1.12-staging.1";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/constants.mjs

@@ -1,6 +1,6 @@
 // src/constants.ts
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.1.11-staging.2";
+var SDK_VERSION = "1.1.12-staging.1";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/{core-B1WCJfDI.d.ts → core-B4YDGtJT.d.ts}

@@ -1,6 +1,6 @@
-import { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, A as ResolvedTrustwareConfig, X as TrustwareTheme, a2 as WalletIdentity, w as walletManager, Z as WalletAddressResolution, aa as buildRoute, ab as buildDepositAddress, ac as submitReceipt, ad as submitStepReceipt, ae as getStatus, af as pollStatus } from './manager-Bw8b1wSD.js';
-import { C as ChainDef, c as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-BxAFzp0s.js';
-import { T as Token } from './types-BJY9r-mz.js';
+import { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, A as ResolvedTrustwareConfig, X as TrustwareTheme, a2 as WalletIdentity, w as walletManager, Z as WalletAddressResolution, aa as buildRoute, ab as buildDepositAddress, ac as submitReceipt, ad as submitStepReceipt, ae as getStatus, af as pollStatus } from './manager-D8nQsod2.js';
+import { C as ChainDef, d as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-DmCPxnxr.js';
+import { T as Token } from './types-CMmx0S4U.js';
 
 type AddressValidationResult = {
     isValid: boolean;

package/dist/{core-CeNTuqPz.d.cts → core-Ck7dinYj.d.cts}

@@ -1,6 +1,6 @@
-import { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, A as ResolvedTrustwareConfig, X as TrustwareTheme, a2 as WalletIdentity, w as walletManager, Z as WalletAddressResolution, aa as buildRoute, ab as buildDepositAddress, ac as submitReceipt, ad as submitStepReceipt, ae as getStatus, af as pollStatus } from './manager-DNGk1YkR.cjs';
-import { C as ChainDef, c as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-BxAFzp0s.cjs';
-import { T as Token } from './types-DX3HtFcn.cjs';
+import { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, A as ResolvedTrustwareConfig, X as TrustwareTheme, a2 as WalletIdentity, w as walletManager, Z as WalletAddressResolution, aa as buildRoute, ab as buildDepositAddress, ac as submitReceipt, ad as submitStepReceipt, ae as getStatus, af as pollStatus } from './manager-BZ8gyHGT.cjs';
+import { C as ChainDef, d as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-DmCPxnxr.cjs';
+import { T as Token } from './types-DEUb5IZA.cjs';
 
 type AddressValidationResult = {
     isValid: boolean;

package/dist/core.cjs

@@ -57,7 +57,17 @@ var init_config = __esm({
     RATE_LIMIT_WAIT_BUDGET_MS = 1e4;
     DEFAULT_FEATURE_FLAGS = {
       tokensPagination: true,
-      balanceStreaming: false,
+      // On by default: an address scan covers every configured chain and takes
+      // seconds end to end, so streaming turns one long wait into a wallet that
+      // fills in as results land — first chunk in ~200ms against a ~2.3s buffered
+      // response, measured on a live backend.
+      //
+      // Safe to default because the path degrades on its own: a backend with
+      // BALANCE_STREAM_ENABLED off refuses the stream, and the SDK falls back to
+      // the buffered endpoint (emitting balance_stream_fallback), as does any
+      // runtime whose fetch has no readable body — React Native, most notably.
+      // The cost of defaulting ahead of a backend is one refused request per scan.
+      balanceStreaming: true,
       shouldAllowGA4: true,
       swapMode: false,
       swapDefaultDestToken: null,
@@ -73,7 +83,7 @@ var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
     SDK_NAME = "@trustware/sdk";
-    SDK_VERSION = "1.1.11-staging.2";
+    SDK_VERSION = "1.1.12-staging.1";
     API_ROOT = "https://bv-staging-api.trustware.io";
     API_PREFIX = "/api";
     WALLETCONNECT_PROJECT_ID = "72ea74c400f5111d43aea638d7d83a24";
@@ -116,7 +126,7 @@ async function assertOK(r) {
   throw new Error(`HTTP ${r.status}: ${msg}`);
 }
 async function validateSdkAccess() {
-  const r = await fetch(`${apiBase()}/sdk/validate`, {
+  const r = await fetch(`${apiBase()}/v1/sdk/validate`, {
     method: "GET",
     headers: jsonHeaders()
   });
@@ -1799,6 +1809,16 @@ function mergeBalanceWrappers(current, incoming) {
   }
   return Array.from(merged.values());
 }
+function toSummary(frame, address) {
+  const total = toNumberOrUndefined(frame.total) ?? 0;
+  return {
+    address: toStringOrUndefined(frame.address) ?? address,
+    partial: Boolean(frame.partial),
+    completed: toNumberOrUndefined(frame.completed) ?? 0,
+    total,
+    elapsedMs: toNumberOrUndefined(frame.elapsed)
+  };
+}
 async function parseStreamingBalances(response, address, options = {}) {
   if (!response.body) {
     throw new Error("balances stream: empty response body");
@@ -1819,7 +1839,12 @@ async function parseStreamingBalances(response, address, options = {}) {
           if (!trimmed) continue;
           try {
             const parsed = JSON.parse(trimmed);
-            if (!parsed.chain_id) continue;
+            if (!parsed.chain_id) {
+              if (parsed.type === "summary") {
+                options.onSummary?.(toSummary(parsed, address));
+              }
+              continue;
+            }
             const chunk = normalizeStreamChunk(parsed);
             emitBalanceStreamChunk(address, chunk.length);
             yield chunk;
@@ -1838,6 +1863,8 @@ async function parseStreamingBalances(response, address, options = {}) {
             const chunk = normalizeStreamChunk(parsed);
             emitBalanceStreamChunk(address, chunk.length);
             yield chunk;
+          } else if (parsed.type === "summary") {
+            options.onSummary?.(toSummary(parsed, address));
           }
         } catch (error) {
           if (options.strict) {
@@ -1892,7 +1919,7 @@ async function getBalancesByAddress(address, opts) {
     }
     return merged;
   }
-  const url = `${apiBase()}/data/balances/${address}`;
+  const url = `${apiBase()}/v1/data/balances/${address}`;
   const r = await rateLimitedFetch(url, {
     method: "GET",
     credentials: "omit",
@@ -1900,14 +1927,27 @@ async function getBalancesByAddress(address, opts) {
   });
   if (!r.ok) throw new Error(`balances: HTTP ${r.status}`);
   const j = await r.json();
-  return Array.isArray(j) ? j : j.results ?? [];
+  const results = Array.isArray(j) ? j : j.results ?? [];
+  if (opts?.onSummary) {
+    const completed = results.length;
+    opts.onSummary({
+      address,
+      partial: Array.isArray(j) ? false : Boolean(j.partial),
+      completed,
+      total: completed
+    });
+  }
+  return results;
+}
+function bufferedOptions(opts) {
+  return { ...opts, stream: false };
 }
 async function* getBalancesByAddressStream(address, opts = {}) {
   if (!TrustwareConfigStore.get().features.balanceStreaming) {
-    yield await getBalancesByAddress(address);
+    yield await getBalancesByAddress(address, bufferedOptions(opts));
     return;
   }
-  const url = `${apiBase()}/data/balances/${address}?stream=1`;
+  const url = `${apiBase()}/v1/data/balances/${address}?stream=1`;
   try {
     const response = await rateLimitedFetch(url, {
       method: "GET",
@@ -1923,7 +1963,14 @@ async function* getBalancesByAddressStream(address, opts = {}) {
     const contentType = response.headers.get("content-type") ?? "";
     if (contentType.includes("application/json")) {
       const payload = await response.json();
-      yield Array.isArray(payload) ? payload : payload.results ?? [];
+      const results = Array.isArray(payload) ? payload : payload.results ?? [];
+      opts.onSummary?.({
+        address,
+        partial: Array.isArray(payload) ? false : Boolean(payload.partial),
+        completed: results.length,
+        total: results.length
+      });
+      yield results;
       return;
     }
     const stream = await parseStreamingBalances(response, address, opts);
@@ -1932,7 +1979,7 @@ async function* getBalancesByAddressStream(address, opts = {}) {
     }
   } catch (error) {
     emitBalanceStreamFallback(address, error);
-    yield await getBalancesByAddress(address);
+    yield await getBalancesByAddress(address, bufferedOptions(opts));
   }
 }
 async function ensureRegistry() {