@vultisig/core-chain 2.18.0 → 2.19.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @vultisig/core-chain
 
+## 2.19.0
+
+### Minor Changes
+
+- [#894](https://github.com/vultisig/vultisig-sdk/pull/894) [`605fbba`](https://github.com/vultisig/vultisig-sdk/commit/605fbbaf107c553898f11f4f7eb6b56a59c01b9e) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - feat(swap): add Jupiter as a Solana same-chain swap provider with a VULT-scaled affiliate fee
+
+  `findSwapQuote` now offers Jupiter for on-Solana token pairs (SOL↔SPL, SPL↔SPL),
+  preferred over SwapKit/LiFi on a near-tie. Jupiter is Solana-only and same-chain
+  — it is never offered for any cross-chain route, and native SOL cross-chain swaps
+  stay on THORChain.
+
+  The Jupiter quote sends `platformFeeBps` = `max(0, 50 − vultTierDiscountBps)`
+  (the existing `getSwapAffiliateBps` value, shared with every other provider), and
+  the swap request sends `feeAccount` = the Associated Token Account of
+  `(owner = Vultisig fee wallet, mint = output mint)`. An idempotent
+  `createAssociatedTokenAccount` instruction for that fee ATA is prepended to the
+  returned transaction (Jupiter does not auto-create it). When the affiliate bps
+  floors to 0 (Ultimate-tier VULT holder), no platform fee or fee account is used.
+
+  New public surface: `swap/general/jupiter/*` (`getJupiterSwapQuote`,
+  `configureJupiter`, `jupiterSwapEnabledChains`) and `jupiter` added to
+  `generalSwapProviders` and the swap explorer providers.
+
+- [#893](https://github.com/vultisig/vultisig-sdk/pull/893) [`552064c`](https://github.com/vultisig/vultisig-sdk/commit/552064cbfb7307867f9897734c010e856f8a08f9) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - Add TON nominator-pool staking support. `@vultisig/core-chain` gains a tonapi staking client (`chains/ton/staking`) — pool list, computed pool info, and account nominator positions — plus per-implementation deposit/withdraw comment resolution (`whales` → `Deposit`/`Withdraw`, `tf` → `d`/`w`), pool eligibility/capacity filters, and a `tonAddressToBounceable` helper that normalizes raw `0:` pool addresses to the bounceable `EQ…` form. `@vultisig/core-mpc` now forces TON transfers bounceable for any staking comment (via `isTonStakingComment`), so a rejected pool deposit/withdraw bounces back instead of being absorbed.
+
+### Patch Changes
+
+- [#886](https://github.com/vultisig/vultisig-sdk/pull/886) [`baedd96`](https://github.com/vultisig/vultisig-sdk/commit/baedd96e9d75a9d73880a59503f95b527d692428) Thanks [@rcoderdev](https://github.com/rcoderdev)! - Add an EVM chain balance batching helper backed by Multicall3.
+
 ## 2.18.0
 
 ### Minor Changes

package/dist/chains/ton/address.d.ts

@@ -3,4 +3,13 @@
  * The toncenter v3 API requires raw addresses.
  */
 export declare const tonAddressToRaw: (userFriendlyAddress: string) => string;
+/**
+ * Converts a raw TON address (`workchain:hex`) to the bounceable user-friendly
+ * form (`EQ…`). Staking-API pool addresses arrive in raw `0:` form, which the
+ * signer treats as non-bounceable — sending a deposit non-bounceable risks the
+ * pool absorbing (losing) a rejected transfer instead of bouncing it back, so
+ * pool destinations MUST be normalized to the bounceable form first. Inputs
+ * already in user-friendly form are returned re-encoded as bounceable.
+ */
+export declare const tonAddressToBounceable: (address: string) => string;
 //# sourceMappingURL=address.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,MAIxD,CAAA"}

package/dist/chains/ton/address.js

@@ -1,3 +1,4 @@
+import { Address } from '@ton/core';
 import { fromBase64 } from '@vultisig/lib-utils/fromBase64';
 /** Converts base64url encoding to standard base64 so `Buffer.from` can decode it. */
 const fromBase64Url = (value) => {
@@ -14,4 +15,16 @@ export const tonAddressToRaw = (userFriendlyAddress) => {
     const hash = decoded.subarray(2, 34).toString('hex');
     return `${workchain}:${hash}`;
 };
+/**
+ * Converts a raw TON address (`workchain:hex`) to the bounceable user-friendly
+ * form (`EQ…`). Staking-API pool addresses arrive in raw `0:` form, which the
+ * signer treats as non-bounceable — sending a deposit non-bounceable risks the
+ * pool absorbing (losing) a rejected transfer instead of bouncing it back, so
+ * pool destinations MUST be normalized to the bounceable form first. Inputs
+ * already in user-friendly form are returned re-encoded as bounceable.
+ */
+export const tonAddressToBounceable = (address) => {
+    const parsed = address.includes(':') ? Address.parseRaw(address) : Address.parse(address);
+    return parsed.toString({ bounceable: true, testOnly: false, urlSafe: true });
+};
 //# sourceMappingURL=address.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAE3D,qFAAqF;AACrF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,mBAA2B,EAAU,EAAE;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEpD,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC,CAAA"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAE3D,qFAAqF;AACrF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,mBAA2B,EAAU,EAAE;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEpD,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAU,EAAE;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAEzF,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AAC9E,CAAC,CAAA"}

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

@@ -0,0 +1,104 @@
+/**
+ * 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 declare const tonNominatorImplementations: readonly ["whales", "tf"];
+export type TonNominatorImplementation = (typeof tonNominatorImplementations)[number];
+export declare const isTonNominatorImplementation: (implementation: string | undefined) => implementation is TonNominatorImplementation;
+/** Deposit comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export declare const tonStakingDepositComment: (implementation: string | undefined) => string | undefined;
+/** Withdraw comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export declare const tonStakingWithdrawComment: (implementation: string | undefined) => string | undefined;
+/**
+ * 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 declare const isTonStakingComment: (memo: string | undefined) => boolean;
+/**
+ * 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 declare 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 declare 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 declare const tonStakingFeeReserve = 50000000n;
+/**
+ * A staking-pool list entry. `address` is the bounceable user-friendly (`EQ…`)
+ * pool contract address (normalized from the raw `0:` API form), `apy` is a
+ * percentage (e.g. `13.27` = 13.27%), and `minStake` is in nanotons.
+ */
+export type TonStakingPool = {
+    address: string;
+    name: string;
+    apy: number;
+    minStake: bigint;
+    verified: boolean;
+    currentNominators?: number;
+    maxNominators?: number;
+    implementation?: string;
+    cycleEnd?: number;
+};
+/** Whether a pool has room for another nominator (pools at capacity reject new stakes). */
+export declare const tonPoolHasCapacity: (pool: TonStakingPool) => boolean;
+/**
+ * Whether a pool is a verified nominator pool with capacity — i.e. one the
+ * picker should surface and a stake can succeed into.
+ */
+export declare const isStakeableTonPool: (pool: TonStakingPool) => boolean;
+/**
+ * Fetches all verified TON staking pools from tonapi (`/v2/staking/pools`).
+ * Includes every implementation; callers filter to stakeable nominator pools
+ * via `isStakeableTonPool`.
+ */
+export declare const getTonStakingPools: () => Promise<TonStakingPool[]>;
+/**
+ * Computed info for a single pool (`/v2/staking/pool/{address}`). All fields
+ * are optional so a partial/changed response degrades gracefully. `apy` is a
+ * percentage; `cycleEnd` is the Unix second the current validation cycle ends.
+ */
+export type TonStakingPoolInfo = {
+    address?: string;
+    name?: string;
+    apy?: number;
+    minStake?: bigint;
+    implementation?: string;
+    cycleEnd?: number;
+};
+/** Fetches computed pool metadata (name, APY, implementation, cycle end). */
+export declare const getTonStakingPoolInfo: (poolAddress: string) => Promise<TonStakingPoolInfo | undefined>;
+/**
+ * An account's position in a nominator pool. All amounts are nanotons. `amount`
+ * is the active stake; `pendingDeposit` is a just-placed stake awaiting the
+ * next validation cycle; `pendingWithdraw`/`readyWithdraw` indicate an
+ * in-progress withdrawal (funds locked until the cycle ends). `pool` is the
+ * bounceable user-friendly (`EQ…`) pool address (normalized from raw `0:`).
+ */
+export type TonNominatorPosition = {
+    pool: string;
+    amount: bigint;
+    pendingDeposit: bigint;
+    pendingWithdraw: bigint;
+    readyWithdraw: bigint;
+};
+/**
+ * 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 declare const getTonNominatorPools: (accountId: string) => Promise<TonNominatorPosition[]>;
+//# sourceMappingURL=staking.d.ts.map

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