@eco-incorp/sauce 0.99.0 → 0.99.2

package/sdk/dist/deployments/v12-addresses.js

@@ -0,0 +1,51 @@
+/**
+ * The deterministic addresses of the pinned Sauce v12 releases.
+ *
+ * `sync-engine-artifacts` assembles these from the `addresses.json` each of the four v12 releases
+ * publishes and writes `artifacts/V12Deployments.json` next to this module — `dist/artifacts` in an
+ * installed package, `src/artifacts` in a from-source tree — which `files: ["sdk/dist"]` carries into
+ * the tarball. It is read at runtime (like `svm/engine-artifacts.ts` reads the `.so`), not imported,
+ * so a clean `tsc` never depends on a file the sync produces.
+ *
+ * These are the deterministic addresses — CREATE3 on EVM, a fixed/derived keypair on SVM — so they are
+ * `chainIndependent` / `clusterIndependent`: one address set, the same everywhere it is deployed. They
+ * are ADDRESSES, not liveness. The legacy chain roster does not attest that these release versions
+ * are deployed; check code/programs on the target chain before use. These supersede the legacy
+ * ADDRESSES — `v12.generated.ts` records the pre-`cook` stack, and its Kitchen/Router are not these.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const ARTIFACT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "artifacts", "V12Deployments.json");
+let cached;
+/**
+ * The assembled release-address record. Read lazily and memoized, so importing this module never
+ * throws — only calling it without a synced artifact does, with a remedy in the message.
+ */
+export function v12DeployedAddresses() {
+    if (cached !== undefined)
+        return cached;
+    if (!existsSync(ARTIFACT)) {
+        throw new Error(`V12Deployments.json not found at ${ARTIFACT}. It ships in the published package; from a source ` +
+            `checkout run \`pnpm --filter './sdk' sync-engine-artifacts\`.`);
+    }
+    cached = JSON.parse(readFileSync(ARTIFACT, "utf8"));
+    return cached;
+}
+/** Legacy EVM Kitchen version. Engine versions are in `v12DeployedAddresses().releases`. */
+export const v12DeployedVersion = () => v12DeployedAddresses().version;
+/** The current EVM engine (interpreter runtime) address. */
+export const v12EngineAddress = () => v12DeployedAddresses().evm.contracts.engine.address;
+/** The current EVM Router address. */
+export const v12RouterAddress = () => v12DeployedAddresses().evm.contracts.router.address;
+/** The current EVM Kitchen (UUPS proxy) address — mints Pots and gates every cook. */
+export const v12KitchenAddress = () => v12DeployedAddresses().evm.contracts.kitchen.address;
+/** The current EVM Kitchen implementation address (behind the proxy). */
+export const v12KitchenImplementationAddress = () => v12DeployedAddresses().evm.contracts.kitchenImplementation.address;
+/** How a Pot address is derived from `(owner, salt)` under the current Kitchen. */
+export const v12PotDerivation = () => v12DeployedAddresses().evm.pot;
+/** The current SVM engine program id — pass as `programId` to `createSauceSvmClient`. */
+export const v12SvmEngineProgramId = () => v12DeployedAddresses().svm.programs.engine.programId;
+/** The current SVM Kitchen program id every cook is gated to. */
+export const v12SvmKitchenProgramId = () => v12DeployedAddresses().svm.programs.kitchen.programId;
+//# sourceMappingURL=v12-addresses.js.map

package/sdk/dist/deployments/v12-addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v12-addresses.js","sourceRoot":"","sources":["../../src/deployments/v12-addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqEzC,MAAM,QAAQ,GAAG,OAAO,CACtB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,IAAI,EACJ,WAAW,EACX,qBAAqB,CACtB,CAAC;AAEF,IAAI,MAAwC,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,qDAAqD;YAC/F,+DAA+D,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAyB,CAAC;IAC5E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,oBAAoB,EAAE,CAAC,OAAO,CAAC;AAE/E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;AAElG,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;AAElG,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;AAEpG,yEAAyE;AACzE,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAW,EAAE,CAC1D,oBAAoB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC;AAErE,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAqB,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;AAEvF,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAChD,oBAAoB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;AAEvD,iEAAiE;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAW,EAAE,CACjD,oBAAoB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC"}

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

