@xyo-network/xl1-react-client-sdk 5.0.14 → 5.0.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser/client/context/in-page/Provider.d.ts +8 -9
- package/dist/browser/client/context/in-page/Provider.d.ts.map +1 -1
- package/dist/browser/client/context/in-page/lib/buildGateway.d.ts +2 -0
- package/dist/browser/client/context/in-page/lib/buildGateway.d.ts.map +1 -1
- package/dist/browser/client/context/in-page/lib/launchInPageGatewaySystem.d.ts +5 -3
- package/dist/browser/client/context/in-page/lib/launchInPageGatewaySystem.d.ts.map +1 -1
- package/dist/browser/client/index.mjs +42 -53
- package/dist/browser/client/index.mjs.map +3 -3
- package/dist/browser/index.mjs +42 -53
- package/dist/browser/index.mjs.map +3 -3
- package/package.json +20 -20
|
@@ -11,6 +11,8 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
|
|
|
11
11
|
signerAccount?: AccountInstance;
|
|
12
12
|
/** Factory that supplies the signer used by mutation providers. */
|
|
13
13
|
signerFactory?: CreatableProviderFactory;
|
|
14
|
+
/** Stable config identifier for signerFactory; defaults to its providerName. */
|
|
15
|
+
signerProviderId?: string;
|
|
14
16
|
/** Optional RPC transport used to reach a remote signer. */
|
|
15
17
|
signerTransport?: RpcTransport<XyoSignerRpcSchemas>;
|
|
16
18
|
/** Chain-data transport mode; defaults to JSON-RPC and may be set to static REST. */
|
|
@@ -31,10 +33,9 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
|
|
|
31
33
|
* expose whichever gateway their subtree cares about.
|
|
32
34
|
*
|
|
33
35
|
* Unlike `WalletGatewayProvider`, gateways here are owned by the page — no
|
|
34
|
-
* browser wallet extension is required.
|
|
35
|
-
* config-resolved XL1 browser system per network
|
|
36
|
-
*
|
|
37
|
-
* `buildGateway` compatibility path.
|
|
36
|
+
* browser wallet extension is required. Every gateway launches one
|
|
37
|
+
* config-resolved XL1 browser system per network, regardless of transport or
|
|
38
|
+
* signing mode.
|
|
38
39
|
*
|
|
39
40
|
* `transport` selects how each gateway reads chain data: `'rpc'` (the
|
|
40
41
|
* default viewer/runner locator, reads over RPC) or `'rest'` (the
|
|
@@ -46,11 +47,9 @@ export interface InPageGatewaysProviderProps extends PropsWithChildren {
|
|
|
46
47
|
* `Promise.allSettled`. Networks that resolve populate `gateways[id]`;
|
|
47
48
|
* networks that reject populate `errors[id]`. One failed network does
|
|
48
49
|
* not block the others.
|
|
49
|
-
* -
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
* - If a signing capability is provided, gateways are built through the
|
|
53
|
-
* existing *runner* compatibility path.
|
|
50
|
+
* - Every gateway is resolved once through browser-kit and shares one
|
|
51
|
+
* immutable provider graph with its XL1 system actor. The page owns each
|
|
52
|
+
* session until React cleanup or `pagehide`.
|
|
54
53
|
* - When `signerTransport` changes identity mid-life, the provider clears
|
|
55
54
|
* all cached gateways and errors synchronously during render (via
|
|
56
55
|
* `previousSignerTransport` state) so consumers never see gateways
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,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,
|
|
1
|
+
{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/context/in-page/Provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,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,EACL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAA;AAKvB,iEAAiE;AACjE,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IAEpE,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,eAAe,CAAA;IAE/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,wBAAwB,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAA;IAEnD,qFAAqF;IACrF,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqGxE,CAAA"}
|
|
@@ -28,6 +28,8 @@ export type GatewayTransport = 'rpc' | 'rest';
|
|
|
28
28
|
* - `transport` — how chain data is read. Defaults to `'rpc'`.
|
|
29
29
|
* - `signerAccount` — a signing account the page owns; seeds the context signer home and
|
|
30
30
|
* registers a `SimpleXyoSigner`. Precedence: `signerFactory` › `signerAccount` › `signerTransport`.
|
|
31
|
+
* @deprecated Direct-locator compatibility only. Use `launchXl1BrowserGatewaySystem` and retain
|
|
32
|
+
* its session so the owning browser realm can stop the provider system.
|
|
31
33
|
*/
|
|
32
34
|
export declare const buildGateway: (gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory, transport?: GatewayTransport, signerAccount?: AccountInstance) => Promise<ContextGatewayType>;
|
|
33
35
|
//# 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,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,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
|
|
1
|
+
{"version":3,"file":"buildGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/buildGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,WAAW,EACxB,eAAe,MAAM,EACrB,kBAAkB,YAAY,CAAC,mBAAmB,CAAC,EACnD,gBAAgB,wBAAwB,EACxC,YAAW,gBAAwB,EACnC,gBAAgB,eAAe,KAC9B,OAAO,CAAC,kBAAkB,CA2C5B,CAAA"}
|
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { AccountInstance } from '@xyo-network/sdk';
|
|
2
|
+
import type { CreatableProviderFactory, GatewayName, RpcTransport, XyoSignerRpcSchemas } from '@xyo-network/xl1-sdk';
|
|
2
3
|
import type { ContextGatewayType } from '../../../types/index.ts';
|
|
4
|
+
import type { GatewayTransport } from './buildGateway.ts';
|
|
3
5
|
/** Page-owned browser-system session exposing the gateway expected by the React context. */
|
|
4
6
|
export interface InPageGatewaySystem {
|
|
5
7
|
readonly gateway: ContextGatewayType;
|
|
6
8
|
stop(): Promise<void>;
|
|
7
9
|
}
|
|
8
|
-
/** Launches one
|
|
9
|
-
export declare function launchInPageGatewaySystem(gatewayName: GatewayName, localEndpoint: string): Promise<InPageGatewaySystem>;
|
|
10
|
+
/** Launches one page-owned REST/RPC browser system for a configured XL1 network. */
|
|
11
|
+
export declare function launchInPageGatewaySystem(gatewayName: GatewayName, localEndpoint: string, signerTransport?: RpcTransport<XyoSignerRpcSchemas>, signerFactory?: CreatableProviderFactory, transport?: GatewayTransport, signerAccount?: AccountInstance, signerProviderId?: string): Promise<InPageGatewaySystem>;
|
|
10
12
|
//# sourceMappingURL=launchInPageGatewaySystem.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"launchInPageGatewaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/launchInPageGatewaySystem.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"launchInPageGatewaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/client/context/in-page/lib/launchInPageGatewaySystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EACV,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,oFAAoF;AACpF,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,EACnD,aAAa,CAAC,EAAE,wBAAwB,EACxC,SAAS,GAAE,gBAAyB,EACpC,aAAa,CAAC,EAAE,eAAe,EAC/B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuB9B"}
|
|
@@ -2205,49 +2205,33 @@ var buildGateway = async (gatewayName, localEndpoint, signerTransport, signerFac
|
|
|
2205
2205
|
|
|
2206
2206
|
// src/client/context/in-page/lib/launchInPageGatewaySystem.ts
|
|
2207
2207
|
import { assertEx as assertEx4 } from "@ariestools/sdk";
|
|
2208
|
-
import {
|
|
2209
|
-
createXl1RestBrowserSystemConfig,
|
|
2210
|
-
launchXl1BrowserSystem,
|
|
2211
|
-
Xl1BrowserSystemActor
|
|
2212
|
-
} from "@xyo-network/xl1-browser-system";
|
|
2208
|
+
import { launchXl1BrowserGatewaySystem } from "@xyo-network/xl1-browser-system";
|
|
2213
2209
|
import {
|
|
2214
2210
|
DefaultNetworks as DefaultNetworks2,
|
|
2215
2211
|
LocalNetwork as LocalNetwork3
|
|
2216
2212
|
} from "@xyo-network/xl1-sdk";
|
|
2217
2213
|
var PAGE_HOST = "page";
|
|
2218
|
-
async function launchInPageGatewaySystem(gatewayName, localEndpoint) {
|
|
2214
|
+
async function launchInPageGatewaySystem(gatewayName, localEndpoint, signerTransport, signerFactory, transport = "rest", signerAccount, signerProviderId) {
|
|
2219
2215
|
const network = DefaultNetworks2.find((network2) => network2.id === gatewayName);
|
|
2220
2216
|
const resolvedNetwork = assertEx4(network, () => `No network found for id ${gatewayName}`);
|
|
2221
2217
|
const isLocal = resolvedNetwork.id === LocalNetwork3.id;
|
|
2222
|
-
const
|
|
2223
|
-
const
|
|
2218
|
+
const rpcUrl = `${resolvedNetwork.url}/rpc`;
|
|
2219
|
+
const endpoint = transport === "rpc" ? rpcUrl : isLocal ? localEndpoint : `https://${resolvedNetwork.id}.xyo.space`;
|
|
2220
|
+
const session = await launchXl1BrowserGatewaySystem({
|
|
2224
2221
|
endpoint,
|
|
2225
2222
|
host: PAGE_HOST,
|
|
2226
|
-
layout: isLocal ? "path" : "subdomain"
|
|
2223
|
+
layout: transport === "rest" && isLocal ? "path" : "subdomain",
|
|
2224
|
+
rpcUrl,
|
|
2225
|
+
signerAccount,
|
|
2226
|
+
signerFactory,
|
|
2227
|
+
signerProviderId,
|
|
2228
|
+
signerTransport,
|
|
2229
|
+
transport
|
|
2227
2230
|
});
|
|
2228
|
-
|
|
2229
|
-
|
|
2230
|
-
|
|
2231
|
-
}
|
|
2232
|
-
try {
|
|
2233
|
-
const actor = session.actors.find((actor2) => actor2 instanceof Xl1BrowserSystemActor);
|
|
2234
|
-
const resolvedActor = assertEx4(actor, () => `XL1 browser system actor was not created for ${gatewayName}`);
|
|
2235
|
-
const gateway = await resolvedActor.getGateway();
|
|
2236
|
-
return {
|
|
2237
|
-
gateway,
|
|
2238
|
-
stop: async () => await session.stop()
|
|
2239
|
-
};
|
|
2240
|
-
} catch (launchError) {
|
|
2241
|
-
const [stopResult] = await Promise.allSettled([session.stop()]);
|
|
2242
|
-
if (stopResult.status === "rejected") {
|
|
2243
|
-
throw new AggregateError(
|
|
2244
|
-
[launchError, stopResult.reason],
|
|
2245
|
-
`XL1 browser system for ${gatewayName} failed to expose a gateway and stop cleanly`,
|
|
2246
|
-
{ cause: launchError }
|
|
2247
|
-
);
|
|
2248
|
-
}
|
|
2249
|
-
throw launchError;
|
|
2250
|
-
}
|
|
2231
|
+
return {
|
|
2232
|
+
gateway: session.gateway,
|
|
2233
|
+
stop: async () => await session.stop()
|
|
2234
|
+
};
|
|
2251
2235
|
}
|
|
2252
2236
|
|
|
2253
2237
|
// src/client/context/in-page/Provider.tsx
|
|
@@ -2266,6 +2250,7 @@ var InPageGatewaysProvider = ({
|
|
|
2266
2250
|
localEndpoint = DEFAULT_LOCAL_ENDPOINT,
|
|
2267
2251
|
signerAccount,
|
|
2268
2252
|
signerFactory,
|
|
2253
|
+
signerProviderId,
|
|
2269
2254
|
signerTransport,
|
|
2270
2255
|
transport = "rpc",
|
|
2271
2256
|
children
|
|
@@ -2288,28 +2273,32 @@ var InPageGatewaysProvider = ({
|
|
|
2288
2273
|
if (cancelled) return;
|
|
2289
2274
|
const results = await Promise.allSettled(
|
|
2290
2275
|
DefaultNetworks3.map(async (network) => {
|
|
2291
|
-
|
|
2292
|
-
|
|
2293
|
-
|
|
2294
|
-
|
|
2295
|
-
|
|
2296
|
-
|
|
2297
|
-
|
|
2298
|
-
|
|
2299
|
-
|
|
2300
|
-
|
|
2301
|
-
|
|
2302
|
-
...previous,
|
|
2303
|
-
[network.id]: error instanceof Error ? error : new Error(String(error))
|
|
2304
|
-
}));
|
|
2305
|
-
});
|
|
2306
|
-
}
|
|
2307
|
-
});
|
|
2308
|
-
ownedSystems.push({ disposePageLifecycle, system });
|
|
2276
|
+
const system = await launchInPageGatewaySystem(
|
|
2277
|
+
network.id,
|
|
2278
|
+
localEndpoint,
|
|
2279
|
+
signerTransport,
|
|
2280
|
+
signerFactory,
|
|
2281
|
+
transport,
|
|
2282
|
+
signerAccount,
|
|
2283
|
+
signerProviderId
|
|
2284
|
+
);
|
|
2285
|
+
if (cancelled) {
|
|
2286
|
+
await Promise.allSettled([system.stop()]);
|
|
2309
2287
|
return { id: network.id, gateway: system.gateway };
|
|
2310
2288
|
}
|
|
2311
|
-
const
|
|
2312
|
-
|
|
2289
|
+
const disposePageLifecycle = bindPageLifecycle(system, {
|
|
2290
|
+
onStopError: (error) => {
|
|
2291
|
+
if (cancelled) return;
|
|
2292
|
+
startTransition(() => {
|
|
2293
|
+
setErrors((previous) => ({
|
|
2294
|
+
...previous,
|
|
2295
|
+
[network.id]: error instanceof Error ? error : new Error(String(error))
|
|
2296
|
+
}));
|
|
2297
|
+
});
|
|
2298
|
+
}
|
|
2299
|
+
});
|
|
2300
|
+
ownedSystems.push({ disposePageLifecycle, system });
|
|
2301
|
+
return { id: network.id, gateway: system.gateway };
|
|
2313
2302
|
})
|
|
2314
2303
|
);
|
|
2315
2304
|
if (!cancelled) {
|
|
@@ -2335,7 +2324,7 @@ var InPageGatewaysProvider = ({
|
|
|
2335
2324
|
for (const owned of ownedSystems) owned.disposePageLifecycle();
|
|
2336
2325
|
void Promise.allSettled(ownedSystems.map(async (owned) => await owned.system.stop()));
|
|
2337
2326
|
};
|
|
2338
|
-
}, [localEndpoint, signerAccount, signerFactory, signerTransport, transport]);
|
|
2327
|
+
}, [localEndpoint, signerAccount, signerFactory, signerProviderId, signerTransport, transport]);
|
|
2339
2328
|
const value = useMemo6(() => {
|
|
2340
2329
|
const value2 = {
|
|
2341
2330
|
clearAll,
|