@eco-incorp/sauce 0.99.6 → 0.99.8

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

@@ -0,0 +1,79 @@
+import { type KeyPairSigner } from "@solana/kit";
+import { type Address } from "viem";
+import { type PrivateKeyAccount } from "viem/accounts";
+import { type KeystoreKind } from "./signer.js";
+/** Where wallets are kept unless `--wallets` says otherwise. */
+export declare const defaultWalletsDir: () => string;
+/** What each wallet holds. */
+export type WalletKind = KeystoreKind;
+/** A wallet, as its file names it in the clear. */
+export interface WalletInfo {
+    readonly name: string;
+    readonly kind: WalletKind;
+    /** A checksummed 0x address on EVM chains, a base58 public key on Solana. */
+    readonly address: string;
+    /** The wallet's file: a keystore `--keystore` (and, for EVM, `cast wallet`) reads. */
+    readonly path: string;
+    /** Where its policy is read from, whether or not there is one. */
+    readonly policyPath: string;
+}
+/** A wallet unlocked: its signer, for the kind of chain it signs on. */
+export type Unlocked = {
+    readonly kind: "evm";
+    readonly info: WalletInfo;
+    readonly account: PrivateKeyAccount;
+} | {
+    readonly kind: "solana";
+    readonly info: WalletInfo;
+    readonly signer: KeyPairSigner;
+};
+/** A wallet's name, checked. */
+export declare function walletName(raw: string): string;
+/** A Solana keypair's 64 bytes as text: the JSON array a keypair file holds. */
+export declare const keypairText: (bytes: Uint8Array) => string;
+/** A secret to import: what a file or stdin held, read as the key it is. */
+export interface ImportedSecret {
+    readonly kind: WalletKind;
+    /** The key: 32 bytes for EVM, the 64-byte keypair for Solana. */
+    readonly bytes: Uint8Array;
+}
+/**
+ * What an import's text is: a v3 keystore (decrypted with `password`, which the wallet then keeps),
+ * a Solana keypair file (a JSON array of 64 bytes) or its base58 spelling, or a raw EVM private key
+ * (32 bytes of hex). The text is a secret from the start; it is never quoted back.
+ */
+export declare function readImport(text: string, password: string, from: string): ImportedSecret;
+export declare class WalletStore {
+    readonly dir: string;
+    constructor(dir: string);
+    private file;
+    /** The wallet `name`, as its file names it; an error naming the directory when there is none. */
+    info(name: string): WalletInfo;
+    private parse;
+    /** Every wallet the directory holds, and a warning for each file there it cannot read. */
+    list(): {
+        readonly wallets: WalletInfo[];
+        readonly warnings: string[];
+    };
+    /** Creates the directory, owner-only, and warns when one that exists lets others in. */
+    private ensureDir;
+    /** Writes `text` as wallet `name`, once: never over a wallet that exists. */
+    private write;
+    /** Stores `bytes` (32 bytes for EVM, a 64-byte keypair for Solana) as wallet `name`. */
+    store(name: string, kind: WalletKind, bytes: Uint8Array, password: string): Promise<{
+        readonly info: WalletInfo;
+        readonly warnings: string[];
+    }>;
+    /** A new wallet `name` with a fresh key. */
+    create(name: string, kind: WalletKind, password: string): Promise<{
+        readonly info: WalletInfo;
+        readonly warnings: string[];
+    }>;
+    /** The wallet's key, decrypted with `password`: what `export` shows, and nothing else reads. */
+    secretOf(name: string, password: string): ImportedSecret;
+    /** The wallet unlocked with `password`: its signer. */
+    unlock(name: string, password: string): Promise<Unlocked>;
+}
+/** The address `info` names, as an EVM address; refuses a Solana wallet. */
+export declare const evmAddressOf: (info: WalletInfo) => Address;
+//# sourceMappingURL=wallets.d.ts.map

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

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

package/sdk/dist/cli/wallets.js

