@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/resolve.d.ts

@@ -0,0 +1,74 @@
+import { AccountRole } from "@solana/kit";
+import type { Address, TransactionSigner } from "@solana/kit";
+import type { AccountManifest } from "sauce-compiler";
+/**
+ * Maps each declared slot of the compiler's AccountManifest to a concrete
+ * address. `signer` REPLACES the manifest's requirement rather than only
+ * raising it: omit it to keep the manifest's own value, `true` to make a
+ * non-signer slot sign, and `false` to attach a slot the program treats as a
+ * signer WITHOUT a transaction signature — which is what a PDA the program
+ * signs for via `invoke_signed` needs. Pass the TransactionSigner itself to
+ * also sign with it (required for any signer ref other than the reserved
+ * fee-payer ref — the send layer has no other way to obtain that signature).
+ *
+ * The two sides describe different things: the manifest states what the PROGRAM
+ * requires of the slot, this states what the TRANSACTION provides.
+ */
+export interface AccountResolution {
+    [ref: string]: Address | {
+        address: Address;
+        signer?: boolean | TransactionSigner;
+    };
+}
+/**
+ * Reserved ref: resolves to the fee payer with signer:true (use it when
+ * bytecode reads MSG_SENDER). A resolution entry under this key is a conflict
+ * and throws — rename the plan ref if it must resolve to another address.
+ */
+export declare const PAYER_REF = "payer";
+export interface ResolveAccountsOptions {
+    /**
+     * Append the fee payer as a readonly signer at the END of the tail (plan
+     * indices stay stable) when no resolved meta already signs. The engine's
+     * NoSigner is LAZY — raised only when the program executes
+     * MSG_SENDER/TX_ORIGIN — so a signerless list is valid for programs that
+     * never read the sender (and lets simulations run sigVerify: false with no
+     * signer at all). Set this for MSG_SENDER-reading programs whose plan
+     * carries no signer meta; prefer the reserved 'payer' ref when the payer
+     * should occupy a plan slot instead.
+     */
+    appendPayerSigner?: boolean;
+}
+export interface ResolvedAccountMeta {
+    address: Address;
+    role: AccountRole;
+    /**
+     * Present only when the resolution attached a TransactionSigner — kit's
+     * signTransactionMessageWithSigners collects it from the instruction meta
+     * (detection is `'signer' in meta`, so the key is omitted, not undefined).
+     */
+    signer?: TransactionSigner;
+}
+/**
+ * Resolves an AccountManifest into ordered account metas: metas[i] is
+ * user-account index i of the execute instruction (inline: instruction account
+ * i; staged: i + 1, after the buffer). The base role comes from the slot's
+ * `requires`; the resolution entry's signer flag then replaces it (see
+ * `AccountResolution`), and a TransactionSigner or the reserved PAYER_REF sets
+ * it. An attached
+ * TransactionSigner rides on the meta so the transaction builder signs with it.
+ * Duplicate addresses across refs are fine — Solana dedupes at message compile.
+ *
+ * A `remaining` entry is a POSITION, not an account: it marks where the
+ * caller's own variable-length tail begins, so resolution stops there and the
+ * caller appends its tail itself. It must be the LAST entry, and one that is not
+ * throws — stopping early would drop the slots after it from `metas` and shift
+ * the index of every account the caller then appends.
+ *
+ * MSG_SENDER/TX_ORIGIN is the first in-list signer, resolved LAZILY by the
+ * engine (NoSigner only when the program actually reads the sender) — so no
+ * signer is auto-appended; a MSG_SENDER-reading program whose manifest
+ * declares no signer slot passes `appendPayerSigner: true`.
+ */
+export declare function resolveAccounts(manifest: AccountManifest, resolution: AccountResolution, payer: Address, { appendPayerSigner }?: ResolveAccountsOptions): ResolvedAccountMeta[];
+//# sourceMappingURL=resolve.d.ts.map

package/sdk/dist/svm/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/svm/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,gBAAgB,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;KAAE,CAAC;CACrF;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,OAAO,EACd,EAAE,iBAAyB,EAAE,GAAE,sBAA2B,GACzD,mBAAmB,EAAE,CAoHvB"}

package/sdk/dist/svm/resolve.js

