@vultisig/core-chain 2.17.11 → 2.19.0

package/dist/chains/ton/staking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staking.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/staking.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,2BAA4B,CAAA;AAEpE,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAA;AAErF,eAAO,MAAM,4BAA4B,GACvC,gBAAgB,MAAM,GAAG,SAAS,KACjC,cAAc,IAAI,0BAC4E,CAAA;AAqBjG,mGAAmG;AACnG,eAAO,MAAM,wBAAwB,GAAI,gBAAgB,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SACe,CAAA;AAEtG,oGAAoG;AACpG,eAAO,MAAM,yBAAyB,GAAI,gBAAgB,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SACe,CAAA;AAOvG;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,OAAwD,CAAA;AAEvH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,cAAiB,CAAA;AAErD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,aAAe,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAc,CAAA;AAc/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAiBD,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,GAAI,MAAM,cAAc,KAAG,OAMzD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,cAAc,KAAG,OACsC,CAAA;AAEhG;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,cAAc,EAAE,CAKnE,CAAA;AAWD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAavG,CAAA;AAUD;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,oBAAoB,EAAE,CAW5F,CAAA"}

package/dist/chains/ton/staking.js

@@ -0,0 +1,137 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { tonAddressToBounceable } from './address.js';
+/**
+ * Public TonAPI host. The staking endpoints (`/v2/staking/*`) are served
+ * exclusively by `tonapi.io` — the Vultisig `/ton` proxy fronts toncenter v3,
+ * which has no staking routes — so we hit tonapi.io directly. The extension's
+ * wildcard https host permission covers it.
+ */
+const tonApiPublicUrl = 'https://tonapi.io';
+/**
+ * tonapi `implementation` values that are genuine **nominator pools** — the
+ * only ones the text-comment deposit/withdraw mechanism can stake into.
+ * `liquidTF` (Tonstakers) mints a jetton instead and is excluded; unknown
+ * implementations are treated as non-nominator (excluded).
+ */
+export const tonNominatorImplementations = ['whales', 'tf'];
+export const isTonNominatorImplementation = (implementation) => !!implementation && tonNominatorImplementations.includes(implementation);
+/**
+ * The deposit/withdraw text comments a TON nominator-pool contract expects.
+ * Each pool *implementation* uses a DIFFERENT word — sending the wrong one is
+ * rejected on-chain (exit code 72). These are contract protocol tokens, NOT
+ * user-facing UI: never translate them.
+ *
+ * The Whales pool repo README's "Stake" is stale and rejected by the live
+ * pools; the verified on-chain word is "Deposit".
+ */
+const tonStakingDepositComments = {
+    tf: 'd',
+    whales: 'Deposit',
+};
+const tonStakingWithdrawComments = {
+    tf: 'w',
+    whales: 'Withdraw',
+};
+/** Deposit comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export const tonStakingDepositComment = (implementation) => isTonNominatorImplementation(implementation) ? tonStakingDepositComments[implementation] : undefined;
+/** Withdraw comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export const tonStakingWithdrawComment = (implementation) => isTonNominatorImplementation(implementation) ? tonStakingWithdrawComments[implementation] : undefined;
+const tonStakingComments = new Set([
+    ...Object.values(tonStakingDepositComments),
+    ...Object.values(tonStakingWithdrawComments),
+]);
+/**
+ * Whether a memo is a nominator-pool deposit/withdraw comment (`d`/`w`/`Deposit`
+ * /`Withdraw`). The signer uses this to force the transfer bounceable: a pool
+ * deposit/withdraw sent non-bounceable can be absorbed (lost) by the pool
+ * instead of bounced back if rejected.
+ */
+export const isTonStakingComment = (memo) => !!memo && tonStakingComments.has(memo.trim());
+/**
+ * Processing-commission buffer (nanotons) added on top of a pool's `min_stake`
+ * for the minimum acceptable deposit. Depositing exactly the minimum is
+ * rejected; the pool needs ~1 TON headroom for its processing commission.
+ */
+export const tonStakingDepositBuffer = 1000000000n;
+/**
+ * Amount (nanotons) accompanying a withdraw message — the pool's 0.2 TON
+ * withdraw fee. The pool returns the full staked balance separately; sending
+ * more (e.g. 1 TON) fails.
+ */
+export const tonStakingWithdrawFee = 200000000n;
+/**
+ * Conservative network-fee reserve (nanotons ≈ 0.05 TON) held back from the
+ * spendable balance when sizing a stake deposit or checking the unstake fee is
+ * affordable. Larger than the bare base fee because the text-comment cell adds
+ * compute; matches the iOS reserve.
+ */
+export const tonStakingFeeReserve = 50000000n;
+const mapPoolEntry = (entry) => ({
+    // Normalize to the bounceable `EQ…` form at the boundary so no caller can
+    // build a staking transfer to a raw/non-bounceable destination (which the
+    // pool would absorb instead of bouncing back on rejection).
+    address: tonAddressToBounceable(entry.address),
+    name: entry.name,
+    apy: entry.apy,
+    minStake: BigInt(Math.trunc(entry.min_stake)),
+    verified: entry.verified,
+    currentNominators: entry.current_nominators,
+    maxNominators: entry.max_nominators,
+    implementation: entry.implementation,
+    cycleEnd: entry.cycle_end,
+});
+/** Whether a pool has room for another nominator (pools at capacity reject new stakes). */
+export const tonPoolHasCapacity = (pool) => {
+    const { currentNominators, maxNominators } = pool;
+    if (currentNominators === undefined || maxNominators === undefined || maxNominators <= 0) {
+        return true;
+    }
+    return currentNominators < maxNominators;
+};
+/**
+ * Whether a pool is a verified nominator pool with capacity — i.e. one the
+ * picker should surface and a stake can succeed into.
+ */
+export const isStakeableTonPool = (pool) => pool.verified && isTonNominatorImplementation(pool.implementation) && tonPoolHasCapacity(pool);
+/**
+ * Fetches all verified TON staking pools from tonapi (`/v2/staking/pools`).
+ * Includes every implementation; callers filter to stakeable nominator pools
+ * via `isStakeableTonPool`.
+ */
+export const getTonStakingPools = async () => {
+    const url = `${tonApiPublicUrl}/v2/staking/pools?include_unverified=false`;
+    const { pools } = await queryUrl(url);
+    return pools.map(mapPoolEntry);
+};
+/** Fetches computed pool metadata (name, APY, implementation, cycle end). */
+export const getTonStakingPoolInfo = async (poolAddress) => {
+    const url = `${tonApiPublicUrl}/v2/staking/pool/${encodeURIComponent(poolAddress)}`;
+    const { pool } = await queryUrl(url);
+    if (!pool)
+        return undefined;
+    return {
+        address: pool.address ? tonAddressToBounceable(pool.address) : undefined,
+        name: pool.name,
+        apy: pool.apy,
+        minStake: pool.min_stake !== undefined ? BigInt(Math.trunc(pool.min_stake)) : undefined,
+        implementation: pool.implementation,
+        cycleEnd: pool.cycle_end,
+    };
+};
+/**
+ * Fetches an account's nominator-pool positions
+ * (`/v2/staking/nominator/{accountId}/pools`) — the authoritative source for
+ * staked positions. `accountId` accepts the user-friendly wallet address.
+ */
+export const getTonNominatorPools = async (accountId) => {
+    const url = `${tonApiPublicUrl}/v2/staking/nominator/${encodeURIComponent(accountId)}/pools`;
+    const { pools } = await queryUrl(url);
+    return pools.map(position => ({
+        pool: tonAddressToBounceable(position.pool),
+        amount: BigInt(Math.trunc(position.amount)),
+        pendingDeposit: BigInt(Math.trunc(position.pending_deposit)),
+        pendingWithdraw: BigInt(Math.trunc(position.pending_withdraw)),
+        readyWithdraw: BigInt(Math.trunc(position.ready_withdraw)),
+    }));
+};
+//# sourceMappingURL=staking.js.map

