@eco-incorp/sauce 0.99.6 → 0.99.7

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

@@ -0,0 +1,49 @@
+/**
+ * One Solana mint as a `@sauce/token` write takes it, resolved per mint: the accounts a cook attaches
+ * for it and the amounts it moves.
+ *
+ * A mint belongs to legacy SPL Token or to Token-2022, and so does every token account of it. Which
+ * one is the mint's OWNER (`token-program.ts`), so this reads the mint through an
+ * `OwnedAccountLoader`: the data alone cannot tell an extensionless Token-2022 mint from a legacy one.
+ * The program is three things to a cook:
+ *   - the `tokenProgram` account a write CPIs into (`transferChecked`, `approveChecked`, which
+ *     require it to own the source, the destination and the mint);
+ *   - the program a token account's associated address derives under, so `svmTokenAccount` gives a
+ *     Token-2022 holder's account where a legacy derivation gives an address nothing created;
+ *   - the program whose extensions (`token-extensions.ts`) decide what a transfer delivers.
+ *
+ * A checked write takes the mint as an account and its decimals as an argument; both are here. A
+ * transfer fee withholds part of what is sent, so `svmTokenReceived` and `svmTokenToSend` net it the
+ * way Token-2022 does, to the unit, at the epoch the transfer lands in.
+ */
+import type { Address } from "@solana/kit";
+import type { MintExtensions } from "./token-extensions.js";
+import type { OwnedAccountLoader } from "./venues/types.js";
+export interface SvmToken {
+    readonly mint: Address;
+    /** The program that owns the mint: legacy SPL Token or Token-2022. A write's `tokenProgram`. */
+    readonly tokenProgram: Address;
+    /** The mint's decimals: a checked write's `decimals` argument. */
+    readonly decimals: number;
+    /** The mint's Token-2022 extensions; none for a legacy mint. */
+    readonly extensions: MintExtensions;
+    /**
+     * Why a checked transfer of this mint is refused, empty when it is not: a transfer hook that names
+     * a program (`@sauce/token` refuses it as "transfer hook": the hook's own accounts are not passed),
+     * and every extension `extensions.blocking` lists (a paused mint, a non-transferable one, accounts
+     * that start frozen).
+     */
+    readonly transferRefusals: readonly string[];
+}
+/**
+ * Reads `mint` and resolves it: its token program, decimals and extensions. Throws when the account
+ * is missing, is owned by neither token program, or is not an initialized mint.
+ */
+export declare function resolveSvmToken(load: OwnedAccountLoader, mint: Address): Promise<SvmToken>;
+/** `owner`'s associated token account for the mint, under the mint's own token program. */
+export declare function svmTokenAccount(token: Pick<SvmToken, "mint" | "tokenProgram">, owner: Address): Promise<Address>;
+/** What the destination of a transfer of `amount` receives at `epoch`: `amount` less the fee. */
+export declare function svmTokenReceived(token: SvmToken, amount: bigint, epoch: bigint): bigint;
+/** What to send at `epoch` for the destination to receive exactly `amount`. */
+export declare function svmTokenToSend(token: SvmToken, amount: bigint, epoch: bigint): bigint;
+//# sourceMappingURL=token-accounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token-accounts.d.ts","sourceRoot":"","sources":["../../src/svm/token-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAS3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQ5D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+BhG;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,EAC9C,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrF"}

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

