@eco-incorp/sauce 0.99.5 → 0.99.7

package/sdk/dist/cli/support.js

@@ -0,0 +1,217 @@
+/**
+ * WHICH CHAINS THE `sauce` COMMAND AND ITS MCP SERVER BUILD TRANSACTIONS ON, and the gate that holds
+ * them to it — the CLI's own policy, not the SDK's: the registry keeps every chain and protocol,
+ * and the SDK's builders take any of them. Nothing outside `sdk/src/cli/` reads this module, and the
+ * package exports none of it; the MCP server imports it from here (`mcp/src/sdk.ts`), and the
+ * skills' generator and checker read the built module.
+ *
+ * For the initial release the command supports transactions on three chains: Ethereum, Base and
+ * Solana ({@link SUPPORTED_CHAIN_SLUGS}). Every other canonical chain is a PREVIEW chain: a program
+ * for it compiles, and the command simulates, rehearses and reads there, but builds no transaction
+ * for it to sign and sends none.
+ *
+ * {@link requireSupported} is the gate, called from the command functions both front ends call
+ * (`txCommand`, `runCommand`, `potDeployCommand`, `publishCommand`, `fillCommand`, the lifecycle's
+ * `build*`) and, where a front end reaches a network or a key before those, from the front end
+ * too. Anything that leaves a transaction ready to sign — the unsigned JSON included — or sends one
+ * is refused on a preview chain: the cook (`tx`, `run`), a Pot's deployment, publishing intents,
+ * and every lifecycle step. A cook or a publish is refused by its own chain and each destination of
+ * the intents it opens ({@link intentDestinations}); each lifecycle step by the chain it is sent on.
+ * Compiling, simulating, dry runs and reads are never refused.
+ *
+ * A developer who needs another chain asks for it with a GitHub issue on the repository, from the
+ * issue form `.github/ISSUE_TEMPLATE/chain-support.yml`, or adds a use case to the request already
+ * open for that chain. {@link chainSupportRequest} builds both links and the text to post; the
+ * form's field ids are {@link CHAIN_SUPPORT_FIELDS}, which `test/cli-chain-support.test.ts` holds
+ * to the form. The refusal carries them as a message for a person and as
+ * {@link PreviewChainRefusal} for an agent: the MCP server returns that structure as the result.
+ */
+import { canonicalChains, chainBySlug, requireChain, } from "../chains/canonical.js";
+import { CliError } from "./args.js";
+/** The chains the release supports, by slug, in the order the docs name them. */
+export const SUPPORTED_CHAIN_SLUGS = ["ethereum", "base", "solana"];
+const SUPPORTED = new Set(SUPPORTED_CHAIN_SLUGS.map((slug) => {
+    const chain = chainBySlug(slug);
+    if (chain === undefined)
+        throw new Error(`cli/support: '${slug}' is not a canonical chain`);
+    return chain.id;
+}));
+/** Whether the release supports `ref`'s chain (`supported`) or only previews it (`preview`).
+ *  Throws for a chain the registry does not have. */
+export function chainSupport(ref) {
+    return SUPPORTED.has(requireChain(ref).id) ? "supported" : "preview";
+}
+/** `chainSupport(ref) === "supported"`; false for a chain the registry does not have. */
+export function isSupportedChain(ref) {
+    try {
+        return chainSupport(ref) === "supported";
+    }
+    catch {
+        return false;
+    }
+}
+/** The supported chains, in {@link SUPPORTED_CHAIN_SLUGS}' order. */
+export function supportedChains() {
+    return SUPPORTED_CHAIN_SLUGS.map((slug) => chainBySlug(slug));
+}
+/** Every other chain of the registry, id-ascending. */
+export function previewChains() {
+    return canonicalChains
+        .filter((chain) => !SUPPORTED.has(chain.id))
+        .slice()
+        .sort((a, b) => a.id - b.id);
+}
+// ---------------------------------------------------------------------------------------------
+// Requesting a chain
+// ---------------------------------------------------------------------------------------------
+/** Where chain-support requests are filed. */
+export const CHAIN_SUPPORT_REPOSITORY = "eco-incorp/sauce";
+/** The label the issue form puts on every request, which the search for one filters on. */
+export const CHAIN_SUPPORT_LABEL = "chain-support";
+/** The issue form, under `.github/ISSUE_TEMPLATE/`. */
+export const CHAIN_SUPPORT_TEMPLATE = "chain-support.yml";
+/** What every request's title starts with. */
+export const CHAIN_SUPPORT_TITLE_PREFIX = "Chain support: ";
+/** The issue form's fields by id: the query parameters a new-issue URL prefills them with. */
+export const CHAIN_SUPPORT_FIELDS = {
+    chain: "chain",
+    chainId: "chain-id",
+    useCase: "use-case",
+    protocols: "protocols",
+    volume: "volume",
+    contact: "contact",
+};
+/** The form's labels for those fields, the headings an issue made from it carries. */
+const FIELD_LABELS = {
+    chain: "Chain",
+    chainId: "Chain id",
+    useCase: "What you want to run there",
+    protocols: "Protocols and tokens",
+    volume: "Expected volume and timing",
+    contact: "Contact",
+};
+const GITHUB = `https://github.com/${CHAIN_SUPPORT_REPOSITORY}`;
+/** A new chain-support request with nothing filled in: the form alone. */
+export const CHAIN_SUPPORT_NEW_ISSUE_URL = `${GITHUB}/issues/new?template=${CHAIN_SUPPORT_TEMPLATE}`;
+/** Every chain-support request, open or closed. */
+export const CHAIN_SUPPORT_ISSUES_URL = `${GITHUB}/issues?${new URLSearchParams({
+    q: `is:issue label:${CHAIN_SUPPORT_LABEL}`,
+})}`;
+/** The chain a request names: a registry chain by its record, or one it does not have as given. */
+function requested(chain) {
+    if (typeof chain === "object" && !("slug" in chain)) {
+        return { name: chain.name, ...(chain.id === undefined ? {} : { id: chain.id }) };
+    }
+    const known = requireChain(chain);
+    return { name: known.name, id: known.id, slug: known.slug };
+}
+/**
+ * The request for `chain` — a registry chain (`ChainRef`), or `{ name, id }` for one it does not
+ * have — with the `details` known so far filled in and the rest left as `<placeholders>`.
+ */
+export function chainSupportRequest(chain, details = {}) {
+    const named = requested(chain);
+    const title = `${CHAIN_SUPPORT_TITLE_PREFIX}${named.name}${named.id === undefined ? "" : ` (${named.id})`}`;
+    const values = {
+        chain: named.name,
+        ...(named.id === undefined ? {} : { chainId: String(named.id) }),
+        ...details,
+    };
+    const prefilled = new URLSearchParams({ template: CHAIN_SUPPORT_TEMPLATE, title });
+    for (const [key, id] of Object.entries(CHAIN_SUPPORT_FIELDS)) {
+        const value = values[key];
+        if (value !== undefined && value !== "")
+            prefilled.set(id, value);
+    }
+    // What the form leaves for the requester: GitHub writes `_No response_` for an empty field.
+    const placeholder = {
+        chain: named.name,
+        chainId: "<its chain id>",
+        useCase: `<what you want to run on ${named.name}>`,
+        protocols: "<the protocols and tokens it needs>",
+        volume: "<the volume you expect, and from when>",
+        contact: "_No response_",
+    };
+    const body = Object.keys(FIELD_LABELS)
+        .map((key) => `### ${FIELD_LABELS[key]}\n\n${values[key] ?? placeholder[key]}`)
+        .join("\n\n");
+    const comment = [
+        `Another use case for ${named.name}${named.id === undefined ? "" : ` (${named.id})`}:`,
+        "",
+        `- ${FIELD_LABELS.useCase}: ${values.useCase ?? placeholder.useCase}`,
+        `- ${FIELD_LABELS.protocols}: ${values.protocols ?? placeholder.protocols}`,
+        `- ${FIELD_LABELS.volume}: ${values.volume ?? placeholder.volume}`,
+    ].join("\n");
+    return {
+        chain: named,
+        title,
+        searchUrl: `${GITHUB}/issues?${new URLSearchParams({
+            q: `is:issue label:${CHAIN_SUPPORT_LABEL} "${named.name}"`,
+        })}`,
+        newIssueUrl: `${GITHUB}/issues/new?${prefilled}`,
+        body,
+        comment,
+    };
+}
+/** A refusal on a preview chain: exit 1 from the command, a structured result from a tool. */
+export class PreviewChainError extends CliError {
+    refusal;
+    constructor(refusal) {
+        super(refusal.message);
+        this.refusal = refusal;
+    }
+}
+const summary = (chain) => ({
+    slug: chain.slug,
+    id: chain.id,
+    name: chain.name,
+});
+/** `["a", "b", "c"]` as "a, b and c". */
+const listed = (words) => words.length <= 1 ? (words[0] ?? "") : `${words.slice(0, -1).join(", ")} and ${words.at(-1)}`;
+/** The supported chains by name, as every message says them: "Ethereum, Base and Solana". */
+export const supportedChainNames = () => listed(supportedChains().map((c) => c.name));
+/** One sentence of what a preview chain still does, for a help text or a note. */
+export const previewChainsNote = () => `For the initial release, transactions are built and sent only on ${supportedChainNames()}. ` +
+    "Every other chain is a preview chain: programs compile there, and simulate, dry runs and " +
+    `reads work, but no transaction is built or sent. Ask for a chain: ${CHAIN_SUPPORT_NEW_ISSUE_URL}`;
+/** The refusal of `action` for the preview chains among `chains`; `undefined` when there is none. */
+export function previewRefusal(action, chains) {
+    const preview = [...new Map(chains.map((chain) => [chain.id, chain])).values()].filter((chain) => !isSupportedChain(chain));
+    if (preview.length === 0)
+        return undefined;
+    const named = listed(preview.map((chain) => `${chain.slug} (${chain.name}, chain id ${chain.id})`));
+    const requests = preview.map((chain) => ({
+        ...summary(chain),
+        request: chainSupportRequest(chain),
+    }));
+    const message = [
+        `${action} is refused: it involves ${named}, ${preview.length === 1 ? "a preview chain" : "preview chains"}. ` +
+            `For the initial release, the sauce command and its MCP server build and send transactions ` +
+            `only on ${supportedChainNames()}. On a preview chain a program still compiles, and ` +
+            "simulate and dry runs rehearse it.",
+        ...requests.map(({ name, request }) => `To ask for ${name}: add your use case to its request if there is one ` +
+            `(${request.searchUrl}), or open one (${request.newIssueUrl}).`),
+    ].join("\n");
+    return {
+        code: "preview-chain",
+        action,
+        message,
+        supportedChains: supportedChains().map(summary),
+        previewChains: requests,
+    };
+}
+/** Throws {@link PreviewChainError} when any of `chains` is a preview chain. */
+export function requireSupported(action, chains) {
+    const refusal = previewRefusal(action, chains);
+    if (refusal !== undefined)
+        throw new PreviewChainError(refusal);
+}
+/**
+ * The chain each of `intents` delivers to: what a cook or a publish that opens them is refused by,
+ * beside its own. An intent its body opens on the destination in turn (a cascade) is not among
+ * them: the lowering reports the intents a program opens itself, and no more.
+ */
+export function intentDestinations(intents) {
+    return intents.map((intent) => intent.destination);
+}
+//# sourceMappingURL=support.js.map

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

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

