@xyo-network/xl1-react-client-sdk 4.4.7 → 4.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,12 @@
1
1
  import type { CreatableProviderFactory, RpcTransport, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
2
2
  import type { PropsWithChildren } from 'react';
3
3
  import React from 'react';
4
+ import type { GatewayTransport } from './lib/index.ts';
4
5
  export interface InPageGatewaysProviderProps extends PropsWithChildren {
5
6
  localEndpoint?: string;
6
7
  signerFactory?: CreatableProviderFactory;
7
8
  signerTransport?: RpcTransport<XyoSignerRpcSchemas>;
9
+ transport?: GatewayTransport;
8
10
  }
9
11
  /**
10
12
  * Publishes a keyed map of in-page gateways — one per network in
@@ -26,6 +28,11 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
26
28
  * between viewer (read-only) and runner (can sign/send) locators; supply
27
29
  * it only when the app needs to sign.
28
30
  *
31
+ * `transport` selects how each gateway reads chain data: `'rpc'` (the
32
+ * default viewer/runner locator, reads over RPC) or `'rest'` (the
33
+ * REST/S3-backed implementation, reads from the static CDN layout). It is
34
+ * forwarded to `buildGateway`.
35
+ *
29
36
  * Behavior:
30
37
  * - On mount, and whenever `signerTransport` changes, `buildGateway` is
31
38
  * called in parallel for every network in `DefaultNetworks` via
@@ -1 +1 @@
1
- {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACX,YAAY,EAAE,mBAAmB,EAC/C,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,KAGN,MAAM,OAAO,CAAA;AAUd,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IAEpE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,aAAa,CAAC,EAAE,wBAAwB,CAAA;IAExC,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuExE,CAAA"}
1
+ {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACX,YAAY,EAAE,mBAAmB,EAC/C,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,KAGN,MAAM,OAAO,CAAA;AAKd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAMtD,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IAEpE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,aAAa,CAAC,EAAE,wBAAwB,CAAA;IAExC,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;IAEnD,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuExE,CAAA"}
@@ -1,22 +1,30 @@
1
1
  import type { CreatableProviderFactory, GatewayName, RpcTransport, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
2
2
  import type { ContextGatewayType } from '../../../types/index.ts';
3
+ /** How an in-page gateway reads chain data: over the network's RPC endpoint, or the static REST/S3 layout. */
4
+ export type GatewayTransport = 'rpc' | 'rest';
3
5
  /**
4
- * Builds a single in-page gateway for `gatewayName`, backed by the network's static REST/S3
5
- * layout for chain reads. When a signing capability is supplied it returns a write-capable
6
- * `XyoGatewayRunner` (mempool submission over the RPC endpoint); otherwise a read-only
7
- * `XyoGateway`.
6
+ * Builds a single in-page gateway for `gatewayName`. Two implementations are available, selected
7
+ * by `transport`:
8
8
  *
9
- * The static REST layout and the RPC mempool endpoint live at different hosts: chain reads come
10
- * from the per-network `<gatewayName>.xyo.space` root (blocks./state./indexes. subdomains derived
11
- * from it), while transaction submission goes to the network's RPC url (`network.url` + `/rpc`).
12
- * The local network is the exception — it reads a path-based layout (`/blocks`, `/state`,
13
- * `/indexes`) served by `localEndpoint`, since there is no published `local.xyo.space` host.
9
+ * - **`'rpc'` (default)** — the original viewer/runner-locator implementation. Both chain reads
10
+ * and transaction submission go over the network's RPC endpoint (`network.url` + `/rpc`) via
11
+ * `basicRemoteViewerLocator` / `basicRemoteRunnerLocator`. This is the safe upgrade default;
12
+ * REST is opt-in.
13
+ * - **`'rest'`** — chain reads come from the network's static REST/S3 layout (the
14
+ * `<gatewayName>.xyo.space` root, blocks./state./indexes. subdomains derived from it), while
15
+ * transaction submission goes to the RPC url. The local network is the exception — it reads a
16
+ * path-based layout (`/blocks`, `/state`, `/indexes`) served by `localEndpoint`, since there is
17
+ * no published `local.xyo.space` host.
14
18
  *
15
- * - `localEndpoint` — the REST/S3 root the local network reads from (path-based buckets). Unused
16
- * for other networks, whose buckets are derived from `<gatewayName>.xyo.space`.
19
+ * When a signing capability is supplied either implementation returns a write-capable runner;
20
+ * otherwise a read-only gateway.
21
+ *
22
+ * - `localEndpoint` — the REST/S3 root the local network reads from (path-based buckets). Only
23
+ * consulted when `transport` is `'rest'` and `gatewayName` is the local network.
17
24
  * - `signerTransport` — an RPC transport to a remote signer, for pages that don't own a signer.
18
25
  * - `signerFactory` — a pre-built in-page local signer provider. Takes precedence over
19
26
  * `signerTransport` when both are supplied (matches the runner locator's own ordering).
27
+ * - `transport` — how chain data is read. Defaults to `'rpc'`.
20
28
  */
21
- export declare const buildGateway: (gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory) => Promise<ContextGatewayType>;
29
+ export declare const buildGateway: (gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory, transport?: GatewayTransport) => Promise<ContextGatewayType>;
22
30
  //# sourceMappingURL=buildGateway.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EAEX,YAAY,EACZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAS7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,WAAW,EACxB,eAAe,MAAM,EACrB,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,EACnD,gBAAgB,wBAAwB,KACvC,OAAO,CAAC,kBAAkB,CA6B5B,CAAA"}
1
+ {"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EAGX,YAAY,EAEZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAY7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,8GAA8G;AAC9G,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,WAAW,EACxB,eAAe,MAAM,EACrB,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,EACnD,gBAAgB,wBAAwB,EACxC,YAAW,gBAAwB,KAClC,OAAO,CAAC,kBAAkB,CAsC5B,CAAA"}
@@ -2153,16 +2153,24 @@ var InPageGatewaysContext = createContextEx2();
2153
2153
  // src/client/context/in-page/lib/buildGateway.ts
2154
2154
  import { assertEx as assertEx3, isDefined as isDefined14 } from "@ariestools/sdk";
2155
2155
  import {
2156
+ basicRemoteRunnerLocator,
2157
+ basicRemoteViewerLocator,
2156
2158
  DefaultNetworks,
2157
2159
  getRestGateway,
2158
2160
  getRestGatewayRunner,
2159
2161
  LocalNetwork as LocalNetwork2,
2160
- restGatewayConfigFromEndpoint
2162
+ restGatewayConfigFromEndpoint,
2163
+ XyoGatewayMoniker
2161
2164
  } from "@xyo-network/xl1-sdk";
2162
- var buildGateway = async (gatewayName, localEndpoint, signerTransport, signerFactory) => {
2165
+ var buildGateway = async (gatewayName, localEndpoint, signerTransport, signerFactory, transport = "rpc") => {
2163
2166
  const network = DefaultNetworks.find((network2) => network2.id === gatewayName);
2164
2167
  const resolvedNetwork = assertEx3(network, () => `No network found for id ${gatewayName}`);
2165
2168
  const rpcUrl = `${resolvedNetwork.url}/rpc`;
2169
+ if (transport === "rpc") {
2170
+ const rpcConnection = { protocol: "http", url: rpcUrl };
2171
+ const locator = isDefined14(signerTransport) || isDefined14(signerFactory) ? await basicRemoteRunnerLocator(gatewayName, rpcConnection, signerTransport, void 0, { signerFactory }) : await basicRemoteViewerLocator(gatewayName, rpcConnection);
2172
+ return await locator.getInstance(XyoGatewayMoniker);
2173
+ }
2166
2174
  const config = gatewayName === LocalNetwork2.id ? {
2167
2175
  blocks: { readUrl: `${localEndpoint}/blocks` },
2168
2176
  chainState: { readUrl: `${localEndpoint}/state` },
@@ -2197,11 +2205,12 @@ import {
2197
2205
  useState as useState15
2198
2206
  } from "react";
2199
2207
  import { jsx as jsx17 } from "react/jsx-runtime";
2200
- var DEFAULT_LOCAL_ENDPOINT = "http://127.0.0.1:8791";
2208
+ var DEFAULT_LOCAL_ENDPOINT = "https://chain.aries.test:8791";
2201
2209
  var InPageGatewaysProvider = ({
2202
2210
  localEndpoint = DEFAULT_LOCAL_ENDPOINT,
2203
2211
  signerFactory,
2204
2212
  signerTransport,
2213
+ transport = "rpc",
2205
2214
  children
2206
2215
  }) => {
2207
2216
  const [gateways, setGateways] = useState15({});
@@ -2221,7 +2230,7 @@ var InPageGatewaysProvider = ({
2221
2230
  if (cancelled) return;
2222
2231
  const results = await Promise.allSettled(
2223
2232
  DefaultNetworks2.map(async (network) => {
2224
- const gateway = await buildGateway(network.id, localEndpoint, signerTransport, signerFactory);
2233
+ const gateway = await buildGateway(network.id, localEndpoint, signerTransport, signerFactory, transport);
2225
2234
  return { id: network.id, gateway };
2226
2235
  })
2227
2236
  );
@@ -2246,7 +2255,7 @@ var InPageGatewaysProvider = ({
2246
2255
  return () => {
2247
2256
  cancelled = true;
2248
2257
  };
2249
- }, [localEndpoint, signerFactory, signerTransport]);
2258
+ }, [localEndpoint, signerFactory, signerTransport, transport]);
2250
2259
  const value = useMemo6(() => {
2251
2260
  const value2 = {
2252
2261
  clearAll,