walletkit-web 0.21.3

package/README.md

@@ -0,0 +1,28 @@
+# `@worldcoin/walletkit-web`
+
+Browser WebAssembly bindings for WalletKit.
+
+> PROTOTYPE: this package is private while its generation and publication
+> workflow is being validated.
+
+The package owns the compiled WalletKit module, generated TypeScript bindings,
+UniFFI player setup, and WASM asset resolution. Browser applications initialize
+it through one interface:
+
+```ts
+const { initializeWalletKit } = await import("@worldcoin/walletkit-web");
+const walletKit = await initializeWalletKit();
+```
+
+Build it from the repository root with the pinned toolchain:
+
+```sh
+nix develop .#wasm --command npm --prefix web/walletkit install
+nix develop .#wasm --command npm --prefix web/walletkit run build
+```
+
+The release build uses `crates/walletkit` directly, disables its default
+features except for `embed-zkeys`, and optimizes the generated module with
+`wasm-opt -Oz --converge`. Embedding the proving artifacts currently makes the
+optimized WASM roughly 40 MB; lazy artifact delivery and worker placement are
+still future production work.

package/dist/generated/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./walletkit";
+export * from "./walletkit_core";
+import * as walletkit from "./walletkit";
+import * as walletkit_core from "./walletkit_core";
+import { type WasmSource } from "@ubjs/wasm";
+export declare function uniffiInitAsync(source: WasmSource): Promise<void>;
+declare const _default: {
+    walletkit: typeof walletkit;
+    walletkit_core: typeof walletkit_core;
+};
+export default _default;

package/dist/generated/walletkit-ffi.d.ts

@@ -0,0 +1,607 @@
+import { type UniffiRustCallStatus } from "@ubjs/core";
+interface NativeModuleInterface {
+    ffi_walletkit_rust_future_poll_u8(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_u8(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_u8(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_u8(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_i8(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_i8(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_i8(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_i8(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_u16(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_u16(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_u16(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_u16(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_i16(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_i16(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_i16(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_i16(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_u32(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_u32(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_u32(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_u32(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_i32(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_i32(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_i32(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_i32(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_u64(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_u64(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_u64(handle: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
+    ffi_walletkit_rust_future_free_u64(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_i64(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_i64(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_i64(handle: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
+    ffi_walletkit_rust_future_free_i64(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_f32(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_f32(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_f32(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_f32(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_f64(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_f64(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_f64(handle: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    ffi_walletkit_rust_future_free_f64(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_rust_buffer(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_rust_buffer(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_rust_buffer(handle: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    ffi_walletkit_rust_future_free_rust_buffer(handle: bigint): void;
+    ffi_walletkit_rust_future_poll_void(handle: bigint, callback: UniffiRustFutureContinuationCallback, callbackData: bigint): void;
+    ffi_walletkit_rust_future_cancel_void(handle: bigint): void;
+    ffi_walletkit_rust_future_complete_void(handle: bigint, uniffi_out_err: UniffiRustCallStatus): void;
+    ffi_walletkit_rust_future_free_void(handle: bigint): void;
+    ffi_walletkit_uniffi_contract_version(): number;
+    rustbuffer_alloc(n: number): Uint8Array;
+    rustbuffer_free(view: Uint8Array): void;
+}
+declare const getter: () => NativeModuleInterface;
+export declare const PLAYER_DEFINITIONS: {
+    readonly symbols: {
+        readonly rustbuffer_alloc: "ffi_walletkit_rustbuffer_alloc";
+        readonly rustbuffer_free: "ffi_walletkit_rustbuffer_free";
+        readonly rustbuffer_from_bytes: "ffi_walletkit_rustbuffer_from_bytes";
+    };
+    readonly functions: {
+        readonly ffi_walletkit_rust_future_poll_u8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_u8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_u8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "UInt8";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_u8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_i8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_i8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_i8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Int8";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_i8: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_u16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_u16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_u16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "UInt16";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_u16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_i16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_i16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_i16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Int16";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_i16: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_u32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_u32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_u32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "UInt32";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_u32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_i32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_i32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_i32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Int32";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_i32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_u64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_u64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_u64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Handle";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_u64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_i64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_i64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_i64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Int64";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_i64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_f32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_f32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_f32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Float32";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_f32: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_f64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_f64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_f64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Float64";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_f64: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_rust_buffer: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_rust_buffer: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_rust_buffer: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "RustBuffer";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_rust_buffer: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_poll_void: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Callback";
+                readonly name: string;
+            }, {
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_cancel_void: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_rust_future_complete_void: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: true;
+        };
+        readonly ffi_walletkit_rust_future_free_void: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ffi_walletkit_uniffi_contract_version: {
+            readonly args: readonly [];
+            readonly ret: {
+                readonly tag: "UInt32";
+            };
+            readonly hasRustCallStatus: false;
+        };
+    };
+    readonly callbacks: {
+        readonly RustFutureContinuationCallback: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }, {
+                readonly tag: "Int8";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+        readonly ForeignFutureDroppedCallback: {
+            readonly args: readonly [{
+                readonly tag: "Handle";
+            }];
+            readonly ret: {
+                readonly tag: "Void";
+            };
+            readonly hasRustCallStatus: false;
+        };
+    };
+    readonly structs: {
+        readonly ForeignFutureDroppedCallbackStruct: readonly [{
+            readonly name: "handle";
+            readonly type: {
+                readonly tag: "Handle";
+            };
+        }, {
+            readonly name: "free";
+            readonly type: {
+                readonly tag: "Callback";
+                readonly name: string;
+            };
+        }];
+    };
+};
+export declare function setNativeModule(m: Record<string, (...args: any[]) => any>): void;
+export default getter;
+export type UniffiRustFutureContinuationCallback = (data: bigint, pollResult: number) => void;
+export type UniffiForeignFutureDroppedCallback = (handle: bigint) => void;
+export type UniffiForeignFutureDroppedCallbackStruct = {
+    handle: bigint;
+    free: UniffiForeignFutureDroppedCallback;
+};

package/dist/generated/walletkit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This should be called before anything else.
+ *
+ * It is likely that this is being done for you by the library's `index.ts`.
+ *
+ * It checks versions of uniffi between when the Rust scaffolding was generated
+ * and when the bindings were generated.
+ *
+ * It also initializes the machinery to enable Rust to talk back to Javascript.
+ */
+declare function uniffiEnsureInitialized(): void;
+declare const _default: Readonly<{
+    initialize: typeof uniffiEnsureInitialized;
+}>;
+export default _default;