package/sdk/dist/cli/svm-effects.d.ts

@@ -0,0 +1,50 @@
+/**
+ * What a simulated Solana cook moved: each writable account of the transaction read before it and
+ * as the simulation leaves it (`simulateTransaction`'s `accounts`, through the SDK client's
+ * `simulate`), and the difference — the SPL token balances of the token accounts among them, and
+ * every account's lamports. The Solana counterpart of `effects.ts`, which reads an EVM cook's logs;
+ * an SPL transfer logs nothing a client can decode, so the accounts themselves are the record.
+ */
+import { type Address, type createSolanaRpc, type Transaction } from "@solana/kit";
+import type { CanonicalChain } from "../chains/canonical.js";
+import type { SimulatedAccount } from "../svm/index.js";
+type Rpc = ReturnType<typeof createSolanaRpc>;
+export interface LamportChange {
+    readonly account: Address;
+    readonly before: bigint;
+    readonly after: bigint;
+}
+export interface TokenChange {
+    readonly account: Address;
+    readonly mint: Address;
+    /** Whose token account it is (its SPL owner, the authority that may move it). */
+    readonly owner: Address;
+    readonly before: bigint;
+    readonly after: bigint;
+    readonly decimals?: number;
+    readonly symbol?: string;
+}
+export interface SvmMoved {
+    readonly tokens: readonly TokenChange[];
+    readonly lamports: readonly LamportChange[];
+    readonly labels: ReadonlyMap<string, string>;
+    /** The transaction's fee payer, whose lamports include the fee. */
+    readonly payer: Address;
+}
+/** The writable accounts of `transaction`'s message, in its order: everything a cook can change. */
+export declare function writableAccounts(transaction: Transaction): Address[];
+/** `addresses` as they are now, `null` where an account does not exist. */
+export declare function accountsNow(rpc: Rpc, addresses: readonly Address[]): Promise<(SimulatedAccount | null)[]>;
+/**
+ * What changed between `before` and `after` for each of `tracked`: the token accounts' balances
+ * (a token account the cook created starts at 0, one it closed ends at 0), and every account's
+ * lamports. Each mint's decimals are read from the cluster, else taken from the registry, which
+ * also names a mint it records.
+ */
+export declare function movedBy(rpc: Rpc, chain: CanonicalChain, tracked: readonly Address[], before: readonly (SimulatedAccount | null)[], after: readonly (SimulatedAccount | null)[], labels: ReadonlyMap<string, string>, payer: Address): Promise<SvmMoved>;
+/** What moved, for a person. */
+export declare function svmMovedLines(moved: SvmMoved): string[];
+/** What moved, for a program: amounts in base units as decimal strings. */
+export declare function svmMovedJson(moved: SvmMoved): Record<string, unknown>;
+export {};
+//# sourceMappingURL=svm-effects.d.ts.map

