@xyo-network/react-chain-client 1.20.24 → 1.20.26

package/dist/browser/context/GatewayContext.d.ts

@@ -1,3 +1,23 @@
+/**
+ * Shared React context that decouples gateway *sources* from gateway
+ * *consumers*. Any provider that can resolve an `XyoGateway` publishes to
+ * this context; any hook or component that needs a gateway reads from it
+ * via `useProvidedGateway`. Consumers never import a specific provider —
+ * they just require that *some* provider is mounted above them in the
+ * tree.
+ *
+ * Current publishers:
+ * - `WalletGatewayProvider` (this package) — sources gateways from the
+ *   injected XL1 wallet extension.
+ * - `GatewayProvider` in `@xyo-network/react-chain-provider` — sources
+ *   gateways built in-page against RPC endpoints, falling back to the
+ *   wallet when available.
+ *
+ * To add a new source (e.g. a mock provider for tests, an iframe-bridged
+ * provider, a server-rendered provider), publish a `GatewayContextState`
+ * to this same context — do not create a parallel context, or consumers
+ * will silently stop receiving updates.
+ */
 export declare const GatewayContext: import("react").Context<(import("./GatewayProviderState.ts").GatewayStateFields & {
     provided: true;
 }) | (import("@xylabs/react-shared").FixedValues<import("@xylabs/react-shared").ProvidedContextExState<import("./GatewayProviderState.ts").GatewayStateFields>, never> & {

package/dist/browser/context/GatewayContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GatewayContext.d.ts","sourceRoot":"","sources":["../../../src/context/GatewayContext.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;GAAyC,CAAA"}
+{"version":3,"file":"GatewayContext.d.ts","sourceRoot":"","sources":["../../../src/context/GatewayContext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc;;;;;;GAAyC,CAAA"}

package/dist/browser/context/GatewayProviderState.d.ts

@@ -1,5 +1,25 @@
 import type { ContextExState } from '@xylabs/react-shared';
 import type { ContextGatewayType } from '../types/index.ts';
+/**
+ * The common surface area published to `GatewayContext`. Every gateway
+ * provider — wallet-backed, in-page, mock, or otherwise — must emit this
+ * shape so that consumers can ignore where the gateway came from.
+ *
+ * Fields use a three-state contract:
+ * - `undefined` — resolution is still in progress; show a loading state.
+ * - `null` — resolution completed and the gateway is definitively absent
+ *   (e.g. no wallet installed, RPC unreachable); safe to show fallback UI.
+ * - `XyoGateway` — resolved and ready to use.
+ *
+ * `defaultGateway` is what most consumers want — the provider picks the
+ * best available source. `gateways` exposes the individual sources for
+ * the rare consumer that needs to differentiate (e.g. a debug panel, or
+ * a flow that must sign with the wallet specifically).
+ *
+ * `resetGatewaysFromConfig` is optional because not every provider has
+ * rebuildable in-page gateways (the wallet-only provider, for instance,
+ * has nothing to reset).
+ */
 export interface GatewayStateFields {
     defaultGateway: ContextGatewayType | undefined | null;
     error: Error | null | undefined;

package/dist/browser/context/GatewayProviderState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GatewayProviderState.d.ts","sourceRoot":"","sources":["../../../src/context/GatewayProviderState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;IACrD,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,QAAQ,EAAE;QACR,aAAa,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;QACpD,aAAa,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;KACrD,CAAA;IACD,uBAAuB,CAAC,EAAE,MAAM,IAAI,CAAA;CACrC;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"GatewayProviderState.d.ts","sourceRoot":"","sources":["../../../src/context/GatewayProviderState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;IACrD,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,QAAQ,EAAE;QACR,aAAa,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;QACpD,aAAa,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAA;KACrD,CAAA;IACD,uBAAuB,CAAC,EAAE,MAAM,IAAI,CAAA;CACrC;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAA"}

package/dist/browser/context/in-page/InPageGatewaysContext.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Narrow, provider-internal context that `InPageGatewaysProvider` writes
+ * to and `GatewayProvider` reads from. Do not consume this in application
+ * code — use `useProvidedGateway` (which reads the shared
+ * `GatewayContext`) instead. This context only exists to decouple the
+ * single in-page *builder* from the many single-gateway *adapters* that
+ * sit between it and the shared gateway surface.
+ */
+export declare const InPageGatewaysContext: import("react").Context<(import("./InPageGatewaysState.ts").InPageGatewaysStateFields & {
+    provided: true;
+}) | (import("@xylabs/react-shared").FixedValues<import("@xylabs/react-shared").ProvidedContextExState<import("./InPageGatewaysState.ts").InPageGatewaysStateFields>, never> & {
+    provided: false;
+}) | (import("@xylabs/react-shared").FixedValues<import("@xylabs/react-shared").NotProvidedContextExState<import("./InPageGatewaysState.ts").InPageGatewaysStateFields>, never> & {
+    provided: false;
+})>;
+//# sourceMappingURL=InPageGatewaysContext.d.ts.map

package/dist/browser/context/in-page/InPageGatewaysContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InPageGatewaysContext.d.ts","sourceRoot":"","sources":["../../../../src/context/in-page/InPageGatewaysContext.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;GAAyC,CAAA"}

package/dist/browser/context/in-page/InPageGatewaysState.d.ts

@@ -0,0 +1,21 @@
+import type { ContextExState } from '@xylabs/react-shared';
+import type { GatewayName } from '@xyo-network/xl1-sdk';
+import type { ContextGatewayType } from '../../types/index.ts';
+/**
+ * Internal handoff shape published by `InPageGatewaysProvider` and
+ * consumed by `GatewayProvider`. Unlike `GatewayContextState`, this is a
+ * *map* of gateways keyed by network id — one builder near the tree root
+ * computes every network's gateway once, and individual `GatewayProvider`
+ * instances deeper in the tree pick out the one they need.
+ *
+ * This is not the cross-publisher surface area; consumers that want "a
+ * gateway" should read the shared `GatewayContext` via
+ * `useProvidedGateway`, not this map directly.
+ */
+export interface InPageGatewaysStateFields {
+    clearAll: () => void;
+    errors: Partial<Record<GatewayName, Error>>;
+    gateways: Partial<Record<GatewayName, ContextGatewayType>>;
+}
+export type InPageGatewaysState = ContextExState<InPageGatewaysStateFields>;
+//# sourceMappingURL=InPageGatewaysState.d.ts.map

package/dist/browser/context/in-page/InPageGatewaysState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InPageGatewaysState.d.ts","sourceRoot":"","sources":["../../../../src/context/in-page/InPageGatewaysState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3C,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAA;CAC3D;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAAA"}

package/dist/browser/context/in-page/Provider.d.ts

@@ -0,0 +1,60 @@
+import type { RpcTransport, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
+import type { PropsWithChildren } from 'react';
+import React from 'react';
+export interface InPageGatewaysProviderProps extends PropsWithChildren {
+    signerTransport?: RpcTransport<XyoSignerRpcSchemas>;
+}
+/**
+ * Publishes a keyed map of in-page gateways — one per network in
+ * `DefaultNetworks` — under the narrow `InPageGatewaysContext`.
+ *
+ * This provider is deliberately *not* a direct publisher of the shared
+ * `GatewayContext` that `useProvidedGateway` reads. Its consumer is the
+ * wrapping `GatewayProvider` in this same package, which picks the
+ * `gatewayName` the consumer asked for out of this map, adapts it into
+ * the single-gateway `GatewayContextState` shape, and then publishes *that*
+ * to the shared context. Splitting the work this way lets one
+ * `InPageGatewaysProvider` near the root build every network's gateway
+ * once, while many `GatewayProvider` instances deeper in the tree each
+ * expose whichever gateway their subtree cares about.
+ *
+ * Unlike `WalletGatewayProvider`, gateways here are constructed directly
+ * in the page (via `buildGateway`) against each network's RPC endpoint
+ * — no browser wallet extension is required. `signerTransport` switches
+ * between viewer (read-only) and runner (can sign/send) locators; supply
+ * it only when the app needs to sign.
+ *
+ * Behavior:
+ * - On mount, and whenever `signerTransport` changes, `buildGateway` is
+ *   called in parallel for every network in `DefaultNetworks` via
+ *   `Promise.allSettled`. Networks that resolve populate `gateways[id]`;
+ *   networks that reject populate `errors[id]`. One failed network does
+ *   not block the others.
+ * - If `signerTransport` is provided, gateways are built with a remote
+ *   *runner* locator, otherwise with a remote *viewer* locator.
+ * - When `signerTransport` changes identity mid-life, the provider clears
+ *   all cached gateways and errors synchronously during render (via
+ *   `previousSignerTransport` state) so consumers never see gateways
+ *   bound to the previous transport, then rebuilds in the effect.
+ * - State updates from the rebuild are wrapped in `startTransition` so a
+ *   slow network doesn't stall higher-priority UI updates.
+ * - A `cancelled` flag in the effect's cleanup discards results from a
+ *   prior `signerTransport` once a new one is in flight.
+ *
+ * Published `InPageGatewaysState` (narrower than `GatewayContextState` —
+ * this is an internal handoff shape, not the cross-publisher surface):
+ * - `gateways` — `Partial<Record<GatewayName, ContextGatewayType>>`. Keys
+ *   are only present for networks that built successfully.
+ * - `errors` — `Partial<Record<GatewayName, Error>>`. Per-network build
+ *   failures, keyed by `GatewayName`.
+ * - `clearAll()` — manually empties both maps. Also invoked internally on
+ *   transport changes. Forwarded by `GatewayProvider` to consumers as
+ *   `resetGatewaysFromConfig`.
+ * - `provided: true` — lets descendants detect a real provider.
+ *
+ * Note: the commented-out `SimpleXyoClient` at the top is intentionally
+ * disabled pending a type unification between `XyoGateway` and
+ * `XyoGatewayRunner`.
+ */
+export declare const InPageGatewaysProvider: React.FC<InPageGatewaysProviderProps>;
+//# sourceMappingURL=Provider.d.ts.map

package/dist/browser/context/in-page/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../src/context/in-page/Provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACG,YAAY,EAAE,mBAAmB,EAC/C,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,KAGN,MAAM,OAAO,CAAA;AAOd,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAmExE,CAAA"}

package/dist/browser/context/in-page/index.d.ts

@@ -0,0 +1,5 @@
+export * from './InPageGatewaysContext.ts';
+export * from './InPageGatewaysState.ts';
+export * from './Provider.tsx';
+export * from './useProvidedInPageGateways.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/context/in-page/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/context/in-page/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gCAAgC,CAAA"}

package/dist/browser/context/in-page/lib/buildGateway.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayName, RpcTransport, SimpleXyoGateway, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
+export declare const buildGateway: (gatewayName: GatewayName, signerTransport?: RpcTransport<XyoSignerRpcSchemas>) => Promise<import("@xyo-network/xl1-sdk").CreatableProviderInstance<SimpleXyoGateway>>;
+//# sourceMappingURL=buildGateway.d.ts.map

package/dist/browser/context/in-page/lib/buildGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../src/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACG,YAAY,EAAE,gBAAgB,EAC5C,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAO7B,eAAO,MAAM,YAAY,GAAU,aAAa,WAAW,EAAE,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,wFAkB/G,CAAA"}

package/dist/browser/context/in-page/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * from './buildGateway.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/context/in-page/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/context/in-page/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/browser/context/in-page/useProvidedInPageGateways.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reads the `InPageGatewaysContext` map of per-network in-page gateways.
+ * Intended for internal use by `GatewayProvider` — application code
+ * should prefer `useProvidedGateway`, which returns a single resolved
+ * gateway regardless of source.
+ *
+ * @param required - When `true` (default), throws if no
+ *   `InPageGatewaysProvider` is mounted above.
+ */
+export declare const useProvidedInPageGateways: (required?: boolean) => Omit<import("./InPageGatewaysState.ts").InPageGatewaysStateFields & {
+    provided: true;
+}, "provided"> | Omit<import("@xylabs/react-shared").NotProvidedContextExState<import("./InPageGatewaysState.ts").InPageGatewaysState>, "provided">;
+//# sourceMappingURL=useProvidedInPageGateways.d.ts.map

package/dist/browser/context/in-page/useProvidedInPageGateways.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProvidedInPageGateways.d.ts","sourceRoot":"","sources":["../../../../src/context/in-page/useProvidedInPageGateways.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAI,kBAAe;;mJAAoE,CAAA"}

package/dist/browser/context/index.d.ts

@@ -1,6 +1,7 @@
 export * from './GatewayContext.ts';
 export * from './GatewayProviderProps.ts';
 export * from './GatewayProviderState.ts';
+export * from './in-page/index.ts';
+export * from './providers/index.ts';
 export * from './useProvidedGateway.ts';
-export * from './WalletGatewayProvider.tsx';
 //# sourceMappingURL=index.d.ts.map

package/dist/browser/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA"}

package/dist/browser/context/providers/GatewayProvider.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+import type { GatewayProviderProps } from '../GatewayProviderProps.ts';
+/**
+ * Publishes the shared `GatewayContext` backed by two sources: the
+ * injected XL1 Wallet extension *and* the in-page gateways built by
+ * `InPageGatewaysProvider`. Use this provider when the host app can
+ * function without a wallet (falling back to the in-page client) but
+ * should still prefer the wallet when it is present.
+ *
+ * Required ancestry: an `InPageGatewaysProvider` must be mounted above
+ * this provider — `useProvidedInPageGateways(true)` throws if missing.
+ * If you only need a wallet-backed gateway, use `WalletGatewayProvider`
+ * instead.
+ *
+ * Source precedence for `defaultGateway`:
+ * - Wallet present and resolved (`XyoGatewayRunner`) → wallet wins; the
+ *   in-page gateway is still exposed via `gateways.inPageGateway` for
+ *   the rare consumer that needs to target it specifically.
+ * - Wallet definitively absent (`null`) → fall back to the in-page
+ *   gateway matching `gatewayName`.
+ * - Wallet still resolving (`undefined`) → leave `defaultGateway`
+ *   `undefined` so consumers render a loading state rather than
+ *   committing to the in-page fallback prematurely.
+ *
+ * The published `GatewayContextState` shape:
+ * - `defaultGateway` — resolved per the precedence above. Three-state:
+ *   `undefined` = loading, `null` is not produced by this provider
+ *   (wallet-null collapses to `gatewayFromConfig`), `XyoGateway` = ready.
+ * - `gateways.walletGateway` — raw wallet result (tri-state).
+ * - `gateways.inPageGateway` — raw in-page result for the requested
+ *   `gatewayName`, or `undefined` if no `gatewayName` was passed.
+ * - `error` — first non-null of wallet error, then in-page build error
+ *   for this `gatewayName`. Also rendered inline via `ErrorRender` above
+ *   `children` so mount-time failures surface even when no consumer
+ *   reads `error`.
+ * - `resetGatewaysFromConfig` — forwards `clearAll` from
+ *   `InPageGatewaysProvider`, letting consumers force a rebuild of the
+ *   in-page gateways (e.g. after a network or endpoint change).
+ * - `provided: true` — lets descendants detect a real provider in the
+ *   tree.
+ *
+ * `defaultGateway`, `gateways`, and the context `value` are memoized so
+ * consumers only re-render when wallet or in-page sources actually
+ * change identity.
+ */
+export declare const GatewayProvider: React.FC<GatewayProviderProps>;
+//# sourceMappingURL=GatewayProvider.d.ts.map

package/dist/browser/context/providers/GatewayProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/GatewayProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAiE1D,CAAA"}

package/dist/browser/context/{WalletGatewayProvider.d.ts → providers/WalletGatewayProvider.d.ts}

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { GatewayProviderProps } from './GatewayProviderProps.ts';
+import type { GatewayProviderProps } from '../GatewayProviderProps.ts';
 /**
  * Publishes a `GatewayContext` backed exclusively by the injected XL1 Wallet
  * extension (i.e. `globalThis.xyo`). This is the provider to use when the

package/dist/browser/context/providers/WalletGatewayProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletGatewayProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/WalletGatewayProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAoChE,CAAA"}

package/dist/browser/context/providers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './GatewayProvider.tsx';
+export * from './WalletGatewayProvider.tsx';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/context/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA"}

package/dist/browser/context/providers/story/GatewayStatus.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+/**
+ * Consumer that reads `useProvidedGateway` and renders the resolved
+ * state in a way that interaction tests can query. Headings (`Gateway
+ * loaded`, `Gateway not available`, etc.) are stable strings so `play`
+ * functions can assert on them without depending on ARIA roles.
+ */
+export declare const GatewayStatus: React.FC;
+//# sourceMappingURL=GatewayStatus.d.ts.map

package/dist/browser/context/providers/story/GatewayStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayStatus.d.ts","sourceRoot":"","sources":["../../../../../src/context/providers/story/GatewayStatus.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EA8CjC,CAAA"}

package/dist/browser/context/useProvidedGateway.d.ts

@@ -1,3 +1,15 @@
+/**
+ * The sole consumer entry point for gateway state. Reads the nearest
+ * `GatewayContext` in the tree, regardless of which provider published
+ * it — this is the decoupling that lets a component work unchanged when
+ * the surrounding app swaps `WalletGatewayProvider` for
+ * `GatewayProvider` (or a test double).
+ *
+ * @param required - When `true` (default), throws if no gateway provider
+ *   is mounted above — use this when the component is meaningless
+ *   without a gateway. When `false`, returns default state (all fields
+ *   undefined) so the component can render a graceful fallback.
+ */
 export declare const useProvidedGateway: (required?: boolean) => Omit<import("./GatewayProviderState.ts").GatewayStateFields & {
     provided: true;
 }, "provided"> | Omit<import("@xylabs/react-shared").NotProvidedContextExState<import("./GatewayProviderState.ts").GatewayContextState>, "provided">;

package/dist/browser/context/useProvidedGateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useProvidedGateway.d.ts","sourceRoot":"","sources":["../../../src/context/useProvidedGateway.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,GAAI,kBAAe;;oJAAsD,CAAA"}
+{"version":3,"file":"useProvidedGateway.d.ts","sourceRoot":"","sources":["../../../src/context/useProvidedGateway.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAAI,kBAAe;;oJAAsD,CAAA"}

package/dist/browser/index.mjs

@@ -309,16 +309,166 @@ var ConnectAccountsStack = /* @__PURE__ */ __name(({ AccountComponent = Connecte
 import { createContextEx } from "@xylabs/react-shared";
 var GatewayContext = createContextEx();
 
-// src/context/useProvidedGateway.ts
+// src/context/in-page/InPageGatewaysContext.ts
+import { createContextEx as createContextEx2 } from "@xylabs/react-shared";
+var InPageGatewaysContext = createContextEx2();
+
+// src/context/in-page/Provider.tsx
+import { DefaultNetworks as DefaultNetworks2 } from "@xyo-network/xl1-sdk";
+import React3, { startTransition, useCallback as useCallback2, useEffect as useEffect3, useMemo, useState as useState3 } from "react";
+
+// src/context/in-page/lib/buildGateway.ts
+import { assertEx as assertEx2, isDefined as isDefined4 } from "@xylabs/sdk-js";
+import { basicRemoteRunnerLocator, basicRemoteViewerLocator, DefaultNetworks, NetworkDataLakeUrls, XyoGatewayMoniker } from "@xyo-network/xl1-sdk";
+var buildGateway = /* @__PURE__ */ __name(async (gatewayName, signerTransport) => {
+  const network = DefaultNetworks.find((network2) => network2.id === gatewayName);
+  const resolvedNetwork = assertEx2(network, () => `No network found for id ${gatewayName}`);
+  const remoteConfig = {
+    rpc: {
+      protocol: "http",
+      url: `${resolvedNetwork.url}/rpc`
+    }
+  };
+  const dataLakeEndpoint = NetworkDataLakeUrls[gatewayName];
+  const locator = isDefined4(signerTransport) ? await basicRemoteRunnerLocator(gatewayName, remoteConfig, signerTransport, dataLakeEndpoint) : await basicRemoteViewerLocator(gatewayName, remoteConfig, dataLakeEndpoint);
+  return await locator.getInstance(XyoGatewayMoniker);
+}, "buildGateway");
+
+// src/context/in-page/Provider.tsx
+var InPageGatewaysProvider = /* @__PURE__ */ __name(({ signerTransport, children }) => {
+  const [gateways, setGateways] = useState3({});
+  const [errors, setErrors] = useState3({});
+  const [previousSignerTransport, setPreviousSignerTransport] = useState3(signerTransport);
+  const clearAll = useCallback2(() => {
+    setGateways({});
+    setErrors({});
+  }, []);
+  if (previousSignerTransport !== signerTransport) {
+    clearAll();
+    setPreviousSignerTransport(signerTransport);
+  }
+  useEffect3(() => {
+    let cancelled = false;
+    const buildAll = /* @__PURE__ */ __name(async () => {
+      const results = await Promise.allSettled(DefaultNetworks2.map(async (network) => {
+        const gateway = await buildGateway(network.id, signerTransport);
+        return {
+          id: network.id,
+          gateway
+        };
+      }));
+      if (cancelled) return;
+      const nextGateways = {};
+      const nextErrors = {};
+      for (const [index, result] of results.entries()) {
+        const networkId = DefaultNetworks2[index].id;
+        if (result.status === "fulfilled") {
+          nextGateways[networkId] = result.value.gateway;
+        } else {
+          nextErrors[networkId] = result.reason instanceof Error ? result.reason : new Error(String(result.reason));
+        }
+      }
+      startTransition(() => {
+        setGateways(nextGateways);
+        setErrors(nextErrors);
+      });
+    }, "buildAll");
+    void buildAll();
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    signerTransport
+  ]);
+  const value = useMemo(() => {
+    const value2 = {
+      clearAll,
+      errors,
+      gateways,
+      provided: true
+    };
+    return value2;
+  }, [
+    clearAll,
+    errors,
+    gateways
+  ]);
+  return /* @__PURE__ */ React3.createElement(InPageGatewaysContext, {
+    value
+  }, children);
+}, "InPageGatewaysProvider");
+
+// src/context/in-page/useProvidedInPageGateways.ts
 import { useContextEx } from "@xylabs/react-shared";
-var useProvidedGateway = /* @__PURE__ */ __name((required = true) => useContextEx(GatewayContext, "Gateway", required), "useProvidedGateway");
+var useProvidedInPageGateways = /* @__PURE__ */ __name((required = true) => useContextEx(InPageGatewaysContext, "InPageGateways", required), "useProvidedInPageGateways");
 
-// src/context/WalletGatewayProvider.tsx
+// src/context/providers/GatewayProvider.tsx
 import { ErrorRender as ErrorRender2 } from "@xylabs/react-error";
-import React3, { useMemo } from "react";
+import { isDefinedNotNull as isDefinedNotNull2, isNull as isNull2 } from "@xylabs/sdk-js";
+import React4, { useMemo as useMemo2 } from "react";
+var GatewayProvider = /* @__PURE__ */ __name(({ gatewayName, children }) => {
+  const { gateway: gatewayFromWallet, error: gatewayFromWalletError } = useGatewayFromWallet(gatewayName);
+  const { gateways: allGateways, errors: allGatewayErrors, clearAll } = useProvidedInPageGateways(true);
+  const gatewayFromConfig = gatewayName ? allGateways[gatewayName] : void 0;
+  const gatewayFromConfigError = gatewayName ? allGatewayErrors[gatewayName] : void 0;
+  const { defaultGateway, gateways } = useMemo2(() => {
+    if (isNull2(gatewayFromWallet)) {
+      return {
+        defaultGateway: gatewayFromConfig,
+        gateways: {
+          inPageGateway: gatewayFromConfig,
+          walletGateway: null
+        }
+      };
+    } else if (isDefinedNotNull2(gatewayFromWallet)) {
+      return {
+        defaultGateway: gatewayFromWallet,
+        gateways: {
+          inPageGateway: gatewayFromConfig,
+          walletGateway: gatewayFromWallet
+        }
+      };
+    }
+    return {
+      defaultGateway: void 0,
+      gateways: {
+        inPageGateway: void 0,
+        walletGateway: void 0
+      }
+    };
+  }, [
+    gatewayFromConfig,
+    gatewayFromWallet
+  ]);
+  const value = useMemo2(() => {
+    const value2 = {
+      defaultGateway,
+      error: gatewayFromWalletError || gatewayFromConfigError,
+      gateways,
+      provided: true,
+      resetGatewaysFromConfig: clearAll
+    };
+    return value2;
+  }, [
+    defaultGateway,
+    gatewayFromWalletError,
+    gatewayFromConfigError,
+    gateways,
+    clearAll
+  ]);
+  return /* @__PURE__ */ React4.createElement(GatewayContext, {
+    value
+  }, /* @__PURE__ */ React4.createElement(ErrorRender2, {
+    error: gatewayFromConfigError
+  }), children);
+}, "GatewayProvider");
+
+// src/context/providers/WalletGatewayProvider.tsx
+import { ErrorRender as ErrorRender3 } from "@xylabs/react-error";
+import React5, { useMemo as useMemo3 } from "react";
 var WalletGatewayProvider = /* @__PURE__ */ __name(({ gatewayName, children }) => {
   const { gateway: gatewayFromWallet, error: gatewayFromWalletError } = useGatewayFromWallet(gatewayName);
-  const { defaultGateway, gateways } = useMemo(() => {
+  const { defaultGateway, gateways } = useMemo3(() => {
     return {
       defaultGateway: gatewayFromWallet,
       gateways: {
@@ -329,7 +479,7 @@ var WalletGatewayProvider = /* @__PURE__ */ __name(({ gatewayName, children }) =
   }, [
     gatewayFromWallet
   ]);
-  const value = useMemo(() => {
+  const value = useMemo3(() => {
     const value2 = {
       defaultGateway,
       error: gatewayFromWalletError,
@@ -342,16 +492,23 @@ var WalletGatewayProvider = /* @__PURE__ */ __name(({ gatewayName, children }) =
     gatewayFromWalletError,
     gateways
   ]);
-  return /* @__PURE__ */ React3.createElement(GatewayContext, {
+  return /* @__PURE__ */ React5.createElement(GatewayContext, {
     value
-  }, /* @__PURE__ */ React3.createElement(ErrorRender2, {
+  }, /* @__PURE__ */ React5.createElement(ErrorRender3, {
     error: gatewayFromWalletError
   }), children);
 }, "WalletGatewayProvider");
+
+// src/context/useProvidedGateway.ts
+import { useContextEx as useContextEx2 } from "@xylabs/react-shared";
+var useProvidedGateway = /* @__PURE__ */ __name((required = true) => useContextEx2(GatewayContext, "Gateway", required), "useProvidedGateway");
 export {
   ConnectAccountsStack,
   ConnectedAccount,
   GatewayContext,
+  GatewayProvider,
+  InPageGatewaysContext,
+  InPageGatewaysProvider,
   WalletGatewayProvider,
   findCaveat,
   getXyoClient,
@@ -362,6 +519,7 @@ export {
   useGateway,
   useGatewayFromWallet,
   usePermissions,
-  useProvidedGateway
+  useProvidedGateway,
+  useProvidedInPageGateways
 };
 //# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/connected/account/Connected.tsx","../../src/components/connected/ConnectAccountsStack.tsx","../../src/components/connected/hooks/useConnectAccount.ts","../../src/hooks/client/helpers/findCaveat.ts","../../src/hooks/client/useClientFromWallet.ts","../../src/hooks/helpers/getXyoClient.ts","../../src/hooks/client/permissions/usePermissions.ts","../../src/hooks/client/permissions/usePermissionsAccounts.ts","../../src/hooks/client/useGatewayFromWallet.ts","../../src/context/GatewayContext.ts","../../src/context/useProvidedGateway.ts","../../src/context/WalletGatewayProvider.tsx"],"sourcesContent":["import {\n  Stack, Tooltip, Typography,\n} from '@mui/material'\nimport { EthAddressWrapper } from '@xylabs/sdk-js'\nimport { BlockiesAvatarAddress } from '@xyo-network/react-chain-blockies'\nimport React from 'react'\n\nexport const ConnectedAccount: React.FC<{ address: string }> = ({ address }) => {\n  const shortenedAddress = `${EthAddressWrapper.fromString(address)?.toShortString(4)}`\n\n  return (\n    <Stack direction=\"row\" alignItems=\"center\" spacing={1}>\n      <BlockiesAvatarAddress address={address} size={21} />\n      <Tooltip title={address}>\n        <Typography color=\"textSecondary\" variant=\"caption\" fontFamily=\"monospace\">{shortenedAddress}</Typography>\n      </Tooltip>\n    </Stack>\n  )\n}\n","import type { StackProps } from '@mui/material'\nimport {\n  Alert, AlertTitle, Button, Stack,\n  Typography,\n} from '@mui/material'\nimport type { ButtonExProps } from '@xylabs/react-button'\nimport { ButtonEx } from '@xylabs/react-button'\nimport { ErrorRender } from '@xylabs/react-error'\nimport type { Address } from '@xylabs/sdk-js'\nimport { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport type { ComponentType, MouseEventHandler } from 'react'\nimport React, { useEffect } from 'react'\n\nimport { ConnectedAccount } from './account/index.ts'\nimport { useConnectAccount } from './hooks/index.ts'\n\nconst DefaultConnectComponent: React.FC<ButtonExProps> = props => (\n  <ButtonEx variant=\"contained\" size=\"small\" {...props} />\n)\n\nconst DefaultNoWalletInstalledComponent: React.FC = () => (\n  <Alert severity=\"warning\">\n    <AlertTitle>XL1 Wallet Not Found</AlertTitle>\n    <Typography gutterBottom>\n      Please ensure that your XL1 Wallet is installed to connect your account.\n    </Typography>\n    <Button\n      sx={{ display: 'flex', justifySelf: 'end' }}\n      size=\"small\"\n      variant=\"outlined\"\n      href=\"https://chromewebstore.google.com/detail/xl1-wallet/fblbagcjeigmhakkfgjpdlcapcgmcfbm\"\n      target=\"_blank\"\n      rel=\"noopener\"\n    >\n      Get XL1 Wallet\n    </Button>\n  </Alert>\n)\n\nexport interface ConnectClientAccountsStackProps extends StackProps {\n  AccountComponent?: ComponentType<{ account?: string }>\n  ConnectComponent?: ComponentType<{ onClick?: MouseEventHandler<HTMLElement> }>\n  NoWalletInstalledComponent?: ComponentType\n  onAccountConnected?: (account: Address) => void\n  onCancel?: () => void\n  timeout?: number\n}\n\n/**\n * Renders a horizontal stack that surfaces the current state of the user's\n * connection to an XL1 wallet (e.g. the XL1 Chrome extension) and lets them\n * kick off a connection.\n *\n * Connection state is derived from `useConnectAccount`, which wraps\n * `useGatewayFromWallet` (wallet/gateway discovery with a configurable\n * `timeout`) and `useAccountPermissions` (already-authorized addresses).\n * The hook returns: `address` (resolved once the wallet exposes one),\n * `connectSigner` (prompts the wallet for an address), `timedout` (the\n * gateway never appeared within `timeout`), and `error` (the first of\n * gateway, permissions, or signer-connect failures).\n *\n * The component renders exactly one of the following wallet states, plus\n * an always-present error slot:\n *\n * - **Connected** — `address` is defined: renders `AccountComponent` for\n *   that address. Also fires `onAccountConnected(address)` once via effect.\n * - **Disconnected, wallet available** — no `address` and not `timedout`:\n *   renders `ConnectComponent` as a \"Connect\" button that invokes\n *   `connectSigner()`. This covers both \"wallet installed but no account\n *   authorized yet\" and \"gateway still resolving\".\n * - **Wallet missing / unreachable** — no `address` and `timedout` is true:\n *   renders `NoWalletInstalledComponent` (defaults to an Alert linking to\n *   the XL1 Wallet Chrome Web Store listing).\n * - **Error** — any error from the hook is rendered via `ErrorRender`\n *   alongside the state above, and `onCancel()` is fired once via effect\n *   so the host UI can close/abort its connect flow.\n *\n * All three slot components (`AccountComponent`, `ConnectComponent`,\n * `NoWalletInstalledComponent`) are injectable so consumers can restyle\n * any state without forking this component.\n */\nexport const ConnectAccountsStack: React.FC<ConnectClientAccountsStackProps> = ({\n  AccountComponent = ConnectedAccount,\n  ConnectComponent = DefaultConnectComponent,\n  NoWalletInstalledComponent = DefaultNoWalletInstalledComponent,\n  onAccountConnected,\n  onCancel,\n  timeout,\n  ...props\n}) => {\n  const {\n    address, connectSigner, error, timedout,\n  } = useConnectAccount(undefined, timeout)\n\n  useEffect(() => {\n    if (isDefined(error) && isDefined(onCancel)) {\n      onCancel()\n    }\n  }, [error, onCancel])\n\n  useEffect(() => {\n    if (isDefined(address) && isDefined(onAccountConnected)) {\n      onAccountConnected(address)\n    }\n  }, [address, onAccountConnected])\n\n  return (\n    <Stack direction=\"row\" alignItems=\"start\" spacing={2} {...props}>\n      {isDefined(address)\n        ? <AccountComponent address={address} />\n        : null}\n      {isUndefined(address) && !timedout\n        ? (\n            <ConnectComponent onClick={() => void connectSigner()}>Connect</ConnectComponent>\n          )\n        : null}\n      {isUndefined(address) && timedout\n        ? (\n            <NoWalletInstalledComponent />\n          )\n        : null}\n      <ErrorRender error={error} scope=\"ConnectSigner:error\" />\n    </Stack>\n  )\n}\n","import { type Address, asAddress } from '@xylabs/sdk-js'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\nimport { MainNetwork } from '@xyo-network/xl1-sdk'\nimport { useCallback, useState } from 'react'\n\nimport { useAccountPermissions, useGatewayFromWallet } from '../../../hooks/index.ts'\n\nexport const useConnectAccount = (gatewayName: GatewayName = MainNetwork.id, timeout?: number) => {\n  const [connectError, setConnectError] = useState<Error>()\n\n  const {\n    gateway, error, timedout,\n  } = useGatewayFromWallet(gatewayName, timeout)\n\n  const [accountPermissions, accountPermissionsError] = useAccountPermissions()\n\n  const [address, setAddress] = useState<Address>()\n\n  const connectSigner = useCallback(async () => {\n    try {\n      setConnectError(undefined)\n      const assertedGateway = assertEx(gateway, () => `Gateway ${gatewayName} is not available`)\n      const signer = assertedGateway.signer\n      const address = await signer.address()\n      setAddress(address)\n      return address\n    } catch (e) {\n      setConnectError(e as Error)\n    }\n  }, [gateway, gatewayName])\n\n  return {\n    address: asAddress(accountPermissions?.[0] ?? address), connectSigner, error: error ?? accountPermissionsError ?? connectError, gateway, timedout,\n  }\n}\n","import { isDefined } from '@xylabs/sdk-js'\nimport type {\n  CaveatTypes, ParentCapability, XyoPermissions,\n} from '@xyo-network/xl1-sdk'\n\nexport const findCaveat = async (\n  permissions: XyoPermissions,\n  targetCapability: ParentCapability,\n  targetCaveatType: CaveatTypes,\n) => {\n  const existingPermissions = await permissions.getPermissions()\n  if (isDefined(existingPermissions) && existingPermissions.length > 0) {\n    const foundPermissions = existingPermissions\n      .find(p => p.parentCapability === targetCapability)\n    if (isDefined(foundPermissions)) {\n      return foundPermissions.caveats?.find(caveat => caveat.type === targetCaveatType)?.value ?? []\n    }\n  }\n  return existingPermissions\n}\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\nimport { useEffect, useState } from 'react'\n\nimport { getXyoClient } from '../helpers/index.ts'\n\ninterface ClientState {\n  client?: XyoClient | null\n  error: Error | null\n  isLoading: boolean\n  timedout: boolean\n}\n\nconst initialState: ClientState = {\n  client: undefined,\n  error: null,\n  isLoading: false,\n  timedout: false,\n}\n\nexport const useClientFromWallet = (timeout?: number): ClientState => {\n  const [state, setState] = useState<ClientState>(initialState)\n\n  useEffect(() => {\n    let cancelled = false\n\n    const initialize = async () => {\n      setState((prev) => {\n        if (prev.isLoading) return prev\n        return {\n          ...prev, isLoading: true, error: null,\n        }\n      })\n\n      try {\n        const client = await getXyoClient(timeout)\n        if (cancelled) return\n        if (client === null) {\n          setState({\n            client: null, timedout: true, isLoading: false, error: null,\n          })\n        } else {\n          setState({\n            client, isLoading: false, error: null, timedout: false,\n          })\n        }\n      } catch (error) {\n        if (cancelled) return\n        setState({\n          client: undefined, isLoading: false, error: error as Error, timedout: false,\n        })\n      }\n    }\n\n    void initialize()\n\n    // Late recovery: if wallet loads after timeout, update state\n    const onPluginReady = () => {\n      if (cancelled) return\n      const client = isUndefined(globalThis.xyo) ? null : globalThis.xyo?.client ?? null\n      setState({\n        client, isLoading: false, timedout: false, error: null,\n      })\n    }\n    globalThis.addEventListener('xyo:plugin-ready', onPluginReady)\n\n    return () => {\n      cancelled = true\n      globalThis.removeEventListener('xyo:plugin-ready', onPluginReady)\n    }\n  }, [timeout])\n\n  return state\n}\n\n/** @deprecated - use useClientFromWallet instead */\nexport const useClient = useClientFromWallet\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\n\nconst CLIENT_LISTENER_TIMEOUT = 2000\n\nconst hasXyoClient = () => {\n  return 'client' in globalThis.xyo\n}\n\nexport const listenForClientInjection = (onClientReady: () => void, timeout: number, onTimeout: () => void) => {\n  let resolved = false\n  const listener: EventListener = () => {\n    onClientReady()\n    resolved = true\n  }\n  globalThis.addEventListener('xyo:plugin-ready', listener)\n  setTimeout(() => {\n    if (!resolved) {\n      globalThis.removeEventListener('xyo:plugin-ready', listener)\n      onTimeout()\n    }\n  }, timeout)\n}\n\ntype ReturnType = XyoClient | undefined | null\n\nexport async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT): Promise<ReturnType> {\n  // if no xyo object, we can bail early\n  if (isUndefined(globalThis.xyo)) {\n    return null\n  }\n  return hasXyoClient()\n    ? globalThis.xyo.client\n    // listen for the XyoWallet to be injected\n    : await new Promise<ReturnType>((resolve) => {\n        listenForClientInjection(\n          () => {\n            resolve(globalThis.xyo.client)\n          },\n          timeout,\n          () => {\n            resolve(null)\n          },\n        )\n      })\n}\n","import { useClientFromWallet } from '../useClientFromWallet.ts'\n\nexport const usePermissions = () => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet()\n  const permissions = client?.permissions\n  return {\n    permissions,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n","import { usePromise } from '@xylabs/react-promise'\nimport type { JsonValue } from '@xylabs/sdk-js'\nimport {\n  isArray, isDefined, isDefinedNotNull, isString,\n} from '@xylabs/sdk-js'\n\nimport { findCaveat } from '../helpers/index.ts'\nimport { usePermissions } from './usePermissions.ts'\n\nconst validateRestrictedAccounts = (restrictedAccounts: JsonValue): readonly string [] => {\n  if (isDefined(restrictedAccounts)) {\n    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {\n      return restrictedAccounts\n    }\n    throw new Error(\n      `Unrecognized format for restrictReturnedAccounts caveat found on permissions.  \\n\n      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`,\n    )\n  }\n  return []\n}\n\nexport const useAccountPermissions = () => {\n  const { permissions, error } = usePermissions()\n\n  return usePromise(async () => {\n    if (isDefinedNotNull(error)) throw error\n    if (isDefined(permissions)) {\n      const restrictedAccounts = await findCaveat(\n        permissions,\n        // TODO - extract to constant in protocol package\n        'xyoWallet_getAccounts',\n        'restrictReturnedAccounts',\n      )\n      return validateRestrictedAccounts(restrictedAccounts)\n    }\n  }, [permissions])\n}\n","import { isNull } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\n\nimport type { GatewayFromWallet } from '../../types/index.ts'\nimport { useClientFromWallet } from './useClientFromWallet.ts'\n\n/**\n * Resolves a gateway from the injected XL1 Wallet extension.\n *\n * The returned `gateway` uses a three-state contract:\n * - `undefined` — wallet detection is still in progress (isLoading=true),\n *   or no gatewayName was provided. Consumers should treat this as \"not yet known\"\n *   and avoid committing to either a present or absent UI state.\n * - `null` — wallet is definitively absent. Either globalThis.xyo was never set,\n *   or detection timed out. Safe to show fallback UI (e.g. \"Get XL1 Wallet\").\n *   A late-recovery listener may still transition this to a real gateway if\n *   the extension loads after the timeout.\n * - `XyoGatewayRunner` — wallet is present and exposes this gateway for the\n *   requested network. Ready to use for transactions and queries.\n */\nexport const useGatewayFromWallet = (gatewayName?: GatewayName, timeout?: number): GatewayFromWallet => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet(timeout)\n\n  const resolveGateway = () => {\n    // null client = wallet confirmed absent (no globalThis.xyo or timed out)\n    if (isNull(client)) return null\n    // client is undefined (still loading) or defined (wallet present) —\n    // optional chain returns undefined while loading, or the gateway if available\n    return client?.gateways?.[gatewayName!]\n  }\n\n  return {\n    // no gatewayName requested = undefined (opt-out, not \"absent\")\n    gateway: gatewayName ? resolveGateway() : undefined,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n\n/** @deprecated - useGatewayFromWallet */\nexport const useGateway = useGatewayFromWallet\n","import { createContextEx } from '@xylabs/react-shared'\n\nimport type { GatewayContextState } from './GatewayProviderState.ts'\n\nexport const GatewayContext = createContextEx<GatewayContextState>()\n","import { useContextEx } from '@xylabs/react-shared'\n\nimport { GatewayContext } from './GatewayContext.ts'\n\nexport const useProvidedGateway = (required = true) => useContextEx(GatewayContext, 'Gateway', required)\n","import { ErrorRender } from '@xylabs/react-error'\nimport React, { useMemo } from 'react'\n\nimport { useGatewayFromWallet } from '../hooks/index.ts'\nimport { GatewayContext } from './GatewayContext.ts'\nimport type { GatewayProviderProps } from './GatewayProviderProps.ts'\nimport type { GatewayContextState } from './GatewayProviderState.ts'\n\n/**\n * Publishes a `GatewayContext` backed exclusively by the injected XL1 Wallet\n * extension (i.e. `globalThis.xyo`). This is the provider to use when the\n * host app is a browser UI that expects the user to bring their own wallet,\n * rather than running an in-page gateway.\n *\n * The requested `gatewayName` is forwarded to `useGatewayFromWallet`, whose\n * returned gateway uses a three-state contract (`undefined` = still\n * resolving, `null` = wallet confirmed absent / timed out,\n * `XyoGatewayRunner` = ready). That tri-state is passed through to\n * consumers unchanged as `defaultGateway` / `gateways.walletGateway`, so\n * downstream hooks can distinguish \"loading\" from \"missing\".\n *\n * The published `GatewayContextState` shape:\n * - `defaultGateway` — the wallet gateway, used when consumers don't\n *   specify which gateway they want.\n * - `gateways.walletGateway` — same instance as `defaultGateway`.\n * - `gateways.inPageGateway` — always `null` here; this provider does not\n *   stand up an in-page client. Pair with a different provider if you need\n *   both.\n * - `error` — surfaced from `useGatewayFromWallet` (detection / timeout /\n *   wallet errors). Also rendered inline via `ErrorRender` above `children`\n *   so mount-time failures are visible even if no consumer reads `error`.\n * - `provided: true` — lets descendants detect that a real provider (not\n *   the default empty context) is in the tree.\n *\n * The `defaultGateway`, `gateways`, and context `value` are memoized so\n * consumers only re-render when the underlying wallet gateway reference or\n * error actually changes.\n */\nexport const WalletGatewayProvider: React.FC<GatewayProviderProps> = ({ gatewayName, children }) => {\n  const {\n    gateway: gatewayFromWallet,\n    error: gatewayFromWalletError,\n  } = useGatewayFromWallet(gatewayName)\n\n  const { defaultGateway, gateways } = useMemo(() => {\n    return {\n      defaultGateway: gatewayFromWallet,\n      gateways: {\n        inPageGateway: null,\n        walletGateway: gatewayFromWallet,\n      },\n    }\n  }, [gatewayFromWallet])\n\n  const value = useMemo(() => {\n    const value: GatewayContextState = {\n      defaultGateway,\n      error: gatewayFromWalletError,\n      gateways,\n      provided: true,\n    }\n    return value\n  }, [\n    defaultGateway,\n    gatewayFromWalletError,\n    gateways,\n  ])\n\n  return (\n    <GatewayContext value={value}>\n      <ErrorRender error={gatewayFromWalletError} />\n      {children}\n    </GatewayContext>\n  )\n}\n"],"mappings":"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","names":["Stack","Tooltip","Typography","EthAddressWrapper","BlockiesAvatarAddress","React","ConnectedAccount","address","shortenedAddress","EthAddressWrapper","fromString","toShortString","Stack","direction","alignItems","spacing","BlockiesAvatarAddress","size","Tooltip","title","Typography","color","variant","fontFamily","Alert","AlertTitle","Button","Stack","Typography","ButtonEx","ErrorRender","isDefined","isUndefined","React","useEffect","asAddress","assertEx","MainNetwork","useCallback","useState","isDefined","findCaveat","permissions","targetCapability","targetCaveatType","existingPermissions","getPermissions","isDefined","length","foundPermissions","find","p","parentCapability","caveats","caveat","type","value","isUndefined","useEffect","useState","isUndefined","CLIENT_LISTENER_TIMEOUT","hasXyoClient","globalThis","xyo","listenForClientInjection","onClientReady","timeout","onTimeout","resolved","listener","addEventListener","setTimeout","removeEventListener","getXyoClient","isUndefined","client","Promise","resolve","initialState","client","undefined","error","isLoading","timedout","useClientFromWallet","timeout","state","setState","useState","useEffect","cancelled","initialize","prev","getXyoClient","onPluginReady","isUndefined","globalThis","xyo","addEventListener","removeEventListener","useClient","usePermissions","client","isLoading","error","timedout","useClientFromWallet","permissions","usePromise","isArray","isDefined","isDefinedNotNull","isString","validateRestrictedAccounts","restrictedAccounts","isDefined","isArray","every","isString","Error","JSON","stringify","useAccountPermissions","permissions","error","usePermissions","usePromise","isDefinedNotNull","findCaveat","isNull","useGatewayFromWallet","gatewayName","timeout","client","isLoading","error","timedout","useClientFromWallet","resolveGateway","isNull","gateways","gateway","undefined","useGateway","useConnectAccount","gatewayName","MainNetwork","id","timeout","connectError","setConnectError","useState","gateway","error","timedout","useGatewayFromWallet","accountPermissions","accountPermissionsError","useAccountPermissions","address","setAddress","connectSigner","useCallback","undefined","assertedGateway","assertEx","signer","e","asAddress","DefaultConnectComponent","props","React","ButtonEx","variant","size","DefaultNoWalletInstalledComponent","Alert","severity","AlertTitle","Typography","gutterBottom","Button","sx","display","justifySelf","href","target","rel","ConnectAccountsStack","AccountComponent","ConnectedAccount","ConnectComponent","NoWalletInstalledComponent","onAccountConnected","onCancel","timeout","address","connectSigner","error","timedout","useConnectAccount","undefined","useEffect","isDefined","Stack","direction","alignItems","spacing","isUndefined","onClick","ErrorRender","scope","createContextEx","GatewayContext","useContextEx","useProvidedGateway","required","useContextEx","GatewayContext","ErrorRender","React","useMemo","WalletGatewayProvider","gatewayName","children","gateway","gatewayFromWallet","error","gatewayFromWalletError","useGatewayFromWallet","defaultGateway","gateways","useMemo","inPageGateway","walletGateway","value","provided","React","GatewayContext","ErrorRender"]}
+{"version":3,"sources":["../../src/components/connected/account/Connected.tsx","../../src/components/connected/ConnectAccountsStack.tsx","../../src/components/connected/hooks/useConnectAccount.ts","../../src/hooks/client/helpers/findCaveat.ts","../../src/hooks/client/useClientFromWallet.ts","../../src/hooks/helpers/getXyoClient.ts","../../src/hooks/client/permissions/usePermissions.ts","../../src/hooks/client/permissions/usePermissionsAccounts.ts","../../src/hooks/client/useGatewayFromWallet.ts","../../src/context/GatewayContext.ts","../../src/context/in-page/InPageGatewaysContext.ts","../../src/context/in-page/Provider.tsx","../../src/context/in-page/lib/buildGateway.ts","../../src/context/in-page/useProvidedInPageGateways.ts","../../src/context/providers/GatewayProvider.tsx","../../src/context/providers/WalletGatewayProvider.tsx","../../src/context/useProvidedGateway.ts"],"sourcesContent":["import {\n  Stack, Tooltip, Typography,\n} from '@mui/material'\nimport { EthAddressWrapper } from '@xylabs/sdk-js'\nimport { BlockiesAvatarAddress } from '@xyo-network/react-chain-blockies'\nimport React from 'react'\n\nexport const ConnectedAccount: React.FC<{ address: string }> = ({ address }) => {\n  const shortenedAddress = `${EthAddressWrapper.fromString(address)?.toShortString(4)}`\n\n  return (\n    <Stack direction=\"row\" alignItems=\"center\" spacing={1}>\n      <BlockiesAvatarAddress address={address} size={21} />\n      <Tooltip title={address}>\n        <Typography color=\"textSecondary\" variant=\"caption\" fontFamily=\"monospace\">{shortenedAddress}</Typography>\n      </Tooltip>\n    </Stack>\n  )\n}\n","import type { StackProps } from '@mui/material'\nimport {\n  Alert, AlertTitle, Button, Stack,\n  Typography,\n} from '@mui/material'\nimport type { ButtonExProps } from '@xylabs/react-button'\nimport { ButtonEx } from '@xylabs/react-button'\nimport { ErrorRender } from '@xylabs/react-error'\nimport type { Address } from '@xylabs/sdk-js'\nimport { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport type { ComponentType, MouseEventHandler } from 'react'\nimport React, { useEffect } from 'react'\n\nimport { ConnectedAccount } from './account/index.ts'\nimport { useConnectAccount } from './hooks/index.ts'\n\nconst DefaultConnectComponent: React.FC<ButtonExProps> = props => (\n  <ButtonEx variant=\"contained\" size=\"small\" {...props} />\n)\n\nconst DefaultNoWalletInstalledComponent: React.FC = () => (\n  <Alert severity=\"warning\">\n    <AlertTitle>XL1 Wallet Not Found</AlertTitle>\n    <Typography gutterBottom>\n      Please ensure that your XL1 Wallet is installed to connect your account.\n    </Typography>\n    <Button\n      sx={{ display: 'flex', justifySelf: 'end' }}\n      size=\"small\"\n      variant=\"outlined\"\n      href=\"https://chromewebstore.google.com/detail/xl1-wallet/fblbagcjeigmhakkfgjpdlcapcgmcfbm\"\n      target=\"_blank\"\n      rel=\"noopener\"\n    >\n      Get XL1 Wallet\n    </Button>\n  </Alert>\n)\n\nexport interface ConnectClientAccountsStackProps extends StackProps {\n  AccountComponent?: ComponentType<{ account?: string }>\n  ConnectComponent?: ComponentType<{ onClick?: MouseEventHandler<HTMLElement> }>\n  NoWalletInstalledComponent?: ComponentType\n  onAccountConnected?: (account: Address) => void\n  onCancel?: () => void\n  timeout?: number\n}\n\n/**\n * Renders a horizontal stack that surfaces the current state of the user's\n * connection to an XL1 wallet (e.g. the XL1 Chrome extension) and lets them\n * kick off a connection.\n *\n * Connection state is derived from `useConnectAccount`, which wraps\n * `useGatewayFromWallet` (wallet/gateway discovery with a configurable\n * `timeout`) and `useAccountPermissions` (already-authorized addresses).\n * The hook returns: `address` (resolved once the wallet exposes one),\n * `connectSigner` (prompts the wallet for an address), `timedout` (the\n * gateway never appeared within `timeout`), and `error` (the first of\n * gateway, permissions, or signer-connect failures).\n *\n * The component renders exactly one of the following wallet states, plus\n * an always-present error slot:\n *\n * - **Connected** — `address` is defined: renders `AccountComponent` for\n *   that address. Also fires `onAccountConnected(address)` once via effect.\n * - **Disconnected, wallet available** — no `address` and not `timedout`:\n *   renders `ConnectComponent` as a \"Connect\" button that invokes\n *   `connectSigner()`. This covers both \"wallet installed but no account\n *   authorized yet\" and \"gateway still resolving\".\n * - **Wallet missing / unreachable** — no `address` and `timedout` is true:\n *   renders `NoWalletInstalledComponent` (defaults to an Alert linking to\n *   the XL1 Wallet Chrome Web Store listing).\n * - **Error** — any error from the hook is rendered via `ErrorRender`\n *   alongside the state above, and `onCancel()` is fired once via effect\n *   so the host UI can close/abort its connect flow.\n *\n * All three slot components (`AccountComponent`, `ConnectComponent`,\n * `NoWalletInstalledComponent`) are injectable so consumers can restyle\n * any state without forking this component.\n */\nexport const ConnectAccountsStack: React.FC<ConnectClientAccountsStackProps> = ({\n  AccountComponent = ConnectedAccount,\n  ConnectComponent = DefaultConnectComponent,\n  NoWalletInstalledComponent = DefaultNoWalletInstalledComponent,\n  onAccountConnected,\n  onCancel,\n  timeout,\n  ...props\n}) => {\n  const {\n    address, connectSigner, error, timedout,\n  } = useConnectAccount(undefined, timeout)\n\n  useEffect(() => {\n    if (isDefined(error) && isDefined(onCancel)) {\n      onCancel()\n    }\n  }, [error, onCancel])\n\n  useEffect(() => {\n    if (isDefined(address) && isDefined(onAccountConnected)) {\n      onAccountConnected(address)\n    }\n  }, [address, onAccountConnected])\n\n  return (\n    <Stack direction=\"row\" alignItems=\"start\" spacing={2} {...props}>\n      {isDefined(address)\n        ? <AccountComponent address={address} />\n        : null}\n      {isUndefined(address) && !timedout\n        ? (\n            <ConnectComponent onClick={() => void connectSigner()}>Connect</ConnectComponent>\n          )\n        : null}\n      {isUndefined(address) && timedout\n        ? (\n            <NoWalletInstalledComponent />\n          )\n        : null}\n      <ErrorRender error={error} scope=\"ConnectSigner:error\" />\n    </Stack>\n  )\n}\n","import { type Address, asAddress } from '@xylabs/sdk-js'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\nimport { MainNetwork } from '@xyo-network/xl1-sdk'\nimport { useCallback, useState } from 'react'\n\nimport { useAccountPermissions, useGatewayFromWallet } from '../../../hooks/index.ts'\n\nexport const useConnectAccount = (gatewayName: GatewayName = MainNetwork.id, timeout?: number) => {\n  const [connectError, setConnectError] = useState<Error>()\n\n  const {\n    gateway, error, timedout,\n  } = useGatewayFromWallet(gatewayName, timeout)\n\n  const [accountPermissions, accountPermissionsError] = useAccountPermissions()\n\n  const [address, setAddress] = useState<Address>()\n\n  const connectSigner = useCallback(async () => {\n    try {\n      setConnectError(undefined)\n      const assertedGateway = assertEx(gateway, () => `Gateway ${gatewayName} is not available`)\n      const signer = assertedGateway.signer\n      const address = await signer.address()\n      setAddress(address)\n      return address\n    } catch (e) {\n      setConnectError(e as Error)\n    }\n  }, [gateway, gatewayName])\n\n  return {\n    address: asAddress(accountPermissions?.[0] ?? address), connectSigner, error: error ?? accountPermissionsError ?? connectError, gateway, timedout,\n  }\n}\n","import { isDefined } from '@xylabs/sdk-js'\nimport type {\n  CaveatTypes, ParentCapability, XyoPermissions,\n} from '@xyo-network/xl1-sdk'\n\nexport const findCaveat = async (\n  permissions: XyoPermissions,\n  targetCapability: ParentCapability,\n  targetCaveatType: CaveatTypes,\n) => {\n  const existingPermissions = await permissions.getPermissions()\n  if (isDefined(existingPermissions) && existingPermissions.length > 0) {\n    const foundPermissions = existingPermissions\n      .find(p => p.parentCapability === targetCapability)\n    if (isDefined(foundPermissions)) {\n      return foundPermissions.caveats?.find(caveat => caveat.type === targetCaveatType)?.value ?? []\n    }\n  }\n  return existingPermissions\n}\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\nimport { useEffect, useState } from 'react'\n\nimport { getXyoClient } from '../helpers/index.ts'\n\ninterface ClientState {\n  client?: XyoClient | null\n  error: Error | null\n  isLoading: boolean\n  timedout: boolean\n}\n\nconst initialState: ClientState = {\n  client: undefined,\n  error: null,\n  isLoading: false,\n  timedout: false,\n}\n\nexport const useClientFromWallet = (timeout?: number): ClientState => {\n  const [state, setState] = useState<ClientState>(initialState)\n\n  useEffect(() => {\n    let cancelled = false\n\n    const initialize = async () => {\n      setState((prev) => {\n        if (prev.isLoading) return prev\n        return {\n          ...prev, isLoading: true, error: null,\n        }\n      })\n\n      try {\n        const client = await getXyoClient(timeout)\n        if (cancelled) return\n        if (client === null) {\n          setState({\n            client: null, timedout: true, isLoading: false, error: null,\n          })\n        } else {\n          setState({\n            client, isLoading: false, error: null, timedout: false,\n          })\n        }\n      } catch (error) {\n        if (cancelled) return\n        setState({\n          client: undefined, isLoading: false, error: error as Error, timedout: false,\n        })\n      }\n    }\n\n    void initialize()\n\n    // Late recovery: if wallet loads after timeout, update state\n    const onPluginReady = () => {\n      if (cancelled) return\n      const client = isUndefined(globalThis.xyo) ? null : globalThis.xyo?.client ?? null\n      setState({\n        client, isLoading: false, timedout: false, error: null,\n      })\n    }\n    globalThis.addEventListener('xyo:plugin-ready', onPluginReady)\n\n    return () => {\n      cancelled = true\n      globalThis.removeEventListener('xyo:plugin-ready', onPluginReady)\n    }\n  }, [timeout])\n\n  return state\n}\n\n/** @deprecated - use useClientFromWallet instead */\nexport const useClient = useClientFromWallet\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\n\nconst CLIENT_LISTENER_TIMEOUT = 2000\n\nconst hasXyoClient = () => {\n  return 'client' in globalThis.xyo\n}\n\nexport const listenForClientInjection = (onClientReady: () => void, timeout: number, onTimeout: () => void) => {\n  let resolved = false\n  const listener: EventListener = () => {\n    onClientReady()\n    resolved = true\n  }\n  globalThis.addEventListener('xyo:plugin-ready', listener)\n  setTimeout(() => {\n    if (!resolved) {\n      globalThis.removeEventListener('xyo:plugin-ready', listener)\n      onTimeout()\n    }\n  }, timeout)\n}\n\ntype ReturnType = XyoClient | undefined | null\n\nexport async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT): Promise<ReturnType> {\n  // if no xyo object, we can bail early\n  if (isUndefined(globalThis.xyo)) {\n    return null\n  }\n  return hasXyoClient()\n    ? globalThis.xyo.client\n    // listen for the XyoWallet to be injected\n    : await new Promise<ReturnType>((resolve) => {\n        listenForClientInjection(\n          () => {\n            resolve(globalThis.xyo.client)\n          },\n          timeout,\n          () => {\n            resolve(null)\n          },\n        )\n      })\n}\n","import { useClientFromWallet } from '../useClientFromWallet.ts'\n\nexport const usePermissions = () => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet()\n  const permissions = client?.permissions\n  return {\n    permissions,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n","import { usePromise } from '@xylabs/react-promise'\nimport type { JsonValue } from '@xylabs/sdk-js'\nimport {\n  isArray, isDefined, isDefinedNotNull, isString,\n} from '@xylabs/sdk-js'\n\nimport { findCaveat } from '../helpers/index.ts'\nimport { usePermissions } from './usePermissions.ts'\n\nconst validateRestrictedAccounts = (restrictedAccounts: JsonValue): readonly string [] => {\n  if (isDefined(restrictedAccounts)) {\n    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {\n      return restrictedAccounts\n    }\n    throw new Error(\n      `Unrecognized format for restrictReturnedAccounts caveat found on permissions.  \\n\n      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`,\n    )\n  }\n  return []\n}\n\nexport const useAccountPermissions = () => {\n  const { permissions, error } = usePermissions()\n\n  return usePromise(async () => {\n    if (isDefinedNotNull(error)) throw error\n    if (isDefined(permissions)) {\n      const restrictedAccounts = await findCaveat(\n        permissions,\n        // TODO - extract to constant in protocol package\n        'xyoWallet_getAccounts',\n        'restrictReturnedAccounts',\n      )\n      return validateRestrictedAccounts(restrictedAccounts)\n    }\n  }, [permissions])\n}\n","import { isNull } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\n\nimport type { GatewayFromWallet } from '../../types/index.ts'\nimport { useClientFromWallet } from './useClientFromWallet.ts'\n\n/**\n * Resolves a gateway from the injected XL1 Wallet extension.\n *\n * The returned `gateway` uses a three-state contract:\n * - `undefined` — wallet detection is still in progress (isLoading=true),\n *   or no gatewayName was provided. Consumers should treat this as \"not yet known\"\n *   and avoid committing to either a present or absent UI state.\n * - `null` — wallet is definitively absent. Either globalThis.xyo was never set,\n *   or detection timed out. Safe to show fallback UI (e.g. \"Get XL1 Wallet\").\n *   A late-recovery listener may still transition this to a real gateway if\n *   the extension loads after the timeout.\n * - `XyoGatewayRunner` — wallet is present and exposes this gateway for the\n *   requested network. Ready to use for transactions and queries.\n */\nexport const useGatewayFromWallet = (gatewayName?: GatewayName, timeout?: number): GatewayFromWallet => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet(timeout)\n\n  const resolveGateway = () => {\n    // null client = wallet confirmed absent (no globalThis.xyo or timed out)\n    if (isNull(client)) return null\n    // client is undefined (still loading) or defined (wallet present) —\n    // optional chain returns undefined while loading, or the gateway if available\n    return client?.gateways?.[gatewayName!]\n  }\n\n  return {\n    // no gatewayName requested = undefined (opt-out, not \"absent\")\n    gateway: gatewayName ? resolveGateway() : undefined,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n\n/** @deprecated - useGatewayFromWallet */\nexport const useGateway = useGatewayFromWallet\n","import { createContextEx } from '@xylabs/react-shared'\n\nimport type { GatewayContextState } from './GatewayProviderState.ts'\n\n/**\n * Shared React context that decouples gateway *sources* from gateway\n * *consumers*. Any provider that can resolve an `XyoGateway` publishes to\n * this context; any hook or component that needs a gateway reads from it\n * via `useProvidedGateway`. Consumers never import a specific provider —\n * they just require that *some* provider is mounted above them in the\n * tree.\n *\n * Current publishers:\n * - `WalletGatewayProvider` (this package) — sources gateways from the\n *   injected XL1 wallet extension.\n * - `GatewayProvider` in `@xyo-network/react-chain-provider` — sources\n *   gateways built in-page against RPC endpoints, falling back to the\n *   wallet when available.\n *\n * To add a new source (e.g. a mock provider for tests, an iframe-bridged\n * provider, a server-rendered provider), publish a `GatewayContextState`\n * to this same context — do not create a parallel context, or consumers\n * will silently stop receiving updates.\n */\nexport const GatewayContext = createContextEx<GatewayContextState>()\n","import { createContextEx } from '@xylabs/react-shared'\n\nimport type { InPageGatewaysState } from './InPageGatewaysState.ts'\n\n/**\n * Narrow, provider-internal context that `InPageGatewaysProvider` writes\n * to and `GatewayProvider` reads from. Do not consume this in application\n * code — use `useProvidedGateway` (which reads the shared\n * `GatewayContext`) instead. This context only exists to decouple the\n * single in-page *builder* from the many single-gateway *adapters* that\n * sit between it and the shared gateway surface.\n */\nexport const InPageGatewaysContext = createContextEx<InPageGatewaysState>()\n","import type {\n  GatewayName, RpcTransport, XyoSignerRpcSchemas,\n} from '@xyo-network/xl1-sdk'\nimport { DefaultNetworks } from '@xyo-network/xl1-sdk'\nimport type { PropsWithChildren } from 'react'\nimport React, {\n  startTransition,\n  useCallback, useEffect, useMemo, useState,\n} from 'react'\n\nimport type { ContextGatewayType } from '../../types/index.ts'\nimport { InPageGatewaysContext } from './InPageGatewaysContext.ts'\nimport type { InPageGatewaysState } from './InPageGatewaysState.ts'\nimport { buildGateway } from './lib/index.ts'\n\nexport interface InPageGatewaysProviderProps extends PropsWithChildren {\n  signerTransport?: RpcTransport<XyoSignerRpcSchemas>\n}\n\n/**\n * Publishes a keyed map of in-page gateways — one per network in\n * `DefaultNetworks` — under the narrow `InPageGatewaysContext`.\n *\n * This provider is deliberately *not* a direct publisher of the shared\n * `GatewayContext` that `useProvidedGateway` reads. Its consumer is the\n * wrapping `GatewayProvider` in this same package, which picks the\n * `gatewayName` the consumer asked for out of this map, adapts it into\n * the single-gateway `GatewayContextState` shape, and then publishes *that*\n * to the shared context. Splitting the work this way lets one\n * `InPageGatewaysProvider` near the root build every network's gateway\n * once, while many `GatewayProvider` instances deeper in the tree each\n * expose whichever gateway their subtree cares about.\n *\n * Unlike `WalletGatewayProvider`, gateways here are constructed directly\n * in the page (via `buildGateway`) against each network's RPC endpoint\n * — no browser wallet extension is required. `signerTransport` switches\n * between viewer (read-only) and runner (can sign/send) locators; supply\n * it only when the app needs to sign.\n *\n * Behavior:\n * - On mount, and whenever `signerTransport` changes, `buildGateway` is\n *   called in parallel for every network in `DefaultNetworks` via\n *   `Promise.allSettled`. Networks that resolve populate `gateways[id]`;\n *   networks that reject populate `errors[id]`. One failed network does\n *   not block the others.\n * - If `signerTransport` is provided, gateways are built with a remote\n *   *runner* locator, otherwise with a remote *viewer* locator.\n * - When `signerTransport` changes identity mid-life, the provider clears\n *   all cached gateways and errors synchronously during render (via\n *   `previousSignerTransport` state) so consumers never see gateways\n *   bound to the previous transport, then rebuilds in the effect.\n * - State updates from the rebuild are wrapped in `startTransition` so a\n *   slow network doesn't stall higher-priority UI updates.\n * - A `cancelled` flag in the effect's cleanup discards results from a\n *   prior `signerTransport` once a new one is in flight.\n *\n * Published `InPageGatewaysState` (narrower than `GatewayContextState` —\n * this is an internal handoff shape, not the cross-publisher surface):\n * - `gateways` — `Partial<Record<GatewayName, ContextGatewayType>>`. Keys\n *   are only present for networks that built successfully.\n * - `errors` — `Partial<Record<GatewayName, Error>>`. Per-network build\n *   failures, keyed by `GatewayName`.\n * - `clearAll()` — manually empties both maps. Also invoked internally on\n *   transport changes. Forwarded by `GatewayProvider` to consumers as\n *   `resetGatewaysFromConfig`.\n * - `provided: true` — lets descendants detect a real provider.\n *\n * Note: the commented-out `SimpleXyoClient` at the top is intentionally\n * disabled pending a type unification between `XyoGateway` and\n * `XyoGatewayRunner`.\n */\nexport const InPageGatewaysProvider: React.FC<InPageGatewaysProviderProps> = ({ signerTransport, children }) => {\n  const [gateways, setGateways] = useState<Partial<Record<GatewayName, ContextGatewayType>>>({})\n  const [errors, setErrors] = useState<Partial<Record<GatewayName, Error>>>({})\n  const [previousSignerTransport, setPreviousSignerTransport] = useState<RpcTransport<XyoSignerRpcSchemas> | undefined>(signerTransport)\n\n  // This can come back once we homogenize the type for XyoGateway.\n  // Right now, SimpleXyoClient takes XyoGatewayRunners but ideally it would take XyoGateway.\n  // const clientInPage = useMemo(() => new SimpleXyoClient(gateways, {}), [gateways])\n\n  const clearAll = useCallback(() => {\n    setGateways({})\n    setErrors({})\n  }, [])\n\n  if (previousSignerTransport !== signerTransport) {\n    clearAll()\n    setPreviousSignerTransport(signerTransport)\n  }\n\n  useEffect(() => {\n    let cancelled = false\n\n    const buildAll = async () => {\n      const results = await Promise.allSettled(\n        DefaultNetworks.map(async (network) => {\n          const gateway = await buildGateway(network.id as GatewayName, signerTransport)\n          return { id: network.id as GatewayName, gateway }\n        }),\n      )\n\n      if (cancelled) return\n\n      const nextGateways: Partial<Record<GatewayName, ContextGatewayType>> = {}\n      const nextErrors: Partial<Record<GatewayName, Error>> = {}\n\n      for (const [index, result] of results.entries()) {\n        const networkId = DefaultNetworks[index].id as GatewayName\n        if (result.status === 'fulfilled') {\n          nextGateways[networkId] = result.value.gateway\n        } else {\n          nextErrors[networkId] = result.reason instanceof Error ? result.reason : new Error(String(result.reason))\n        }\n      }\n\n      startTransition(() => {\n        setGateways(nextGateways)\n        setErrors(nextErrors)\n      })\n    }\n\n    void buildAll()\n    return () => {\n      cancelled = true\n    }\n  }, [signerTransport])\n\n  const value = useMemo(() => {\n    const value: InPageGatewaysState = {\n      clearAll,\n      errors,\n      gateways,\n      provided: true,\n    }\n    return value\n  }, [clearAll, errors, gateways])\n\n  return <InPageGatewaysContext value={value}>{children}</InPageGatewaysContext>\n}\n","import { assertEx, isDefined } from '@xylabs/sdk-js'\nimport type {\n  GatewayName,\n  RemoteConfig, RpcTransport, SimpleXyoGateway,\n  XyoSignerRpcSchemas,\n} from '@xyo-network/xl1-sdk'\nimport {\n  basicRemoteRunnerLocator,\n  basicRemoteViewerLocator,\n  DefaultNetworks, NetworkDataLakeUrls, XyoGatewayMoniker,\n} from '@xyo-network/xl1-sdk'\n\nexport const buildGateway = async (gatewayName: GatewayName, signerTransport?: RpcTransport<XyoSignerRpcSchemas>) => {\n  const network = DefaultNetworks.find(network => network.id === gatewayName)\n  const resolvedNetwork = assertEx(network, () => `No network found for id ${gatewayName}`)\n\n  const remoteConfig: RemoteConfig = {\n    rpc: {\n      protocol: 'http',\n      url: `${resolvedNetwork.url}/rpc`,\n    },\n  }\n\n  const dataLakeEndpoint = NetworkDataLakeUrls[gatewayName]\n\n  const locator = isDefined(signerTransport)\n    ? await basicRemoteRunnerLocator(gatewayName, remoteConfig, signerTransport, dataLakeEndpoint)\n    : await basicRemoteViewerLocator(gatewayName, remoteConfig, dataLakeEndpoint)\n\n  return await locator.getInstance<SimpleXyoGateway>(XyoGatewayMoniker)\n}\n","import { useContextEx } from '@xylabs/react-shared'\n\nimport { InPageGatewaysContext } from './InPageGatewaysContext.ts'\n\n/**\n * Reads the `InPageGatewaysContext` map of per-network in-page gateways.\n * Intended for internal use by `GatewayProvider` — application code\n * should prefer `useProvidedGateway`, which returns a single resolved\n * gateway regardless of source.\n *\n * @param required - When `true` (default), throws if no\n *   `InPageGatewaysProvider` is mounted above.\n */\nexport const useProvidedInPageGateways = (required = true) => useContextEx(InPageGatewaysContext, 'InPageGateways', required)\n","import { ErrorRender } from '@xylabs/react-error'\nimport { isDefinedNotNull, isNull } from '@xylabs/sdk-js'\nimport React, { useMemo } from 'react'\n\nimport { useGatewayFromWallet } from '../../hooks/index.ts'\nimport { GatewayContext } from '../GatewayContext.ts'\nimport type { GatewayProviderProps } from '../GatewayProviderProps.ts'\nimport type { GatewayContextState } from '../GatewayProviderState.ts'\nimport { useProvidedInPageGateways } from '../in-page/index.ts'\n\n/**\n * Publishes the shared `GatewayContext` backed by two sources: the\n * injected XL1 Wallet extension *and* the in-page gateways built by\n * `InPageGatewaysProvider`. Use this provider when the host app can\n * function without a wallet (falling back to the in-page client) but\n * should still prefer the wallet when it is present.\n *\n * Required ancestry: an `InPageGatewaysProvider` must be mounted above\n * this provider — `useProvidedInPageGateways(true)` throws if missing.\n * If you only need a wallet-backed gateway, use `WalletGatewayProvider`\n * instead.\n *\n * Source precedence for `defaultGateway`:\n * - Wallet present and resolved (`XyoGatewayRunner`) → wallet wins; the\n *   in-page gateway is still exposed via `gateways.inPageGateway` for\n *   the rare consumer that needs to target it specifically.\n * - Wallet definitively absent (`null`) → fall back to the in-page\n *   gateway matching `gatewayName`.\n * - Wallet still resolving (`undefined`) → leave `defaultGateway`\n *   `undefined` so consumers render a loading state rather than\n *   committing to the in-page fallback prematurely.\n *\n * The published `GatewayContextState` shape:\n * - `defaultGateway` — resolved per the precedence above. Three-state:\n *   `undefined` = loading, `null` is not produced by this provider\n *   (wallet-null collapses to `gatewayFromConfig`), `XyoGateway` = ready.\n * - `gateways.walletGateway` — raw wallet result (tri-state).\n * - `gateways.inPageGateway` — raw in-page result for the requested\n *   `gatewayName`, or `undefined` if no `gatewayName` was passed.\n * - `error` — first non-null of wallet error, then in-page build error\n *   for this `gatewayName`. Also rendered inline via `ErrorRender` above\n *   `children` so mount-time failures surface even when no consumer\n *   reads `error`.\n * - `resetGatewaysFromConfig` — forwards `clearAll` from\n *   `InPageGatewaysProvider`, letting consumers force a rebuild of the\n *   in-page gateways (e.g. after a network or endpoint change).\n * - `provided: true` — lets descendants detect a real provider in the\n *   tree.\n *\n * `defaultGateway`, `gateways`, and the context `value` are memoized so\n * consumers only re-render when wallet or in-page sources actually\n * change identity.\n */\nexport const GatewayProvider: React.FC<GatewayProviderProps> = ({ gatewayName, children }) => {\n  const {\n    gateway: gatewayFromWallet,\n    error: gatewayFromWalletError,\n  } = useGatewayFromWallet(gatewayName)\n\n  const {\n    gateways: allGateways,\n    errors: allGatewayErrors,\n    clearAll,\n  } = useProvidedInPageGateways(true)\n\n  const gatewayFromConfig = gatewayName ? allGateways[gatewayName] : undefined\n  const gatewayFromConfigError = gatewayName ? allGatewayErrors[gatewayName] : undefined\n\n  const { defaultGateway, gateways } = useMemo(() => {\n    if (isNull(gatewayFromWallet)) {\n      return {\n        defaultGateway: gatewayFromConfig,\n        gateways: {\n          inPageGateway: gatewayFromConfig,\n          walletGateway: null,\n        },\n      }\n    } else if (isDefinedNotNull(gatewayFromWallet)) {\n      return {\n        defaultGateway: gatewayFromWallet,\n        gateways: {\n          inPageGateway: gatewayFromConfig,\n          walletGateway: gatewayFromWallet,\n        },\n      }\n    }\n    return {\n      defaultGateway: undefined,\n      gateways: {\n        inPageGateway: undefined,\n        walletGateway: undefined,\n      },\n    }\n  }, [gatewayFromConfig, gatewayFromWallet])\n\n  const value = useMemo(() => {\n    const value: GatewayContextState = {\n      defaultGateway,\n      error: gatewayFromWalletError || gatewayFromConfigError,\n      gateways,\n      provided: true,\n      resetGatewaysFromConfig: clearAll,\n    }\n    return value\n  }, [\n    defaultGateway,\n    gatewayFromWalletError,\n    gatewayFromConfigError,\n    gateways,\n    clearAll,\n  ])\n\n  return (\n    <GatewayContext value={value}>\n      <ErrorRender error={gatewayFromConfigError} />\n      {children}\n    </GatewayContext>\n  )\n}\n","import { ErrorRender } from '@xylabs/react-error'\nimport React, { useMemo } from 'react'\n\nimport { useGatewayFromWallet } from '../../hooks/index.ts'\nimport { GatewayContext } from '../GatewayContext.ts'\nimport type { GatewayProviderProps } from '../GatewayProviderProps.ts'\nimport type { GatewayContextState } from '../GatewayProviderState.ts'\n\n/**\n * Publishes a `GatewayContext` backed exclusively by the injected XL1 Wallet\n * extension (i.e. `globalThis.xyo`). This is the provider to use when the\n * host app is a browser UI that expects the user to bring their own wallet,\n * rather than running an in-page gateway.\n *\n * The requested `gatewayName` is forwarded to `useGatewayFromWallet`, whose\n * returned gateway uses a three-state contract (`undefined` = still\n * resolving, `null` = wallet confirmed absent / timed out,\n * `XyoGatewayRunner` = ready). That tri-state is passed through to\n * consumers unchanged as `defaultGateway` / `gateways.walletGateway`, so\n * downstream hooks can distinguish \"loading\" from \"missing\".\n *\n * The published `GatewayContextState` shape:\n * - `defaultGateway` — the wallet gateway, used when consumers don't\n *   specify which gateway they want.\n * - `gateways.walletGateway` — same instance as `defaultGateway`.\n * - `gateways.inPageGateway` — always `null` here; this provider does not\n *   stand up an in-page client. Pair with a different provider if you need\n *   both.\n * - `error` — surfaced from `useGatewayFromWallet` (detection / timeout /\n *   wallet errors). Also rendered inline via `ErrorRender` above `children`\n *   so mount-time failures are visible even if no consumer reads `error`.\n * - `provided: true` — lets descendants detect that a real provider (not\n *   the default empty context) is in the tree.\n *\n * The `defaultGateway`, `gateways`, and context `value` are memoized so\n * consumers only re-render when the underlying wallet gateway reference or\n * error actually changes.\n */\nexport const WalletGatewayProvider: React.FC<GatewayProviderProps> = ({ gatewayName, children }) => {\n  const {\n    gateway: gatewayFromWallet,\n    error: gatewayFromWalletError,\n  } = useGatewayFromWallet(gatewayName)\n\n  const { defaultGateway, gateways } = useMemo(() => {\n    return {\n      defaultGateway: gatewayFromWallet,\n      gateways: {\n        inPageGateway: null,\n        walletGateway: gatewayFromWallet,\n      },\n    }\n  }, [gatewayFromWallet])\n\n  const value = useMemo(() => {\n    const value: GatewayContextState = {\n      defaultGateway,\n      error: gatewayFromWalletError,\n      gateways,\n      provided: true,\n    }\n    return value\n  }, [\n    defaultGateway,\n    gatewayFromWalletError,\n    gateways,\n  ])\n\n  return (\n    <GatewayContext value={value}>\n      <ErrorRender error={gatewayFromWalletError} />\n      {children}\n    </GatewayContext>\n  )\n}\n","import { useContextEx } from '@xylabs/react-shared'\n\nimport { GatewayContext } from './GatewayContext.ts'\n\n/**\n * The sole consumer entry point for gateway state. Reads the nearest\n * `GatewayContext` in the tree, regardless of which provider published\n * it — this is the decoupling that lets a component work unchanged when\n * the surrounding app swaps `WalletGatewayProvider` for\n * `GatewayProvider` (or a test double).\n *\n * @param required - When `true` (default), throws if no gateway provider\n *   is mounted above — use this when the component is meaningless\n *   without a gateway. When `false`, returns default state (all fields\n *   undefined) so the component can render a graceful fallback.\n */\nexport const useProvidedGateway = (required = true) => useContextEx(GatewayContext, 'Gateway', required)\n"],"mappings":"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","names":["Stack","Tooltip","Typography","EthAddressWrapper","BlockiesAvatarAddress","React","ConnectedAccount","address","shortenedAddress","EthAddressWrapper","fromString","toShortString","Stack","direction","alignItems","spacing","BlockiesAvatarAddress","size","Tooltip","title","Typography","color","variant","fontFamily","Alert","AlertTitle","Button","Stack","Typography","ButtonEx","ErrorRender","isDefined","isUndefined","React","useEffect","asAddress","assertEx","MainNetwork","useCallback","useState","isDefined","findCaveat","permissions","targetCapability","targetCaveatType","existingPermissions","getPermissions","isDefined","length","foundPermissions","find","p","parentCapability","caveats","caveat","type","value","isUndefined","useEffect","useState","isUndefined","CLIENT_LISTENER_TIMEOUT","hasXyoClient","globalThis","xyo","listenForClientInjection","onClientReady","timeout","onTimeout","resolved","listener","addEventListener","setTimeout","removeEventListener","getXyoClient","isUndefined","client","Promise","resolve","initialState","client","undefined","error","isLoading","timedout","useClientFromWallet","timeout","state","setState","useState","useEffect","cancelled","initialize","prev","getXyoClient","onPluginReady","isUndefined","globalThis","xyo","addEventListener","removeEventListener","useClient","usePermissions","client","isLoading","error","timedout","useClientFromWallet","permissions","usePromise","isArray","isDefined","isDefinedNotNull","isString","validateRestrictedAccounts","restrictedAccounts","isDefined","isArray","every","isString","Error","JSON","stringify","useAccountPermissions","permissions","error","usePermissions","usePromise","isDefinedNotNull","findCaveat","isNull","useGatewayFromWallet","gatewayName","timeout","client","isLoading","error","timedout","useClientFromWallet","resolveGateway","isNull","gateways","gateway","undefined","useGateway","useConnectAccount","gatewayName","MainNetwork","id","timeout","connectError","setConnectError","useState","gateway","error","timedout","useGatewayFromWallet","accountPermissions","accountPermissionsError","useAccountPermissions","address","setAddress","connectSigner","useCallback","undefined","assertedGateway","assertEx","signer","e","asAddress","DefaultConnectComponent","props","React","ButtonEx","variant","size","DefaultNoWalletInstalledComponent","Alert","severity","AlertTitle","Typography","gutterBottom","Button","sx","display","justifySelf","href","target","rel","ConnectAccountsStack","AccountComponent","ConnectedAccount","ConnectComponent","NoWalletInstalledComponent","onAccountConnected","onCancel","timeout","address","connectSigner","error","timedout","useConnectAccount","undefined","useEffect","isDefined","Stack","direction","alignItems","spacing","isUndefined","onClick","ErrorRender","scope","createContextEx","GatewayContext","createContextEx","InPageGatewaysContext","DefaultNetworks","React","startTransition","useCallback","useEffect","useMemo","useState","assertEx","isDefined","basicRemoteRunnerLocator","basicRemoteViewerLocator","DefaultNetworks","NetworkDataLakeUrls","XyoGatewayMoniker","buildGateway","gatewayName","signerTransport","network","DefaultNetworks","find","id","resolvedNetwork","assertEx","remoteConfig","rpc","protocol","url","dataLakeEndpoint","NetworkDataLakeUrls","locator","isDefined","basicRemoteRunnerLocator","basicRemoteViewerLocator","getInstance","XyoGatewayMoniker","InPageGatewaysProvider","signerTransport","children","gateways","setGateways","useState","errors","setErrors","previousSignerTransport","setPreviousSignerTransport","clearAll","useCallback","useEffect","cancelled","buildAll","results","Promise","allSettled","DefaultNetworks","map","network","gateway","buildGateway","id","nextGateways","nextErrors","index","result","entries","networkId","status","value","reason","Error","String","startTransition","useMemo","provided","React","InPageGatewaysContext","useContextEx","useProvidedInPageGateways","required","useContextEx","InPageGatewaysContext","ErrorRender","isDefinedNotNull","isNull","React","useMemo","GatewayProvider","gatewayName","children","gateway","gatewayFromWallet","error","gatewayFromWalletError","useGatewayFromWallet","gateways","allGateways","errors","allGatewayErrors","clearAll","useProvidedInPageGateways","gatewayFromConfig","undefined","gatewayFromConfigError","defaultGateway","useMemo","isNull","inPageGateway","walletGateway","isDefinedNotNull","value","provided","resetGatewaysFromConfig","React","GatewayContext","ErrorRender","ErrorRender","React","useMemo","WalletGatewayProvider","gatewayName","children","gateway","gatewayFromWallet","error","gatewayFromWalletError","useGatewayFromWallet","defaultGateway","gateways","useMemo","inPageGateway","walletGateway","value","provided","React","GatewayContext","ErrorRender","useContextEx","useProvidedGateway","required","useContextEx","GatewayContext"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/react-chain-client",
-  "version": "1.20.24",
+  "version": "1.20.26",
   "description": "XYO Layer One React SDK - Client/Wallet Hooks",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -42,7 +42,7 @@
     "@xylabs/react-error": "~7.1.20",
     "@xylabs/react-shared": "~7.1.20",
     "@xyo-network/xl1-sdk": "^1.26.36",
-    "@xyo-network/react-chain-blockies": "~1.20.24"
+    "@xyo-network/react-chain-blockies": "~1.20.26"
   },
   "devDependencies": {
     "@emotion/react": "^11.5.0",
@@ -134,8 +134,8 @@
     "vite": "^8.0.9",
     "webextension-polyfill": "^0.10.0 || ^0.11.0 || ^0.12.0",
     "zod": "~4.3.6",
-    "@xyo-network/react-chain-model": "~1.20.24",
-    "@xyo-network/react-chain-shared": "~1.20.24"
+    "@xyo-network/react-chain-model": "~1.20.26",
+    "@xyo-network/react-chain-shared": "~1.20.26"
   },
   "peerDependencies": {
     "@mui/material": ">=6 <8",

package/dist/browser/context/WalletGatewayProvider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WalletGatewayProvider.d.ts","sourceRoot":"","sources":["../../../src/context/WalletGatewayProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAoChE,CAAA"}