@@ -0,0 +1,128 @@
+import { AccountRole, isSignerRole } from "@solana/kit";
+/**
+ * Reserved ref: resolves to the fee payer with signer:true (use it when
+ * bytecode reads MSG_SENDER). A resolution entry under this key is a conflict
+ * and throws — rename the plan ref if it must resolve to another address.
+ */
+export const PAYER_REF = "payer";
+/** The four `AccountRole` values are exactly Solana's own, so each maps straight onto a kit role. */
+function isWritableSlot(role) {
+    return role === "writable" || role === "writable_signer";
+}
+function isSignerSlot(role) {
+    return role === "readonly_signer" || role === "writable_signer";
+}
+/**
+ * Resolves an AccountManifest into ordered account metas: metas[i] is
+ * user-account index i of the execute instruction (inline: instruction account
+ * i; staged: i + 1, after the buffer). The base role comes from the slot's
+ * `requires`; the resolution entry's signer flag then replaces it (see
+ * `AccountResolution`), and a TransactionSigner or the reserved PAYER_REF sets
+ * it. An attached
+ * TransactionSigner rides on the meta so the transaction builder signs with it.
+ * Duplicate addresses across refs are fine — Solana dedupes at message compile.
+ *
+ * A `remaining` entry is a POSITION, not an account: it marks where the
+ * caller's own variable-length tail begins, so resolution stops there and the
+ * caller appends its tail itself. It must be the LAST entry, and one that is not
+ * throws — stopping early would drop the slots after it from `metas` and shift
+ * the index of every account the caller then appends.
+ *
+ * MSG_SENDER/TX_ORIGIN is the first in-list signer, resolved LAZILY by the
+ * engine (NoSigner only when the program actually reads the sender) — so no
+ * signer is auto-appended; a MSG_SENDER-reading program whose manifest
+ * declares no signer slot passes `appendPayerSigner: true`.
+ */
+export function resolveAccounts(manifest, resolution, payer, { appendPayerSigner = false } = {}) {
+    const unresolved = [];
+    const metas = [];
+    let hasRemaining = false;
+    for (const [index, entry] of manifest.accounts.entries()) {
+        // A `remaining` marker carries no role: everything after it is the caller's own tail, which only
+        // the caller can enumerate. It has to be LAST for that to hold — a slot after it would be
+        // dropped from `metas`, shifting the index of every account the caller then appends.
+        if (entry.kind !== "slot") {
+            const after = manifest.accounts.slice(index + 1);
+            if (after.length > 0) {
+                const names = after.map((later) => (later.kind === "slot" ? later.name : later.kind));
+                throw new Error(`account manifest: a '${entry.kind}' entry must be last, but index ${index} of ${manifest.accounts.length} is followed by '${names.join("', '")}'`);
+            }
+            hasRemaining = true;
+            break;
+        }
+        const meta = { ref: entry.name, writable: isWritableSlot(entry.requires) };
+        let address;
+        let signer = isSignerSlot(entry.requires);
+        let transactionSigner;
+        if (meta.ref === PAYER_REF) {
+            if (resolution[PAYER_REF] !== undefined) {
+                throw new Error(`account ref 'payer' is reserved for the fee payer (rename the ref or remove it from the resolution map)`);
+            }
+            address = payer;
+            signer = true;
+        }
+        else {
+            const entry = resolution[meta.ref];
+            if (entry !== undefined) {
+                if (typeof entry === "string") {
+                    address = entry;
+                }
+                else {
+                    address = entry.address;
+                    if (typeof entry.signer === "object") {
+                        if (entry.signer.address !== entry.address) {
+                            throw new Error(`account ref '${meta.ref}' address ${entry.address} does not match its TransactionSigner address ${entry.signer.address}`);
+                        }
+                        transactionSigner = entry.signer;
+                        signer = true;
+                    }
+                    else {
+                        // The override REPLACES the manifest's requirement rather than only raising it:
+                        // `undefined` keeps the manifest default, `true` raises, and `false` LOWERS. Lowering is
+                        // the case that matters — a Pot is a PDA the kitchen signs for via `invoke_signed`, so
+                        // its slot is `writable_signer` to the program while the TRANSACTION must attach it
+                        // unsigned. `signer || …` could only ever raise, which made that unattachable.
+                        //
+                        // The two sides describe different things: the manifest states what the PROGRAM
+                        // requires of the slot, the resolution states what the TRANSACTION provides. Only the
+                        // caller knows a CPI supplies the signature.
+                        signer = entry.signer ?? signer;
+                    }
+                }
+            }
+        }
+        if (address === undefined) {
+            unresolved.push(meta.ref);
+            continue;
+        }
+        const role = meta.writable
+            ? signer
+                ? AccountRole.WRITABLE_SIGNER
+                : AccountRole.WRITABLE
+            : signer
+                ? AccountRole.READONLY_SIGNER
+                : AccountRole.READONLY;
+        metas.push(transactionSigner ? { address, role, signer: transactionSigner } : { address, role });
+    }
+    if (unresolved.length > 0) {
+        throw new Error(`unresolved account refs: ${unresolved.join(", ")} (provide addresses in the resolution map)`);
+    }
+    if (appendPayerSigner && !metas.some((meta) => isSignerRole(meta.role))) {
+        // Appending lands at `metas.length` — which, after a `remaining` marker, is exactly where the
+        // caller's own tail begins. Every account they then append would sit one slot later than the
+        // program expects, and the program would read the payer where it expected the first tail
+        // account. The caller owns that region, so the signer has to come from them.
+        //
+        // Reachable only since the resolution's `signer` flag started LOWERING as well as raising: a
+        // manifest signer slot used to guarantee a signing meta here, so this branch could not be
+        // entered by a manifest that declared one.
+        if (hasRemaining) {
+            throw new Error("appendPayerSigner: this manifest ends with a 'remaining' marker, so appending the payer " +
+                "would take the first index of the caller's own tail and shift every account after it. " +
+                "Include a signer in the tail, or resolve a manifest slot as a signer, instead.");
+        }
+        metas.push({ address: payer, role: AccountRole.READONLY_SIGNER });
+    }
+    return metas;
+}
+//# sourceMappingURL=resolve.js.map