package/sdk/dist/cli/svm-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svm-effects.d.ts","sourceRoot":"","sources":["../../src/cli/svm-effects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAc9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,EAAE,CAkBpE;AAID,2EAA2E;AAC3E,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,OAAO,EAAE,GAC5B,OAAO,CAAC,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAC,CActC;AAmCD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAC5C,KAAK,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,QAAQ,CAAC,CAwDnB;AAkBD,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAyBvD;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCrE"}

package/sdk/dist/cli/svm-effects.js

@@ -0,0 +1,196 @@
+/**
+ * What a simulated Solana cook moved: each writable account of the transaction read before it and
+ * as the simulation leaves it (`simulateTransaction`'s `accounts`, through the SDK client's
+ * `simulate`), and the difference — the SPL token balances of the token accounts among them, and
+ * every account's lamports. The Solana counterpart of `effects.ts`, which reads an EVM cook's logs;
+ * an SPL transfer logs nothing a client can decode, so the accounts themselves are the record.
+ */
+import { getAddressDecoder, getAddressEncoder, getBase64Encoder, getCompiledTransactionMessageDecoder, } from "@solana/kit";
+import { bytesToHex, formatUnits } from "viem";
+import { sourceGlobals } from "../routes/source-globals.js";
+/** SPL Token and Token-2022: the programs whose accounts hold a token balance. */
+const TOKEN_PROGRAMS = new Set([
+    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+    "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
+]);
+/** An SPL token account's base layout: mint, owner, amount (u64 LE), and 165 bytes in all. */
+const TOKEN_ACCOUNT_SIZE = 165;
+/** Token-2022 marks an extended account's kind at byte 165: 2 is a token account, 1 a mint. */
+const ACCOUNT_TYPE_TOKEN = 2;
+/** A mint's decimals: after its optional authority (4 + 32 bytes) and its supply (8). */
+const MINT_DECIMALS_AT = 44;
+/** The writable accounts of `transaction`'s message, in its order: everything a cook can change. */
+export function writableAccounts(transaction) {
+    const message = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);
+    const { header, staticAccounts } = message;
+    if (header === undefined || staticAccounts === undefined)
+        return [];
+    const signers = header.numSignerAccounts;
+    return staticAccounts.filter((_, index) => index < signers
+        ? index < signers - header.numReadonlySignerAccounts
+        : index < staticAccounts.length - header.numReadonlyNonSignerAccounts);
+}
+const bytesOf = (base64) => new Uint8Array(getBase64Encoder().encode(base64));
+/** `addresses` as they are now, `null` where an account does not exist. */
+export async function accountsNow(rpc, addresses) {
+    if (addresses.length === 0)
+        return [];
+    const { value } = await rpc.getMultipleAccounts([...addresses], { encoding: "base64" }).send();
+    return value.map((account) => account === null
+        ? null
+        : {
+            lamports: BigInt(account.lamports),
+            owner: account.owner,
+            data: bytesOf(account.data[0]),
+            executable: account.executable,
+        });
+}
+/** A token account's mint, owner and amount, or `undefined` for any other account. */
+function tokenAccount(account) {
+    if (account === null || !TOKEN_PROGRAMS.has(account.owner))
+        return undefined;
+    const { data } = account;
+    if (data.length < TOKEN_ACCOUNT_SIZE ||
+        (data.length > TOKEN_ACCOUNT_SIZE && data[TOKEN_ACCOUNT_SIZE] !== ACCOUNT_TYPE_TOKEN)) {
+        return undefined;
+    }
+    const decoder = getAddressDecoder();
+    return {
+        mint: decoder.decode(data.subarray(0, 32)),
+        owner: decoder.decode(data.subarray(32, 64)),
+        amount: new DataView(data.buffer, data.byteOffset).getBigUint64(64, true),
+    };
+}
+/** The registry's row for `mint` among `tokens`, matched by base58 or by its 32 bytes in hex. */
+function registryRow(tokens, mint) {
+    const hex = bytesToHex(new Uint8Array(getAddressEncoder().encode(mint))).toLowerCase();
+    return tokens.find((token) => token.address === mint || String(token.address).toLowerCase() === hex);
+}
+/**
+ * What changed between `before` and `after` for each of `tracked`: the token accounts' balances
+ * (a token account the cook created starts at 0, one it closed ends at 0), and every account's
+ * lamports. Each mint's decimals are read from the cluster, else taken from the registry, which
+ * also names a mint it records.
+ */
+export async function movedBy(rpc, chain, tracked, before, after, labels, payer) {
+    const tokens = [];
+    const lamports = [];
+    tracked.forEach((account, index) => {
+        const was = before[index] ?? null;
+        const is = after[index] ?? null;
+        const lamportsBefore = was?.lamports ?? 0n;
+        const lamportsAfter = is?.lamports ?? 0n;
+        if (lamportsBefore !== lamportsAfter) {
+            lamports.push({ account, before: lamportsBefore, after: lamportsAfter });
+        }
+        const held = tokenAccount(was);
+        const holds = tokenAccount(is);
+        const seen = holds ?? held;
+        if (seen === undefined)
+            return;
+        const amountBefore = held?.amount ?? 0n;
+        const amountAfter = holds?.amount ?? 0n;
+        if (amountBefore !== amountAfter) {
+            tokens.push({
+                account,
+                mint: seen.mint,
+                owner: seen.owner,
+                before: amountBefore,
+                after: amountAfter,
+            });
+        }
+    });
+    const mints = [...new Set(tokens.map((change) => change.mint))];
+    const decimals = new Map();
+    if (mints.length > 0) {
+        const read = await accountsNow(rpc, mints).catch(() => mints.map(() => null));
+        read.forEach((account, index) => {
+            if (account !== null && account.data.length > MINT_DECIMALS_AT) {
+                decimals.set(mints[index], account.data[MINT_DECIMALS_AT]);
+            }
+        });
+    }
+    const registered = tokens.length === 0 ? [] : sourceGlobals(chain).tokens;
+    return {
+        tokens: tokens.map((change) => {
+            const row = registryRow(registered, change.mint);
+            const places = decimals.get(change.mint) ?? row?.decimals;
+            const symbol = row?.symbol;
+            return {
+                ...change,
+                ...(places === undefined ? {} : { decimals: places }),
+                ...(symbol === undefined ? {} : { symbol }),
+            };
+        }),
+        lamports,
+        labels,
+        payer,
+    };
+}
+const named = (moved, account) => {
+    const label = moved.labels.get(account);
+    return label === undefined ? account : `${account} (${label})`;
+};
+const signed = (amount, decimals, unit) => {
+    const size = amount < 0n ? -amount : amount;
+    const text = decimals === undefined
+        ? `${size} ${unit} (base units)`
+        : `${formatUnits(size, decimals)} ${unit}`;
+    return `${amount < 0n ? "-" : "+"}${text}`;
+};
+/** What moved, for a person. */
+export function svmMovedLines(moved) {
+    const lines = [];
+    if (moved.tokens.length > 0) {
+        lines.push("Token balance changes:");
+        for (const change of moved.tokens) {
+            const unit = change.symbol ?? `of mint ${change.mint}`;
+            lines.push(`  ${named(moved, change.account)}, owned by ${named(moved, change.owner)}: ` +
+                signed(change.after - change.before, change.decimals, unit));
+        }
+    }
+    if (moved.lamports.length > 0) {
+        lines.push("Lamport changes:");
+        for (const change of moved.lamports) {
+            const delta = change.after - change.before;
+            lines.push(`  ${named(moved, change.account)}: ${delta < 0n ? "" : "+"}${delta} lamports` +
+                (change.account === moved.payer ? ", the transaction's fee included" : ""));
+        }
+    }
+    if (lines.length === 0)
+        lines.push("It changed no token balance and no account's lamports.");
+    return lines;
+}
+/** What moved, for a program: amounts in base units as decimal strings. */
+export function svmMovedJson(moved) {
+    const label = (account) => {
+        const name = moved.labels.get(account);
+        return name === undefined ? {} : { label: name };
+    };
+    return {
+        tokenChanges: moved.tokens.map((change) => ({
+            account: change.account,
+            ...label(change.account),
+            mint: change.mint,
+            ...(change.symbol === undefined ? {} : { symbol: change.symbol }),
+            owner: change.owner,
+            before: change.before.toString(),
+            after: change.after.toString(),
+            delta: (change.after - change.before).toString(),
+            ...(change.decimals === undefined
+                ? {}
+                : {
+                    decimals: change.decimals,
+                    formatted: formatUnits(change.after - change.before, change.decimals),
+                }),
+        })),
+        lamportChanges: moved.lamports.map((change) => ({
+            account: change.account,
+            ...label(change.account),
+            before: change.before.toString(),
+            after: change.after.toString(),
+            delta: (change.after - change.before).toString(),
+        })),
+    };
+}
+//# sourceMappingURL=svm-effects.js.map