package/dist/chains/ton/staking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staking.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/staking.ts"],"names":[],"mappings":"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"}

package/dist/coin/balance/getEvmChainBalances.d.ts

@@ -0,0 +1,11 @@
+import { EvmChain } from '@vultisig/core-chain/Chain';
+import { AccountCoinKey } from '@vultisig/core-chain/coin/AccountCoin';
+import { Address } from 'viem';
+export type GetEvmChainBalancesInput = {
+    chain: EvmChain;
+    address: Address;
+    coins: AccountCoinKey<EvmChain>[];
+};
+export type EvmChainBalances = Record<string, bigint>;
+export declare const getEvmChainBalances: (input: GetEvmChainBalancesInput) => Promise<EvmChainBalances>;
+//# sourceMappingURL=getEvmChainBalances.d.ts.map

package/dist/coin/balance/getEvmChainBalances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEvmChainBalances.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/coin/balance/getEvmChainBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAErD,OAAO,EAAE,cAAc,EAA0B,MAAM,uCAAuC,CAAA;AAE9F,OAAO,EAAE,OAAO,EAAsB,MAAM,MAAM,CAAA;AAMlD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAkBrD,eAAO,MAAM,mBAAmB,GAAU,OAAO,wBAAwB,KAAG,OAAO,CAAC,gBAAgB,CAiDnG,CAAA"}

