@jpool/bond-sdk 0.3.0-next.6 → 0.3.0-next.8

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, Connection, Keypair, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { PublicKey, Connection, Keypair, PublicKeyInitData, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { BN, AnchorProvider, Program, Wallet as Wallet$1 } from '@coral-xyz/anchor';
 
 /**
@@ -884,31 +884,32 @@ type ValidatorBond = {
     bump: number;
 };
 type InitializeProps = {
-    authority: PublicKey;
-    reserveAddress: PublicKey;
+    authority?: PublicKey;
+    reserve: PublicKey;
 };
 type RegisterValidatorProps = {
-    creator: PublicKey;
     identity: PublicKey;
     voteAccount: PublicKey;
     initialCollateral: number;
     withdrawalAuthority?: PublicKey;
+    creator?: PublicKey;
 };
 type TopUpCollateralProps = {
-    user: PublicKey;
-    voteAccount: PublicKey;
     amount: number;
+    voteAccount: PublicKey;
+    payer?: PublicKey;
 };
 type WithdrawCollateralProps = {
-    withdrawalAuthority: PublicKey;
-    voteAccount: PublicKey;
-    destination: PublicKey;
     amount: number;
-};
-type WithdrawCompensationProps = {
-    authority: PublicKey;
     voteAccount: PublicKey;
+    destination?: PublicKey;
+    withdrawalAuthority?: PublicKey;
+};
+type ClaimProps = {
     amount: number;
+    voteAccount: PublicKey;
+    reserve?: PublicKey;
+    authority?: PublicKey;
 };
 type GetHistoryProps = {
     voteAccount: PublicKey;
@@ -922,6 +923,10 @@ type GetHistoryGroupedProps = {
     voteAccount: PublicKey;
     epochsCount?: number;
 };
+type SetAuthorityProps = {
+    newAuthority: PublicKey;
+    authority?: PublicKey;
+};
 type GlobalState = {
     authority: PublicKey;
     totalValidators: number;
@@ -1000,94 +1005,109 @@ declare class JBondClient {
      */
     pda: {
         globalState: () => [PublicKey, number];
-        validatorBond: (voteAccount: PublicKey) => [PublicKey, number];
+        validatorBond: (vote: PublicKeyInitData) => [PublicKey, number];
     };
+    /**
+     * Initialize the program
+     * Default authority is the provider's wallet
+     */
+    initialize(props: InitializeProps): Promise<string>;
+    /**
+     * Register a new validator
+     * Default creator is the provider's wallet
+     */
+    registerValidator(props: RegisterValidatorProps): Promise<string>;
+    /**
+     * Top up collateral
+     * Default payer is the provider's wallet
+     */
+    topUpCollateral(props: TopUpCollateralProps): Promise<string>;
+    /**
+     * Withdraw collateral
+     * Default withdrawal authority is the provider's wallet
+     * Default destination is the provider's wallet
+     * @return Transaction signature
+     */
+    withdrawCollateral(props: WithdrawCollateralProps): Promise<string>;
+    /**
+     * Claim compensation
+     * Default authority is the provider's wallet
+     * @return Transaction signature
+     */
+    claimCompensation(props: ClaimProps): Promise<string>;
+    /**
+     * Set a new authority for the program
+     * Default authority is the provider's wallet
+     * @return Transaction signature
+     */
+    setAuthority(props: SetAuthorityProps): Promise<string>;
     /**
      * Build initialize instruction
-     * @param props
      */
     buildInitializeInstruction(props: InitializeProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build register validator instruction
-     * @param props
      */
     buildRegisterValidatorInstruction(props: RegisterValidatorProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build top up collateral instruction
-     * @param props
      */
     buildTopUpCollateralInstruction(props: TopUpCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
-    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
-    /**
-     * Build withdraw compensation instruction
-     * @param props
-     */
-    buildWithdrawCompensationInstruction(props: WithdrawCompensationProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Build multiple withdraw compensation instructions
-     * @param authority
-     * @param withdrawals
+     * Build withdraw collateral instruction
      */
-    buildWithdrawCompensationsInstructions(authority: PublicKey, withdrawals: Array<{
-        voteAccount: PublicKey;
-        amount: number;
-    }>): Promise<_solana_web3_js.TransactionInstruction[]>;
+    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Get validator bond account state
-     * @param vote
+     * Build claim compensation instruction
      */
-    getValidatorBond(vote: PublicKey): Promise<{
-        identity: any;
-        voteAccount: any;
-        withdrawalAuthority: any;
-        totalCompensationAmount: number;
-        isActive: any;
-        createdAt: number;
-        bump: any;
-    } | null>;
+    buildClaimInstruction(props: ClaimProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build set authority instruction
      */
-    buildSetAuthorityInstruction(props: {
-        authority: PublicKey;
-        newAuthority: PublicKey;
-    }): Promise<_solana_web3_js.TransactionInstruction>;
-    /**
-     * Get the collateral balance of a validator bond account
-     * @param vote - The vote account public key
-     * @returns The available collateral balance in SOL (excluding rent-exempt amount)
-     */
-    getValidatorCollateralBalance(vote: PublicKey): Promise<number>;
+    buildSetAuthorityInstruction(props: SetAuthorityProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Get global state
+     * Fetch global state or throw if not found
      */
     getGlobalState(): Promise<{
-        authority: string;
+        authority: PublicKey;
+        reserve: PublicKey;
         totalValidators: number;
-        totalCompensationAmount: number;
-        reserveAddress: string;
+        totalCompensationAmount: BN;
+        bump: number;
     }>;
     /**
-     * Get current epoch
+     * Fetch validator bond data or null if not found
+     * @param vote
      */
-    getCurrentEpoch(): Promise<number>;
+    getValidatorBond(vote: PublicKeyInitData): Promise<{
+        identity: PublicKey;
+        voteAccount: PublicKey;
+        creator: PublicKey;
+        withdrawalAuthority: PublicKey | null;
+        totalCompensationAmount: BN;
+        lastCompensationAmount: BN;
+        lastCompensationEpoch: BN;
+        createdAt: BN;
+        isActive: boolean;
+        bump: number;
+    } | null>;
     /**
-     * Helper methods for backward compatibility (can be removed if not needed)
-     * @param props
+     * Get validator bond account balance (in SOL)
+     * @param vote - Vote account public key
+     * @return Balance in SOL
      */
-    initialize(props: WithOptionalAuthority<InitializeProps>): Promise<string>;
-    registerValidator(voteAccount: PublicKey, initialCollateral: number, withdrawalAuthority?: PublicKey, identity?: PublicKey): Promise<string>;
-    topUpCollateral(voteAccount: PublicKey, amount: number, validator?: PublicKey): Promise<string>;
-    withdrawCollateral(voteAccount: PublicKey, destination: PublicKey, amount: number, withdrawalAuthority?: PublicKey): Promise<string>;
-    claimCompensation(voteAccount: PublicKey, amount: number, authority?: PublicKey): Promise<string>;
+    getValidatorBondBalance(vote: PublicKeyInitData): Promise<number>;
     /**
      * Get transaction history grouped by epochs
-     * @param voteAccount - The vote account to get history for
+     * @param vote - The vote account to get history for
      * @param epochsCount - Number of recent epochs to return (default: 10)
      * @returns Array of epoch history items sorted by epoch (descending)
      */
-    getHistoryGroupedByEpochs(voteAccount: PublicKey, epochsCount?: number): Promise<EpochHistoryItem[]>;
-    getHistory(voteAccount: PublicKey, options?: {
+    getHistoryGroupedByEpochs(vote: PublicKeyInitData, epochsCount?: number): Promise<EpochHistoryItem[]>;
+    /**
+     * Get transaction history for a specific validator bond account
+     */
+    getHistory(vote: PublicKey, options?: {
         cluster?: 'mainnet-beta' | 'testnet' | 'devnet';
         limit?: number;
         before?: string;
@@ -1106,11 +1126,6 @@ declare class JBondClient {
      */
     private getInstructionDiscriminator;
 }
-type WithOptionalAuthority<T extends {
-    authority: PublicKey;
-}> = Omit<T, 'authority'> & {
-    authority?: PublicKey;
-};
 
 /**
  * Program IDs for different environments
@@ -1131,4 +1146,4 @@ declare class NodeWallet implements Wallet {
     get publicKey(): PublicKey;
 }
 
-export { BondClientEnv, BondTransactionType, type ClientOptions, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalState, type InitializeProps, JBondClient, type Jbond, NodeWallet, type RegisterValidatorProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps, type WithdrawCompensationProps };
+export { BondClientEnv, BondTransactionType, type ClaimProps, type ClientOptions, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalState, type InitializeProps, JBondClient, type Jbond, NodeWallet, type RegisterValidatorProps, type SetAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, Connection, Keypair, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { PublicKey, Connection, Keypair, PublicKeyInitData, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { BN, AnchorProvider, Program, Wallet as Wallet$1 } from '@coral-xyz/anchor';
 
 /**
@@ -884,31 +884,32 @@ type ValidatorBond = {
     bump: number;
 };
 type InitializeProps = {
-    authority: PublicKey;
-    reserveAddress: PublicKey;
+    authority?: PublicKey;
+    reserve: PublicKey;
 };
 type RegisterValidatorProps = {
-    creator: PublicKey;
     identity: PublicKey;
     voteAccount: PublicKey;
     initialCollateral: number;
     withdrawalAuthority?: PublicKey;
+    creator?: PublicKey;
 };
 type TopUpCollateralProps = {
-    user: PublicKey;
-    voteAccount: PublicKey;
     amount: number;
+    voteAccount: PublicKey;
+    payer?: PublicKey;
 };
 type WithdrawCollateralProps = {
-    withdrawalAuthority: PublicKey;
-    voteAccount: PublicKey;
-    destination: PublicKey;
     amount: number;
-};
-type WithdrawCompensationProps = {
-    authority: PublicKey;
     voteAccount: PublicKey;
+    destination?: PublicKey;
+    withdrawalAuthority?: PublicKey;
+};
+type ClaimProps = {
     amount: number;
+    voteAccount: PublicKey;
+    reserve?: PublicKey;
+    authority?: PublicKey;
 };
 type GetHistoryProps = {
     voteAccount: PublicKey;
@@ -922,6 +923,10 @@ type GetHistoryGroupedProps = {
     voteAccount: PublicKey;
     epochsCount?: number;
 };
+type SetAuthorityProps = {
+    newAuthority: PublicKey;
+    authority?: PublicKey;
+};
 type GlobalState = {
     authority: PublicKey;
     totalValidators: number;
@@ -1000,94 +1005,109 @@ declare class JBondClient {
      */
     pda: {
         globalState: () => [PublicKey, number];
-        validatorBond: (voteAccount: PublicKey) => [PublicKey, number];
+        validatorBond: (vote: PublicKeyInitData) => [PublicKey, number];
     };
+    /**
+     * Initialize the program
+     * Default authority is the provider's wallet
+     */
+    initialize(props: InitializeProps): Promise<string>;
+    /**
+     * Register a new validator
+     * Default creator is the provider's wallet
+     */
+    registerValidator(props: RegisterValidatorProps): Promise<string>;
+    /**
+     * Top up collateral
+     * Default payer is the provider's wallet
+     */
+    topUpCollateral(props: TopUpCollateralProps): Promise<string>;
+    /**
+     * Withdraw collateral
+     * Default withdrawal authority is the provider's wallet
+     * Default destination is the provider's wallet
+     * @return Transaction signature
+     */
+    withdrawCollateral(props: WithdrawCollateralProps): Promise<string>;
+    /**
+     * Claim compensation
+     * Default authority is the provider's wallet
+     * @return Transaction signature
+     */
+    claimCompensation(props: ClaimProps): Promise<string>;
+    /**
+     * Set a new authority for the program
+     * Default authority is the provider's wallet
+     * @return Transaction signature
+     */
+    setAuthority(props: SetAuthorityProps): Promise<string>;
     /**
      * Build initialize instruction
-     * @param props
      */
     buildInitializeInstruction(props: InitializeProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build register validator instruction
-     * @param props
      */
     buildRegisterValidatorInstruction(props: RegisterValidatorProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build top up collateral instruction
-     * @param props
      */
     buildTopUpCollateralInstruction(props: TopUpCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
-    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
-    /**
-     * Build withdraw compensation instruction
-     * @param props
-     */
-    buildWithdrawCompensationInstruction(props: WithdrawCompensationProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Build multiple withdraw compensation instructions
-     * @param authority
-     * @param withdrawals
+     * Build withdraw collateral instruction
      */
-    buildWithdrawCompensationsInstructions(authority: PublicKey, withdrawals: Array<{
-        voteAccount: PublicKey;
-        amount: number;
-    }>): Promise<_solana_web3_js.TransactionInstruction[]>;
+    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Get validator bond account state
-     * @param vote
+     * Build claim compensation instruction
      */
-    getValidatorBond(vote: PublicKey): Promise<{
-        identity: any;
-        voteAccount: any;
-        withdrawalAuthority: any;
-        totalCompensationAmount: number;
-        isActive: any;
-        createdAt: number;
-        bump: any;
-    } | null>;
+    buildClaimInstruction(props: ClaimProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
      * Build set authority instruction
      */
-    buildSetAuthorityInstruction(props: {
-        authority: PublicKey;
-        newAuthority: PublicKey;
-    }): Promise<_solana_web3_js.TransactionInstruction>;
-    /**
-     * Get the collateral balance of a validator bond account
-     * @param vote - The vote account public key
-     * @returns The available collateral balance in SOL (excluding rent-exempt amount)
-     */
-    getValidatorCollateralBalance(vote: PublicKey): Promise<number>;
+    buildSetAuthorityInstruction(props: SetAuthorityProps): Promise<_solana_web3_js.TransactionInstruction>;
     /**
-     * Get global state
+     * Fetch global state or throw if not found
      */
     getGlobalState(): Promise<{
-        authority: string;
+        authority: PublicKey;
+        reserve: PublicKey;
         totalValidators: number;
-        totalCompensationAmount: number;
-        reserveAddress: string;
+        totalCompensationAmount: BN;
+        bump: number;
     }>;
     /**
-     * Get current epoch
+     * Fetch validator bond data or null if not found
+     * @param vote
      */
-    getCurrentEpoch(): Promise<number>;
+    getValidatorBond(vote: PublicKeyInitData): Promise<{
+        identity: PublicKey;
+        voteAccount: PublicKey;
+        creator: PublicKey;
+        withdrawalAuthority: PublicKey | null;
+        totalCompensationAmount: BN;
+        lastCompensationAmount: BN;
+        lastCompensationEpoch: BN;
+        createdAt: BN;
+        isActive: boolean;
+        bump: number;
+    } | null>;
     /**
-     * Helper methods for backward compatibility (can be removed if not needed)
-     * @param props
+     * Get validator bond account balance (in SOL)
+     * @param vote - Vote account public key
+     * @return Balance in SOL
      */
-    initialize(props: WithOptionalAuthority<InitializeProps>): Promise<string>;
-    registerValidator(voteAccount: PublicKey, initialCollateral: number, withdrawalAuthority?: PublicKey, identity?: PublicKey): Promise<string>;
-    topUpCollateral(voteAccount: PublicKey, amount: number, validator?: PublicKey): Promise<string>;
-    withdrawCollateral(voteAccount: PublicKey, destination: PublicKey, amount: number, withdrawalAuthority?: PublicKey): Promise<string>;
-    claimCompensation(voteAccount: PublicKey, amount: number, authority?: PublicKey): Promise<string>;
+    getValidatorBondBalance(vote: PublicKeyInitData): Promise<number>;
     /**
      * Get transaction history grouped by epochs
-     * @param voteAccount - The vote account to get history for
+     * @param vote - The vote account to get history for
      * @param epochsCount - Number of recent epochs to return (default: 10)
      * @returns Array of epoch history items sorted by epoch (descending)
      */
-    getHistoryGroupedByEpochs(voteAccount: PublicKey, epochsCount?: number): Promise<EpochHistoryItem[]>;
-    getHistory(voteAccount: PublicKey, options?: {
+    getHistoryGroupedByEpochs(vote: PublicKeyInitData, epochsCount?: number): Promise<EpochHistoryItem[]>;
+    /**
+     * Get transaction history for a specific validator bond account
+     */
+    getHistory(vote: PublicKey, options?: {
         cluster?: 'mainnet-beta' | 'testnet' | 'devnet';
         limit?: number;
         before?: string;
@@ -1106,11 +1126,6 @@ declare class JBondClient {
      */
     private getInstructionDiscriminator;
 }
-type WithOptionalAuthority<T extends {
-    authority: PublicKey;
-}> = Omit<T, 'authority'> & {
-    authority?: PublicKey;
-};
 
 /**
  * Program IDs for different environments
@@ -1131,4 +1146,4 @@ declare class NodeWallet implements Wallet {
     get publicKey(): PublicKey;
 }
 
-export { BondClientEnv, BondTransactionType, type ClientOptions, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalState, type InitializeProps, JBondClient, type Jbond, NodeWallet, type RegisterValidatorProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps, type WithdrawCompensationProps };
+export { BondClientEnv, BondTransactionType, type ClaimProps, type ClientOptions, ENV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalState, type InitializeProps, JBondClient, type Jbond, NodeWallet, type RegisterValidatorProps, type SetAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBond, type WithdrawCollateralProps };