@zerc20/wallet-sdk 0.1.0 → 0.3.0

package/dist/burnWorker.js

@@ -1,10 +1,10 @@
-// Searches a burn address off the main thread: core.ts starts one per search, a Web Worker in a browser and a worker
-// thread in Node.
-import { initCore, searchHere } from './core.js';
-async function answer(s) {
+// Runs blocks of burn address searches off the main thread, one at a time: core.ts keeps a pool of these, Web Workers
+// in a browser and worker threads in Node.
+import { initCore, runBlock } from './core.js';
+async function answer(b) {
     try {
         await initCore();
-        return { burn: searchHere(s) };
+        return { burn: runBlock(b) };
     }
     catch (e) {
         return { error: e instanceof Error ? e.message : String(e) };
@@ -16,6 +16,6 @@ if (typeof self !== 'undefined') {
 else {
     // a variable, so that bundlers for the browser leave Node's module alone
     const threads = 'node:worker_threads';
-    void import(/* @vite-ignore */ threads).then(async ({ parentPort, workerData }) => parentPort.postMessage(await answer(workerData)));
+    void import(/* @vite-ignore */ threads).then(({ parentPort }) => parentPort.on('message', (b) => void answer(b).then((a) => parentPort.postMessage(a))));
 }
 //# sourceMappingURL=burnWorker.js.map

package/dist/burnWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"burnWorker.js","sourceRoot":"","sources":["../src/burnWorker.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,kBAAkB;AAElB,OAAO,EAAoC,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEnF,KAAK,UAAU,MAAM,CAAC,CAAa;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,EAAE,IAAI,EAA4B,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACjG,CAAC;KAAM,CAAC;IACN,yEAAyE;IACzE,MAAM,OAAO,GAAG,qBAAqB,CAAC;IAEtC,KAAK,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAC1C,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAgD,EAAE,EAAE,CACjF,UAAU,CAAC,WAAW,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CACnD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"burnWorker.js","sourceRoot":"","sources":["../src/burnWorker.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,2CAA2C;AAE3C,OAAO,EAAmC,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhF,KAAK,UAAU,MAAM,CAAC,CAAY;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,EAAE,IAAI,EAA2B,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAChG,CAAC;KAAM,CAAC;IACN,yEAAyE;IACzE,MAAM,OAAO,GAAG,qBAAqB,CAAC;IAEtC,KAAK,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAwB,EAAE,EAAE,CACpF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CACvF,CAAC;AACJ,CAAC"}

package/dist/chain.d.ts

@@ -288,11 +288,25 @@ export declare const depositFactoryAbi: readonly [{
     }, {
         readonly type: "uint256";
         readonly name: "fee";
+    }, {
+        readonly type: "address";
+        readonly name: "referrer";
+    }, {
+        readonly type: "uint16";
+        readonly name: "referralBps";
     }];
     readonly outputs: readonly [{
         readonly type: "address";
     }];
 }];
+/** The factory's `MAX_REFERRAL_BPS`: the most of a deposit, after the relayer's fee, that a referrer can take. */
+export declare const MAX_REFERRAL_BPS = 300;
+/** An app that hands out deposit addresses and takes `bps` of each payment to them, of what is left after the relayer's
+ * fee. `address` is paid, and also names the app on chain. */
+export interface Referrer {
+    address: Address;
+    bps: number;
+}
 export declare const depositAddressAbi: readonly [{
     readonly name: "refund";
     readonly type: "function";
@@ -327,12 +341,12 @@ export declare class Chain {
     get chainId(): bigint;
     ledger(): Promise<Address>;
     /** The deposit address the factory deploys for `token`, `burnAddress` and `refundAddress`, whose flush pays `fee`
-     * to `feeRecipient`. */
-    predictDepositAddress(token: Address, burnAddress: Hex, refundAddress: Address, feeRecipient: Address, fee: bigint): Promise<Address>;
+     * to `feeRecipient` and `referralBps` of the rest to `referrer`. */
+    predictDepositAddress(token: Address, burnAddress: Hex, refundAddress: Address, feeRecipient: Address, fee: bigint, referrer: Address, referralBps: number): Promise<Address>;
     /** The refund address of `address` if it is a deployed deposit address for `token` and `burnAddress`, whatever its
-     * refund address and fee; null if it is not one. A clone's code ends with its immutable args, `abi.encode(token,
-     * burnAddress, refundAddress, feeRecipient, fee)`; the factory's address for them confirms it, so code made to look
-     * like one does not pass. */
+     * refund address, fee and referral; null if it is not one. A clone's code ends with its immutable args,
+     * `abi.encode(token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps)`; the factory's address
+     * for them confirms it, so code made to look like one does not pass. */
     depositAddressRefund(address: Address, token: Address, burnAddress: Hex): Promise<Address | null>;
     /** Whether the ledger accepts `root` as the tree at `size` leaves. */
     provedRoot(size: number, root: Hex): Promise<boolean>;

package/dist/chain.js

@@ -35,8 +35,10 @@ export const erc20Abi = parseAbi([
     'function transfer(address to, uint256 amount) returns (bool)',
 ]);
 export const depositFactoryAbi = parseAbi([
-    'function predict(address token, address burnAddress, address refundAddress, address feeRecipient, uint256 fee) view returns (address)',
+    'function predict(address token, address burnAddress, address refundAddress, address feeRecipient, uint256 fee, address referrer, uint16 referralBps) view returns (address)',
 ]);
+/** The factory's `MAX_REFERRAL_BPS`: the most of a deposit, after the relayer's fee, that a referrer can take. */
+export const MAX_REFERRAL_BPS = 300;
 export const depositAddressAbi = parseAbi(['function refund(address asset)']);
 /** The native asset's stand-in for `underlyingAsset`. */
 export const NATIVE = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE';
@@ -65,27 +67,31 @@ export class Chain {
         return this.#ledger;
     }
     /** The deposit address the factory deploys for `token`, `burnAddress` and `refundAddress`, whose flush pays `fee`
-     * to `feeRecipient`. */
-    predictDepositAddress(token, burnAddress, refundAddress, feeRecipient, fee) {
+     * to `feeRecipient` and `referralBps` of the rest to `referrer`. */
+    predictDepositAddress(token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps) {
         return this.client.readContract({
             address: this.config.depositAddressFactory,
             abi: depositFactoryAbi,
             functionName: 'predict',
-            args: [token, burnAddress, refundAddress, feeRecipient, fee],
+            args: [token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps],
         });
     }
     /** The refund address of `address` if it is a deployed deposit address for `token` and `burnAddress`, whatever its
-     * refund address and fee; null if it is not one. A clone's code ends with its immutable args, `abi.encode(token,
-     * burnAddress, refundAddress, feeRecipient, fee)`; the factory's address for them confirms it, so code made to look
-     * like one does not pass. */
+     * refund address, fee and referral; null if it is not one. A clone's code ends with its immutable args,
+     * `abi.encode(token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps)`; the factory's address
+     * for them confirms it, so code made to look like one does not pass. */
     async depositAddressRefund(address, token, burnAddress) {
         const code = await this.client.getCode({ address });
-        if (!code || size(code) < 160)
+        if (!code || size(code) < 224)
             return null;
-        const [refundAddress, feeRecipient, fee] = decodeAbiParameters([{ type: 'address' }, { type: 'address' }, { type: 'uint256' }], slice(code, size(code) - 96));
+        // the uint16 read as a whole word, so code made to look like a clone cannot make the decoding throw
+        const [refundAddress, feeRecipient, fee, referrer, referralBps] = decodeAbiParameters([{ type: 'address' }, { type: 'address' }, { type: 'uint256' }, { type: 'address' }, { type: 'uint256' }], slice(code, size(code) - 160));
+        // predict would revert
         if (refundAddress === zeroAddress || feeRecipient === zeroAddress)
-            return null; // predict would revert
-        const expected = await this.predictDepositAddress(token, burnAddress, refundAddress, feeRecipient, fee);
+            return null;
+        if (referralBps > MAX_REFERRAL_BPS || (referrer === zeroAddress && referralBps !== 0n))
+            return null;
+        const expected = await this.predictDepositAddress(token, burnAddress, refundAddress, feeRecipient, fee, referrer, Number(referralBps));
         return expected.toLowerCase() === address.toLowerCase() ? refundAddress : null;
     }
     /** Whether the ledger accepts `root` as the tree at `size` leaves. */

package/dist/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -1,5 +1,5 @@
 import type { CanisterClient, ViewKey } from '@zerc20/storage-sdk';
-import { type Hex, type WalletClient } from 'viem';
+import { type Account, type Hex, type WalletClient } from 'viem';
 import type { Chain } from './chain.js';
 import type { ChainConfig, Network } from './network.js';
 import type { Asp, Indexer } from './servers.js';
@@ -18,11 +18,20 @@ export interface SpendKey {
     publicKey: Hex;
     nullifyingKey: Hex;
 }
+/** What a sync needs of a key: its public key and nullifying key, which find and follow what it owns but spend none of
+ * it. */
+export type Owner = Pick<SpendKey, 'publicKey' | 'nullifyingKey'>;
 export interface Ctx {
     network: Network;
-    seed: Uint8Array;
+    /** The root of every key. Opened with a function for it, held only while something needs it; otherwise always. */
+    seed: Uint8Array | null;
+    /** The owners derived while the seed was held, by key: the wallet's own (`''`) and each receive code's. */
+    owners: Map<string, Owner>;
     address: Hex;
-    walletClient: WalletClient;
+    /** The account that holds the public funds, and signs for them. */
+    account: Account;
+    /** The user's wallet, when it is what signs and sends rather than an account of the app's own (`walletOn`). */
+    walletClient: WalletClient | null;
     storage: CanisterClient;
     view: ViewKey;
     chains: ChainCtx[];
@@ -37,11 +46,21 @@ export interface CodeId {
     tokenId: number;
     index: number;
 }
+/** The seed, which the wallet holds whenever it does what needs it. */
+export declare function seedOf(ctx: Ctx): Uint8Array;
 /** The key that owns this seed's notes and deposits on every chain and token, or with `code`, the notes paid to that
- * receive code. */
+ * receive code. Its owner is kept for when the seed is not held. */
 export declare function spendKey(ctx: Ctx, code?: CodeId): SpendKey;
+/** `spendKey`'s owner: derived before, or now if the seed is held; null if neither. The wallet's own is derived as it
+ * opens. */
+export declare function owner(ctx: Ctx, code?: CodeId): Owner | null;
 export declare function chainCtx(ctx: Ctx, chainId: bigint): ChainCtx;
 export declare function chainState(ctx: Ctx, chainId: bigint): ChainState;
+/** `wc` on `chainId`, switched there first: a browser wallet is on one chain at a time. */
+export declare function switched(wc: WalletClient, chainId: bigint): Promise<WalletClient>;
+/** The client that sends the account's transactions on `chainId`: the user's wallet, switched to the chain, or the
+ * app's own account, through the chain's RPC. */
+export declare function walletOn(ctx: Ctx, chainId: bigint): Promise<WalletClient>;
 /** Waits until the wallet's own node has a transaction mined on ours too: the wallet simulates the next one there, and
  * where blocks are fast that node lags ours now and then, so the next one would show as reverting. A wallet that does
  * not answer is not waited on. */

package/dist/context.js

@@ -1,21 +1,37 @@
 // Everything an open wallet works with, shared by sync and the operations.
-import { publicActions } from 'viem';
+import { createWalletClient, http, publicActions } from 'viem';
 import { core } from './core.js';
+import { guard } from './errors.js';
 const keys = new WeakMap();
+const idOf = (code) => (code ? `${code.chainId}:${code.tokenId}:${code.index}` : '');
+/** The seed, which the wallet holds whenever it does what needs it. */
+export function seedOf(ctx) {
+    if (!ctx.seed)
+        throw new Error('the wallet does not hold its seed now');
+    return ctx.seed;
+}
 /** The key that owns this seed's notes and deposits on every chain and token, or with `code`, the notes paid to that
- * receive code. */
+ * receive code. Its owner is kept for when the seed is not held. */
 export function spendKey(ctx, code) {
-    let bySeed = keys.get(ctx.seed);
+    const seed = seedOf(ctx);
+    let bySeed = keys.get(seed);
     if (!bySeed)
-        keys.set(ctx.seed, (bySeed = new Map()));
-    const id = code ? `${code.chainId}:${code.tokenId}:${code.index}` : '';
+        keys.set(seed, (bySeed = new Map()));
+    const id = idOf(code);
     let key = bySeed.get(id);
     if (!key) {
-        key = (code ? core.codeKey(ctx.seed, code.chainId, code.tokenId, code.index) : core.spendKey(ctx.seed));
+        key = (code ? core.codeSpendKey(seed, code.chainId, code.tokenId, code.index) : core.spendKey(seed));
         bySeed.set(id, key);
     }
+    if (!ctx.owners.has(id))
+        ctx.owners.set(id, { publicKey: key.publicKey, nullifyingKey: key.nullifyingKey });
     return key;
 }
+/** `spendKey`'s owner: derived before, or now if the seed is held; null if neither. The wallet's own is derived as it
+ * opens. */
+export function owner(ctx, code) {
+    return ctx.owners.get(idOf(code)) ?? (ctx.seed ? spendKey(ctx, code) : null);
+}
 export function chainCtx(ctx, chainId) {
     const c = ctx.chains.find((c) => c.config.chainId === chainId);
     if (!c)
@@ -28,6 +44,19 @@ export function chainState(ctx, chainId) {
         ctx.state.chains.push((s = { chainId, samples: [], burnNext: {} }));
     return s;
 }
+/** `wc` on `chainId`, switched there first: a browser wallet is on one chain at a time. */
+export async function switched(wc, chainId) {
+    if ((await wc.getChainId()) !== Number(chainId))
+        await guard(wc.switchChain({ id: Number(chainId) }));
+    return wc;
+}
+/** The client that sends the account's transactions on `chainId`: the user's wallet, switched to the chain, or the
+ * app's own account, through the chain's RPC. */
+export async function walletOn(ctx, chainId) {
+    if (ctx.walletClient)
+        return switched(ctx.walletClient, chainId);
+    return createWalletClient({ account: ctx.account, transport: http(chainCtx(ctx, chainId).config.rpcUrl) });
+}
 /** Waits until the wallet's own node has a transaction mined on ours too: the wallet simulates the next one there, and
  * where blocks are fast that node lags ours now and then, so the next one would show as reverting. A wallet that does
  * not answer is not waited on. */

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAG3E,OAAO,EAA+B,aAAa,EAAE,MAAM,MAAM,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmCjC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAqC,CAAC;AAS9D;mBACmB;AACnB,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,IAAa;IAC9C,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAa,CAAC;QACpH,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,OAAe;IAChD,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,yBAAyB,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,OAAe;IAClD,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC;QAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;kCAEkC;AAClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAgB,EAAE,IAAS;IAC1D,MAAM,EAAE;SACL,MAAM,CAAC,aAAa,CAAC;SACrB,yBAAyB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC5E,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/core.d.ts

@@ -7,37 +7,52 @@ export interface Burn {
     salt: Hex;
     address: Address;
 }
-/** A seed's `index`-th burn address of a token, with its salt: about 2^16 hashes, up to tens of seconds on a phone.
- * Searched off the main thread (a Web Worker in a browser, a worker thread in Node), so that the app stays
- * responsive; `signal` stops the search. */
-export declare const burnAddress: (seed: Uint8Array, chainId: bigint, tokenId: number, index: number, signal?: AbortSignal) => Promise<Burn>;
-/** The `k`-th burn address a point of sale holding `laneKey` makes for its owner's `publicKey` on a chain and token
- * (`keys::pos_burn`), with its salt: about 2^16 hashes too, searched the same way. */
-export declare const posBurnAddress: (laneKey: Uint8Array, chainId: bigint, tokenId: number, k: number, publicKey: Hex, signal?: AbortSignal) => Promise<Burn>;
+/** The `index`-th burn address of `publicKey` on a chain and token, and its salt, from `burnKey`: the wallet's own burn
+ * key, or a point of sale's (`wallet_keys::derive_burn_address`). About 2^16 hashes, spread over the device's cores
+ * (Web Workers in a browser, worker threads in Node) so that the app stays responsive; `signal` stops the search. */
+export declare const burnAddress: (burnKey: Uint8Array, chainId: bigint, tokenId: number, index: number, publicKey: Hex, signal?: AbortSignal) => Promise<Burn>;
 /** A burn address of someone else's `publicKey` (one they published to be paid), with a random salt that has the proof
  * of work: about 2^16 hashes too, searched the same way. Only who holds the salt finds it: the payer, and the owner once
  * told (`planSend` with `burn`). */
 export declare const burnAddressFor: (chainId: bigint, publicKey: Hex, signal?: AbortSignal) => Promise<Burn>;
 export type BurnSearch = {
-    seed: Uint8Array;
+    burnKey: Uint8Array;
     chainId: bigint;
     tokenId: number;
     index: number;
-} | {
-    laneKey: Uint8Array;
-    chainId: bigint;
-    tokenId: number;
-    k: number;
     publicKey: Hex;
 } | {
     chainId: bigint;
     publicKey: Hex;
 };
-/** A search, where it runs: a seed's index, or a point of sale's counter, derives its salts; someone else's key takes
- * random ones. */
-export declare function searchHere(s: BurnSearch): Burn;
+/** A block of a search: its salt counters `from..=to`, or as many random salts for someone else's key. */
+export interface BurnBlock {
+    search: BurnSearch;
+    from: number;
+    to: number;
+}
 export type BurnAnswer = {
-    burn: Burn;
+    burn: Burn | null;
 } | {
     error: string;
 };
+/** The address a block holds, if any. Its salts count up from a start: one the burn key derives, or for someone else's
+ * key a random one below 2^253, so that every salt is a field element. */
+export declare function runBlock({ search: s, from, to }: BurnBlock): Burn | null;
+type Outcome = {
+    burn: Burn;
+} | {
+    error: unknown;
+};
+/** A search in progress, in blocks `0, 1, …` of `BLOCK` counters. From a burn key, the address is the first block's
+ * hit, so that every device derives the same one; for someone else's key, it is the first found. */
+export declare class Search {
+    #private;
+    readonly s: BurnSearch;
+    constructor(s: BurnSearch, settle: (r: Outcome) => void);
+    take(): number | undefined;
+    drop(block: number): void;
+    finish(block: number, burn: Burn | null): void;
+    fail(error: unknown): void;
+}
+export {};