package/dist/coin/balance/getEvmChainBalances.js

@@ -0,0 +1,57 @@
+import { getEvmClient } from '@vultisig/core-chain/chains/evm/client';
+import { accountCoinKeyToString } from '@vultisig/core-chain/coin/AccountCoin';
+import { isFeeCoin } from '@vultisig/core-chain/coin/utils/isFeeCoin';
+import { erc20Abi, parseAbi } from 'viem';
+import { getEvmCoinBalance } from './resolvers/evm.js';
+const multicall3Abi = parseAbi(['function getEthBalance(address addr) view returns (uint256)']);
+const getFallbackBalances = async ({ chain, address, coins }) => {
+    const entries = await Promise.all(coins.map(async (coin) => {
+        const input = { ...coin, chain, address };
+        try {
+            return [accountCoinKeyToString(input), await getEvmCoinBalance(input)];
+        }
+        catch {
+            return [accountCoinKeyToString(input), 0n];
+        }
+    }));
+    return Object.fromEntries(entries);
+};
+export const getEvmChainBalances = async (input) => {
+    const { chain, address, coins } = input;
+    if (coins.length === 0) {
+        return {};
+    }
+    const publicClient = getEvmClient(chain);
+    const multicall3Address = publicClient.chain?.contracts?.multicall3?.address;
+    if (!multicall3Address) {
+        return getFallbackBalances(input);
+    }
+    const contracts = coins.map(coin => isFeeCoin(coin)
+        ? {
+            address: multicall3Address,
+            abi: multicall3Abi,
+            functionName: 'getEthBalance',
+            args: [address],
+        }
+        : {
+            address: coin.id,
+            abi: erc20Abi,
+            functionName: 'balanceOf',
+            args: [address],
+        });
+    const results = await publicClient
+        .multicall({
+        allowFailure: true,
+        contracts,
+    })
+        .catch(() => undefined);
+    if (!results) {
+        return getFallbackBalances(input);
+    }
+    return Object.fromEntries(coins.map((coin, index) => {
+        const result = results[index];
+        const amount = result?.status === 'success' ? BigInt(result.result) : 0n;
+        return [accountCoinKeyToString({ ...coin, chain, address }), amount];
+    }));
+};
+//# sourceMappingURL=getEvmChainBalances.js.map

package/dist/coin/balance/getEvmChainBalances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEvmChainBalances.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/coin/balance/getEvmChainBalances.ts"],"names":[],"mappings":"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"}

package/dist/swap/general/GeneralSwapProvider.d.ts

@@ -1,4 +1,4 @@
-export declare const generalSwapProviders: readonly ["1inch", "li.fi", "kyber", "swapkit", "cowswap"];
+export declare const generalSwapProviders: readonly ["1inch", "li.fi", "kyber", "swapkit", "cowswap", "jupiter"];
 export type GeneralSwapProvider = (typeof generalSwapProviders)[number];
 export declare const generalSwapProviderName: Record<GeneralSwapProvider, string>;
 //# sourceMappingURL=GeneralSwapProvider.d.ts.map

package/dist/swap/general/GeneralSwapProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneralSwapProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,4DAA6D,CAAA;AAE9F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMvE,CAAA"}
+{"version":3,"file":"GeneralSwapProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,uEAAwE,CAAA;AAEzG,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAOvE,CAAA"}

package/dist/swap/general/GeneralSwapProvider.js

@@ -1,9 +1,10 @@
-export const generalSwapProviders = ['1inch', 'li.fi', 'kyber', 'swapkit', 'cowswap'];
+export const generalSwapProviders = ['1inch', 'li.fi', 'kyber', 'swapkit', 'cowswap', 'jupiter'];
 export const generalSwapProviderName = {
     '1inch': '1Inch',
     'li.fi': 'LI.FI',
     kyber: 'KyberSwap',
     swapkit: 'SwapKit',
     cowswap: 'CowSwap',
+    jupiter: 'Jupiter',
 };
 //# sourceMappingURL=GeneralSwapProvider.js.map

package/dist/swap/general/GeneralSwapProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneralSwapProvider.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAI9F,MAAM,CAAC,MAAM,uBAAuB,GAAwC;IAC1E,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA"}
+{"version":3,"file":"GeneralSwapProvider.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAIzG,MAAM,CAAC,MAAM,uBAAuB,GAAwC;IAC1E,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA"}

