@pyefi/sdk 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { V as ValidatorId, M as MaturityId, U as UserStakeAccount, O as OpenOrder, a as MatchedMarket, I as IndividualOrder, b as Maturity } from './apy-store-CNq9A4Xc.js';
-export { A as ALLOWED_VALIDATORS, c as ApyActions, d as ApyState, e as ApyStore, B as BalanceActions, f as BalanceState, g as BalanceStore, h as Balances, i as ManifestMarketRecord, j as MarketActions, k as MarketState, l as MarketStore, m as OrderBookSummary, S as StakeAccountState, n as Validator, W as WalletActions, o as WalletState, p as WalletStatus, q as WalletStore, r as buildMarketLookup, s as createApyStore, t as createBalanceStore, u as createMarketStore, v as createWalletStore, w as fetchManifestMarkets, x as getMaturity, y as maturities, z as maturitiesArray, C as maturityIdsArray, D as parseOrderBook, E as validators } from './apy-store-CNq9A4Xc.js';
 import { PublicKey, Connection } from '@solana/web3.js';
+import { U as UserStakeAccount, B as Balances, O as OpenOrder, M as MatchedMarket, I as IndividualOrder, V as ValidatorRow, a as BondRow } from './validator-store-CirN3_Ac.js';
+export { A as ApyActions, b as ApyState, c as ApyStore, d as BalanceActions, e as BalanceState, f as BalanceStore, C as CanonicalMaturity, L as LockupActions, g as LockupState, h as LockupStore, i as ManifestMarketRecord, j as MarketActions, k as MarketState, l as MarketStore, m as OrderBookSummary, S as StakeAccountState, n as ValidatorActions, o as ValidatorState, p as ValidatorStore, W as WalletActions, q as WalletState, r as WalletStatus, s as WalletStore, t as buildMarketLookup, u as createApyStore, v as createBalanceStore, w as createLockupStore, x as createMarketStore, y as createValidatorStore, z as createWalletStore, D as fetchManifestMarkets, E as parseOrderBook, F as selectBond, G as selectBondsForValidator, H as selectWidgetValidator, J as selectWidgetValidators } from './validator-store-CirN3_Ac.js';
 import { SupabaseClient } from '@supabase/supabase-js';
 import { WalletContextState } from '@solana/wallet-adapter-react';
 import 'immer';
