@bananapus/nana-sdk-core 1.9.4 → 1.10.0

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

@@ -0,0 +1,169 @@
+import type { Address, Hex, PublicClient } from "viem";
+import type { JBChainId } from "../types.js";
+/** Canonical Permit2 deployment shared by supported EVM chains. */
+export declare const PERMIT2_ADDRESS: `0x${string}`;
+/** Permit2 methods used to inspect or establish Universal Router allowances. */
+export declare const permit2Abi: readonly [{
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }];
+    readonly outputs: readonly [];
+}];
+/** EIP-712 types for Permit2's one-token, one-spender authorization. */
+export declare const PERMIT2_TYPES: {
+    readonly PermitDetails: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+    readonly PermitSingle: readonly [{
+        readonly name: "details";
+        readonly type: "PermitDetails";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "sigDeadline";
+        readonly type: "uint256";
+    }];
+};
+export interface Permit2SignatureAuthorization {
+    chainId: JBChainId;
+    token: Address;
+    spender: Address;
+    amount: bigint;
+    expiration: number;
+    nonce: number;
+    sigDeadline: bigint;
+}
+export interface Permit2Allowance {
+    amount: bigint;
+    expiration: number;
+    nonce: number;
+}
+/** Build the exact typed-data payload a wallet signs for PermitSingle. */
+export declare function permit2TypedData(authorization: Permit2SignatureAuthorization): {
+    domain: {
+        name: "Permit2";
+        chainId: 1 | 11155111 | 10 | 11155420 | 8453 | 84532 | 42161 | 421614;
+        verifyingContract: `0x${string}`;
+    };
+    types: {
+        readonly PermitDetails: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint160";
+        }, {
+            readonly name: "expiration";
+            readonly type: "uint48";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint48";
+        }];
+        readonly PermitSingle: readonly [{
+            readonly name: "details";
+            readonly type: "PermitDetails";
+        }, {
+            readonly name: "spender";
+            readonly type: "address";
+        }, {
+            readonly name: "sigDeadline";
+            readonly type: "uint256";
+        }];
+    };
+    primaryType: "PermitSingle";
+    message: {
+        details: {
+            token: `0x${string}`;
+            amount: bigint;
+            expiration: number;
+            nonce: number;
+        };
+        spender: `0x${string}`;
+        sigDeadline: bigint;
+    };
+};
+/** Read an owner's Permit2 allowance, defaulting the spender to Universal Router. */
+export declare function readPermit2Allowance(client: PublicClient, { chainId, owner, token, spender, }: {
+    chainId: JBChainId;
+    owner: Address;
+    token: Address;
+    spender?: Address;
+}): Promise<Permit2Allowance>;
+/** Whether an allowance is too small or expires inside the safety buffer. */
+export declare function permit2AllowanceNeedsRefresh({ allowance, amount, now, expirationBufferSeconds, }: {
+    allowance: Pick<Permit2Allowance, "amount" | "expiration">;
+    amount: bigint;
+    now?: number;
+    expirationBufferSeconds?: number;
+}): boolean;
+/** Read whether an ERC-20 needs a fresh Permit2 authorization for Universal Router. */
+export declare function needsPermit2Approval({ client, chainId, owner, token, amount, now, expirationBufferSeconds, }: {
+    client: PublicClient;
+    chainId: JBChainId;
+    owner: Address;
+    token: Address;
+    amount: bigint;
+    now?: number;
+    expirationBufferSeconds?: number;
+}): Promise<boolean>;
+/**
+ * Prefer a gasless Permit2 signature for EOAs. Contract wallets generally need
+ * the on-chain Permit2 approval path unless their integration handles ERC-1271.
+ */
+export declare function shouldUsePermit2Signature({ needsApproval, walletLookupSettled, walletBytecode, isSafe, }: {
+    needsApproval: boolean;
+    walletLookupSettled: boolean;
+    walletBytecode?: Hex;
+    isSafe: boolean;
+}): boolean;
+/** Fall back only for wallets that cannot sign typed data, never on rejection. */
+export declare function permit2SignatureNeedsOnchainFallback(error: unknown): boolean;
+//# sourceMappingURL=permit2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.d.ts","sourceRoot":"","sources":["../../../src/v6/permit2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,mEAAmE;AACnE,eAAO,MAAM,eAAe,eAA0B,CAAC;AAEvD,gFAAgF;AAChF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Bb,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAYhB,CAAC;AAEX,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB5E;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,GACR,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,EAC3C,SAAS,EACT,MAAM,EACN,GAAmC,EACnC,uBAA+B,GAChC,EAAE;IACD,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAQV;AAED,uFAAuF;AACvF,wBAAsB,oBAAoB,CAAC,EACzC,MAAM,EACN,OAAO,EACP,KAAK,EACL,KAAK,EACL,MAAM,EACN,GAAG,EACH,uBAAuB,GACxB,EAAE;IACD,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC,OAAO,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,MAAM,GACP,EAAE;IACD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAGV;AAED,kFAAkF;AAClF,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB5E"}