package/dist/swap/general/jupiter/JupiterSwapEnabledChains.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Jupiter is a Solana-only, same-chain aggregator. It can route SOL↔SPL and
+ * SPL↔SPL pairs that stay on Solana, and nothing else — there is no cross-chain
+ * Jupiter route. `findSwapQuote` therefore only offers Jupiter when both legs
+ * are on Solana.
+ */
+export declare const jupiterSwapEnabledChains: readonly [import("@vultisig/core-chain/Chain").OtherChain.Solana];
+export type JupiterSwapEnabledChain = (typeof jupiterSwapEnabledChains)[number];
+//# sourceMappingURL=JupiterSwapEnabledChains.d.ts.map

package/dist/swap/general/jupiter/JupiterSwapEnabledChains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JupiterSwapEnabledChains.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/jupiter/JupiterSwapEnabledChains.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,mEAA0B,CAAA;AAE/D,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/swap/general/jupiter/JupiterSwapEnabledChains.js

@@ -0,0 +1,9 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+/**
+ * Jupiter is a Solana-only, same-chain aggregator. It can route SOL↔SPL and
+ * SPL↔SPL pairs that stay on Solana, and nothing else — there is no cross-chain
+ * Jupiter route. `findSwapQuote` therefore only offers Jupiter when both legs
+ * are on Solana.
+ */
+export const jupiterSwapEnabledChains = [Chain.Solana];
+//# sourceMappingURL=JupiterSwapEnabledChains.js.map

package/dist/swap/general/jupiter/JupiterSwapEnabledChains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JupiterSwapEnabledChains.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/jupiter/JupiterSwapEnabledChains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAU,CAAA"}

package/dist/swap/general/jupiter/api/getJupiterSwapQuote.d.ts

@@ -0,0 +1,25 @@
+import { AccountCoin } from '@vultisig/core-chain/coin/AccountCoin';
+import { GeneralSwapQuote } from '@vultisig/core-chain/swap/general/GeneralSwapQuote';
+import { JupiterSwapEnabledChain } from '@vultisig/core-chain/swap/general/jupiter/JupiterSwapEnabledChains';
+import { TransferDirection } from '@vultisig/lib-utils/TransferDirection';
+type Input = Record<TransferDirection, AccountCoin<JupiterSwapEnabledChain>> & {
+    amount: bigint;
+    /** VULT-scaled affiliate fee in bps. `0` disables the platform fee entirely. */
+    affiliateBps?: number;
+    /** Slippage tolerance in bps (e.g. 50 = 0.5%). Defaults to 50. */
+    slippageBps?: number;
+};
+/**
+ * Fetch a Solana same-chain swap quote from Jupiter and build the signed-tx
+ * payload the keysign pipeline expects.
+ *
+ * Affiliate fee: when `affiliateBps > 0`, `platformFeeBps` is sent on the quote.
+ * The fee ATA (output mint, owner = `jupiterFeeOwnerAddress`) is derived, passed
+ * to `/swap` as `feeAccount`, and an idempotent create instruction is prepended
+ * to the returned transaction only when the quote actually returns a non-zero
+ * `platformFee.amount`. When `affiliateBps` is 0 (e.g. an Ultimate-tier VULT
+ * holder) or Jupiter floors the fee to zero, no fee account is touched.
+ */
+export declare const getJupiterSwapQuote: ({ from, to, amount, affiliateBps, slippageBps, }: Input) => Promise<GeneralSwapQuote>;
+export {};
+//# sourceMappingURL=getJupiterSwapQuote.d.ts.map

package/dist/swap/general/jupiter/api/getJupiterSwapQuote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJupiterSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/jupiter/api/getJupiterSwapQuote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAA;AAErF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oEAAoE,CAAA;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAUzE,KAAK,KAAK,GAAG,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,uBAAuB,CAAC,CAAC,GAAG;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AA2CD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAU,kDAMvC,KAAK,KAAG,OAAO,CAAC,gBAAgB,CAuFlC,CAAA"}

package/dist/swap/general/jupiter/api/getJupiterSwapQuote.js