package/sdk/dist/svm/resolve.js.map

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

package/sdk/dist/svm/send.d.ts

@@ -0,0 +1,48 @@
+import type { Commitment, GetEpochInfoApi, GetSignatureStatusesApi, GetTransactionApi, Rpc, RpcSubscriptions, SendTransactionApi, Signature, SignatureNotificationsApi, SimulateTransactionApi, SlotNotificationsApi, Transaction } from "@solana/kit";
+import type { SignedExecuteTransaction } from "./transaction.js";
+export interface SimulateExecuteResult {
+    ok: boolean;
+    unitsConsumed?: bigint;
+    returnData?: Uint8Array;
+    logs: string[];
+    /** Present iff the failure was a sauce REVERT — payload is the revert data. */
+    revert?: {
+        payload: Uint8Array;
+    };
+    err?: unknown;
+}
+export interface SimulateExecuteOptions {
+    /**
+     * Index of the engine execute instruction inside the transaction. Defaults
+     * to the last instruction — buildExecuteTransaction and the client place
+     * prepends first and the execute instruction last. Pass it explicitly when
+     * the transaction is composed differently.
+     */
+    executeInstructionIndex?: number;
+}
+/**
+ * Simulates a signed execute transaction. A `Custom(0)` error from the execute
+ * instruction is a sauce REVERT: the revert payload rides in returnData and
+ * surfaces as `revert.payload`. All other engine failures map to the same
+ * InvalidInstructionData instruction error and are NOT distinguishable from
+ * each other except by reading `logs`. Failures of other instructions
+ * (prepends) surface as plain `err` — never as `revert`.
+ */
+export declare function simulateExecute(rpc: Rpc<SimulateTransactionApi>, transaction: Transaction, { executeInstructionIndex }?: SimulateExecuteOptions): Promise<SimulateExecuteResult>;
+export interface SendExecuteInput {
+    rpc: Rpc<GetEpochInfoApi & GetSignatureStatusesApi & GetTransactionApi & SendTransactionApi>;
+    rpcSubscriptions: RpcSubscriptions<SignatureNotificationsApi & SlotNotificationsApi>;
+    transaction: SignedExecuteTransaction;
+    commitment?: Commitment;
+}
+export interface SendExecuteResult {
+    signature: Signature;
+    returnData?: Uint8Array;
+    computeUnits?: bigint;
+    logs: string[];
+}
+/** Sends a signed execute transaction, confirms it, and reads back return data from the transaction meta. */
+export declare function sendExecute({ rpc, rpcSubscriptions, transaction, commitment, }: SendExecuteInput): Promise<SendExecuteResult>;
+/** Simulated units padded 20% (rounded up), capped at the engine's 1.4M CU budget. */
+export declare function recommendedComputeUnitLimit(simulatedUnits: bigint): number;
+//# sourceMappingURL=send.d.ts.map

