@wireio/stake 0.1.3 → 0.1.69

package/src/networks/solana/constants.ts

@@ -1,49 +1,71 @@
 // 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 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).
  */
-// Extract program IDs from IDL files
-export const PROGRAM_IDS = {
-    LIQSOL_CORE: new PublicKey(liqsolCoreIDL.address),
-    LIQSOL_TOKEN: new PublicKey(liqSolTokenIDL.address),
-    VALIDATOR_LEADERBOARD: new PublicKey(validatorLeaderboardIDL.address),
-} as const;
+export type SolanaProgramIds = {
+    LIQSOL_CORE: PublicKey;
+    LIQSOL_TOKEN: PublicKey;
+    VALIDATOR_LEADERBOARD: PublicKey;
+    TRANSFER_HOOK: PublicKey;
+    ALT: PublicKey;
+};
 
-// Export individual program IDs for convenience
-export const {
-    LIQSOL_CORE,
-    LIQSOL_TOKEN,
-    VALIDATOR_LEADERBOARD,
-} = 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("AZQmTbacBuAsJpncg2N2AwcZsLG1Sxeohbau9vjezmTz")
+};
+
+export const PROGRAM_IDS_BY_CHAIN: Record<SupportedSolChainID, SolanaProgramIds> = {
+    [SolChainID.Mainnet]: MAINNET_PROGRAM_IDS,
+    [SolChainID.Devnet]: 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)
  * ---------------------------------------------------------------------------
- *
- * These strings are baked into the on-chain programs and are already used in
- * your test utils. We centralize them here so all clients share them.
  */
-
 export const PDA_SEEDS = {
+    // GLOBAL CONFIG
+    GLOBAL_CONFIG: 'global_config',
+
     // liqsol_core: deposit / stake controller
     DEPOSIT_AUTHORITY: 'deposit_authority',
     VAULT: 'vault',
     RESERVE_POOL: 'reserve_pool',
     STAKE_CONTROLLER_STATE: 'stake_controller',
-    PAYOUT_STATE: 'payout-state',
+    PAYOUT_STATE: 'payout_state',
 
     // liqsol_token: mint + bucket
     LIQSOL_MINT: 'liqsol_mint',
@@ -54,189 +76,86 @@ export const PDA_SEEDS = {
     DISTRIBUTION_STATE: 'distribution_state',
     USER_RECORD: 'user_record',
 
-    // pay-rate history
+    // pay-rate / price history
     PAY_RATE_HISTORY: 'pay_rate_history',
+    PRICE_HISTORY: 'price_history',
 
     // validator leaderboard (state + records)
     LEADERBOARD_STATE: 'leaderboard_state',
     VALIDATOR_RECORD: 'validator',
     GLOBAL_STAKE_INFO: 'global_stake_info',
-} as const;
-
-/**
- * Helpers for PDA derivation so clients don’t duplicate logic.
- */
-
-export const deriveLiqsolMintPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQSOL_MINT)],
-        PROGRAM_IDS.LIQSOL_TOKEN,
-    )[0];
-
-export const deriveLiqsolMintAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LIQSOL_MINT_AUTHORITY)],
-        PROGRAM_IDS.LIQSOL_TOKEN,
-    )[0];
-
-export const deriveDepositAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.DEPOSIT_AUTHORITY)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveVaultPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VAULT)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveReservePoolPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.RESERVE_POOL)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveStakeControllerStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.STAKE_CONTROLLER_STATE)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const derivePayoutStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.PAYOUT_STATE)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveBucketAuthorityPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.BUCKET_AUTHORITY)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveDistributionStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.DISTRIBUTION_STATE)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const deriveUserRecordPda = (user: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.USER_RECORD), user.toBuffer()],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-export const derivePayRateHistoryPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.PAY_RATE_HISTORY)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
-
-// export const deriveGlobalStakeInfoPda = () =>
-//     PublicKey.findProgramAddressSync(
-//         [Buffer.from(PDA_SEEDS.GLOBAL_STAKE_INFO)],
-//         PROGRAM_IDS.LIQSOL_CORE,
-//     )[0];
-
-export const deriveLeaderboardStatePda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.LEADERBOARD_STATE)],
-        PROGRAM_IDS.VALIDATOR_LEADERBOARD,
-    )[0];
-
-export const deriveValidatorRecordPda = (voteAccount: PublicKey) =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VALIDATOR_RECORD), voteAccount.toBuffer()],
-        PROGRAM_IDS.VALIDATOR_LEADERBOARD,
-    )[0];
 
