@temporalabs/treasury 0.1.1 → 0.1.3

package/dist/earn/solana.d.ts

@@ -0,0 +1,278 @@
+import type { SolanaVaultEntry } from "../registry-schema.js";
+/** Which chain a Solana response is about: the name a caller passes back, and the cluster a wallet must be on. */
+export declare const onSolana: {
+    readonly chain: "solana";
+    readonly chainId: null;
+    readonly cluster: "mainnet-beta";
+    readonly genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+};
+/** The explorer page for a Solana account or transaction. */
+export declare const solscan: (kind: "account" | "tx", id: string) => string;
+/** A Solana address argument, checked here: the CLI's schema accepts either family's address form. */
+export declare function solanaAccount(v: string, what: string): string;
+/** The row `earn vaults` lists for a Solana vault. */
+export declare function solanaVaultRow(v: SolanaVaultEntry): {
+    symbol: string;
+    name: string;
+    warning: string;
+    links: {
+        explorer: string;
+    };
+    backend: "morpho" | "tempora";
+    isDefault: boolean;
+    chain: "solana";
+    chainId: null;
+    address: string & import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58">;
+    chassis: "kamino-vault";
+    asset: {
+        address: string & import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58">;
+        symbol: string;
+        decimals: number;
+    };
+    sharesMint: string & import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58">;
+    shareDecimals: number;
+    depositOpen: {
+        open: boolean;
+        method: "simulated-deposit-from-stranger";
+        measuredAtSlot: number;
+        measuredAtIso: string;
+        reason?: "REVERTED_OTHER" | "PERMISSIONED" | undefined;
+        detail?: string | undefined;
+    };
+    notes: string[];
+};
+/** `earn status` with no account: is the Solana endpoint up, and is it mainnet. Never throws. */
+export declare function solanaHealth(vault: SolanaVaultEntry, partial: Record<string, unknown>): Promise<{
+    rpc: string;
+    latestSlot: null;
+    reason: string;
+    vault: string;
+    rpcSource: string;
+    rpcConfigured: boolean;
+    chain: "solana";
+    chainId: null;
+    cluster: "mainnet-beta";
+    genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+    server: string;
+    version: string;
+    registry: {
+        schemaVersion: 1;
+        vaults: number;
+        reconciledAtIso: string;
+    };
+    mode: string;
+} | {
+    rpc: string;
+    chainVerified: boolean;
+    latestSlot: string;
+    vault: string;
+    rpcSource: string;
+    rpcConfigured: boolean;
+    chain: "solana";
+    chainId: null;
+    cluster: "mainnet-beta";
+    genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+    server: string;
+    version: string;
+    registry: {
+        schemaVersion: 1;
+        vaults: number;
+        reconciledAtIso: string;
+    };
+    mode: string;
+}>;
+/** `earn status --account`: the deposit pre-flight. */
+export declare function solanaPreflight(vault: SolanaVaultEntry, account: string, amountHuman?: string): Promise<{
+    vault: string;
+    depositor: string;
+    status: import("../solana/vault.js").SolanaPreflightStatus;
+    canDeposit: boolean;
+    findings: string[];
+} | {
+    status: import("../solana/vault.js").SolanaPreflightStatus;
+    canDeposit: boolean;
+    findings: string[];
+    vault: string;
+    depositor: string;
+    balances: {
+        asset: string;
+        shares: string;
+    };
+    quotes: {
+        sharePriceInAssets: string;
+    };
+    measuredAtSlot: number;
+} | {
+    status: import("../solana/vault.js").SolanaPreflightStatus;
+    canDeposit: boolean;
+    findings: string[];
+    vault: string;
+    depositor: string;
+    balances: {
+        asset: string;
+        shares: string;
+    };
+    quotes: {
+        sharePriceInAssets: string;
+    };
+    measuredAtSlot: number;
+}>;
+/** `earn quote --direction deposit`. */
+export declare function solanaQuoteDeposit(vault: SolanaVaultEntry, account: string, amountHuman: string): Promise<{
+    vault: string;
+    depositor: string;
+    amountUsdc: string;
+    expectedShares: string;
+    sharePriceInAssets: string | undefined;
+    preflight: {
+        vault: string;
+        depositor: string;
+        status: import("../solana/vault.js").SolanaPreflightStatus;
+        canDeposit: boolean;
+        findings: string[];
+    } | {
+        status: import("../solana/vault.js").SolanaPreflightStatus;
+        canDeposit: boolean;
+        findings: string[];
+        vault: string;
+        depositor: string;
+        balances: {
+            asset: string;
+            shares: string;
+        };
+        quotes: {
+            sharePriceInAssets: string;
+        };
+        measuredAtSlot: number;
+    } | {
+        status: import("../solana/vault.js").SolanaPreflightStatus;
+        canDeposit: boolean;
+        findings: string[];
+        vault: string;
+        depositor: string;
+        balances: {
+            asset: string;
+            shares: string;
+        };
+        quotes: {
+            sharePriceInAssets: string;
+        };
+        measuredAtSlot: number;
+    };
+    note: string;
+}>;
+/** `earn quote --direction withdraw`. */
+export declare function solanaQuoteWithdraw(vault: SolanaVaultEntry, account: string, amountHuman: string): Promise<{
+    canWithdraw: boolean;
+    note: string;
+    vault: string;
+    owner: string;
+    amountUsdc: string;
+    sharesToBurn: string;
+    sharesHeld: string;
+    instantLiquidity: string;
+    sharePriceInAssets: string;
+} | {
+    canWithdraw: boolean;
+    measuredAtSlot: number;
+    note: string;
+    vault: string;
+    owner: string;
+    amountUsdc: string;
+    sharesToBurn: string;
+    sharesHeld: string;
+    instantLiquidity: string;
+    sharePriceInAssets: string;
+} | {
+    canWithdraw: boolean;
+    receives: string;
+    measuredAtSlot: number;
+    note: string;
+    vault: string;
+    owner: string;
+    amountUsdc: string;
+    sharesToBurn: string;
+    sharesHeld: string;
+    instantLiquidity: string;
+    sharePriceInAssets: string;
+}>;
+/** `earn balance`: shares, value, and what a full exit would pay now. No event scan on Solana. */
+export declare function solanaBalance(vault: SolanaVaultEntry, account: string): Promise<{
+    vault: string;
+    account: string;
+    sharesExact: string;
+    shares: string;
+    usdcValue: string;
+    sharePriceInAssets: string;
+    exit: {
+        instantLiquidity: string;
+    };
+    entryBasisUsdc: string;
+    accruedYieldUsdc: string;
+    scan: {
+        complete: boolean;
+        wholeHistory: boolean;
+        note: string;
+    };
+    measuredAtSlot: number;
+}>;
+/**
+ * What a Solana signer must do for a prepared transaction to land exactly once. Stated with every build,
+ * because nothing here signs or sends.
+ */
+export declare const SOLANA_SIGNER_RULES: readonly ["Sign and send on Solana mainnet-beta only: check the wallet's network before signing.", "Send before block height `transaction.expiresAfterBlockHeight` (about a minute after it was prepared). If that height has passed, do not sign: prepare the transaction again.", "Before signing, check the fee payer and signer is the account the operator named, and the vault the transaction calls (`vaultAddress`) is the vault named. Do not sign a transaction whose account you did not confirm.", "Confirm by the signature's status. If a send fails with no status, read the account's share balance before preparing again: a transaction that did land would be repeated by a new one."];
+/** `earn prepare_deposit` on Solana. Simulated first; a deposit the program would refuse is not returned. */
+export declare function solanaPrepareDeposit(vault: SolanaVaultEntry, account: string, amountHuman: string, receiver: string): Promise<{
+    next_step: string;
+    signer_rules: readonly ["Sign and send on Solana mainnet-beta only: check the wallet's network before signing.", "Send before block height `transaction.expiresAfterBlockHeight` (about a minute after it was prepared). If that height has passed, do not sign: prepare the transaction again.", "Before signing, check the fee payer and signer is the account the operator named, and the vault the transaction calls (`vaultAddress`) is the vault named. Do not sign a transaction whose account you did not confirm.", "Confirm by the signature's status. If a send fails with no status, read the account's share balance before preparing again: a transaction that did land would be repeated by a new one."];
+    vault: string;
+    vaultAddress: string & import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58">;
+    account: string;
+    kind: "deposit" | "withdraw";
+    expected: string;
+    simulated: string;
+    transaction: {
+        encoding: string;
+        wire: string;
+        bytes: number;
+        feePayer: string;
+        blockhash: string;
+        preparedAtBlockHeight: string;
+        expiresAfterBlockHeight: string;
+    };
+    chain: "solana";
+    chainId: null;
+    cluster: "mainnet-beta";
+    genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+    requires_signature: boolean;
+    status: string;
+}>;
+/** `earn prepare_withdraw` on Solana. `all` burns exactly `sharesExact`. Simulated first. */
+export declare function solanaPrepareWithdraw(vault: SolanaVaultEntry, account: string, receiver: string, args: {
+    amountHuman?: string;
+    sharesExact?: string;
+}): Promise<{
+    next_step: string;
+    signer_rules: readonly ["Sign and send on Solana mainnet-beta only: check the wallet's network before signing.", "Send before block height `transaction.expiresAfterBlockHeight` (about a minute after it was prepared). If that height has passed, do not sign: prepare the transaction again.", "Before signing, check the fee payer and signer is the account the operator named, and the vault the transaction calls (`vaultAddress`) is the vault named. Do not sign a transaction whose account you did not confirm.", "Confirm by the signature's status. If a send fails with no status, read the account's share balance before preparing again: a transaction that did land would be repeated by a new one."];
+    vault: string;
+    vaultAddress: string & import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58">;
+    account: string;
+    kind: "deposit" | "withdraw";
+    expected: string;
+    simulated: string;
+    transaction: {
+        encoding: string;
+        wire: string;
+        bytes: number;
+        feePayer: string;
+        blockhash: string;
+        preparedAtBlockHeight: string;
+        expiresAfterBlockHeight: string;
+    };
+    chain: "solana";
+    chainId: null;
+    cluster: "mainnet-beta";
+    genesisHash: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+    requires_signature: boolean;
+    status: string;
+}>;