@@ -0,0 +1,112 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+import { solanaConfig } from '@vultisig/core-chain/chains/solana/solanaConfig';
+import { getJupiterConfig, jupiterFeeOwnerAddress } from '@vultisig/core-chain/swap/general/jupiter/config';
+import { deriveJupiterFeeAccount, prependJupiterFeeAta } from './jupiterFeeAta.js';
+/** Canonical wrapped-SOL mint, used as the mint address for native SOL legs. */
+const solanaNativeMint = 'So11111111111111111111111111111111111111112';
+/** Jupiter default slippage when the caller does not override (bps). */
+const DEFAULT_JUPITER_SLIPPAGE_BPS = 50;
+const mintFor = ({ id }) => id ?? solanaNativeMint;
+const requestJson = async (url, init) => {
+    const response = await fetch(url, init);
+    const rawText = await response.text().catch(() => '');
+    if (!response.ok) {
+        const hint = rawText ? ` ${rawText.slice(0, 200)}` : '';
+        throw new Error(`Jupiter request failed (${response.status}): ${response.statusText}${hint}`);
+    }
+    try {
+        return JSON.parse(rawText);
+    }
+    catch {
+        throw new Error('Jupiter returned a non-JSON response.');
+    }
+};
+/**
+ * Fetch a Solana same-chain swap quote from Jupiter and build the signed-tx
+ * payload the keysign pipeline expects.
+ *
+ * Affiliate fee: when `affiliateBps > 0`, `platformFeeBps` is sent on the quote.
+ * The fee ATA (output mint, owner = `jupiterFeeOwnerAddress`) is derived, passed
+ * to `/swap` as `feeAccount`, and an idempotent create instruction is prepended
+ * to the returned transaction only when the quote actually returns a non-zero
+ * `platformFee.amount`. When `affiliateBps` is 0 (e.g. an Ultimate-tier VULT
+ * holder) or Jupiter floors the fee to zero, no fee account is touched.
+ */
+export const getJupiterSwapQuote = async ({ from, to, amount, affiliateBps = 0, slippageBps = DEFAULT_JUPITER_SLIPPAGE_BPS, }) => {
+    const { baseUrl } = getJupiterConfig();
+    const inputMint = mintFor(from);
+    const outputMint = mintFor(to);
+    const requestsPlatformFee = affiliateBps > 0;
+    const quoteParams = new URLSearchParams({
+        swapMode: 'ExactIn',
+        inputMint,
+        outputMint,
+        amount: amount.toString(),
+        slippageBps: slippageBps.toString(),
+    });
+    if (requestsPlatformFee) {
+        quoteParams.set('platformFeeBps', affiliateBps.toString());
+    }
+    const quoteResponse = await requestJson(`${baseUrl}/swap/v1/quote?${quoteParams.toString()}`, {
+        headers: { Accept: 'application/json' },
+    });
+    // Gate the fee-account flow on the actually quoted fee, not just the requested
+    // bps: Jupiter can floor `platformFee.amount` to 0 (tiny amounts, route with no
+    // fee-eligible mint) even when we asked for a fee. Deriving a fee account and
+    // paying ATA rent for a zero fee would break the "no fee account when the fee
+    // floors to zero" contract. Require both a requested fee and a non-zero quoted
+    // amount before touching the fee account.
+    const swapFeeAmount = BigInt(quoteResponse.platformFee?.amount ?? '0');
+    const chargesFee = requestsPlatformFee && swapFeeAmount > 0n;
+    // The fee mint is the OUTPUT mint (ExactIn). Derive the fee ATA up front so
+    // it can be sent to /swap and so we know which program owns it for the
+    // prepended create instruction.
+    const feeAccountInfo = chargesFee
+        ? await deriveJupiterFeeAccount({ outputMint, feeOwner: jupiterFeeOwnerAddress })
+        : undefined;
+    const swapResponse = await requestJson(`${baseUrl}/swap/v1/swap`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({
+            quoteResponse,
+            userPublicKey: from.address,
+            wrapAndUnwrapSol: true,
+            dynamicComputeUnitLimit: true,
+            ...(feeAccountInfo ? { feeAccount: feeAccountInfo.feeAccount } : {}),
+        }),
+    });
+    if (!swapResponse.swapTransaction) {
+        throw new Error('Jupiter swap response did not include a serialized transaction.');
+    }
+    const data = feeAccountInfo
+        ? await prependJupiterFeeAta({
+            txData: swapResponse.swapTransaction,
+            feeAccount: feeAccountInfo.feeAccount,
+            mintPubkey: feeAccountInfo.mintPubkey,
+            ownerPubkey: feeAccountInfo.ownerPubkey,
+            tokenProgramId: feeAccountInfo.tokenProgramId,
+        })
+        : swapResponse.swapTransaction;
+    // Network fee is an upper-bound estimate: Solana's per-signature base fee plus
+    // the fee-ATA rent buffer when we prepend a create instruction (charged once
+    // per fee mint; idempotent thereafter). Jupiter embeds its own priority fee in
+    // the returned tx, which the consumer surfaces at broadcast time.
+    const networkFee = BigInt(solanaConfig.baseFee) + (chargesFee ? BigInt(solanaConfig.ataRentLamports) : 0n);
+    return {
+        dstAmount: quoteResponse.outAmount,
+        provider: 'jupiter',
+        tx: {
+            solana: {
+                data,
+                networkFee,
+                swapFee: {
+                    amount: swapFeeAmount,
+                    decimals: to.decimals,
+                    chain: Chain.Solana,
+                    id: to.id,
+                },
+            },
+        },
+    };
+};
+//# sourceMappingURL=getJupiterSwapQuote.js.map

