@eco-incorp/sauce 0.99.0

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

@@ -0,0 +1,90 @@
+/**
+ * WHERE THE DEPLOYED SAUCE v12 STACK LIVES.
+ *
+ * The package already shipped the engine's ABIs (`sdk/dist/artifacts/`) and the
+ * v12 runtime creation code, but not the ADDRESSES of the deployed contracts —
+ * so a consumer could encode a call and had nowhere to send it, and
+ * `createSauceSvmClient` (which takes a required `programId`) had no default to
+ * offer. This module closes that with the addresses in `v12.generated.ts`, which
+ * record the PREVIOUS deployment: the pinned releases publish an `addresses.json`
+ * naming the current Kitchen and Router, and they are not these. See that file's
+ * header before relying on any of them.
+ *
+ * The addresses are chain-invariant — the same on every chain they were deployed
+ * to — which is why this exposes one flat address set plus per-chain liveness
+ * rather than repeating the same three addresses twelve times. Do not read that
+ * as "the stack is live everywhere": liveness is per chain, and one chain in the
+ * record is not live (see `v12FailedChainIds`).
+ */
+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 };
+/** The 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;
+    /** The only field to gate on. False means the stack is NOT usable on this chain. */
+    live: boolean;
+    status: string;
+    /** Present only for a failed deploy. */
+    error?: string;
+}
+/** A resolved, usable deployment: the addresses plus which chain they are live on. */
+export interface V12Deployment extends V12EvmContracts {
+    chainId: number;
+    name: string;
+}
+/** Every chain id in the record, live or not, ascending. */
+export declare function v12ChainIds(): number[];
+/** Chain ids where the stack is live and usable, ascending. */
+export declare function v12LiveChainIds(): number[];
+/** Chain ids present in the record whose deploy did NOT land. */
+export declare function v12FailedChainIds(): number[];
+/** True only when the stack is live on `chainId`. */
+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;
+/**
+ * The Sauce Recipes API chain slug (its `chain=` query param, e.g. `'base'`) for
+ * `chainId`, or undefined when the v12 stack is not live there.
+ *
+ * The slug IS the engine-side chain name from the pinned deploy record, which by
+ * construction equals the API's pool-config key — both derive from the same
+ * `deployments/v12.json` `evm.chains` id map — so a consumer can gate provider
+ * capability AND build the API URL from ONE source, with no hand-maintained
+ * chainId→slug table to drift (and go stale the next time a chain is added).
+ * Gated on `live` for the same reason as {@link v12Deployment}: a chain with no
+ * Kitchen has no Pot to cook on, so emitting a slug there would misreport a
+ * permanent deployment gap as a servable route.
+ */
+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>;
+/**
+ * Addresses for `chainId`, or undefined when the stack is not live there.
+ *
+ * Returns undefined rather than the addresses for a non-live chain on purpose:
+ * the addresses are chain-invariant, so they are non-null even where nothing is
+ * deployed, and handing them back would point callers at empty accounts.
+ */
+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;
+/** The SVM engine program id — pass as `programId` to `createSauceSvmClient`. */
+export declare const v12SvmProgramId: string;
+/** True if the SVM engine is deployed on `cluster` (`'devnet'` | `'mainnet-beta'`). */
+export declare function isV12SvmDeployed(cluster: string): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployments/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACR,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAElF,wDAAwD;AACxD,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,oFAAoF;IACpF,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sFAAsF;AACtF,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,+DAA+D;AAC/D,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAGlF;AAED;;;;;;;;;;;;GAYG;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;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAIxE;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAcnE;AAED,iFAAiF;AACjF,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AAEzD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/sdk/dist/deployments/index.js

