@eco-incorp/sauce 0.99.0

package/sdk/dist/routes/intent-dsl.js

@@ -0,0 +1,380 @@
+import { requireChain } from "../chains/canonical.js";
+import { chainAmbient, chainDefines } from "./ambient.js";
+import { isSauceClosure, sauceBodyToSource } from "./closure.js";
+import { encodeRewardEvm, encodeRewardSvm, encodeRouteEvm, encodeRouteSvm, hashIntent, } from "./encode.js";
+import { assembleIntent } from "./intent.js";
+import { assertNestingInvariants, nestedChildCalls, nestedTransferProgram, } from "./nest.js";
+import { normalizeRoute } from "./normalize.js";
+import { approvalTxs, fundTx, intentHashCall, intentVaultAddressCall, isIntentFundedCall, publishAndFundTx, publishTx, } from "./portal.js";
+import { compileSauceRoute, } from "./sauce-route.js";
+import { predictVaultAddress } from "./vault.js";
+function missingField(field, where) {
+    throw new Error(`openRoute: '${field}' is required — supply it ${where}`);
+}
+function isTokenAmountArray(value) {
+    return Array.isArray(value);
+}
+/** Resolves `.reward(rewardArg)`'s argument against `options`' own fallback fields, into a
+ *  fully-formed `(source, RewardInput)` pair -- or throws, naming exactly which required field
+ *  (`source`/`creator`/`prover`/`deadline`) is missing from BOTH the reward argument and `options`. */
+function resolveReward(rewardArg, options) {
+    const spec = typeof rewardArg === "bigint"
+        ? { nativeAmount: rewardArg }
+        : isTokenAmountArray(rewardArg)
+            ? { tokens: rewardArg }
+            : rewardArg;
+    const sourceRef = spec.source ?? options?.source;
+    if (sourceRef === undefined) {
+        missingField("source", "as `reward.source` or `IntentOptions.source`");
+    }
+    const source = requireChain(sourceRef);
+    const deadline = spec.deadline ?? options?.rewardDeadline ?? options?.deadline;
+    if (deadline === undefined) {
+        missingField("deadline", "as `reward.deadline`, `IntentOptions.rewardDeadline`, or `IntentOptions.deadline`");
+    }
+    const creator = spec.creator ?? options?.creator;
+    if (creator === undefined) {
+        missingField("creator", "as `reward.creator` or `IntentOptions.creator`");
+    }
+    const prover = spec.prover ?? options?.prover;
+    if (prover === undefined) {
+        missingField("prover", "as `reward.prover` or `IntentOptions.prover`");
+    }
+    return {
+        source,
+        reward: {
+            deadline,
+            creator,
+            prover,
+            nativeAmount: spec.nativeAmount,
+            tokens: spec.tokens,
+        },
+    };
+}
+function missingSourcePortal() {
+    throw new Error("BuiltIntent: no Portal target — supply it as the call's own `target.portal` or as " +
+        "`IntentOptions.sourcePortal` when building the intent");
+}
+function resolveTarget(target, sourcePortal) {
+    const portal = target?.portal ?? sourcePortal;
+    if (portal === undefined)
+        missingSourcePortal();
+    return { portal };
+}
+function makeBuiltIntent(intent, destination, source, compiled, sourcePortal, children = []) {
+    const target = (t) => resolveTarget(t, sourcePortal);
+    return {
+        intent,
+        destination,
+        source,
+        compiled,
+        children,
+        root() {
+            return intent;
+        },
+        intents() {
+            return [intent, ...children.flatMap((c) => c.intents())];
+        },
+        hash() {
+            return hashIntent(intent);
+        },
+        encodeEVM() {
+            return { route: encodeRouteEvm(intent.route), reward: encodeRewardEvm(intent.reward) };
+        },
+        encodeSVM() {
+            return { route: encodeRouteSvm(intent.route), reward: encodeRewardSvm(intent.reward) };
+        },
+        publishCalldata(t) {
+            return publishTx(intent, target(t));
+        },
+        publishAndFundCalldata(allowPartial, t) {
+            return publishAndFundTx(intent, allowPartial, target(t));
+        },
+        fundCalldata(allowPartial, t) {
+            return fundTx(intent, allowPartial, target(t));
+        },
+        approvals(t) {
+            return approvalTxs(intent, target(t));
+        },
+        vaultCall(t) {
+            return intentVaultAddressCall(intent, target(t));
+        },
+        predictVault(config) {
+            return predictVaultAddress(hashIntent(intent).intentHash, config);
+        },
+        vault(config) {
+            return predictVaultAddress(hashIntent(intent).intentHash, config);
+        },
+        hashCall(t) {
+            return intentHashCall(intent, target(t));
+        },
+        fundedCall(t) {
+            return isIntentFundedCall(intent, target(t));
+        },
+    };
+}
+/**
+ * Opens a route on `chain` (the DESTINATION) — what every chain global's callable AND `.route`
+ * forward to, so `Base(sauce, opts)` and `Base.route(sauce, opts)` are behaviorally identical by
+ * construction (both call this exact function).
+ */
+export function openRoute(chain, sauce, options) {
+    const destination = requireChain(chain);
+    if (options === undefined) {
+        missingField("execution/pot, deadline, portal", "via `IntentOptions` (the second argument)");
+    }
+    if (options.deadline === undefined) {
+        missingField("deadline", "as `IntentOptions.deadline`");
+    }
+    if (options.portal === undefined) {
+        missingField("portal", "as `IntentOptions.portal`");
+    }
+    if (options.execution === undefined &&
+        options.pot !== undefined &&
+        options.engine === undefined) {
+        missingField("engine", "alongside the `IntentOptions.pot` shorthand");
+    }
+    const execution = options.execution ??
+        (options.pot !== undefined && options.engine !== undefined
+            ? { pot: options.pot, engine: options.engine }
+            : undefined);
+    if (execution === undefined) {
+        missingField("execution", "as `IntentOptions.execution` or the EVM shorthand `IntentOptions.pot`");
+    }
+    const closure = isSauceClosure(sauce);
+    const sauceSource = closure ? sauceBodyToSource(sauce) : sauce;
+    // Chain-scoped ambient defines (chainId, protocol/contract addresses, caller token symbols) sit
+    // UNDERNEATH the caller's own IntentOptions.defines, which sits underneath the most-specific
+    // IntentOptions.compile.defines -- caller always wins on a key collision; a user-declared local
+    // inside the body wins over all of this via the compiler's own getConstant/getVar precedence.
+    const ambientDefines = chainDefines(destination, { tokens: options.tokenDefines });
+    const mergedDefines = { ...ambientDefines, ...options.defines, ...options.compile?.defines };
+    // P7 — the ambient-MODULE half of the chain bundle (`ambientDefines` above is the scalar half).
+    // `chainAmbient(destination)` is the plugin's chain-scoped ambient module list (`["@sauce/token"]`
+    // by default, see `ambient.ts#chainAmbient`/`plugin/index.ts`'s own notes); merged with any
+    // caller-supplied `options.compile.ambient` (deduped -- either side may legitimately name the
+    // same module).
+    const mergedAmbient = Array.from(new Set([...chainAmbient(destination), ...(options.compile?.ambient ?? [])]));
+    const compileOptions = {
+        ...options.compile,
+        defines: mergedDefines,
+        tokens: options.compile?.tokens ?? options.tokenDefines,
+        ambient: mergedAmbient.length > 0 ? mergedAmbient : options.compile?.ambient,
+    };
+    let compiledRoute;
+    try {
+        compiledRoute = compileSauceRoute(destination, sauceSource, execution, compileOptions);
+    }
+    catch (err) {
+        // The compiler reports a free identifier as "`X` is not a declared variable", inside a larger
+        // rustc-style diagnostic — so match the sentence rather than a message prefix.
+        const undeclared = err instanceof Error ? /`([^`]+)` is not a declared variable/.exec(err.message) : null;
+        if (closure && undeclared !== null) {
+            const name = undeclared[1];
+            throw new Error(`openRoute: closure route body references '${name}', which is not defined — a closure ` +
+                `captures nothing by construction; supply '${name}' via IntentOptions.defines (or a chain-scoped ` +
+                `ambient define) instead.`, 
+            // Keep the compiler's own diagnostic reachable: this message names the fix, the cause
+            // carries the full rustc-style report the regex above only matched one sentence of.
+            { cause: err });
+        }
+        throw err;
+    }
+    const nestedEntries = [];
+    const TRANSFER_ONLY_KEYS = [
+        "vault",
+        "vaultConfig",
+        "clamp",
+        "requireCap",
+        "native",
+        "fundNativeFromRoute",
+        "pot",
+        "engine",
+        "compile",
+    ];
+    const PUBLISH_ONLY_KEYS = ["allowPartial", "fundedByBody"];
+    function assertNestOptionMode(via, opts) {
+        if (opts === undefined)
+            return;
+        const otherVia = via === "transfer" ? "publishAndFund" : "transfer";
+        const offendingKeys = via === "transfer" ? PUBLISH_ONLY_KEYS : TRANSFER_ONLY_KEYS;
+        for (const key of offendingKeys) {
+            if (opts[key] !== undefined) {
+                throw new Error(`openRoute: .nest() option '${key}' is only valid with via: "${otherVia}" — it is meaningless ` +
+                    `under via: "${via}" (mode-mismatched options throw rather than being silently ignored).`);
+            }
+        }
+    }
+    function evmPotOf(exec) {
+        return exec !== undefined && "pot" in exec ? exec.pot : undefined;
+    }
+    function evmEngineOf(exec) {
+        return exec !== undefined && "engine" in exec ? exec.engine : undefined;
+    }
+    const pending = {
+        nest(childOrThunk, opts) {
+            const isThunk = typeof childOrThunk === "function";
+            const built = isThunk ? childOrThunk(destination) : childOrThunk;
+            if (!isThunk && built.source.id !== destination.id) {
+                throw new Error(`openRoute: .nest() child's source ('${built.source.slug}') does not match this route's ` +
+                    `destination ('${destination.slug}') — a child's source chain is always its parent's ` +
+                    `destination (execution) chain. Prefer the thunk form (\`.nest((on) => ...)\`), which cannot ` +
+                    `get this wrong.`);
+            }
+            const via = opts?.via ?? "transfer";
+            assertNestOptionMode(via, opts);
+            if (via === "transfer" && evmPotOf(execution) === undefined && opts?.pot === undefined) {
+                throw new Error(`openRoute: .nest() via: "transfer" requires an EVM Pot execution (T3) — this route's own ` +
+                    `IntentOptions.execution/pot must name a Pot (a Solana/SVM destination has none), or pass ` +
+                    `NestOptions.pot explicitly.`);
+            }
+            nestedEntries.push({
+                built,
+                via,
+                position: opts?.position ?? "after",
+                portal: opts?.portal ?? options.portal,
+                allowPartial: opts?.allowPartial ?? false,
+                fundedByBody: opts?.fundedByBody ?? false,
+                vault: opts?.vault,
+                vaultConfig: opts?.vaultConfig,
+                clamp: opts?.clamp ?? true,
+                requireCap: opts?.requireCap ?? false,
+                native: opts?.native ?? "balance",
+                fundNativeFromRoute: opts?.fundNativeFromRoute ?? false,
+                pot: opts?.pot,
+                engine: opts?.engine,
+                compile: opts?.compile,
+            });
+            return pending;
+        },
+        reward(rewardArg) {
+            const { source, reward } = resolveReward(rewardArg, options);
+            let parentRouteForInvariants;
+            if (nestedEntries.length > 0) {
+                parentRouteForInvariants = normalizeRoute({
+                    deadline: options.deadline,
+                    portal: options.portal,
+                    nativeAmount: options.nativeAmount,
+                    tokens: options.tokens,
+                    calls: [],
+                });
+                assertNestingInvariants({
+                    parentChain: destination,
+                    parentRoute: parentRouteForInvariants,
+                    children: nestedEntries.map((e) => ({
+                        intent: e.built.intent,
+                        fundedByBody: e.fundedByBody,
+                        via: e.via,
+                    })),
+                });
+                // T5: a transfer child opting into `fundNativeFromRoute` re-enables a NATIVE-only coverage
+                // check, since that native genuinely comes from this route's own `route.nativeAmount`.
+                const fundNativeFromRouteTotal = nestedEntries
+                    .filter((e) => e.via === "transfer" && e.fundNativeFromRoute)
+                    .reduce((sum, e) => sum + e.built.intent.reward.nativeAmount, 0n);
+                if (fundNativeFromRouteTotal > parentRouteForInvariants.nativeAmount) {
+                    throw new Error(`openRoute: .nest() children opted into fundNativeFromRoute total nativeAmount ` +
+                        `(${fundNativeFromRouteTotal}) exceeds this route's own route.nativeAmount ` +
+                        `(${parentRouteForInvariants.nativeAmount}) (T5) — the transfer cook's value cannot ` +
+                        `exceed what the solver delivered via route.nativeAmount.`);
+                }
+            }
+            /** Resolves a `NestEntry`'s vault-address rung, precedence explicit > predicted > runtime. */
+            function resolveVaultResolution(e) {
+                if (e.vault !== undefined)
+                    return { mode: "explicit", vault: e.vault };
+                if (e.vaultConfig !== undefined) {
+                    return {
+                        mode: "predicted",
+                        config: {
+                            vaultInitCodeHash: e.vaultConfig.vaultInitCodeHash,
+                            portal: e.vaultConfig.portal ?? e.portal,
+                            prefix: e.vaultConfig.prefix,
+                        },
+                    };
+                }
+                return { mode: "runtime", portal: e.portal };
+            }
+            /** Compiles every `via: "transfer"` entry in one position group into ONE merged `cook()`
+             *  call (in `.nest()` order) — see `nest.ts#nestedTransferProgram`. */
+            function buildTransferCall(transferEntries) {
+                const defaultPot = evmPotOf(execution);
+                const pot = transferEntries[0].pot ?? defaultPot;
+                if (pot === undefined) {
+                    throw new Error(`openRoute: .nest() via: "transfer" requires an EVM Pot execution (T3) — this route's own ` +
+                        `IntentOptions.execution/pot must name a Pot, or pass NestOptions.pot explicitly.`);
+                }
+                const defaultEngine = evmEngineOf(execution);
+                const engine = transferEntries[0].engine ?? defaultEngine;
+                if (engine === undefined) {
+                    throw new Error(`openRoute: .nest() via: "transfer" needs the interpreter the cook runs on — this route's ` +
+                        `own IntentOptions.execution/engine must name one, or pass NestOptions.engine explicitly.`);
+                }
+                // Both are taken from entry 0 and both must therefore be UNANIMOUS across the group — the
+                // merge produces one cook, so a second opinion cannot be honoured. Checking only the Pot
+                // would silently run entry 1's bytecode on entry 0's interpreter, which is the one thing a
+                // caller cannot see in the encoded call.
+                for (const e of transferEntries) {
+                    const entryPot = e.pot ?? defaultPot;
+                    if (entryPot !== pot) {
+                        throw new Error(`openRoute: .nest() via: "transfer" children merged into the same position group must ` +
+                            `target the same Pot — got conflicting NestOptions.pot values ('${pot}' vs '${entryPot}').`);
+                    }
+                    const entryEngine = e.engine ?? defaultEngine;
+                    if (entryEngine !== engine) {
+                        throw new Error(`openRoute: .nest() via: "transfer" children merged into the same position group must ` +
+                            `run on the same engine — got conflicting NestOptions.engine values ('${engine}' vs ` +
+                            `'${entryEngine}').`);
+                    }
+                }
+                const entries = transferEntries.map((e) => ({
+                    child: e.built.intent,
+                    opts: {
+                        vaultResolution: resolveVaultResolution(e),
+                        clamp: e.clamp,
+                        requireCap: e.requireCap,
+                        native: e.native,
+                    },
+                }));
+                const { source: transferSource, baseDirs } = nestedTransferProgram(entries);
+                const nativeValue = transferEntries
+                    .filter((e) => e.fundNativeFromRoute)
+                    .reduce((sum, e) => sum + e.built.intent.reward.nativeAmount, 0n);
+                const perEntryCompile = transferEntries.map((e) => e.compile).find((c) => c !== undefined);
+                const transferCompileOptions = {
+                    ...perEntryCompile,
+                    target: perEntryCompile?.target ?? "v12",
+                    baseDirs: [...(perEntryCompile?.baseDirs ?? []), ...baseDirs],
+                };
+                const compiledTransfer = compileSauceRoute(destination, transferSource, { pot, engine, value: nativeValue }, transferCompileOptions);
+                return compiledTransfer.calls[0];
+            }
+            const childCalls = (position) => {
+                const group = nestedEntries.filter((e) => e.position === position);
+                const publishCalls = group
+                    .filter((e) => e.via === "publishAndFund")
+                    .flatMap((e) => nestedChildCalls(e.built.intent, { portal: e.portal, allowPartial: e.allowPartial }));
+                const transferEntries = group.filter((e) => e.via === "transfer");
+                const transferCalls = transferEntries.length > 0 ? [buildTransferCall(transferEntries)] : [];
+                return [...publishCalls, ...transferCalls];
+            };
+            const calls = [
+                ...(options.precalls ?? []),
+                ...childCalls("before"),
+                ...compiledRoute.calls,
+                ...childCalls("after"),
+            ];
+            const intent = assembleIntent(source, destination, {
+                salt: options.salt,
+                deadline: options.deadline,
+                portal: options.portal,
+                nativeAmount: options.nativeAmount,
+                tokens: options.tokens,
+                calls,
+            }, reward);
+            return makeBuiltIntent(intent, destination, source, compiledRoute.compiled, options.sourcePortal, nestedEntries.map((e) => e.built));
+        },
+    };
+    return pending;
+}
+//# sourceMappingURL=intent-dsl.js.map