package/sdk/dist/svm/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/svm/send.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,GAAG,EACH,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAiCD,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAChC,WAAW,EAAE,WAAW,EACxB,EAAE,uBAAuB,EAAE,GAAE,sBAA2B,GACvD,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,GAAG,CAAC,eAAe,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;IAC7F,gBAAgB,EAAE,gBAAgB,CAAC,yBAAyB,GAAG,oBAAoB,CAAC,CAAC;IACrF,WAAW,EAAE,wBAAwB,CAAC;IACtC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6GAA6G;AAC7G,wBAAsB,WAAW,CAAC,EAChC,GAAG,EACH,gBAAgB,EAChB,WAAW,EACX,UAAwB,GACzB,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoB/C;AAED,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/sdk/dist/svm/send.js

@@ -0,0 +1,82 @@
+import { getBase64Encoder, getBase64EncodedWireTransaction, getCompiledTransactionMessageDecoder, getSignatureFromTransaction, sendAndConfirmTransactionFactory, } from "@solana/kit";
+import { ENGINE_GAS_LIMIT_CU } from "./engine.js";
+function decodeBase64(data) {
+    return new Uint8Array(getBase64Encoder().encode(data));
+}
+/**
+ * Custom(0) is the only custom program error the engine emits (Error::Revert),
+ * but any program in the transaction can fail with error code 0 too (SPL Token
+ * error 0 = NotRentExempt, ATA error 0 = InvalidOwner — exactly the prepend
+ * kinds shipped by prepends.ts), so the failing instruction index must be the
+ * engine execute instruction's.
+ */
+function isSauceRevert(err, executeInstructionIndex) {
+    if (typeof err !== "object" || err === null || !("InstructionError" in err))
+        return false;
+    const detail = err.InstructionError;
+    if (!Array.isArray(detail) || Number(detail[0]) !== executeInstructionIndex)
+        return false;
+    const inner = detail[1];
+    return (typeof inner === "object" && inner !== null && inner.Custom === 0);
+}
+function instructionCount(transaction) {
+    const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);
+    return "instructions" in compiled ? compiled.instructions.length : compiled.numInstructions;
+}
+/**
+ * Simulates a signed execute transaction. A `Custom(0)` error from the execute
+ * instruction is a sauce REVERT: the revert payload rides in returnData and
+ * surfaces as `revert.payload`. All other engine failures map to the same
+ * InvalidInstructionData instruction error and are NOT distinguishable from
+ * each other except by reading `logs`. Failures of other instructions
+ * (prepends) surface as plain `err` — never as `revert`.
+ */
+export async function simulateExecute(rpc, transaction, { executeInstructionIndex } = {}) {
+    const wireTransaction = getBase64EncodedWireTransaction(transaction);
+    const { value } = await rpc
+        .simulateTransaction(wireTransaction, { encoding: "base64", replaceRecentBlockhash: true })
+        .send();
+    const logs = value.logs ? [...value.logs] : [];
+    const returnData = value.returnData ? decodeBase64(value.returnData.data[0]) : undefined;
+    if (value.err === null) {
+        return { ok: true, unitsConsumed: value.unitsConsumed, returnData, logs };
+    }
+    const executeIndex = executeInstructionIndex ?? instructionCount(transaction) - 1;
+    const result = {
+        ok: false,
+        err: value.err,
+        unitsConsumed: value.unitsConsumed,
+        logs,
+    };
+    if (isSauceRevert(value.err, executeIndex)) {
+        result.revert = { payload: returnData ?? new Uint8Array(0) };
+    }
+    return result;
+}
+/** Sends a signed execute transaction, confirms it, and reads back return data from the transaction meta. */
+export async function sendExecute({ rpc, rpcSubscriptions, transaction, commitment = "confirmed", }) {
+    const sendAndConfirm = sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions });
+    await sendAndConfirm(transaction, { commitment });
+    const signature = getSignatureFromTransaction(transaction);
+    const response = await rpc
+        .getTransaction(signature, {
+        commitment,
+        encoding: "base64",
+        maxSupportedTransactionVersion: 0,
+    })
+        .send();
+    const meta = response?.meta;
+    return {
+        signature,
+        returnData: meta?.returnData ? decodeBase64(meta.returnData.data[0]) : undefined,
+        computeUnits: meta?.computeUnitsConsumed,
+        logs: meta?.logMessages ? [...meta.logMessages] : [],
+    };
+}
+/** Simulated units padded 20% (rounded up), capped at the engine's 1.4M CU budget. */
+export function recommendedComputeUnitLimit(simulatedUnits) {
+    const padded = (simulatedUnits * 12n + 9n) / 10n;
+    const cap = BigInt(ENGINE_GAS_LIMIT_CU);
+    return Number(padded > cap ? cap : padded);
+}
+//# sourceMappingURL=send.js.map

