@wireio/stake 0.0.5 → 0.0.69

package/src/networks/solana/clients/token.client.ts

@@ -0,0 +1,210 @@
+import { AnchorProvider, BN, Program } from '@coral-xyz/anchor';
+import type { TransactionInstruction, Connection } from '@solana/web3.js';
+import { PublicKey, SystemProgram } from '@solana/web3.js';
+import {
+    TOKEN_2022_PROGRAM_ID,
+    ASSOCIATED_TOKEN_PROGRAM_ID,
+} from '@solana/spl-token';
+
+import {
+    buildOutpostAccounts,
+    type OutpostAccounts,
+} from '../utils';
+
+import { LiqsolCoreClientIdl, SolanaProgramService } from '../program';
+
+import {
+    GlobalState,
+    PriceHistory,
+    TrancheState,
+    WalletLike,
+    OutpostAccount,
+    UserPretokenRecord,
+} from '../types';
+
+import {
+    CHAINLINK_FEED,
+    CHAINLINK_PROGRAM,
+} from '../constants';
+
+export class TokenClient {
+    private readonly program: Program<LiqsolCoreClientIdl>;
+
+    get wallet(): WalletLike {
+        return this.provider.wallet;
+    }
+
+    get connection(): Connection {
+        return this.provider.connection;
+    }
+
+    constructor(
+        private readonly provider: AnchorProvider,
+        private readonly pgs: SolanaProgramService
+    ) {
+        this.program = pgs.getProgram('liqsolCore');
+    }
+
+    // ---------------------------------------------------------------------------
+    // Account helpers
+    // ---------------------------------------------------------------------------
+
+    async getAccounts(user: PublicKey): Promise<OutpostAccounts> {
+        return buildOutpostAccounts(this.provider.connection, user, this.pgs);
+    }
+
+    async fetchGlobalState(): Promise<GlobalState> {
+        const { globalState } = await this.getAccounts(this.wallet.publicKey);
+        return this.program.account.globalState.fetch(globalState);
+    }
+
+    async fetchTrancheState(): Promise<TrancheState> {
+        const { trancheState } = await this.getAccounts(this.wallet.publicKey);
+        return this.program.account.trancheState.fetch(trancheState);
+    }
+
+    /**
+     * Fetch the per-user Outpost account (old "wire receipt").
+     * Returns null if the user has never interacted with Outpost.
+     */
+    async fetchOutpostAccount(user: PublicKey): Promise<OutpostAccount | null> {
+        const { outpostAccount } = await this.getAccounts(user);
+        return this.program.account.outpostAccount.fetchNullable(outpostAccount);
+    }
+
+    /**
+     * Fetch the per-user pretoken purchase record.
+     * Returns null if the user has never purchased pretokens.
+     */
+    async fetchUserPretokenRecord(
+        user: PublicKey,
+    ): Promise<UserPretokenRecord | null> {
+        const { userPretokenRecord } = await this.getAccounts(user);
+        return this.program.account.userPretokenRecord.fetchNullable(
+            userPretokenRecord,
+        );
+    }
+
+    // ---------------------------------------------------------------------------
+    // Instruction builders (no send / confirm)
+    // ---------------------------------------------------------------------------
+
+    /**
+     * Build a pretoken `purchase` instruction using liqSOL from the user’s ATA.
+     *
+     * This mirrors capital-staking `executePurchase` wiring:
+     * - amountLamports: liqSOL amount (raw token-2022 units, not SOL)
+     */
+    async buildPurchaseIx(
+        amountLamports: bigint,
+        user = this.wallet.publicKey,
+    ): Promise<TransactionInstruction> {
+        console.log('build purchase for', user.toBase58());
+        
+        const a = await this.getAccounts(user);
+
+        const extraAccountMetaList = this.pgs.deriveExtraAccountMetaListPda(a.liqsolMint);
+        const liqsolCoreProgram = this.pgs.PROGRAM_IDS.LIQSOL_CORE;
+        const transferHookProgram = this.pgs.PROGRAM_IDS.TRANSFER_HOOK;
+
+        return this.program.methods
+            .purchase(new BN(amountLamports.toString()))
+            .accounts({
+                user: a.user,
+                liqsolMint: a.liqsolMint,
+                globalState: a.globalState,
+                distributionState: a.distributionState,
+
+                // buyer’s liqSOL
+                buyerAta: a.userAta,
+
+                // pool / bucket context
+                poolAuthority: a.poolAuthority,
+                bucketAuthority: a.bucketAuthority,
+                bucketTokenAccount: a.bucketTokenAccount,
+                bucketUserRecord: a.bucketUserRecord,
+
+                // distribution userRecords (token-account keyed)
+                senderUserRecord: a.userUserRecord,
+                receiverUserRecord: a.liqsolPoolUserRecord,
+
+                // transfer-hook wiring
+                extraAccountMetaList,
+                liqsolCoreProgram,
+                transferHookProgram,
+
+                // pool + outpost + tranche
+                liqsolPoolAta: a.liqsolPoolAta,
+                outpostAccount: a.outpostAccount,
+                trancheState: a.trancheState,
+                userPretokenRecord: a.userPretokenRecord,
+
+                // Chainlink pricing
+                chainlinkFeed: a.chainLinkFeed ?? CHAINLINK_FEED,
+                chainlinkProgram: a.chainLinkProgram ?? CHAINLINK_PROGRAM,
+
+                tokenProgram: TOKEN_2022_PROGRAM_ID,
+                associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+                systemProgram: SystemProgram.programId,
+
+                pretokenPurchaseHistory: a.pretokenPurchaseHistory,
+            } as any)
+            .instruction();
+    }
+
+    // NOTE:
+    // - There is no longer `purchaseWithSol` in the IDL - SOL → liqSOL happens
+    //   through the deposit / liqSOL minting path, not directly in pretokens.
+    // - `purchaseFromYield` is an operator-facing / protocol flow and you
+    //   indicated you’ll trigger it from Wire infra, so we don’t expose a
+    //   client helper here for now.
+
+    // ---------------------------------------------------------------------------
+    // Price helpers (SOL/USD via priceHistory account)
+    // ---------------------------------------------------------------------------
+
+    async getSolPriceUsdSafe(): Promise<{ price?: bigint; timestamp?: number }> {
+        try {
+            const price = await this.getSolPriceUsd();
+            // current priceHistory account has no timestamp; keep optional
+            return { price, timestamp: undefined };
+        } catch {
+            return { price: undefined, timestamp: undefined };
+        }
+    }
+
+    /**
+     * Fetch latest SOL/USD price (1e8 scale) from liqsol_core.priceHistory.
+     * Uses the ring-buffer semantics from capital-staking.
+     */
+    async getSolPriceUsd(): Promise<bigint> {
+        const priceHistoryPda = this.pgs.derivePriceHistoryPda();
+        const history = (await this.program.account.priceHistory.fetch(
+            priceHistoryPda,
+        )) as PriceHistory;
+
+        const { prices, nextIndex, count, windowSize } = history;
+
+        if (!prices || prices.length === 0 || !count) {
+            throw new Error('Price history is empty - no SOL price available');
+        }
+
+        const capacity = prices.length || windowSize;
+        if (!capacity) {
+            throw new Error(
+                'Price history capacity is zero - check account layout',
+            );
+        }
+
+        const lastIndex = nextIndex === 0 ? capacity - 1 : nextIndex - 1;
+        const latest = prices[lastIndex];
+
+        if (!BN.isBN(latest)) {
+            throw new Error(
+                'Latest price entry is not a BN - check IDL/decoder',
+            );
+        }
+
+        return BigInt(latest.toString());
+    }
+}

