@parity/truapi-provider 0.1.1-dev-20260731.0 → 0.1.1-dev-20260806.0

package/README.md

@@ -9,8 +9,8 @@ crate natively over UniFFI, so network access works the same everywhere.
 You connect to a network by its genesis hash, and everything else is handled for
 you: the bundled catalog provides the spec and relay wiring, so clients never
 ship or refresh specs of their own. One light client is shared across all
-connections, and its synced state is saved between runs, so the next launch
-resumes where it left off instead of syncing from scratch.
+connections. Its synced state can be captured and restored, so a launch resumes
+from finalized state instead of syncing from scratch.
 
 ## Usage
 
@@ -29,14 +29,28 @@ import wasmUrl from "@parity/truapi-provider/truapi_provider_bg.wasm?url";
 
 await init({ module_or_path: wasmUrl });
 
-const provider = new ChainProviderBuilder().build();
-const connection = await provider.connect("0x77af…"); // genesis hash
+const genesis = "0x77af…";
+const builder = new ChainProviderBuilder();
+
+// Resume from the state saved by the previous run, when there is one.
+const saved = localStorage.getItem(`chain-db:${genesis}`);
+if (saved) builder.setDatabase(genesis, saved);
+
+const provider = builder.build();
+const connection = await provider.connect(genesis);
 
 connection.send('{"jsonrpc":"2.0","id":1,"method":"chainSpec_v1_genesisHash","params":[]}');
 const response = await connection.nextResponse(); // undefined once closed
 connection.close();
+
+// Later, once the light client has synced, save state for the next launch.
+localStorage.setItem(`chain-db:${genesis}`, await provider.snapshot(genesis));
 ```
 
+Warm start is yours to drive: call `snapshot()` once the light client has synced,
+persist the string wherever you like, and hand it back through `setDatabase()`
+before `build()` on the next launch.
+
 #### Android (Kotlin)
 
 Native targets deliver responses to a listener instead of a pull loop, and take

package/dist/truapi_provider.d.ts

@@ -144,12 +144,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_12915: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_12917: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_3697: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_3697_2: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_3697_3: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7073: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_12921: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_12923: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3701: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3701_2: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3701_3: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7079: (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

@@ -472,7 +472,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_12917(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_12923(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -590,27 +590,27 @@ function __wbg_get_imports() {
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 979, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_12915);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_12921);
             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_3697);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3701);
             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_3697_2);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3701_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_3697_3);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3701_3);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 672, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_7073);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_7079);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
@@ -637,26 +637,26 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_7073(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_7073(arg0, arg1);
+function __wasm_bindgen_func_elem_7079(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_7079(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_3697(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3697(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3701(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3701(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3697_2(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3697_2(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3701_2(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3701_2(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3697_3(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3697_3(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3701_3(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3701_3(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_12915(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_12921(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_12915(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_12921(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -667,8 +667,8 @@ function __wasm_bindgen_func_elem_12915(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_12917(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_12917(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_12923(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_12923(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 

package/dist/truapi_provider_bg.wasm.d.ts

@@ -21,12 +21,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_12915: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_12917: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_3697: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_3697_2: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_3697_3: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_7073: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_12921: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_12923: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3701: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3701_2: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3701_3: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_7079: (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.1.1-dev-20260731.0",
+  "version": "0.1.1-dev-20260806.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>",