package/dist/swap/general/jupiter/api/getJupiterSwapQuote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJupiterSwapQuote.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/jupiter/api/getJupiterSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAA;AAG9E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAA;AAI3G,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE/E,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,6CAA6C,CAAA;AAEtE,wEAAwE;AACxE,MAAM,4BAA4B,GAAG,EAAE,CAAA;AAiCvC,MAAM,OAAO,GAAG,CAAC,EAAE,EAAE,EAAe,EAAU,EAAE,CAAC,EAAE,IAAI,gBAAgB,CAAA;AAEvE,MAAM,WAAW,GAAG,KAAK,EAAK,GAAW,EAAE,IAAkB,EAAc,EAAE;IAC3E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IAErD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACvD,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC,CAAA;IAC/F,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAC1D,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,EACxC,IAAI,EACJ,EAAE,EACF,MAAM,EACN,YAAY,GAAG,CAAC,EAChB,WAAW,GAAG,4BAA4B,GACpC,EAA6B,EAAE;IACrC,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC,CAAA;IAE9B,MAAM,mBAAmB,GAAG,YAAY,GAAG,CAAC,CAAA;IAE5C,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACtC,QAAQ,EAAE,SAAS;QACnB,SAAS;QACT,UAAU;QACV,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;QACzB,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;KACpC,CAAC,CAAA;IACF,IAAI,mBAAmB,EAAE,CAAC;QACxB,WAAW,CAAC,GAAG,CAAC,gBAAgB,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAuB,GAAG,OAAO,kBAAkB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE;QAClH,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;KACxC,CAAC,CAAA;IAEF,+EAA+E;IAC/E,gFAAgF;IAChF,8EAA8E;IAC9E,8EAA8E;IAC9E,+EAA+E;IAC/E,0CAA0C;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,IAAI,GAAG,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,mBAAmB,IAAI,aAAa,GAAG,EAAE,CAAA;IAE5D,4EAA4E;IAC5E,uEAAuE;IACvE,gCAAgC;IAChC,MAAM,cAAc,GAAG,UAAU;QAC/B,CAAC,CAAC,MAAM,uBAAuB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACjF,CAAC,CAAC,SAAS,CAAA;IAEb,MAAM,YAAY,GAAG,MAAM,WAAW,CAAsB,GAAG,OAAO,eAAe,EAAE;QACrF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,aAAa;YACb,aAAa,EAAE,IAAI,CAAC,OAAO;YAC3B,gBAAgB,EAAE,IAAI;YACtB,uBAAuB,EAAE,IAAI;YAC7B,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC;KACH,CAAC,CAAA;IAEF,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACpF,CAAC;IAED,MAAM,IAAI,GAAG,cAAc;QACzB,CAAC,CAAC,MAAM,oBAAoB,CAAC;YACzB,MAAM,EAAE,YAAY,CAAC,eAAe;YACpC,UAAU,EAAE,cAAc,CAAC,UAAU;YACrC,UAAU,EAAE,cAAc,CAAC,UAAU;YACrC,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,cAAc,EAAE,cAAc,CAAC,cAAc;SAC9C,CAAC;QACJ,CAAC,CAAC,YAAY,CAAC,eAAe,CAAA;IAEhC,+EAA+E;IAC/E,6EAA6E;IAC7E,+EAA+E;IAC/E,kEAAkE;IAClE,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAE1G,OAAO;QACL,SAAS,EAAE,aAAa,CAAC,SAAS;QAClC,QAAQ,EAAE,SAAS;QACnB,EAAE,EAAE;YACF,MAAM,EAAE;gBACN,IAAI;gBACJ,UAAU;gBACV,OAAO,EAAE;oBACP,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,EAAE,EAAE,EAAE,CAAC,EAAE;iBACV;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/swap/general/jupiter/api/jupiterFeeAta.d.ts

