@zerc20/wallet-sdk 0.2.0 → 0.4.0

package/wasm/zerc20_wallet_core.d.ts

@@ -7,18 +7,27 @@
  */
 export function aspLeaves(bitmap: Uint8Array, first: bigint, count: number): Uint8Array;
 
+export function burnAddressOf(chain_id: bigint, public_key: string, salt: string): string | undefined;
+
 /**
- * A seed's `index`-th burn address for one chain and token, with its salt: `{salt, address}`. About 2^16 hashes.
+ * The `index`-th burn address of `public_key` on one chain and token from `burn_key`, and its salt, if the salt's
+ * counter is in `from..=to`: `{salt, address}` or `undefined`. Searched in blocks of counters from 0, the result is
+ * the first block's hit.
  */
-export function burnAddress(seed: Uint8Array, chain_id: bigint, token_id: number, index: number): any;
+export function burnBlock(burn_key: Uint8Array, chain_id: bigint, token_id: number, index: number, public_key: string, from: number, to: number): any;
 
-export function burnAddressOf(chain_id: bigint, public_key: string, salt: string): string | undefined;
+/**
+ * A burn address of someone else's `public_key` on a chain, with its salt: the first of the `count` salts from
+ * `start` that has the proof of work, `{salt, address}`, or `undefined`. A random `start` makes the salt
+ * unguessable.
+ */
+export function burnBlockFor(chain_id: bigint, public_key: string, start: string, count: number): any;
 
 /**
  * The key that owns the notes paid to a seed's `index`-th receive code for one chain and token, shaped like
  * `spendKey`.
  */
-export function codeKey(seed: Uint8Array, chain_id: bigint, token_id: number, index: number): any;
+export function codeSpendKey(seed: Uint8Array, chain_id: bigint, token_id: number, index: number): any;
 
 /**
  * `CommitmentLedger`'s hash chain after appending a commitment with `fields` to `prev`.
@@ -65,10 +74,10 @@ export function path(i: bigint, n: bigint, chunk_leaves: Uint8Array, page_chunks
 export function pathRoot(leaf: string, i: bigint, siblings: string[]): string;
 
 /**
- * The `k`-th burn address a point of sale holding `lane_key` makes for `public_key` on one chain and token, with its
- * salt: `{salt, address}`. About 2^16 hashes.
+ * The public key a signing key's hash and a nullifying key make: how a view key's holder checks that the nullifying
+ * key it was given is the one the account's notes commit to.
  */