package/sdk/dist/routes/intent-dsl.js.map

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

package/sdk/dist/routes/intent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Intent assembly — the ONE place that knows the current eco-routes schema's
+ * field names. A future v3 reward-leg model swaps this file (and
+ * `types.ts`); the builder (`builder.ts`) never references a field name
+ * directly, only calls `assemble(...)`.
+ */
+import type { CanonicalChain } from "../chains/canonical.js";
+import type { Intent, RewardInput, RouteInput } from "./types.js";
+/**
+ * Builds one `Intent` for a leg running from `source` to `destination`.
+ * `route === undefined` means a TERMINAL close: the leg gets a synthesized
+ * empty route (see `emptyRoute`) instead of a caller-supplied one.
+ */
+export declare function assembleIntent(source: CanonicalChain, destination: CanonicalChain, route: RouteInput | undefined, reward: RewardInput): Intent;
+//# sourceMappingURL=intent.d.ts.map

package/sdk/dist/routes/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/routes/intent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,GAClB,MAAM,CAQR"}

package/sdk/dist/routes/intent.js

@@ -0,0 +1,16 @@
+import { emptyRoute, normalizeReward, normalizeRoute } from "./normalize.js";
+/**
+ * Builds one `Intent` for a leg running from `source` to `destination`.
+ * `route === undefined` means a TERMINAL close: the leg gets a synthesized
+ * empty route (see `emptyRoute`) instead of a caller-supplied one.
+ */
+export function assembleIntent(source, destination, route, reward) {
+    const normalizedReward = normalizeReward(reward);
+    return {
+        destination: BigInt(destination.id),
+        sourceChainId: BigInt(source.id),
+        route: route === undefined ? emptyRoute(normalizedReward.deadline) : normalizeRoute(route),
+        reward: normalizedReward,
+    };
+}
+//# sourceMappingURL=intent.js.map