-/**
-* Stake controller vault PDA (reserve pool SOL vault).
-* This is the same as VAULT, but named more explicitly for SDK callers.
-*/
-export const deriveStakeControllerVaultPda = () =>
-    PublicKey.findProgramAddressSync(
-        [Buffer.from(PDA_SEEDS.VAULT)],
-        PROGRAM_IDS.LIQSOL_CORE,
-    )[0];
+    // Outpost / Wire pretokens
+    OUTPOST_GLOBAL_STATE: 'outpost_global_state',
+    LIQSOL_POOL: 'liqsol_pool',
+    OUTPOST_ACCOUNT: 'outpost_account',
+    USER_PRETOKEN_RECORD: 'user_pretoken_record',
+    TRANCHE_STATE: 'tranche_state',
+
+    // BAR module (bonded actor roles)
+    BAR_STATE_SEED: 'bar_state',
+    BONDED_ACTOR_SEED: 'bonded_actor',
+    BOND_LEVEL_SEED: 'bond_level',
+
+    // SPL transfer-hook extra account metas
+    EXTRA_ACCOUNT_METAS: 'extra-account-metas',
+
+    // Withdraw module / receipts
+    WITHDRAW_GLOBAL: 'global',
+    STAKE_ALLOCATION_STATE: 'stake_allocation_state',
+    STAKE_METRICS: 'stake_metrics',
+    MAINTENANCE_LEDGER: 'maintenance_ledger',
+    WITHDRAW_MINT_AUTHORITY: 'mint_authority',
+    MINT_METADATA: 'mint_metadata',
+    LIQ_RECEIPT_DATA: 'liq_receipt_data',
+    WITHDRAW_MINT: 'mint',
+
+    // New
+    PRETOKEN_PURCHASE_HISTORY: 'pretoken_purchase_history',
+
+    // OPP (outpost protocol pipeline)
+    OPP_EPOCH_STATE: 'opp_epoch_state',
+    PENDING_ATTESTATIONS: 'pending_attestations',
+    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,
-    seed: any,
+    seed: number,
 ): Promise<PublicKey> => {
     const seedStr = `ephemeral_${seed}`;
-    return await PublicKey.createWithSeed(user, seedStr, StakeProgram.programId);
+    return PublicKey.createWithSeed(user, seedStr, StakeProgram.programId);
 };
 
-
+/**
+ * Constant keys (Chainlink)
+ */
+export const CHAINLINK_FEED = new PublicKey(
+    'CH31Xns5z3M1cTAbKW34jcxPPciazARpijcHj9rxtemt',
+);
+export const CHAINLINK_PROGRAM = new PublicKey(
+    'HEvSKofvBgfaexv23kMabbYqxasxU3mQ4ibBMEmJWHny',
+);
 
 /**
  * ---------------------------------------------------------------------------
  *  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)
-// Mirrors EPHEMERAL_RENT_EXEMPTION = 2_282_880 used in tests
 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): number =>
-    Math.round(sol * LAMPORTS_PER_SOL);
-
-/**
- * ---------------------------------------------------------------------------
- *  CLUSTER / ENVIRONMENT CONFIG (optional but handy)
- * ---------------------------------------------------------------------------
- */
-
-export type SolanaCluster = 'localnet' | 'devnet' | 'mainnet';
-
-// export interface SolanaStakeProgramAddresses {
-//     liqsolCore: PublicKey;
-//     liqsolToken: PublicKey;
-//     validatorLeaderboard: PublicKey;
-// }
-
-// export const PROGRAMS_BY_CLUSTER: Record<SolanaCluster, SolanaStakeProgramAddresses> = {
-//     localnet: {
-//         liqsolCore: PROGRAM_IDS.LIQSOL_CORE,
-//         liqsolToken: PROGRAM_IDS.LIQSOL_TOKEN,
-//         validatorLeaderboard: PROGRAM_IDS.VALIDATOR_LEADERBOARD,
-//     },
-//     devnet: {
-//         liqsolCore: PROGRAM_IDS.LIQSOL_CORE,
-//         liqsolToken: PROGRAM_IDS.LIQSOL_TOKEN,
-//         validatorLeaderboard: PROGRAM_IDS.VALIDATOR_LEADERBOARD,
-//     },
-//     mainnet: {
-//         liqsolCore: PROGRAM_IDS.LIQSOL_CORE,
-//         liqsolToken: PROGRAM_IDS.LIQSOL_TOKEN,
-//         validatorLeaderboard: PROGRAM_IDS.VALIDATOR_LEADERBOARD,
-//     },
-// };
-
-// export const DEFAULT_CLUSTER: SolanaCluster = 'localnet';
-
-// export function getProgramIds(cluster: SolanaCluster = DEFAULT_CLUSTER): SolanaStakeProgramAddresses {
-//     return PROGRAMS_BY_CLUSTER[cluster];
-// }
+export const solToLamports = (sol: number): bigint =>
+    BigInt(Math.round(sol * LAMPORTS_PER_SOL));