-export function posBurnAddress(lane_key: Uint8Array, chain_id: bigint, token_id: number, k: number, public_key: string): any;
+export function publicKey(auth_key_hash: string, nullifying_key: string): string;
 
 /**
  * Seals a merge witness (JSON) to the merge prover's key, padded with spaces to `pad_to` bytes. Take the key from
@@ -123,9 +132,10 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly aspLeaves: (a: number, b: number, c: bigint, d: number) => [number, number, number, number];
-    readonly burnAddress: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
     readonly burnAddressOf: (a: bigint, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly codeKey: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
+    readonly burnBlock: (a: number, b: number, c: bigint, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
+    readonly burnBlockFor: (a: bigint, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly codeSpendKey: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
     readonly hashChain: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly leaf: (a: number, b: number) => [number, number, number, number];
     readonly leaves: (a: number, b: number) => [number, number, number, number];
@@ -134,7 +144,7 @@ export interface InitOutput {
     readonly nullifier: (a: bigint, b: bigint, c: number, d: number) => [number, number, number, number];
     readonly path: (a: bigint, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number, number, number];
     readonly pathRoot: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number, number];
-    readonly posBurnAddress: (a: number, b: number, c: bigint, d: number, e: number, f: number, g: number) => [number, number, number];
+    readonly publicKey: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly sealMergeWitness: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly sealWitness: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly signMerge: (a: number, b: number, c: number, d: number) => [number, number, number, number];

package/wasm/zerc20_wallet_core.js

@@ -20,24 +20,6 @@ export function aspLeaves(bitmap, first, count) {
     return v2;
 }
 
-/**
- * A seed's `index`-th burn address for one chain and token, with its salt: `{salt, address}`. About 2^16 hashes.
- * @param {Uint8Array} seed
- * @param {bigint} chain_id
- * @param {number} token_id
- * @param {number} index
- * @returns {any}
- */
-export function burnAddress(seed, chain_id, token_id, index) {
-    const ptr0 = passArray8ToWasm0(seed, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.burnAddress(ptr0, len0, chain_id, token_id, index);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return takeFromExternrefTable0(ret[0]);
-}
-
 /**
  * @param {bigint} chain_id
  * @param {string} public_key
@@ -61,6 +43,53 @@ export function burnAddressOf(chain_id, public_key, salt) {
     return v3;
 }
 
+/**
+ * The `index`-th burn address of `public_key` on one chain and token from `burn_key`, and its salt, if the salt's
+ * counter is in `from..=to`: `{salt, address}` or `undefined`. Searched in blocks of counters from 0, the result is
+ * the first block's hit.
+ * @param {Uint8Array} burn_key
+ * @param {bigint} chain_id
+ * @param {number} token_id
+ * @param {number} index
+ * @param {string} public_key
+ * @param {number} from
+ * @param {number} to
+ * @returns {any}
+ */
+export function burnBlock(burn_key, chain_id, token_id, index, public_key, from, to) {
+    const ptr0 = passArray8ToWasm0(burn_key, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(public_key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.burnBlock(ptr0, len0, chain_id, token_id, index, ptr1, len1, from, to);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * A burn address of someone else's `public_key` on a chain, with its salt: the first of the `count` salts from
+ * `start` that has the proof of work, `{salt, address}`, or `undefined`. A random `start` makes the salt
+ * unguessable.
+ * @param {bigint} chain_id
+ * @param {string} public_key
+ * @param {string} start
+ * @param {number} count
+ * @returns {any}
+ */
+export function burnBlockFor(chain_id, public_key, start, count) {
+    const ptr0 = passStringToWasm0(public_key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(start, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.burnBlockFor(chain_id, ptr0, len0, ptr1, len1, count);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * The key that owns the notes paid to a seed's `index`-th receive code for one chain and token, shaped like
  * `spendKey`.
@@ -70,10 +99,10 @@ export function burnAddressOf(chain_id, public_key, salt) {
  * @param {number} index
  * @returns {any}
  */
-export function codeKey(seed, chain_id, token_id, index) {
+export function codeSpendKey(seed, chain_id, token_id, index) {
     const ptr0 = passArray8ToWasm0(seed, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.codeKey(ptr0, len0, chain_id, token_id, index);
+    const ret = wasm.codeSpendKey(ptr0, len0, chain_id, token_id, index);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -296,25 +325,33 @@ export function pathRoot(leaf, i, siblings) {
 }
 
 /**
- * The `k`-th burn address a point of sale holding `lane_key` makes for `public_key` on one chain and token, with its
- * salt: `{salt, address}`. About 2^16 hashes.
- * @param {Uint8Array} lane_key
- * @param {bigint} chain_id
- * @param {number} token_id
- * @param {number} k
- * @param {string} public_key
- * @returns {any}
+ * The public key a signing key's hash and a nullifying key make: how a view key's holder checks that the nullifying
+ * key it was given is the one the account's notes commit to.
+ * @param {string} auth_key_hash
+ * @param {string} nullifying_key
+ * @returns {string}
  */
-export function posBurnAddress(lane_key, chain_id, token_id, k, public_key) {
-    const ptr0 = passArray8ToWasm0(lane_key, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(public_key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.posBurnAddress(ptr0, len0, chain_id, token_id, k, ptr1, len1);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
+export function publicKey(auth_key_hash, nullifying_key) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(auth_key_hash, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(nullifying_key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.publicKey(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
     }
-    return takeFromExternrefTable0(ret[0]);
 }
 
 /**

package/wasm/zerc20_wallet_core_bg.wasm.d.ts

@@ -2,9 +2,10 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const aspLeaves: (a: number, b: number, c: bigint, d: number) => [number, number, number, number];
-export const burnAddress: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
 export const burnAddressOf: (a: bigint, b: number, c: number, d: number, e: number) => [number, number, number, number];
-export const codeKey: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
+export const burnBlock: (a: number, b: number, c: bigint, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
+export const burnBlockFor: (a: bigint, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+export const codeSpendKey: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number];
 export const hashChain: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const leaf: (a: number, b: number) => [number, number, number, number];
 export const leaves: (a: number, b: number) => [number, number, number, number];
@@ -13,7 +14,7 @@ export const noteTag: (a: number, b: number, c: number) => [number, number, numb
 export const nullifier: (a: bigint, b: bigint, c: number, d: number) => [number, number, number, number];
 export const path: (a: bigint, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number, number, number];
 export const pathRoot: (a: number, b: number, c: bigint, d: number, e: number) => [number, number, number, number];
-export const posBurnAddress: (a: number, b: number, c: bigint, d: number, e: number, f: number, g: number) => [number, number, number];
+export const publicKey: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const sealMergeWitness: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const sealWitness: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const signMerge: (a: number, b: number, c: number, d: number) => [number, number, number, number];