package/sdk/dist/svm/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/svm/send.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAC/B,oCAAoC,EACpC,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAerB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAalD,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,GAAY,EAAE,uBAA+B;IAClE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,kBAAkB,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1F,MAAM,MAAM,GAAI,GAAqC,CAAC,gBAAgB,CAAC;IAEvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,uBAAuB;QAAE,OAAO,KAAK,CAAC;IAE1F,MAAM,KAAK,GAAY,MAAM,CAAC,CAAC,CAAC,CAAC;IAEjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA8B,CAAC,MAAM,KAAK,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwB;IAChD,MAAM,QAAQ,GAAG,oCAAoC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAEzF,OAAO,cAAc,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;AAC9F,CAAC;AAYD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAgC,EAChC,WAAwB,EACxB,EAAE,uBAAuB,KAA6B,EAAE;IAExD,MAAM,eAAe,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG;SACxB,mBAAmB,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;SAC1F,IAAI,EAAE,CAAC;IAEV,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzF,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,YAAY,GAAG,uBAAuB,IAAI,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClF,MAAM,MAAM,GAA0B;QACpC,EAAE,EAAE,KAAK;QACT,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,IAAI;KACL,CAAC;IAEF,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAgBD,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,GAAG,EACH,gBAAgB,EAChB,WAAW,EACX,UAAU,GAAG,WAAW,GACP;IACjB,MAAM,cAAc,GAAG,gCAAgC,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACnF,MAAM,cAAc,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,GAAG;SACvB,cAAc,CAAC,SAAS,EAAE;QACzB,UAAU;QACV,QAAQ,EAAE,QAAQ;QAClB,8BAA8B,EAAE,CAAC;KAClC,CAAC;SACD,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,CAAC;IAE5B,OAAO;QACL,SAAS;QACT,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAChF,YAAY,EAAE,IAAI,EAAE,oBAAoB;QACxC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,2BAA2B,CAAC,cAAsB;IAChE,MAAM,MAAM,GAAG,CAAC,cAAc,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/sdk/dist/svm/token-extensions.d.ts