package/dist/cjs/v6/permit2.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERMIT2_TYPES = exports.permit2Abi = exports.PERMIT2_ADDRESS = void 0;
+exports.permit2TypedData = permit2TypedData;
+exports.readPermit2Allowance = readPermit2Allowance;
+exports.permit2AllowanceNeedsRefresh = permit2AllowanceNeedsRefresh;
+exports.needsPermit2Approval = needsPermit2Approval;
+exports.shouldUsePermit2Signature = shouldUsePermit2Signature;
+exports.permit2SignatureNeedsOnchainFallback = permit2SignatureNeedsOnchainFallback;
+const constants_js_1 = require("../constants.js");
+const uniswapV4_js_1 = require("./uniswapV4.js");
+/** Canonical Permit2 deployment shared by supported EVM chains. */
+exports.PERMIT2_ADDRESS = uniswapV4_js_1.UNISWAP_PERMIT2_ADDRESS;
+/** Permit2 methods used to inspect or establish Universal Router allowances. */
+exports.permit2Abi = [
+    {
+        type: "function",
+        name: "allowance",
+        stateMutability: "view",
+        inputs: [
+            { name: "owner", type: "address" },
+            { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+        ],
+        outputs: [
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+            { name: "nonce", type: "uint48" },
+        ],
+    },
+    {
+        type: "function",
+        name: "approve",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+        ],
+        outputs: [],
+    },
+];
+/** EIP-712 types for Permit2's one-token, one-spender authorization. */
+exports.PERMIT2_TYPES = {
+    PermitDetails: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint160" },
+        { name: "expiration", type: "uint48" },
+        { name: "nonce", type: "uint48" },
+    ],
+    PermitSingle: [
+        { name: "details", type: "PermitDetails" },
+        { name: "spender", type: "address" },
+        { name: "sigDeadline", type: "uint256" },
+    ],
+};
+/** Build the exact typed-data payload a wallet signs for PermitSingle. */
+function permit2TypedData(authorization) {
+    return {
+        domain: {
+            name: "Permit2",
+            chainId: authorization.chainId,
+            verifyingContract: exports.PERMIT2_ADDRESS,
+        },
+        types: exports.PERMIT2_TYPES,
+        primaryType: "PermitSingle",
+        message: {
+            details: {
+                token: authorization.token,
+                amount: authorization.amount,
+                expiration: authorization.expiration,
+                nonce: authorization.nonce,
+            },
+            spender: authorization.spender,
+            sigDeadline: authorization.sigDeadline,
+        },
+    };
+}
+/** Read an owner's Permit2 allowance, defaulting the spender to Universal Router. */
+async function readPermit2Allowance(client, { chainId, owner, token, spender, }) {
+    const resolvedSpender = spender ?? (0, uniswapV4_js_1.uniswapV4Deployment)(chainId)?.universalRouter;
+    if (!resolvedSpender) {
+        throw new Error(`No supported Uniswap Universal Router on chain ${chainId}.`);
+    }
+    const [amount, expiration, nonce] = await client.readContract({
+        address: exports.PERMIT2_ADDRESS,
+        abi: exports.permit2Abi,
+        functionName: "allowance",
+        args: [owner, token, resolvedSpender],
+    });
+    return { amount, expiration, nonce };
+}
+/** Whether an allowance is too small or expires inside the safety buffer. */
+function permit2AllowanceNeedsRefresh({ allowance, amount, now = Math.floor(Date.now() / 1000), expirationBufferSeconds = 1_800, }) {
+    if (expirationBufferSeconds < 0) {
+        throw new Error("expirationBufferSeconds cannot be negative.");
+    }
+    return (allowance.amount < amount ||
+        allowance.expiration <= now + expirationBufferSeconds);
+}
+/** Read whether an ERC-20 needs a fresh Permit2 authorization for Universal Router. */
+async function needsPermit2Approval({ client, chainId, owner, token, amount, now, expirationBufferSeconds, }) {
+    if (token.toLowerCase() === constants_js_1.NATIVE_TOKEN.toLowerCase())
+        return false;
+    const allowance = await readPermit2Allowance(client, {
+        chainId,
+        owner,
+        token,
+    });
+    return permit2AllowanceNeedsRefresh({
+        allowance,
+        amount,
+        now,
+        expirationBufferSeconds,
+    });
+}
+/**
+ * Prefer a gasless Permit2 signature for EOAs. Contract wallets generally need
+ * the on-chain Permit2 approval path unless their integration handles ERC-1271.
+ */
+function shouldUsePermit2Signature({ needsApproval, walletLookupSettled, walletBytecode, isSafe, }) {
+    const isContract = !!walletBytecode && walletBytecode !== "0x";
+    return needsApproval && walletLookupSettled && !isContract && !isSafe;
+}
+/** Fall back only for wallets that cannot sign typed data, never on rejection. */
+function permit2SignatureNeedsOnchainFallback(error) {
+    const messages = [];
+    let current = error;
+    for (let depth = 0; current && depth < 5; depth += 1) {
+        if (typeof current !== "object")
+            break;
+        const value = current;
+        for (const key of ["code", "shortMessage", "message", "details"]) {
+            if (value[key] !== undefined)
+                messages.push(String(value[key]));
+        }
+        current = value.cause;
+    }
+    const text = messages.join(" ").toLowerCase();
+    if (/user rejected|rejected the request|denied|4001/.test(text))
+        return false;
+    return /(^|\s)-32602(\s|$)|(^|\s)-32601(\s|$)|(^|\s)4200(\s|$)|invalid parameters|method .*not supported|unsupported method|typed data.*not supported/.test(text);
+}
+//# sourceMappingURL=permit2.js.map

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

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

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

