@eco-incorp/sauce 0.99.5 → 0.99.7

package/sdk/dist/cli/args.js

@@ -0,0 +1,354 @@
+/**
+ * The `sauce` command's flags: parsing them, and turning each value into the SDK type it names.
+ *
+ * Every failure here is a {@link UsageError} whose message names the flag and what it accepts, so
+ * the command can tell a mistyped invocation (exit 2, with a pointer to `--help`) from a program
+ * that does not compile or a chain that says no (exit 1).
+ */
+import { parseArgs } from "node:util";
+import { getAddressEncoder, isAddress as isSolanaAddress } from "@solana/kit";
+import { bytesToBigInt, getAddress, isAddress } from "viem";
+import { requireChain } from "../chains/canonical.js";
+import { potSalt, SAUCE_INTENT_POT_SALT } from "../deployments/pot.js";
+import { INTENT_FUND_VIA } from "../routes/portal.js";
+/** A mistyped invocation: an unknown or missing flag, or a value that is not what the flag takes. */
+export class UsageError extends Error {
+}
+/** A failure that is not the invocation's fault: a program that does not compile, a chain that
+ *  disagrees. Exit 1, where a {@link UsageError} is exit 2. */
+export class CliError extends Error {
+}
+/** `argv` against `flags`, strictly: an unknown flag, a missing value or a stray operand throws. */
+export function parseFlags(argv, flags) {
+    const options = Object.fromEntries(Object.entries(flags).map(([name, spec]) => [
+        name,
+        {
+            type: spec.type,
+            ...(spec.multiple === true ? { multiple: true } : {}),
+            ...(spec.short === undefined ? {} : { short: spec.short }),
+        },
+    ]));
+    // A bare optional-value flag — last, or followed by another flag — takes the empty value.
+    const words = argv.map((word, index) => {
+        const name = /^--([\w-]+)$/.exec(word)?.[1];
+        const next = argv[index + 1];
+        return name !== undefined &&
+            flags[name]?.optionalValue === true &&
+            (next === undefined || next.startsWith("-"))
+            ? `${word}=`
+            : word;
+    });
+    try {
+        const { values, positionals } = parseArgs({
+            args: words,
+            options,
+            strict: true,
+            allowPositionals: true,
+        });
+        return { values, positionals };
+    }
+    catch (error) {
+        throw new UsageError(describeParseError(error, flags, words));
+    }
+}
+/** `parseArgs`'s messages advise on `--` escaping; say what was wrong with the flag instead. */
+function describeParseError(error, flags, argv) {
+    const message = error instanceof Error ? error.message : String(error);
+    const code = error.code;
+    const flag = /'(-{1,2}[^' ]+)/.exec(message)?.[1];
+    // Several flags in one word: a shell handed over a quoted string, or a variable it did not split
+    // (zsh never splits an unquoted `$FLAGS`).
+    const joined = argv.find((word) => /^-{1,2}\S+\s/.test(word) && word.startsWith(flag ?? "\0"));
+    if (code === "ERR_PARSE_ARGS_UNKNOWN_OPTION" && joined !== undefined) {
+        // Only the flags' names: a value in there may be a key.
+        const names = joined.split(/\s+/).filter((word) => /^-{1,2}[\w-]+$/.test(word));
+        return (`one argument holds several words, ${names.join(", ")} and their values, with spaces ` +
+            "between them: a shell passed a quoted string, or a variable it did not split (zsh does not " +
+            "split an unquoted $VARIABLE). Pass each flag and each value as a word of its own.");
+    }
+    if (code === "ERR_PARSE_ARGS_UNKNOWN_OPTION" && flag !== undefined) {
+        return `unknown option ${flag}`;
+    }
+    if (code === "ERR_PARSE_ARGS_INVALID_OPTION_VALUE" && flag !== undefined) {
+        const name = flag.replace(/^-+/, "");
+        const spec = flags[name] ?? Object.values(flags).find((f) => f.short === name);
+        return spec?.type === "boolean"
+            ? `${flag} takes no value`
+            : `${flag} needs a value${spec?.value === undefined ? "" : `: ${spec.value}`}`;
+    }
+    return message;
+}
+/** The one string value of `flag`, or `undefined` when it was not given. */
+export function stringFlag(args, flag) {
+    const value = args.values[flag];
+    return typeof value === "string" ? value : undefined;
+}
+/** The one string value of `flag`; missing, it is a usage error naming what it takes. */
+export function requiredFlag(args, flag, value) {
+    const given = stringFlag(args, flag);
+    if (given === undefined)
+        throw new UsageError(`missing --${flag} ${value}`);
+    return given;
+}
+/** Every value of a repeatable flag, in the order given. */
+export function repeatedFlag(args, flag) {
+    const value = args.values[flag];
+    return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+/** A chain by canonical slug, alias or numeric id — the same lookup the SDK itself uses. `from`
+ *  names where the value came from, for the error. */
+export function parseChain(raw, from = "--chain") {
+    const ref = /^\d+$/.test(raw) ? Number(raw) : raw;
+    try {
+        return requireChain(ref);
+    }
+    catch (error) {
+        throw new UsageError(`${from}: ${error.message}`);
+    }
+}
+export function parseTarget(raw, from = "--target") {
+    if (raw !== "evm" && raw !== "svm") {
+        throw new UsageError(`${from}: '${raw}' is not a target (evm or svm)`);
+    }
+    return raw;
+}
+const HEADER_TAG = /^\/\/\s*@(chain|target)\s+(\S+)\s*$/;
+/**
+ * The defaults a program file declares for itself, from the `//` comment lines it starts with:
+ *
+ * ```js
+ * // @chain base
+ * // Pays RECIPIENT from the Pot.
+ * ```
+ *
+ * The header ends at the first line that is not a `//` comment. A flag overrides what it says.
+ */
+export function parseHeader(text, file) {
+    const header = {};
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index].trim();
+        if (!line.startsWith("//"))
+            break;
+        const tag = HEADER_TAG.exec(line);
+        if (tag === null)
+            continue;
+        const name = tag[1];
+        if (header[name] !== undefined) {
+            throw new UsageError(`${file}:${index + 1}: the header gives @${name} twice`);
+        }
+        header[name] = tag[2];
+    }
+    return header;
+}
+/** A 20-byte hex address, returned checksummed. */
+export function parseAddress(flag, raw) {
+    if (!isAddress(raw, { strict: false })) {
+        throw new UsageError(`--${flag}: '${raw}' is not an address (20 bytes of hex, 0x-prefixed)`);
+    }
+    return getAddress(raw);
+}
+/** A non-negative integer amount in wei: decimal digits, or 0x-prefixed hex. */
+export function parseWei(flag, raw) {
+    if (!/^(?:\d+|0x[0-9a-fA-F]+)$/.test(raw)) {
+        throw new UsageError(`--${flag}: '${raw}' is not an amount in wei (an integer, e.g. 1000)`);
+    }
+    return BigInt(raw);
+}
+/**
+ * `--via kitchen|engine`: how a Solana cook reaches the engine — the Kitchen's `cook` on the
+ * owner's Pot, or the engine's own paid `cookAndPay`. `from` names where the value came from.
+ */
+export function parseVia(raw, from = "--via") {
+    if (raw !== "kitchen" && raw !== "engine") {
+        throw new UsageError(`${from}: '${raw}' is not kitchen (the Kitchen's cook, on the owner's Pot) or engine (the ` +
+            "engine's own paid cook, with no Pot)");
+    }
+    return raw;
+}
+/** A non-negative amount of lamports that fits a u64: decimal digits, or 0x-prefixed hex. */
+export function parseLamports(flag, raw) {
+    if (!/^(?:\d+|0x[0-9a-fA-F]+)$/.test(raw) || BigInt(raw) >= 1n << 64n) {
+        throw new UsageError(`--${flag}: '${raw}' is not an amount in lamports (an integer below 2^64, e.g. 5000)`);
+    }
+    return BigInt(raw);
+}
+/**
+ * A Pot's salt: `--salt <label>`, hashed by the SDK's `potSalt`, or `--salt-hex <bytes32>`, exactly
+ * 32 bytes — never both. Neither is the zero salt, the one Pot an owner has by default.
+ */
+export function parseSalt(label, hex) {
+    if (label !== undefined && hex !== undefined) {
+        throw new UsageError("give --salt or --salt-hex, not both: --salt <label> is hashed into the salt, --salt-hex " +
+            "<bytes32> is the salt itself");
+    }
+    if (label !== undefined) {
+        if (label === "") {
+            throw new UsageError("--salt: a label cannot be empty; leave --salt out for the default Pot");
+        }
+        const shown = /^[\w.@:/-]+$/.test(label) ? label : JSON.stringify(label);
+        return { salt: potSalt(label), flag: `--salt ${shown}` };
+    }
+    if (hex !== undefined) {
+        if (!/^0x[0-9a-fA-F]{64}$/.test(hex)) {
+            throw new UsageError(`--salt-hex: '${hex}' is not exactly 32 bytes of 0x-prefixed hex`);
+        }
+        return { salt: hex.toLowerCase(), flag: `--salt-hex ${hex.toLowerCase()}` };
+    }
+    return { salt: SAUCE_INTENT_POT_SALT };
+}
+/** How an intent's reward is funded — `routes/portal.ts#IntentFundVia`, spelled the same here. */
+export function parseFundVia(raw, from = "--intent-fund-via") {
+    if (!INTENT_FUND_VIA.includes(raw)) {
+        throw new UsageError(`${from}: '${raw}' is not ${INTENT_FUND_VIA.join(" or ")} — transfer pays the reward into ` +
+            "the intent's vault and then publishes; publishAndFund approves the Portal, which pulls it");
+    }
+    return raw;
+}
+/** Absolute Unix seconds. */
+export function parseUnixSeconds(flag, raw) {
+    if (!/^\d+$/.test(raw)) {
+        throw new UsageError(`--${flag}: '${raw}' is not a Unix time in seconds (e.g. 2000000000)`);
+    }
+    return BigInt(raw);
+}
+/** The literal syntax a define's value takes: a decimal or 0x-hex integer, `_` separators and a
+ *  trailing `n` allowed — the spelling the compiler accepts. */
+const DEFINE_VALUE = /^(?:\d[\d_]*|0x[0-9a-fA-F][0-9a-fA-F_]*)n?$/;
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const WORD = 1n << 256n;
+/**
+ * A Solana public key, as the 32-byte big-endian word a program compares an account's `address`
+ * with — `undefined` when `raw` is not one. A string of digits alone is read as the integer it also
+ * is, so a key that is all digits (the System Program's `1111…`) is given as 0x hex instead.
+ */
+function solanaKey(raw) {
+    if (/^\d+$/.test(raw) || !isSolanaAddress(raw))
+        return undefined;
+    return bytesToBigInt(new Uint8Array(getAddressEncoder().encode(raw)));
+}
+/** `raw` as a define's value, or a usage error naming `where` it was given. On Solana (`svm`), a
+ *  base58 public key is one too. */
+function defineValue(raw, where, svm) {
+    if (typeof raw === "boolean")
+        return raw;
+    if (raw === "true" || raw === "false")
+        return raw === "true";
+    let word;
+    if (typeof raw === "number" && Number.isSafeInteger(raw) && raw >= 0)
+        word = BigInt(raw);
+    if (typeof raw === "string" && DEFINE_VALUE.test(raw)) {
+        word = BigInt(raw.replace(/_/g, "").replace(/n$/, ""));
+    }
+    const key = word === undefined && typeof raw === "string" ? solanaKey(raw) : undefined;
+    if (key !== undefined) {
+        if (!svm) {
+            throw new UsageError(`${where}: '${String(raw)}' is a Solana public key (base58), which only a program for ` +
+                "Solana takes; give an EVM address as 0x hex");
+        }
+        word = key;
+    }
+    if (word === undefined) {
+        const shown = typeof raw === "string" ? `'${raw}'` : JSON.stringify(raw);
+        throw new UsageError(`${where}: ${shown} is not a define value: an address or other integer (decimal or 0x hex)` +
+            `${svm ? ", a base58 public key" : ""}, true or false`);
+    }
+    if (word >= WORD)
+        throw new UsageError(`${where}: ${String(raw)} does not fit 256 bits`);
+    return word;
+}
+function defineName(name, where) {
+    if (!IDENTIFIER.test(name)) {
+        throw new UsageError(`${where}: '${name}' is not a name a program can declare`);
+    }
+    return name;
+}
+/**
+ * `--define NAME=VALUE`, repeated: compile-time values the program reads by name. A define replaces
+ * the program's own module-level `const` of that name. A repeated name is refused rather than
+ * last-wins, as the compiler refuses it. On a Solana program (`target` svm) a value may also be a
+ * base58 public key.
+ */
+export function parseDefines(raws, target = "evm") {
+    const defines = {};
+    for (const raw of raws) {
+        const eq = raw.indexOf("=");
+        if (eq < 0)
+            throw new UsageError(`--define: '${raw}' is not NAME=VALUE`);
+        const name = defineName(raw.slice(0, eq), "--define");
+        if (Object.hasOwn(defines, name))
+            throw new UsageError(`--define: ${name} is given twice`);
+        defines[name] = defineValue(raw.slice(eq + 1), `--define ${name}`, target === "svm");
+    }
+    return defines;
+}
+/** Whether a define's value is written as an address: `0x` and 40 hex digits, or on Solana a
+ *  base58 public key. */
+const spelledAsAddress = (raw, svm) => typeof raw === "string" &&
+    (/^0x[0-9a-fA-F]{40}$/.test(raw) || (svm && solanaKey(raw) !== undefined));
+/**
+ * The defines whose value is written as an address, from `--define`'s `NAME=VALUE`s and a
+ * `--defines` file's text, `--define` winning as it does for the value. A report shows those as
+ * addresses and every other number as the integer it is, whatever its size: a price limit near
+ * 2^160 is not an address.
+ */
+export function addressDefines(raws, fileText, target = "evm") {
+    const spelled = fileText === undefined ? {} : { ...JSON.parse(fileText) };
+    for (const raw of raws) {
+        const eq = raw.indexOf("=");
+        if (eq > 0)
+            spelled[raw.slice(0, eq)] = raw.slice(eq + 1);
+    }
+    return addressDefinesOf(spelled, target);
+}
+/** The names among `entries` (NAME to value, as `parseDefineMap` takes them) whose value is
+ *  written as an address: what the MCP tools pass, beside `addressDefines`'s flags and file. */
+export function addressDefinesOf(entries, target = "evm") {
+    return Object.entries(entries)
+        .filter(([, raw]) => spelledAsAddress(raw, target === "svm"))
+        .map(([name]) => name);
+}
+/**
+ * `--defines <file.json>`: one JSON object of NAME to value — a string in `--define`'s syntax, a
+ * non-negative safe-integer number, or a boolean. `file` is only for the errors.
+ */
+export function parseDefinesFile(text, file, target = "evm") {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new UsageError(`--defines ${file}: not JSON (${error.message})`);
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new UsageError(`--defines ${file}: expected one JSON object of NAME to value`);
+    }
+    return parseDefineMap(parsed, `--defines ${file}`, target);
+}
+/**
+ * Defines given as one object of NAME to value, each value as `--defines` takes it: a string in
+ * `--define`'s syntax, a non-negative safe-integer number, or a boolean — and on a Solana program
+ * (`target` svm) a base58 public key. `where` names where they were given, for the errors.
+ */
+export function parseDefineMap(entries, where, target = "evm") {
+    const defines = {};
+    for (const [name, raw] of Object.entries(entries)) {
+        defines[defineName(name, where)] = defineValue(raw, `${where}: ${name}`, target === "svm");
+    }
+    return defines;
+}
+/** `flags` as the option lines of a `--help` screen, aligned. */
+export function describeFlags(flags) {
+    const rows = Object.entries(flags).map(([name, spec]) => {
+        const short = spec.short === undefined ? "    " : `-${spec.short}, `;
+        const value = spec.value === undefined
+            ? ""
+            : spec.optionalValue === true
+                ? ` [${spec.value}]`
+                : ` ${spec.value}`;
+        return [`${short}--${name}${value}`, spec.help];
+    });
+    const width = Math.max(...rows.map(([left]) => left.length));
+    return rows.map(([left, help]) => `  ${left.padEnd(width)}  ${help}`).join("\n");
+}
+//# sourceMappingURL=args.js.map

