@lat-murmeldjur/weeb_3 0.0.317001 → 0.0.319002

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,28 @@ await init();
 
 const weeb3node = new Weeb3No103();
 
-// Use the built-in network profile and bootnodes.
+// Use the built-in mainnet profile and browser-dialable bootnodes.
 await weeb3node.connect();
+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");
+], "1");
 
 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 +187,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 +214,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.319002",
   "license": "MIT",
   "repository": {
     "type": "git",

package/weeb_3.d.ts

@@ -91,8 +91,12 @@ export class Weeb3No103 {
     retrieve_bytes(address: string): Promise<Uint8Array>;
     retrieve_chunk(address: string): Promise<Uint8Array>;
     start(bootstrap_nodes: BootstrapNode[], network_id: string): 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>;
@@ -110,7 +114,6 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    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;
     readonly bootstrapnode_multiaddr: (a: number) => [number, number];
@@ -153,6 +156,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;
@@ -161,13 +165,17 @@ export interface InitOutput {
     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_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_feed_topic: (a: number, b: number, c: number) => any;
-    readonly weeb3no103_render_interface: (a: number, b: any) => any;
+    readonly interweeb: (a: number, b: number) => 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;
@@ -191,17 +199,17 @@ export interface InitOutput {
     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__hd044c415605327d3: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__he561fc60712dccf3: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h9288ef3fe9915859: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h32ae8b24e9ba2070: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h0a32fbc1945885b3: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h11c7dfb27aa38104: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h0a32fbc1945885b3_4: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h0a32fbc1945885b3_6: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h8fe36b0e7e1e898d: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h44a7023f2fe3c61c: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hb6b3ef33145d000c: (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;