@@ -0,0 +1,69 @@
+import type { Address, Hex, PublicClient } from "viem";
+import type { JBChainId } from "../types.js";
+import { type PayPreview, type PaySettlement } from "./pay.js";
+import type { Permit2SignatureAuthorization } from "./permit2.js";
+import { type UniswapV4PoolKey } from "./uniswapV4.js";
+export interface NativeSwapConfig {
+    wrappedNative: Address;
+    bridgeToken: Address;
+    v3Quoter: Address;
+}
+/** Canonical WETH/USDC V3 bridge used by direct-pay swaps on all v6 mainnets. */
+export declare const NATIVE_SWAP_BY_CHAIN: Readonly<Partial<Record<JBChainId, NativeSwapConfig>>>;
+export type DirectPayInputRoute = {
+    kind: "single-v4";
+} | {
+    kind: "native-v3-v4";
+    wrappedNative: Address;
+    bridgeToken: Address;
+    bridgeTokenSymbol: "USDC";
+    bridgeTokenDecimals: 6;
+    v3Fee: number;
+    quotedBridgeAmount: bigint;
+} | {
+    kind: "erc20-v3-native-v4";
+    inputToken: Address;
+    wrappedNative: Address;
+    bridgeTokenSymbol: "ETH";
+    bridgeTokenDecimals: 18;
+    v3Fee: number;
+    quotedBridgeAmount: bigint;
+};
+export interface DirectPaySwapQuote {
+    kind: "direct-swap";
+    poolKey: UniswapV4PoolKey;
+    zeroForOne: boolean;
+    quotedTokenCount: bigint;
+    /** Protected minimum and the beneficiary's direct-swap token count. */
+    minimumTokenCount: bigint;
+    beneficiaryTokenCount: bigint;
+    reservedTokenCount: 0n;
+    inputRoute: DirectPayInputRoute;
+}
+/**
+ * Quote the best direct pool purchase, including the atomic ETH/USDC V3 bridge
+ * when the user's payment currency differs from the hooked V4 pool currency.
+ * Returns null unless its slippage-protected minimum beats terminal payment.
+ */
+export declare function quoteDirectPaySwap({ client, chainId, poolKey, pairIsCurrency0, paymentToken, amount, payPreview, paySettlement, slippageBps, }: {
+    client: PublicClient;
+    chainId: JBChainId;
+    poolKey: UniswapV4PoolKey;
+    pairIsCurrency0: boolean;
+    paymentToken: Address;
+    amount: bigint;
+    payPreview: PayPreview;
+    paySettlement?: PaySettlement;
+    slippageBps?: bigint;
+}): Promise<DirectPaySwapQuote | null>;
+/** Build the atomic Universal Router transaction for a direct-pay quote. */
+export declare function buildDirectPaySwapTx({ chainId, quote, amount, recipient, deadline, }: {
+    chainId: JBChainId;
+    quote: DirectPaySwapQuote;
+    amount: bigint;
+    recipient: Address;
+    deadline: bigint;
+}): import("./uniswapV4.js").UniswapV4SwapTxRequest;
+/** Prepend Universal Router's PERMIT2_PERMIT command to a reviewed swap. */
+export declare function addPermit2SignatureToDirectPaySwap(request: ReturnType<typeof buildDirectPaySwapTx>, authorization: Permit2SignatureAuthorization, signature: Hex): ReturnType<typeof buildDirectPaySwapTx>;
+//# sourceMappingURL=directPay.d.ts.map

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

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