@parity/truapi-provider 0.3.2 → 0.4.1-dev-20261110.0

package/README.md

@@ -12,7 +12,10 @@ connections, and its synced state is kept between launches, so a launch resumes
 from finalized state instead of syncing from scratch. It holds at most 32 of them
 at once and rejects a `connect` past that, so a client that leaks connections
 fails instead of growing; closing one hands its slot back. Connections to a
-remote node you registered with `addRpcChain` are not counted against it.
+remote node you registered with `addRpcChain` are not counted against it. A
+provider with an `addRpcChain` registration connects only to chains registered
+on it. The catalog does not resolve any other genesis hash for it, so a host on
+remote nodes never starts the light client by accident.
 
 ## Usage
 

package/dist/truapi_provider.d.ts

@@ -27,6 +27,9 @@ export interface ConnectionTypes {
 
 /**
  * Collects genesis-hash to chain-source registrations from JS.
+ *
+ * The built provider resolves an unregistered genesis from the bundled catalog,
+ * unless a remote node was registered with `addRpcChain`.
  */
 export class ChainProviderBuilder {
     free(): void;
@@ -47,7 +50,8 @@ export class ChainProviderBuilder {
     /**
      * Register a remote JSON-RPC node for the chain identified by the
      * `0x`-prefixed genesis hash. A later registration for the same hash
-     * replaces the earlier one.
+     * replaces the earlier one, and the built provider no longer resolves
+     * other genesis hashes from the catalog.
      */
     addRpcChain(genesis_hash: string, url: string): void;
     /**
@@ -125,7 +129,8 @@ export class ChainProviderHandle {
      * chain resumes from it. Resolves with whether a blob is now in hand.
      *
      * Call this before connecting. The store is read at most once per chain,
-     * because only the first add of a chain consumes a blob.
+     * because only the first add of a chain consumes a blob. Rejects for a
+     * chain this provider cannot connect to, as `connect` does.
      */
     loadDatabase(genesis_hash: string): Promise<boolean>;
     /**
@@ -255,12 +260,12 @@ export interface InitOutput {
     readonly networkchains_people: (a: number, b: number) => void;
     readonly networkchains_relay: (a: number, b: number) => void;
     readonly setLogLevel: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_20795: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_20797: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_3944: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_3944_2: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_3944_3: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7520: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_20786: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_20788: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3932: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3932_2: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3932_3: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7511: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/dist/truapi_provider.js

@@ -2,6 +2,9 @@
 
 /**
  * Collects genesis-hash to chain-source registrations from JS.
+ *
+ * The built provider resolves an unregistered genesis from the bundled catalog,
+ * unless a remote node was registered with `addRpcChain`.
  */
 export class ChainProviderBuilder {
     __destroy_into_raw() {
@@ -66,7 +69,8 @@ export class ChainProviderBuilder {
     /**
      * Register a remote JSON-RPC node for the chain identified by the
      * `0x`-prefixed genesis hash. A later registration for the same hash
-     * replaces the earlier one.
+     * replaces the earlier one, and the built provider no longer resolves
+     * other genesis hashes from the catalog.
      * @param {string} genesis_hash
      * @param {string} url
      */
@@ -265,7 +269,8 @@ export class ChainProviderHandle {
      * chain resumes from it. Resolves with whether a blob is now in hand.
      *
      * Call this before connecting. The store is read at most once per chain,
-     * because only the first add of a chain consumes a blob.
+     * because only the first add of a chain consumes a blob. Rejects for a
+     * chain this provider cannot connect to, as `connect` does.
      * @param {string} genesis_hash
      * @returns {Promise<boolean>}
      */
@@ -670,7 +675,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_20797(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_20788(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -795,28 +800,28 @@ function __wbg_get_imports() {
             console.warn(getObject(arg0));
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1898, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_20795);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1899, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_20786);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 20, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3944);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3932);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 20, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3944_2);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3932_2);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 20, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3944_3);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3932_3);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 711, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_7520);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 712, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_7511);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
@@ -843,26 +848,26 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_7520(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_7520(arg0, arg1);
+function __wasm_bindgen_func_elem_7511(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_7511(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_3944(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3944(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3932(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3932(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3944_2(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3944_2(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3932_2(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3932_2(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3944_3(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3944_3(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3932_3(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3932_3(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_20795(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_20786(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_20795(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_20786(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -873,8 +878,8 @@ function __wasm_bindgen_func_elem_20795(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_20797(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_20797(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_20788(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_20788(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 

package/dist/truapi_provider_bg.wasm.d.ts

@@ -28,12 +28,12 @@ export const networkchains_bulletin: (a: number, b: number) => void;
 export const networkchains_people: (a: number, b: number) => void;
 export const networkchains_relay: (a: number, b: number) => void;
 export const setLogLevel: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_20795: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_20797: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_3944: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_3944_2: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_3944_3: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_7520: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_20786: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_20788: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3932: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3932_2: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3932_3: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_7511: (a: number, b: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/truapi-provider",
-  "version": "0.3.2",
+  "version": "0.4.1-dev-20261110.0",
   "description": "Network provider backends for the TrUAPI ChainProvider: an embedded smoldot light client and remote WebSocket JSON-RPC nodes, compiled to WebAssembly for browser hosts",
   "license": "MIT AND Apache-2.0",
   "author": "Parity Technologies <admin@parity.io>",