@@ -0,0 +1,48 @@
+import { PublicKey } from '@solana/web3.js';
+export type JupiterFeeAccount = {
+    /** Base58 ATA address Jupiter must credit the platform fee to. */
+    feeAccount: string;
+    /** Token program (Token vs Token-2022) that owns the fee-mint. */
+    tokenProgramId: PublicKey;
+    mintPubkey: PublicKey;
+    ownerPubkey: PublicKey;
+};
+/**
+ * Derive the Jupiter platform-fee Associated Token Account for `(owner =
+ * feeOwner, mint = outputMint)`. Jupiter charges the affiliate fee in the
+ * OUTPUT mint (the only mint allowed for an ExactIn swap besides the input),
+ * so the fee mint is always the swap's output mint.
+ *
+ * The token program is resolved from the mint owner so Token-2022 mints derive
+ * the correct ATA. This must be called BEFORE the `/swap` request so the
+ * derived `feeAccount` can be passed to Jupiter.
+ */
+export declare const deriveJupiterFeeAccount: ({ outputMint, feeOwner, }: {
+    outputMint: string;
+    feeOwner: string;
+}) => Promise<JupiterFeeAccount>;
+/**
+ * Prepend an idempotent `createAssociatedTokenAccount` instruction for the
+ * Jupiter fee ATA to the serialized swap transaction.
+ *
+ * Jupiter's `/swap` endpoint auto-creates the *user's* output ATA but treats
+ * the `feeAccount` as a precondition it never initializes — so we must prepend
+ * our own create instruction. The idempotent variant is a no-op (no rent
+ * charged) when the ATA already exists, making this safe to run on every swap
+ * without an existence probe.
+ *
+ * Rent (~0.002 SOL, the first time per fee mint) is paid by the tx fee-payer
+ * (the user), matching the existing LiFi Solana ATA-injection behaviour.
+ *
+ * `recentBlockhash` is preserved verbatim from Jupiter's quote. The consumer's
+ * keysign path refreshes the blockhash before broadcast (same as every other
+ * Solana general-swap route), so we do not refresh it here.
+ */
+export declare const prependJupiterFeeAta: ({ txData, feeAccount, mintPubkey, ownerPubkey, tokenProgramId, }: {
+    txData: string;
+    feeAccount: string;
+    mintPubkey: PublicKey;
+    ownerPubkey: PublicKey;
+    tokenProgramId: PublicKey;
+}) => Promise<string>;
+//# sourceMappingURL=jupiterFeeAta.d.ts.map

package/dist/swap/general/jupiter/api/jupiterFeeAta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jupiterFeeAta.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/jupiter/api/jupiterFeeAta.ts"],"names":[],"mappings":"AAMA,OAAO,EAA6B,SAAS,EAA4C,MAAM,iBAAiB,CAAA;AAsDhH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,cAAc,EAAE,SAAS,CAAA;IACzB,UAAU,EAAE,SAAS,CAAA;IACrB,WAAW,EAAE,SAAS,CAAA;CACvB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAU,2BAG3C;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC,iBAAiB,CAa5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAU,kEAMxC;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,SAAS,CAAA;IACrB,WAAW,EAAE,SAAS,CAAA;IACtB,cAAc,EAAE,SAAS,CAAA;CAC1B,KAAG,OAAO,CAAC,MAAM,CAgDjB,CAAA"}

package/dist/swap/general/jupiter/api/jupiterFeeAta.js

