@temporalabs/treasury 0.1.2 → 0.1.4

package/dist/config/earn.d.ts

@@ -11,7 +11,8 @@
  *                         config/registry disagreement — and the schema allows a WHITELIST_GATED
  *                         default, because the pre-flight re-measures access live on every call and
  *                         refuses a non-member before anything is built.
- *   `roundTripVault`      what the deposit → redeem tiers exercise. The Base default today.
+ *   `roundTripVault`      what `scripts/roundtrip.ts` exercises by default. The Base default today. (The fork
+ *                         tier round-trips every depositable vault on each chain, from the registry.)
  *
  * Addresses live in the registry (`registry/vaults.json`, schema-validated, block-stamped) — a
  * ticker here resolves through it.
@@ -42,12 +43,20 @@ export declare const EARN: {
      * `robinhood`: Tempora Labs Cash Plus USDG (Test 2D) — a Morpho Vault V2 on Robinhood Chain over
      * USDG, the first vault whose asset is not USDC. Open to any account by the same measurement.
      *
+     * `ethereum`: Tempora Labs Cash Plus USDC (Test 2E) — a Morpho Vault V2 on Ethereum, open to any
+     * account by the same measurement. Gas there costs far more than on the other chains.
+     *
+     * `monad`: Tempora Labs Cash Plus USDC (Test 2F) — a Morpho Vault V2 on Monad, open to any account
+     * by the same measurement.
+     *
      * `Record<ChainKey, …>`: a chain added to `CHAIN_INFO` without a default here does not compile.
      */
     readonly defaultVaultByChain: {
         base: string;
         arbitrum: string;
         robinhood: string;
+        ethereum: string;
+        monad: string;
     };
     /** The round-trip target. The same vault as the default; open, so the fork tier deposits from the whale directly. */
     readonly roundTripVault: "tlCashPlusUSDC2B";
@@ -61,6 +70,12 @@ export declare const EARN: {
         readonly usdcWhale: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb";
         /** Aave V3's aArbUSDCn token on Arbitrum One — held ~1.7e13 native-USDC base units when probed 2026-10-02. Impersonated on the fork, never keyed. */
         readonly usdcWhaleArbitrum: "0x724dc807b04555b71ed48a6896b6F41593b8C637";
+        /** Morpho Blue on Ethereum — held ~1.2e14 USDC base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        readonly usdcWhaleEthereum: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb";
+        /** The largest USDC holder among recent transfers on Monad — ~1.3e13 base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        readonly usdcWhaleMonad: "0x188d586Ddcf52439676Ca21A244753fA19F9Ea8e";
+        /** The largest USDG holder among recent transfers on Robinhood Chain — ~1.0e14 base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        readonly usdgWhaleRobinhood: "0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9d";
         /** USDC the fork round trip deposits, and what it seeds a discovered depositor with beforehand. */
         readonly forkDepositUsdc: "100";
         readonly forkSeedUsdc: "1000";

package/dist/config/earn.js

@@ -11,7 +11,8 @@
  *                         config/registry disagreement — and the schema allows a WHITELIST_GATED
  *                         default, because the pre-flight re-measures access live on every call and
  *                         refuses a non-member before anything is built.
- *   `roundTripVault`      what the deposit → redeem tiers exercise. The Base default today.
+ *   `roundTripVault`      what `scripts/roundtrip.ts` exercises by default. The Base default today. (The fork
+ *                         tier round-trips every depositable vault on each chain, from the registry.)
  *
  * Addresses live in the registry (`registry/vaults.json`, schema-validated, block-stamped) — a
  * ticker here resolves through it.
@@ -40,12 +41,20 @@ export const EARN = {
      * `robinhood`: Tempora Labs Cash Plus USDG (Test 2D) — a Morpho Vault V2 on Robinhood Chain over
      * USDG, the first vault whose asset is not USDC. Open to any account by the same measurement.
      *
+     * `ethereum`: Tempora Labs Cash Plus USDC (Test 2E) — a Morpho Vault V2 on Ethereum, open to any
+     * account by the same measurement. Gas there costs far more than on the other chains.
+     *
+     * `monad`: Tempora Labs Cash Plus USDC (Test 2F) — a Morpho Vault V2 on Monad, open to any account
+     * by the same measurement.
+     *
      * `Record<ChainKey, …>`: a chain added to `CHAIN_INFO` without a default here does not compile.
      */
     defaultVaultByChain: {
         base: "tlCashPlusUSDC2B",
         arbitrum: "tlCashPlusUSDC2C",
         robinhood: "tlCashPlusUSDG2D",
+        ethereum: "tlCashPlusUSDC2E",
+        monad: "tlCashPlusUSDC2F",
     },
     /** The round-trip target. The same vault as the default; open, so the fork tier deposits from the whale directly. */
     roundTripVault: "tlCashPlusUSDC2B",
@@ -59,6 +68,12 @@ export const EARN = {
         usdcWhale: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
         /** Aave V3's aArbUSDCn token on Arbitrum One — held ~1.7e13 native-USDC base units when probed 2026-10-02. Impersonated on the fork, never keyed. */
         usdcWhaleArbitrum: "0x724dc807b04555b71ed48a6896b6F41593b8C637",
+        /** Morpho Blue on Ethereum — held ~1.2e14 USDC base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        usdcWhaleEthereum: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
+        /** The largest USDC holder among recent transfers on Monad — ~1.3e13 base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        usdcWhaleMonad: "0x188d586Ddcf52439676Ca21A244753fA19F9Ea8e",
+        /** The largest USDG holder among recent transfers on Robinhood Chain — ~1.0e14 base units when probed 2026-10-11. Impersonated on the fork, never keyed. */
+        usdgWhaleRobinhood: "0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9d",
         /** USDC the fork round trip deposits, and what it seeds a discovered depositor with beforehand. */
         forkDepositUsdc: "100",
         forkSeedUsdc: "1000",

package/dist/config/earn.js.map

@@ -1 +1 @@
-{"version":3,"file":"earn.js","sourceRoot":"","sources":["../../src/config/earn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,sEAAsE;IACtE,YAAY,EAAE,MAAyB;IAEvC;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,kBAAkB;QAC5B,SAAS,EAAE,kBAAkB;KACU;IAEzC,qHAAqH;IACrH,cAAc,EAAE,kBAAwC;IAExD,wGAAwG;IACxG,mBAAmB,EAAE,MAAM;IAE3B,8CAA8C;IAC9C,QAAQ,EAAE;QACR,4FAA4F;QAC5F,QAAQ,EAAE,4CAAqD;QAC/D,wHAAwH;QACxH,SAAS,EAAE,4CAAqD;QAChE,qJAAqJ;QACrJ,iBAAiB,EAAE,4CAAqD;QACxE,mGAAmG;QACnG,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,MAAM;KACrB;CACO,CAAC"}
+{"version":3,"file":"earn.js","sourceRoot":"","sources":["../../src/config/earn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,sEAAsE;IACtE,YAAY,EAAE,MAAyB;IAEvC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,kBAAkB;QAC5B,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,EAAE,kBAAkB;KACc;IAEzC,qHAAqH;IACrH,cAAc,EAAE,kBAAwC;IAExD,wGAAwG;IACxG,mBAAmB,EAAE,MAAM;IAE3B,8CAA8C;IAC9C,QAAQ,EAAE;QACR,4FAA4F;QAC5F,QAAQ,EAAE,4CAAqD;QAC/D,wHAAwH;QACxH,SAAS,EAAE,4CAAqD;QAChE,qJAAqJ;QACrJ,iBAAiB,EAAE,4CAAqD;QACxE,4HAA4H;QAC5H,iBAAiB,EAAE,4CAAqD;QACxE,kJAAkJ;QAClJ,cAAc,EAAE,4CAAqD;QACrE,4JAA4J;QAC5J,kBAAkB,EAAE,4CAAqD;QACzE,mGAAmG;QACnG,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,MAAM;KACrB;CACO,CAAC"}

package/dist/connect/ack.d.ts

@@ -18,6 +18,7 @@
 import { type Address } from "viem";
 import type { UnsignedCall } from "../build.js";
 import type { Admitted } from "./gate.js";
+import type { SolanaVaultEntry } from "../registry-schema.js";
 /** How long an acknowledgement stays usable: long enough to read it and answer, not long enough to forget it. */
 export declare const ACK_TTL_MS: number;
 export interface PendingAck {
@@ -29,21 +30,35 @@ export interface PendingAck {
 /** What the calls ARE: the connected account and each call's chain, destination, calldata and value. */
 export declare function callsDigest(calls: UnsignedCall[], account: Address): string;
 export declare function issueAck(calls: UnsignedCall[], account: Address, now: Date): PendingAck;
+/**
+ * What a Solana intent IS: the connected account, the vault, the action and its raw amount. Not the
+ * transaction's bytes — those name a blockhash that expires in about a minute, so the page builds a fresh
+ * transaction for the same intent, and the gate holds every one of them to it. A withdrawal by amount is
+ * `withdraw-assets` with the asset's raw amount: the shares worth it change as the vault earns, so they are
+ * worked out only once the acknowledgement is accepted.
+ */
+export declare function solanaIntentDigest(account: string, vault: string, action: "deposit" | "withdraw" | "withdraw-assets", raw: bigint): string;
+export declare function issueAckForDigest(digest: string, now: Date): PendingAck;
 /** Throws unless `code` names `pending`, it is unexpired, and it was issued for exactly these calls. */
 export declare function checkAck(code: string, pending: PendingAck | undefined, calls: UnsignedCall[], account: Address, now: Date): void;
+/** `checkAck` against a digest computed by the caller (a Solana intent's). */
+export declare function checkAckDigest(code: string, pending: PendingAck | undefined, digest: string, now: Date): void;
 export interface AckSummary {
     action: "deposit" | "withdraw";
     amount: string;
     /** The vault's asset (USDC; USDG on Robinhood Chain): what a withdrawal pays out. */
     asset: string;
     chain: string;
-    chainId: number;
+    /** `null` on Solana, which has no chain id; the text then names the cluster. */
+    chainId: number | null;
     vault: {
         symbol: string;
         name: string;
         address: string;
         explorer: string;
     };
+    /** What the wallet will ask; the EVM default (approve then deposit, or one withdrawal) when absent. */
+    prompts?: string;
     receiver: string;
     warning: string;
     disclosures: string[];
@@ -55,5 +70,77 @@ export interface AckSummary {
  */
 export declare function operatorWarning(w: string, action?: "deposit" | "withdraw"): string;
 export declare function summarize(action: "deposit" | "withdraw", calls: UnsignedCall[], admitted: Admitted[], receiver: Address): AckSummary;
+/** The summary for a Solana intent: one transaction, no approve, and shares only ever to the account itself. */
+export declare function summarizeSolana(action: "deposit" | "withdraw", v: SolanaVaultEntry, amountText: string, account: string): AckSummary;
 /** The text the operator reads. Generated, never paraphrased: the same calls always produce the same words. */
 export declare function acknowledgementText(s: AckSummary): string;
+/**
+ * A plan: one acknowledgement for several deposits and withdrawals, across vaults and chains (`connect plan`).
+ *
+ * Each leg is bound to the same digest its own `--ack` would be (`callsDigest`, `solanaIntentDigest`), so a
+ * leg run rebuilds its calls exactly as a single acknowledgement does and is held to them. The plan's code
+ * is spent leg by leg, in order: a leg that does not complete ends the plan, and the legs after it never run.
+ */
+export declare const PLAN_TTL_MS: number;
+/** Past this many legs, the operator is better served by more than one plan. */
+export declare const PLAN_MAX_LEGS = 8;
+export type PlanLegStatus = "pending" | "running" | "completed" | "stopped" | "not_reported";
+export interface PlanLeg {
+    leg: number;
+    action: "deposit" | "withdraw";
+    vault: string;
+    chain: string;
+    amount: string;
+    digest: string;
+    /** The exact command that runs this leg once the plan is acknowledged. */
+    command: string;
+    /** What that command builds the leg's calls from: how `connect plan --run` rebuilds them for its one page. */
+    args?: PlanLegArgs;
+    status: PlanLegStatus;
+    txs?: PlanTx[];
+    reason?: string;
+}
+/** A leg's transaction as the plan keeps it: its hash, its verdict, and anything else the wallet moved with it. */
+export interface PlanTx {
+    hash: string;
+    verified: string;
+    alsoMoved?: {
+        to: string;
+        amountRaw: string;
+    }[];
+}
+export interface PlanLegArgs {
+    vault: string;
+    receiver: string;
+    amount_usdc?: string;
+    all?: boolean;
+    shares_exact?: string;
+}
+export interface PendingPlan {
+    code: string;
+    issuedAtIso: string;
+    expiresAtIso: string;
+    acknowledged: boolean;
+    legs: PlanLeg[];
+    /**
+     * The one page `connect plan --run` serves for this plan: its secret and port, kept so a run that stops at the
+     * shell's time limit and the run after it serve the same page, and the operator's open tab carries on.
+     */
+    page?: {
+        secret: string;
+        port: number;
+    };
+}
+/** What a plan IS: its legs' digests, in order. Reordering, adding or dropping a leg changes it. */
+export declare function planDigest(digests: string[]): string;
+export declare function issuePlan(legs: Omit<PlanLeg, "status">[], now: Date): PendingPlan;
+export declare const planExpired: (p: PendingPlan, now: Date) => boolean;
+/** Throws unless `code` names the pending plan, it is unexpired and not yet acknowledged, and its legs are exactly `digests`. */
+export declare function checkPlanAck(code: string, plan: PendingPlan | undefined, digests: string[], now: Date): void;
+/**
+ * Throws unless leg `leg` of the acknowledged plan `code` may run now, for exactly `digest`: the plan is
+ * acknowledged and unexpired, every earlier leg completed, and this leg has not run. Returns its index.
+ */
+export declare function checkPlanLeg(code: string, leg: number, plan: PendingPlan | undefined, digest: string, now: Date): number;
+/** The text the operator reads for a plan: every leg, then each warning and the disclosures once. */
+export declare function planAcknowledgementText(legs: AckSummary[], totals: string[]): string;

package/dist/connect/ack.js

@@ -26,7 +26,19 @@ export function callsDigest(calls, account) {
     return keccak256(stringToHex(JSON.stringify([account, calls.map((c) => [c.chainId, c.to, c.data, c.value])])));
 }
 export function issueAck(calls, account, now) {
-    const digest = callsDigest(calls, account);
+    return issueAckForDigest(callsDigest(calls, account), now);
+}
+/**
+ * What a Solana intent IS: the connected account, the vault, the action and its raw amount. Not the
+ * transaction's bytes — those name a blockhash that expires in about a minute, so the page builds a fresh
+ * transaction for the same intent, and the gate holds every one of them to it. A withdrawal by amount is
+ * `withdraw-assets` with the asset's raw amount: the shares worth it change as the vault earns, so they are
+ * worked out only once the acknowledgement is accepted.
+ */
+export function solanaIntentDigest(account, vault, action, raw) {
+    return keccak256(stringToHex(JSON.stringify(["solana", account, vault, action, raw.toString()])));
+}
+export function issueAckForDigest(digest, now) {
     const issuedAtIso = now.toISOString();
     return {
         code: keccak256(stringToHex(`${digest}|${issuedAtIso}`)).slice(2, 10),
@@ -37,6 +49,10 @@ export function issueAck(calls, account, now) {
 }
 /** Throws unless `code` names `pending`, it is unexpired, and it was issued for exactly these calls. */
 export function checkAck(code, pending, calls, account, now) {
+    checkAckDigest(code, pending, callsDigest(calls, account), now);
+}
+/** `checkAck` against a digest computed by the caller (a Solana intent's). */
+export function checkAckDigest(code, pending, digest, now) {
     const again = "run the same command without --ack, post its `acknowledgement` to the operator, and wait for their yes";
     if (!pending)
         throw new Error(`refused: no acknowledgement is pending; ${again}`);
@@ -46,7 +62,7 @@ export function checkAck(code, pending, calls, account, now) {
     // A missing or unreadable expiry counts as expired, never as no expiry.
     if (!Number.isFinite(expires) || now.getTime() > expires)
         throw new Error(`refused: the acknowledgement expired at ${pending.expiresAtIso}; ${again}`);
-    if (callsDigest(calls, account) !== pending.digest) {
+    if (digest !== pending.digest) {
         throw new Error(`refused: these calls are not the ones the operator acknowledged (the amount, vault, chain, receiver or connected account changed); ${again}`);
     }
 }
@@ -83,17 +99,37 @@ export function summarize(action, calls, admitted, receiver) {
             : [...DISCLOSURES.plain.always],
     };
 }
+/** The summary for a Solana intent: one transaction, no approve, and shares only ever to the account itself. */
+export function summarizeSolana(action, v, amountText, account) {
+    return {
+        action,
+        amount: amountText,
+        asset: v.asset.symbol,
+        chain: "Solana",
+        chainId: null,
+        vault: { symbol: v.symbol, name: v.name, address: v.address, explorer: `https://solscan.io/account/${v.address}` },
+        receiver: account,
+        warning: operatorWarning(v.warning, action),
+        prompts: action === "deposit"
+            ? "Your wallet will ask you once, to make the deposit. A first deposit also opens your share account, which takes about 0.002 SOL of rent."
+            : "Your wallet will ask you once, to make the withdrawal. Kamino keeps up to 0.001 USDC of each withdraw instruction in the vault, a charge it sets and can change.",
+        disclosures: action === "deposit"
+            ? [...DISCLOSURES.plain.deposit, ...(v.depositOpen.open ? [] : [DISCLOSURES.plain.gatedDeposit]), ...DISCLOSURES.plain.always]
+            : [...DISCLOSURES.plain.always],
+    };
+}
 /** The text the operator reads. Generated, never paraphrased: the same calls always produce the same words. */
 export function acknowledgementText(s) {
     const lands = s.action === "deposit" ? "Shares go to" : `${s.asset} goes to`;
-    const prompts = s.action === "deposit"
-        ? `Your wallet will ask you twice: first to approve ${s.amount} to the vault, then to make the deposit.`
-        : `Your wallet will ask you once, to make the withdrawal.`;
+    const prompts = s.prompts ??
+        (s.action === "deposit"
+            ? `Your wallet will ask you twice: first to approve ${s.amount} to the vault, then to make the deposit.`
+            : `Your wallet will ask you once, to make the withdrawal.`);
     return [
         `Confirm before the signing page opens. Nothing has been sent.`,
         ``,
         `  ${s.action === "deposit" ? "Deposit" : "Withdraw"}: ${s.amount}`,
-        `  Chain: ${s.chain} (chainId ${s.chainId})`,
+        s.chainId === null ? `  Chain: ${s.chain} (mainnet-beta)` : `  Chain: ${s.chain} (chainId ${s.chainId})`,
         `  Vault: ${s.vault.name} (${s.vault.symbol})`,
         `         ${s.vault.explorer}`,
         `  ${lands}: ${s.receiver} (the connected wallet)`,
@@ -108,4 +144,139 @@ export function acknowledgementText(s) {
         `Do you acknowledge and want the signing page opened for exactly this ${s.action}? Reply yes or no.`,
     ].join("\n");
 }
+/**
+ * A plan: one acknowledgement for several deposits and withdrawals, across vaults and chains (`connect plan`).
+ *
+ * Each leg is bound to the same digest its own `--ack` would be (`callsDigest`, `solanaIntentDigest`), so a
+ * leg run rebuilds its calls exactly as a single acknowledgement does and is held to them. The plan's code
+ * is spent leg by leg, in order: a leg that does not complete ends the plan, and the legs after it never run.
+ */
+export const PLAN_TTL_MS = 60 * 60_000;
+/** Past this many legs, the operator is better served by more than one plan. */
+export const PLAN_MAX_LEGS = 8;
+/** What a plan IS: its legs' digests, in order. Reordering, adding or dropping a leg changes it. */
+export function planDigest(digests) {
+    return keccak256(stringToHex(JSON.stringify(["plan", digests])));
+}
+export function issuePlan(legs, now) {
+    const a = issueAckForDigest(planDigest(legs.map((l) => l.digest)), now);
+    return {
+        code: a.code,
+        issuedAtIso: a.issuedAtIso,
+        expiresAtIso: new Date(now.getTime() + PLAN_TTL_MS).toISOString(),
+        acknowledged: false,
+        legs: legs.map((l) => ({ ...l, status: "pending" })),
+    };
+}
+export const planExpired = (p, now) => {
+    const expires = Date.parse(p.expiresAtIso);
+    // A missing or unreadable expiry counts as expired, never as no expiry.
+    return !Number.isFinite(expires) || now.getTime() > expires;
+};
+/** Throws unless `code` names the pending plan, it is unexpired and not yet acknowledged, and its legs are exactly `digests`. */
+export function checkPlanAck(code, plan, digests, now) {
+    const again = "run the same `connect plan` without --ack, post its `acknowledgement` to the operator, and wait for their yes";
+    if (!plan)
+        throw new Error(`refused: no plan is pending; ${again}`);
+    if (code.trim().toLowerCase() !== plan.code)
+        throw new Error(`refused: --ack ${code} is not the pending plan's code; ${again}`);
+    if (planExpired(plan, now))
+        throw new Error(`refused: the plan expired at ${plan.expiresAtIso}; ${again}`);
+    if (plan.acknowledged)
+        throw new Error(`refused: this plan was already acknowledged; run its legs (\`connect plan --status\` lists them)`);
+    if (planDigest(digests) !== planDigest(plan.legs.map((l) => l.digest))) {
+        throw new Error(`refused: these legs are not the ones the operator acknowledged (a leg, its order, amount, vault, or a share balance changed); ${again}`);
+    }
+}
+/**
+ * Throws unless leg `leg` of the acknowledged plan `code` may run now, for exactly `digest`: the plan is
+ * acknowledged and unexpired, every earlier leg completed, and this leg has not run. Returns its index.
+ */
+export function checkPlanLeg(code, leg, plan, digest, now) {
+    const again = "acknowledge a new plan with `connect plan`";
+    if (!plan)
+        throw new Error(`refused: no plan is pending; ${again}`);
+    if (code.trim().toLowerCase() !== plan.code)
+        throw new Error(`refused: --plan ${code} is not the pending plan's code; ${again}`);
+    if (!plan.acknowledged)
+        throw new Error(`refused: plan ${plan.code} has not been acknowledged; post its acknowledgement and, on the operator's yes, run \`connect plan\` with --ack ${plan.code}`);
+    if (planExpired(plan, now))
+        throw new Error(`refused: the plan expired at ${plan.expiresAtIso}; legs that have not started do not run; ${again}`);
+    const i = plan.legs.findIndex((l) => l.leg === leg);
+    if (i < 0)
+        throw new Error(`refused: plan ${plan.code} has no leg ${leg}; it has legs 1 to ${plan.legs.length}`);
+    const ended = plan.legs.find((l) => l.status !== "pending" && l.status !== "completed");
+    if (ended && ended.leg !== leg) {
+        throw new Error(ended.status === "running"
+            ? `refused: leg ${ended.leg} is still running, or its run never finished; no later leg runs until it has completed`
+            : `refused: the plan ended at leg ${ended.leg} (${ended.status}), so no later leg runs; ${again}`);
+    }
+    if (plan.legs[i].status !== "pending")
+        throw new Error(`refused: leg ${leg} has already run (${plan.legs[i].status})`);
+    const before = plan.legs.slice(0, i).find((l) => l.status !== "completed");
+    if (before)
+        throw new Error(`refused: legs run in order, and leg ${before.leg} has not completed; run it first`);
+    if (digest !== plan.legs[i].digest) {
+        throw new Error(`refused: these calls are not leg ${leg} as the operator acknowledged it (the amount, vault, chain, receiver or connected account changed); ${again}`);
+    }
+    return i;
+}
+/** The text the operator reads for a plan: every leg, then each warning and the disclosures once. */
+export function planAcknowledgementText(legs, totals) {
+    const n = legs.length;
+    // One warning per text, naming every vault it covers. A withdrawal's warning is the deposit's without its advice on
+    // how much to deposit (`operatorWarning`), so the two are one warning, with that advice named for the deposits only.
+    const advice = (w) => w.match(/Deposit only .*?\.(?=\s|$)/g)?.join(" ") ?? "";
+    const warnings = [];
+    for (const s of legs) {
+        const base = operatorWarning(s.warning, "withdraw");
+        const w = warnings.find((x) => x.text === base) ?? warnings[warnings.push({ text: base, vaults: [], advice: "", depositVaults: [] }) - 1];
+        if (!w.vaults.includes(s.vault.symbol))
+            w.vaults.push(s.vault.symbol);
+        if (s.action === "deposit" && advice(s.warning)) {
+            w.advice = advice(s.warning);
+            if (!w.depositVaults.includes(s.vault.symbol))
+                w.depositVaults.push(s.vault.symbol);
+        }
+    }
+    const several = new Set(legs.map((s) => s.vault.symbol)).size > 1;
+    const fees = DISCLOSURES.plain.deposit.find((d) => d.startsWith("Tempora Labs runs this vault"));
+    const disclosures = [...new Set(legs.flatMap((s) => s.disclosures))].map((d) => (several && d === fees ? DISCLOSURES.plain.feesSeveral : d));
+    const minutes = Math.round(PLAN_TTL_MS / 60_000);
+    const legLines = legs.flatMap((s, i) => {
+        const lands = s.action === "deposit" ? "Shares go to" : `${s.asset} goes to`;
+        const prompts = s.prompts ??
+            (s.action === "deposit"
+                ? `Your wallet will ask you twice: first to approve ${s.amount} to the vault, then to make the deposit.`
+                : `Your wallet will ask you once, to make the withdrawal.`);
+        return [
+            `  ${i + 1}. ${s.action === "deposit" ? "Deposit" : "Withdraw"}: ${s.amount}`,
+            s.chainId === null ? `     Chain: ${s.chain} (mainnet-beta)` : `     Chain: ${s.chain} (chainId ${s.chainId})`,
+            `     Vault: ${s.vault.name} (${s.vault.symbol})`,
+            `            ${s.vault.explorer}`,
+            `     ${lands}: ${s.receiver} (the connected wallet)`,
+            `     ${prompts}`,
+            ``,
+        ];
+    });
+    return [
+        `Confirm before any signing page opens. Nothing has been sent.`,
+        ``,
+        `This plan has ${n} ${n === 1 ? "leg" : "legs"}, run in this order on one signing page, where your wallet asks you to confirm each transaction. If a leg does not complete, the legs after it do not run.`,
+        `The plan lasts ${minutes} minutes: a leg not started by then does not run, and connecting a wallet again cancels it. To stop partway, reject a transaction in your wallet, or stop the plan on the signing page; the legs after it then do not run.`,
+        ``,
+        ...legLines,
+        ...(totals.length ? [`In total: ${totals.join("; ")}.`, ``] : []),
+        ...warnings.flatMap((w) => [
+            `WARNING (${w.vaults.join(", ")}): ${w.text}`,
+            ...(w.advice ? [`  For the ${w.depositVaults.length === 1 ? "deposit" : "deposits"} (${w.depositVaults.join(", ")}): ${w.advice}`] : []),
+        ]),
+        ``,
+        `Before you agree:`,
+        ...disclosures.map((d) => `  - ${d}`),
+        `  ${DISCLOSURES.plain.fullTerms}`,
+        ``,
+        `Do you acknowledge and want the signing page opened for exactly these ${n} ${n === 1 ? "leg" : "legs"}, run one leg at a time? Reply yes or no.`,
+    ].join("\n");
+}
 //# sourceMappingURL=ack.js.map

package/dist/connect/ack.js.map

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

package/dist/connect/commands.d.ts

@@ -19,6 +19,7 @@ import { type Address, type Hex } from "viem";
 import { type UnsignedCall } from "../build.js";
 import { makePublicClient } from "../client.js";
 import type { Command } from "../earn/commands.js";
+import { type SolanaFlowDeps } from "./solana.js";
 import { type Settled } from "./http.js";
 import { type Session } from "./session.js";
 import { type Verdict } from "./verify.js";
@@ -48,6 +49,10 @@ export interface ConnectDeps {
     balanceTimeoutMs?: number;
     /** The clock acknowledgements are issued and checked against (tests). */
     now?: () => Date;
+    /** The Solana flows' chain reads (tests). */
+    solanaRpc?: SolanaFlowDeps["rpc"];
+    /** Overrides the page time `connect plan --run` keeps back before starting a leg (tests). */
+    legMinMs?: number;
 }
 export declare function runConnect(deps?: ConnectDeps): Promise<{
     result: Settled<Session>;
@@ -59,6 +64,31 @@ interface TxOutcome extends Verdict {
     description: string;
     hash: string;
 }
+/** One leg's confirm core: the gate, the chain reads, and the step-by-step verdicts, without the page around it. */
+export interface ConfirmCore {
+    chainId: number;
+    calls: UnsignedCall[];
+    done: TxOutcome[];
+    stopReason: () => string | undefined;
+    info: () => Record<string, unknown>;
+    /** Records the hash for step `index`, reads its receipt, and says whether the next step may go. */
+    accept: (index: unknown, hash: unknown) => Promise<{
+        ok: false;
+        reason: string;
+    } | {
+        ok: true;
+        kind: "next" | "finished" | "stop";
+        reply: Record<string, unknown>;
+    }>;
+    /** Puts a hash the page could not hand over on record, against the step it names. */
+    onReject: (body: Record<string, unknown>) => void;
+}
+/**
+ * The confirm flow without its page: the gate runs here, on exactly the calls the page will hand the
+ * wallet, so no caller can pass a check for one batch and the calls of another. It throws before any
+ * page opens. `deadline`: when the page closes, so every chain read stops waiting by then.
+ */
+export declare function prepareConfirm(calls: UnsignedCall[], session: Session, deps: ConnectDeps, deadline: number): Promise<ConfirmCore>;
 export declare function runConfirm(calls: UnsignedCall[], session: Session, deps?: ConnectDeps): Promise<{
     result: Settled<TxOutcome[]>;
     url: string;