package/sdk/dist/cli/svm-effects.js.map

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

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

@@ -0,0 +1,42 @@
+/** A terminal to ask on: what it reads, where its prompts go, and how to let it go. */
+export interface Terminal {
+    readonly input: NodeJS.ReadableStream & {
+        setRawMode?: (mode: boolean) => unknown;
+        isTTY?: boolean;
+    };
+    readonly output: NodeJS.WritableStream;
+    readonly close: () => void;
+}
+/** The controlling terminal, `/dev/tty`, opened for a question; `undefined` where there is none. */
+export declare function controllingTerminal(): Terminal | undefined;
+/** What a terminal is chosen from. Injected, so each case can be tested without one. */
+export interface TerminalChoice {
+    /** Whether the program was read from stdin, spending it. */
+    readonly stdinRead: boolean;
+    readonly stdin: Terminal["input"] & {
+        isTTY?: boolean;
+    };
+    readonly stderr: NodeJS.WritableStream;
+    /** Opens the controlling terminal; `undefined` where there is none. */
+    readonly controlling: () => Terminal | undefined;
+}
+/**
+ * The terminal to ask on: stdin while it is an unread terminal; the controlling terminal once stdin
+ * carried the program; else none. A stdin that is not a terminal and was not read (CI, a pipe the
+ * command never reads) asks nothing, as before: the controlling terminal is only the fallback for
+ * the stdin the program itself used up.
+ */
+export declare function chooseTerminal(choice: TerminalChoice): Terminal | undefined;
+/**
+ * Writes `text` to the controlling terminal itself — never to stdout, where a pipe or an agent could
+ * capture it — or, where there is no `/dev/tty` (Windows), to stdout only while stdout is a
+ * terminal. False where there is no terminal at all. What `sauce wallet export` shows a key with.
+ */
+export declare function writeToTerminal(text: string): boolean;
+/** A yes/no answer typed at `terminal`: yes only for `y` or `yes`. */
+export declare function confirmOn(terminal: Terminal, question: string): Promise<boolean>;
+/** A line typed at `terminal`, as typed. */
+export declare function askOn(terminal: Terminal, question: string): Promise<string>;
+/** A password typed at `terminal`, echoing nothing. */
+export declare function passwordOn(terminal: Terminal, prompt: string): Promise<string>;
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/cli/terminal.ts"],"names":[],"mappings":"AAmBA,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QACtC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QACxC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,IAAI,QAAQ,GAAG,SAAS,CA0B1D;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,GAAG,SAAS,CAK3E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBrD;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3E;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC9E"}