@jpool/bond-sdk 0.9.0-next.9 → 0.10.0

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 import { Fee } from '@solana/spl-stake-pool/src/layouts';
 import { PublicKey, TransactionInstruction, Connection, PublicKeyInitData, Transaction, VersionedTransaction, Keypair } from '@solana/web3.js';
-import BN from 'bn.js';
+import * as bn_js from 'bn.js';
+import bn_js__default from 'bn.js';
 import { IdlTypes, IdlAccounts, Program, Provider } from '@coral-xyz/anchor';
 
 type StakePoolManager = {
     stakePoolAddress: PublicKey;
-    depositSol: (lamports: BN) => TransactionInstruction;
-    withdrawSol: (poolTokens: BN) => TransactionInstruction;
+    depositSol: (lamports: bn_js__default) => TransactionInstruction;
+    withdrawSol: (poolTokens: bn_js__default) => TransactionInstruction;
     readonly exchangeRate: number;
     readonly withdrawSolFee: Fee;
 };
@@ -16,7 +17,7 @@ declare enum Seeds {
     GlobalState = "global_state",
     BondState = "bond_state",
     ValidatorBond = "validator_bond",
-    PerformanceBond = "performance",
+    StandardBond = "standard",
     CrowdFundingBond = "crowdfunding"
 }
 /**
@@ -31,7 +32,7 @@ declare const ENV_PROGRAM_ID: Record<string, PublicKey>;
  * IDL can be found at `target/idl/jbond.json`.
  */
 type Jbond = {
-    "address": "DBuUGWbLz8CkAMQiagMfrQzj8SSg1rHQJWrTSc97HWfR";
+    "address": "BondQ7KqZreTcW2UbeTNDcLCJQ3aXAtLn2Fm6ftaJDU";
     "metadata": {
         "name": "jbond";
         "version": "0.2.1";
@@ -208,10 +209,6 @@ type Jbond = {
                 210
             ];
             "accounts": [
-                {
-                    "name": "globalState";
-                    "writable": true;
-                },
                 {
                     "name": "bondState";
                     "writable": true;
@@ -744,9 +741,6 @@ type Jbond = {
         },
         {
             "name": "globalInitialize";
-            "docs": [
-                "----------------------------- Global Instructions ----------------------------"
-            ];
             "discriminator": [
                 30,
                 79,
@@ -795,6 +789,111 @@ type Jbond = {
             ];
             "args": [];
         },
+        {
+            "name": "migrateBond";
+            "docs": [
+                "Migrates validator bond data from legacy structure to new structure."
+            ];
+            "discriminator": [
+                107,
+                119,
+                59,
+                110,
+                76,
+                18,
+                37,
+                163
+            ];
+            "accounts": [
+                {
+                    "name": "bondState";
+                    "writable": true;
+                },
+                {
+                    "name": "legacyValidatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "legacyVoteAccount";
+                },
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    118,
+                                    97,
+                                    108,
+                                    105,
+                                    100,
+                                    97,
+                                    116,
+                                    111,
+                                    114,
+                                    95,
+                                    98,
+                                    111,
+                                    110,
+                                    100
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "bondState";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "legacyVoteAccount";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "creator";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "sessionFinish";
+            "docs": [
+                "Finishes a bond, preventing further deposits and withdrawals."
+            ];
+            "discriminator": [
+                230,
+                209,
+                54,
+                205,
+                127,
+                141,
+                137,
+                113
+            ];
+            "accounts": [
+                {
+                    "name": "bondState";
+                    "writable": true;
+                },
+                {
+                    "name": "authority";
+                    "writable": true;
+                    "signer": true;
+                    "relations": [
+                        "bondState"
+                    ];
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "sessionStart";
             "docs": [
@@ -1063,6 +1162,16 @@ type Jbond = {
             "code": 6021;
             "name": "invalidArgument";
             "msg": "Invalid argument provided";
+        },
+        {
+            "code": 6022;
+            "name": "bondNotDisabled";
+            "msg": "Bond is not disabled";
+        },
+        {
+            "code": 6023;
+            "name": "bondNotEnabled";
+            "msg": "Bond is not enabled";
         }
     ];
     "types": [
@@ -1071,6 +1180,16 @@ type Jbond = {
             "type": {
                 "kind": "struct";
                 "fields": [
+                    {
+                        "name": "status";
+                        "type": {
+                            "option": {
+                                "defined": {
+                                    "name": "bondStatus";
+                                };
+                            };
+                        };
+                    },
                     {
                         "name": "newReserve";
                         "type": {
@@ -1173,7 +1292,7 @@ type Jbond = {
                     {
                         "name": "bondType";
                         "docs": [
-                            "The type of bond (e.g., Performance, Crowdfunding)"
+                            "The type of bond (e.g., Standard, Crowdfunding)"
                         ];
                         "type": {
                             "defined": {
@@ -1241,6 +1360,17 @@ type Jbond = {
                         ];
                         "type": "i64";
                     },
+                    {
+                        "name": "status";
+                        "docs": [
+                            "Current status of the bond"
+                        ];
+                        "type": {
+                            "defined": {
+                                "name": "bondStatus";
+                            };
+                        };
+                    },
                     {
                         "name": "bump";
                         "docs": [
@@ -1251,6 +1381,20 @@ type Jbond = {
                 ];
             };
         },
+        {
+            "name": "bondStatus";
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "active";
+                    },
+                    {
+                        "name": "disabled";
+                    }
+                ];
+            };
+        },
         {
             "name": "bondType";
             "docs": [
@@ -1260,7 +1404,7 @@ type Jbond = {
                 "kind": "enum";
                 "variants": [
                     {
-                        "name": "performance";
+                        "name": "standard";
                     },
                     {
                         "name": "crowdfunding";
@@ -1386,15 +1530,6 @@ type Jbond = {
             "type": {
                 "kind": "struct";
                 "fields": [
-                    {
-                        "name": "bonds";
-                        "docs": [
-                            "List of all registered bonds"
-                        ];
-                        "type": {
-                            "vec": "pubkey";
-                        };
-                    },
                     {
                         "name": "authority";
                         "docs": [
@@ -1418,7 +1553,7 @@ type Jbond = {
                 "kind": "struct";
                 "fields": [
                     {
-                        "name": "bond";
+                        "name": "state";
                         "type": "pubkey";
                     },
                     {
@@ -1439,26 +1574,10 @@ type Jbond = {
                             "option": "pubkey";
                         };
                     },
-                    {
-                        "name": "totalCompensationAmount";
-                        "type": "u64";
-                    },
-                    {
-                        "name": "lastCompensationAmount";
-                        "type": "u64";
-                    },
-                    {
-                        "name": "lastCompensationEpoch";
-                        "type": "u64";
-                    },
                     {
                         "name": "createdAt";
                         "type": "i64";
                     },
-                    {
-                        "name": "isActive";
-                        "type": "bool";
-                    },
                     {
                         "name": "bump";
                         "type": "u8";
@@ -1504,18 +1623,23 @@ type BondState = IdlAccounts<Jbond>['bondState'];
 type ValidatorBond = IdlAccounts<Jbond>['validatorBond'];
 type BondType = IdlTypes<Jbond>['bondType'];
 type CollateralType = IdlTypes<Jbond>['collateralType'];
+type BondStateStatus = IdlTypes<Jbond>['bondStatus'];
 type BondStateStats = {
     totalCollected: number;
     status: SessionStatus;
 };
 declare const bondTypeToSeed: {
-    performance: Seeds;
+    standard: Seeds;
     crowdfunding: Seeds;
 };
 declare const BondTypeVariant: {
-    Performance: BondType;
+    Standard: BondType;
     Crowdfunding: BondType;
 };
+declare const BondStateStatusVariant: {
+    Active: BondStateStatus;
+    Disabled: BondStateStatus;
+};
 type GlobalInitializeProps = {
     authority?: PublicKey;
 };
@@ -1573,6 +1697,7 @@ type BondConfigureProps = {
     bondType: BondType;
     name: string;
     authority?: PublicKey;
+    bondStateStatus?: BondStateStatus;
     newAuthority?: PublicKey;
     newReserve?: PublicKey;
 };
@@ -1600,8 +1725,6 @@ type TransactionHistoryItem = {
     epoch: number;
     type: BondTransactionType;
     amount: number;
-    beforeBalance?: number;
-    afterBalance?: number;
 };
 declare enum BondTransactionType {
     Deposit = "deposit",
@@ -1778,10 +1901,20 @@ declare class JBondClient {
     buildWithdrawIx(props: WithdrawCollateralProps): Promise<TransactionInstruction>;
     buildClaimIx(props: ClaimProps): Promise<TransactionInstruction>;
     buildSetWithdrawAuthorityIx(props: SetWithdrawAuthorityProps): Promise<TransactionInstruction>;
-    buildBondFinishIx(_props: {
+    buildBondFinishIx(props: {
         bondType: BondType;
         name: string;
     }): Promise<TransactionInstruction>;
+    migrateBond(props: {
+        bondType: BondType;
+        name: string;
+        voteAccount: PublicKeyInitData;
+    }): Promise<string | undefined>;
+    buildBondMigrateIx(props: {
+        bondType: BondType;
+        name: string;
+        voteAccount: PublicKeyInitData;
+    }): Promise<TransactionInstruction>;
     buildBondStartIx(props: {
         bondType: BondType;
         name: string;
@@ -1791,22 +1924,83 @@ declare class JBondClient {
      * Fetch global state or throw if not found
      */
     getGlobalState(): Promise<GlobalState>;
-    getBondState(bondType: BondType, bondName: string): Promise<BondState>;
+    /**
+     * Fetch bond state with stats
+     * @param bondType - Type of the bond
+     * @param bondName - Name of the bond
+     * @param withStats
+     */
+    getBondState(bondType: BondType, bondName: string, withStats?: boolean): Promise<{
+        bondState: BondState;
+        stateStats: BondStateStats | null;
+    }>;
     /**
      * Get all bond states with total collected collateral
      */
-    getAllBondStates(bondType: BondType): Promise<Array<[BondState, BondStateStats]>>;
+    getAllBondStates(bondType: BondType, sessionStatus?: SessionStatus): Promise<{
+        publicKey: PublicKey;
+        bondState: {
+            name: string;
+            bondType: ({
+                crowdfunding?: undefined;
+            } & {
+                standard: Record<string, never>;
+            }) | ({
+                standard?: undefined;
+            } & {
+                crowdfunding: Record<string, never>;
+            });
+            collateralType: ({
+                native?: undefined;
+                token?: undefined;
+            } & {
+                stakeAccount: Record<string, never>;
+            }) | ({
+                stakeAccount?: undefined;
+                token?: undefined;
+            } & {
+                native: Record<string, never>;
+            }) | ({
+                stakeAccount?: undefined;
+                native?: undefined;
+            } & {
+                token: {
+                    0: PublicKey;
+                };
+            });
+            reserve: PublicKey;
+            authority: PublicKey;
+            sessionId: number;
+            totalMembers: number;
+            totalCompensationAmount: bn_js;
+            sessionStartTs: bn_js;
+            sessionFinishTs: bn_js;
+            status: ({
+                disabled?: undefined;
+            } & {
+                active: Record<string, never>;
+            }) | ({
+                active?: undefined;
+            } & {
+                disabled: Record<string, never>;
+            });
+            bump: number;
+        };
+        stateStats: {
+            totalCollected: number;
+            status: SessionStatus;
+        };
+    }[]>;
     /**
      * Get session status for bond state
      */
     private getBondStateSessionStatus;
-    /** Get all validator bonds for a given bond state */
+    /**
+     * Get all validator bonds for a given bond state
+     */
     private getValidatorBondsByState;
     /**
      * Fetch validator bond data or null if not found
-     * @param bondType
-     * @param bondName
-     * @param vote
      */
     getValidatorBond(bondType: BondType, bondName: string, vote: PublicKeyInitData): Promise<ValidatorBond | null>;
     /**
@@ -1821,6 +2015,39 @@ declare class JBondClient {
      * @return Balance in lamports
      */
     getValidatorBondBalance(bondType: BondType, bondName: string, vote: PublicKeyInitData): Promise<number>;
+    /**
+     * Get total collected collateral for a bond state
+     */
+    getBondStateTotalCollected(bondType: BondType, bondName: string, votes: PublicKeyInitData[]): Promise<number>;
+    /**
+     * Get transaction history for a specific validator bond account
+     */
+    getHistory(bondType: BondType, bondName: string, vote: PublicKey, options?: {
+        cluster?: 'mainnet-beta' | 'testnet' | 'devnet';
+        limit?: number;
+        before?: string;
+        until?: string;
+    }): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get full transaction history by paginating through results
+     * @param bondType
+     * @param bondName
+     * @param voteAccount
+     * @param pageSize
+     */
+    getFullHistory(bondType: BondType, bondName: string, voteAccount: PublicKey, pageSize?: number): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get instruction discriminator from IDL
+     * @param instructionName
+     * @private
+     */
+    private getInstructionDiscriminator;
+    /**
+     * Get bond state stats
+     * @param state
+     * @private
+     */
+    private getBondStateStats;
     /**
      * Load stake pool account and cache it if not already cached
      * @private
@@ -1841,4 +2068,4 @@ declare class JBondClient {
     private lamports;
 }
 
-export { BondClientEnv, type BondCollateral, type BondConfigureProps, type BondInitializeProps, type BondState, type BondStateStats, BondTransactionType, type BondType, BondTypeVariant, type ClaimProps, type ClientOptions, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JPOOL_STAKE_POOL, type Jbond, NodeWallet, type RegisterValidatorProps, Seeds, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps, bondTypeToSeed };
+export { BondClientEnv, type BondCollateral, type BondConfigureProps, type BondInitializeProps, type BondState, type BondStateStats, type BondStateStatus, BondStateStatusVariant, BondTransactionType, type BondType, BondTypeVariant, type ClaimProps, type ClientOptions, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JPOOL_STAKE_POOL, type Jbond, NodeWallet, type RegisterValidatorProps, Seeds, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps, bondTypeToSeed };