package/sdk/dist/routes/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/routes/intent.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG7E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,WAA2B,EAC3B,KAA6B,EAC7B,MAAmB;IAEnB,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC;QAC1F,MAAM,EAAE,gBAAgB;KACzB,CAAC;AACJ,CAAC"}

package/sdk/dist/routes/nest.d.ts

@@ -0,0 +1,131 @@
+import type { CanonicalChain } from "../chains/canonical.js";
+import { type VaultConfig } from "./vault.js";
+import type { AddressInput, CallInput, Intent, Route } from "./types.js";
+/** Per-child options for `nestedChildCalls` — `portal` is always the PARENT's own `route.portal`. */
+export interface NestedChildOptions {
+    readonly portal: AddressInput;
+    readonly allowPartial: boolean;
+}
+/**
+ * The calls a static child contributes to the PARENT's own `route.calls`:
+ * `[...approve(P, amount) per distinct reward token, publishAndFund(childDestination, childRouteBytes,
+ * childReward, allowPartial)]`, all issued against `opts.portal` (the parent's own `route.portal`).
+ * Reuses `portal.ts#approvalTxs`/`publishAndFundTx` entirely — no second encoder.
+ */
+export declare function nestedChildCalls(child: Intent, opts: NestedChildOptions): readonly CallInput[];
+/**
+ * Asserts every field of `child`'s reward is concrete (known off-chain). Vacuous today — `Intent`'s
+ * runtime shape has no lazy/runtime-computed field, so a fully-built `Intent` is always static by
+ * construction. This is deliberately kept as its own named assertion because it is the SEAM where an
+ * S6 runtime-computed child (design doc §7) will be rejected here, rather than silently mis-encoded
+ * by treating a placeholder as a real amount.
+ */
+export declare function assertStaticChild(_child: Intent): void;
+/**
+ * The nesting mechanism a child uses. This PURE MODULE's own default is `"publishAndFund"` (so every
+ * already-landed caller of `assertNestingInvariants`/`nestedChildCalls` keeps its exact meaning
+ * unchanged) — the DSL's own default (`intent-dsl.ts`) is `"transfer"`, a deliberate, documented
+ * asymmetry (see that file's module doc). `"transfer"` is the 2026-08-11 USER DIRECTIVE default: the
+ * parent's route TRANSFERS a balance-capped amount to the child's (fully static) vault address
+ * instead of splicing a runtime `publishAndFund` — see `nestedTransferStatements`/
+ * `nestedTransferProgram` below for the codegen, and this file's module doc for the on-chain grounding
+ * (balance-based payout, no funded-flag gate, no publication requirement).
+ */
+export type NestVia = "transfer" | "publishAndFund";
+export interface NestChild {
+    readonly intent: Intent;
+    /** Opt-out of invariant 5's funding-coverage check for this one child: the legitimate case where
+     *  the parent's own Sauce program EARNS the child's reward tokens/native and forwards them to the
+     *  Executor (its `cook()` caller) rather than the solver delivering them via `route.tokens`.
+     *  publishAndFund-mode only — meaningless (and ignored) for a `"transfer"`-mode child, since
+     *  invariant 5 is unconditionally dropped for those regardless of this flag. */
+    readonly fundedByBody?: boolean;
+    /** This PURE module's own default: `"publishAndFund"` (see {@link NestVia}'s doc for why). */
+    readonly via?: NestVia;
+}
+/** `.nest()`'s vault-address resolution, precedence explicit > predicted > runtime (the default) —
+ *  see the design doc's "vaultAddrResolution" section for the full rationale of each rung. */
+export type ChildVaultResolution = {
+    readonly mode: "explicit";
+    readonly vault: AddressInput;
+} | {
+    readonly mode: "predicted";
+    readonly config: VaultConfig;
+} | {
+    readonly mode: "runtime";
+    readonly portal: AddressInput;
+};
+/** Per-child options for the transfer codegen below. */
+export interface TransferChildOptions {
+    readonly vaultResolution: ChildVaultResolution;
+    /** Caps the transferred amount at the child's own declared reward amount. Default `true` — see
+     *  the design doc's "capModel" section for why this is a pure improvement, never a restriction. */
+    readonly clamp?: boolean;
+    /** Reverts the whole parent fulfillment (rather than quietly stalling the child) when the Pot's
+     *  own balance is already short of the declared cap. Default `false`. */
+    readonly requireCap?: boolean;
+    /** `"skip"` omits the native leg entirely even when `child.reward.nativeAmount > 0`. Default
+     *  `"balance"` — transfer `ctx.selfBalance()`, clamped/guarded exactly like an ERC20 leg. */
+    readonly native?: "balance" | "skip";
+}
+export interface AssertNestingInvariantsArgs {
+    /** The parent's DESTINATION chain — i.e. its own execution chain, and therefore every child's
+     *  source chain. */
+    readonly parentChain: CanonicalChain;
+    /** The parent's own (already-normalized) `Route` — its `tokens`/`nativeAmount`/`deadline` are what
+     *  invariants 4 and 5 check children against. */
+    readonly parentRoute: Route;
+    readonly children: readonly NestChild[];
+}
+/**
+ * Asserts the six build-time invariants a static cascade must satisfy (design doc §15.4), all fail
+ * closed:
+ *
+ *  1. EVM parent — `parentChain.kind === "evm"`. The Solana Portal PROGRAM is not in eco-routes on
+ *     `main` (zero `.rs`); a child's OWN destination may still be `svm`.
+ *  2. Source match — every child's `sourceChainId` equals the parent's destination chain id.
+ *  3. Static child — `assertStaticChild` per child (the S6 seam).
+ *  4. Deadlines INCREASE with depth — `child.route.deadline >= parentRoute.deadline` AND
+ *     `child.reward.deadline >= parentRoute.deadline`. The child publishes DURING the parent's
+ *     fulfillment, which `Inbox._fulfill` allows right up to the parent's own `route.deadline`
+ *     (`block.timestamp > route.deadline` is the only revert condition), so an earlier child deadline
+ *     is publishable-but-already-dead.
+ *  5. Funding coverage — per reward token, `Σ children reward amounts <= Σ parentRoute.tokens
+ *     amounts` for that token, and `Σ children reward nativeAmount <= parentRoute.nativeAmount` —
+ *     skipping any child with `fundedByBody: true`, and (2026-08-11 directive) UNCONDITIONALLY
+ *     skipping every `via: "transfer"` child regardless of `fundedByBody` — the transfer itself IS
+ *     the (balance-based) funding, so there is nothing static left to compare against
+ *     `parentRoute.tokens`/`nativeAmount`. See `intent-dsl.ts`'s T5 for the one native-only coverage
+ *     check that DOES still apply to a transfer child (only when it opts into `fundNativeFromRoute`).
+ *  6. No duplicate intent hash — `normalizeRoute` defaults `salt` to 32 zero bytes, so two
+ *     structurally identical children silently collapse into the SAME intent. A repeat `intentHash`
+ *     anywhere in `children` throws, pointing at `options.salt`.
+ */
+export declare function assertNestingInvariants(args: AssertNestingInvariantsArgs): void;
+/**
+ * The Sauce statements one child contributes to a merged transfer program (see
+ * `nestedTransferProgram`): a `balanceOf`/clamp/zero-guard/`transfer` block per reward token, plus an
+ * analogous native leg, each capped at exactly the amount the caller declared in `child.reward` (the
+ * design doc's "capModel"). `index` namespaces every local this child introduces (`n<index>_...`) so
+ * several children merge into ONE program scope without colliding.
+ */
+export declare function nestedTransferStatements(child: Intent, index: number, opts: TransferChildOptions): readonly string[];
+/** One `{ child, opts }` pair per transfer-mode nested child, merged (in this array's order) into
+ *  ONE `nestedTransferProgram` output. */
+export interface TransferNestEntry {
+    readonly child: Intent;
+    readonly opts: TransferChildOptions;
+}
+/**
+ * Merges every entry's `nestedTransferStatements` into ONE `function main(){...}` Sauce program —
+ * `intent-dsl.ts` is the only caller that ever `compile()`s this text, keeping the compiler
+ * dependency out of this pure module entirely. `imports`/`baseDirs` are surfaced separately so a
+ * caller with its own `baseDirs`/compile options can merge them rather than re-deriving what this
+ * program needs.
+ */
+export declare function nestedTransferProgram(entries: readonly TransferNestEntry[]): {
+    readonly source: string;
+    readonly imports: readonly string[];
+    readonly baseDirs: readonly string[];
+};
+//# sourceMappingURL=nest.d.ts.map

package/sdk/dist/routes/nest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.d.ts","sourceRoot":"","sources":["../../src/routes/nest.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAO7D,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAC;AAE3F,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,SAAS,SAAS,EAAE,CAK9F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;oFAIgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;8FAC8F;AAC9F,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAEhE,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAC;IAC/C;uGACmG;IACnG,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;6EACyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;iGAC6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C;wBACoB;IACpB,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC;qDACiD;IACjD,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAmG/E;AA4DD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,GACzB,SAAS,MAAM,EAAE,CA6DnB;AAED;0CAC0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAOA"}