@@ -0,0 +1,104 @@
+/**
+ * WHERE THE DEPLOYED SAUCE v12 STACK LIVES.
+ *
+ * The package already shipped the engine's ABIs (`sdk/dist/artifacts/`) and the
+ * v12 runtime creation code, but not the ADDRESSES of the deployed contracts —
+ * so a consumer could encode a call and had nowhere to send it, and
+ * `createSauceSvmClient` (which takes a required `programId`) had no default to
+ * offer. This module closes that with the addresses in `v12.generated.ts`, which
+ * record the PREVIOUS deployment: the pinned releases publish an `addresses.json`
+ * naming the current Kitchen and Router, and they are not these. See that file's
+ * header before relying on any of them.
+ *
+ * The addresses are chain-invariant — the same on every chain they were deployed
+ * to — which is why this exposes one flat address set plus per-chain liveness
+ * rather than repeating the same three addresses twelve times. Do not read that
+ * as "the stack is live everywhere": liveness is per chain, and one chain in the
+ * record is not live (see `v12FailedChainIds`).
+ */
+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 };
+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);
+}
+/** Chain ids where the stack is live and usable, ascending. */
+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);
+}
+/** True only when the stack is live on `chainId`. */
+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 };
+}
+/**
+ * The Sauce Recipes API chain slug (its `chain=` query param, e.g. `'base'`) for
+ * `chainId`, or undefined when the v12 stack is not live there.
+ *
+ * The slug IS the engine-side chain name from the pinned deploy record, which by
+ * construction equals the API's pool-config key — both derive from the same
+ * `deployments/v12.json` `evm.chains` id map — so a consumer can gate provider
+ * capability AND build the API URL from ONE source, with no hand-maintained
+ * chainId→slug table to drift (and go stale the next time a chain is added).
+ * Gated on `live` for the same reason as {@link v12Deployment}: a chain with no
+ * Kitchen has no Pot to cook on, so emitting a slug there would misreport a
+ * permanent deployment gap as a servable route.
+ */
+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;
+}
+/**
+ * Addresses for `chainId`, or undefined when the stack is not live there.
+ *
+ * Returns undefined rather than the addresses for a non-live chain on purpose:
+ * the addresses are chain-invariant, so they are non-null even where nothing is
+ * deployed, and handing them back would point callers at empty accounts.
+ */
+export function v12Deployment(chainId) {
+    const c = CHAINS[chainId];
+    if (c === undefined || !c.live)
+        return undefined;
+    return { chainId, name: c.name, ...V12_EVM_CONTRACTS };
+}
+/** 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 is not deployed on chain ${chainId} (known chains: ${v12ChainIds().join(", ")})`);
+    }
+    throw new Error(`Sauce v12 is not live on chain ${chainId} (${c.name}): status '${c.status}'` +
+        (c.error === undefined ? "" : ` — ${c.error}`));
+}
+/** The SVM engine program id — pass as `programId` to `createSauceSvmClient`. */
+export const v12SvmProgramId = V12_SVM.programId;
+/** True if the SVM engine is deployed on `cluster` (`'devnet'` | `'mainnet-beta'`). */
+export function isV12SvmDeployed(cluster) {
+    return Object.prototype.hasOwnProperty.call(V12_SVM.clusters, cluster);
+}
+//# sourceMappingURL=index.js.map

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

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

package/sdk/dist/deployments/v12.generated.d.ts

