@zerc20/wallet-sdk 0.3.0 → 0.5.0

package/README.md

@@ -19,7 +19,7 @@ const wallet = await Wallet.open({ network, walletClient, seed, persist: { load,
 await wallet.sync();
 wallet.balances();
 const q = await wallet.fees({ kind: 'send', token, amount });
-await (await wallet.send({ to: '0x…', token, amount, maxFee: q.fee })).wait();
+await (await wallet.send({ to: 'zerc20id1…', token, amount, maxFee: q.fee })).wait();
 ```
 
 ## License

package/dist/accountId.d.ts

@@ -0,0 +1,5 @@
+import { type Address } from 'viem';
+/** `address` as its zERC20 ID: checksummed text (bech32m, `zerc20id1…`) of its 20 bytes. */
+export declare const accountId: (address: Address) => string;
+/** The account `text` is the zERC20 ID of, or `null` if it is not one. */
+export declare function idAccount(text: string): Address | null;

package/dist/accountId.js

@@ -0,0 +1,19 @@
+// A zERC20 ID: an account's address as text that no other wallet or exchange takes for an address, so that a payer
+// pays the account privately, as only a zERC20 wallet does, and never by a public transfer to the address, which this
+// wallet does not hold.
+import { bech32m } from '@scure/base';
+import { bytesToHex, getAddress, hexToBytes } from 'viem';
+const PREFIX = 'zerc20id';
+/** `address` as its zERC20 ID: checksummed text (bech32m, `zerc20id1…`) of its 20 bytes. */
+export const accountId = (address) => bech32m.encode(PREFIX, bech32m.toWords(hexToBytes(address)), false);
+/** The account `text` is the zERC20 ID of, or `null` if it is not one. */
+export function idAccount(text) {
+    try {
+        const { prefix, bytes } = bech32m.decodeToBytes(text.trim());
+        return prefix === PREFIX && bytes.length === 20 ? getAddress(bytesToHex(bytes)) : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=accountId.js.map

package/dist/accountId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountId.js","sourceRoot":"","sources":["../src/accountId.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,sHAAsH;AACtH,wBAAwB;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAgB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAExE,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAU,EAAE,CACpD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAEtE,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/chain.d.ts

@@ -282,6 +282,41 @@ export declare const depositFactoryAbi: readonly [{
     }, {
         readonly type: "address";
         readonly name: "refundAddress";
+    }, {
+        readonly type: "address";
+        readonly name: "refundSigner";
+    }, {
+        readonly type: "address";
+        readonly name: "feeRecipient";
+    }, {
+        readonly type: "uint256";
+        readonly name: "fee";
+    }, {
+        readonly type: "address";
+        readonly name: "referrer";
+    }, {
+        readonly type: "uint16";
+        readonly name: "referralBps";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "flush";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "token";
+    }, {
+        readonly type: "address";
+        readonly name: "burnAddress";
+    }, {
+        readonly type: "address";
+        readonly name: "refundAddress";
+    }, {
+        readonly type: "address";
+        readonly name: "refundSigner";
     }, {
         readonly type: "address";
         readonly name: "feeRecipient";
@@ -299,6 +334,18 @@ export declare const depositFactoryAbi: readonly [{
         readonly type: "address";
     }];
 }];
+/** Where a deposit address sends back what it cannot wrap, and a rage exit's refund: a fixed address, which anyone may
+ * refund to, or wherever the key at `signer` signs for each refund (`DepositAddress.refundTo`). */
+export type Refund = {
+    address: Address;
+} | {
+    signer: Address;
+};
+/** What the factory derives a deposit address from, in the order its `predict` and `flush` take it. */
+export type FactoryArgs = readonly [Address, Hex, Address, Address, Address, bigint, Address, number];
+/** `FactoryArgs` for a deposit address of `token` into `burnAddress` whose refunds go as `refund` says, and whose flush
+ * pays `fee` to `feeRecipient` and `referralBps` of the rest to `referrer`. */
+export declare const factoryArgs: (token: Address, burnAddress: Hex, refund: Refund, feeRecipient: Address, fee: bigint, referrer: Address, referralBps: number) => FactoryArgs;
 /** 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
@@ -316,7 +363,30 @@ export declare const depositAddressAbi: readonly [{
         readonly name: "asset";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly name: "refundTo";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "asset";
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+    }, {
+        readonly type: "uint256";
+        readonly name: "deadline";
+    }, {
+        readonly type: "bytes";
+        readonly name: "signature";
+    }];
+    readonly outputs: readonly [];
 }];
+/** What a deposit address's refund signer signs to send its balance of `asset` to `to` until `deadline` (Unix seconds),
+ * as an EIP-191 message: the chain and the address are in it, so it moves nothing at the same address elsewhere. */
+export declare const refundDigest: (chainId: bigint, depositAddress: Address, asset: Address, to: Address, deadline: bigint) => `0x${string}`;
+/** Multicall3, at the address it has on every chain the deposit relayer serves: it puts calls in one transaction. */
+export declare const MULTICALL3: Address;
 /** The native asset's stand-in for `underlyingAsset`. */
 export declare const NATIVE: Address;
 /** `Protocol.UNWRAP_INTENT`: the `withdrawIntent` that pays a withdrawal out as the underlying asset. The EIP-712 struct
@@ -333,21 +403,25 @@ export interface Token {
     symbol: string;
     decimals: number;
 }
+/** A transport to a chain's RPC (`url`, or the chain's own) that waits out its rate limit. A public RPC turns calls
+ * away beyond some per second (Tenderly's gateways, about five `eth_call`s), which a sync and a deposit together pass;
+ * viem retries a refusal, but its default three retries give up within the second the limit counts. Five wait 0.15 s,
+ * doubling, 4.65 s in all. */
+export declare const rpcTransport: (url?: string) => import("viem").HttpTransport<undefined, false>;
 export declare class Chain {
     #private;
     readonly config: ChainConfig;
     readonly client: PublicClient;
     constructor(config: ChainConfig);
     get chainId(): bigint;
-    ledger(): Promise<Address>;
-    /** The deposit address the factory deploys for `token`, `burnAddress` and `refundAddress`, whose flush pays `fee`
-     * 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, 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>;
+    readonly ledger: () => Promise<`0x${string}`>;
+    /** The deposit address the factory deploys for `args`. */
+    predictDepositAddress(args: FactoryArgs): Promise<Address>;
+    /** Where `address` refunds to if it is a deployed deposit address for `token` and `burnAddress`, whatever its refund,
+     * fee and referral; null if it is not one. A clone's code ends with its immutable args,
+     * `abi.encode(token, burnAddress, refundAddress, refundSigner, 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<Refund | null>;
     /** Whether the ledger accepts `root` as the tree at `size` leaves. */
     provedRoot(size: number, root: Hex): Promise<boolean>;
     /** `2^64 - 1`, unless the ledger is in an emergency: then it accepts no root above it, and proves none. */
@@ -356,4 +430,6 @@ export declare class Chain {
     withdrawFee(tokenId: number, amount: bigint): Promise<bigint>;
     /** Every token the factory has registered, read once and then only the new ones. */
     tokens(): Promise<Token[]>;
+    /** The tokens as `tokens()` last read them, without reading again. */
+    get known(): Token[];
 }

package/dist/chain.js

@@ -1,5 +1,5 @@
 // What a wallet reads from the chain itself, through its own RPC: roots are taken from here, never from a server.
-import { createPublicClient, decodeAbiParameters, http, keccak256, numberToHex, parseAbi, size, slice, toHex, zeroAddress, } from 'viem';
+import { createPublicClient, decodeAbiParameters, encodeAbiParameters, http, keccak256, numberToHex, parseAbi, parseAbiParameters, size, slice, toHex, zeroAddress, } from 'viem';
 export const verifierAbi = parseAbi([
     'function ledger() view returns (address)',
     'function factory() view returns (address)',
@@ -35,64 +35,91 @@ 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, address referrer, uint16 referralBps) view returns (address)',
+    'function predict(address token, address burnAddress, address refundAddress, address refundSigner, address feeRecipient, uint256 fee, address referrer, uint16 referralBps) view returns (address)',
+    'function flush(address token, address burnAddress, address refundAddress, address refundSigner, address feeRecipient, uint256 fee, address referrer, uint16 referralBps) returns (address)',
 ]);
+const refundArgs = (refund) => 'address' in refund ? [refund.address, zeroAddress] : [zeroAddress, refund.signer];
+/** `FactoryArgs` for a deposit address of `token` into `burnAddress` whose refunds go as `refund` says, and whose flush
+ * pays `fee` to `feeRecipient` and `referralBps` of the rest to `referrer`. */
+export const factoryArgs = (token, burnAddress, refund, feeRecipient, fee, referrer, referralBps) => [token, burnAddress, ...refundArgs(refund), feeRecipient, fee, referrer, referralBps];
 /** 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)']);
+export const depositAddressAbi = parseAbi([
+    'function refund(address asset)',
+    'function refundTo(address asset, address to, uint256 deadline, bytes signature)',
+]);
+/** What a deposit address's refund signer signs to send its balance of `asset` to `to` until `deadline` (Unix seconds),
+ * as an EIP-191 message: the chain and the address are in it, so it moves nothing at the same address elsewhere. */
+export const refundDigest = (chainId, depositAddress, asset, to, deadline) => keccak256(encodeAbiParameters(parseAbiParameters('uint256, address, address, address, uint256'), [
+    chainId,
+    depositAddress,
+    asset,
+    to,
+    deadline,
+]));
+/** Multicall3, at the address it has on every chain the deposit relayer serves: it puts calls in one transaction. */
+export const MULTICALL3 = '0xcA11bde05977b3631167028862bE2a173976CA11';
 /** The native asset's stand-in for `underlyingAsset`. */
 export const NATIVE = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE';
 /** `Protocol.UNWRAP_INTENT`: the `withdrawIntent` that pays a withdrawal out as the underlying asset. The EIP-712 struct
  * hash of `Unwrap()`, reduced into the BN254 field. */
 export const UNWRAP_INTENT = BigInt(keccak256(keccak256(toHex('Unwrap()')))) %
     21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+/** A transport to a chain's RPC (`url`, or the chain's own) that waits out its rate limit. A public RPC turns calls
+ * away beyond some per second (Tenderly's gateways, about five `eth_call`s), which a sync and a deposit together pass;
+ * viem retries a refusal, but its default three retries give up within the second the limit counts. Five wait 0.15 s,
+ * doubling, 4.65 s in all. */
+export const rpcTransport = (url) => http(url, { retryCount: 5 });
+/** `read`, made once and then kept. A read that fails is not kept: the next call reads again, rather than failing for
+ * as long as the wallet is open. */
+function once(read) {
+    let kept;
+    return () => (kept ??= read().catch((e) => {
+        kept = undefined;
+        throw e;
+    }));
+}
 export class Chain {
     config;
     client;
-    #ledger;
-    #tokens;
+    #tokens = [];
     constructor(config) {
         this.config = config;
-        this.client = createPublicClient({ transport: http(config.rpcUrl) });
+        this.client = createPublicClient({ transport: rpcTransport(config.rpcUrl) });
     }
     get chainId() {
         return this.config.chainId;
     }
-    ledger() {
-        this.#ledger ??= this.client.readContract({
-            address: this.config.verifier,
-            abi: verifierAbi,
-            functionName: 'ledger',
-        });
-        return this.#ledger;
-    }
-    /** The deposit address the factory deploys for `token`, `burnAddress` and `refundAddress`, whose flush pays `fee`
-     * to `feeRecipient` and `referralBps` of the rest to `referrer`. */
-    predictDepositAddress(token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps) {
+    // the verifier's ledger and token factory are set once, as it is initialized
+    ledger = once(() => this.client.readContract({ address: this.config.verifier, abi: verifierAbi, functionName: 'ledger' }));
+    #factory = once(() => this.client.readContract({ address: this.config.verifier, abi: verifierAbi, functionName: 'factory' }));
+    /** The deposit address the factory deploys for `args`. */
+    predictDepositAddress(args) {
         return this.client.readContract({
             address: this.config.depositAddressFactory,
             abi: depositFactoryAbi,
             functionName: 'predict',
-            args: [token, burnAddress, refundAddress, feeRecipient, fee, referrer, referralBps],
+            args,
         });
     }
-    /** The refund address of `address` if it is a deployed deposit address for `token` and `burnAddress`, whatever its
-     * 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. */
+    /** Where `address` refunds to if it is a deployed deposit address for `token` and `burnAddress`, whatever its refund,
+     * fee and referral; null if it is not one. A clone's code ends with its immutable args,
+     * `abi.encode(token, burnAddress, refundAddress, refundSigner, 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) < 224)
+        if (!code || size(code) < 256)
             return null;
         // 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));
+        const [refundAddress, refundSigner, feeRecipient, fee, referrer, referralBps] = decodeAbiParameters(parseAbiParameters('address, address, address, uint256, address, uint256'), slice(code, size(code) - 192));
         // predict would revert
-        if (refundAddress === zeroAddress || feeRecipient === zeroAddress)
+        if ((refundAddress === zeroAddress) === (refundSigner === zeroAddress) || feeRecipient === zeroAddress)
             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;
+        const refund = refundAddress === zeroAddress ? { signer: refundSigner } : { address: refundAddress };
+        const expected = await this.predictDepositAddress(factoryArgs(token, burnAddress, refund, feeRecipient, fee, referrer, Number(referralBps)));
+        return expected.toLowerCase() === address.toLowerCase() ? refund : null;
     }
     /** Whether the ledger accepts `root` as the tree at `size` leaves. */
     async provedRoot(size, root) {
@@ -125,13 +152,9 @@ export class Chain {
     }
     /** Every token the factory has registered, read once and then only the new ones. */
     async tokens() {
-        const factory = await this.client.readContract({
-            address: this.config.verifier,
-            abi: verifierAbi,
-            functionName: 'factory',
-        });
+        const factory = await this.#factory();
         const count = await this.client.readContract({ address: factory, abi: factoryAbi, functionName: 'tokenCount' });
-        const known = this.#tokens ?? [];
+        const known = this.#tokens;
         const fresh = await Promise.all(Array.from({ length: count - known.length }, async (_, i) => {
             const tokenId = known.length + i + 1;
             const address = await this.client.readContract({
@@ -151,5 +174,9 @@ export class Chain {
         this.#tokens = [...known, ...fresh];
         return this.#tokens;
     }
+    /** The tokens as `tokens()` last read them, without reading again. */
+    get known() {
+        return this.#tokens;
+    }
 }
 //# sourceMappingURL=chain.js.map

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,6 +1,6 @@
 import type { CanisterClient, ViewKey } from '@zerc20/storage-sdk';
-import { type Account, type Hex, type WalletClient } from 'viem';
-import type { Chain } from './chain.js';
+import { type Account, type Address, type Hex, type LocalAccount, type WalletClient } from 'viem';
+import { type Chain } from './chain.js';
 import type { ChainConfig, Network } from './network.js';
 import type { Asp, Indexer } from './servers.js';
 import type { ChainState, WalletState } from './state.js';
@@ -19,14 +19,18 @@ export interface SpendKey {
     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'>;
+ * it, and the signing key's hash, which with the nullifying key makes the public key. */
+export type Owner = Pick<SpendKey, 'authKeyHash' | 'publicKey' | 'nullifyingKey'>;
 export interface Ctx {
     network: Network;
-    /** The root of every key. Opened with a function for it, held only while something needs it; otherwise always. */
+    /** The root of every key. Opened with a function for it, held only while something needs it; watching, never;
+     * otherwise always. */
     seed: Uint8Array | null;
-    /** The owners derived while the seed was held, by key: the wallet's own (`''`) and each receive code's. */
+    /** The owners derived while the seed was held, or given by a view key, by key: the wallet's own (`''`) and each
+     * receive code's. */
     owners: Map<string, Owner>;
+    /** The refund signers' addresses derived while the seed was held, by receive code (`refundSigner`). */
+    refundSigners: Map<string, Address>;
     address: Hex;
     /** The account that holds the public funds, and signs for them. */
     account: Account;
@@ -54,6 +58,10 @@ 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;
+/** The key that signs where the refunds of the deposit address handed out with `code`'s burn address go. */
+export declare function refundAccount(ctx: Ctx, code: CodeId): LocalAccount;
+/** `refundAccount`'s address: derived before, or now if the seed is held; null if neither. */
+export declare function refundSigner(ctx: Ctx, code: CodeId): Address | 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. */

package/dist/context.js

@@ -1,7 +1,10 @@
 // Everything an open wallet works with, shared by sync and the operations.
-import { createWalletClient, http, publicActions } from 'viem';
+import { createWalletClient, publicActions, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { rpcTransport } from './chain.js';
 import { core } from './core.js';
 import { guard } from './errors.js';
+import { refundKey } from './seed.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. */
@@ -23,8 +26,9 @@ export function spendKey(ctx, code) {
         key = (code ? core.codeSpendKey(seed, code.chainId, code.tokenId, code.index) : core.spendKey(seed));
         bySeed.set(id, key);
     }
+    const { authKeyHash, publicKey, nullifyingKey } = key;
     if (!ctx.owners.has(id))
-        ctx.owners.set(id, { publicKey: key.publicKey, nullifyingKey: key.nullifyingKey });
+        ctx.owners.set(id, { authKeyHash, publicKey, 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
@@ -32,6 +36,16 @@ export function spendKey(ctx, code) {
 export function owner(ctx, code) {
     return ctx.owners.get(idOf(code)) ?? (ctx.seed ? spendKey(ctx, code) : null);
 }
+/** The key that signs where the refunds of the deposit address handed out with `code`'s burn address go. */
+export function refundAccount(ctx, code) {
+    const account = privateKeyToAccount(refundKey(seedOf(ctx), code.chainId, code.tokenId, code.index));
+    ctx.refundSigners.set(idOf(code), account.address);
+    return account;
+}
+/** `refundAccount`'s address: derived before, or now if the seed is held; null if neither. */
+export function refundSigner(ctx, code) {
+    return ctx.refundSigners.get(idOf(code)) ?? (ctx.seed ? refundAccount(ctx, code).address : null);
+}
 export function chainCtx(ctx, chainId) {
     const c = ctx.chains.find((c) => c.config.chainId === chainId);
     if (!c)
@@ -55,7 +69,7 @@ export async function switched(wc, chainId) {
 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) });
+    return createWalletClient({ account: ctx.account, transport: rpcTransport(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

package/dist/context.js.map

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

package/dist/core.d.ts

@@ -9,8 +9,12 @@ export interface 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>;
+ * (Web Workers in a browser, worker threads in Node) so that the app stays responsive; `signal` stops the search. One
+ * that nobody waits for, made ahead, is `urgent: false`: it gives way to those someone waits for. */
+export declare const burnAddress: (burnKey: Uint8Array, chainId: bigint, tokenId: number, index: number, publicKey: Hex, opts?: {
+    signal?: AbortSignal;
+    urgent?: boolean;
+}) => 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`). */
@@ -36,9 +40,26 @@ export type BurnAnswer = {
 } | {
     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;
+/** What a block asks of the protocol code: `burnBlock`'s arguments, or `burnBlockFor`'s. */
+export type BurnCall = {
+    burnKey: Uint8Array;
+    chainId: bigint;
+    tokenId: number;
+    index: number;
+    publicKey: Hex;
+    from: number;
+    to: number;
+} | {
+    chainId: bigint;
+    publicKey: Hex;
+    start: Hex;
+    count: number;
+};
+/** A block's call. 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 blockCall({ search: s, from, to }: BurnBlock): BurnCall;
+/** The address a block holds, if any. */
+export declare function runBlock(b: BurnBlock): Burn | null;
 type Outcome = {
     burn: Burn;
 } | {
@@ -55,4 +76,13 @@ export declare class Search {
     finish(block: number, burn: Burn | null): void;
     fail(error: unknown): void;
 }
+/** Runs blocks somewhere other than this module's wasm: a server's native process, say. */
+export interface BurnRunner {
+    /** How many blocks it runs at once. */
+    slots: number;
+    run(call: BurnCall): Promise<Burn | null>;
+}
+/** Runs every block from now on on `r`, or with null in this module's wasm again. The blocks the runner had are handed
+ * out again, and what it answers for them later is dropped. */
+export declare function runBurnsOn(r: BurnRunner | null): void;
 export {};