@@ -0,0 +1,58 @@
+import { associatedTokenAccount } from "./portal.js";
+import { classifyMintProgram, isToken2022Mint, SPL_MINT_SIZE, TOKEN_2022_PROGRAM_ID, } from "./token-program.js";
+import { grossTransferAmount, netTransferAmount, parseMintExtensions } from "./token-extensions.js";
+/** A mint's base: decimals@44 and is_initialized@45, the same in both programs. */
+const MINT_DECIMALS = 44;
+const MINT_INITIALIZED = 45;
+/** Token-2022's multisig size, which it never reads as a mint whatever its type byte says. */
+const MULTISIG_LEN = 355;
+/**
+ * Reads `mint` and resolves it: its token program, decimals and extensions. Throws when the account
+ * is missing, is owned by neither token program, or is not an initialized mint.
+ */
+export async function resolveSvmToken(load, mint) {
+    const account = await load(mint);
+    if (account === null)
+        throw new Error(`svm token: mint ${mint} account not found`);
+    const tokenProgram = classifyMintProgram(mint, account.data, account.owner);
+    const { data } = account;
+    // The shape `@sauce/token`'s `decimals` requires: 82 bytes, or an extended Token-2022 mint.
+    const shaped = data.length === SPL_MINT_SIZE ||
+        (tokenProgram === TOKEN_2022_PROGRAM_ID &&
+            isToken2022Mint(data) &&
+            data.length !== MULTISIG_LEN);
+    if (!shaped || data[MINT_INITIALIZED] !== 1) {
+        throw new Error(`svm token: ${mint} is not an initialized mint`);
+    }
+    const extensions = parseMintExtensions(data);
+    const hook = extensions.transferHook;
+    return {
+        mint,
+        tokenProgram,
+        decimals: data[MINT_DECIMALS],
+        extensions,
+        transferRefusals: [
+            ...(hook === undefined
+                ? []
+                : [
+                    `TransferHook names program ${hook.programId}, whose extra accounts a checked transfer does not pass`,
+                ]),
+            ...extensions.blocking,
+        ],
+    };
+}
+/** `owner`'s associated token account for the mint, under the mint's own token program. */
+export function svmTokenAccount(token, owner) {
+    return associatedTokenAccount(owner, token.mint, token.tokenProgram);
+}
+/** What the destination of a transfer of `amount` receives at `epoch`: `amount` less the fee. */
+export function svmTokenReceived(token, amount, epoch) {
+    const fee = token.extensions.transferFee;
+    return fee === undefined ? amount : netTransferAmount(amount, fee, epoch);
+}
+/** What to send at `epoch` for the destination to receive exactly `amount`. */
+export function svmTokenToSend(token, amount, epoch) {
+    const fee = token.extensions.transferFee;
+    return fee === undefined ? amount : grossTransferAmount(amount, fee, epoch);
+}
+//# sourceMappingURL=token-accounts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token-accounts.js","sourceRoot":"","sources":["../../src/svm/token-accounts.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIpG,mFAAmF;AACnF,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,8FAA8F;AAC9F,MAAM,YAAY,GAAG,GAAG,CAAC;AAmBzB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAwB,EAAE,IAAa;IAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,oBAAoB,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,4FAA4F;IAC5F,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,KAAK,aAAa;QAC7B,CAAC,YAAY,KAAK,qBAAqB;YACrC,eAAe,CAAC,IAAI,CAAC;YACrB,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,6BAA6B,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC;IAErC,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAE;QAC9B,UAAU;QACV,gBAAgB,EAAE;YAChB,GAAG,CAAC,IAAI,KAAK,SAAS;gBACpB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,8BAA8B,IAAI,CAAC,SAAS,yDAAyD;iBACtG,CAAC;YACN,GAAG,UAAU,CAAC,QAAQ;SACvB;KACF,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAC7B,KAA8C,EAC9C,KAAc;IAEd,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,KAAe,EAAE,MAAc,EAAE,KAAa;IAC7E,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;IAEzC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,MAAc,EAAE,KAAa;IAC3E,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;IAEzC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC"}

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