@@ -2,13 +2,13 @@
 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). */
+/** @deprecated Legacy EVM addresses. Use v12EngineAddress/v12RouterAddress/v12KitchenAddress. */
 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. */
+/** Historical per-chain deploy outcome; does not establish current release liveness. */
 export declare const V12_EVM_CHAINS: {
     readonly 1: {
         readonly name: "ethereum";
@@ -77,7 +77,7 @@ export declare const V12_EVM_CHAINS: {
         readonly status: "live";
     };
 };
-/** The SVM engine program (non-upgradeable when `upgradeable` is false). */
+/** @deprecated Historical SVM deployment. Use v12SvmEngineProgramId for the pinned release. */
 export declare const V12_SVM: {
     readonly programId: "CuHCniNMWLSkZWBQKon9tudGujZeXJRUwG2PCLDq4ipJ";
     readonly upgradeable: false;

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

@@ -1 +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"}
+{"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,iGAAiG;AACjG,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcjB,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAOV,CAAC"}

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

@@ -16,13 +16,13 @@
 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). */
+/** @deprecated Legacy EVM addresses. Use v12EngineAddress/v12RouterAddress/v12KitchenAddress. */
 export const V12_EVM_CONTRACTS = {
     router: '0x20BbEc03eE401B26938880cd23Aac00Cf927F06a',
     v12Runtime: '0x3dfE79fBB6C62D00986F476c3F86E7D19E0cabeD',
     v12Kitchen: '0xd57b452634c653D80A85160fea895BB07Ac41D8F',
 };
-/** Per-chain deploy outcome. `live` is the only field callers should gate on. */
+/** Historical per-chain deploy outcome; does not establish current release liveness. */
 export const V12_EVM_CHAINS = {
     1: { name: 'ethereum', live: true, status: 'live' },
     10: { name: 'optimism', live: true, status: 'live' },
@@ -38,7 +38,7 @@ export const V12_EVM_CHAINS = {
     42220: { name: 'celo', live: true, status: 'live' },
     57073: { name: 'ink', live: true, status: 'live' },
 };
-/** The SVM engine program (non-upgradeable when `upgradeable` is false). */
+/** @deprecated Historical SVM deployment. Use v12SvmEngineProgramId for the pinned release. */
 export const V12_SVM = {
     programId: 'CuHCniNMWLSkZWBQKon9tudGujZeXJRUwG2PCLDq4ipJ',
     upgradeable: false,

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

@@ -1 +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"}
+{"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,iGAAiG;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,4CAA4C;IACpD,UAAU,EAAE,4CAA4C;IACxD,UAAU,EAAE,4CAA4C;CAChD,CAAC;AAEX,wFAAwF;AACxF,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,+FAA+F;AAC/F,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/index.d.ts

@@ -1,106 +1,32 @@
 /**
- * `@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.
+ * EVM deposit, withdrawal, staking, and wrapping builders for `@eco-incorp/sauce`.
+ *
+ * `toDeposit` normalizes a specification against the templates in `templates.ts`.
+ * `depositSource` emits a complete program; `depositCallStatement` emits a block for composition.
+ * These helpers construct source synchronously and do not compile or send transactions.
+ *
+ * Programs call the protocol directly. ERC-20-funded templates prepend an approval to the target;
+ * native-funded templates attach value with `evm.call(target, value, calldata)`. The executing Pot
+ * must hold the assets. WETH wrapping and unwrapping use their raw selectors.
+ *
+ * Compile generated source with `routes.compileSauceRoute`, supplying both `pot` and `engine`
+ * and `baseDirs: [...deposit.DEPOSIT_BASE_DIRS]`. The route compiler supplies a `void` annotation
+ * for a falling-through entry. `swapThenDepositSource` combines swaps and deposits in one program;
+ * compile that form with `deposit.COMPOSED_BASE_DIRS`.
+ *
+ * Query `listDepositTemplates()` for supported protocol/action pairs. Templates include Aave and
+ * Spark supply/withdrawal, Compound V3 supply, Euler/ERC-4626 deposits, Lido operations, and WETH
+ * wrapping/unwrapping. The registry does not cover every operation in the protocol catalog.
+ *
+ * The default approval policy is `exact`; `none` skips the approval and `max` grants the maximum
+ * allowance. Approvals persist after the cook. The default beneficiary is `ctx.self()` when the
+ * template supports a beneficiary. Runtime `balance` reads native ETH for native-funded templates,
+ * WETH at `target` for unwrapping, or the supplied `token` otherwise. `delta` measures that same
+ * balance against the pre-swap snapshot provided by `swapThenDepositSource`.
+ * For Aave/Spark withdrawals, use fixed amounts or `amount: "max"`: the runtime balance is the
+ * underlying token held by the Pot, not its supplied position.
+ *
+ * See `docs/guides/builders-and-actions.md` for public usage and funding requirements.
  */
 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";

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deposit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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.map

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

@@ -10,7 +10,7 @@ import type { DepositSpec, NormalizedDeposit } from "./types.js";
  * 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;
+ * `token` supplied to a raw-call template or omitted from a typed-ABI 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

package/sdk/dist/deposit/params.js

@@ -27,7 +27,7 @@ function toBigIntStrict(value, label) {
  * 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;
+ * `token` supplied to a raw-call template or omitted from a typed-ABI 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
@@ -43,7 +43,7 @@ export function toDeposit(spec) {
     // 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`);
+            throw new Error(`toDeposit: ${spec.protocol}:${spec.action} has no separate asset parameter, so "token" must be omitted; use "target" for the called contract`);
         }
     }
     else if (spec.token === undefined) {

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

@@ -1 +1 @@
-{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/deposit/params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,SAAS,eAAe,CAAC,KAAmB,EAAE,MAAc;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB,EAAE,KAAa;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CACvB,IAA2F;IAE3F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhE,wFAAwF;IACxF,yFAAyF;IACzF,4FAA4F;IAC5F,sFAAsF;IACtF,qDAAqD;IACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,iFAAiF,CAC5H,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,iEAAiE,CAC5G,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,WAAW,KAAK,aAAa,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,gHAAgH,CAC3J,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;QAC3E,CAAC,CAAC,IAAI,CAAC,MAAM;QACb,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE5C,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,kGAAkG,CAC7I,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YACzE,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,wBAAwB,IAAI,aAAa,KAAK,EAAE,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;IAC3F,CAAC;IAED,MAAM,cAAc,GAAmB,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC;IAEtE,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC9C,KAAK,EAAE,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAqB,EAAE,OAAO,CAAC;QAC9F,MAAM;QACN,WAAW,EACT,QAAQ,CAAC,WAAW,KAAK,aAAa;YACpC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC9B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;gBAClD,CAAC,CAAC,MAAM;QACd,cAAc;QACd,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/deposit/params.ts"],"names":[],"mappings":"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"}

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

@@ -28,7 +28,7 @@ export declare const COMPOSED_BASE_DIRS: readonly string[];
  */
 export declare function depositCallStatement(spec: DepositSourceSpec, varSuffix?: string): string;
 /** The import lines a `depositSource(specs)` program needs: each resolved template's own
- *  `imports`, plus `IERC20` iff any spec needs an approve or a `"balance"` ERC20 read. De-duped by
+ *  `imports`, plus `IERC20` iff any spec needs an approval or an ERC20 balance/delta read. De-duped by
  *  exact line, in first-seen order (`IERC20` first, matching `swap`'s own ordering convention). */
 export declare function depositImportLines(specs: DepositSourceSpec | readonly DepositSourceSpec[]): readonly string[];
 export interface DepositSourceOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/deposit/source.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAe,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAIpF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAG9C,CAAC;AAEF;qBACqB;AACrB,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAC;AAqDF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,SAAK,GAAG,MAAM,CASpF;AAED;;mGAEmG;AACnG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,GACtD,SAAS,MAAM,EAAE,CAqBnB;AAED,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AASD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,EACtD,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CASR;AAED,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,EACjD,QAAQ,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,EAC1D,IAAI,GAAE,sBAA2B,GAChC,MAAM,CA0ER"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/deposit/source.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAe,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAKpF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAG9C,CAAC;AAEF;qBACqB;AACrB,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAC;AA4DF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,SAAK,GAAG,MAAM,CASpF;AAED;;mGAEmG;AACnG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,GACtD,SAAS,MAAM,EAAE,CAqBnB;AAED,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AASD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,EACtD,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CASR;AAED,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,EACjD,QAAQ,EAAE,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,EAC1D,IAAI,GAAE,sBAA2B,GAChC,MAAM,CAwDR"}

package/sdk/dist/deposit/source.js

@@ -10,6 +10,7 @@ import { SWAP_BASE_DIRS, swapCallStatement, swapImportLines } from "../swap/sour
 import { formatBigint } from "./format.js";
 import { toDeposit } from "./params.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
+const MAX_UINT256 = (1n << 256n) - 1n;
 /**
  * `baseDirs` for compiling a `depositSource`/`depositCallStatement` program. Two entries, because
  * (unlike `swap`, whose only import is the engine-vendored `ISauceRouter`) a deposit template's
@@ -38,9 +39,14 @@ const IERC20_IMPORT = `import { IERC20 } from "./artifacts/IERC20.json";`;
 function needsIerc20Import(d) {
     if (d.template.funding === "erc20-approve" && d.approvalPolicy !== "none")
         return true;
-    if (d.template.binding !== null && d.amount === "balance")
-        return true;
-    return false;
+    return d.template.funding !== "native-value" && (d.amount === "balance" || d.amount === "delta");
+}
+function balanceExpression(deposit) {
+    if (deposit.template.funding === "native-value")
+        return "ctx.selfBalance()";
+    // WETH unwrap reads the target token itself; typed templates name their asset separately.
+    const token = deposit.token ?? deposit.target;
+    return `IERC20.at(${formatBigint(token)}).balanceOf(ctx.self())`;
 }
 /** The approve line(s) for a normalized deposit whose amount has already resolved to `amountExpr`
  *  (a literal or a bound identifier) — the ONE place `funding`/`approvalPolicy` is consulted, so no
@@ -50,7 +56,7 @@ function approveLines(d, amountExpr) {
         return [];
     if (d.token === null)
         throw new Error("deposit: unreachable — erc20-approve template without a token");
-    const approveAmount = d.approvalPolicy === "max" ? "(2n ** 256n - 1n)" : amountExpr;
+    const approveAmount = d.approvalPolicy === "max" ? formatBigint(MAX_UINT256) : amountExpr;
     return [
         `IERC20.at(${formatBigint(d.token)}).approve(${formatBigint(d.target)}, ${approveAmount});`,
     ];
@@ -64,17 +70,15 @@ function resolveAmountExpr(d, varSuffix) {
         throw new Error(`depositCallStatement: amount "delta" is only meaningful inside swapThenDepositSource (it needs a pre-swap balance snapshot) — ${d.template.protocol}:${d.template.action}`);
     }
     if (d.amount === "max") {
-        return { pre: [], amountExpr: "(2n ** 256n - 1n)" };
+        return { pre: [], amountExpr: formatBigint(MAX_UINT256) };
     }
     if (d.amount === "balance") {
-        if (d.template.binding === null) {
-            return { pre: [], amountExpr: "ctx.selfBalance()" };
+        if (d.template.funding === "native-value") {
+            return { pre: [], amountExpr: balanceExpression(d) };
         }
-        if (d.token === null)
-            throw new Error("deposit: unreachable — erc20 template without a token");
         const varName = `depositAmt${varSuffix}`;
         return {
-            pre: [`const ${varName} = IERC20.at(${formatBigint(d.token)}).balanceOf(ctx.self());`],
+            pre: [`const ${varName} = ${balanceExpression(d)};`],
             amountExpr: varName,
         };
     }
@@ -98,7 +102,7 @@ export function depositCallStatement(spec, varSuffix = "") {
     return lines.join("\n");
 }
 /** The import lines a `depositSource(specs)` program needs: each resolved template's own
- *  `imports`, plus `IERC20` iff any spec needs an approve or a `"balance"` ERC20 read. De-duped by
+ *  `imports`, plus `IERC20` iff any spec needs an approval or an ERC20 balance/delta read. De-duped by
  *  exact line, in first-seen order (`IERC20` first, matching `swap`'s own ordering convention). */
 export function depositImportLines(specs) {
     const list = Array.isArray(specs) ? specs : [specs];
@@ -180,17 +184,6 @@ export function swapThenDepositSource(swaps, deposits, opts = {}) {
             importLines.push(line);
         }
     }
-    // A "delta" deposit needs a balance read even if depositImportLines (which never sees "delta"
-    // amounts as needing one — it only special-cases "balance") didn't already add it.
-    const needsIerc20ForDelta = depositList.some((d) => {
-        if (d.amount !== "delta")
-            return false;
-        const normalized = toDeposit({ ...d, amount: 0n });
-        return normalized.template.binding !== null;
-    });
-    if (needsIerc20ForDelta && !seen.has(IERC20_IMPORT)) {
-        importLines.unshift(IERC20_IMPORT);
-    }
     const swapBlock = swapList.map(swapCallStatement).join("\n");
     const preLines = [];
     const postLines = [];
@@ -200,17 +193,9 @@ export function swapThenDepositSource(swaps, deposits, opts = {}) {
             return;
         const normalized = toDeposit({ ...d, amount: 0n });
         const varBase = `deposit${i}`;
-        if (normalized.template.binding === null) {
-            preLines.push(`const ${varBase}Pre = ctx.selfBalance();`);
-            postLines.push(`const ${varBase}Post = ctx.selfBalance();`);
-        }
-        else {
-            if (normalized.token === null)
-                throw new Error("deposit: unreachable — erc20 template without a token");
-            const tokenLit = formatBigint(normalized.token);
-            preLines.push(`const ${varBase}Pre = IERC20.at(${tokenLit}).balanceOf(ctx.self());`);
-            postLines.push(`const ${varBase}Post = IERC20.at(${tokenLit}).balanceOf(ctx.self());`);
-        }
+        const balance = balanceExpression(normalized);
+        preLines.push(`const ${varBase}Pre = ${balance};`);
+        postLines.push(`const ${varBase}Post = ${balance};`);
         postLines.push(`const ${varBase}Amt = ${varBase}Post - ${varBase}Pre;`);
         deltaAmountExprs.set(i, `${varBase}Amt`);
     });

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

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

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

@@ -34,8 +34,8 @@ export interface ExtraFieldSpec {
  * The chain-agnostic deposit SPEC a caller builds — the input to {@link toDeposit} /
  * `depositCallStatement` / `depositSource`.
  *
- * `token` is required for an `"erc20-approve"`/`"none"` template (the asset being approved/
- * supplied/withdrawn) and must be omitted for a `"native-value"` template (there is no ERC20 leg).
+ * `token` names the asset for a typed-ABI template. Omit it for WETH wrap/unwrap and Lido stake;
+ * WETH unwrap uses `target` as its token address, while wrap and stake use native ETH.
  * `beneficiary` defaults to `ctx.self()` and must be omitted on a `beneficiary: "unsupported"`
  * template (every such protocol credits `msg.sender` unconditionally — accepting one would silently
  * send the position to the wrong account).
@@ -48,7 +48,7 @@ export interface DepositSpec {
     action: string;
     /** The contract this deposit calls into (the Aave Pool, the Comet, the vault, WETH9, stETH, …). */
     target: AddressInput;
-    /** Required for an ERC20-funded template; must be omitted for a native-value one. */
+    /** Required for typed-ABI templates; omit for WETH wrap/unwrap and Lido stake. */
     token?: AddressInput;
     amount: AmountInput;
     /** Defaults to `ctx.self()`. Must be omitted on a `beneficiary: "unsupported"` template. */
@@ -63,7 +63,8 @@ export interface DepositSpec {
  * {@link DepositSpec}:
  *
  * - `amount: "balance"` — emit a RUNTIME balance read instead of a baked-in literal (`IERC20.
- *   balanceOf(ctx.self())` for an ERC20 template, `ctx.selfBalance()` for a native one) — the shape
+ *   balanceOf(ctx.self())` on `token` or the WETH unwrap `target`, `ctx.selfBalance()` for a
+ *   native-funded template) — the shape
  *   a swap-then-deposit program needs when the deposit amount is an earlier leg's (unknown at
  *   compile time) output.
  * - `amount: "delta"` — only meaningful inside `swapThenDepositSource` (it needs a pre-swap balance

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

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

package/sdk/dist/evm/engine.d.ts

@@ -39,6 +39,14 @@ export declare const v12PotAbi: readonly [{
     readonly outputs: readonly [{
         readonly type: "address";
     }];
+}, {
+    readonly name: "kitchen";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
 }, {
     readonly name: "router";
     readonly type: "function";
@@ -78,6 +86,14 @@ export declare const v12KitchenAbi: readonly [{
     readonly outputs: readonly [{
         readonly type: "address";
     }];
+}, {
+    readonly name: "executionFee";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
 }, {
     readonly name: "router";
     readonly type: "function";
@@ -119,6 +135,14 @@ export declare const v12Pot: {
         readonly outputs: readonly [{
             readonly type: "address";
         }];
+    }, {
+        readonly name: "kitchen";
+        readonly type: "function";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [{
+            readonly type: "address";
+        }];
     }, {
         readonly name: "router";
         readonly type: "function";
@@ -168,6 +192,14 @@ export declare const v12Kitchen: {
         readonly outputs: readonly [{
             readonly type: "address";
         }];
+    }, {
+        readonly name: "executionFee";
+        readonly type: "function";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [{
+            readonly type: "uint256";
+        }];
     }, {
         readonly name: "router";
         readonly type: "function";

package/sdk/dist/evm/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/evm/engine.ts"],"names":[],"mappings":"AAaA,OAAO,EAAgC,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE5E;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKpB,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIxB,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEjB;;;;;;OAMG;kCACkB,OAAO,WAAW,GAAG,KAAG,GAAG;CAExC,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAErB,iGAAiG;sCACxE,OAAO,QAAQ,GAAG,KAAG,GAAG;IAEjD,yFAAyF;uCAC/D,OAAO,QAAQ,GAAG,KAAG,GAAG;CAE1C,CAAC"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/evm/engine.ts"],"names":[],"mappings":"AAaA,OAAO,EAAgC,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE5E;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpB,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEjB;;;;;;OAMG;kCACkB,OAAO,WAAW,GAAG,KAAG,GAAG;CAExC,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAErB,iGAAiG;sCACxE,OAAO,QAAQ,GAAG,KAAG,GAAG;IAEjD,yFAAyF;uCAC/D,OAAO,QAAQ,GAAG,KAAG,GAAG;CAE1C,CAAC"}