@wireio/stake 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@wireio/stake",
-    "version": "0.2.2",
+    "version": "0.2.4",
     "description": "LIQ Staking Module for Wire Network",
     "homepage": "https://gitea.gitgo.app/Wire/sdk-stake",
     "license": "FSL-1.1-Apache-2.0",

package/src/assets/solana/idl/liqsol_core.json

@@ -1,5 +1,5 @@
 {
-  "address": "HR3t8mA25TdJpwLph2h2L7KhK7ynWoAByYYzgUAfd5rk",
+  "address": "BBkVcNWNQz1vZ6esv5US4QnNFWPRqxWbdpJHur9GVXSu",
   "metadata": {
     "name": "liqsol_core",
     "version": "0.1.0",
@@ -3151,58 +3151,8 @@
   "errors": [
     {
       "code": 6000,
-      "name": "NoRewardsToClaim",
-      "msg": "No rewards to claim"
-    },
-    {
-      "code": 6001,
-      "name": "InsufficientBalance",
-      "msg": "Insufficient balance"
-    },
-    {
-      "code": 6002,
-      "name": "InsufficientFunds",
-      "msg": "Insufficient funds"
-    },
-    {
-      "code": 6003,
-      "name": "Unauthorized",
-      "msg": "Unauthorized - caller is not the distribution authority"
-    },
-    {
-      "code": 6004,
-      "name": "InvalidMint",
-      "msg": "Invalid mint"
-    },
-    {
-      "code": 6005,
-      "name": "InvalidOwner",
-      "msg": "Invalid owner"
-    },
-    {
-      "code": 6006,
-      "name": "InvalidUserRecord",
-      "msg": "Invalid user record"
-    },
-    {
-      "code": 6007,
-      "name": "InvalidWithdrawal",
-      "msg": "Invalid withdrawal - balance increased instead of decreased"
-    },
-    {
-      "code": 6008,
-      "name": "InvalidProgramId",
-      "msg": "Invalid program ID"
-    },
-    {
-      "code": 6009,
-      "name": "InstructionIntrospectionFailed",
-      "msg": "Instruction introspection failed"
-    },
-    {
-      "code": 6010,
-      "name": "ReceiptFulfilled",
-      "msg": "Receipt already fulfilled"
+      "name": "AccountBorrowFailed",
+      "msg": "Util Acc borrow Failed"
     }
   ],
   "types": [

package/src/assets/solana/idl/liqsol_token.json

@@ -1,5 +1,5 @@
 {
-  "address": "HEAKvfg2X7K4zbGDiAbfuu5abxQyk1HbKVgskZZFXrUx",
+  "address": "6cDoerqdV6UQDsGvUEq5Qj5HRxxyDxSuUaB2J6iK8cio",
   "metadata": {
     "name": "liqsol_token",
     "version": "0.1.0",

package/src/assets/solana/idl/validator_leaderboard.json

@@ -1,5 +1,5 @@
 {
-  "address": "BcMW7wN54FexYaB7Xujvag5uUQ1WoDoGbzVg1VEXPBhV",
+  "address": "C4ddPrB1ALYpW4G1Qz4ffvETBA8YGUL7TVZaLiE6bb1q",
   "metadata": {
     "name": "validator_leaderboard",
     "version": "0.1.0",

package/src/assets/solana/types/liqsol_core.ts

@@ -5,7 +5,7 @@
  * IDL can be found at `target/idl/liqsol_core.json`.
  */
 export type LiqsolCore = {
-  "address": "HR3t8mA25TdJpwLph2h2L7KhK7ynWoAByYYzgUAfd5rk",
+  "address": "BBkVcNWNQz1vZ6esv5US4QnNFWPRqxWbdpJHur9GVXSu",
   "metadata": {
     "name": "liqsolCore",
     "version": "0.1.0",
@@ -3157,58 +3157,8 @@ export type LiqsolCore = {
   "errors": [
     {
       "code": 6000,
-      "name": "noRewardsToClaim",
-      "msg": "No rewards to claim"
-    },
-    {
-      "code": 6001,
-      "name": "insufficientBalance",
-      "msg": "Insufficient balance"
-    },
-    {
-      "code": 6002,
-      "name": "insufficientFunds",
-      "msg": "Insufficient funds"
-    },
-    {
-      "code": 6003,
-      "name": "unauthorized",
-      "msg": "Unauthorized - caller is not the distribution authority"
-    },
-    {
-      "code": 6004,
-      "name": "invalidMint",
-      "msg": "Invalid mint"
-    },
-    {
-      "code": 6005,
-      "name": "invalidOwner",
-      "msg": "Invalid owner"
-    },
-    {
-      "code": 6006,
-      "name": "invalidUserRecord",
-      "msg": "Invalid user record"
-    },
-    {
-      "code": 6007,
-      "name": "invalidWithdrawal",
-      "msg": "Invalid withdrawal - balance increased instead of decreased"
-    },
-    {
-      "code": 6008,
-      "name": "invalidProgramId",
-      "msg": "Invalid program ID"
-    },
-    {
-      "code": 6009,
-      "name": "instructionIntrospectionFailed",
-      "msg": "Instruction introspection failed"
-    },
-    {
-      "code": 6010,
-      "name": "receiptFulfilled",
-      "msg": "Receipt already fulfilled"
+      "name": "accountBorrowFailed",
+      "msg": "Util Acc borrow Failed"
     }
   ],
   "types": [

package/src/assets/solana/types/liqsol_token.ts

@@ -5,7 +5,7 @@
  * IDL can be found at `target/idl/liqsol_token.json`.
  */
 export type LiqsolToken = {
-  "address": "HEAKvfg2X7K4zbGDiAbfuu5abxQyk1HbKVgskZZFXrUx",
+  "address": "6cDoerqdV6UQDsGvUEq5Qj5HRxxyDxSuUaB2J6iK8cio",
   "metadata": {
     "name": "liqsolToken",
     "version": "0.1.0",

package/src/assets/solana/types/validator_leaderboard.ts

@@ -5,7 +5,7 @@
  * IDL can be found at `target/idl/validator_leaderboard.json`.
  */
 export type ValidatorLeaderboard = {
-  "address": "BcMW7wN54FexYaB7Xujvag5uUQ1WoDoGbzVg1VEXPBhV",
+  "address": "C4ddPrB1ALYpW4G1Qz4ffvETBA8YGUL7TVZaLiE6bb1q",
   "metadata": {
     "name": "validatorLeaderboard",
     "version": "0.1.0",

package/src/index.ts

@@ -1,6 +1,6 @@
 // Staker utilities
-export * from './staker/staker';
-export * from './staker/types';
+export * from './staker';
+export * from './types';
 
 // NETWORKS
 export * from './networks/ethereum/ethereum';
@@ -16,4 +16,5 @@ export * from './networks/solana/utils';
 export * from './networks/solana/clients/deposit.client';
 export * from './networks/solana/clients/distribution.client';
 export * from './networks/solana/clients/leaderboard.client';
-export * from './networks/solana/clients/outpost.client';
+export * from './networks/solana/clients/outpost.client';
+export * from './networks/solana/clients/token.client';

package/src/networks/ethereum/ethereum.ts

@@ -1,5 +1,5 @@
 import { BigNumber, ethers } from 'ethers';
-import { IStakingClient, Portfolio, StakerConfig } from '../../staker/types';
+import { IStakingClient, Portfolio, PurchaseAsset, PurchaseQuote, StakerConfig, TrancheSnapshot } from '../../types';
 import { PublicKey as WirePubKey } from '@wireio/core';
 import { EthereumContractService } from './contract';
 import { preLaunchReceipt, WithdrawRequestedEvent, WithdrawResult } from './types';
@@ -114,6 +114,16 @@ export class EthereumStakingClient implements IStakingClient {
         }
     }
 
+    // TODO
+    buy(amount: bigint, purchaseAsset: PurchaseAsset): Promise<string> {
+        throw new Error("Method not yet implemented.");
+    }
+
+    // TODO
+    getBuyQuote(amount: bigint, purchaseAsset: PurchaseAsset): Promise<PurchaseQuote> {
+        throw new Error("Method not yet implemented.");
+    }
+
     
     /**
      * Resolve the user's ETH + liqETH balances.
@@ -161,12 +171,26 @@ export class EthereumStakingClient implements IStakingClient {
                 decimals: nativeDecimals,
                 symbol: liqSymbol,
             },
+            wire: {
+                amount: BigInt(0), // TODO
+                decimals: 0,
+                symbol: '$WIRE',
+            },
             chainID: this.network.chainId
         }
         // console.log('ETH PORTFOLIO', portfolio);
         return portfolio;
     }
 
+    /**
+     * Program-level prelaunch WIRE / tranche snapshot for Solana.
+     * Uses the same OutpostWireStateSnapshot primitive as getPortfolio().
+     * TODO! for eth
+     */
+    async getTrancheSnapshot(): Promise<TrancheSnapshot | null> {
+        return null
+    }
+
     
     // ---------------------------------------------------------------------
     // Internal ETH Staking client helper functions

package/src/networks/ethereum/types.ts

@@ -1,5 +1,5 @@
 import { BigNumber, ethers } from 'ethers';
-import { BalanceView } from '../../staker/types';
+import { BalanceView } from '../../types';
 
 export const CONTRACT_NAMES = [
     'Accounting',

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

@@ -0,0 +1,225 @@
+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, buildSolanaTrancheSnapshot } from '../utils';
+import { SolanaProgramService } from '../program';
+import { LiqsolCore } from '../../../assets/solana/types/liqsol_core';
+import {
+    GlobalState,
+    PriceHistory,
+    TrancheState,
+    UserWarrantRecord,
+    WalletLike,
+    WireReceipt,
+} from '../types';
+import { derivePriceHistoryPda } from '../constants';
+import type { } from '../types';
+import { ChainID, SolChainID } from '@wireio/core';
+import { PurchaseAsset, PurchaseQuote, TrancheSnapshot } from '../../../types';
+
+export class TokenClient {
+    private readonly program: Program<LiqsolCore>;
+
+    get wallet(): WalletLike {
+        return this.provider.wallet;
+    }
+
+    constructor(private readonly provider: AnchorProvider) {
+        const svc = new SolanaProgramService(provider);
+        this.program = svc.getProgram('liqsolCore');
+    }
+
+    // ---------------------------------------------------------------------------
+    // Account helpers
+    // ---------------------------------------------------------------------------
+
+    async getAccounts(user: PublicKey): Promise<OutpostAccounts> {
+        return buildOutpostAccounts(this.provider.connection, user);
+    }
+
+    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);
+    }
+
+    async fetchWireReceipt(user: PublicKey): Promise<WireReceipt> {
+        const { wireReceipt } = await this.getAccounts(user);
+        return this.program.account.wireReceipt.fetch(wireReceipt);
+    }
+
+    async fetchUserWarrantRecord(user: PublicKey): Promise<UserWarrantRecord> {
+        const { userWarrantRecord } = await this.getAccounts(user);
+        return this.program.account.userWarrantRecord.fetch(userWarrantRecord);
+    }
+
+    // ---------------------------------------------------------------------------
+    // Tranche snapshot / quoting
+    // ---------------------------------------------------------------------------
+
+    // ---------------------------------------------------------------------------
+    // Instruction builders (no send / confirm)
+    // ---------------------------------------------------------------------------
+
+    async buildPurchaseWithSolIx(
+        amountLamports: bigint,
+        user = this.wallet.publicKey,
+    ): Promise<TransactionInstruction> {
+        const a = await this.getAccounts(user);
+
+        return this.program.methods
+            .purchaseWithSol(new BN(amountLamports.toString()))
+            .accounts({
+                user: a.user,
+                liqsolMint: a.liqsolMint,
+                globalState: a.globalState,
+
+                poolAuthority: a.poolAuthority,
+                liqsolPoolAta: a.liqsolPoolAta,
+                liqsolPoolUserRecord: a.poolUserRecord,
+                distributionState: a.distributionState,
+                payRateHistory: a.payRateHistory,
+                bucketAuthority: a.bucketAuthority,
+                bucketTokenAccount: a.bucketTokenAccount,
+                solBucket: a.solBucket,
+
+                // IDL name is warrantDepositRecord (wireReceipt PDA)
+                warrantDepositRecord: a.wireReceipt,
+
+                trancheState: a.trancheState,
+                userWarrantRecord: a.userWarrantRecord,
+
+                chainlinkFeed: a.chainLinkFeed,
+                chainlinkProgram: a.chainLinkProgram,
+
+                tokenProgram: TOKEN_2022_PROGRAM_ID,
+                systemProgram: SystemProgram.programId,
+            })
+            .instruction();
+    }
+
+    async buildPurchaseWithLiqsolIx(
+        amountLamports: bigint,
+        user = this.wallet.publicKey,
+    ): Promise<TransactionInstruction> {
+        const a = await this.getAccounts(user);
+
+        return this.program.methods
+            .purchaseWithLiqsol(new BN(amountLamports.toString()))
+            .accounts({
+                user: a.user,
+                liqsolMint: a.liqsolMint,
+                globalState: a.globalState,
+
+                buyerAta: a.userAta,
+                poolAuthority: a.poolAuthority,
+                liqsolPoolAta: a.liqsolPoolAta,
+
+                warrantDepositRecord: a.wireReceipt,
+
+                liqsolPoolUserRecord: a.poolUserRecord,
+                distributionState: a.distributionState,
+                payRateHistory: a.payRateHistory,
+                bucketAuthority: a.bucketAuthority,
+                bucketTokenAccount: a.bucketTokenAccount,
+                solBucket: a.solBucket,
+
+                trancheState: a.trancheState,
+                userWarrantRecord: a.userWarrantRecord,
+
+                chainlinkFeed: a.chainLinkFeed,
+                chainlinkProgram: a.chainLinkProgram,
+
+                tokenProgram: TOKEN_2022_PROGRAM_ID,
+                associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+                systemProgram: SystemProgram.programId,
+            })
+            .instruction();
+    }
+
+    async buildPurchaseFromYieldIx(
+        user = this.wallet.publicKey,
+    ): Promise<TransactionInstruction> {
+        const a = await this.getAccounts(user);
+
+        return this.program.methods
+            .purchaseWarrantsFromYield()
+            .accounts({
+                user: a.user,
+                globalState: a.globalState,
+                liqsolMint: a.liqsolMint,
+                poolAuthority: a.poolAuthority,
+                liqsolPoolAta: a.liqsolPoolAta,
+                solBucket: a.solBucket,
+
+                liqsolPoolUserRecord: a.poolUserRecord,
+                distributionState: a.distributionState,
+                payRateHistory: a.payRateHistory,
+                bucketAuthority: a.bucketAuthority,
+                bucketTokenAccount: a.bucketTokenAccount,
+
+                trancheState: a.trancheState,
+                userWarrantRecord: a.userWarrantRecord,
+                chainlinkFeed: a.chainLinkFeed,
+                chainlinkProgram: a.chainLinkProgram,
+
+                tokenProgram: TOKEN_2022_PROGRAM_ID,
+                systemProgram: SystemProgram.programId,
+            })
+            .instruction();
+    }
+
+    // ---------------------------------------------------------------------------
+    // 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 earlier SDK code.
+     */
+    async getSolPriceUsd(): Promise<bigint> {
+        const priceHistoryPda = 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

@@ -74,6 +74,9 @@ export const PDA_SEEDS = {
     BAR_STATE_SEED: 'bar_state',
     BONDED_ACTOR_SEED: 'bonded_actor',
     BOND_LEVEL_SEED: 'bond_level',
+
+    // Other?
+    PRICE_HISTORY: 'price_history',
 } as const;
 
 /**
@@ -232,6 +235,12 @@ export const deriveBondedActorPda = (actor: PublicKey) =>
         LIQSOL_CORE,
     )[0];
 
+export const derivePriceHistoryPda = () =>
+    PublicKey.findProgramAddressSync(
+        [Buffer.from(PDA_SEEDS.PRICE_HISTORY)],
+        LIQSOL_CORE,
+    )[0];
+
 /**
  * Ephemeral stake account address used per-deposit.
  * On-chain convention: seed = `ephemeral_<u32>` under StakeProgram.programId.