package/sdk/dist/cli/args.js.map

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

package/sdk/dist/cli/assume.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `sauce simulate --assume-balance`: what the Pot holds for one rehearsal, put there with state
+ * overrides. Nothing is sent and nothing on chain changes.
+ *
+ * The chain's native currency is the account's balance, overridden as it is. A token's balance is
+ * a word in the token's own storage — the proxy's, for a token behind one, since the implementation
+ * runs on the proxy's storage — and which word is found by asking the token, with plain `eth_call`
+ * and state overrides only (no trace or debug API):
+ *
+ *   1. every candidate slot is written at once, each with its own marker, and the marker
+ *      `balanceOf(holder)` answers names the slot. Should that one call not settle it (a token
+ *      whose `balanceOf` trips over one of the other writes), each candidate is tried alone;
+ *   2. the slot found is written with the amount, alone, and `balanceOf(holder)` must answer exactly
+ *      that, or nothing is assumed.
+ *
+ * The candidates are the layouts a balance mapping takes: Solidity's `mapping(address => uint256)`
+ * at slots 0–255 (`keccak256(holder . slot)`), Vyper's `HashMap` at slots 0–31
+ * (`keccak256(slot . holder)`), OpenZeppelin's namespaced (ERC-7201) upgradeable ERC-20, and
+ * Solady's ERC-20. A token whose balance is computed rather than stored (a rebasing token, shares)
+ * has no such slot, and is refused with that said. So is a B20 token, a precompile of the Base
+ * node (Coinbase's tokenized stocks), whose account holds the one byte `0xef` and whose balances
+ * the node keeps where no override reaches.
+ */
+import { type Address, type Hex, type PublicClient, type StateOverride } from "viem";
+/** Where a holder's balance lives in a token's storage, and which layout put it there. */
+export interface BalanceSlot {
+    readonly slot: Hex;
+    readonly layout: string;
+}
+type Candidate = BalanceSlot;
+/** Every slot a holder's balance might be at, in the order a hit is most likely. */
+export declare function balanceSlotCandidates(holder: Address): Candidate[];
+/**
+ * The slot of `token`'s storage holding `holder`'s balance, found with `eth_call` and state
+ * overrides and confirmed by `balanceOf`. `label` names the token in a failure.
+ */
+export declare function findBalanceSlot(client: PublicClient, token: Address, holder: Address, label: string): Promise<BalanceSlot>;
+/**
+ * `holder`'s balance of `token`, set to `amount` for a rehearsal: the slot found and the override
+ * that writes it, confirmed by `balanceOf` answering exactly `amount` through it.
+ */
+export declare function assumeTokenBalance(client: PublicClient, token: Address, holder: Address, amount: bigint, label: string): Promise<BalanceSlot & {
+    readonly override: StateOverride[number];
+}>;
+/**
+ * Overrides for the same account, merged into one entry each: a node takes one override per
+ * address, and viem refuses two.
+ */
+export declare function mergeOverrides(overrides: readonly StateOverride[number][]): StateOverride;
+export {};
+//# sourceMappingURL=assume.d.ts.map

package/sdk/dist/cli/assume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assume.d.ts","sourceRoot":"","sources":["../../src/cli/assume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,MAAM,CAAC;AAMd,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,SAAS,GAAG,WAAW,CAAC;AAY7B,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,CA0BlE;AA4DD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CA6DtB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAkBrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,aAAa,CA4BzF"}

package/sdk/dist/cli/assume.js

@@ -0,0 +1,207 @@
+/**
+ * `sauce simulate --assume-balance`: what the Pot holds for one rehearsal, put there with state
+ * overrides. Nothing is sent and nothing on chain changes.
+ *
+ * The chain's native currency is the account's balance, overridden as it is. A token's balance is
+ * a word in the token's own storage — the proxy's, for a token behind one, since the implementation
+ * runs on the proxy's storage — and which word is found by asking the token, with plain `eth_call`
+ * and state overrides only (no trace or debug API):
+ *
+ *   1. every candidate slot is written at once, each with its own marker, and the marker
+ *      `balanceOf(holder)` answers names the slot. Should that one call not settle it (a token
+ *      whose `balanceOf` trips over one of the other writes), each candidate is tried alone;
+ *   2. the slot found is written with the amount, alone, and `balanceOf(holder)` must answer exactly
+ *      that, or nothing is assumed.
+ *
+ * The candidates are the layouts a balance mapping takes: Solidity's `mapping(address => uint256)`
+ * at slots 0–255 (`keccak256(holder . slot)`), Vyper's `HashMap` at slots 0–31
+ * (`keccak256(slot . holder)`), OpenZeppelin's namespaced (ERC-7201) upgradeable ERC-20, and
+ * Solady's ERC-20. A token whose balance is computed rather than stored (a rebasing token, shares)
+ * has no such slot, and is refused with that said. So is a B20 token, a precompile of the Base
+ * node (Coinbase's tokenized stocks), whose account holds the one byte `0xef` and whose balances
+ * the node keeps where no override reaches.
+ */
+import { concat, encodeAbiParameters, encodeFunctionData, decodeFunctionResult, getAddress, keccak256, numberToHex, pad, parseAbi, } from "viem";
+import { CliError } from "./args.js";
+const BALANCE_OF = parseAbi(["function balanceOf(address) view returns (uint256)"]);
+/** A B20 token's code: no bytecode, the one byte that marks the node's own token. */
+const B20_CODE = "0xef";
+const SOLIDITY_SLOTS = 256;
+const VYPER_SLOTS = 32;
+/** OpenZeppelin's `ERC20Upgradeable` (v5) storage namespace, `openzeppelin.storage.ERC20`, whose
+ *  first field is the balances mapping. */
+const OZ_ERC20_NAMESPACE = "0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00";
+/** Solady `ERC20`'s balance slot seed: the slot is `keccak256(holder . uint64(0) . uint32(seed))`. */
+const SOLADY_BALANCE_SEED = "0x87a211a2";
+/** Every slot a holder's balance might be at, in the order a hit is most likely. */
+export function balanceSlotCandidates(holder) {
+    const solidity = (slot) => keccak256(encodeAbiParameters([{ type: "address" }, { type: "uint256" }], [holder, BigInt(slot)]));
+    const vyper = (slot) => keccak256(encodeAbiParameters([{ type: "uint256" }, { type: "address" }], [slot, holder]));
+    return [
+        ...Array.from({ length: SOLIDITY_SLOTS }, (_, at) => ({
+            slot: solidity(BigInt(at)),
+            layout: `Solidity mapping at slot ${at}`,
+        })),
+        {
+            slot: solidity(OZ_ERC20_NAMESPACE),
+            layout: "OpenZeppelin ERC20Upgradeable (ERC-7201 namespace)",
+        },
+        {
+            slot: keccak256(concat([holder, pad("0x", { size: 8 }), SOLADY_BALANCE_SEED])),
+            layout: "Solady ERC20",
+        },
+        ...Array.from({ length: VYPER_SLOTS }, (_, at) => ({
+            slot: vyper(BigInt(at)),
+            layout: `Vyper HashMap at slot ${at}`,
+        })),
+    ];
+}
+/** Markers below 2^64, so a balance packed into fewer bits than a word still reads one back. */
+const MARKER_BASE = 0x5a0ce5a0ce000000n;
+const word = (value) => numberToHex(value, { size: 32 });
+/** `balanceOf(holder)` on `token` with `slots` overridden; `undefined` when the call fails. */
+async function balanceWith(client, token, holder, slots) {
+    try {
+        const { data } = await client.call({
+            to: token,
+            data: encodeFunctionData({ abi: BALANCE_OF, functionName: "balanceOf", args: [holder] }),
+            ...(slots.length === 0
+                ? {}
+                : {
+                    stateOverride: [
+                        {
+                            address: token,
+                            stateDiff: slots.map(({ slot, value }) => ({ slot, value: word(value) })),
+                        },
+                    ],
+                }),
+        });
+        if (data === undefined || data.length !== 66)
+            return undefined;
+        return decodeFunctionResult({ abi: BALANCE_OF, functionName: "balanceOf", data });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The candidate whose marker `balanceOf` answered with, if any. */
+const answered = (candidates, balance) => {
+    if (balance === undefined || balance < MARKER_BASE)
+        return undefined;
+    return candidates[Number(balance - MARKER_BASE)];
+};
+/** Whether the endpoint applies an `eth_call` state override at all: code put at an empty address
+ *  must answer. */
+async function overridesApplied(client) {
+    const probe = "0x5a0CE00000000000000000000000000000005a0C";
+    try {
+        const { data } = await client.call({
+            to: probe,
+            // PUSH1 0x2a PUSH1 0 MSTORE PUSH1 0x20 PUSH1 0 RETURN: answers the word 42.
+            stateOverride: [{ address: probe, code: "0x602a60005260206000f3" }],
+        });
+        return data !== undefined && BigInt(data) === 42n;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The slot of `token`'s storage holding `holder`'s balance, found with `eth_call` and state
+ * overrides and confirmed by `balanceOf`. `label` names the token in a failure.
+ */
+export async function findBalanceSlot(client, token, holder, label) {
+    let code;
+    try {
+        code = await client.getCode({ address: token });
+    }
+    catch {
+        // Unread code says nothing: the search below decides.
+    }
+    if (code === B20_CODE) {
+        throw new CliError(`--assume-balance ${label}: ${token} is a B20 token, a precompile of the Base node, which ` +
+            "keeps its balances where no state override reaches, so a rehearsal cannot give the Pot " +
+            "one. Fund the Pot with it instead (--fund), from an account that holds it.");
+    }
+    const candidates = balanceSlotCandidates(holder);
+    const current = await balanceWith(client, token, holder, []);
+    if (current === undefined) {
+        throw new CliError(`--assume-balance ${label}: ${token} does not answer balanceOf(address), so it is not an ` +
+            "ERC-20 the rehearsal can give a balance of");
+    }
+    // One call with every candidate written: the marker that comes back names the slot.
+    let found = answered(candidates, await balanceWith(client, token, holder, candidates.map(({ slot }, index) => ({ slot, value: MARKER_BASE + BigInt(index) }))));
+    // Each alone, a few at a time, when writing them all at once did not settle it.
+    for (let at = 0; found === undefined && at < candidates.length; at += 16) {
+        const batch = candidates.slice(at, at + 16);
+        const answers = await Promise.all(batch.map((candidate, index) => balanceWith(client, token, holder, [
+            { slot: candidate.slot, value: MARKER_BASE + BigInt(at + index) },
+        ])));
+        found = answers.map((answer) => answered(candidates, answer)).find((hit) => hit !== undefined);
+    }
+    if (found === undefined) {
+        if (!(await overridesApplied(client))) {
+            throw new CliError(`--assume-balance ${label}: the endpoint does not apply state overrides to eth_call, ` +
+                "which giving the Pot a balance needs: use an endpoint that does (most do)");
+        }
+        throw new CliError(`--assume-balance ${label}: no storage slot of ${token} holds the balance its balanceOf ` +
+            `reports (tried Solidity mappings at slots 0-${SOLIDITY_SLOTS - 1}, Vyper's at ` +
+            `0-${VYPER_SLOTS - 1}, OpenZeppelin's namespaced ERC-20 and Solady's): a token whose ` +
+            "balance is computed rather than stored (rebasing, shares) cannot be assumed. Fund the " +
+            "Pot instead.");
+    }
+    return found;
+}
+/**
+ * `holder`'s balance of `token`, set to `amount` for a rehearsal: the slot found and the override
+ * that writes it, confirmed by `balanceOf` answering exactly `amount` through it.
+ */
+export async function assumeTokenBalance(client, token, holder, amount, label) {
+    const found = await findBalanceSlot(client, token, holder, label);
+    const write = [{ slot: found.slot, value: amount }];
+    if ((await balanceWith(client, token, holder, write)) !== amount) {
+        throw new CliError(`--assume-balance ${label}: writing ${amount} at ${found.slot} (${found.layout}) of ` +
+            `${token} does not make balanceOf(${holder}) answer ${amount}, so the balance cannot be ` +
+            "assumed");
+    }
+    return {
+        ...found,
+        override: {
+            address: getAddress(token),
+            stateDiff: [{ slot: found.slot, value: word(amount) }],
+        },
+    };
+}
+/**
+ * Overrides for the same account, merged into one entry each: a node takes one override per
+ * address, and viem refuses two.
+ */
+export function mergeOverrides(overrides) {
+    const byAddress = new Map();
+    for (const override of overrides) {
+        const key = getAddress(override.address);
+        const before = byAddress.get(key);
+        if (before === undefined) {
+            byAddress.set(key, { ...override, address: key });
+            continue;
+        }
+        const slots = new Map();
+        for (const entry of [...(before.stateDiff ?? []), ...(override.stateDiff ?? [])]) {
+            slots.set(entry.slot.toLowerCase(), entry.value);
+        }
+        const balance = override.balance ?? before.balance;
+        const nonce = override.nonce ?? before.nonce;
+        const code = override.code ?? before.code;
+        byAddress.set(key, {
+            address: key,
+            ...(balance === undefined ? {} : { balance }),
+            ...(nonce === undefined ? {} : { nonce }),
+            ...(code === undefined ? {} : { code }),
+            ...(slots.size === 0
+                ? {}
+                : { stateDiff: [...slots].map(([slot, value]) => ({ slot: slot, value })) }),
+        });
+    }
+    return [...byAddress.values()];
+}
+//# sourceMappingURL=assume.js.map

package/sdk/dist/cli/assume.js.map

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