@lat-murmeldjur/weeb_3 0.0.317001 → 0.0.320001

package/README.md

@@ -33,6 +33,7 @@ The `wasm-pack` build prepares the generated `static/package.json` for publishin
 - `static/snippets/web3-0742d85b024bb6f5/inline0.js`
 - `static/weeb_3.js`
 - `static/weeb_3_bg.wasm`
+- `static/weeb_3.d.ts`
 
 After publishing, the package can be used with the same API shape as the examples in `static/example.html` and `static/issue-1-json-sync-example.html`:
 
@@ -43,18 +44,34 @@ await init();
 
 const weeb3node = new Weeb3No103();
 
-// Use the built-in network profile and bootnodes.
-await weeb3node.connect();
+// Use the built-in mainnet profile and browser-dialable bootnodes.
+weeb3node.start();
+console.log(await weeb3node.networkState());
+
+// Switch explicitly between the built-in profiles.
+await weeb3node.switchTestnet();
+await weeb3node.switchMainnet();
+
+// The generic form accepts "mainnet", "gnosis", or "1", and
+// "testnet", "sepolia", or "10".
+await weeb3node.switchNetwork("testnet");
+await weeb3node.switchNetwork("mainnet");
 
 // Or start with explicit browser-dialable bootnodes.
-weeb3node.start([
-  new BootstrapNode("/ip4/example/tcp/443/wss/p2p/examplePeerId", true),
-], "10");
+weeb3node.start({
+  networkId: "1",
+  bootstrapNodes: [
+    new BootstrapNode("/ip4/example/tcp/443/wss/p2p/examplePeerId", true),
+  ],
+});
+
+// Or start with the built-in testnet profile.
+weeb3node.start({ testnet: true });
 
 const ready = await weeb3node.ready(1, 20_000);
 ```
 
-The wrapper exposes the browser node as `Weeb3No103`. It can start the runtime, connect to network profiles, render the bundled interface into a container, report network and progress state, retrieve BZZ resources, retrieve raw bytes or chunks, upload `File` objects or byte arrays, publish and read feed updates, and expose feed identity helpers.
+The wrapper exposes the browser node as `Weeb3No103`. It can start the runtime, connect to network profiles, switch between mainnet and testnet with `switchMainnet()` / `switchTestnet()` or `switchNetwork(mode)`, render the bundled interface into a container, report network and progress state, retrieve BZZ resources, retrieve raw bytes or chunks, upload `File` objects or byte arrays, publish and read feed updates, and expose feed identity helpers.
 
 The publishing workflow defaults to the GitHub repository owner scope. If a different npm scope is needed, set the `NPM_SCOPE` repository variable in GitHub Actions before pushing to `main`.
 
@@ -176,6 +193,7 @@ The main runtime depends on several focused modules:
 - `src/secure_vault.rs` manages sensitive local state such as upload identities, postage-stamp state, feed ownership, and cheque signer material.
 - `src/network_profile.rs` defines the built-in testnet and mainnet profiles, wallet chain ids, token symbols, and bootnodes.
 - `src/on_chain.rs` implements browser wallet and contract interactions for postage batches, price oracle access, chequebook operations, swap token operations, and related state.
+- Batch state held by `weeb-3-secure` is requested with the active Swarm network id, so testnet and mainnet use separate batch owners, batch ids, bucket counters, and temp-auth authorization.
 - `src/interface_conventions.rs` and `src/interface_runtime_conventions.rs` contain DOM helpers, UI rendering, route parsing, network controls, and Service Worker runtime integration.
 - `src/library.rs` exposes the Wasm runtime to JavaScript as `Weeb3No103` and `BootstrapNode`.
 - `src/conventions.rs` and `src/interface_conventions.rs` collect common encoding, decoding, hashing, resource, UI, and protocol helper logic.
@@ -202,7 +220,8 @@ Single files can still be displayed without a Service Worker by creating `Blob`
 
 The Service Worker solves this by providing deterministic application-scoped routes:
 
-- `GET` and `HEAD` requests below `/bzz/<reference>/<path>` are interpreted as canonical BZZ resource requests.
+- `GET` and `HEAD` requests below `/bzz/<reference>/<path>` are interpreted as canonical mainnet BZZ resource requests.
+- Testnet can be selected from routes with `/testnet`, for example `/weeb-3/testnet` to boot the interface in testnet mode or `/weeb-3/testnet/bzz/<reference>/<path>` for a testnet BZZ link.
 - Raw byte and chunk routes below `/bytes/`, `/chunks/`, and `/chunk/` are forwarded to the Rust runtime.
 - `POST` requests to the scoped `/bzz` endpoint are forwarded as upload requests, including upload headers such as encryption, collection, and index-document hints.
 - Fetch requests are forwarded to the active controlled client through `postMessage` and `MessageChannel`.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@lat-murmeldjur/weeb_3",
   "type": "module",
   "description": "A Swarm client for browsers",
-  "version": "0.0.317001",
+  "version": "0.0.320001",
   "license": "MIT",
   "repository": {
     "type": "git",

package/weeb_3.d.ts

@@ -69,6 +69,8 @@ export class Weeb3No103 {
     networkState(): Promise<object>;
     network_state(): Promise<object>;
     constructor();
+    openSecureVault(): object;
+    open_secure_vault(): object;
     postFeedBytes(topic: string, bytes: Uint8Array, mime: string, filename: string, encryption: boolean): Promise<object>;
     postPushChunk(data: Uint8Array, soc: boolean, chunk_address: Uint8Array, stamp: Uint8Array): Promise<string>;
     postUploadBytes(bytes: Uint8Array, mime: string, filename: string, encryption: boolean, add_to_feed: boolean, feed_topic: string): Promise<object>;
@@ -90,9 +92,13 @@ export class Weeb3No103 {
     retrieveChunk(address: string): Promise<Uint8Array>;
     retrieve_bytes(address: string): Promise<Uint8Array>;
     retrieve_chunk(address: string): Promise<Uint8Array>;
-    start(bootstrap_nodes: BootstrapNode[], network_id: string): void;
+    start(options?: any | null): void;
+    switchMainnet(): Promise<object>;
     switchNetwork(mode: string): Promise<object>;
+    switchTestnet(): Promise<object>;
+    switch_mainnet(): Promise<object>;
     switch_network(mode: string): Promise<object>;
+    switch_testnet(): Promise<object>;
     upload(file: File, encryption: boolean, index_string: string, add_to_feed: boolean, feed_topic: string): Promise<object>;
     uploadPrerequisites(depth: number, validity_days: number): Promise<object>;
     upload_prerequisites(depth: number, validity_days: number): Promise<object>;
@@ -104,12 +110,35 @@ export class Wings {
     [Symbol.dispose](): void;
 }
 
+export function init_wasm_runtime(): void;
+
 export function interweeb(_st: string): Promise<void>;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_weeb3_free: (a: number, b: number) => void;
+    readonly __wbg_wings_free: (a: number, b: number) => void;
+    readonly weeb3_acquire: (a: number, b: number, c: number) => any;
+    readonly weeb3_acquire_feed: (a: number, b: number, c: number, d: number, e: number) => any;
+    readonly weeb3_change_bootnode_address: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+    readonly weeb3_get_connections: (a: number) => any;
+    readonly weeb3_get_current_logs: (a: number) => any;
+    readonly weeb3_get_network_id: (a: number) => any;
+    readonly weeb3_get_ongoing_connections: (a: number) => any;
+    readonly weeb3_interface_log: (a: number, b: number, c: number) => void;
+    readonly weeb3_new: (a: number, b: number) => number;
+    readonly weeb3_post_push_chunk: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
+    readonly weeb3_post_upload: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
+    readonly weeb3_reset_stamp: (a: number) => any;
+    readonly weeb3_retrieve_bytes: (a: number, b: number, c: number) => any;
+    readonly weeb3_retrieve_chunk_bytes: (a: number, b: number, c: number) => any;
+    readonly weeb3_run: (a: number, b: number, c: number) => any;
+    readonly weeb3_set_network_id: (a: number, b: number, c: number) => any;
+    readonly weeb3_toggle_transfer_pause: (a: number) => any;
+    readonly weeb3_transfer_paused: (a: number) => number;
+    readonly init_wasm_runtime: () => void;
     readonly interweeb: (a: number, b: number) => any;
     readonly __wbg_bootstrapnode_free: (a: number, b: number) => void;
     readonly __wbg_weeb3no103_free: (a: number, b: number) => void;
@@ -140,6 +169,7 @@ export interface InitOutput {
     readonly weeb3no103_networkState: (a: number) => any;
     readonly weeb3no103_network_state: (a: number) => any;
     readonly weeb3no103_new: () => number;
+    readonly weeb3no103_openSecureVault: (a: number) => any;
     readonly weeb3no103_postFeedBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => any;
     readonly weeb3no103_postPushChunk: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
     readonly weeb3no103_postUploadBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => any;
@@ -153,6 +183,7 @@ export interface InitOutput {
     readonly weeb3no103_readyState: (a: number, b: number, c: number) => any;
     readonly weeb3no103_ready_state: (a: number, b: number, c: number) => any;
     readonly weeb3no103_renderInterface: (a: number, b: any) => any;
+    readonly weeb3no103_render_interface: (a: number, b: any) => any;
     readonly weeb3no103_resetStamp: (a: number) => any;
     readonly weeb3no103_reset_stamp: (a: number) => any;
     readonly weeb3no103_retrieve: (a: number, b: number, c: number) => any;
@@ -160,56 +191,40 @@ export interface InitOutput {
     readonly weeb3no103_retrieveChunk: (a: number, b: number, c: number) => any;
     readonly weeb3no103_retrieve_bytes: (a: number, b: number, c: number) => any;
     readonly weeb3no103_retrieve_chunk: (a: number, b: number, c: number) => any;
-    readonly weeb3no103_start: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly weeb3no103_start: (a: number, b: number) => void;
+    readonly weeb3no103_switchMainnet: (a: number) => any;
     readonly weeb3no103_switchNetwork: (a: number, b: number, c: number) => any;
+    readonly weeb3no103_switchTestnet: (a: number) => any;
+    readonly weeb3no103_switch_mainnet: (a: number) => any;
     readonly weeb3no103_switch_network: (a: number, b: number, c: number) => any;
+    readonly weeb3no103_switch_testnet: (a: number) => any;
     readonly weeb3no103_upload: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
     readonly weeb3no103_uploadPrerequisites: (a: number, b: number, c: number) => any;
     readonly weeb3no103_upload_prerequisites: (a: number, b: number, c: number) => any;
+    readonly weeb3no103_open_secure_vault: (a: number) => any;
     readonly weeb3no103_feed_topic: (a: number, b: number, c: number) => any;
-    readonly weeb3no103_render_interface: (a: number, b: any) => any;
-    readonly __wbg_weeb3_free: (a: number, b: number) => void;
-    readonly __wbg_wings_free: (a: number, b: number) => void;
-    readonly weeb3_acquire: (a: number, b: number, c: number) => any;
-    readonly weeb3_acquire_feed: (a: number, b: number, c: number, d: number, e: number) => any;
-    readonly weeb3_change_bootnode_address: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
-    readonly weeb3_get_connections: (a: number) => any;
-    readonly weeb3_get_current_logs: (a: number) => any;
-    readonly weeb3_get_network_id: (a: number) => any;
-    readonly weeb3_get_ongoing_connections: (a: number) => any;
-    readonly weeb3_interface_log: (a: number, b: number, c: number) => void;
-    readonly weeb3_new: (a: number, b: number) => number;
-    readonly weeb3_post_push_chunk: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
-    readonly weeb3_post_upload: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
-    readonly weeb3_reset_stamp: (a: number) => any;
-    readonly weeb3_retrieve_bytes: (a: number, b: number, c: number) => any;
-    readonly weeb3_retrieve_chunk_bytes: (a: number, b: number, c: number) => any;
-    readonly weeb3_run: (a: number, b: number, c: number) => any;
-    readonly weeb3_set_network_id: (a: number, b: number, c: number) => any;
-    readonly weeb3_toggle_transfer_pause: (a: number) => any;
-    readonly weeb3_transfer_paused: (a: number) => number;
     readonly __wbg_requestarguments_free: (a: number, b: number) => void;
     readonly requestarguments_method: (a: number) => [number, number];
     readonly requestarguments_params: (a: number) => any;
-    readonly wasm_bindgen__convert__closures_____invoke__h39453673aeb618ab: (a: number, b: number, c: any) => [number, number];
-    readonly wasm_bindgen__convert__closures_____invoke__h2d6c650cac09b0b2: (a: number, b: number, c: any) => [number, number];
-    readonly wasm_bindgen__convert__closures_____invoke__h38bb2d7626f4cfa1: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h6a22690fdc0e9d3a: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h82048516b933eb0e: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h7595764d8075eff9: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h82048516b933eb0e_4: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h82048516b933eb0e_6: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h096c301d37cdbb45: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h6f4ab657709ae694: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hbc64d0ffa7547e63: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hc61cf82ed5539fc0: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__ha3ccbd176587943b: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h23d607816848205c: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h2ba9a57baa99e61c: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h06a9db7efe4e0c03: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hce4d7bcafefc2486: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h06a9db7efe4e0c03_4: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h06a9db7efe4e0c03_6: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h376be826f7c7dcad: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hce415dd57ff2f6ce: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h6da4d6df0f6bffeb: (a: number, b: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
     readonly __externref_drop_slice: (a: number, b: number) => void;
-    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }