@bananapus/nana-sdk-core 1.5.1 → 1.6.0

package/dist/cjs/v6/cashOut.d.ts

@@ -108,4 +108,191 @@ export declare function getCashOutQuote(client: PublicClient, { chainId, project
     decimals?: bigint;
     currency?: bigint;
 }): Promise<CashOutQuote>;
+/**
+ * The default cash-out slippage tolerance, in basis points (1%).
+ *
+ * Quotes from {@link getHookAwareCashOutQuote} are exact against current state;
+ * this tolerance only absorbs quote-to-inclusion drift (payments, other cash
+ * outs, sucker snapshot syncs, or pool moves that land first).
+ */
+export declare const DEFAULT_CASH_OUT_SLIPPAGE_BPS = 100n;
+/**
+ * Apply a slippage tolerance to a quoted output, flooring toward zero but
+ * never below 1 for a positive quote (a zero minimum disables protection).
+ *
+ * @param quoted The quoted output amount.
+ * @param slippageBps The tolerance in basis points. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The minimum acceptable output.
+ */
+export declare function slippageFloor(quoted: bigint, slippageBps?: bigint): bigint;
+/**
+ * The exact protocol fee `JBMultiTerminal` deducts from a cash-out reclaim:
+ * `reclaimAmount / 40` (2.5%, floor division — NOT `× 975 / 1000`, which can
+ * differ by 1 wei and break an exact minimum).
+ *
+ * With a non-zero cash-out tax rate the fee applies to the full reclaim. With
+ * a zero tax rate it applies only up to the project's fee-free surplus
+ * (round-trip prevention). Feeless beneficiaries pay no fee.
+ *
+ * @param args.reclaimAmount The gross reclaim amount, before the terminal fee.
+ * @param args.cashOutTaxRate The ruleset's cash-out tax rate.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * @param args.feeFreeSurplus The project's `feeFreeSurplusOf` counter for the
+ * reclaimed token. Only consulted when the tax rate is zero.
+ * @returns The fee amount the terminal will deduct.
+ */
+export declare function cashOutProtocolFee({ reclaimAmount, cashOutTaxRate, beneficiaryIsFeeless, feeFreeSurplus, }: {
+    reclaimAmount: bigint;
+    cashOutTaxRate: bigint;
+    beneficiaryIsFeeless?: boolean;
+    feeFreeSurplus?: bigint;
+}): bigint;
+/**
+ * The diagnostic payload the buyback hook packs into its cash-out hook
+ * specification — the protocol's public preview API for the sell-side routing
+ * decision (returned by `previewCashOutFrom` whether or not the pool route
+ * wins).
+ */
+export interface BuybackCashOutSpec {
+    minimumSwapAmountOut: bigint;
+    cashOutCountToSell: bigint;
+    netDirectCashOutAmount: bigint;
+    twapTick: number;
+    twapLiquidity: bigint;
+    poolId: Hex;
+    rawSwapQuote: bigint;
+    hasUserSpecifiedMinimumSwapAmountOut: boolean;
+}
+/**
+ * Decode the buyback hook's cash-out specification metadata (see
+ * {@link BuybackCashOutSpec}).
+ */
+export declare function decodeBuybackCashOutSpec(metadata: Hex): BuybackCashOutSpec;
+/**
+ * Build the buyback hook's `cashOut` metadata entry:
+ * `(uint256 minimumSwapAmountOut, bool skip)`.
+ *
+ * `minimumSwapAmountOut` is a hard floor on the net terminal-token output,
+ * enforced by the hook on BOTH the pool route and the direct bonding-curve
+ * fallback. Note an explicit non-zero minimum skips the hook's TWAP lookup:
+ * a minimum at or below the direct net keeps execution on the terminal path,
+ * a minimum above it routes through the pool. `skip: true` forces the
+ * terminal path outright (the floor still applies).
+ *
+ * @param args.hook The hook address the terminal consults (from the preview's
+ * hook specification).
+ * @param args.minimumSwapAmountOut The net-output floor.
+ * @param args.skip Force the direct terminal path. Defaults to false.
+ * @returns The metadata to pass as `cashOutTokensOf`'s `metadata` argument.
+ */
+export declare function buildBuybackCashOutMetadata({ hook, minimumSwapAmountOut, skip, }: {
+    hook: Address;
+    minimumSwapAmountOut: bigint;
+    skip?: boolean;
+}): Hex;
+/** A hook specification tuple as returned by the terminal preview functions. */
+export interface CashOutHookSpecification {
+    hook: Address;
+    noop: boolean;
+    amount: bigint;
+    metadata: Hex;
+}
+/**
+ * A slippage-protected cash-out route: which venue the transaction should
+ * expect, and the exact `minTokensReclaimed`/`metadata` pair to submit.
+ */
+export interface CashOutRoute {
+    /** "treasury" = direct bonding-curve reclaim; "amm" = buyback pool sell. */
+    route: "treasury" | "amm";
+    /** The quoted net output on the chosen route. */
+    expectedReturn: bigint;
+    /** The slippage-floored minimum net output. */
+    minimumReturn: bigint;
+    /**
+     * The `minTokensReclaimed` to pass to `cashOutTokensOf`. Non-zero only on
+     * the treasury route — on the pool route the terminal itself reclaims
+     * nothing (the hook pays the beneficiary), so the floor lives in
+     * {@link CashOutRoute.metadata} instead.
+     */
+    terminalMinimum: bigint;
+    /** The `metadata` to pass to `cashOutTokensOf`. */
+    metadata: Hex;
+    /** The gross direct reclaim, before the terminal fee. */
+    treasuryGross: bigint;
+    /** The terminal fee on the direct reclaim. */
+    treasuryProtocolFee: bigint;
+    /** The net direct reclaim after the terminal fee. */
+    treasuryNet: bigint;
+    /** The decoded buyback diagnostics, when the hook was consulted. */
+    buyback: (BuybackCashOutSpec & {
+        hook: Address;
+    }) | null;
+}
+/**
+ * Interpret a hook-aware `previewCashOutFrom` result and prepare a
+ * slippage-protected route.
+ *
+ * On the treasury route the floor is enforced via `minTokensReclaimed`; if the
+ * routing flips to the pool between quote and inclusion, the transaction
+ * reverts rather than executing a stale path — re-quote and retry. On the pool
+ * route the floor is moved into the hook's `cashOut` metadata (the terminal
+ * minimum must be zero there), and if the floored pool quote no longer beats
+ * the direct net, the route falls back to the treasury path.
+ *
+ * @param args.reclaimAmount `previewCashOutFrom`'s gross reclaim amount.
+ * @param args.cashOutTaxRate `previewCashOutFrom`'s cash-out tax rate.
+ * @param args.hookSpecifications `previewCashOutFrom`'s hook specifications.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false (conservative: assumes the fee applies).
+ * @param args.feeFreeSurplus The terminal's `feeFreeSurplusOf` for the token.
+ * Only consulted when the tax rate is zero. Defaults to 0.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route.
+ */
+export declare function resolveCashOutRoute({ reclaimAmount, cashOutTaxRate, hookSpecifications, beneficiaryIsFeeless, feeFreeSurplus, slippageBps, }: {
+    reclaimAmount: bigint;
+    cashOutTaxRate: bigint;
+    hookSpecifications: readonly CashOutHookSpecification[];
+    beneficiaryIsFeeless?: boolean;
+    feeFreeSurplus?: bigint;
+    slippageBps?: bigint;
+}): CashOutRoute;
+/**
+ * Quote a cash out through `JBMultiTerminal.previewCashOutFrom` — the
+ * hook-aware simulation of the REAL cash-out path (data hook, buyback
+ * routing, cross-chain terms) — and prepare a slippage-protected route.
+ *
+ * Prefer this over {@link getCashOutQuote} for building transactions:
+ * `currentReclaimableSurplusOf` skips the data hook entirely, so its result
+ * can diverge from what `cashOutTokensOf` pays and is unsafe to use as a
+ * minimum.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.holder The address whose tokens would be cashed out.
+ * @param args.cashOutCount The number of project tokens to cash out.
+ * @param args.tokenToReclaim The terminal token to reclaim.
+ * @param args.beneficiary The reclaim beneficiary. Defaults to the holder.
+ * @param args.terminal The terminal to quote against. Defaults to the chain's
+ * canonical `JBMultiTerminal`.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route (see {@link CashOutRoute}).
+ */
+export declare function getHookAwareCashOutQuote(client: PublicClient, { chainId, projectId, holder, cashOutCount, tokenToReclaim, beneficiary, terminal, beneficiaryIsFeeless, slippageBps, }: {
+    chainId: JBChainId;
+    projectId: bigint;
+    holder: Address;
+    cashOutCount: bigint;
+    tokenToReclaim: Address;
+    beneficiary?: Address;
+    terminal?: Address;
+    beneficiaryIsFeeless?: boolean;
+    slippageBps?: bigint;
+}): Promise<CashOutRoute>;
 //# sourceMappingURL=cashOut.d.ts.map

package/dist/cjs/v6/cashOut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cashOut.d.ts","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AACvE,OAAO,EACL,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,kBAAkB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAuB,EACvB,WAAW,EACX,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,kBAAkB,CAgBrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,gBAAgB,EAChB,QAAQ,GACT,EAAE;IACD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,GAAG,CAiBN;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAc,EACd,QAA2C,GAC5C,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,CAAC,CAYvB"}
+{"version":3,"file":"cashOut.d.ts","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"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"}

package/dist/cjs/v6/cashOut.js

@@ -1,8 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CASH_OUT_SLIPPAGE_BPS = void 0;
 exports.buildCashOutTx = buildCashOutTx;
 exports.build721CashOutMetadata = build721CashOutMetadata;
 exports.getCashOutQuote = getCashOutQuote;
+exports.slippageFloor = slippageFloor;
+exports.cashOutProtocolFee = cashOutProtocolFee;
+exports.decodeBuybackCashOutSpec = decodeBuybackCashOutSpec;
+exports.buildBuybackCashOutMetadata = buildBuybackCashOutMetadata;
+exports.resolveCashOutRoute = resolveCashOutRoute;
+exports.getHookAwareCashOutQuote = getHookAwareCashOutQuote;
 const viem_1 = require("viem");
 const juicebox_js_1 = require("../generated/juicebox.js");
 const fee_js_1 = require("../utils/fee.js");
@@ -109,4 +116,248 @@ async function getCashOutQuote(client, { chainId, projectId, cashOutCount, decim
         reclaimAmountAfterFee: (0, fee_js_1.applyJbDaoCashOutFee)(reclaimAmount),
     };
 }
+/**
+ * The default cash-out slippage tolerance, in basis points (1%).
+ *
+ * Quotes from {@link getHookAwareCashOutQuote} are exact against current state;
+ * this tolerance only absorbs quote-to-inclusion drift (payments, other cash
+ * outs, sucker snapshot syncs, or pool moves that land first).
+ */
+exports.DEFAULT_CASH_OUT_SLIPPAGE_BPS = 100n;
+const MAX_BPS = 10000n;
+function requireBps(slippageBps) {
+    if (slippageBps < 0n || slippageBps >= MAX_BPS) {
+        throw new Error("Slippage basis points must be in [0, 10000)");
+    }
+    return slippageBps;
+}
+/**
+ * Apply a slippage tolerance to a quoted output, flooring toward zero but
+ * never below 1 for a positive quote (a zero minimum disables protection).
+ *
+ * @param quoted The quoted output amount.
+ * @param slippageBps The tolerance in basis points. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The minimum acceptable output.
+ */
+function slippageFloor(quoted, slippageBps = exports.DEFAULT_CASH_OUT_SLIPPAGE_BPS) {
+    requireBps(slippageBps);
+    if (quoted <= 0n)
+        return 0n;
+    const floor = (quoted * (MAX_BPS - slippageBps)) / MAX_BPS;
+    return floor > 0n ? floor : 1n;
+}
+/**
+ * The exact protocol fee `JBMultiTerminal` deducts from a cash-out reclaim:
+ * `reclaimAmount / 40` (2.5%, floor division — NOT `× 975 / 1000`, which can
+ * differ by 1 wei and break an exact minimum).
+ *
+ * With a non-zero cash-out tax rate the fee applies to the full reclaim. With
+ * a zero tax rate it applies only up to the project's fee-free surplus
+ * (round-trip prevention). Feeless beneficiaries pay no fee.
+ *
+ * @param args.reclaimAmount The gross reclaim amount, before the terminal fee.
+ * @param args.cashOutTaxRate The ruleset's cash-out tax rate.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * @param args.feeFreeSurplus The project's `feeFreeSurplusOf` counter for the
+ * reclaimed token. Only consulted when the tax rate is zero.
+ * @returns The fee amount the terminal will deduct.
+ */
+function cashOutProtocolFee({ reclaimAmount, cashOutTaxRate, beneficiaryIsFeeless = false, feeFreeSurplus = 0n, }) {
+    if (reclaimAmount <= 0n || beneficiaryIsFeeless)
+        return 0n;
+    if (cashOutTaxRate > 0n)
+        return reclaimAmount / 40n;
+    const feeable = reclaimAmount < feeFreeSurplus ? reclaimAmount : feeFreeSurplus;
+    return feeable / 40n;
+}
+const BUYBACK_CASH_OUT_SPEC_ABI = [
+    { name: "minimumSwapAmountOut", type: "uint256" },
+    { name: "cashOutCountToSell", type: "uint256" },
+    { name: "netDirectCashOutAmount", type: "uint256" },
+    { name: "twapTick", type: "int24" },
+    { name: "twapLiquidity", type: "uint128" },
+    { name: "poolId", type: "bytes32" },
+    { name: "rawSwapQuote", type: "uint256" },
+    { name: "hasUserSpecifiedMinimumSwapAmountOut", type: "bool" },
+];
+/**
+ * Decode the buyback hook's cash-out specification metadata (see
+ * {@link BuybackCashOutSpec}).
+ */
+function decodeBuybackCashOutSpec(metadata) {
+    const [minimumSwapAmountOut, cashOutCountToSell, netDirectCashOutAmount, twapTick, twapLiquidity, poolId, rawSwapQuote, hasUserSpecifiedMinimumSwapAmountOut,] = (0, viem_1.decodeAbiParameters)(BUYBACK_CASH_OUT_SPEC_ABI, metadata);
+    return {
+        minimumSwapAmountOut,
+        cashOutCountToSell,
+        netDirectCashOutAmount,
+        twapTick,
+        twapLiquidity,
+        poolId,
+        rawSwapQuote,
+        hasUserSpecifiedMinimumSwapAmountOut,
+    };
+}
+/**
+ * Build the buyback hook's `cashOut` metadata entry:
+ * `(uint256 minimumSwapAmountOut, bool skip)`.
+ *
+ * `minimumSwapAmountOut` is a hard floor on the net terminal-token output,
+ * enforced by the hook on BOTH the pool route and the direct bonding-curve
+ * fallback. Note an explicit non-zero minimum skips the hook's TWAP lookup:
+ * a minimum at or below the direct net keeps execution on the terminal path,
+ * a minimum above it routes through the pool. `skip: true` forces the
+ * terminal path outright (the floor still applies).
+ *
+ * @param args.hook The hook address the terminal consults (from the preview's
+ * hook specification).
+ * @param args.minimumSwapAmountOut The net-output floor.
+ * @param args.skip Force the direct terminal path. Defaults to false.
+ * @returns The metadata to pass as `cashOutTokensOf`'s `metadata` argument.
+ */
+function buildBuybackCashOutMetadata({ hook, minimumSwapAmountOut, skip = false, }) {
+    if (minimumSwapAmountOut < 0n) {
+        throw new Error("Cash out minimum cannot be negative");
+    }
+    const payload = (0, viem_1.encodeAbiParameters)([{ type: "uint256" }, { type: "bool" }], [minimumSwapAmountOut, skip]);
+    return (0, hook_js_1.createHookMetadata)([(0, hook_js_1.hookMetadataId)(hook, "cashOut")], [payload]);
+}
+/**
+ * Interpret a hook-aware `previewCashOutFrom` result and prepare a
+ * slippage-protected route.
+ *
+ * On the treasury route the floor is enforced via `minTokensReclaimed`; if the
+ * routing flips to the pool between quote and inclusion, the transaction
+ * reverts rather than executing a stale path — re-quote and retry. On the pool
+ * route the floor is moved into the hook's `cashOut` metadata (the terminal
+ * minimum must be zero there), and if the floored pool quote no longer beats
+ * the direct net, the route falls back to the treasury path.
+ *
+ * @param args.reclaimAmount `previewCashOutFrom`'s gross reclaim amount.
+ * @param args.cashOutTaxRate `previewCashOutFrom`'s cash-out tax rate.
+ * @param args.hookSpecifications `previewCashOutFrom`'s hook specifications.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false (conservative: assumes the fee applies).
+ * @param args.feeFreeSurplus The terminal's `feeFreeSurplusOf` for the token.
+ * Only consulted when the tax rate is zero. Defaults to 0.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route.
+ */
+function resolveCashOutRoute({ reclaimAmount, cashOutTaxRate, hookSpecifications, beneficiaryIsFeeless = false, feeFreeSurplus = 0n, slippageBps = exports.DEFAULT_CASH_OUT_SLIPPAGE_BPS, }) {
+    requireBps(slippageBps);
+    const treasuryProtocolFee = cashOutProtocolFee({
+        reclaimAmount,
+        cashOutTaxRate,
+        beneficiaryIsFeeless,
+        feeFreeSurplus,
+    });
+    const treasuryNet = reclaimAmount - treasuryProtocolFee;
+    const specification = hookSpecifications.find((spec) => spec.metadata !== "0x") ?? null;
+    const buyback = specification
+        ? {
+            hook: specification.hook,
+            ...decodeBuybackCashOutSpec(specification.metadata),
+        }
+        : null;
+    const treasuryRoute = {
+        route: "treasury",
+        expectedReturn: treasuryNet,
+        minimumReturn: slippageFloor(treasuryNet, slippageBps),
+        terminalMinimum: slippageFloor(treasuryNet, slippageBps),
+        metadata: "0x",
+        treasuryGross: reclaimAmount,
+        treasuryProtocolFee,
+        treasuryNet,
+        buyback,
+    };
+    if (!specification || specification.noop || !buyback)
+        return treasuryRoute;
+    // The pool route won the preview. Re-previews with an explicit metadata
+    // minimum report that already-protected floor and no raw quote — preserve
+    // it instead of discounting a second time.
+    const quote = buyback.rawSwapQuote > 0n
+        ? buyback.rawSwapQuote
+        : buyback.minimumSwapAmountOut;
+    const minimumReturn = buyback.rawSwapQuote > 0n && !buyback.hasUserSpecifiedMinimumSwapAmountOut
+        ? slippageFloor(quote, slippageBps)
+        : buyback.minimumSwapAmountOut;
+    // An explicit metadata minimum at or below the direct net routes execution
+    // back to the terminal path anyway; take the deterministic treasury route.
+    if (quote <= 0n || minimumReturn <= buyback.netDirectCashOutAmount) {
+        return treasuryRoute;
+    }
+    return {
+        route: "amm",
+        expectedReturn: quote,
+        minimumReturn,
+        terminalMinimum: 0n,
+        metadata: buildBuybackCashOutMetadata({
+            hook: specification.hook,
+            minimumSwapAmountOut: minimumReturn,
+        }),
+        treasuryGross: reclaimAmount,
+        treasuryProtocolFee,
+        treasuryNet,
+        buyback,
+    };
+}
+/**
+ * Quote a cash out through `JBMultiTerminal.previewCashOutFrom` — the
+ * hook-aware simulation of the REAL cash-out path (data hook, buyback
+ * routing, cross-chain terms) — and prepare a slippage-protected route.
+ *
+ * Prefer this over {@link getCashOutQuote} for building transactions:
+ * `currentReclaimableSurplusOf` skips the data hook entirely, so its result
+ * can diverge from what `cashOutTokensOf` pays and is unsafe to use as a
+ * minimum.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.holder The address whose tokens would be cashed out.
+ * @param args.cashOutCount The number of project tokens to cash out.
+ * @param args.tokenToReclaim The terminal token to reclaim.
+ * @param args.beneficiary The reclaim beneficiary. Defaults to the holder.
+ * @param args.terminal The terminal to quote against. Defaults to the chain's
+ * canonical `JBMultiTerminal`.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route (see {@link CashOutRoute}).
+ */
+async function getHookAwareCashOutQuote(client, { chainId, projectId, holder, cashOutCount, tokenToReclaim, beneficiary, terminal, beneficiaryIsFeeless = false, slippageBps = exports.DEFAULT_CASH_OUT_SLIPPAGE_BPS, }) {
+    const terminalAddress = terminal ?? (0, types_js_1.v6Address)("JBMultiTerminal", chainId);
+    const [, reclaimAmount, cashOutTaxRate, hookSpecifications] = await client.readContract({
+        address: terminalAddress,
+        abi: juicebox_js_1.jbMultiTerminalAbi,
+        functionName: "previewCashOutFrom",
+        args: [
+            holder,
+            projectId,
+            cashOutCount,
+            tokenToReclaim,
+            beneficiary ?? holder,
+            "0x",
+        ],
+    });
+    // The fee-free surplus counter only matters on zero-tax rulesets.
+    const feeFreeSurplus = cashOutTaxRate === 0n
+        ? await client.readContract({
+            address: terminalAddress,
+            abi: juicebox_js_1.jbMultiTerminalAbi,
+            functionName: "feeFreeSurplusOf",
+            args: [projectId, tokenToReclaim],
+        })
+        : 0n;
+    return resolveCashOutRoute({
+        reclaimAmount,
+        cashOutTaxRate,
+        hookSpecifications,
+        beneficiaryIsFeeless,
+        feeFreeSurplus,
+        slippageBps,
+    });
+}
 //# sourceMappingURL=cashOut.js.map

package/dist/cjs/v6/cashOut.js.map

@@ -1 +1 @@
-{"version":3,"file":"cashOut.js","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":";;AAwCA,wCAoCC;AAqBD,0DAuBC;AAyCD,0CA2BC;AA5LD,+BAAuE;AACvE,0DAGkC;AAElC,4CAAuD;AACvD,8CAAsE;AACtE,+CAAyD;AACzD,yCAAuC;AAcvC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAkB,GAAG,EAAE,EACvB,WAAW,EACX,QAAQ,GAAG,IAAI,GAWhB;IACC,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,gCAAkB;QACvB,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE;YACJ,MAAM;YACN,SAAS;YACT,YAAY;YACZ,cAAc;YACd,kBAAkB;YAClB,WAAW;YACX,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,uBAAuB,CAAC,EACtC,gBAAgB,EAChB,QAAQ,GAIT;IACC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,0BAAmB,EAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzE,OAAO,IAAA,4BAAkB,EACvB,CAAC,IAAA,wBAAc,EAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,EAC7C,CAAC,OAAO,CAAC,CACH,CAAC;AACX,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,eAAe,CACnC,MAAoB,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,GAAG,GAAG,EACd,QAAQ,GAAG,MAAM,CAAC,sCAAwB,CAAC,GAO5C;IAED,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,IAAA,oBAAS,EAAC,iBAAiB,EAAE,OAAO,CAAC;QAC9C,GAAG,EAAE,gCAAkB;QACvB,YAAY,EAAE,6BAA6B;QAC3C,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,aAAa;QACb,qBAAqB,EAAE,IAAA,6BAAoB,EAAC,aAAa,CAAC;KAC3D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cashOut.js","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/cashOut.d.ts

@@ -108,4 +108,191 @@ export declare function getCashOutQuote(client: PublicClient, { chainId, project
     decimals?: bigint;
     currency?: bigint;
 }): Promise<CashOutQuote>;
+/**
+ * The default cash-out slippage tolerance, in basis points (1%).
+ *
+ * Quotes from {@link getHookAwareCashOutQuote} are exact against current state;
+ * this tolerance only absorbs quote-to-inclusion drift (payments, other cash
+ * outs, sucker snapshot syncs, or pool moves that land first).
+ */
+export declare const DEFAULT_CASH_OUT_SLIPPAGE_BPS = 100n;
+/**
+ * Apply a slippage tolerance to a quoted output, flooring toward zero but
+ * never below 1 for a positive quote (a zero minimum disables protection).
+ *
+ * @param quoted The quoted output amount.
+ * @param slippageBps The tolerance in basis points. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The minimum acceptable output.
+ */
+export declare function slippageFloor(quoted: bigint, slippageBps?: bigint): bigint;
+/**
+ * The exact protocol fee `JBMultiTerminal` deducts from a cash-out reclaim:
+ * `reclaimAmount / 40` (2.5%, floor division — NOT `× 975 / 1000`, which can
+ * differ by 1 wei and break an exact minimum).
+ *
+ * With a non-zero cash-out tax rate the fee applies to the full reclaim. With
+ * a zero tax rate it applies only up to the project's fee-free surplus
+ * (round-trip prevention). Feeless beneficiaries pay no fee.
+ *
+ * @param args.reclaimAmount The gross reclaim amount, before the terminal fee.
+ * @param args.cashOutTaxRate The ruleset's cash-out tax rate.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * @param args.feeFreeSurplus The project's `feeFreeSurplusOf` counter for the
+ * reclaimed token. Only consulted when the tax rate is zero.
+ * @returns The fee amount the terminal will deduct.
+ */
+export declare function cashOutProtocolFee({ reclaimAmount, cashOutTaxRate, beneficiaryIsFeeless, feeFreeSurplus, }: {
+    reclaimAmount: bigint;
+    cashOutTaxRate: bigint;
+    beneficiaryIsFeeless?: boolean;
+    feeFreeSurplus?: bigint;
+}): bigint;
+/**
+ * The diagnostic payload the buyback hook packs into its cash-out hook
+ * specification — the protocol's public preview API for the sell-side routing
+ * decision (returned by `previewCashOutFrom` whether or not the pool route
+ * wins).
+ */
+export interface BuybackCashOutSpec {
+    minimumSwapAmountOut: bigint;
+    cashOutCountToSell: bigint;
+    netDirectCashOutAmount: bigint;
+    twapTick: number;
+    twapLiquidity: bigint;
+    poolId: Hex;
+    rawSwapQuote: bigint;
+    hasUserSpecifiedMinimumSwapAmountOut: boolean;
+}
+/**
+ * Decode the buyback hook's cash-out specification metadata (see
+ * {@link BuybackCashOutSpec}).
+ */
+export declare function decodeBuybackCashOutSpec(metadata: Hex): BuybackCashOutSpec;
+/**
+ * Build the buyback hook's `cashOut` metadata entry:
+ * `(uint256 minimumSwapAmountOut, bool skip)`.
+ *
+ * `minimumSwapAmountOut` is a hard floor on the net terminal-token output,
+ * enforced by the hook on BOTH the pool route and the direct bonding-curve
+ * fallback. Note an explicit non-zero minimum skips the hook's TWAP lookup:
+ * a minimum at or below the direct net keeps execution on the terminal path,
+ * a minimum above it routes through the pool. `skip: true` forces the
+ * terminal path outright (the floor still applies).
+ *
+ * @param args.hook The hook address the terminal consults (from the preview's
+ * hook specification).
+ * @param args.minimumSwapAmountOut The net-output floor.
+ * @param args.skip Force the direct terminal path. Defaults to false.
+ * @returns The metadata to pass as `cashOutTokensOf`'s `metadata` argument.
+ */
+export declare function buildBuybackCashOutMetadata({ hook, minimumSwapAmountOut, skip, }: {
+    hook: Address;
+    minimumSwapAmountOut: bigint;
+    skip?: boolean;
+}): Hex;
+/** A hook specification tuple as returned by the terminal preview functions. */
+export interface CashOutHookSpecification {
+    hook: Address;
+    noop: boolean;
+    amount: bigint;
+    metadata: Hex;
+}
+/**
+ * A slippage-protected cash-out route: which venue the transaction should
+ * expect, and the exact `minTokensReclaimed`/`metadata` pair to submit.
+ */
+export interface CashOutRoute {
+    /** "treasury" = direct bonding-curve reclaim; "amm" = buyback pool sell. */
+    route: "treasury" | "amm";
+    /** The quoted net output on the chosen route. */
+    expectedReturn: bigint;
+    /** The slippage-floored minimum net output. */
+    minimumReturn: bigint;
+    /**
+     * The `minTokensReclaimed` to pass to `cashOutTokensOf`. Non-zero only on
+     * the treasury route — on the pool route the terminal itself reclaims
+     * nothing (the hook pays the beneficiary), so the floor lives in
+     * {@link CashOutRoute.metadata} instead.
+     */
+    terminalMinimum: bigint;
+    /** The `metadata` to pass to `cashOutTokensOf`. */
+    metadata: Hex;
+    /** The gross direct reclaim, before the terminal fee. */
+    treasuryGross: bigint;
+    /** The terminal fee on the direct reclaim. */
+    treasuryProtocolFee: bigint;
+    /** The net direct reclaim after the terminal fee. */
+    treasuryNet: bigint;
+    /** The decoded buyback diagnostics, when the hook was consulted. */
+    buyback: (BuybackCashOutSpec & {
+        hook: Address;
+    }) | null;
+}
+/**
+ * Interpret a hook-aware `previewCashOutFrom` result and prepare a
+ * slippage-protected route.
+ *
+ * On the treasury route the floor is enforced via `minTokensReclaimed`; if the
+ * routing flips to the pool between quote and inclusion, the transaction
+ * reverts rather than executing a stale path — re-quote and retry. On the pool
+ * route the floor is moved into the hook's `cashOut` metadata (the terminal
+ * minimum must be zero there), and if the floored pool quote no longer beats
+ * the direct net, the route falls back to the treasury path.
+ *
+ * @param args.reclaimAmount `previewCashOutFrom`'s gross reclaim amount.
+ * @param args.cashOutTaxRate `previewCashOutFrom`'s cash-out tax rate.
+ * @param args.hookSpecifications `previewCashOutFrom`'s hook specifications.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false (conservative: assumes the fee applies).
+ * @param args.feeFreeSurplus The terminal's `feeFreeSurplusOf` for the token.
+ * Only consulted when the tax rate is zero. Defaults to 0.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route.
+ */
+export declare function resolveCashOutRoute({ reclaimAmount, cashOutTaxRate, hookSpecifications, beneficiaryIsFeeless, feeFreeSurplus, slippageBps, }: {
+    reclaimAmount: bigint;
+    cashOutTaxRate: bigint;
+    hookSpecifications: readonly CashOutHookSpecification[];
+    beneficiaryIsFeeless?: boolean;
+    feeFreeSurplus?: bigint;
+    slippageBps?: bigint;
+}): CashOutRoute;
+/**
+ * Quote a cash out through `JBMultiTerminal.previewCashOutFrom` — the
+ * hook-aware simulation of the REAL cash-out path (data hook, buyback
+ * routing, cross-chain terms) — and prepare a slippage-protected route.
+ *
+ * Prefer this over {@link getCashOutQuote} for building transactions:
+ * `currentReclaimableSurplusOf` skips the data hook entirely, so its result
+ * can diverge from what `cashOutTokensOf` pays and is unsafe to use as a
+ * minimum.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.holder The address whose tokens would be cashed out.
+ * @param args.cashOutCount The number of project tokens to cash out.
+ * @param args.tokenToReclaim The terminal token to reclaim.
+ * @param args.beneficiary The reclaim beneficiary. Defaults to the holder.
+ * @param args.terminal The terminal to quote against. Defaults to the chain's
+ * canonical `JBMultiTerminal`.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route (see {@link CashOutRoute}).
+ */
+export declare function getHookAwareCashOutQuote(client: PublicClient, { chainId, projectId, holder, cashOutCount, tokenToReclaim, beneficiary, terminal, beneficiaryIsFeeless, slippageBps, }: {
+    chainId: JBChainId;
+    projectId: bigint;
+    holder: Address;
+    cashOutCount: bigint;
+    tokenToReclaim: Address;
+    beneficiary?: Address;
+    terminal?: Address;
+    beneficiaryIsFeeless?: boolean;
+    slippageBps?: bigint;
+}): Promise<CashOutRoute>;
 //# sourceMappingURL=cashOut.d.ts.map

package/dist/esm/v6/cashOut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cashOut.d.ts","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AACvE,OAAO,EACL,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,kBAAkB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAuB,EACvB,WAAW,EACX,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,kBAAkB,CAgBrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,gBAAgB,EAChB,QAAQ,GACT,EAAE;IACD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,GAAG,CAiBN;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAc,EACd,QAA2C,GAC5C,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,CAAC,CAYvB"}
+{"version":3,"file":"cashOut.d.ts","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/cashOut.js

@@ -1,4 +1,4 @@
-import { encodeAbiParameters } from "viem";
+import { decodeAbiParameters, encodeAbiParameters, } from "viem";
 import { jbMultiTerminalAbi, jbTerminalStoreAbi, } from "../generated/juicebox.js";
 import { applyJbDaoCashOutFee } from "../utils/fee.js";
 import { createHookMetadata, hookMetadataId } from "../utils/hook.js";
@@ -104,4 +104,248 @@ export async function getCashOutQuote(client, { chainId, projectId, cashOutCount
         reclaimAmountAfterFee: applyJbDaoCashOutFee(reclaimAmount),
     };
 }
+/**
+ * The default cash-out slippage tolerance, in basis points (1%).
+ *
+ * Quotes from {@link getHookAwareCashOutQuote} are exact against current state;
+ * this tolerance only absorbs quote-to-inclusion drift (payments, other cash
+ * outs, sucker snapshot syncs, or pool moves that land first).
+ */
+export const DEFAULT_CASH_OUT_SLIPPAGE_BPS = 100n;
+const MAX_BPS = 10000n;
+function requireBps(slippageBps) {
+    if (slippageBps < 0n || slippageBps >= MAX_BPS) {
+        throw new Error("Slippage basis points must be in [0, 10000)");
+    }
+    return slippageBps;
+}
+/**
+ * Apply a slippage tolerance to a quoted output, flooring toward zero but
+ * never below 1 for a positive quote (a zero minimum disables protection).
+ *
+ * @param quoted The quoted output amount.
+ * @param slippageBps The tolerance in basis points. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The minimum acceptable output.
+ */
+export function slippageFloor(quoted, slippageBps = DEFAULT_CASH_OUT_SLIPPAGE_BPS) {
+    requireBps(slippageBps);
+    if (quoted <= 0n)
+        return 0n;
+    const floor = (quoted * (MAX_BPS - slippageBps)) / MAX_BPS;
+    return floor > 0n ? floor : 1n;
+}
+/**
+ * The exact protocol fee `JBMultiTerminal` deducts from a cash-out reclaim:
+ * `reclaimAmount / 40` (2.5%, floor division — NOT `× 975 / 1000`, which can
+ * differ by 1 wei and break an exact minimum).
+ *
+ * With a non-zero cash-out tax rate the fee applies to the full reclaim. With
+ * a zero tax rate it applies only up to the project's fee-free surplus
+ * (round-trip prevention). Feeless beneficiaries pay no fee.
+ *
+ * @param args.reclaimAmount The gross reclaim amount, before the terminal fee.
+ * @param args.cashOutTaxRate The ruleset's cash-out tax rate.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * @param args.feeFreeSurplus The project's `feeFreeSurplusOf` counter for the
+ * reclaimed token. Only consulted when the tax rate is zero.
+ * @returns The fee amount the terminal will deduct.
+ */
+export function cashOutProtocolFee({ reclaimAmount, cashOutTaxRate, beneficiaryIsFeeless = false, feeFreeSurplus = 0n, }) {
+    if (reclaimAmount <= 0n || beneficiaryIsFeeless)
+        return 0n;
+    if (cashOutTaxRate > 0n)
+        return reclaimAmount / 40n;
+    const feeable = reclaimAmount < feeFreeSurplus ? reclaimAmount : feeFreeSurplus;
+    return feeable / 40n;
+}
+const BUYBACK_CASH_OUT_SPEC_ABI = [
+    { name: "minimumSwapAmountOut", type: "uint256" },
+    { name: "cashOutCountToSell", type: "uint256" },
+    { name: "netDirectCashOutAmount", type: "uint256" },
+    { name: "twapTick", type: "int24" },
+    { name: "twapLiquidity", type: "uint128" },
+    { name: "poolId", type: "bytes32" },
+    { name: "rawSwapQuote", type: "uint256" },
+    { name: "hasUserSpecifiedMinimumSwapAmountOut", type: "bool" },
+];
+/**
+ * Decode the buyback hook's cash-out specification metadata (see
+ * {@link BuybackCashOutSpec}).
+ */
+export function decodeBuybackCashOutSpec(metadata) {
+    const [minimumSwapAmountOut, cashOutCountToSell, netDirectCashOutAmount, twapTick, twapLiquidity, poolId, rawSwapQuote, hasUserSpecifiedMinimumSwapAmountOut,] = decodeAbiParameters(BUYBACK_CASH_OUT_SPEC_ABI, metadata);
+    return {
+        minimumSwapAmountOut,
+        cashOutCountToSell,
+        netDirectCashOutAmount,
+        twapTick,
+        twapLiquidity,
+        poolId,
+        rawSwapQuote,
+        hasUserSpecifiedMinimumSwapAmountOut,
+    };
+}
+/**
+ * Build the buyback hook's `cashOut` metadata entry:
+ * `(uint256 minimumSwapAmountOut, bool skip)`.
+ *
+ * `minimumSwapAmountOut` is a hard floor on the net terminal-token output,
+ * enforced by the hook on BOTH the pool route and the direct bonding-curve
+ * fallback. Note an explicit non-zero minimum skips the hook's TWAP lookup:
+ * a minimum at or below the direct net keeps execution on the terminal path,
+ * a minimum above it routes through the pool. `skip: true` forces the
+ * terminal path outright (the floor still applies).
+ *
+ * @param args.hook The hook address the terminal consults (from the preview's
+ * hook specification).
+ * @param args.minimumSwapAmountOut The net-output floor.
+ * @param args.skip Force the direct terminal path. Defaults to false.
+ * @returns The metadata to pass as `cashOutTokensOf`'s `metadata` argument.
+ */
+export function buildBuybackCashOutMetadata({ hook, minimumSwapAmountOut, skip = false, }) {
+    if (minimumSwapAmountOut < 0n) {
+        throw new Error("Cash out minimum cannot be negative");
+    }
+    const payload = encodeAbiParameters([{ type: "uint256" }, { type: "bool" }], [minimumSwapAmountOut, skip]);
+    return createHookMetadata([hookMetadataId(hook, "cashOut")], [payload]);
+}
+/**
+ * Interpret a hook-aware `previewCashOutFrom` result and prepare a
+ * slippage-protected route.
+ *
+ * On the treasury route the floor is enforced via `minTokensReclaimed`; if the
+ * routing flips to the pool between quote and inclusion, the transaction
+ * reverts rather than executing a stale path — re-quote and retry. On the pool
+ * route the floor is moved into the hook's `cashOut` metadata (the terminal
+ * minimum must be zero there), and if the floored pool quote no longer beats
+ * the direct net, the route falls back to the treasury path.
+ *
+ * @param args.reclaimAmount `previewCashOutFrom`'s gross reclaim amount.
+ * @param args.cashOutTaxRate `previewCashOutFrom`'s cash-out tax rate.
+ * @param args.hookSpecifications `previewCashOutFrom`'s hook specifications.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false (conservative: assumes the fee applies).
+ * @param args.feeFreeSurplus The terminal's `feeFreeSurplusOf` for the token.
+ * Only consulted when the tax rate is zero. Defaults to 0.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route.
+ */
+export function resolveCashOutRoute({ reclaimAmount, cashOutTaxRate, hookSpecifications, beneficiaryIsFeeless = false, feeFreeSurplus = 0n, slippageBps = DEFAULT_CASH_OUT_SLIPPAGE_BPS, }) {
+    requireBps(slippageBps);
+    const treasuryProtocolFee = cashOutProtocolFee({
+        reclaimAmount,
+        cashOutTaxRate,
+        beneficiaryIsFeeless,
+        feeFreeSurplus,
+    });
+    const treasuryNet = reclaimAmount - treasuryProtocolFee;
+    const specification = hookSpecifications.find((spec) => spec.metadata !== "0x") ?? null;
+    const buyback = specification
+        ? {
+            hook: specification.hook,
+            ...decodeBuybackCashOutSpec(specification.metadata),
+        }
+        : null;
+    const treasuryRoute = {
+        route: "treasury",
+        expectedReturn: treasuryNet,
+        minimumReturn: slippageFloor(treasuryNet, slippageBps),
+        terminalMinimum: slippageFloor(treasuryNet, slippageBps),
+        metadata: "0x",
+        treasuryGross: reclaimAmount,
+        treasuryProtocolFee,
+        treasuryNet,
+        buyback,
+    };
+    if (!specification || specification.noop || !buyback)
+        return treasuryRoute;
+    // The pool route won the preview. Re-previews with an explicit metadata
+    // minimum report that already-protected floor and no raw quote — preserve
+    // it instead of discounting a second time.
+    const quote = buyback.rawSwapQuote > 0n
+        ? buyback.rawSwapQuote
+        : buyback.minimumSwapAmountOut;
+    const minimumReturn = buyback.rawSwapQuote > 0n && !buyback.hasUserSpecifiedMinimumSwapAmountOut
+        ? slippageFloor(quote, slippageBps)
+        : buyback.minimumSwapAmountOut;
+    // An explicit metadata minimum at or below the direct net routes execution
+    // back to the terminal path anyway; take the deterministic treasury route.
+    if (quote <= 0n || minimumReturn <= buyback.netDirectCashOutAmount) {
+        return treasuryRoute;
+    }
+    return {
+        route: "amm",
+        expectedReturn: quote,
+        minimumReturn,
+        terminalMinimum: 0n,
+        metadata: buildBuybackCashOutMetadata({
+            hook: specification.hook,
+            minimumSwapAmountOut: minimumReturn,
+        }),
+        treasuryGross: reclaimAmount,
+        treasuryProtocolFee,
+        treasuryNet,
+        buyback,
+    };
+}
+/**
+ * Quote a cash out through `JBMultiTerminal.previewCashOutFrom` — the
+ * hook-aware simulation of the REAL cash-out path (data hook, buyback
+ * routing, cross-chain terms) — and prepare a slippage-protected route.
+ *
+ * Prefer this over {@link getCashOutQuote} for building transactions:
+ * `currentReclaimableSurplusOf` skips the data hook entirely, so its result
+ * can diverge from what `cashOutTokensOf` pays and is unsafe to use as a
+ * minimum.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.holder The address whose tokens would be cashed out.
+ * @param args.cashOutCount The number of project tokens to cash out.
+ * @param args.tokenToReclaim The terminal token to reclaim.
+ * @param args.beneficiary The reclaim beneficiary. Defaults to the holder.
+ * @param args.terminal The terminal to quote against. Defaults to the chain's
+ * canonical `JBMultiTerminal`.
+ * @param args.beneficiaryIsFeeless Whether the beneficiary is feeless.
+ * Defaults to false.
+ * @param args.slippageBps Tolerance for quote-to-inclusion drift. Defaults to
+ * {@link DEFAULT_CASH_OUT_SLIPPAGE_BPS}.
+ * @returns The protected route (see {@link CashOutRoute}).
+ */
+export async function getHookAwareCashOutQuote(client, { chainId, projectId, holder, cashOutCount, tokenToReclaim, beneficiary, terminal, beneficiaryIsFeeless = false, slippageBps = DEFAULT_CASH_OUT_SLIPPAGE_BPS, }) {
+    const terminalAddress = terminal ?? v6Address("JBMultiTerminal", chainId);
+    const [, reclaimAmount, cashOutTaxRate, hookSpecifications] = await client.readContract({
+        address: terminalAddress,
+        abi: jbMultiTerminalAbi,
+        functionName: "previewCashOutFrom",
+        args: [
+            holder,
+            projectId,
+            cashOutCount,
+            tokenToReclaim,
+            beneficiary ?? holder,
+            "0x",
+        ],
+    });
+    // The fee-free surplus counter only matters on zero-tax rulesets.
+    const feeFreeSurplus = cashOutTaxRate === 0n
+        ? await client.readContract({
+            address: terminalAddress,
+            abi: jbMultiTerminalAbi,
+            functionName: "feeFreeSurplusOf",
+            args: [projectId, tokenToReclaim],
+        })
+        : 0n;
+    return resolveCashOutRoute({
+        reclaimAmount,
+        cashOutTaxRate,
+        hookSpecifications,
+        beneficiaryIsFeeless,
+        feeFreeSurplus,
+        slippageBps,
+    });
+}
 //# sourceMappingURL=cashOut.js.map

package/dist/esm/v6/cashOut.js.map

@@ -1 +1 @@
-{"version":3,"file":"cashOut.js","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,mBAAmB,EAAE,MAAM,MAAM,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAcvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAkB,GAAG,EAAE,EACvB,WAAW,EACX,QAAQ,GAAG,IAAI,GAWhB;IACC,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE;YACJ,MAAM;YACN,SAAS;YACT,YAAY;YACZ,cAAc;YACd,kBAAkB;YAClB,WAAW;YACX,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,gBAAgB,EAChB,QAAQ,GAIT;IACC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzE,OAAO,kBAAkB,CACvB,CAAC,cAAc,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,EAC7C,CAAC,OAAO,CAAC,CACH,CAAC;AACX,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAoB,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,GAAG,GAAG,EACd,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAO5C;IAED,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC;QAC9C,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,6BAA6B;QAC3C,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,aAAa;QACb,qBAAqB,EAAE,oBAAoB,CAAC,aAAa,CAAC;KAC3D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cashOut.js","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/nana-sdk-core",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "type": "module",
   "repository": {
     "type": "git",