@@ -0,0 +1,297 @@
+/**
+ * The wallet directory: the keys the `sauce` command (and the local MCP server) sign with when
+ * told `--wallet <name>`, each encrypted under a password the agent holds and never sees in its
+ * context (`password.ts` reads it from the source it is told about).
+ *
+ * One file per wallet, `<dir>/<name>.json`, beside the intent store under `~/.sauce`:
+ *
+ *  - an EVM wallet is a Web3 Secret Storage (v3) keystore exactly as geth and `cast wallet` write it
+ *    (scrypt, AES-128-CTR, keccak-256 MAC; `signer.ts#encryptKeystore`), so `--keystore <file>`,
+ *    `cast wallet … --keystore <file>` and geth read it too;
+ *  - a Solana wallet is the same envelope around the keypair's 64 bytes (seed, then public key, as
+ *    solana-keygen writes them), marked `"kind": "solana"`, its `address` the base58 public key.
+ *
+ * The address is in the clear in each file, so listing wallets and naming one's address need no
+ * password. A file is written once — to a temporary file created 0600, then LINKED into place,
+ * which fails if the name exists — and never overwritten. The directory is created 0700. Beside a
+ * wallet may sit `<name>.policy.json`, the limits on what it sends, and the ledger of what it sent
+ * (`policy.ts`). This is a HOT wallet: whoever holds the password and the file holds the key, so it
+ * should hold small balances.
+ *
+ * NODE-ONLY (the filesystem, `node:crypto`), like the rest of `cli/`; nothing browser-facing
+ * imports it. The default directory is `~/.sauce/wallets`; `--wallets <dir>` names another.
+ */
+import { generateKeyPairSync } from "node:crypto";
+import { chmodSync, linkSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createKeyPairSignerFromBytes, getBase58Decoder, getBase58Encoder, isAddress as isSolanaAddress, } from "@solana/kit";
+import { bytesToHex, getAddress, hexToBytes, isAddress } from "viem";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { CliError, UsageError } from "./args.js";
+import { MIN_PASSWORD } from "./password.js";
+import { decryptKeystoreBytes, encryptKeystore, keystoreKind, parsePrivateKey, secret, } from "./signer.js";
+/** Where wallets are kept unless `--wallets` says otherwise. */
+export const defaultWalletsDir = () => join(homedir(), ".sauce", "wallets");
+/** A wallet's name: lowercase letters, digits, `-` and `_`, as a file name on any system. */
+const NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+/** A wallet's name, checked. */
+export function walletName(raw) {
+    if (!NAME.test(raw)) {
+        throw new UsageError(`'${raw}' is not a wallet name: up to 64 lowercase letters, digits, - and _, starting with ` +
+            "a letter or digit");
+    }
+    return raw;
+}
+/** A Solana keypair's 64 bytes as text: the JSON array a keypair file holds. */
+export const keypairText = (bytes) => JSON.stringify([...bytes]);
+/** Registers every spelling of a Solana keypair as a secret: its JSON array, base58 and hex. */
+function secretKeypair(bytes) {
+    secret(keypairText(bytes));
+    secret(getBase58Decoder().decode(bytes));
+    secret(bytesToHex(bytes));
+    secret(getBase58Decoder().decode(bytes.subarray(0, 32)));
+}
+/** A fresh ed25519 keypair as solana-keygen writes it: the 32-byte seed, then the public key. */
+function newSolanaKeypair() {
+    const { privateKey, publicKey } = generateKeyPairSync("ed25519");
+    const seed = privateKey.export({ format: "der", type: "pkcs8" }).subarray(-32);
+    const pub = publicKey.export({ format: "der", type: "spki" }).subarray(-32);
+    const bytes = new Uint8Array([...seed, ...pub]);
+    seed.fill(0);
+    return bytes;
+}
+/** The keypair `bytes` hold, checked: its public half must be its seed's. */
+async function solanaSigner(bytes, what) {
+    if (bytes.length !== 64)
+        throw new CliError(`${what} does not hold a 64-byte Solana keypair`);
+    try {
+        return await createKeyPairSignerFromBytes(bytes);
+    }
+    catch {
+        throw new CliError(`${what}: its 64 bytes are not an ed25519 keypair`);
+    }
+}
+/**
+ * What an import's text is: a v3 keystore (decrypted with `password`, which the wallet then keeps),
+ * a Solana keypair file (a JSON array of 64 bytes) or its base58 spelling, or a raw EVM private key
+ * (32 bytes of hex). The text is a secret from the start; it is never quoted back.
+ */
+export function readImport(text, password, from) {
+    const trimmed = text.trim();
+    secret(trimmed);
+    if (trimmed.startsWith("{")) {
+        const { kind, bytes } = decryptKeystoreBytes(trimmed, password);
+        return { kind, bytes };
+    }
+    if (trimmed.startsWith("[")) {
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            parsed = undefined;
+        }
+        if (!Array.isArray(parsed) ||
+            parsed.length !== 64 ||
+            !parsed.every((byte) => Number.isInteger(byte) && byte >= 0 && byte <= 255)) {
+            throw new UsageError(`${from}: not a Solana keypair file (a JSON array of 64 bytes, as solana-keygen writes)`);
+        }
+        const bytes = Uint8Array.from(parsed);
+        secretKeypair(bytes);
+        return { kind: "solana", bytes };
+    }
+    if (/^(?:0x)?[0-9a-fA-F]{64}$/.test(trimmed)) {
+        return { kind: "evm", bytes: hexToBytes(parsePrivateKey(trimmed, from)) };
+    }
+    if (/^[1-9A-HJ-NP-Za-km-z]{80,90}$/.test(trimmed)) {
+        const bytes = new Uint8Array(getBase58Encoder().encode(trimmed));
+        if (bytes.length === 64) {
+            secretKeypair(bytes);
+            return { kind: "solana", bytes };
+        }
+    }
+    throw new UsageError(`${from} holds no key this command reads: a keystore (JSON), a Solana keypair (a JSON array ` +
+        "of 64 bytes, or its base58), or an EVM private key (32 bytes of hex)");
+}
+/** The `address` a wallet's file names: hex without 0x (as geth writes it), or base58. */
+async function addressOf(kind, bytes) {
+    if (kind === "evm") {
+        return privateKeyToAccount(bytesToHex(bytes))
+            .address.slice(2)
+            .toLowerCase();
+    }
+    return (await solanaSigner(bytes, "the key")).address;
+}
+export class WalletStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    file(name) {
+        return join(this.dir, `${walletName(name)}.json`);
+    }
+    /** The wallet `name`, as its file names it; an error naming the directory when there is none. */
+    info(name) {
+        const path = this.file(name);
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+        }
+        catch (error) {
+            throw new CliError(error.code === "ENOENT"
+                ? `no wallet ${name} in ${this.dir}: \`sauce wallet list\` names them, and ` +
+                    `\`sauce wallet new ${name}\` creates one`
+                : `${path} is unreadable`);
+        }
+        return this.parse(name, path, text);
+    }
+    parse(name, path, text) {
+        let kind;
+        let field;
+        try {
+            kind = keystoreKind(text);
+            field = JSON.parse(text).address;
+        }
+        catch {
+            throw new CliError(`${path} is not a wallet's keystore`);
+        }
+        let address;
+        if (kind === "evm" && typeof field === "string") {
+            const spelled = field.startsWith("0x") ? field : `0x${field}`;
+            if (isAddress(spelled, { strict: false }))
+                address = getAddress(spelled);
+        }
+        if (kind === "solana" && typeof field === "string" && isSolanaAddress(field))
+            address = field;
+        if (address === undefined)
+            throw new CliError(`${path} names no address`);
+        return { name, kind, address, path, policyPath: join(this.dir, `${name}.policy.json`) };
+    }
+    /** Every wallet the directory holds, and a warning for each file there it cannot read. */
+    list() {
+        let names;
+        try {
+            names = readdirSync(this.dir);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return { wallets: [], warnings: [] };
+            throw error;
+        }
+        const wallets = [];
+        const warnings = [];
+        for (const file of names.sort()) {
+            const name = /^([a-z0-9][a-z0-9_-]{0,63})\.json$/.exec(file)?.[1];
+            if (name === undefined)
+                continue;
+            try {
+                wallets.push(this.info(name));
+            }
+            catch (error) {
+                warnings.push(`warning: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return { wallets, warnings };
+    }
+    /** Creates the directory, owner-only, and warns when one that exists lets others in. */
+    ensureDir() {
+        mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+        if (process.platform === "win32")
+            return [];
+        const mode = statSync(this.dir).mode & 0o777;
+        return (mode & 0o077) === 0
+            ? []
+            : [
+                `warning: ${this.dir} is open to others (mode ${mode.toString(8)}): each wallet file is ` +
+                    `yours alone, but \`chmod 700 ${this.dir}\` keeps their names private too`,
+            ];
+    }
+    /** Writes `text` as wallet `name`, once: never over a wallet that exists. */
+    write(name, text) {
+        const warnings = this.ensureDir();
+        const final = this.file(name);
+        const temporary = join(this.dir, `.${name}.json.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`);
+        writeFileSync(temporary, text, { flag: "wx", mode: 0o600 });
+        try {
+            chmodSync(temporary, 0o600);
+            linkSync(temporary, final);
+        }
+        catch (error) {
+            if (error.code === "EEXIST") {
+                throw new CliError(`wallet ${name} exists in ${this.dir}: a wallet is never overwritten (pick another name)`, { cause: error });
+            }
+            throw error;
+        }
+        finally {
+            unlinkSync(temporary);
+        }
+        return warnings;
+    }
+    /** Stores `bytes` (32 bytes for EVM, a 64-byte keypair for Solana) as wallet `name`. */
+    async store(name, kind, bytes, password) {
+        walletName(name);
+        // Held here, where every wallet is created — the CLI and the MCP server alike.
+        if ([...password].length < MIN_PASSWORD) {
+            throw new UsageError(`a wallet's password is ${MIN_PASSWORD} characters at least: its key is encrypted under it ` +
+                "on disk");
+        }
+        if (kind === "evm" && bytes.length !== 32)
+            throw new CliError("an EVM key is 32 bytes");
+        if (kind === "solana") {
+            secretKeypair(bytes);
+            await solanaSigner(bytes, "the keypair");
+        }
+        else {
+            secret(bytesToHex(bytes));
+        }
+        const address = await addressOf(kind, bytes);
+        const warnings = this.write(name, encryptKeystore(bytes, password, { kind, address }));
+        return { info: this.info(name), warnings };
+    }
+    /** A new wallet `name` with a fresh key. */
+    create(name, kind, password) {
+        const bytes = kind === "evm" ? hexToBytes(generatePrivateKey()) : newSolanaKeypair();
+        return this.store(name, kind, bytes, password).finally(() => bytes.fill(0));
+    }
+    /** The wallet's key, decrypted with `password`: what `export` shows, and nothing else reads. */
+    secretOf(name, password) {
+        const info = this.info(name);
+        const { kind, bytes } = decryptKeystoreBytes(readFileSync(info.path, "utf8"), password);
+        if (kind === "solana")
+            secretKeypair(bytes);
+        return { kind, bytes };
+    }
+    /** The wallet unlocked with `password`: its signer. */
+    async unlock(name, password) {
+        const info = this.info(name);
+        const { kind, bytes } = this.secretOf(name, password);
+        try {
+            if (kind === "evm") {
+                if (bytes.length !== 32)
+                    throw new CliError(`${info.path} does not hold a 32-byte key`);
+                const account = privateKeyToAccount(bytesToHex(bytes));
+                if (account.address !== info.address) {
+                    throw new CliError(`${info.path} holds the key of ${account.address}, not ${info.address}`);
+                }
+                return { kind, info, account };
+            }
+            const signer = await solanaSigner(bytes, info.path);
+            if (signer.address !== info.address) {
+                throw new CliError(`${info.path} holds the keypair of ${signer.address}, not ${info.address}`);
+            }
+            return { kind, info, signer };
+        }
+        finally {
+            bytes.fill(0);
+        }
+    }
+}
+/** The address `info` names, as an EVM address; refuses a Solana wallet. */
+export const evmAddressOf = (info) => {
+    if (info.kind !== "evm") {
+        throw new UsageError(`wallet ${info.name} is a Solana wallet: an EVM transaction is signed by an EVM wallet`);
+    }
+    return getAddress(info.address);
+};
+//# sourceMappingURL=wallets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallets.js","sourceRoot":"","sources":["../../src/cli/wallets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,SAAS,EACT,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,IAAI,eAAe,GAE7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAA0B,MAAM,MAAM,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA0B,MAAM,eAAe,CAAC;AAEhG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,MAAM,GAEP,MAAM,aAAa,CAAC;AAErB,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEpF,6FAA6F;AAC7F,MAAM,IAAI,GAAG,4BAA4B,CAAC;AAsB1C,gCAAgC;AAChC,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,UAAU,CAClB,IAAI,GAAG,qFAAqF;YAC1F,mBAAmB,CACtB,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAErF,gGAAgG;AAChG,SAAS,aAAa,CAAC,KAAiB;IACtC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,iGAAiG;AACjG,SAAS,gBAAgB;IACvB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEb,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,KAAK,UAAU,YAAY,CAAC,KAAiB,EAAE,IAAY;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IAC9F,IAAI,CAAC;QACH,OAAO,MAAM,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB,EAAE,IAAY;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IAChB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEhE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,MAAM,CAAC,MAAM,KAAK,EAAE;YACpB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC,EAC3E,CAAC;YACD,MAAM,IAAI,UAAU,CAClB,GAAG,IAAI,iFAAiF,CACzF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAkB,CAAC,CAAC;QAClD,aAAa,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACxB,aAAa,CAAC,KAAK,CAAC,CAAC;YAErB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,UAAU,CAClB,GAAG,IAAI,sFAAsF;QAC3F,sEAAsE,CACzE,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,KAAK,UAAU,SAAS,CAAC,IAAgB,EAAE,KAAiB;IAC1D,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAQ,CAAC;aACjD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;aAChB,WAAW,EAAE,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED,MAAM,OAAO,WAAW;IACb,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,iGAAiG;IACjG,IAAI,CAAC,IAAY;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CACf,KAA2B,CAAC,IAAI,KAAK,QAAQ;gBAC5C,CAAC,CAAC,aAAa,IAAI,OAAO,IAAI,CAAC,GAAG,0CAA0C;oBACxE,sBAAsB,IAAI,gBAAgB;gBAC9C,CAAC,CAAC,GAAG,IAAI,gBAAgB,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY;QACpD,IAAI,IAAgB,CAAC;QACrB,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC1B,KAAK,GAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC,OAAO,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9D,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,KAAK,CAAC;QAC9F,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;QAE1E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC;IAC1F,CAAC;IAED,0FAA0F;IAC1F,IAAI;QACF,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACzF,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,wFAAwF;IAChF,SAAS;QACf,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;QAE7C,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,YAAY,IAAI,CAAC,GAAG,4BAA4B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB;oBACvF,gCAAgC,IAAI,CAAC,GAAG,kCAAkC;aAC7E,CAAC;IACR,CAAC;IAED,6EAA6E;IACrE,KAAK,CAAC,IAAY,EAAE,IAAY;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CACpB,IAAI,CAAC,GAAG,EACR,IAAI,IAAI,SAAS,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAC1E,CAAC;QACF,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC5B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnD,MAAM,IAAI,QAAQ,CAChB,UAAU,IAAI,cAAc,IAAI,CAAC,GAAG,qDAAqD,EACzF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,KAAK,CACT,IAAY,EACZ,IAAgB,EAChB,KAAiB,EACjB,QAAgB;QAEhB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,+EAA+E;QAC/E,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAClB,0BAA0B,YAAY,sDAAsD;gBAC1F,SAAS,CACZ,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAEvF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,4CAA4C;IAC5C,MAAM,CACJ,IAAY,EACZ,IAAgB,EAChB,QAAgB;QAEhB,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAErF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,gGAAgG;IAChG,QAAQ,CAAC,IAAY,EAAE,QAAgB;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,QAAQ;YAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QAE5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,QAAgB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;oBAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,8BAA8B,CAAC,CAAC;gBACxF,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAQ,CAAC,CAAC;gBAC9D,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;oBACrC,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,CAAC,IAAI,qBAAqB,OAAO,CAAC,OAAO,SAAS,IAAI,CAAC,OAAO,EAAE,CACxE,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACjC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACpC,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,CAAC,IAAI,yBAAyB,MAAM,CAAC,OAAO,SAAS,IAAI,CAAC,OAAO,EAAE,CAC3E,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAgB,EAAW,EAAE;IACxD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,UAAU,IAAI,CAAC,IAAI,oEAAoE,CACxF,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/sdk/dist/deployments/index.d.ts

@@ -1,66 +1,8 @@
 /**
- * Pinned release addresses and a separate historical chain roster. Address functions and
- * `v12Deployment` read `V12Deployments.json`; chain flags/slugs describe the older roster and
- * require on-chain verification before use. Exported legacy address constants remain for compatibility.
+ * `@eco-incorp/sauce/deployments` — the addresses of the pinned v12 releases, read from
+ * `V12Deployments.json` (see `v12-addresses.ts`). They are ADDRESSES, not liveness: the SDK reads no
+ * chain, so check for code on the target chain before relying on one.
  */
-import { V12_EVM_CHAINS, V12_EVM_CONTRACTS, V12_GENERATED_BY, V12_SALT, V12_SVM } from "./v12.generated.js";
-export { V12_EVM_CHAINS, V12_EVM_CONTRACTS, V12_GENERATED_BY, V12_SALT, V12_SVM };
+export * from "./releases.js";
 export * from "./v12-addresses.js";
-/** The pinned release's three chain-invariant EVM contract addresses. */
-export interface V12EvmContracts {
-    /** Swap surface every Pot's fallback delegatecalls into. */
-    router: string;
-    /** The Huff interpreter runtime that executes Sauce bytecode. */
-    v12Runtime: string;
-    /** Factory — mint a Pot via `deployPot(owner, salt)`. */
-    v12Kitchen: string;
-}
-/** One chain's deploy outcome, as recorded by the engine's deploy script. */
-export interface V12ChainDeployment {
-    chainId: number;
-    /** Engine-side chain slug (e.g. `'base'`) — not necessarily the SDK's chain name. */
-    name: string;
-    /** Historical deployment outcome; does not attest the pinned release's current liveness. */
-    live: boolean;
-    status: string;
-    /** Present only for a failed deploy. */
-    error?: string;
-}
-/** Pinned release addresses for a chain in the historical successful-deployment roster. */
-export interface V12Deployment extends V12EvmContracts {
-    chainId: number;
-    name: string;
-}
-/** Every chain id in the record, live or not, ascending. */
-export declare function v12ChainIds(): number[];
-/** Historically successful chain ids, ascending. Check current release code before use. */
-export declare function v12LiveChainIds(): number[];
-/** Chain ids present in the record whose deploy did NOT land. */
-export declare function v12FailedChainIds(): number[];
-/** Historical success flag; not an RPC check or proof that the pinned release is deployed. */
-export declare function isV12Live(chainId: number): boolean;
-/** The raw per-chain record (including a failed chain's `error`), or undefined if unknown. */
-export declare function v12ChainDeployment(chainId: number): V12ChainDeployment | undefined;
-/**
- * Engine-side chain slug from a historically successful deployment record. This is not a
- * current release liveness check or an attestation of a routing provider's chain coverage.
- */
-export declare function v12ChainSlug(chainId: number): string | undefined;
-/**
- * Every live v12 chain as a `chainId → slug` map, ascending — the direct
- * replacement for a hand-maintained slug constant. Excludes chains whose deploy
- * did not land (see {@link v12FailedChainIds}).
- */
-export declare function v12LiveChainSlugs(): Record<number, string>;
-/**
- * Pinned release addresses for a historically successful chain, otherwise undefined.
- * The legacy roster does not attest that this release is deployed: verify code on the target chain.
- */
-export declare function v12Deployment(chainId: number): V12Deployment | undefined;
-/** Like {@link v12Deployment}, but throws with the reason instead of returning undefined. */
-export declare function requireV12Deployment(chainId: number): V12Deployment;
-/** @deprecated Legacy engine program id. Use `v12SvmEngineProgramId()` for the pinned release. */
-export declare const v12SvmProgramId: string;
-/** Historical SVM cluster coverage; not an attestation of the pinned release's deployment. */
-export declare function isV12SvmDeployed(cluster: string): boolean;
 //# sourceMappingURL=index.d.ts.map

package/sdk/dist/deployments/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployments/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACR,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAGlF,cAAc,oBAAoB,CAAC;AAEnC,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,4DAA4D;AAC5D,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAItC;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAGlF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAUxE;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAcnE;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AAEzD,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployments/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/sdk/dist/deployments/index.js

@@ -1,88 +1,8 @@
 /**
- * Pinned release addresses and a separate historical chain roster. Address functions and
- * `v12Deployment` read `V12Deployments.json`; chain flags/slugs describe the older roster and
- * require on-chain verification before use. Exported legacy address constants remain for compatibility.
+ * `@eco-incorp/sauce/deployments` — the addresses of the pinned v12 releases, read from
+ * `V12Deployments.json` (see `v12-addresses.ts`). They are ADDRESSES, not liveness: the SDK reads no
+ * chain, so check for code on the target chain before relying on one.
  */
-import { V12_EVM_CHAINS, V12_EVM_CONTRACTS, V12_GENERATED_BY, V12_SALT, V12_SVM, } from "./v12.generated.js";
-import { v12EngineAddress, v12KitchenAddress, v12RouterAddress } from "./v12-addresses.js";
-export { V12_EVM_CHAINS, V12_EVM_CONTRACTS, V12_GENERATED_BY, V12_SALT, V12_SVM };
-// The pinned release addresses, assembled from each release's addresses.json (see the header split).
+export * from "./releases.js";
 export * from "./v12-addresses.js";
-const CHAINS = V12_EVM_CHAINS;
-/** Every chain id in the record, live or not, ascending. */
-export function v12ChainIds() {
-    return Object.keys(CHAINS)
-        .map(Number)
-        .sort((a, b) => a - b);
-}
-/** Historically successful chain ids, ascending. Check current release code before use. */
-export function v12LiveChainIds() {
-    return v12ChainIds().filter((id) => CHAINS[id].live);
-}
-/** Chain ids present in the record whose deploy did NOT land. */
-export function v12FailedChainIds() {
-    return v12ChainIds().filter((id) => !CHAINS[id].live);
-}
-/** Historical success flag; not an RPC check or proof that the pinned release is deployed. */
-export function isV12Live(chainId) {
-    return CHAINS[chainId]?.live === true;
-}
-/** The raw per-chain record (including a failed chain's `error`), or undefined if unknown. */
-export function v12ChainDeployment(chainId) {
-    const c = CHAINS[chainId];
-    return c === undefined ? undefined : { chainId, ...c };
-}
-/**
- * Engine-side chain slug from a historically successful deployment record. This is not a
- * current release liveness check or an attestation of a routing provider's chain coverage.
- */
-export function v12ChainSlug(chainId) {
-    const c = CHAINS[chainId];
-    return c === undefined || !c.live ? undefined : c.name;
-}
-/**
- * Every live v12 chain as a `chainId → slug` map, ascending — the direct
- * replacement for a hand-maintained slug constant. Excludes chains whose deploy
- * did not land (see {@link v12FailedChainIds}).
- */
-export function v12LiveChainSlugs() {
-    const out = {};
-    for (const id of v12LiveChainIds())
-        out[id] = CHAINS[id].name;
-    return out;
-}
-/**
- * Pinned release addresses for a historically successful chain, otherwise undefined.
- * The legacy roster does not attest that this release is deployed: verify code on the target chain.
- */
-export function v12Deployment(chainId) {
-    const c = CHAINS[chainId];
-    if (c === undefined || !c.live)
-        return undefined;
-    return {
-        chainId,
-        name: c.name,
-        router: v12RouterAddress(),
-        v12Runtime: v12EngineAddress(),
-        v12Kitchen: v12KitchenAddress(),
-    };
-}
-/** Like {@link v12Deployment}, but throws with the reason instead of returning undefined. */
-export function requireV12Deployment(chainId) {
-    const found = v12Deployment(chainId);
-    if (found !== undefined)
-        return found;
-    const c = CHAINS[chainId];
-    if (c === undefined) {
-        throw new Error(`Sauce v12 has no historical deployment record for chain ${chainId} (known chains: ${v12ChainIds().join(", ")})`);
-    }
-    throw new Error(`Sauce v12's historical deployment failed on chain ${chainId} (${c.name}): status '${c.status}'` +
-        (c.error === undefined ? "" : ` — ${c.error}`));
-}
-/** @deprecated Legacy engine program id. Use `v12SvmEngineProgramId()` for the pinned release. */
-export const v12SvmProgramId = V12_SVM.programId;
-/** Historical SVM cluster coverage; not an attestation of the pinned release's deployment. */
-export function isV12SvmDeployed(cluster) {
-    return Object.prototype.hasOwnProperty.call(V12_SVM.clusters, cluster);
-}
 //# sourceMappingURL=index.js.map

package/sdk/dist/deployments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deployments/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deployments/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/sdk/dist/deployments/pot.d.ts

@@ -2,9 +2,9 @@
  * Where a Sauce Pot lives, without asking a chain.
  *
  * A Pot is CREATE2 from the Kitchen, so its address is a pure function of its OWNER and a salt —
- * `V12Deployments.json` ships the deployer and init-code hash that complete the formula, and
- * `V12EngineGate.json` records the Kitchen the released engine will accept Pots from. Nothing here
- * reads the network.
+ * `V12Deployments.json` ships the deployer (the Kitchen proxy) and the init-code hash that complete
+ * the formula, both from the kitchen release's own `addresses.json`; the sync refuses a Kitchen or a
+ * hash that is not the one the released engine gates on. Nothing here reads the network.
  *
  * DERIVING IS NOT DEPLOYING. The address exists as arithmetic the moment you know the owner; the
  * contract exists once somebody has called the Kitchen's `deployPot`, a permissionless call per
@@ -26,14 +26,24 @@ import { type Hex } from "viem";
  * for the production Portal.
  */
 export declare const SAUCE_INTENT_POT_SALT: Hex;
-/** The Kitchen the released engine accepts Pots from — the one its gate re-derives against. */
-export declare const v12GateKitchen: () => Hex;
+/**
+ * The salt of the Pot an owner names `label`: `keccak256(utf8(label))`.
+ *
+ * An owner has one Pot per salt. The zero salt ({@link SAUCE_INTENT_POT_SALT}) is the convention
+ * for the one Pot an owner has by default — the one the solver deploys and every intent derives —
+ * and a label names any other: `v12PredictPot(owner, potSalt("treasury"))`. Hashing gives any label
+ * a full 32-byte salt, the same everywhere: the `sauce` command's `--salt treasury` is this. An
+ * exact salt needs no helper; pass the 32 bytes to `v12PredictPot` as they are.
+ */
+export declare function potSalt(label: string): Hex;
 /**
  * `CREATE2(kitchen, keccak256(abi.encode(owner, salt)), initCodeHash)` — the formula
- * `V12Deployments.json` records, applied.
+ * `V12Deployments.json` records, applied. `kitchen` defaults to the pinned release's Kitchen proxy,
+ * the Pots' deployer; the init-code hash is always the pinned release's, never a constant here.
  *
  * Chain-independent, like every CREATE2 address: the same owner and salt give the same Pot on every
- * chain the Kitchen is deployed at that address on.
+ * chain the Kitchen is deployed at that address on. A Kitchen upgrade that moves the init-code hash
+ * moves every Pot minted after it — the reason this reads the hash from the release.
  */
 export declare function v12PredictPot(owner: Hex, salt?: Hex, kitchen?: Hex): Hex;
 //# sourceMappingURL=pot.d.ts.map

package/sdk/dist/deployments/pot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pot.d.ts","sourceRoot":"","sources":["../../src/deployments/pot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAiE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAK/F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,EAAE,GAA4B,CAAC;AAEjE,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAO,GAA+D,CAAC;AAElG;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,GAAG,EACV,IAAI,GAAE,GAA2B,EACjC,OAAO,GAAE,GAAsB,GAC9B,GAAG,CAUL"}
+{"version":3,"file":"pot.d.ts","sourceRoot":"","sources":["../../src/deployments/pot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAML,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAId;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,EAAE,GAA4B,CAAC;AAEjE;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAS1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,GAAG,EACV,IAAI,GAAE,GAA2B,EACjC,OAAO,GAAE,GAAoD,GAC5D,GAAG,CAUL"}