@@ -0,0 +1,95 @@
+/** CREATE2 salt the stack was deployed with. */
+export declare const V12_SALT: "0x0000000000000000000000000000000000000000000000000000000000000001";
+/** Which tool in the engine repo produced the underlying record. */
+export declare const V12_GENERATED_BY: "dev-tools/scripts/deploy-v12.ts";
+/** Chain-invariant EVM addresses (identical on every chain — see the note above). */
+export declare const V12_EVM_CONTRACTS: {
+    readonly router: "0x20BbEc03eE401B26938880cd23Aac00Cf927F06a";
+    readonly v12Runtime: "0x3dfE79fBB6C62D00986F476c3F86E7D19E0cabeD";
+    readonly v12Kitchen: "0xd57b452634c653D80A85160fea895BB07Ac41D8F";
+};
+/** Per-chain deploy outcome. `live` is the only field callers should gate on. */
+export declare const V12_EVM_CHAINS: {
+    readonly 1: {
+        readonly name: "ethereum";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 10: {
+        readonly name: "optimism";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 56: {
+        readonly name: "bsc";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 130: {
+        readonly name: "unichain";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 137: {
+        readonly name: "polygon";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 143: {
+        readonly name: "monad";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 146: {
+        readonly name: "sonic";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 2020: {
+        readonly name: "ronin";
+        readonly live: false;
+        readonly status: "failed";
+        readonly error: "Contracts deployed with a Solidity version equal or higher than 0.8.20 might not work properly. For more information, please see https://eips.ethereum.org/EIPS/eip-3855 Error: Failed to send transacti";
+    };
+    readonly 8453: {
+        readonly name: "base";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 9745: {
+        readonly name: "plasma";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 42161: {
+        readonly name: "arbitrum";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 42220: {
+        readonly name: "celo";
+        readonly live: true;
+        readonly status: "live";
+    };
+    readonly 57073: {
+        readonly name: "ink";
+        readonly live: true;
+        readonly status: "live";
+    };
+};
+/** The SVM engine program (non-upgradeable when `upgradeable` is false). */
+export declare const V12_SVM: {
+    readonly programId: "CuHCniNMWLSkZWBQKon9tudGujZeXJRUwG2PCLDq4ipJ";
+    readonly upgradeable: false;
+    readonly clusters: {
+        readonly devnet: {
+            readonly cluster: "devnet";
+            readonly status: "already-deployed";
+        };
+        readonly 'mainnet-beta': {
+            readonly cluster: "mainnet-beta";
+            readonly status: "already-deployed";
+        };
+    };
+};
+//# sourceMappingURL=v12.generated.d.ts.map

package/sdk/dist/deployments/v12.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v12.generated.d.ts","sourceRoot":"","sources":["../../src/deployments/v12.generated.ts"],"names":[],"mappings":"AAeA,gDAAgD;AAChD,eAAO,MAAM,QAAQ,EAAG,oEAA6E,CAAC;AAEtG,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,EAAG,iCAA0C,CAAC;AAE3E,qFAAqF;AACrF,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcjB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAOV,CAAC"}

package/sdk/dist/deployments/v12.generated.js

@@ -0,0 +1,50 @@
+// NOT GENERATED — hand-maintained, and nothing checks it.
+//
+// It was written by sdk/scripts/sync-engine-artifacts.mjs from the engine dep's deployments/v12.json.
+// That dep is gone. **These addresses describe the stack deployed BEFORE the engine became a `cook`
+// argument**: every pinned release now publishes an `addresses.json`, and the Kitchen and Router it
+// names are not these. In particular `v12Runtime` is an interpreter of the older lineage, which is
+// why nothing defaults to it (see routes/sauce-route.ts#SauceEvmExecutionInput.engine).
+//
+// These addresses are chain-invariant — verified identical on every chain they were deployed to —
+// which is why this is one flat address set plus per-chain liveness rather than the same three
+// addresses repeated per chain. (The mechanism is not asserted here: the current stack is CREATE3
+// per `addresses.json`, and the script that produced THIS set is gone. Determinism is the part that
+// matters.) It is also why a stale entry is dangerous rather than merely wrong: a deterministic
+// address resolves on chains where the contract it names was never deployed.
+/** CREATE2 salt the stack was deployed with. */
+export const V12_SALT = '0x0000000000000000000000000000000000000000000000000000000000000001';
+/** Which tool in the engine repo produced the underlying record. */
+export const V12_GENERATED_BY = 'dev-tools/scripts/deploy-v12.ts';
+/** Chain-invariant EVM addresses (identical on every chain — see the note above). */
+export const V12_EVM_CONTRACTS = {
+    router: '0x20BbEc03eE401B26938880cd23Aac00Cf927F06a',
+    v12Runtime: '0x3dfE79fBB6C62D00986F476c3F86E7D19E0cabeD',
+    v12Kitchen: '0xd57b452634c653D80A85160fea895BB07Ac41D8F',
+};
+/** Per-chain deploy outcome. `live` is the only field callers should gate on. */
+export const V12_EVM_CHAINS = {
+    1: { name: 'ethereum', live: true, status: 'live' },
+    10: { name: 'optimism', live: true, status: 'live' },
+    56: { name: 'bsc', live: true, status: 'live' },
+    130: { name: 'unichain', live: true, status: 'live' },
+    137: { name: 'polygon', live: true, status: 'live' },
+    143: { name: 'monad', live: true, status: 'live' },
+    146: { name: 'sonic', live: true, status: 'live' },
+    2020: { name: 'ronin', live: false, status: 'failed', error: 'Contracts deployed with a Solidity version equal or higher than 0.8.20 might not work properly. For more information, please see https://eips.ethereum.org/EIPS/eip-3855 Error: Failed to send transacti' },
+    8453: { name: 'base', live: true, status: 'live' },
+    9745: { name: 'plasma', live: true, status: 'live' },
+    42161: { name: 'arbitrum', live: true, status: 'live' },
+    42220: { name: 'celo', live: true, status: 'live' },
+    57073: { name: 'ink', live: true, status: 'live' },
+};
+/** The SVM engine program (non-upgradeable when `upgradeable` is false). */
+export const V12_SVM = {
+    programId: 'CuHCniNMWLSkZWBQKon9tudGujZeXJRUwG2PCLDq4ipJ',
+    upgradeable: false,
+    clusters: {
+        'devnet': { cluster: 'devnet', status: 'already-deployed' },
+        'mainnet-beta': { cluster: 'mainnet-beta', status: 'already-deployed' },
+    },
+};
+//# sourceMappingURL=v12.generated.js.map

package/sdk/dist/deployments/v12.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v12.generated.js","sourceRoot":"","sources":["../../src/deployments/v12.generated.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,sGAAsG;AACtG,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,wFAAwF;AACxF,EAAE;AACF,kGAAkG;AAClG,+FAA+F;AAC/F,kGAAkG;AAClG,oGAAoG;AACpG,gGAAgG;AAChG,6EAA6E;AAE7E,gDAAgD;AAChD,MAAM,CAAC,MAAM,QAAQ,GAAG,oEAA6E,CAAC;AAEtG,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,iCAA0C,CAAC;AAE3E,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,4CAA4C;IACpD,UAAU,EAAE,4CAA4C;IACxD,UAAU,EAAE,4CAA4C;CAChD,CAAC;AAEX,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACnD,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACpD,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACrD,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACpD,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAClD,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAClD,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,0MAA0M,EAAE;IACzQ,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAClD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACpD,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACvD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IACnD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;CAC1C,CAAC;AAEX,4EAA4E;AAC5E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,8CAA8C;IACzD,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE;QACR,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC3D,cAAc,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE;KACxE;CACO,CAAC"}

package/sdk/dist/deposit/format.d.ts

@@ -0,0 +1,5 @@
+/** Tiny formatting helpers shared by `templates.ts` and `source.ts` — no compiler import. */
+export declare function formatBigint(value: bigint): string;
+/** A resolved address field: `bigint` -> its numeric literal, `"self"` -> `ctx.self()`. */
+export declare function formatAddressField(value: bigint | "self"): string;
+//# sourceMappingURL=format.d.ts.map

package/sdk/dist/deposit/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/deposit/format.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEjE"}

package/sdk/dist/deposit/format.js

@@ -0,0 +1,9 @@
+/** Tiny formatting helpers shared by `templates.ts` and `source.ts` — no compiler import. */
+export function formatBigint(value) {
+    return `${value.toString()}n`;
+}
+/** A resolved address field: `bigint` -> its numeric literal, `"self"` -> `ctx.self()`. */
+export function formatAddressField(value) {
+    return value === "self" ? "ctx.self()" : formatBigint(value);
+}
+//# sourceMappingURL=format.js.map

package/sdk/dist/deposit/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/deposit/format.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC;AAChC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,111 @@
+/**
+ * `@eco-incorp/sauce`'s `deposit` module — E4.2, the universal deposit/stake/wrap adapter.
+ *
+ * There is no engine Router adapter for deposit/stake/wrap — the Router is swap+quote only. So a
+ * deposit lowers to a DIRECT protocol call in SauceScript: `token.approve(spender, amount);
+ * IProtocol.at(addr).method(...)` — the `swapAndSupply` recipe's own shape. E4.2 is therefore a
+ * PER-PROTOCOL call-template registry (`sdk/src/deposit/templates.ts`), not a dispatch into one
+ * entry point like `swap`.
+ *
+ * Two layers, both pure/sync, no compiler import (mirrors `sdk/src/swap/index.ts`'s posture):
+ *
+ *   1. {@link toDeposit} — the whole normalization/defaulting/guard decision, as a plain
+ *      `NormalizedDeposit` object (bigint scalars, the resolved `DepositTemplate` attached).
+ *   2. {@link depositCallStatement} / {@link depositSource} — pure string templating over that
+ *      object, producing SauceScript source. `depositSource` returns a complete
+ *      `function main() { ... }` program; `depositCallStatement` returns one statement block
+ *      (approve + protocol call) for splicing into a larger program.
+ *
+ * ## Composing with E4.1 (swap)
+ *
+ * {@link swapThenDepositSource} is the seam: a swap-then-deposit program is ONE `main()` with the
+ * swap statement(s) followed by the deposit statement(s) — because `V12Pot.cook` takes exactly one
+ * program, exactly like `swap`'s own multi-leg story.
+ *
+ * ```ts
+ * import { routes, deposit } from "@eco-incorp/sauce";
+ *
+ * // routes.compileSauceRoute, not the compiler directly: a generated `main` falls off the end and
+ * // has no return type of its own, so a raw compile rejects it with "`main` does not return on
+ * // every path". compileSauceRoute annotates it before compiling.
+ * const { compiled } = routes.compileSauceRoute(
+ *   "base",
+ *   deposit.depositSource({ protocol: "aave-v3", action: "supply", target: aavePool,
+ *     token: tokenIn, amount: 500n, extra: { referralCode: 0n } }),
+ *   { pot },
+ *   { baseDirs: deposit.DEPOSIT_BASE_DIRS },
+ * );
+ * // compiled.bytecode[0] -- 132 bytes for this spec
+ * ```
+ *
+ * ## Starter templates (eleven; see `templates.ts` for the full registry)
+ *
+ * - `aave-v3:supply` / `aave-v3:withdraw`, `spark:supply` / `spark:withdraw` — Aave-v3-shaped
+ *   `Pool.supply/withdraw`; Spark is a verified Aave-v3 fork with the identical selector, kept as
+ *   its own template entry for address-registry/documentation clarity.
+ * - `compound-v3:supply` — Comet's `supplyTo(dst, asset, amount)`, used unconditionally (rather
+ *   than the plain 2-arg `supply`) so a beneficiary is always representable.
+ * - `euler-v2:deposit`, `erc4626:deposit` — ERC-4626-shaped `deposit(assets, receiver)`; `erc4626`
+ *   is the universal catch-all for any 4626 vault reachable without its own template.
+ * - `lido:wrap` (wstETH, ERC20-funded), `lido:stake` (stETH `submit`, native-value — must be a raw
+ *   call, see below), and `weth:wrap` / `weth:unwrap` (WETH9, also raw — see `skippedProtocols`).
+ *
+ * ## Native vs ERC20 — why this is the one place E4.2 differs from E4.1's shape
+ *
+ * A TYPED ABI binding can never attach ETH: the compiler's non-view external-call path hardcodes
+ * `value = 0` (`compiler/src/processor/expression.ts`'s `processContractCall`), and there is no
+ * `.value()`/`{value:}` syntax anywhere in SauceScript. The only way to attach value is the raw
+ * builtin `evm.call(target, value, calldata)`. So every
+ * `funding: "native-value"` template (`weth:wrap`, `lido:stake`) emits a raw call instead of a
+ * typed one — `WETH.deposit(){value}` becomes
+ * `evm.call(<weth>, <amount>, hex`d0e30db0`)`. `weth:unwrap` is
+ * ALSO a raw call (no vendored ABI exists for WETH at all — see below) but attaches no value; its
+ * amount rides as an `abi.encode`d calldata word instead.
+ *
+ * ## `skippedProtocols` — what was left out, and why
+ *
+ * - **WETH has NO vendored SDK ABI anywhere** (there is no `weth`/`wrapped-native` protocol slug
+ *   among the SDK's ~130 entries, and `sdk/src/artifacts/` — `.gitignore`d, engine artifacts only —
+ *   could not host a hand-added one even if invented). Both WETH templates therefore use the raw
+ *   `evm.call` path with WETH9's two well-known selectors as SDK constants, forced anyway for
+ *   `wrap` (native value) and costing nothing for `unwrap`. The selectors are pinned in
+ *   `sdk/test/deposit.test.ts` against `toFunctionSelector`, so they cannot silently rot.
+ * - **`morpho-blue`'s `supply`** really does exist in the vendored ABI and does compile, but is
+ *   deliberately NOT registered: its argument list mixes a static 5-field `marketParams` tuple with
+ *   a dynamic `bytes data` field — a shape nothing in this repo has executed on-chain, against the
+ *   backdrop of a recorded, still-open v12 all-dynamic `abi.encode` head/tail framing bug — and
+ *   `supply` is assets-XOR-shares and market-keyed, which needs its own spec surface, not the flat
+ *   `{token, amount, beneficiary}` shape this module is scoped to.
+ * - **Also considered, left out:** `euler-v2` `EVCABI.enableCollateral/enableController` (position
+ *   management, not a deposit); `aave-v2`'s `LendingPoolABI.deposit` (a 5-line alias of the
+ *   registered `aave-v3:supply`, omitted to keep the starter set to current protocols);
+ *   `compound-v3`'s `withdraw`/`withdrawTo` (present, deferred so the withdraw direction lands with
+ *   one shape — Aave/Spark — first); most vault-shaped protocols not registered here are already
+ *   reachable through `erc4626:deposit`.
+ *
+ * ## Approvals
+ *
+ * `depositCallStatement` prepends `IERC20.at(token).approve(target, amount)` immediately before the
+ * protocol call whenever `funding === "erc20-approve"` — the ONE place this decision is made, so no
+ * template can emit its own approve or forget one. The spender is always the template's own
+ * `target`. `approvalPolicy` (default `"exact"`) may be `"none"` (skip — the token is already
+ * approved) or `"max"` (approve `2n**256n - 1n`; NOT the default, since a cook's approval outlives
+ * the cook — a lingering unlimited allowance is a real residual-risk change, not a gas
+ * micro-optimization). No allowance CHECK is ever emitted (a read-then-branch inside a single
+ * atomic cook is pure gas).
+ *
+ * ## Packaging note
+ *
+ * `DEPOSIT_BASE_DIRS`'s protocol-registry entry depends on the root `package.json` `files` list
+ * shipping `sdk/src/protocols` verbatim in the published package — true today, but nothing in this
+ * module enforces it going forward.
+ *
+ * See `docs/plans/2026-08-08-universal-interfaces-epic.md` for the wider epic this is E4.2 of.
+ */
+export type { Address, AddressInput, AmountInput, Hex, ApprovalPolicy, BeneficiarySupport, DepositSpec, DepositSourceSpec, DepositTemplate, ExtraFieldSpec, Funding, NormalizedDeposit, SkippedProtocolNote, } from "./types.js";
+export { DEPOSIT_TEMPLATES, depositTemplateFor, listDepositTemplates } from "./templates.js";
+export type { DepositKey } from "./templates.js";
+export { toDeposit } from "./params.js";
+export { depositCallStatement, depositImportLines, depositSource, swapThenDepositSource, DEPOSIT_BASE_DIRS, COMPOSED_BASE_DIRS, } from "./source.js";
+export type { DepositSourceOptions, SwapThenDepositOptions } from "./source.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deposit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AACH,YAAY,EACV,OAAO,EACP,YAAY,EACZ,WAAW,EACX,GAAG,EACH,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/sdk/dist/deposit/index.js

@@ -0,0 +1,4 @@
+export { DEPOSIT_TEMPLATES, depositTemplateFor, listDepositTemplates } from "./templates.js";
+export { toDeposit } from "./params.js";
+export { depositCallStatement, depositImportLines, depositSource, swapThenDepositSource, DEPOSIT_BASE_DIRS, COMPOSED_BASE_DIRS, } from "./source.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deposit/index.ts"],"names":[],"mappings":"AAwHA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/sdk/dist/deposit/params.d.ts

@@ -0,0 +1,23 @@
+import type { DepositSpec, NormalizedDeposit } from "./types.js";
+/**
+ * The whole normalization/defaulting/guard decision: lowers a chain-agnostic {@link DepositSpec}
+ * into a fully normalized {@link NormalizedDeposit} — plain bigints (+ the `"self"` sentinel for a
+ * defaulted `beneficiary`), with its resolved {@link DepositTemplate} attached.
+ *
+ * `spec.amount` may be `"balance" | "delta" | "max"` — see {@link DepositSourceSpec} — in which case
+ * it passes through unresolved (the caller, `depositCallStatement`/`swapThenDepositSource`, decides
+ * the actual amount EXPRESSION; this function only validates every OTHER field and, for `"max"`,
+ * checks `allowsMaxAmount`).
+ *
+ * Throws (never emits a program that would misbehave on-chain) for: an unknown `protocol:action`;
+ * `token` supplied to a native-value template; `token` omitted from an erc20-approve/none template;
+ * `beneficiary` supplied to a `beneficiary: "unsupported"` template; `amount: "max"` on a template
+ * with `allowsMaxAmount: false`; an unrecognized `extra` field name; an `amount` given as a `number`
+ * that is not a safe integer (past 2^53-1 pass a bigint or a string, since the double has already
+ * been rounded); and whatever the field's own `ExtraFieldSpec.normalize` throws for an out-of-range
+ * extra value.
+ */
+export declare function toDeposit(spec: DepositSpec | (Omit<DepositSpec, "amount"> & {
+    amount: "balance" | "delta" | "max";
+})): NormalizedDeposit;
+//# sourceMappingURL=params.d.ts.map

package/sdk/dist/deposit/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/deposit/params.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAkB,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAajF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAA;CAAE,CAAC,GAC1F,iBAAiB,CAqEnB"}

package/sdk/dist/deposit/params.js

@@ -0,0 +1,89 @@
+/**
+ * Normalization core for E4.2's universal deposit adapter — `toDeposit`. See
+ * `sdk/src/deposit/index.ts` for the module overview.
+ */
+import { toExactBigInt } from "../numeric.js";
+import { depositTemplateFor } from "./templates.js";
+function toAddressBigint(value, _label) {
+    if (typeof value === "bigint")
+        return value;
+    return BigInt(value);
+}
+function toBigIntStrict(value, label) {
+    if (typeof value === "bigint")
+        return value;
+    if (typeof value === "number")
+        return toExactBigInt(value, label);
+    return BigInt(value);
+}
+/**
+ * The whole normalization/defaulting/guard decision: lowers a chain-agnostic {@link DepositSpec}
+ * into a fully normalized {@link NormalizedDeposit} — plain bigints (+ the `"self"` sentinel for a
+ * defaulted `beneficiary`), with its resolved {@link DepositTemplate} attached.
+ *
+ * `spec.amount` may be `"balance" | "delta" | "max"` — see {@link DepositSourceSpec} — in which case
+ * it passes through unresolved (the caller, `depositCallStatement`/`swapThenDepositSource`, decides
+ * the actual amount EXPRESSION; this function only validates every OTHER field and, for `"max"`,
+ * checks `allowsMaxAmount`).
+ *
+ * Throws (never emits a program that would misbehave on-chain) for: an unknown `protocol:action`;
+ * `token` supplied to a native-value template; `token` omitted from an erc20-approve/none template;
+ * `beneficiary` supplied to a `beneficiary: "unsupported"` template; `amount: "max"` on a template
+ * with `allowsMaxAmount: false`; an unrecognized `extra` field name; an `amount` given as a `number`
+ * that is not a safe integer (past 2^53-1 pass a bigint or a string, since the double has already
+ * been rounded); and whatever the field's own `ExtraFieldSpec.normalize` throws for an out-of-range
+ * extra value.
+ */
+export function toDeposit(spec) {
+    const template = depositTemplateFor(spec.protocol, spec.action);
+    // A raw-call template (`binding === null`: weth:wrap, weth:unwrap, lido:stake) operates
+    // directly on `target` via a hand-built calldata word — there is no separate ERC20 asset
+    // address at all, so "token" must be omitted. Every typed-ABI template (`binding !== null`)
+    // requires one, regardless of its `funding` (even a "none"-funded typed withdraw like
+    // aave-v3:withdraw still names an `asset` argument).
+    if (template.binding === null) {
+        if (spec.token !== undefined) {
+            throw new Error(`toDeposit: ${spec.protocol}:${spec.action} is a native-value template — there is no ERC20 leg, so "token" must be omitted`);
+        }
+    }
+    else if (spec.token === undefined) {
+        throw new Error(`toDeposit: ${spec.protocol}:${spec.action} requires "token" (the asset being approved/supplied/withdrawn)`);
+    }
+    if (template.beneficiary === "unsupported" && spec.beneficiary !== undefined) {
+        throw new Error(`toDeposit: ${spec.protocol}:${spec.action} does not support a beneficiary — it always credits msg.sender; passing one would silently be ignored on-chain`);
+    }
+    const amount = spec.amount === "balance" || spec.amount === "delta" || spec.amount === "max"
+        ? spec.amount
+        : toBigIntStrict(spec.amount, "amount");
+    if (amount === "max" && !template.allowsMaxAmount) {
+        throw new Error(`toDeposit: ${spec.protocol}:${spec.action} does not document a uint256-max sentinel — "max" is only accepted where allowsMaxAmount is true`);
+    }
+    const extraInput = spec.extra ?? {};
+    for (const name of Object.keys(extraInput)) {
+        if (!(name in template.extras)) {
+            const known = Object.keys(template.extras).sort().join(", ") || "(none)";
+            throw new Error(`toDeposit: ${spec.protocol}:${spec.action} has no extra field "${name}". Known: ${known}`);
+        }
+    }
+    const extra = {};
+    for (const [name, fieldSpec] of Object.entries(template.extras)) {
+        const raw = extraInput[name];
+        extra[name] =
+            raw !== undefined ? fieldSpec.normalize(raw, `extra.${name}`) : fieldSpec.defaultValue;
+    }
+    const approvalPolicy = spec.approvalPolicy ?? "exact";
+    return {
+        template,
+        target: toAddressBigint(spec.target, "target"),
+        token: template.binding === null ? null : toAddressBigint(spec.token, "token"),
+        amount,
+        beneficiary: template.beneficiary === "unsupported"
+            ? null
+            : spec.beneficiary !== undefined
+                ? toAddressBigint(spec.beneficiary, "beneficiary")
+                : "self",
+        approvalPolicy,
+        extra,
+    };
+}
+//# sourceMappingURL=params.js.map

package/sdk/dist/deposit/params.js.map

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