@@ -9,6 +9,8 @@ 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;
+export declare const EXT_SCALED_UI_AMOUNT = 25;
+export declare const EXT_PAUSABLE = 26;
 /** One transfer-fee schedule, valid from `epoch` onward until superseded. */
 export interface TransferFee {
     epoch: bigint;
@@ -43,8 +45,9 @@ export interface MintExtensions {
     /**
      * 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.
+     * mint. Only NonTransferable, DefaultAccountState=frozen and a paused
+     * Pausable mint qualify — see the `advisories` note for why PermanentDelegate
+     * / ConfidentialTransfer do NOT.
      */
     blocking: string[];
     /**
@@ -63,11 +66,13 @@ export interface MintExtensions {
 }
 /**
  * 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`.
+ * `{ blocking: [], advisories: [] }` for a legacy 82-byte mint (or any non-T22
+ * shape). For a Token-2022 mint, recognizes TransferFeeConfig and TransferHook
+ * (returned as structured fields), the un-routable set (NonTransferable,
+ * DefaultAccountState frozen, Pausable paused), each pushed as a reason string
+ * into `blocking`, and the routable trust flags (PermanentDelegate,
+ * ConfidentialTransferMint, Pausable not paused, ScaledUiAmount, MemoTransfer),
+ * each pushed into `advisories`.
  */
 export declare function parseMintExtensions(mintData: Uint8Array): MintExtensions;
 /** The TransferFee active at `epoch`: newer if epoch >= newer.epoch, else older. */
@@ -80,4 +85,10 @@ export declare function getEpochFee(cfg: TransferFeeConfig, epoch: bigint): Tran
 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;
+/**
+ * The amount to send under `cfg` at `epoch` for the recipient to receive exactly `received`, as
+ * spl-token-2022's `calculate_pre_fee_amount` computes it (the formula is in this file's header):
+ * `netTransferAmount(grossTransferAmount(r, cfg, e), cfg, e) === r`.
+ */
+export declare function grossTransferAmount(received: bigint, cfg: TransferFeeConfig, epoch: bigint): bigint;
 //# sourceMappingURL=token-extensions.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"token-extensions.d.ts","sourceRoot":"","sources":["../../src/svm/token-extensions.ts"],"names":[],"mappings":"AAwDA,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;AACpC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,YAAY,KAAK,CAAC;AAK/B,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;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAyCD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAqExE;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;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR"}

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

@@ -26,6 +26,12 @@
  *     transfer_fee_basis_points u16 LE (2).
  *   - TransferHook (extension_type 14) value: authority Pubkey (32),
  *     program_id Pubkey (32) — both OptionalNonZeroPubkey (all-zero == None).
+ *   - ScaledUiAmountConfig (extension_type 25) value: authority Pubkey (32),
+ *     multiplier f64 (8), new_multiplier_effective_timestamp i64 (8),
+ *     new_multiplier f64 (8). A display multiplier only: every amount an
+ *     instruction or a program sees is raw.
+ *   - PausableConfig (extension_type 26) value: authority Pubkey (32), paused
+ *     bool (1). While paused, Token-2022 refuses transfers, mints and burns.
  *
  * FEE FORMULA (spl-token-2022 `TransferFee::calculate_fee` /
  * `TransferFeeConfig::calculate_epoch_fee`, cross-checked):
@@ -35,6 +41,17 @@
  *   newer_transfer_fee  if epoch >= newer_transfer_fee.epoch
  *   older_transfer_fee  otherwise
  * The recipient receives amount - fee.
+ *
+ * The INVERSE (spl-token-2022 `TransferFee::calculate_pre_fee_amount`), the
+ * amount to send for the recipient to receive exactly `received`:
+ *   received                                     if bps == 0
+ *   0                                            if received == 0
+ *   received + maximum_fee                       if bps == 10_000
+ *   otherwise raw = ceil(received * 10_000 / (10_000 - bps)), and
+ *   received + maximum_fee                       if raw - received >= maximum_fee
+ *   raw                                          otherwise
+ * The fee on that amount is exactly the difference, so the recipient nets
+ * `received` to the unit.
  */
 import { getAddressDecoder } from "@solana/kit";
 import { readUintLE } from "./venues/math.js";
@@ -50,6 +67,8 @@ export const EXT_MEMO_TRANSFER = 8; // account-level extension; recognized defen
 export const EXT_NON_TRANSFERABLE = 9;
 export const EXT_PERMANENT_DELEGATE = 12;
 export const EXT_TRANSFER_HOOK = 14;
+export const EXT_SCALED_UI_AMOUNT = 25;
+export const EXT_PAUSABLE = 26;
 /** DefaultAccountState value 2 == Frozen (0 Uninitialized, 1 Initialized, 2 Frozen). */
 const ACCOUNT_STATE_FROZEN = 2;
 const addressDecoder = getAddressDecoder();
@@ -87,11 +106,13 @@ function parseTransferHook(data, value, length) {
 }
 /**
  * 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`.
+ * `{ blocking: [], advisories: [] }` for a legacy 82-byte mint (or any non-T22
+ * shape). For a Token-2022 mint, recognizes TransferFeeConfig and TransferHook
+ * (returned as structured fields), the un-routable set (NonTransferable,
+ * DefaultAccountState frozen, Pausable paused), each pushed as a reason string
+ * into `blocking`, and the routable trust flags (PermanentDelegate,
+ * ConfidentialTransferMint, Pausable not paused, ScaledUiAmount, MemoTransfer),
+ * each pushed into `advisories`.
  */
 export function parseMintExtensions(mintData) {
     const result = { blocking: [], advisories: [] };
@@ -137,6 +158,20 @@ export function parseMintExtensions(mintData) {
                 // transferChecked still works. PYUSD/USDG both carry it.
                 result.advisories.push("ConfidentialTransferMint (confidential transfers are opt-in; plain transfers still work)");
                 break;
+            case EXT_PAUSABLE:
+                if (length >= 33 && mintData[value + 32] !== 0) {
+                    // Token-2022 refuses every transfer, mint and burn until the authority resumes it.
+                    result.blocking.push("Pausable=paused (transfers fail until the mint is resumed)");
+                }
+                else {
+                    // Tokenized stocks carry it unpaused: an issuer's switch, not a transfer gate today.
+                    result.advisories.push("Pausable (the issuer can pause transfers)");
+                }
+                break;
+            case EXT_SCALED_UI_AMOUNT:
+                // NOT blocking: a display multiplier. Balances, transfers and quotes stay raw.
+                result.advisories.push("ScaledUiAmount (a UI amount is the raw amount times a multiplier; amounts here are raw)");
+                break;
             case EXT_MEMO_TRANSFER:
                 // Account-level extension — cannot appear on a mint; recognized only
                 // defensively. Surfaced as advisory, never a mint-level block.
@@ -171,4 +206,22 @@ export function calcTransferFee(amount, cfg, epoch) {
 export function netTransferAmount(amount, cfg, epoch) {
     return amount - calcTransferFee(amount, cfg, epoch);
 }
+/**
+ * The amount to send under `cfg` at `epoch` for the recipient to receive exactly `received`, as
+ * spl-token-2022's `calculate_pre_fee_amount` computes it (the formula is in this file's header):
+ * `netTransferAmount(grossTransferAmount(r, cfg, e), cfg, e) === r`.
+ */
+export function grossTransferAmount(received, cfg, epoch) {
+    const fee = getEpochFee(cfg, epoch);
+    const bps = BigInt(fee.transferFeeBasisPoints);
+    if (bps === 0n)
+        return received;
+    if (received === 0n)
+        return 0n;
+    if (bps === ONE_IN_BASIS_POINTS)
+        return received + fee.maximumFee;
+    const denominator = ONE_IN_BASIS_POINTS - bps;
+    const raw = (received * ONE_IN_BASIS_POINTS + denominator - 1n) / denominator; // ceil
+    return raw - received >= fee.maximumFee ? received + fee.maximumFee : raw;
+}
 //# sourceMappingURL=token-extensions.js.map

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

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

package/sdk/dist/token/evm.js

@@ -1,7 +1,7 @@
 /**
  * The ERC20 arm — statement/expression builders for the universal token interface's EVM lowering.
  * The writes go through `safe.ts` (OpenZeppelin `SafeERC20`); the read is a typed call against the
- * engine-vendored `IERC20` artifact, the shape `swap/source.ts`/`deposit/source.ts` already emit.
+ * engine-vendored `IERC20` artifact, the shape `deposit/source.ts` already emits.
  */
 import { formatAddressField } from "../deposit/format.js";
 import { toAddressBigint, toAmountBigint } from "./params.js";

package/sdk/dist/token/index.d.ts

@@ -7,7 +7,7 @@
  * `sdk/src/routes/chain-exports.generated.ts`); this module is also importable directly as
  * `token.Token`, or any of its named exports.
  *
- * Compiler-free, like `swap/` and `deposit/`: every function here returns SauceScript SOURCE (or a
+ * Compiler-free, like `deposit/`: every function here returns SauceScript SOURCE (or a
  * structured EVM `Call`); the caller runs `compile()` with explicit options. See
  * `sdk/src/token/source.ts` for the per-target emission seam and `sdk/src/token/api.ts` for the
  * `Token`/`TokenCall` builder shape.

package/sdk/dist/token/index.js

@@ -7,7 +7,7 @@
  * `sdk/src/routes/chain-exports.generated.ts`); this module is also importable directly as
  * `token.Token`, or any of its named exports.
  *
- * Compiler-free, like `swap/` and `deposit/`: every function here returns SauceScript SOURCE (or a
+ * Compiler-free, like `deposit/`: every function here returns SauceScript SOURCE (or a
  * structured EVM `Call`); the caller runs `compile()` with explicit options. See
  * `sdk/src/token/source.ts` for the per-target emission seam and `sdk/src/token/api.ts` for the
  * `Token`/`TokenCall` builder shape.

package/sdk/dist/token/params.js

@@ -1,5 +1,5 @@
 /**
- * Normalization + guards for the universal token interface. Mirrors `swap/params.ts`'s posture:
+ * Normalization + guards for the universal token interface. Mirrors `deposit/params.ts`'s posture:
  * throws (never emits a program that would revert on-chain) rather than guessing.
  */
 import { toExactBigInt } from "../numeric.js";

package/sdk/dist/token/source.js

@@ -1,6 +1,6 @@
 /**
  * SauceScript SOURCE emission for the universal token interface — pure string templating, no
- * compiler import (matches `swap/source.ts`/`deposit/source.ts`'s posture: every compile option
+ * compiler import (matches `deposit/source.ts`'s posture: every compile option
  * stays explicit at the call site). The `IERC20` ABI an EVM program imports is served by the route
  * compiler itself (`embedded/resolve.ts`), so compiling one needs no resolver option.
  */
@@ -98,8 +98,8 @@ export function tokenSource(spec, target, opts = {}) {
         .join("\n");
     // Every SVM account is a main() param, in attach order — that declaration IS the manifest.
     const params = isEvmTarget(target) ? "" : svmAccountParamList(specs);
-    // SVM consumers compile directly to retain the account manifest. EVM source stays plain JS for
-    // the route wrapper's accessor parser, whose compiler adapter supplies its void annotation.
+    // SVM consumers compile directly to retain the account manifest. EVM source leaves `main`
+    // unannotated: it is compiled through the route compiler, whose adapter supplies the `void`.
     const returnType = !isEvmTarget(target) && specs[specs.length - 1].op !== "balanceOf" ? ": void" : "";
     const parts = [...importLines, "", `function ${fnName}(${params})${returnType} {`, body, "}", ""];
     return parts.join("\n");

package/sdk/dist/token/source.js.map

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

package/sdk/dist/token/types.d.ts

@@ -1,6 +1,6 @@
 /**
- * The universal token interface — types + registry constants. Sibling module to `swap/` and
- * `deposit/`: compiler-free, SauceScript SOURCE emission only. See `sdk/src/token/index.ts` for the
+ * The universal token interface — types + registry constants. Sibling module to `deposit/`:
+ * compiler-free, SauceScript SOURCE emission only. See `sdk/src/token/index.ts` for the
  * module-level overview and `sdk/src/token/source.ts` for the per-target emission seam.
  */
 /** A 20-byte EVM address, as an ordinary `0x`-prefixed hex string. */

package/sdk/dist/token/types.js

@@ -1,6 +1,6 @@
 /**
- * The universal token interface — types + registry constants. Sibling module to `swap/` and
- * `deposit/`: compiler-free, SauceScript SOURCE emission only. See `sdk/src/token/index.ts` for the
+ * The universal token interface — types + registry constants. Sibling module to `deposit/`:
+ * compiler-free, SauceScript SOURCE emission only. See `sdk/src/token/index.ts` for the
  * module-level overview and `sdk/src/token/source.ts` for the per-target emission seam.
  */
 /** SPL Token TransferChecked instruction discriminant. */

package/sdk/src/protocols/aerodrome/AerodromePoolABI.json

@@ -0,0 +1,105 @@
+{
+  "abi": [
+    {
+      "name": "getReserves",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "_reserve0",
+          "type": "uint256"
+        },
+        {
+          "name": "_reserve1",
+          "type": "uint256"
+        },
+        {
+          "name": "_blockTimestampLast",
+          "type": "uint256"
+        }
+      ]
+    },
+    {
+      "name": "getAmountOut",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [
+        {
+          "name": "amountIn",
+          "type": "uint256"
+        },
+        {
+          "name": "tokenIn",
+          "type": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256"
+        }
+      ]
+    },
+    {
+      "name": "stable",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "bool"
+        }
+      ]
+    },
+    {
+      "name": "token0",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address"
+        }
+      ]
+    },
+    {
+      "name": "token1",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address"
+        }
+      ]
+    },
+    {
+      "name": "swap",
+      "type": "function",
+      "stateMutability": "nonpayable",
+      "inputs": [
+        {
+          "name": "amount0Out",
+          "type": "uint256"
+        },
+        {
+          "name": "amount1Out",
+          "type": "uint256"
+        },
+        {
+          "name": "to",
+          "type": "address"
+        },
+        {
+          "name": "data",
+          "type": "bytes"
+        }
+      ],
+      "outputs": []
+    }
+  ]
+}