package/src/networks/solana/constants.ts

@@ -1,73 +1,156 @@
 // src/networks/solana/constants.ts
+import { PublicKey, StakeProgram } from '@solana/web3.js';
+import { SolChainID } from '@wireio/core';
 
-import { PublicKey } from '@solana/web3.js';
-import { TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID } from '@solana/spl-token';
-
-// — IDLs — (must match your filesystem: src/assets/solana/idl/*.json)
-import DepositIDL from '../../assets/solana/idl/deposit.json';
-import DistributionIDL from '../../assets/solana/idl/distribution.json';
-import LiqSolTokenIDL from '../../assets/solana/idl/liq_sol_token.json';
-import StakeControllerIDL from '../../assets/solana/idl/stake_controller.json';
-import StakeRegistryIDL from '../../assets/solana/idl/stake_registry.json';
-import TreasuryIDL from '../../assets/solana/idl/treasury.json';
-import ValidatorLeaderboardIDL from '../../assets/solana/idl/validator_leaderboard.json';
-import ValidatorRegistryIDL from '../../assets/solana/idl/validator_registry.json';
-import YieldOracleIDL from '../../assets/solana/idl/yield_oracle.json';
-
-// — Types — for your clients
-import type { Deposit } from '../../assets/solana/types/deposit';
-import type { Distribution } from '../../assets/solana/types/distribution';
-import type { ValidatorLeaderboard } from '../../assets/solana/types/validator_leaderboard';
-import type { LiqSolToken } from '../../assets/solana/types/liq_sol_token';
-import type { StakeController } from '../../assets/solana/types/stake_controller';
-import type { StakeRegistry } from '../../assets/solana/types/stake_registry';
-import type { Treasury } from '../../assets/solana/types/treasury';
-import type { ValidatorRegistry } from '../../assets/solana/types/validator_registry';
-import type { YieldOracle } from '../../assets/solana/types/yield_oracle';
-
-// Re-export for easy import elsewhere:
-export {
-    Deposit,
-    DepositIDL,
-    Distribution,
-    DistributionIDL,
-    LiqSolToken,
-    LiqSolTokenIDL,
-    StakeController,
-    StakeControllerIDL,
-    StakeRegistry,
-    StakeRegistryIDL,
-    Treasury,
-    TreasuryIDL,
-    ValidatorLeaderboard,
-    ValidatorLeaderboardIDL,
-    ValidatorRegistry,
-    ValidatorRegistryIDL,
-    YieldOracle,
-    YieldOracleIDL,
+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';
+
+/**
+ * Per-chain program IDs (NOT global anymore).
+ */
+export type SolanaProgramIds = {
+    LIQSOL_CORE: PublicKey;
+    LIQSOL_TOKEN: PublicKey;
+    VALIDATOR_LEADERBOARD: PublicKey;
+    TRANSFER_HOOK: PublicKey;
+    ALT: PublicKey;
+};
+
+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;
 };
 