package/dist/earn/solana.js

@@ -0,0 +1,302 @@
+/**
+ * The earn commands on Solana: what `src/earn/commands.ts` answers when the vault is on Solana.
+ *
+ * The same contracts as on EVM, adapted where Solana differs:
+ * - A prepared deposit or withdrawal is ONE unsigned transaction (base64 wire bytes), not a list of calls,
+ *   and it EXPIRES: it names a recent blockhash and lands only before `lastValidBlockHeight`, about a minute
+ *   later. The envelope says so in structure (`transaction.expiresAfterBlockHeight`), not only in prose.
+ * - It is simulated before it is returned. A transaction the program would refuse is not handed to a signer:
+ *   the refusal comes back instead, with the program's own reason.
+ * - There is no receiver. A Kamino vault mints shares to the signer's own account and pays a withdrawal to the
+ *   account that burns the shares, so `--receiver` must be the account, and anything else is refused.
+ * - There is no approve step, and no event scan: entry basis and yield are not read on Solana, and say so.
+ */
+import { isAddress as isSolanaAddress } from "@solana/kit";
+import { SOLANA_INFO, solanaRpcSourceForEnv, solanaRpcUrlFromEnv } from "../client.js";
+import { describeError, redactEndpoints } from "../redact.js";
+import { formatAmount, parseAmount } from "../units.js";
+import { PACKAGE_VERSION } from "../version.js";
+import { loadRegistry } from "../registry.js";
+import { MAINNET_GENESIS_HASH } from "../solana/constants.js";
+import { associatedTokenAccount, compileUnsigned } from "../solana/kvault.js";
+import { makeSolanaRpc, solanaCluster } from "../solana/rpc.js";
+import { depositInstructions, describeSimulation, freshLifetime, partialWithdrawal, preflightDepositSolana, readVault, sharePrice, simulate, simulateWithdrawal, tokenBalance, withdrawInstructions } from "../solana/vault.js";
+/** Which chain a Solana response is about: the name a caller passes back, and the cluster a wallet must be on. */
+export const onSolana = { chain: SOLANA_INFO.key, chainId: null, cluster: "mainnet-beta", genesisHash: MAINNET_GENESIS_HASH };
+/** The explorer page for a Solana account or transaction. */
+export const solscan = (kind, id) => `https://solscan.io/${kind}/${id}`;
+/** A Solana address argument, checked here: the CLI's schema accepts either family's address form. */
+export function solanaAccount(v, what) {
+    if (!isSolanaAddress(v))
+        throw new Error(`${what} must be a Solana address for a vault on Solana; got ${v}`);
+    return v;
+}
+/** Every Solana read goes through one client per command, on the endpoint the environment names. */
+function rpcAndCheck() {
+    return { rpc: makeSolanaRpc(solanaRpcUrlFromEnv()), source: solanaRpcSourceForEnv().source };
+}
+/**
+ * Runs the reads WHILE asking the endpoint which cluster it is. A devnet or local endpoint answers every
+ * read, and the vault's address has no account there, so the reads fail as "no account" — a mismatch is
+ * reported INSTEAD, naming the variable, as on EVM.
+ */
+async function onMainnet(rpc, source, work) {
+    const [cluster, settled] = await Promise.all([
+        solanaRpcSourceForEnv().configured ? solanaCluster(rpc) : Promise.resolve("mainnet"),
+        work().then((value) => ({ ok: true, value }), (error) => ({ ok: false, error })),
+    ]);
+    if (cluster === "other")
+        throw new Error(`the endpoint in ${source} is not Solana mainnet-beta (its genesis hash differs). Point ${SOLANA_INFO.rpcEnv[0]} at a mainnet endpoint; until then no Solana read can be trusted.`);
+    if (!settled.ok)
+        throw settled.error;
+    return settled.value;
+}
+/** The row `earn vaults` lists for a Solana vault. */
+export function solanaVaultRow(v) {
+    return {
+        symbol: v.symbol,
+        name: v.name,
+        warning: v.warning,
+        links: { explorer: solscan("account", v.address) },
+        backend: v.backend,
+        isDefault: v.isDefault,
+        chain: SOLANA_INFO.key,
+        chainId: null,
+        address: v.address,
+        chassis: v.chassis,
+        asset: v.asset,
+        sharesMint: v.sharesMint,
+        shareDecimals: v.shareDecimals,
+        depositOpen: v.depositOpen,
+        notes: v.notes,
+    };
+}
+/** `earn status` with no account: is the Solana endpoint up, and is it mainnet. Never throws. */
+export async function solanaHealth(vault, partial) {
+    const src = solanaRpcSourceForEnv();
+    const base = {
+        mode: "health",
+        ...partial,
+        server: "treasury",
+        version: PACKAGE_VERSION,
+        registry: { schemaVersion: loadRegistry().schemaVersion, vaults: loadRegistry().vaults.length + loadRegistry().solanaVaults.length, reconciledAtIso: loadRegistry().reconciledAtIso },
+        ...onSolana,
+        vault: vault.symbol,
+        rpcSource: src.source,
+        rpcConfigured: src.configured,
+    };
+    try {
+        const rpc = makeSolanaRpc(solanaRpcUrlFromEnv());
+        const [cluster, slot] = await Promise.all([solanaCluster(rpc), rpc.getSlot({ commitment: "confirmed" }).send()]);
+        if (cluster === "other") {
+            return { ...base, rpc: "wrong_chain", latestSlot: null, reason: `the endpoint in ${src.source} is not Solana mainnet-beta (its genesis hash differs). Point ${SOLANA_INFO.rpcEnv[0]} at a mainnet endpoint.` };
+        }
+        return { ...base, rpc: "ok", chainVerified: cluster === "mainnet", latestSlot: slot.toString() };
+    }
+    catch (e) {
+        return { ...base, rpc: "unreachable", latestSlot: null, reason: redactEndpoints(e instanceof Error ? e.message : String(e)) };
+    }
+}
+/** `earn status --account`: the deposit pre-flight. */
+export async function solanaPreflight(vault, account, amountHuman) {
+    const { rpc, source } = rpcAndCheck();
+    const r = await onMainnet(rpc, source, () => preflightDepositSolana(rpc, vault, solanaAccount(account, "account"), amountHuman));
+    const { expectedSharesRaw: _raw, ...rest } = r;
+    return rest;
+}
+/** `earn quote --direction deposit`. */
+export async function solanaQuoteDeposit(vault, account, amountHuman) {
+    const { rpc, source } = rpcAndCheck();
+    const pf = await onMainnet(rpc, source, () => preflightDepositSolana(rpc, vault, solanaAccount(account, "account"), amountHuman));
+    const raw = pf.expectedSharesRaw;
+    const { expectedSharesRaw: _raw, ...preflight } = pf;
+    return {
+        vault: vault.symbol,
+        depositor: account,
+        amountUsdc: `${amountHuman} ${vault.asset.symbol}`,
+        expectedShares: raw === undefined ? "unknown — the simulated deposit did not succeed; see preflight" : `${formatAmount(raw, vault.shareDecimals)} ${vault.symbol}`,
+        sharePriceInAssets: preflight.quotes?.sharePriceInAssets,
+        preflight,
+        note: "Read from a simulated deposit at the slot shown: the shares the account would receive. This client quotes no rate.",
+    };
+}
+/** Shares for `amountHuman` of the asset, rounded UP so the withdrawal is worth at least the amount asked. */
+function sharesFor(v, amountHuman) {
+    const amount = parseAmount(amountHuman, v.entry.asset.decimals, `withdrawal amount (${v.entry.asset.symbol})`);
+    if (amount === 0n)
+        throw new Error("a withdrawal of 0");
+    if (v.holdings.netAum === 0n)
+        throw new Error(`${v.entry.symbol} holds nothing to withdraw`);
+    return (amount * v.state.sharesIssued + v.holdings.netAum - 1n) / v.holdings.netAum;
+}
+/** Simulates a withdrawal of `shares` and reads what the account would receive and how many shares it would burn. */
+async function simulateWithdraw(rpc, v, account, shares) {
+    return simulateWithdrawal(rpc, v, account, await withdrawInstructions(v, account, shares));
+}
+/** `earn quote --direction withdraw`. */
+export async function solanaQuoteWithdraw(vault, account, amountHuman) {
+    const { rpc, source } = rpcAndCheck();
+    return onMainnet(rpc, source, async () => {
+        const owner = solanaAccount(account, "account");
+        const v = await readVault(rpc, vault);
+        const held = await tokenBalance(rpc, await associatedTokenAccount(owner, v.state.sharesMint));
+        const shares = sharesFor(v, amountHuman);
+        const base = {
+            vault: vault.symbol,
+            owner,
+            amountUsdc: `${amountHuman} ${vault.asset.symbol}`,
+            sharesToBurn: `${formatAmount(shares, vault.shareDecimals)} ${vault.symbol}`,
+            sharesHeld: `${formatAmount(held.amount, vault.shareDecimals)} ${vault.symbol}`,
+            instantLiquidity: `${formatAmount(v.holdings.idle, vault.asset.decimals)} ${vault.asset.symbol}`,
+            sharePriceInAssets: `${sharePrice(v)} ${vault.asset.symbol} per share`,
+        };
+        if (shares > held.amount) {
+            return { ...base, canWithdraw: false, note: `the account holds ${formatAmount(held.amount, vault.shareDecimals)} shares, fewer than the ${formatAmount(shares, vault.shareDecimals)} this amount needs` };
+        }
+        const { sim, received, burned, legs } = await simulateWithdraw(rpc, v, owner, shares);
+        if (received === undefined || burned === undefined)
+            return { ...base, canWithdraw: false, measuredAtSlot: Number(sim.slot), note: `the simulated withdrawal failed: ${describeSimulation(sim)}` };
+        const partial = partialWithdrawal(shares, burned, legs, vault.shareDecimals, sim.slot);
+        if (partial)
+            return { ...base, canWithdraw: false, measuredAtSlot: Number(sim.slot), note: partial };
+        return {
+            ...base,
+            canWithdraw: true,
+            receives: `${formatAmount(received, vault.asset.decimals)} ${vault.asset.symbol}`,
+            measuredAtSlot: Number(sim.slot),
+            note: "simulated withdrawal succeeds at this slot. `receives` is what the account's USDC balance would rise by — net of the up to 0.001 USDC Kamino keeps per withdraw instruction.",
+        };
+    });
+}
+/** `earn balance`: shares, value, and what a full exit would pay now. No event scan on Solana. */
+export async function solanaBalance(vault, account) {
+    const { rpc, source } = rpcAndCheck();
+    return onMainnet(rpc, source, async () => {
+        const owner = solanaAccount(account, "account");
+        const v = await readVault(rpc, vault);
+        const held = await tokenBalance(rpc, await associatedTokenAccount(owner, v.state.sharesMint));
+        const value = v.state.sharesIssued === 0n ? 0n : (held.amount * v.holdings.netAum) / v.state.sharesIssued;
+        let exit;
+        if (held.amount === 0n) {
+            exit = { exitableNow: `0 ${vault.asset.symbol}`, measuredAs: "no position" };
+        }
+        else {
+            try {
+                const { sim, received } = await simulateWithdraw(rpc, v, owner, held.amount);
+                exit =
+                    received === undefined
+                        ? { exitableNow: "unknown", measuredAs: "refused", note: `a full withdrawal was refused at this slot: ${describeSimulation(sim)}` }
+                        : { exitableNow: `${formatAmount(received, vault.asset.decimals)} ${vault.asset.symbol}`, measuredAs: "a simulated full withdrawal", note: "net of the up to 0.001 USDC Kamino keeps per withdraw instruction" };
+            }
+            catch (e) {
+                exit = { exitableNow: "unknown", measuredAs: "not measured", note: describeError(e) };
+            }
+        }
+        return {
+            vault: vault.symbol,
+            account: owner,
+            sharesExact: formatAmount(held.amount, vault.shareDecimals),
+            shares: `${formatAmount(held.amount, vault.shareDecimals)} ${vault.symbol}`,
+            usdcValue: `${formatAmount(value, vault.asset.decimals)} ${vault.asset.symbol}`,
+            sharePriceInAssets: `${sharePrice(v)} ${vault.asset.symbol} per share`,
+            exit: { ...exit, instantLiquidity: `${formatAmount(v.holdings.idle, vault.asset.decimals)} ${vault.asset.symbol}` },
+            entryBasisUsdc: "unknown — not read on Solana; see scan.note",
+            accruedYieldUsdc: "unknown — not read on Solana; see scan.note",
+            scan: {
+                complete: false,
+                wholeHistory: false,
+                note: "On Solana this client reads the position, not its history: entry basis and yield are not derived. The account's own deposit and withdrawal transactions are the record (solscan.io lists them).",
+            },
+            measuredAtSlot: Number(v.slot),
+        };
+    });
+}
+/**
+ * What a Solana signer must do for a prepared transaction to land exactly once. Stated with every build,
+ * because nothing here signs or sends.
+ */
+export const SOLANA_SIGNER_RULES = [
+    "Sign and send on Solana mainnet-beta only: check the wallet's network before signing.",
+    "Send before block height `transaction.expiresAfterBlockHeight` (about a minute after it was prepared). If that height has passed, do not sign: prepare the transaction again.",
+    "Before signing, check the fee payer and signer is the account the operator named, and the vault the transaction calls (`vaultAddress`) is the vault named. Do not sign a transaction whose account you did not confirm.",
+    "Confirm by the signature's status. If a send fails with no status, read the account's share balance before preparing again: a transaction that did land would be repeated by a new one.",
+];
+/**
+ * The envelope a Solana build returns: one unsigned transaction, its expiry, and what simulating it showed.
+ * The deposit warning is NOT attached here: `commitsMoney` in ./commands.ts is the one place that writes it.
+ */
+async function envelope(rpc, v, account, kind, simulated, ixs, expected) {
+    const life = await freshLifetime(rpc);
+    const tx = compileUnsigned(ixs, account, life);
+    return {
+        requires_signature: true,
+        status: "unsigned",
+        ...onSolana,
+        next_step: `This is ONE Solana transaction, for Solana mainnet-beta: tell the operator which chain. Hand it to the operator's own Solana wallet now — it lands only until block height ${life.lastValidBlockHeight}, about a minute from now — following \`signer_rules\`. Nothing has been submitted; no funds have moved.`,
+        signer_rules: SOLANA_SIGNER_RULES,
+        vault: v.entry.symbol,
+        vaultAddress: v.entry.address,
+        account,
+        kind,
+        expected,
+        simulated,
+        transaction: {
+            encoding: "base64",
+            wire: tx.base64,
+            bytes: tx.bytes,
+            feePayer: account,
+            blockhash: life.blockhash,
+            preparedAtBlockHeight: life.currentBlockHeight.toString(),
+            expiresAfterBlockHeight: life.lastValidBlockHeight.toString(),
+        },
+    };
+}
+/** The receiver must be the account: shares and withdrawals go to the signer's own accounts on this program. */
+function sameAsAccount(receiver, account) {
+    if (receiver !== account) {
+        throw new Error(`on Solana the receiver must be the account itself: a Kamino vault mints shares to the signer's own account and pays a withdrawal to the account whose shares burn. --receiver ${receiver} is not --account ${account}.`);
+    }
+}
+/** `earn prepare_deposit` on Solana. Simulated first; a deposit the program would refuse is not returned. */
+export async function solanaPrepareDeposit(vault, account, amountHuman, receiver) {
+    const user = solanaAccount(account, "account");
+    sameAsAccount(solanaAccount(receiver, "receiver"), user);
+    const { rpc, source } = rpcAndCheck();
+    return onMainnet(rpc, source, async () => {
+        const v = await readVault(rpc, vault);
+        const amount = parseAmount(amountHuman, vault.asset.decimals, `deposit amount (${vault.asset.symbol})`);
+        if (amount === 0n)
+            throw new Error("a deposit of 0");
+        const ixs = await depositInstructions(v, user, amount);
+        const sharesAta = await associatedTokenAccount(user, v.state.sharesMint);
+        const before = await tokenBalance(rpc, sharesAta);
+        const sim = await simulate(rpc, ixs, user, [sharesAta]);
+        if (!sim.ok)
+            throw new Error(`not prepared: the simulated deposit fails at slot ${sim.slot}: ${describeSimulation(sim)}. Run \`earn status --chain solana --account ${user}\` for the reason in words.`);
+        const minted = (sim.after.get(sharesAta) ?? 0n) - before.amount;
+        return envelope(rpc, v, user, "deposit", `deposit ${formatAmount(amount, vault.asset.decimals)} ${vault.asset.symbol}; the simulation at slot ${sim.slot} minted ${formatAmount(minted, vault.shareDecimals)} ${vault.symbol}`, ixs, `${formatAmount(minted, vault.shareDecimals)} ${vault.symbol}`);
+    });
+}
+/** `earn prepare_withdraw` on Solana. `all` burns exactly `sharesExact`. Simulated first. */
+export async function solanaPrepareWithdraw(vault, account, receiver, args) {
+    const user = solanaAccount(account, "account");
+    sameAsAccount(solanaAccount(receiver, "receiver"), user);
+    const { rpc, source } = rpcAndCheck();
+    return onMainnet(rpc, source, async () => {
+        const v = await readVault(rpc, vault);
+        const shares = args.sharesExact !== undefined ? parseAmount(args.sharesExact, vault.shareDecimals, "shares_exact") : sharesFor(v, args.amountHuman);
+        const held = await tokenBalance(rpc, await associatedTokenAccount(user, v.state.sharesMint));
+        if (shares > held.amount)
+            throw new Error(`the account holds ${formatAmount(held.amount, vault.shareDecimals)} shares, fewer than the ${formatAmount(shares, vault.shareDecimals)} this withdrawal burns`);
+        const ixs = await withdrawInstructions(v, user, shares);
+        const { sim, received, burned, legs } = await simulateWithdraw(rpc, v, user, shares);
+        if (received === undefined || burned === undefined)
+            throw new Error(`not prepared: the simulated withdrawal fails at slot ${sim.slot}: ${describeSimulation(sim)}`);
+        const partial = partialWithdrawal(shares, burned, legs, vault.shareDecimals, sim.slot);
+        if (partial)
+            throw new Error(`not prepared: ${partial}`);
+        const got = `${formatAmount(received, vault.asset.decimals)} ${vault.asset.symbol}`;
+        return envelope(rpc, v, user, "withdraw", `burn ${formatAmount(shares, vault.shareDecimals)} ${vault.symbol}; the simulation at slot ${sim.slot} paid ${got} (net of the up to 0.001 USDC Kamino keeps per withdraw instruction)`, ixs, got);
+    });
+}
+//# sourceMappingURL=solana.js.map

package/dist/earn/solana.js.map

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

package/dist/guide.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The public copy for THIS version: the file at its release tag, so the guide an agent reads describes the
+ * CLI it is running. The default branch does not: it moves with each release, and before v0.1.3 it had no
+ * llms.txt at all. A tag exists only once the release is cut, so an unreleased build's URL resolves then.
+ */
+export declare const GUIDE_URL: string;
+/**
+ * The `guide` field of the top-level and per-skill `--help`; undefined when this is the plugin's copy.
+ * Only the existence of `llms.txt` beside the CLI is checked, to name its path; nothing in the CLI reads it.
+ */
+export declare function guidePointer(): {
+    read_first: string;
+    file?: string;
+    url: string;
+} | undefined;