package/sdk/src/protocols/aerodrome/abis.ts

@@ -76,3 +76,65 @@ export const AerodromePoolFactoryABI = [
     outputs: [{ name: "pool", type: "address" }],
   },
 ] as const;
+
+// Pool — the reads a program makes on a pool it looked up through PoolFactory, and `swap`, called
+// directly once the input is transferred to the pool. `getAmountOut` prices a trade net of the
+// pool's fee on either curve (`stable`: x³y + y³x, otherwise xy); `getReserves`' third value is a
+// timestamp. Pass empty `data`: any other calls `hook` back on `to`. From the verified Pool source,
+// of which every pool is an EIP-1167 clone.
+export const AerodromePoolABI = [
+  {
+    name: "getReserves",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [
+      { name: "_reserve0", type: "uint256" },
+      { name: "_reserve1", type: "uint256" },
+      { name: "_blockTimestampLast", type: "uint256" },
+    ],
+  },
+  {
+    name: "getAmountOut",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "amountIn", type: "uint256" },
+      { name: "tokenIn", type: "address" },
+    ],
+    outputs: [{ name: "", type: "uint256" }],
+  },
+  {
+    name: "stable",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "bool" }],
+  },
+  {
+    name: "token0",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+  },
+  {
+    name: "token1",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+  },
+  {
+    name: "swap",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "amount0Out", type: "uint256" },
+      { name: "amount1Out", type: "uint256" },
+      { name: "to", type: "address" },
+      { name: "data", type: "bytes" },
+    ],
+    outputs: [],
+  },
+] as const;