-// — Program IDs — anchor “address” fields inside each IDL must match these:
-export const DEPOSIT_PROGRAM_ID = new PublicKey(DepositIDL.address);
-export const DISTRIBUTION_PROGRAM_ID = new PublicKey(DistributionIDL.address);
-export const LIQSOL_TOKEN_PROGRAM_ID = new PublicKey(LiqSolTokenIDL.address);
-export const STAKE_CONTROLLER_PROGRAM_ID = new PublicKey(StakeControllerIDL.address);
-export const STAKE_REGISTRY_PROGRAM_ID = new PublicKey(StakeRegistryIDL.address);
-export const TREASURY_PROGRAM_ID = new PublicKey(TreasuryIDL.address);
-export const VALIDATOR_LEADERBOARD_PROGRAM_ID = new PublicKey(ValidatorLeaderboardIDL.address);
-export const VALIDATOR_REGISTRY_PROGRAM_ID = new PublicKey(ValidatorRegistryIDL.address);
-export const YIELD_ORACLE_PROGRAM_ID = new PublicKey(YieldOracleIDL.address);
-
-// — Protocol constants — tweak as needed:
-export const MIN_SOL_TO_PARTICIPATE = 1_000_000_000;  // 1 SOL in lamports
-export const MIN_FUNDS_THRESHOLD = 10_000_000_000; // 10 SOL in lamports
-export const RESERVE_FOR_FEES = 1_000_000_000;  // 1 SOL
-
-// — Pre-derived PDA seeds for your convenience —  
-// (you can still use your utils.ts helpers instead)
-export const TREASURY_WALLET_PDA = new PublicKey('9gLj1MRrm66GNYqnMLPGUzyYqYJpVLQgFSbtCQV9Ta4G');
-export const LIQSOL_MINT_ADDRESS = new PublicKey('B2XtJABkc6eUoYUNgSfZVb3kYckmbh2zxp4rp2hX2Xwa');
-export const STAKE_VAULT_PDA = new PublicKey('AY83EfU5LXJGDhbLeP45H3tLKisGZgSe2G4mGYfPimqN');
-
-// re-export SPL token constants:
-export { TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID };
+/**
+ * ---------------------------------------------------------------------------
+ *  PDA SEEDS (must match on-chain programs)
+ * ---------------------------------------------------------------------------
+ */
+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',
+
+    // liqsol_token: mint + bucket
+    LIQSOL_MINT: 'liqsol_mint',
+    LIQSOL_MINT_AUTHORITY: 'mint_authority',
+    BUCKET_AUTHORITY: 'liqsol_bucket',
+
+    // distribution program (embedded in liqsol_core)
+    DISTRIBUTION_STATE: 'distribution_state',
+    USER_RECORD: 'user_record',
+
+    // 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',
+
+    // 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',
+} as const;
+
+/**
+ * Ephemeral stake account address seed helper
+ * (this one really is global & chain-agnostic).
+ */
+export const deriveEphemeralStakeAddress = async (
+    user: PublicKey,
+    seed: number,
+): Promise<PublicKey> => {
+    const seedStr = `ephemeral_${seed}`;
+    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
+ * ---------------------------------------------------------------------------
+ */
+export const PAY_RATE_SCALE_FACTOR = BigInt(1_000_000_000_000); // 10^12
+export const DEFAULT_AVERAGE_PAY_RATE = BigInt(191_780_821);
+export const DEFAULT_PAY_RATE_LOOKBACK = 5;
+export const EPHEMERAL_RENT_EXEMPTION = 2_282_880;
+
+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));