@wireio/stake 1.1.0 → 1.2.69

package/src/networks/solana/constants.ts

@@ -1,40 +1,62 @@
 // src/networks/solana/constants.ts
 import { PublicKey, StakeProgram } from '@solana/web3.js';
+import { SolChainID } from '@wireio/core';
 
-import liqsolCoreIDL from '../../assets/solana/idl/liqsol_core.json';
-import liqSolTokenIDL from '../../assets/solana/idl/liqsol_token.json';
-import validatorLeaderboardIDL from '../../assets/solana/idl/validator_leaderboard.json';
-import transferHookIDL from '../../assets/solana/idl/transfer_hook.json';
+import mainnetLiqsolCoreIDL from '../../assets/solana/mainnet/idl/liqsol_core.json';
+import mainnetLiqSolTokenIDL from '../../assets/solana/mainnet/idl/liqsol_token.json';
+import mainnetValidatorLeaderboardIDL from '../../assets/solana/mainnet/idl/validator_leaderboard.json';
+import mainnetTransferHookIDL from '../../assets/solana/mainnet/idl/transfer_hook.json';
+
+import devnetLiqsolCoreIDL from '../../assets/solana/devnet/idl/liqsol_core.json';
+import devnetLiqSolTokenIDL from '../../assets/solana/devnet/idl/liqsol_token.json';
+import devnetValidatorLeaderboardIDL from '../../assets/solana/devnet/idl/validator_leaderboard.json';
+import devnetTransferHookIDL from '../../assets/solana/devnet/idl/transfer_hook.json';
+import { SupportedSolChainID } from '../../types';
 
 /**
- * ---------------------------------------------------------------------------
- *  PROGRAM IDS
- * ---------------------------------------------------------------------------
- *
- * These should match:
- *  - `metadata.address` in your Anchor IDLs under src/assets/solana/idl/*.json
- *  - The program IDs printed by your deploy scripts
+ * Per-chain program IDs (NOT global anymore).
  */
-export const PROGRAM_IDS = {
-    LIQSOL_CORE: new PublicKey(liqsolCoreIDL.address),
-    LIQSOL_TOKEN: new PublicKey(liqSolTokenIDL.address),
-    VALIDATOR_LEADERBOARD: new PublicKey(validatorLeaderboardIDL.address),
-    TRANSFER_HOOK: new PublicKey(transferHookIDL.address),
-} as const;
+export type SolanaProgramIds = {
+    LIQSOL_CORE: PublicKey;
+    LIQSOL_TOKEN: PublicKey;
+    VALIDATOR_LEADERBOARD: PublicKey;
+    TRANSFER_HOOK: PublicKey;
+    ALT: PublicKey;
+};
 
-export const {
-    LIQSOL_CORE,
-    LIQSOL_TOKEN,
-    VALIDATOR_LEADERBOARD,
-    TRANSFER_HOOK,
-} = PROGRAM_IDS;
+const MAINNET_PROGRAM_IDS: SolanaProgramIds = {
+    LIQSOL_CORE: new PublicKey(mainnetLiqsolCoreIDL.address),
+    LIQSOL_TOKEN: new PublicKey(mainnetLiqSolTokenIDL.address),
+    VALIDATOR_LEADERBOARD: new PublicKey(mainnetValidatorLeaderboardIDL.address),
+    TRANSFER_HOOK: new PublicKey(mainnetTransferHookIDL.address),
+    ALT: new PublicKey("AQXTHwkdNBEiXeQuVA5uCoxvzgYUmudRxthQY4vWKCPS")
+};
+
+const DEVNET_PROGRAM_IDS: SolanaProgramIds = {
+    LIQSOL_CORE: new PublicKey(devnetLiqsolCoreIDL.address),
+    LIQSOL_TOKEN: new PublicKey(devnetLiqSolTokenIDL.address),
+    VALIDATOR_LEADERBOARD: new PublicKey(devnetValidatorLeaderboardIDL.address),
+    TRANSFER_HOOK: new PublicKey(devnetTransferHookIDL.address),
+    ALT: new PublicKey("3dm6p83nqBTLnbJBFEfbHJ988y6cfKtrGSoKJbGD3hqp")
+};
+
+export const PROGRAM_IDS_BY_CHAIN: Record<SupportedSolChainID, SolanaProgramIds> = {
+    [SolChainID.Mainnet]: MAINNET_PROGRAM_IDS,
+    [SolChainID.Devnet]: DEVNET_PROGRAM_IDS,
+    ['devnet-wire' as any]: DEVNET_PROGRAM_IDS,
+};
+
+export const getProgramIds = (chainId: SolChainID): SolanaProgramIds => {
+    const ids = PROGRAM_IDS_BY_CHAIN[chainId];
+    if (!ids) throw new Error(`Unsupported Solana chainId=${chainId}`);
+    return ids;
+};
 
 /**
  * ---------------------------------------------------------------------------
  *  PDA SEEDS (must match on-chain programs)
  * ---------------------------------------------------------------------------
  */
-
 export const PDA_SEEDS = {
     // GLOBAL CONFIG
     GLOBAL_CONFIG: 'global_config',
@@ -53,7 +75,6 @@ export const PDA_SEEDS = {
 
     // distribution program (embedded in liqsol_core)
     DISTRIBUTION_STATE: 'distribution_state',
-    // NOTE: in the current IDL, userRecord is keyed by the USER (wallet), not ATA
     USER_RECORD: 'user_record',
 
     // pay-rate / price history
@@ -89,259 +110,21 @@ export const PDA_SEEDS = {
     MINT_METADATA: 'mint_metadata',
     LIQ_RECEIPT_DATA: 'liq_receipt_data',
     WITHDRAW_MINT: 'mint',
-} as const;
-
-// Global Config PDA
-export const deriveGlobalConfigPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.GLOBAL_CONFIG)],
-        LIQSOL_CORE,
-    )[0];
-
-
-/**
- * ---------------------------------------------------------------------------
- *  CORE / DISTRIBUTION / DEPOSIT PDAS
- * ---------------------------------------------------------------------------
- */
-
-export const deriveLiqsolMintPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQSOL_MINT)],
-        LIQSOL_TOKEN,
-    )[0];
-
-export const deriveLiqsolMintAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQSOL_MINT_AUTHORITY)],
-        LIQSOL_TOKEN,
-    )[0];
-
-export const deriveDepositAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.DEPOSIT_AUTHORITY)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveVaultPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VAULT)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveReservePoolPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.RESERVE_POOL)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveStakeControllerStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.STAKE_CONTROLLER_STATE)],
-        LIQSOL_CORE,
-    )[0];
-
-export const derivePayoutStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.PAYOUT_STATE)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveBucketAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.BUCKET_AUTHORITY)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveDistributionStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.DISTRIBUTION_STATE)],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * user_record PDA
- *
- * In the current liqsol_core IDL, this is keyed by USER (wallet),
- * not by token account.
- */
-export const deriveUserRecordPda = (user: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.USER_RECORD), user.toBuffer()],
-        LIQSOL_CORE,
-    )[0];
-
-export const derivePayRateHistoryPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.PAY_RATE_HISTORY)],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * ---------------------------------------------------------------------------
- *  WITHDRAW MODULE / RECEIPTS
- * ---------------------------------------------------------------------------
- */
-
-export const deriveWithdrawGlobalPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.WITHDRAW_GLOBAL)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveStakeAllocationStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.STAKE_ALLOCATION_STATE)],
-        LIQSOL_CORE,
-    )[0];
 
-export const deriveStakeMetricsPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.STAKE_METRICS)],
-        LIQSOL_CORE,
-    )[0];
+    // New
+    PRETOKEN_PURCHASE_HISTORY: 'pretoken_purchase_history',
 
-export const deriveMaintenanceLedgerPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.MAINTENANCE_LEDGER)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveWithdrawMintAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.WITHDRAW_MINT_AUTHORITY)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveWithdrawMintMetadataPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.MINT_METADATA)],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * NFT mint for withdrawal receipt, derived from nextReceiptId.
- */
-export const deriveWithdrawNftMintPda = (receiptId: bigint | number) => {
-    const receiptIdBytes = Buffer.alloc(8);
-    // receiptId comes in as BN or bigint upstream → normalize
-    const asBigInt =
-        typeof receiptId === 'bigint'
-            ? receiptId
-            : BigInt(receiptId.toString());
-    receiptIdBytes.writeBigUInt64LE(asBigInt);
-    return PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.WITHDRAW_MINT), receiptIdBytes],
-        LIQSOL_CORE,
-    )[0];
-};
-
-export const deriveLiqReceiptDataPda = (nftMint: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQ_RECEIPT_DATA), nftMint.toBuffer()],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * ---------------------------------------------------------------------------
- *  VALIDATOR LEADERBOARD
- * ---------------------------------------------------------------------------
- */
-
-export const deriveLeaderboardStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LEADERBOARD_STATE)],
-        VALIDATOR_LEADERBOARD,
-    )[0];
-
-export const deriveValidatorRecordPda = (voteAccount: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VALIDATOR_RECORD), voteAccount.toBuffer()],
-        VALIDATOR_LEADERBOARD,
-    )[0];
-
-export const deriveStakeControllerVaultPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VAULT)],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * ---------------------------------------------------------------------------
- *  OUTPOST / PRETOKENS
- * ---------------------------------------------------------------------------
- */
-
-export const deriveOutpostGlobalStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.OUTPOST_GLOBAL_STATE)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveOutpostPoolAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQSOL_POOL)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveOutpostAccountPda = (user: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.OUTPOST_ACCOUNT), user.toBuffer()],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveUserPretokenRecordPda = (user: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.USER_PRETOKEN_RECORD), user.toBuffer()],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveTrancheStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.TRANCHE_STATE)],
-        LIQSOL_CORE,
-    )[0];
-
-export const derivePriceHistoryPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.PRICE_HISTORY)],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * BAR (bonded actor roles)
- */
-
-export const deriveBarConfigPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.BAR_STATE_SEED)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveBondLevelPda = (bondLevelId: number[]) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.BOND_LEVEL_SEED), Buffer.from(bondLevelId)],
-        LIQSOL_CORE,
-    )[0];
-
-export const deriveBondedActorPda = (actor: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.BONDED_ACTOR_SEED), actor.toBuffer()],
-        LIQSOL_CORE,
-    )[0];
-
-/**
- * SPL Transfer-hook: extra-account-metas PDA for the liqSOL mint.
- */
-export const deriveExtraAccountMetaListPda = (liqsolMint: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.EXTRA_ACCOUNT_METAS), liqsolMint.toBuffer()],
-        PROGRAM_IDS.TRANSFER_HOOK,
-    )[0];
+    // OPP (outpost protocol pipeline)
+    OPP_EPOCH_STATE: 'opp_epoch_state',
+    PENDING_ATTESTATIONS: 'pending_attestations',
+    EPOCH_HEADER: 'epoch_header',
+    EPOCH_MESSAGE: 'epoch_message',
+    OPP_BRIDGE_STATE: 'opp_bridge_state',
+} as const;
 
 /**
- * Ephemeral stake account address used per-deposit.
- * On-chain convention: seed = `ephemeral_<u32>` under StakeProgram.programId.
+ * Ephemeral stake account address seed helper
+ * (this one really is global & chain-agnostic).
  */
 export const deriveEphemeralStakeAddress = async (
     user: PublicKey,
@@ -366,26 +149,16 @@ export const CHAINLINK_PROGRAM = new PublicKey(
  *  ECONOMICS & MATH CONSTANTS
  * ---------------------------------------------------------------------------
  */
-
-// Same scale factor used on-chain for pay-rate math
 export const PAY_RATE_SCALE_FACTOR = BigInt(1_000_000_000_000); // 10^12
-
-// Default pay rate fallback used in tests & utils
 export const DEFAULT_AVERAGE_PAY_RATE = BigInt(191_780_821);
-
-// How many history entries to average when computing expected fee
 export const DEFAULT_PAY_RATE_LOOKBACK = 5;
-
-// Rent exemption for ephemeral stake account (lamports)
 export const EPHEMERAL_RENT_EXEMPTION = 2_282_880;
 
-// For convenience: lamports <-> SOL helpers (no RPC dependency)
 export const LAMPORTS_PER_SOL = 1_000_000_000;
-
 export const INDEX_SCALE = BigInt(1_000_000_000_000); // 1e12
 
 export const lamportsToSol = (lamports: number | bigint): number =>
     Number(lamports) / LAMPORTS_PER_SOL;
 
 export const solToLamports = (sol: number): bigint =>
-    BigInt(Math.round(sol * LAMPORTS_PER_SOL));
+    BigInt(Math.round(sol * LAMPORTS_PER_SOL));