@vultisig/core-chain 2.19.0 → 2.20.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vultisig/core-chain
 
+## 2.20.0
+
+### Minor Changes
+
+- [#900](https://github.com/vultisig/vultisig-sdk/pull/900) [`9e72781`](https://github.com/vultisig/vultisig-sdk/commit/9e7278125bd8bc722a26ab3a1f91ba1be03054d1) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - feat(solana): staking foundation — models + RPC read layer
+
+  Phase 1 of Solana native staking. Adds the chain-layer read foundation under
+  `@vultisig/core-chain/chains/solana/staking`: config, stake-account/validator
+  models (jsonParsed parsing + activation-state derivation), the RPC read layer
+  (getVoteAccounts / stake-account scan / epoch / rent / inflation / supply), and
+  the withdraw cooldown gate. No UI, no signing, no validator-metadata source.
+
 ## 2.19.0
 
 ### Minor Changes

package/dist/chains/solana/staking/config.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Constants for Solana native staking (Stake program) reads.
+ *
+ * The Stake-program account layout and the staker-authority memcmp offset are
+ * protocol facts, not per-chain config, so this is a single flat constant set.
+ *
+ * The min-delegation RPC (`getStakeMinimumDelegation`) is blocked by the
+ * Vultisig proxy. The 1 SOL program minimum delegation is active on mainnet and
+ * is enforced by the Stake program — a delegation below it reverts with
+ * `StakeError.InsufficientDelegation`. Since the RPC is blocked, the delegation
+ * floor uses the documented `minDelegationFloorLamports` constant below plus the
+ * live rent-exempt reserve (active stake = funding − rent, so the funding floor
+ * is 1 SOL + rent).
+ *
+ * Port of iOS `SolanaStakingConfig`.
+ */
+export declare const solanaStakingConfig: {
+    /**
+     * The on-chain Stake program. Every stake account is owned by this program;
+     * it is also the `programId` argument to the stake-filtered
+     * `getProgramAccounts` scan.
+     */
+    readonly stakeProgramId: "Stake11111111111111111111111111111111111111";
+    /**
+     * Byte size of a fully-initialized stake account (`StakeStateV2`). The
+     * `getProgramAccounts` scan filters on `dataSize: 200` to exclude
+     * uninitialized / rewards-pool accounts before the memcmp narrows to the
+     * owner's accounts.
+     */
+    readonly stakeStateSize: 200;
+    /**
+     * Offset of the staker authority pubkey inside the stake-account data, used
+     * as the `memcmp` offset to fetch only a given owner's stake accounts.
+     * Layout: 4-byte state enum discriminant + 8-byte `rentExemptReserve` = 12
+     * bytes precede `Meta.authorized.staker`.
+     */
+    readonly stakerMemcmpOffset: 12;
+    /**
+     * Offset of the delegation `voter` (vote account) pubkey inside the
+     * stake-account data. Available for vote-account-scoped scans; the
+     * owner-scoped read uses `stakerMemcmpOffset`.
+     */
+    readonly voterMemcmpOffset: 124;
+    /**
+     * Documented substitute for the blocked min-delegation RPC. 1 SOL in
+     * lamports — the historical program minimum. Used together with the live
+     * rent-exempt reserve as the delegation floor.
+     */
+    readonly minDelegationFloorLamports: 1000000000n;
+    /** Lamports per SOL (9 decimals). Shared by the staking read/format layer. */
+    readonly lamportsPerSol: 1000000000n;
+    /**
+     * Rent-exempt reserve for a 200-byte stake account (`StakeStateV2`), in
+     * lamports. Deterministic from the rent rate + account size, so it serves as
+     * the pre-load default before the live `getMinimumBalanceForRentExemption`
+     * read returns.
+     */
+    readonly rentExemptReserveLamports: 2282880n;
+    /**
+     * Mainnet schedule: 432,000 slots per epoch (~2 days). Informational — the
+     * live value is read from `getEpochInfo.slotsInEpoch`; this is the documented
+     * fallback for activation/cooldown copy.
+     */
+    readonly slotsPerEpoch: 432000n;
+    /**
+     * `u64::MAX` sentinel the Stake program writes into `deactivationEpoch` while
+     * a delegation is active (not deactivating). Parsed stake accounts carry this
+     * verbatim; the activation-state derivation treats it as "no deactivation
+     * scheduled".
+     */
+    readonly epochSentinel: 18446744073709551615n;
+};
+/** SOL decimals — used by the staking format layer. */
+export declare const solDecimals = 9;
+//# sourceMappingURL=config.d.ts.map

package/dist/chains/solana/staking/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/staking/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH,8EAA8E;;IAG9E;;;;;OAKG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;CAEK,CAAA;AAEV,uDAAuD;AACvD,eAAO,MAAM,WAAW,IAAI,CAAA"}

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

@@ -0,0 +1,75 @@
+/**
+ * Constants for Solana native staking (Stake program) reads.
+ *
+ * The Stake-program account layout and the staker-authority memcmp offset are
+ * protocol facts, not per-chain config, so this is a single flat constant set.
+ *
+ * The min-delegation RPC (`getStakeMinimumDelegation`) is blocked by the
+ * Vultisig proxy. The 1 SOL program minimum delegation is active on mainnet and
+ * is enforced by the Stake program — a delegation below it reverts with
+ * `StakeError.InsufficientDelegation`. Since the RPC is blocked, the delegation
+ * floor uses the documented `minDelegationFloorLamports` constant below plus the
+ * live rent-exempt reserve (active stake = funding − rent, so the funding floor
+ * is 1 SOL + rent).
+ *
+ * Port of iOS `SolanaStakingConfig`.
+ */
+export const solanaStakingConfig = {
+    /**
+     * The on-chain Stake program. Every stake account is owned by this program;
+     * it is also the `programId` argument to the stake-filtered
+     * `getProgramAccounts` scan.
+     */
+    stakeProgramId: 'Stake11111111111111111111111111111111111111',
+    /**
+     * Byte size of a fully-initialized stake account (`StakeStateV2`). The
+     * `getProgramAccounts` scan filters on `dataSize: 200` to exclude
+     * uninitialized / rewards-pool accounts before the memcmp narrows to the
+     * owner's accounts.
+     */
+    stakeStateSize: 200,
+    /**
+     * Offset of the staker authority pubkey inside the stake-account data, used
+     * as the `memcmp` offset to fetch only a given owner's stake accounts.
+     * Layout: 4-byte state enum discriminant + 8-byte `rentExemptReserve` = 12
+     * bytes precede `Meta.authorized.staker`.
+     */
+    stakerMemcmpOffset: 12,
+    /**
+     * Offset of the delegation `voter` (vote account) pubkey inside the
+     * stake-account data. Available for vote-account-scoped scans; the
+     * owner-scoped read uses `stakerMemcmpOffset`.
+     */
+    voterMemcmpOffset: 124,
+    /**
+     * Documented substitute for the blocked min-delegation RPC. 1 SOL in
+     * lamports — the historical program minimum. Used together with the live
+     * rent-exempt reserve as the delegation floor.
+     */
+    minDelegationFloorLamports: 1000000000n,
+    /** Lamports per SOL (9 decimals). Shared by the staking read/format layer. */
+    lamportsPerSol: 1000000000n,
+    /**
+     * Rent-exempt reserve for a 200-byte stake account (`StakeStateV2`), in
+     * lamports. Deterministic from the rent rate + account size, so it serves as
+     * the pre-load default before the live `getMinimumBalanceForRentExemption`
+     * read returns.
+     */
+    rentExemptReserveLamports: 2282880n,
+    /**
+     * Mainnet schedule: 432,000 slots per epoch (~2 days). Informational — the
+     * live value is read from `getEpochInfo.slotsInEpoch`; this is the documented
+     * fallback for activation/cooldown copy.
+     */
+    slotsPerEpoch: 432000n,
+    /**
+     * `u64::MAX` sentinel the Stake program writes into `deactivationEpoch` while
+     * a delegation is active (not deactivating). Parsed stake accounts carry this
+     * verbatim; the activation-state derivation treats it as "no deactivation
+     * scheduled".
+     */
+    epochSentinel: 18446744073709551615n,
+};
+/** SOL decimals — used by the staking format layer. */
+export const solDecimals = 9;
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/staking/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC;;;;OAIG;IACH,cAAc,EAAE,6CAA6C;IAE7D;;;;;OAKG;IACH,cAAc,EAAE,GAAG;IAEnB;;;;;OAKG;IACH,kBAAkB,EAAE,EAAE;IAEtB;;;;OAIG;IACH,iBAAiB,EAAE,GAAG;IAEtB;;;;OAIG;IACH,0BAA0B,EAAE,WAAc;IAE1C,8EAA8E;IAC9E,cAAc,EAAE,WAAc;IAE9B;;;;;OAKG;IACH,yBAAyB,EAAE,QAAU;IAErC;;;;OAIG;IACH,aAAa,EAAE,OAAQ;IAEvB;;;;;OAKG;IACH,aAAa,EAAE,qBAA2B;CAClC,CAAA;AAEV,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAA"}

package/dist/chains/solana/staking/cooldownGate.d.ts

@@ -0,0 +1,34 @@
+import { SolanaStakeAccount } from './models/stakeAccount.js';
+/**
+ * Gates a stake-account withdraw on the deactivation cooldown. After a
+ * deactivate, the stake cools down for ~1 epoch: the lamports become
+ * withdrawable only once the network epoch has advanced PAST the account's
+ * `deactivationEpoch`. Evaluating this before a withdraw keysign avoids
+ * surprising the user with a transaction the Stake program would reject.
+ *
+ * Port of iOS `SolanaEpochCooldownGate`.
+ */
+export type SolanaEpochCooldownState = {
+    status: 'available';
+} | {
+    status: 'blocked';
+    unlocksAtEpoch: bigint;
+};
+/**
+ * Evaluates whether `account`'s deactivated stake can be withdrawn at
+ * `currentEpoch`. Pure function over the parsed delegation + the live epoch.
+ *
+ * - A non-deactivating account (sentinel `deactivationEpoch`) is `available` —
+ *   there is nothing cooling down.
+ * - A deactivating account unlocks once the network advances past its
+ *   deactivation epoch, i.e. at `deactivationEpoch + 1`.
+ */
+export declare const evaluateCooldown: (account: SolanaStakeAccount, currentEpoch: bigint) => SolanaEpochCooldownState;
+/**
+ * Approximate mainnet epoch length in days. Informational copy only — the
+ * authoritative withdraw gate is `evaluateCooldown`, which uses the live epoch.
+ */
+export declare const approximateDaysPerEpoch = 2;
+/** Approximate calendar days for `epochs` epochs of cooldown. */
+export declare const approximateCooldownDays: (epochs: number) => number;
+//# sourceMappingURL=cooldownGate.d.ts.map

package/dist/chains/solana/staking/cooldownGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldownGate.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/staking/cooldownGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAElF;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9G;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,kBAAkB,EAAE,cAAc,MAAM,KAAG,wBAapF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,KAAG,MAAuD,CAAA"}

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

@@ -0,0 +1,32 @@
+import { isDeactivationSentinel } from './models/stakeAccount.js';
+/**
+ * Evaluates whether `account`'s deactivated stake can be withdrawn at
+ * `currentEpoch`. Pure function over the parsed delegation + the live epoch.
+ *
+ * - A non-deactivating account (sentinel `deactivationEpoch`) is `available` —
+ *   there is nothing cooling down.
+ * - A deactivating account unlocks once the network advances past its
+ *   deactivation epoch, i.e. at `deactivationEpoch + 1`.
+ */
+export const evaluateCooldown = (account, currentEpoch) => {
+    const { delegation } = account;
+    if (!delegation) {
+        return { status: 'available' };
+    }
+    if (isDeactivationSentinel(delegation)) {
+        return { status: 'available' };
+    }
+    if (currentEpoch > delegation.deactivationEpoch) {
+        return { status: 'available' };
+    }
+    // `deactivationEpoch` is < sentinel here, so +1 is safe.
+    return { status: 'blocked', unlocksAtEpoch: delegation.deactivationEpoch + 1n };
+};
+/**
+ * Approximate mainnet epoch length in days. Informational copy only — the
+ * authoritative withdraw gate is `evaluateCooldown`, which uses the live epoch.
+ */
+export const approximateDaysPerEpoch = 2;
+/** Approximate calendar days for `epochs` epochs of cooldown. */
+export const approximateCooldownDays = (epochs) => Math.max(0, epochs) * approximateDaysPerEpoch;
+//# sourceMappingURL=cooldownGate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cooldownGate.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/staking/cooldownGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAsB,MAAM,uBAAuB,CAAA;AAalF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA2B,EAAE,YAAoB,EAA4B,EAAE;IAC9G,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IAChC,CAAC;IACD,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IAChC,CAAC;IACD,IAAI,YAAY,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAChD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IAChC,CAAC;IACD,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,CAAC,iBAAiB,GAAG,EAAE,EAAE,CAAA;AACjF,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,uBAAuB,CAAA"}

package/dist/chains/solana/staking/models/stakeAccount.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Parsed Solana stake account — the read-side model the staking UI binds to
+ * (delegation amount, validator, activation state, withdraw authority). One
+ * stake account delegates to exactly one validator; a wallet can hold N.
+ *
+ * Decoded from a `getAccountInfo` / `getProgramAccounts` `jsonParsed` row
+ * (`value.data.parsed.info.{meta,stake}`). The on-chain numbers
+ * (`activationEpoch`, `deactivationEpoch`, `stake`, `rentExemptReserve`) are
+ * serialized as decimal STRINGS in jsonParsed — they're u64 and exceed JSON's
+ * safe-integer range — so they are converted to `bigint` here.
+ *
+ * Port of iOS `SolanaStakeAccount`.
+ */
+/**
+ * Activation lifecycle of a stake delegation, derived from the account's
+ * `activationEpoch` / `deactivationEpoch` relative to the current epoch.
+ * Solana stake activates at the next epoch boundary and cools down ~1 epoch
+ * after a deactivate before the funds can be withdrawn.
+ */
+export type SolanaStakeActivationState = 'activating' | 'active' | 'deactivating' | 'inactive';
+export type SolanaStakeDelegation = {
+    /** Vote account this stake is delegated to. */
+    votePubkey: string;
+    /** Epoch the delegation began activating. */
+    activationEpoch: bigint;
+    /**
+     * Epoch the delegation began deactivating, or `epochSentinel` (`u64::MAX`)
+     * while active (the Stake program's "not deactivating" sentinel).
+     */
+    deactivationEpoch: bigint;
+    /** Delegated lamports. */
+    stake: bigint;
+};
+export type SolanaStakeAccount = {
+    /** Stake account address (its own pubkey, not the owner's). */
+    pubkey: string;
+    /**
+     * The account's total lamports (delegated stake + rent reserve + any
+     * undelegated lamports).
+     */
+    lamports: bigint;
+    /**
+     * Rent-exempt reserve held by the account — not part of the delegated /
+     * withdrawable stake.
+     */
+    rentExemptReserve: bigint;
+    /** Authority allowed to delegate / deactivate the stake. */
+    staker: string;
+    /** Authority allowed to withdraw the stake. */
+    withdrawer: string;
+    /**
+     * The delegation, or `undefined` for an initialized-but-undelegated account
+     * (`parsed.type == "initialized"`, no `stake.delegation`).
+     */
+    delegation?: SolanaStakeDelegation;
+};
+/** `true` when no deactivation has been scheduled on the delegation. */
+export declare const isDeactivationSentinel: (delegation: SolanaStakeDelegation) => boolean;
+/**
+ * Derives the lifecycle state from the current epoch. Pure so the cooldown gate
+ * and the UI share one definition.
+ *
+ * - activating: delegation began this epoch and is not deactivating.
+ * - deactivating: a deactivation was scheduled and the current epoch has not
+ *   yet passed it.
+ * - active: delegated in a prior epoch and not deactivating.
+ * - inactive: no delegation, or the deactivation epoch has passed.
+ */
+export declare const stakeActivationState: (account: SolanaStakeAccount, currentEpoch: bigint) => SolanaStakeActivationState;
+/**
+ * Mirrors the `jsonParsed` Stake-program account `info` shape. u64 fields arrive
+ * as decimal strings (or numbers); `toBigInt` coerces both.
+ */
+type ParsedStakeInfo = {
+    meta?: {
+        rentExemptReserve?: string | number;
+        authorized?: {
+            staker?: string;
+            withdrawer?: string;
+        };
+    };
+    stake?: {
+        delegation?: {
+            voter?: string;
+            stake?: string | number;
+            activationEpoch?: string | number;
+            deactivationEpoch?: string | number;
+        };
+    };
+};
+/**
+ * Builds the model from a decoded jsonParsed Stake-program account. Returns
+ * `undefined` when the account is not a parsed stake account (e.g. a non-stake
+ * program account or a base64/dataSliced row with no `parsed` tree).
+ */
+export declare const parseStakeAccount: ({ pubkey, lamports, parsedInfo, }: {
+    pubkey: string;
+    lamports: bigint;
+    parsedInfo: ParsedStakeInfo | undefined;
+}) => SolanaStakeAccount | undefined;
+export {};
+//# sourceMappingURL=stakeAccount.d.ts.map

package/dist/chains/solana/staking/models/stakeAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stakeAccount.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/solana/staking/models/stakeAccount.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAA;AAE9F,MAAM,MAAM,qBAAqB,GAAG;IAClC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,qBAAqB,CAAA;CACnC,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,GAAI,YAAY,qBAAqB,KAAG,OACP,CAAA;AAEpE;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,kBAAkB,EAAE,cAAc,MAAM,KAAG,0BAcxF,CAAA;AAID;;;GAGG;AACH,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE;QACL,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;QACnC,UAAU,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACtD,CAAA;IACD,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE;YACX,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;YACvB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;YACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SACpC,CAAA;KACF,CAAA;CACF,CAAA;AAaD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,mCAI/B;IACD,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,eAAe,GAAG,SAAS,CAAA;CACxC,KAAG,kBAAkB,GAAG,SA4CxB,CAAA"}

package/dist/chains/solana/staking/models/stakeAccount.js

@@ -0,0 +1,85 @@
+import { solanaStakingConfig } from '../config.js';
+/** `true` when no deactivation has been scheduled on the delegation. */
+export const isDeactivationSentinel = (delegation) => delegation.deactivationEpoch === solanaStakingConfig.epochSentinel;
+/**
+ * Derives the lifecycle state from the current epoch. Pure so the cooldown gate
+ * and the UI share one definition.
+ *
+ * - activating: delegation began this epoch and is not deactivating.
+ * - deactivating: a deactivation was scheduled and the current epoch has not
+ *   yet passed it.
+ * - active: delegated in a prior epoch and not deactivating.
+ * - inactive: no delegation, or the deactivation epoch has passed.
+ */
+export const stakeActivationState = (account, currentEpoch) => {
+    const { delegation } = account;
+    if (!delegation) {
+        return 'inactive';
+    }
+    if (!isDeactivationSentinel(delegation)) {
+        // A deactivation is scheduled. Still cooling down until the current epoch
+        // passes the deactivation epoch; inactive afterwards.
+        return currentEpoch <= delegation.deactivationEpoch ? 'deactivating' : 'inactive';
+    }
+    // No deactivation scheduled — activating in its first epoch, active after.
+    return currentEpoch <= delegation.activationEpoch ? 'activating' : 'active';
+};
+const toBigInt = (value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    try {
+        return BigInt(typeof value === 'number' ? Math.trunc(value) : value);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Builds the model from a decoded jsonParsed Stake-program account. Returns
+ * `undefined` when the account is not a parsed stake account (e.g. a non-stake
+ * program account or a base64/dataSliced row with no `parsed` tree).
+ */
+export const parseStakeAccount = ({ pubkey, lamports, parsedInfo, }) => {
+    // Reject partially-malformed payloads rather than coercing them into
+    // fabricated zero/empty values — a bogus `0n` stake or empty authority would
+    // surface downstream as wrong balances or a falsely inactive/available state.
+    const meta = parsedInfo?.meta;
+    if (!meta?.authorized?.staker || !meta.authorized.withdrawer) {
+        return undefined;
+    }
+    const rentExemptReserve = toBigInt(meta.rentExemptReserve);
+    if (rentExemptReserve === undefined) {
+        return undefined;
+    }
+    const delegationInfo = parsedInfo?.stake?.delegation;
+    let delegation;
+    if (delegationInfo) {
+        // A delegation object with no `voter` is a malformed row, not an
+        // undelegated account — reject it rather than fabricating "inactive".
+        if (!delegationInfo.voter) {
+            return undefined;
+        }
+        const activationEpoch = toBigInt(delegationInfo.activationEpoch);
+        const deactivationEpoch = toBigInt(delegationInfo.deactivationEpoch);
+        const stake = toBigInt(delegationInfo.stake);
+        if (activationEpoch === undefined || deactivationEpoch === undefined || stake === undefined) {
+            return undefined;
+        }
+        delegation = {
+            votePubkey: delegationInfo.voter,
+            activationEpoch,
+            deactivationEpoch,
+            stake,
+        };
+    }
+    return {
+        pubkey,
+        lamports,
+        rentExemptReserve,
+        staker: meta.authorized.staker,
+        withdrawer: meta.authorized.withdrawer,
+        delegation,
+    };
+};
+//# sourceMappingURL=stakeAccount.js.map

package/dist/chains/solana/staking/models/stakeAccount.js.map

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

package/dist/chains/solana/staking/models/validator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * A validator row from `getVoteAccounts` plus an optional metadata enrichment
+ * struct (name / logo / APY / score) populated by the metadata-provider seam.
+ * The base row is decoded straight off the RPC; `ValidatorMetadata` starts
+ * empty so the read layer can ship before the enrichment source is wired.
+ *
+ * Port of iOS `SolanaValidator` / `ValidatorMetadata`.
+ */
+/**
+ * Off-chain enrichment for a validator. All optional — populated from a
+ * metadata source; the base read layer leaves it empty.
+ */
+export type ValidatorMetadata = {
+    name?: string;
+    logoUrl?: string;
+    /** Estimated APY as a fraction (e.g. 0.067 for 6.7%). */
+    apyEstimate?: number;
+    /** A 0–100 quality score from the metadata source. */
+    score?: number;
+};
+export type SolanaValidator = {
+    /** Vote account address — the delegation target a stake account points at. */
+    votePubkey: string;
+    /** The validator's identity (node) pubkey. */
+    nodePubkey: string;
+    /**
+     * Total active stake delegated to this validator, in lamports. Sourced from
+     * `getVoteAccounts`, which serializes it as a JSON number — so for very large
+     * validators this is already an approximate (>2^53) value. Kept as `number`
+     * rather than dressed up as an exact `bigint`; it drives sort / voting-power
+     * display only, never balance math.
+     */
+    activatedStake: number;
+    /** Commission percentage (0–100) the validator takes from rewards. */
+    commission: number;
+    /** Whether this vote account has voted in the current epoch. */
+    epochVoteAccount: boolean;
+    /**
+     * `true` when the validator is in the delinquent set (not voting). Carried
+     * from which `getVoteAccounts` bucket the row came from, not the wire.
+     */
+    isDelinquent: boolean;
+    /** Enrichment from the metadata provider — name, logo, APY estimate, score. */
+    metadata: ValidatorMetadata;
+};
+/**
+ * `prefix…suffix` form of a base58 pubkey for compact display. Returns the
+ * input unchanged when it is too short to truncate meaningfully.
+ */
+export declare const truncatedPubkey: (pubkey: string, prefix?: number, suffix?: number) => string;
+/**
+ * Name to show in the picker: the enriched metadata name when present,
+ * otherwise a truncated vote pubkey. Keeps the display layer independent of
+ * whether the metadata provider returned anything.
+ */
+export declare const validatorDisplayName: (validator: SolanaValidator) => string;
+/**
+ * The validator logo URL, or `undefined` when no metadata source supplied one —
+ * the display layer then renders a deterministic placeholder.
+ */
+export declare const validatorLogoUrl: (validator: SolanaValidator) => string | undefined;
+//# sourceMappingURL=validator.d.ts.map

package/dist/chains/solana/staking/models/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/solana/staking/models/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,gBAAgB,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,EAAE,iBAAiB,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,eAAU,EAAE,eAAU,KAAG,MAC6B,CAAA;AAEtG;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,eAAe,KAAG,MAMjE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,eAAe,KAAG,MAAM,GAAG,SAGtE,CAAA"}

package/dist/chains/solana/staking/models/validator.js

@@ -0,0 +1,34 @@
+/**
+ * A validator row from `getVoteAccounts` plus an optional metadata enrichment
+ * struct (name / logo / APY / score) populated by the metadata-provider seam.
+ * The base row is decoded straight off the RPC; `ValidatorMetadata` starts
+ * empty so the read layer can ship before the enrichment source is wired.
+ *
+ * Port of iOS `SolanaValidator` / `ValidatorMetadata`.
+ */
+/**
+ * `prefix…suffix` form of a base58 pubkey for compact display. Returns the
+ * input unchanged when it is too short to truncate meaningfully.
+ */
+export const truncatedPubkey = (pubkey, prefix = 4, suffix = 4) => pubkey.length > prefix + suffix + 1 ? `${pubkey.slice(0, prefix)}…${pubkey.slice(-suffix)}` : pubkey;
+/**
+ * Name to show in the picker: the enriched metadata name when present,
+ * otherwise a truncated vote pubkey. Keeps the display layer independent of
+ * whether the metadata provider returned anything.
+ */
+export const validatorDisplayName = (validator) => {
+    const name = validator.metadata.name?.trim();
+    if (name) {
+        return name;
+    }
+    return truncatedPubkey(validator.votePubkey);
+};
+/**
+ * The validator logo URL, or `undefined` when no metadata source supplied one —
+ * the display layer then renders a deterministic placeholder.
+ */
+export const validatorLogoUrl = (validator) => {
+    const raw = validator.metadata.logoUrl?.trim();
+    return raw ? raw : undefined;
+};
+//# sourceMappingURL=validator.js.map

package/dist/chains/solana/staking/models/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/solana/staking/models/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyCH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAU,EAAE,CAChF,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;AAEtG;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAA0B,EAAU,EAAE;IACzE,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;AAC9C,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAA0B,EAAsB,EAAE;IACjF,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9B,CAAC,CAAA"}

package/dist/chains/solana/staking/rpc.d.ts

@@ -0,0 +1,49 @@
+import { SolanaStakeAccount } from './models/stakeAccount.js';
+import { SolanaValidator } from './models/validator.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 declare const fetchSolanaValidators: () => Promise<SolanaValidator[]>;
+/**
+ * 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 declare const fetchSolanaStakeAccounts: (owner: string) => Promise<SolanaStakeAccount[]>;
+/**
+ * Fetches a single stake account's parsed state by address. Used by the
+ * unstake / withdraw / move flows that operate on a known account.
+ */
+export declare const fetchSolanaStakeAccount: (pubkey: string) => Promise<SolanaStakeAccount | undefined>;
+export type SolanaEpochInfo = {
+    epoch: bigint;
+    slotIndex: bigint;
+    slotsInEpoch: bigint;
+};
+/** Current epoch info — drives activation-state derivation and cooldown copy. */
+export declare const fetchSolanaEpochInfo: () => Promise<SolanaEpochInfo>;
+/**
+ * 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 declare const fetchSolanaRentReserve: () => Promise<bigint>;
+/** Network inflation rate (total) — drives the on-chain APY fallback. */
+export declare const fetchSolanaInflationRate: () => Promise<number>;
+/**
+ * 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 declare const fetchSolanaTotalSupply: () => Promise<number>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/chains/solana/staking/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/staking/rpc.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,eAAe,EAAE,CAiBvE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,kBAAkB,EAAE,CAqB1F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAWpG,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,QAAa,OAAO,CAAC,eAAe,CAQpE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,MAAM,CAI7D,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,MAAM,CAI/D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,MAAM,CAI7D,CAAA"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/core-chain",
-  "version": "2.19.0",
+  "version": "2.20.0",
   "description": "Blockchain chain logic shared across Vultisig clients",
   "license": "MIT",
   "repository": {
@@ -680,6 +680,31 @@
       "import": "./dist/chains/solana/spl/getSplAssociatedAccount.js",
       "default": "./dist/chains/solana/spl/getSplAssociatedAccount.js"
     },
+    "./chains/solana/staking/config": {
+      "types": "./dist/chains/solana/staking/config.d.ts",
+      "import": "./dist/chains/solana/staking/config.js",
+      "default": "./dist/chains/solana/staking/config.js"
+    },
+    "./chains/solana/staking/cooldownGate": {
+      "types": "./dist/chains/solana/staking/cooldownGate.d.ts",
+      "import": "./dist/chains/solana/staking/cooldownGate.js",
+      "default": "./dist/chains/solana/staking/cooldownGate.js"
+    },
+    "./chains/solana/staking/models/stakeAccount": {
+      "types": "./dist/chains/solana/staking/models/stakeAccount.d.ts",
+      "import": "./dist/chains/solana/staking/models/stakeAccount.js",
+      "default": "./dist/chains/solana/staking/models/stakeAccount.js"
+    },
+    "./chains/solana/staking/models/validator": {
+      "types": "./dist/chains/solana/staking/models/validator.d.ts",
+      "import": "./dist/chains/solana/staking/models/validator.js",
+      "default": "./dist/chains/solana/staking/models/validator.js"
+    },
+    "./chains/solana/staking/rpc": {
+      "types": "./dist/chains/solana/staking/rpc.d.ts",
+      "import": "./dist/chains/solana/staking/rpc.js",
+      "default": "./dist/chains/solana/staking/rpc.js"
+    },
     "./chains/sui/buildTransactionFromJson": {
       "types": "./dist/chains/sui/buildTransactionFromJson.d.ts",
       "import": "./dist/chains/sui/buildTransactionFromJson.js",