@@ -0,0 +1,83 @@
+import type { Address } from "@solana/kit";
+/** Basis-points denominator (spl-token-2022 ONE_IN_BASIS_POINTS). */
+export declare const ONE_IN_BASIS_POINTS = 10000n;
+export declare const EXT_UNINITIALIZED = 0;
+export declare const EXT_TRANSFER_FEE_CONFIG = 1;
+export declare const EXT_CONFIDENTIAL_TRANSFER_MINT = 4;
+export declare const EXT_DEFAULT_ACCOUNT_STATE = 6;
+export declare const EXT_MEMO_TRANSFER = 8;
+export declare const EXT_NON_TRANSFERABLE = 9;
+export declare const EXT_PERMANENT_DELEGATE = 12;
+export declare const EXT_TRANSFER_HOOK = 14;
+/** One transfer-fee schedule, valid from `epoch` onward until superseded. */
+export interface TransferFee {
+    epoch: bigint;
+    maximumFee: bigint;
+    transferFeeBasisPoints: number;
+}
+/**
+ * A mint's TransferFeeConfig: the older and newer fee schedules. A caller picks
+ * the one effective at the current epoch (see `getEpochFee`) — the config
+ * carries both so a quote computed near an epoch boundary stays exact.
+ */
+export interface TransferFeeConfig {
+    olderTransferFee: TransferFee;
+    newerTransferFee: TransferFee;
+}
+/** A mint's TransferHook extension (non-nil program only). */
+export interface TransferHookInfo {
+    programId: Address;
+    /**
+     * The hook's ExtraAccountMetaList PDA (["extra-account-metas", mint] under
+     * `programId`). Requires an async PDA derivation, so this sync parser leaves
+     * it undefined; the caller derives it when building the swap.
+     */
+    extraAccountMetaListPda?: Address;
+}
+/** Parsed mint extensions relevant to routing. */
+export interface MintExtensions {
+    /** Present iff a TransferFeeConfig extension is set (fee may still be zero). */
+    transferFee?: TransferFeeConfig;
+    /** Present iff a TransferHook extension with a non-nil program is set. */
+    transferHook?: TransferHookInfo;
+    /**
+     * HARD un-routable reasons: a plain `transferChecked` into a fresh recipient
+     * ATA genuinely fails or the received amount is unusable. Empty for a routable
+     * mint. Only NonTransferable and DefaultAccountState=frozen qualify — see the
+     * `advisories` note for why PermanentDelegate / ConfidentialTransfer do NOT.
+     */
+    blocking: string[];
+    /**
+     * Present-but-routable trust flags. These extensions are carried by the
+     * flagship tradeable Token-2022 stablecoins (PYUSD, USDG both set
+     * PermanentDelegate AND ConfidentialTransferMint) yet transfer normally on
+     * every Solana DEX — so they must NOT self-drop the pool (doing so defeats the
+     * entire point of T22 support). They are surfaced here for a caller that wants
+     * to gate on trust policy, but routing treats them as safe. Verified against
+     * live mainnet mint bytes (see test/svm/fixtures/token-2022/real-mints.json):
+     * a ConfidentialTransferMint enables confidential transfers as an OPT-IN per
+     * account, leaving plain transfers intact; a PermanentDelegate is a
+     * clawback/compliance authority, not a transfer gate.
+     */
+    advisories: string[];
+}
+/**
+ * Parse the Token-2022 TLV extension region of a mint. Returns
+ * `{ blocking: [] }` for a legacy 82-byte mint (or any non-T22 shape). For a
+ * Token-2022 mint, recognizes TransferFeeConfig and TransferHook (returned as
+ * structured fields) plus the un-routable set (NonTransferable,
+ * PermanentDelegate, ConfidentialTransferMint, MemoTransfer-required, and
+ * DefaultAccountState frozen), each pushed as a reason string into `blocking`.
+ */
+export declare function parseMintExtensions(mintData: Uint8Array): MintExtensions;
+/** The TransferFee active at `epoch`: newer if epoch >= newer.epoch, else older. */
+export declare function getEpochFee(cfg: TransferFeeConfig, epoch: bigint): TransferFee;
+/**
+ * The transfer fee withheld from `amount` under `cfg` at `epoch`, EXACTLY as
+ * spl-token-2022 computes it: 0 when bps or amount is 0, else
+ * min(maximum_fee, ceil(amount * bps / 10_000)).
+ */
+export declare function calcTransferFee(amount: bigint, cfg: TransferFeeConfig, epoch: bigint): bigint;
+/** The amount the recipient actually receives: `amount - calcTransferFee(...)`. */
+export declare function netTransferAmount(amount: bigint, cfg: TransferFeeConfig, epoch: bigint): bigint;
+//# sourceMappingURL=token-extensions.d.ts.map

package/sdk/dist/svm/token-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-extensions.d.ts","sourceRoot":"","sources":["../../src/svm/token-extensions.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAG3C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,WAAW,CAAC;CAC/B;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAyCD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAsDxE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7F;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/F"}

package/sdk/dist/svm/token-extensions.js

