@vultisig/core-chain 2.18.0 → 2.20.0

package/dist/chains/solana/staking/rpc.js

@@ -0,0 +1,112 @@
+import { PublicKey } from '@solana/web3.js';
+import { getSolanaClient } from '../client.js';
+import { solanaStakingConfig } from './config.js';
+import { parseStakeAccount } from './models/stakeAccount.js';
+/**
+ * Read-side Solana RPC for native staking. Thin wrappers over the shared
+ * `@solana/web3.js` connection (`getSolanaClient`) so the staking read layer
+ * stays one call away from the rest of the Solana chain code.
+ *
+ * Port of the Solana staking reads in iOS `SolanaService` / `SolanaAPI`.
+ */
+/**
+ * Lists every validator from `getVoteAccounts`, tagging each with the
+ * delinquent flag derived from its bucket (`current` vs `delinquent`). The base
+ * metadata is left empty — the metadata-provider seam enriches it later.
+ */
+export const fetchSolanaValidators = async () => {
+    const client = getSolanaClient();
+    const { current, delinquent } = await client.getVoteAccounts();
+    const toValidator = (account, isDelinquent) => ({
+        votePubkey: account.votePubkey,
+        nodePubkey: account.nodePubkey,
+        // `activatedStake` arrives from the RPC as a JSON number — keep it as-is
+        // rather than minting a falsely-exact bigint from an already-lossy value.
+        activatedStake: account.activatedStake,
+        commission: account.commission,
+        epochVoteAccount: account.epochVoteAccount,
+        isDelinquent,
+        metadata: {},
+    });
+    return [...current.map(a => toValidator(a, false)), ...delinquent.map(a => toValidator(a, true))];
+};
+/**
+ * Fetches the owner's stake accounts via a Stake-program `getProgramAccounts`
+ * scan filtered on `dataSize: 200` (fully-initialized stake accounts) and a
+ * memcmp on the staker authority at offset 12. Uncached at the call site — the
+ * staking view must reflect just-submitted txs and newly accrued rewards.
+ */
+export const fetchSolanaStakeAccounts = async (owner) => {
+    const client = getSolanaClient();
+    const rows = await client.getParsedProgramAccounts(new PublicKey(solanaStakingConfig.stakeProgramId), {
+        filters: [
+            { dataSize: solanaStakingConfig.stakeStateSize },
+            { memcmp: { offset: solanaStakingConfig.stakerMemcmpOffset, bytes: owner } },
+        ],
+    });
+    return rows.flatMap(({ pubkey, account }) => {
+        const { data } = account;
+        if (!('parsed' in data)) {
+            return [];
+        }
+        const parsed = parseStakeAccount({
+            pubkey: pubkey.toBase58(),
+            lamports: BigInt(account.lamports),
+            parsedInfo: data.parsed?.info,
+        });
+        return parsed ? [parsed] : [];
+    });
+};
+/**
+ * Fetches a single stake account's parsed state by address. Used by the
+ * unstake / withdraw / move flows that operate on a known account.
+ */
+export const fetchSolanaStakeAccount = async (pubkey) => {
+    const client = getSolanaClient();
+    const { value } = await client.getParsedAccountInfo(new PublicKey(pubkey));
+    if (!value || !('parsed' in value.data)) {
+        return undefined;
+    }
+    return parseStakeAccount({
+        pubkey,
+        lamports: BigInt(value.lamports),
+        parsedInfo: value.data.parsed?.info,
+    });
+};
+/** Current epoch info — drives activation-state derivation and cooldown copy. */
+export const fetchSolanaEpochInfo = async () => {
+    const client = getSolanaClient();
+    const info = await client.getEpochInfo();
+    return {
+        epoch: BigInt(info.epoch),
+        slotIndex: BigInt(info.slotIndex),
+        slotsInEpoch: BigInt(info.slotsInEpoch),
+    };
+};
+/**
+ * The rent-exempt reserve for a 200-byte stake account, in lamports. The new
+ * stake account must be funded with this on top of the delegated amount.
+ */
+export const fetchSolanaRentReserve = async () => {
+    const client = getSolanaClient();
+    const lamports = await client.getMinimumBalanceForRentExemption(solanaStakingConfig.stakeStateSize);
+    return BigInt(lamports);
+};
+/** Network inflation rate (total) — drives the on-chain APY fallback. */
+export const fetchSolanaInflationRate = async () => {
+    const client = getSolanaClient();
+    const { total } = await client.getInflationRate();
+    return total;
+};
+/**
+ * Total SOL supply in lamports — the denominator for the staked fraction in the
+ * APY fallback. `getSupply` returns a JSON number that exceeds 2^53, so it is
+ * already approximate; kept as `number` (the ratio it feeds only needs ~2dp),
+ * not minted into a falsely-exact bigint.
+ */
+export const fetchSolanaTotalSupply = async () => {
+    const client = getSolanaClient();
+    const { value } = await client.getSupply();
+    return value.total;
+};
+//# sourceMappingURL=rpc.js.map

package/dist/chains/solana/staking/rpc.js.map

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

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"}