@@ -0,0 +1,115 @@
+import { createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddressSync, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, } from '@solana/spl-token';
+import { PublicKey, TransactionMessage, VersionedTransaction } from '@solana/web3.js';
+import { getSolanaClient } from '@vultisig/core-chain/chains/solana/client';
+/** Maximum attempts for LUT fetches before giving up. */
+const MAX_LUT_FETCH_ATTEMPTS = 3;
+/**
+ * Fetch a LUT account with simple retry (exponential back-off, up to 3 attempts).
+ * RPC timeouts are transient; retrying avoids spurious quote failures.
+ */
+const fetchLutWithRetry = async (client, accountKey) => {
+    const errors = [];
+    for (let attempt = 0; attempt < MAX_LUT_FETCH_ATTEMPTS; attempt++) {
+        try {
+            const result = await client.getAddressLookupTable(accountKey);
+            return result.value ?? null;
+        }
+        catch (err) {
+            errors.push(err);
+            if (attempt < MAX_LUT_FETCH_ATTEMPTS - 1) {
+                await new Promise(resolve => setTimeout(resolve, 200 * 2 ** attempt));
+            }
+        }
+    }
+    console.warn('[jupiterFeeAta] LUT fetch failed after retries:', errors);
+    return null;
+};
+/**
+ * Resolve the SPL token program (Token vs Token-2022) that owns a mint.
+ *
+ * Failing to resolve the mint (RPC timeout, bad address, closed account) must
+ * throw rather than fall back to TOKEN_PROGRAM_ID — a silent fallback would
+ * derive the wrong ATA and produce an opaque simulation failure downstream.
+ */
+const resolveTokenProgramId = async (mintPubkey) => {
+    const client = getSolanaClient();
+    const mintInfo = await client.getAccountInfo(mintPubkey);
+    if (!mintInfo) {
+        throw new Error(`Mint account ${mintPubkey.toBase58()} not found - cannot determine Token vs Token-2022 program`);
+    }
+    if (mintInfo.owner.equals(TOKEN_PROGRAM_ID)) {
+        return TOKEN_PROGRAM_ID;
+    }
+    if (mintInfo.owner.equals(TOKEN_2022_PROGRAM_ID)) {
+        return TOKEN_2022_PROGRAM_ID;
+    }
+    throw new Error(`Mint ${mintPubkey.toBase58()} is owned by unsupported program ${mintInfo.owner.toBase58()} - expected Token or Token-2022`);
+};
+/**
+ * Derive the Jupiter platform-fee Associated Token Account for `(owner =
+ * feeOwner, mint = outputMint)`. Jupiter charges the affiliate fee in the
+ * OUTPUT mint (the only mint allowed for an ExactIn swap besides the input),
+ * so the fee mint is always the swap's output mint.
+ *
+ * The token program is resolved from the mint owner so Token-2022 mints derive
+ * the correct ATA. This must be called BEFORE the `/swap` request so the
+ * derived `feeAccount` can be passed to Jupiter.
+ */
+export const deriveJupiterFeeAccount = async ({ outputMint, feeOwner, }) => {
+    const mintPubkey = new PublicKey(outputMint);
+    const ownerPubkey = new PublicKey(feeOwner);
+    const tokenProgramId = await resolveTokenProgramId(mintPubkey);
+    const feeAccount = getAssociatedTokenAddressSync(mintPubkey, ownerPubkey, 
+    /* allowOwnerOffCurve */ false, tokenProgramId).toBase58();
+    return { feeAccount, tokenProgramId, mintPubkey, ownerPubkey };
+};
+/**
+ * Prepend an idempotent `createAssociatedTokenAccount` instruction for the
+ * Jupiter fee ATA to the serialized swap transaction.
+ *
+ * Jupiter's `/swap` endpoint auto-creates the *user's* output ATA but treats
+ * the `feeAccount` as a precondition it never initializes — so we must prepend
+ * our own create instruction. The idempotent variant is a no-op (no rent
+ * charged) when the ATA already exists, making this safe to run on every swap
+ * without an existence probe.
+ *
+ * Rent (~0.002 SOL, the first time per fee mint) is paid by the tx fee-payer
+ * (the user), matching the existing LiFi Solana ATA-injection behaviour.
+ *
+ * `recentBlockhash` is preserved verbatim from Jupiter's quote. The consumer's
+ * keysign path refreshes the blockhash before broadcast (same as every other
+ * Solana general-swap route), so we do not refresh it here.
+ */
+export const prependJupiterFeeAta = async ({ txData, feeAccount, mintPubkey, ownerPubkey, tokenProgramId, }) => {
+    const client = getSolanaClient();
+    const versionedTx = VersionedTransaction.deserialize(Buffer.from(txData, 'base64'));
+    const lutAccounts = [];
+    if (versionedTx.message.version === 0) {
+        const lookups = versionedTx.message.addressTableLookups;
+        for (const lut of lookups) {
+            const lutAccount = await fetchLutWithRetry(client, lut.accountKey);
+            if (lutAccount) {
+                lutAccounts.push(lutAccount);
+            }
+        }
+    }
+    let decompiledMessage;
+    try {
+        decompiledMessage = TransactionMessage.decompile(versionedTx.message, {
+            addressLookupTableAccounts: lutAccounts,
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to decompile Jupiter transaction message - one or more LUT accounts could not be resolved (fetched ${lutAccounts.length} of ${versionedTx.message.addressTableLookups?.length ?? 0} referenced LUTs). Original error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const createFeeAtaIx = createAssociatedTokenAccountIdempotentInstruction(decompiledMessage.payerKey, new PublicKey(feeAccount), ownerPubkey, mintPubkey, tokenProgramId);
+    const updatedMessage = new TransactionMessage({
+        payerKey: decompiledMessage.payerKey,
+        recentBlockhash: decompiledMessage.recentBlockhash,
+        instructions: [createFeeAtaIx, ...decompiledMessage.instructions],
+    }).compileToV0Message(lutAccounts.length > 0 ? lutAccounts : undefined);
+    // Do NOT copy versionedTx.signatures: the message bytes changed, so any
+    // signature over the old bytes is invalid. Jupiter does not pre-sign quotes.
+    return Buffer.from(new VersionedTransaction(updatedMessage).serialize()).toString('base64');
+};
+//# sourceMappingURL=jupiterFeeAta.js.map

package/dist/swap/general/jupiter/api/jupiterFeeAta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jupiterFeeAta.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/jupiter/api/jupiterFeeAta.ts"],"names":[],"mappings":"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"}