@@ -0,0 +1,174 @@
+/**
+ * Token-2022 mint extension parsing + the EXACT spl-token-2022 transfer-fee
+ * math. This is the correctness layer every SVM venue adapter reuses: a mint's
+ * TransferFee changes the amount actually received, so a venue's referenceQuote
+ * must net the fee on BOTH the input-side deposit and the output-side
+ * withdrawal for the netted quote to match realized on-chain output; and the
+ * un-routable extension set makes a mint un-swappable through a plain
+ * TransferChecked, so a venue must drop it.
+ *
+ * LAYOUT (authoritative sources, cross-checked before finalizing):
+ *   - The mint's TLV region begins at byte 166 (82-byte base padded to 165,
+ *     then a 1-byte account-type discriminator == 1 for Mint at offset 165).
+ *     See ./token-program.ts and the orca-so/whirlpools
+ *     `MintWithTransferFeeConfigLayout` proptest fixture
+ *     (`82 + 83 + 1 + 2 + 2 + 108`).
+ *   - Each TLV entry is: extension_type u16 LE, length u16 LE, then `length`
+ *     value bytes. type 0 (Uninitialized) terminates the scan.
+ *   - TransferFeeConfig (extension_type 1, length 108) value layout, from
+ *     spl-token-2022 `TransferFeeConfig` (repr(C), spl-pod little-endian):
+ *       +0   transfer_fee_config_authority  Pubkey (32)
+ *       +32  withdraw_withheld_authority     Pubkey (32)
+ *       +64  withheld_amount                 u64 LE (8)
+ *       +72  older_transfer_fee              TransferFee (18)
+ *       +90  newer_transfer_fee              TransferFee (18)
+ *     TransferFee (18 bytes): epoch u64 LE (8), maximum_fee u64 LE (8),
+ *     transfer_fee_basis_points u16 LE (2).
+ *   - TransferHook (extension_type 14) value: authority Pubkey (32),
+ *     program_id Pubkey (32) — both OptionalNonZeroPubkey (all-zero == None).
+ *
+ * FEE FORMULA (spl-token-2022 `TransferFee::calculate_fee` /
+ * `TransferFeeConfig::calculate_epoch_fee`, cross-checked):
+ *   fee = 0                                      if bps == 0 or amount == 0
+ *   fee = min(maximum_fee, ceil(amount * bps / 10_000))   otherwise
+ * with the TransferFee active at `epoch` chosen as:
+ *   newer_transfer_fee  if epoch >= newer_transfer_fee.epoch
+ *   older_transfer_fee  otherwise
+ * The recipient receives amount - fee.
+ */
+import { getAddressDecoder } from "@solana/kit";
+import { readUintLE } from "./venues/math.js";
+import { T22_TLV_START, isToken2022Mint } from "./token-program.js";
+/** Basis-points denominator (spl-token-2022 ONE_IN_BASIS_POINTS). */
+export const ONE_IN_BASIS_POINTS = 10000n;
+// --- Token-2022 mint ExtensionType discriminants (spl-token-2022 ExtensionType) ---
+export const EXT_UNINITIALIZED = 0;
+export const EXT_TRANSFER_FEE_CONFIG = 1;
+export const EXT_CONFIDENTIAL_TRANSFER_MINT = 4;
+export const EXT_DEFAULT_ACCOUNT_STATE = 6;
+export const EXT_MEMO_TRANSFER = 8; // account-level extension; recognized defensively
+export const EXT_NON_TRANSFERABLE = 9;
+export const EXT_PERMANENT_DELEGATE = 12;
+export const EXT_TRANSFER_HOOK = 14;
+/** DefaultAccountState value 2 == Frozen (0 Uninitialized, 1 Initialized, 2 Frozen). */
+const ACCOUNT_STATE_FROZEN = 2;
+const addressDecoder = getAddressDecoder();
+function isAllZero(data, offset, length) {
+    for (let i = offset; i < offset + length; i++) {
+        if (data[i] !== 0)
+            return false;
+    }
+    return true;
+}
+/** Parse one TransferFee (18 bytes) at `offset`. */
+function parseTransferFee(data, offset) {
+    return {
+        epoch: readUintLE(data, offset, 8),
+        maximumFee: readUintLE(data, offset + 8, 8),
+        transferFeeBasisPoints: Number(readUintLE(data, offset + 16, 2)),
+    };
+}
+/** Parse a TransferFeeConfig value (108 bytes) starting at `value` offset. */
+function parseTransferFeeConfig(data, value) {
+    // +0 config authority (32), +32 withdraw authority (32), +64 withheld u64 (8),
+    // +72 older TransferFee (18), +90 newer TransferFee (18).
+    return {
+        olderTransferFee: parseTransferFee(data, value + 72),
+        newerTransferFee: parseTransferFee(data, value + 90),
+    };
+}
+/** Parse a TransferHook value: authority (32) + program_id (32). Nil program → undefined. */
+function parseTransferHook(data, value, length) {
+    if (length < 64)
+        return undefined;
+    if (isAllZero(data, value + 32, 32))
+        return undefined; // OptionalNonZeroPubkey::None
+    return { programId: addressDecoder.decode(data.subarray(value + 32, value + 64)) };
+}
+/**
+ * Parse the Token-2022 TLV extension region of a mint. Returns
+ * `{ blocking: [] }` for a legacy 82-byte mint (or any non-T22 shape). For a
+ * Token-2022 mint, recognizes TransferFeeConfig and TransferHook (returned as
+ * structured fields) plus the un-routable set (NonTransferable,
+ * PermanentDelegate, ConfidentialTransferMint, MemoTransfer-required, and
+ * DefaultAccountState frozen), each pushed as a reason string into `blocking`.
+ */
+export function parseMintExtensions(mintData) {
+    const result = { blocking: [], advisories: [] };
+    if (!isToken2022Mint(mintData))
+        return result;
+    let offset = T22_TLV_START;
+    while (offset + 4 <= mintData.length) {
+        const type = mintData[offset] | (mintData[offset + 1] << 8);
+        const length = mintData[offset + 2] | (mintData[offset + 3] << 8);
+        const value = offset + 4;
+        if (type === EXT_UNINITIALIZED)
+            break; // zero-padded tail
+        if (value + length > mintData.length)
+            break; // truncated entry — stop
+        switch (type) {
+            case EXT_TRANSFER_FEE_CONFIG:
+                if (length >= 108)
+                    result.transferFee = parseTransferFeeConfig(mintData, value);
+                break;
+            case EXT_TRANSFER_HOOK: {
+                const hook = parseTransferHook(mintData, value, length);
+                if (hook)
+                    result.transferHook = hook;
+                break;
+            }
+            case EXT_NON_TRANSFERABLE:
+                result.blocking.push("NonTransferable (cannot be transferred at all)");
+                break;
+            case EXT_DEFAULT_ACCOUNT_STATE:
+                if (length >= 1 && mintData[value] === ACCOUNT_STATE_FROZEN) {
+                    // A freshly created recipient ATA starts frozen and cannot receive
+                    // until the freeze authority thaws it — un-routable for a plain swap.
+                    result.blocking.push("DefaultAccountState=frozen (new accounts start frozen)");
+                }
+                break;
+            case EXT_PERMANENT_DELEGATE:
+                // NOT blocking: a clawback/compliance authority, not a transfer gate.
+                // PYUSD/USDG both carry it and trade normally everywhere.
+                result.advisories.push("PermanentDelegate (a delegate authority can move/burn balances)");
+                break;
+            case EXT_CONFIDENTIAL_TRANSFER_MINT:
+                // NOT blocking: confidential transfers are OPT-IN per account; plain
+                // transferChecked still works. PYUSD/USDG both carry it.
+                result.advisories.push("ConfidentialTransferMint (confidential transfers are opt-in; plain transfers still work)");
+                break;
+            case EXT_MEMO_TRANSFER:
+                // Account-level extension — cannot appear on a mint; recognized only
+                // defensively. Surfaced as advisory, never a mint-level block.
+                result.advisories.push("MemoTransfer (account-level; not expected on a mint)");
+                break;
+            default:
+                break; // any other extension is routing-neutral
+        }
+        offset = value + length;
+    }
+    return result;
+}
+/** The TransferFee active at `epoch`: newer if epoch >= newer.epoch, else older. */
+export function getEpochFee(cfg, epoch) {
+    return epoch >= cfg.newerTransferFee.epoch ? cfg.newerTransferFee : cfg.olderTransferFee;
+}
+/**
+ * The transfer fee withheld from `amount` under `cfg` at `epoch`, EXACTLY as
+ * spl-token-2022 computes it: 0 when bps or amount is 0, else
+ * min(maximum_fee, ceil(amount * bps / 10_000)).
+ */
+export function calcTransferFee(amount, cfg, epoch) {
+    const fee = getEpochFee(cfg, epoch);
+    const bps = BigInt(fee.transferFeeBasisPoints);
+    if (bps === 0n || amount === 0n)
+        return 0n;
+    const numerator = amount * bps;
+    const rawFee = (numerator + ONE_IN_BASIS_POINTS - 1n) / ONE_IN_BASIS_POINTS; // ceil
+    return rawFee < fee.maximumFee ? rawFee : fee.maximumFee;
+}
+/** The amount the recipient actually receives: `amount - calcTransferFee(...)`. */
+export function netTransferAmount(amount, cfg, epoch) {
+    return amount - calcTransferFee(amount, cfg, epoch);
+}
+//# sourceMappingURL=token-extensions.js.map

package/sdk/dist/svm/token-extensions.js.map

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