@wireio/stake 0.4.3 → 0.4.69

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

@@ -1,12 +1,7 @@
 import { AnchorProvider, Program } from '@coral-xyz/anchor';
 import { PublicKey } from '@solana/web3.js';
 
-import { SolanaProgramService } from '../program';
-import type { ValidatorLeaderboard } from '../../../assets/solana/types/validator_leaderboard';
-import {
-    deriveLeaderboardStatePda,
-    deriveValidatorRecordPda,
-} from '../constants';
+import { SolanaProgramService, ValidatorLeaderboardClientIdl } from '../program';
 import { LeaderboardState, ValidatorRecord } from '../types';
 
 /**
@@ -15,15 +10,17 @@ import { LeaderboardState, ValidatorRecord } from '../types';
  * Adjust account names/fields to match your IDL (state, validatorRecord, etc).
  */
 export class LeaderboardClient {
-    private program: Program<ValidatorLeaderboard>;
+    private program: Program<ValidatorLeaderboardClientIdl>;
 
-    constructor(private provider: AnchorProvider) {
-        const svc = new SolanaProgramService(provider);
-        this.program = svc.getProgram('validatorLeaderboard');
+    constructor(
+        private readonly provider: AnchorProvider,
+        private readonly pgs: SolanaProgramService
+    ) {
+        this.program = pgs.getProgram('validatorLeaderboard');
     }
 
     async getState(): Promise<LeaderboardState | null> {
-        const pda = deriveLeaderboardStatePda();
+        const pda = this.pgs.deriveLeaderboardStatePda();
         try {
             // Assumes account name "leaderboardState"
             return await this.program.account.leaderboardState.fetch(pda);
@@ -33,7 +30,7 @@ export class LeaderboardClient {
     }
 
     async getValidatorRecord(voteAccount: PublicKey): Promise<ValidatorRecord | null> {
-        const pda = deriveValidatorRecordPda(voteAccount);
+        const pda = this.pgs.deriveValidatorRecordPda(voteAccount);
         try {
             // Assumes account name "validatorRecord"
             return await this.program.account.validatorRecord.fetchNullable(pda);
@@ -57,7 +54,7 @@ export class LeaderboardClient {
     async getTopValidators(limit = 20): Promise<ValidatorRecord[]> {
         // Try to use the leaderboard state first
         try {
-            const leaderboardPda = deriveLeaderboardStatePda();
+            const leaderboardPda = this.pgs.deriveLeaderboardStatePda();
             const leaderboard: LeaderboardState 
                 = await this.program.account.leaderboardState.fetch(leaderboardPda);
 

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

@@ -9,12 +9,10 @@ import {
     TOKEN_2022_PROGRAM_ID,
 } from '@solana/spl-token';
 
-import liqsolCoreIDL from '../../../assets/solana/idl/liqsol_core.json';
-import { LiqsolCore } from '../../../assets/solana/types/liqsol_core';
-
 import {
     OutpostAccounts,
     buildOutpostAccounts,
+    safeFetch,
 } from '../utils';
 
 import {
@@ -23,7 +21,8 @@ import {
     TrancheState,
     WalletLike,
 } from '../types';
-import { INDEX_SCALE, PROGRAM_IDS } from '../constants';
+import { INDEX_SCALE } from '../constants';
+import { LiqsolCoreClientIdl, SolanaProgramService } from '../program';
 
 /**
  * OutpostClient
@@ -41,12 +40,13 @@ import { INDEX_SCALE, PROGRAM_IDS } from '../constants';
  * in sync with the on-chain PDAs and capital-staking Wire utils.
  */
 export class OutpostClient {
-    private readonly program: Program<LiqsolCore>;
+    private readonly program: Program<LiqsolCoreClientIdl>;
 
     constructor(
         private readonly provider: AnchorProvider,
+        private readonly pgs: SolanaProgramService,
     ) {
-        this.program = new Program(liqsolCoreIDL as any, provider);
+        this.program = pgs.getProgram('liqsolCore');
     }
 
     get connection() {
@@ -57,14 +57,6 @@ export class OutpostClient {
         return this.provider.wallet as unknown as WalletLike;
     }
 
-    /**
-     * Expose the raw Program in case callers need to build custom
-     * instructions outside this client.
-     */
-    get liqsolCoreProgram(): Program<LiqsolCore> {
-        return this.program;
-    }
-
     /**
      * Build all outpost-related PDAs / ATAs for a given user.
      * Defaults to the connected wallet.
@@ -74,18 +66,44 @@ export class OutpostClient {
         if (!userPk) {
             throw new Error('OutpostClient.buildAccounts: wallet not connected');
         }
-        return buildOutpostAccounts(this.connection, userPk);
+        return buildOutpostAccounts(this.connection, userPk, this.pgs);
     }
 
     /**
      * Internal helper: get raw token balance (BN) for a given ATA.
      */
     private async getTokenBalance(ata: PublicKey): Promise<BN> {
+        const bal = await this.connection.getTokenAccountBalance(ata);
+        return new BN(bal.value.amount);
+    }
+
+    /**
+     * Fetch an OutpostAccount, handling legacy accounts that pre-date the
+     * three trailing Option<u64> fields.  If the normal decode throws a
+     * RangeError we re-fetch the raw data, pad it to the expected size
+     * (zeros → Option::None for each missing field), and let Anchor's
+     * coder decode the padded buffer.
+     */
+    private async fetchOutpostAccount(address: PublicKey) {
         try {
-            const bal = await this.connection.getTokenAccountBalance(ata);
-            return new BN(bal.value.amount);
-        } catch {
-            return new BN(0);
+            return await this.program.account.outpostAccount.fetchNullable(address);
+        } catch (e) {
+            if (!(e instanceof RangeError)) throw e;
+
+            const info = await this.connection.getAccountInfo(address);
+            if (!info) return null;
+
+            // 3 × Option<u64> encoded as 1-byte tag (0x00 = None) = 3 bytes
+            // when present (Some) each is 9 bytes, but None is just 0x00
+            const EXPECTED_SIZE = info.data.length + 3;
+            const padded = Buffer.alloc(EXPECTED_SIZE);
+            info.data.copy(padded);
+            // trailing bytes are already 0x00 → Option::None for each field
+
+            return this.program.coder.accounts.decode(
+                'outpostAccount',
+                padded,
+            );
         }
     }
 
@@ -94,29 +112,25 @@ export class OutpostClient {
      */
     async fetchWireState(user?: PublicKey): Promise<OutpostWireStateSnapshot> {
         const userPk = user ?? this.wallet.publicKey;
-        if (!userPk) {
-            throw new Error('OutpostClient.fetchWireState: wallet not connected');
-        }
+        if (!userPk) throw new Error('OutpostClient.fetchWireState: wallet not connected');
 
         const pdas = await this.buildAccounts(userPk);
-
         const [
             globalState,
             outpostAccount,
             distributionState,
             userPretokenRecord,
             trancheState,
+            liqsolPoolBalance,
+            userLiqsolBalance,
         ] = await Promise.all([
-            this.program.account.globalState.fetch(pdas.globalState),
-            this.program.account.outpostAccount.fetchNullable(pdas.outpostAccount),
-            this.program.account.distributionState.fetchNullable(pdas.distributionState),
-            this.program.account.userPretokenRecord.fetchNullable(pdas.userPretokenRecord),
-            this.program.account.trancheState.fetchNullable(pdas.trancheState),
-        ]);
-
-        const [liqsolPoolBalance, userLiqsolBalance] = await Promise.all([
-            this.getTokenBalance(pdas.liqsolPoolAta),
-            this.getTokenBalance(pdas.userAta),
+            safeFetch(this.program.account.globalState.fetch(pdas.globalState), 'globalState'),
+            safeFetch(this.fetchOutpostAccount(pdas.outpostAccount), 'outpostAccount'),
+            safeFetch(this.program.account.distributionState.fetchNullable(pdas.distributionState), 'distributionState'),
+            safeFetch(this.program.account.userPretokenRecord.fetchNullable(pdas.userPretokenRecord), 'userPretokenRecord'),
+            safeFetch(this.program.account.trancheState.fetchNullable(pdas.trancheState), 'trancheState'),
+            safeFetch(this.getTokenBalance(pdas.liqsolPoolAta), 'liqsolPoolAta'),
+            safeFetch(this.getTokenBalance(pdas.userAta), 'userAta'),
         ]);
 
         return {
@@ -130,54 +144,73 @@ export class OutpostClient {
         };
     }
 
+
+
     // -------------------------------------------------------------------------
-    // Outpost stake / unstake builders (synd / desynd)
+    // Outpost stake / unstake builders (syndicate_liqsol_to_wire / desynd)
     // -------------------------------------------------------------------------
 
     /**
-     * Build the `synd` (stake) instruction:
-     *   user liqSOL ATA → liqSOL pool ATA
+     * Build the `syndicate_liqsol_to_wire` (stake) instruction:
+     *   user liqSOL ATA → liqSOL pool ATA, bridged to the Wire chain.
+     *
+     * @param amountLamports  Amount of liqSOL to stake (in lamports / base units).
+     * @param user            Solana signer. Defaults to the connected wallet.
+     * @param wireAccount     Wire chain recipient account name. Required.
      */
     async buildStakeIx(
         amountLamports: bigint,
-        user?: PublicKey,
+        user: PublicKey = this.wallet.publicKey,
+        wireAccount?: string,
     ): Promise<TransactionInstruction> {
-        const userPk = user ?? this.wallet.publicKey;
-        if (!userPk) {
+        if (!user) {
             throw new Error('OutpostClient.buildStakeIx: wallet not connected');
         }
+        if (!wireAccount?.trim()) {
+            throw new Error('OutpostClient.buildStakeIx: wireAccount is required');
+        }
 
-        const a = await this.buildAccounts(userPk);
+        const a = await this.buildAccounts(user);
 
         return this.program.methods
-            .synd(new BN(amountLamports.toString()))
+            .syndicateLiqsolToWire(wireAccount.trim(), new BN(amountLamports.toString()))
             .accounts({
-                user: userPk,
+                user,
                 liqsolMint: a.liqsolMint,
-                globalState: a.globalState,
                 distributionState: a.distributionState,
+                globalState: a.globalState,
                 userAta: a.userAta,
+                senderUserRecord: a.userUserRecord,
                 poolAuthority: a.poolAuthority,
+                liqsolPoolAta: a.liqsolPoolAta,
+                poolUserRecord: a.liqsolPoolUserRecord,
+                bridgeState: a.bridgeState,
+                extraAccountMetaList: a.extraAccountMetaList,
+                liqsolCoreProgram: this.pgs.PROGRAM_IDS.LIQSOL_CORE,
+                transferHookProgram: this.pgs.PROGRAM_IDS.TRANSFER_HOOK,
                 bucketAuthority: a.bucketAuthority,
                 bucketTokenAccount: a.bucketTokenAccount,
                 bucketUserRecord: a.bucketUserRecord,
-                senderUserRecord: a.userUserRecord,
-                receiverUserRecord: a.liqsolPoolUserRecord,
-                extraAccountMetaList: a.extraAccountMetaList,
-                liqsolCoreProgram: PROGRAM_IDS.LIQSOL_CORE,
-                transferHookProgram: PROGRAM_IDS.TRANSFER_HOOK,
-                liqsolPoolAta: a.liqsolPoolAta,
-                outpostAccount: a.outpostAccount,
                 tokenProgram: TOKEN_2022_PROGRAM_ID,
                 associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
                 systemProgram: SystemProgram.programId,
+                globalConfig: a.globalConfig,
+                oppEpochState: a.oppEpochState,
+                pendingAttestations: a.pendingAttestations,
             })
             .instruction();
     }
 
     /**
-     * Build the `desynd` (unstake) instruction:
+     * Build the `desynd` (unstake / desync) instruction:
      *   liqSOL pool ATA → user liqSOL ATA
+     *
+     * When Wire is in PostLaunch mode this instruction emits a `DesyncRequest`
+     * OPP attestation and does NOT immediately return tokens.  The Wire chain
+     * relay picks up the attestation, and an admin subsequently executes
+     * `complete_withdraw` to deliver the tokens to the user.
+     *
+     * In PreLaunch mode the tokens are returned directly.
      */
     async buildUnstakeIx(
         amountLamports: bigint,
@@ -205,12 +238,17 @@ export class OutpostClient {
                 senderUserRecord: a.liqsolPoolUserRecord,
                 receiverUserRecord: a.userUserRecord,
                 extraAccountMetaList: a.extraAccountMetaList,
-                liqsolCoreProgram: PROGRAM_IDS.LIQSOL_CORE,
-                transferHookProgram: PROGRAM_IDS.TRANSFER_HOOK,
+                liqsolCoreProgram: this.pgs.PROGRAM_IDS.LIQSOL_CORE,
+                transferHookProgram: this.pgs.PROGRAM_IDS.TRANSFER_HOOK,
                 liqsolPoolAta: a.liqsolPoolAta,
                 outpostAccount: a.outpostAccount,
                 tokenProgram: TOKEN_2022_PROGRAM_ID,
                 systemProgram: SystemProgram.programId,
+                associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+                globalConfig: a.globalConfig,
+                oppEpochState: a.oppEpochState,
+                pendingAttestations: a.pendingAttestations,
+                pretokenPurchaseHistory: a.pretokenPurchaseHistory,
             })
             .instruction();
     }
@@ -271,7 +309,7 @@ export class OutpostClient {
      *   if remainder > 0 → shares + 1
      */
     static tokensToShares(amount: BN, currentIndex: BN): BN {
-        const numerator = amount.mul(INDEX_SCALE);
+        const numerator = amount.mul(new BN(INDEX_SCALE));
         const shares = numerator.div(currentIndex);
         const remainder = numerator.mod(currentIndex);
         return remainder.eqn(0) ? shares : shares.addn(1);
@@ -300,4 +338,4 @@ export class OutpostClient {
         const decPart = valueStr.slice(valueStr.length - decimals);
         return `${intPart}.${decPart}`;
     }
-}
+}

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

@@ -11,8 +11,7 @@ import {
     type OutpostAccounts,
 } from '../utils';
 
-import { SolanaProgramService } from '../program';
-import type { LiqsolCore } from '../../../assets/solana/types/liqsol_core';
+import { LiqsolCoreClientIdl, SolanaProgramService } from '../program';
 
 import {
     GlobalState,
@@ -24,16 +23,12 @@ import {
 } from '../types';
 
 import {
-    derivePriceHistoryPda,
     CHAINLINK_FEED,
     CHAINLINK_PROGRAM,
-    PROGRAM_IDS,
-    deriveExtraAccountMetaListPda,
 } from '../constants';
 
-
 export class TokenClient {
-    private readonly program: Program<LiqsolCore>;
+    private readonly program: Program<LiqsolCoreClientIdl>;
 
     get wallet(): WalletLike {
         return this.provider.wallet;
@@ -43,9 +38,11 @@ export class TokenClient {
         return this.provider.connection;
     }
 
-    constructor(private readonly provider: AnchorProvider) {
-        const svc = new SolanaProgramService(provider);
-        this.program = svc.getProgram('liqsolCore');
+    constructor(
+        private readonly provider: AnchorProvider,
+        private readonly pgs: SolanaProgramService
+    ) {
+        this.program = pgs.getProgram('liqsolCore');
     }
 
     // ---------------------------------------------------------------------------
@@ -53,7 +50,7 @@ export class TokenClient {
     // ---------------------------------------------------------------------------
 
     async getAccounts(user: PublicKey): Promise<OutpostAccounts> {
-        return buildOutpostAccounts(this.provider.connection, user);
+        return buildOutpostAccounts(this.provider.connection, user, this.pgs);
     }
 
     async fetchGlobalState(): Promise<GlobalState> {
@@ -102,11 +99,13 @@ export class TokenClient {
         amountLamports: bigint,
         user = this.wallet.publicKey,
     ): Promise<TransactionInstruction> {
+        console.log('build purchase for', user.toBase58());
+        
         const a = await this.getAccounts(user);
 
-        const extraAccountMetaList = deriveExtraAccountMetaListPda(a.liqsolMint);
-        const liqsolCoreProgram = PROGRAM_IDS.LIQSOL_CORE;
-        const transferHookProgram = PROGRAM_IDS.TRANSFER_HOOK;
+        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()))
@@ -147,6 +146,12 @@ export class TokenClient {
                 tokenProgram: TOKEN_2022_PROGRAM_ID,
                 associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
                 systemProgram: SystemProgram.programId,
+
+                pretokenPurchaseHistory: a.pretokenPurchaseHistory,
+
+                globalConfig: a.globalConfig,
+                oppEpochState: a.oppEpochState, 
+                pendingAttestations: a.pendingAttestations
             })
             .instruction();
     }
@@ -177,7 +182,7 @@ export class TokenClient {
      * Uses the ring-buffer semantics from capital-staking.
      */
     async getSolPriceUsd(): Promise<bigint> {
-        const priceHistoryPda = derivePriceHistoryPda();
+        const priceHistoryPda = this.pgs.derivePriceHistoryPda();
         const history = (await this.program.account.priceHistory.fetch(
             priceHistoryPda,
         )) as PriceHistory;