@@ -17,6 +17,46 @@ interface PyeSDKConfig {
 declare function configurePyeSDK(config: PyeSDKConfig): void;
 declare function getPyeConfig(): PyeSDKConfig;
 
+interface Validator {
+    name: string;
+    symbol: string;
+    vote_account: string;
+    pt_sol: string;
+    rt_sol: string;
+    is_allowed: boolean;
+    type: "validator" | "lst";
+}
+type ValidatorId = "adrastea" | "alchemy" | "all-nodes" | "alpha-pro" | "anagram" | "anchorage-digital" | "anza" | "astralane" | "asymmetric" | "binance" | "bitwise" | "block-logic" | "blockdaemon" | "blockport" | "blocksize" | "bloxroute" | "blueshift" | "bonk" | "bybit" | "chainflow" | "chorus-one" | "coinbase" | "coyote-staking" | "dawnlabs" | "decentra" | "defi-dev-corp" | "drift" | "dsrv" | "edgevana" | "emory-blockchain" | "everstake" | "exo-tech" | "facilities" | "falconx" | "fd1" | "figment" | "forward-industries" | "galaxy" | "gate-omega" | "gemini" | "genco" | "global-stake" | "greed-academy" | "gripto" | "guardian" | "h2o-nodes" | "hashkey-cloud" | "haus" | "helius" | "hello-moon" | "hinode-tech" | "hubra" | "hylo" | "ice-staking" | "ily-validator" | "infinite-sol" | "jupiter" | "kairos-research" | "kiln" | "kraken" | "kumavalidator" | "laine" | "lakestake" | "lantern" | "ledger" | "luganodes" | "luminal" | "lumos-maxima" | "madlads" | "magic-eden" | "marginfi" | "meria" | "mesh-validator" | "monkedao" | "nansen" | "neodyme" | "nordic-staking" | "nova-consortium" | "okx-earn" | "omakase" | "orang3club" | "orangefin" | "ottersec" | "overclock" | "p-ops" | "p2p" | "parafi" | "phantom" | "phase-labs" | "pier-two" | "portals" | "project-catalyst" | "project-super" | "prostaking" | "pumpkins-pool" | "quicknode" | "radiants" | "rakurai" | "range" | "raposa" | "raydium" | "restake" | "rockaway-x" | "saga-dao" | "sec3" | "sendai" | "sensei-node" | "sentinel" | "shinobi" | "shiro" | "sol-rain-drops" | "sol-strategies" | "solana" | "solana-compass" | "solana-japan" | "solayer" | "solflare" | "solstack" | "solstice" | "solyrae" | "somos" | "squads-validator" | "stachenode" | "stakecraft" | "stakefish" | "stakely" | "stakin-the-tie" | "stakr-space" | "stardust" | "starke-finance" | "step-finance" | "stronghold" | "superfast" | "swyke" | "temporal" | "temporal-opal" | "the-vault" | "theia-capital" | "thw" | "tinydancer" | "triton-one" | "twinstake" | "txtx" | "unruggable" | "upbit-staking" | "valid-blocks" | "validation-cloud" | "valigator" | "vladika" | "vybe-network" | "watchtower" | "xandeum";
+declare const validators: {
+    [key in ValidatorId]: Validator;
+};
+declare const ALLOWED_VALIDATORS: {
+    name: string;
+    symbol: string;
+    vote_account: string;
+    pt_sol: string;
+    rt_sol: string;
+    is_allowed: boolean;
+    type: "validator" | "lst";
+    id: ValidatorId;
+}[];
+
+interface Maturity {
+    human_readable: string;
+    month: string;
+    year: string;
+    issuance_start_timestamp: string;
+    issuance_close_timestamp: string;
+    maturity_timestamp: string;
+}
+type MaturityId = "q12026" | "q22026" | "q32026" | "q42026";
+declare const maturities: {
+    [key in MaturityId]: Maturity;
+};
+declare const maturitiesArray: Maturity[];
+declare const maturityIdsArray: MaturityId[];
+declare const getMaturity: (maturityId: MaturityId) => Maturity;
+
 interface Bond {
     pubkey: string;
     pt_address: string;
@@ -75,6 +115,9 @@ declare function fetchUserStakeAccounts(connection: Connection, owner: PublicKey
 declare function fetchBalances(connection: Connection, owner: PublicKey): Promise<Record<string, number>>;
 declare function fetchBalancesForMints(connection: Connection, owner: PublicKey, mints: string[]): Promise<Record<string, number>>;
 
+declare function readCachedWalletBalances(publicKey: string): Balances | null;
+declare function writeCachedWalletBalances(publicKey: string, balances: Balances): void;
+
 interface ExchangeBalancesResult {
     exchangeBalances: Record<string, number>;
     openOrdersBalances: Record<string, number>;
@@ -137,6 +180,48 @@ declare function checkBuyLiquidity(asks: IndividualOrder[], orderSizeTokens: num
  */
 declare function checkSellLiquidity(bids: IndividualOrder[], orderSizeTokens: number): LiquidityCheck;
 
+/**
+ * Stable error codes for Sell-Yield gating. Surface these in support messages
+ * and telemetry. Format: PYE-<DOMAIN>-<CONDITION>.
+ */
+declare const SELL_YIELD_CODES: {
+    readonly VALIDATOR_NOT_CONFIGURED: "PYE-VALIDATOR-NOT-CONFIGURED";
+    readonly VALIDATOR_WIDGET_DISABLED: "PYE-VALIDATOR-WIDGET-DISABLED";
+    readonly VALIDATOR_ALT_MISSING: "PYE-VALIDATOR-ALT-MISSING";
+    readonly BOND_MISSING: "PYE-BOND-MISSING";
+    readonly BOND_NOT_STANDARD: "PYE-BOND-NOT-STANDARD";
+    readonly MARKET_MISSING: "PYE-MARKET-MISSING";
+    readonly LIQUIDITY_INSUFFICIENT: "PYE-LIQUIDITY-INSUFFICIENT";
+};
+type SellYieldCode = (typeof SELL_YIELD_CODES)[keyof typeof SELL_YIELD_CODES];
+type SellYieldStatus = {
+    ok: true;
+} | {
+    ok: false;
+    code: SellYieldCode;
+    reason: string;
+};
+interface CanSellYieldParams {
+    validatorVoteAccount: string;
+    maturityId: MaturityId;
+    amountSol: number;
+    nowTs: number;
+    validators: Record<string, ValidatorRow>;
+    bonds: Record<string, BondRow>;
+    markets: Record<string, MatchedMarket>;
+}
+/**
+ * Single source of truth for "can the user sell yield on this (stake, maturity)?".
+ * Returns the first failure reason in priority order (validator → bond → market →
+ * liquidity) so the caller can show one clear message rather than a stack of them.
+ */
+declare function canSellYield(params: CanSellYieldParams): SellYieldStatus;
+/**
+ * Lighter check used by screens that only know the validator (Welcome, Select
+ * Position). Catches cases 1 + 2 from the gating audit.
+ */
+declare function validatorAvailability(voteAccount: string, validators: Record<string, ValidatorRow>): SellYieldStatus;
+
 /**
  * Returns a UNIX-seconds "now" adjusted so that it aligns with the cluster's
  * perceived epoch-start boundary. The Bonds program mints RT proportional to
@@ -314,4 +399,4 @@ interface ExecuteRedeemResult {
 }
 declare function executeRedeem({ connection, wallet, bondPubkey, principalTokenMint, yieldTokenMint, ptAmountLamports, rtAmountLamports, }: ExecuteRedeemParams): Promise<ExecuteRedeemResult>;
 
-export { type Bond, type BondPayment, type EstimateRtFromStakeParams, type ExchangeBalancesResult, type ExecuteCancelOrderParams, type ExecuteCancelOrderResult, type ExecuteDepositAndSellParams, type ExecuteDepositAndSellResult, type ExecuteLimitOrderParams, type ExecuteLimitOrderResult, type ExecuteRedeemParams, type ExecuteRedeemResult, type ExecuteRtSellParams, type ExecuteRtSellResult, type ExecuteStakeAccountDepositParams, type ExecuteStakeDepositParams, type ExecuteStakeDepositResult, type ExecuteSwapParams, type ExecuteSwapResult, IndividualOrder, type LiquidityCheck, type LockupMetrics, MatchedMarket, Maturity, MaturityId, OpenOrder, PYE_TRADING_FEE_BPS, PYE_TREASURY_WALLET, type PtLookupEntry, type PyeSDKConfig, type RewardBreakdown, type Token, type TokenId, type TvlSnapshot, UserStakeAccount, ValidatorId, allTokenAddresses, allowedLockups, applyTradingFee, buildPtLookup, calculateFeeLamports, checkBuyLiquidity, checkSellLiquidity, configurePyeSDK, estimateRtFromStake, executeCancelOrder, executeDepositAndSell, executeLimitOrder, executeRedeem, executeRtSell, executeStakeAccountDeposit, executeStakeDeposit, executeSwap, fetchBalances, fetchBalancesForMints, fetchEpochSyncedNowTs, fetchExchangeBalances, fetchLockupMetrics, fetchUserStakeAccounts, getPyeConfig, lockups, lookupBondByVoteAccount, tokenIdsArray, tokens };
+export { ALLOWED_VALIDATORS, Balances, type Bond, type BondPayment, BondRow, type CanSellYieldParams, type EstimateRtFromStakeParams, type ExchangeBalancesResult, type ExecuteCancelOrderParams, type ExecuteCancelOrderResult, type ExecuteDepositAndSellParams, type ExecuteDepositAndSellResult, type ExecuteLimitOrderParams, type ExecuteLimitOrderResult, type ExecuteRedeemParams, type ExecuteRedeemResult, type ExecuteRtSellParams, type ExecuteRtSellResult, type ExecuteStakeAccountDepositParams, type ExecuteStakeDepositParams, type ExecuteStakeDepositResult, type ExecuteSwapParams, type ExecuteSwapResult, IndividualOrder, type LiquidityCheck, type LockupMetrics, MatchedMarket, type Maturity, type MaturityId, OpenOrder, PYE_TRADING_FEE_BPS, PYE_TREASURY_WALLET, type PtLookupEntry, type PyeSDKConfig, type RewardBreakdown, SELL_YIELD_CODES, type SellYieldCode, type SellYieldStatus, type Token, type TokenId, type TvlSnapshot, UserStakeAccount, type Validator, type ValidatorId, ValidatorRow, allTokenAddresses, allowedLockups, applyTradingFee, buildPtLookup, calculateFeeLamports, canSellYield, checkBuyLiquidity, checkSellLiquidity, configurePyeSDK, estimateRtFromStake, executeCancelOrder, executeDepositAndSell, executeLimitOrder, executeRedeem, executeRtSell, executeStakeAccountDeposit, executeStakeDeposit, executeSwap, fetchBalances, fetchBalancesForMints, fetchEpochSyncedNowTs, fetchExchangeBalances, fetchLockupMetrics, fetchUserStakeAccounts, getMaturity, getPyeConfig, lockups, lookupBondByVoteAccount, maturities, maturitiesArray, maturityIdsArray, readCachedWalletBalances, tokenIdsArray, tokens, validatorAvailability, validators, writeCachedWalletBalances };

package/dist/index.js

@@ -8,7 +8,9 @@ import {
   configurePyeSDK,
   createApyStore,
   createBalanceStore,
+  createLockupStore,
   createMarketStore,
+  createValidatorStore,
   createWalletStore,
   fetchBalances,
   fetchBalancesForMints,
@@ -23,10 +25,16 @@ import {
   maturitiesArray,
   maturityIdsArray,
   parseOrderBook,
+  readCachedWalletBalances,
+  selectBond,
+  selectBondsForValidator,
+  selectWidgetValidator,
+  selectWidgetValidators,
   tokenIdsArray,
   tokens,
-  validators
-} from "./chunk-2NO7PNVV.js";
+  validators,
+  writeCachedWalletBalances
+} from "./chunk-GXXXUTDQ.js";
 
 // src/constants/fees.ts
 import { PublicKey } from "@solana/web3.js";
@@ -242,6 +250,98 @@ function estimateRtFromStake({
   return amountSol * (remaining / total);
 }
 
+// src/lib/can-sell-yield.ts
+var SELL_YIELD_CODES = {
+  VALIDATOR_NOT_CONFIGURED: "PYE-VALIDATOR-NOT-CONFIGURED",
+  VALIDATOR_WIDGET_DISABLED: "PYE-VALIDATOR-WIDGET-DISABLED",
+  VALIDATOR_ALT_MISSING: "PYE-VALIDATOR-ALT-MISSING",
+  BOND_MISSING: "PYE-BOND-MISSING",
+  BOND_NOT_STANDARD: "PYE-BOND-NOT-STANDARD",
+  MARKET_MISSING: "PYE-MARKET-MISSING",
+  LIQUIDITY_INSUFFICIENT: "PYE-LIQUIDITY-INSUFFICIENT"
+};
+function canSellYield(params) {
+  var _a;
+  const validator = params.validators[params.validatorVoteAccount];
+  if (!validator) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.VALIDATOR_NOT_CONFIGURED,
+      reason: "This validator isn't configured in Pye's metadata yet."
+    };
+  }
+  if (validator.widget !== true) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.VALIDATOR_WIDGET_DISABLED,
+      reason: "Sell Yield isn't enabled for this validator yet."
+    };
+  }
+  if (!validator.alt_pubkey) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.VALIDATOR_ALT_MISSING,
+      reason: "Setup pending \u2014 Pye hasn't deployed an Address Lookup Table for this validator yet."
+    };
+  }
+  const bond = params.bonds[`${params.validatorVoteAccount}:${params.maturityId}`];
+  if (!bond) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.BOND_MISSING,
+      reason: "No bond exists for this validator at this maturity yet."
+    };
+  }
+  if (bond.standard !== true) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.BOND_NOT_STANDARD,
+      reason: "Setup pending \u2014 this maturity's bond hasn't been promoted to standard yet."
+    };
+  }
+  const market = params.markets[`${params.validatorVoteAccount}-${params.maturityId}-RT`];
+  if (!market) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.MARKET_MISSING,
+      reason: "No RT market exists for this validator at this maturity yet."
+    };
+  }
+  const maturity = maturities[params.maturityId];
+  const estimatedRt = estimateRtFromStake({
+    amountSol: params.amountSol,
+    maturity,
+    nowTs: params.nowTs
+  });
+  const liquidity = ((_a = market.bids) == null ? void 0 : _a.length) ? checkSellLiquidity(market.bids, estimatedRt) : null;
+  if (!(liquidity == null ? void 0 : liquidity.isSufficientLiquidity)) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.LIQUIDITY_INSUFFICIENT,
+      reason: "The order book doesn't have enough bids to fill this amount yet."
+    };
+  }
+  return { ok: true };
+}
+function validatorAvailability(voteAccount, validators2) {
+  const v = validators2[voteAccount];
+  if (!v) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.VALIDATOR_NOT_CONFIGURED,
+      reason: "This validator isn't configured in Pye's metadata yet."
+    };
+  }
+  if (v.widget !== true) {
+    return {
+      ok: false,
+      code: SELL_YIELD_CODES.VALIDATOR_WIDGET_DISABLED,
+      reason: "Sell Yield isn't enabled for this validator yet."
+    };
+  }
+  return { ok: true };
+}
+
 // src/lib/execute-stake-deposit.ts
 import {
   ComputeBudgetProgram,
@@ -1296,18 +1396,22 @@ export {
   ALLOWED_VALIDATORS,
   PYE_TRADING_FEE_BPS,
   PYE_TREASURY_WALLET,
+  SELL_YIELD_CODES,
   allTokenAddresses,
   allowedLockups,
   applyTradingFee,
   buildMarketLookup,
   buildPtLookup,
   calculateFeeLamports,
+  canSellYield,
   checkBuyLiquidity,
   checkSellLiquidity,
   configurePyeSDK,
   createApyStore,
   createBalanceStore,
+  createLockupStore,
   createMarketStore,
+  createValidatorStore,
   createWalletStore,
   estimateRtFromStake,
   executeCancelOrder,
@@ -1333,8 +1437,15 @@ export {
   maturitiesArray,
   maturityIdsArray,
   parseOrderBook,
+  readCachedWalletBalances,
+  selectBond,
+  selectBondsForValidator,
+  selectWidgetValidator,
+  selectWidgetValidators,
   tokenIdsArray,
   tokens,
-  validators
+  validatorAvailability,
+  validators,
+  writeCachedWalletBalances
 };
 //# sourceMappingURL=index.js.map