@jpool/bond-sdk 0.4.0 → 0.5.0-next.1

package/dist/index.d.mts

@@ -1,86 +1,6 @@
-import { BN, Program, AnchorProvider, Wallet } from '@coral-xyz/anchor';
-import { PublicKey, Connection, Keypair, TransactionInstruction } from '@solana/web3.js';
-
-type Config = {
-    rpcUrl: string;
-};
-type ValidatorBondAccount = {
-    identity: PublicKey;
-    voteAccount: PublicKey;
-    withdrawalAuthority?: string;
-    totalWithdrawn: number;
-    lastWithdrawalEpoch: number;
-    isActive: boolean;
-    createdAt: number;
-    bump: number;
-};
-type InitializeProps = {
-    authority: PublicKey;
-    reserveAddress: PublicKey;
-};
-type RegisterValidatorProps = {
-    creator: PublicKey;
-    identity: PublicKey;
-    voteAccount: PublicKey;
-    initialCollateral: number;
-    withdrawalAuthority?: PublicKey;
-};
-type TopUpCollateralProps = {
-    user: PublicKey;
-    voteAccount: PublicKey;
-    amount: number;
-};
-type WithdrawCollateralProps = {
-    withdrawalAuthority: PublicKey;
-    voteAccount: PublicKey;
-    destination: PublicKey;
-    amount: number;
-};
-type WithdrawCompensationProps = {
-    authority: PublicKey;
-    voteAccount: PublicKey;
-    amount: number;
-};
-type GetHistoryProps = {
-    voteAccount: PublicKey;
-    options?: {
-        limit?: number;
-        before?: string;
-        until?: string;
-    };
-};
-type GetHistoryGroupedProps = {
-    voteAccount: PublicKey;
-    epochsCount?: number;
-};
-type GlobalState = {
-    authority: PublicKey;
-    totalValidators: number;
-    totalCollateral: BN;
-    totalWithdrawn: BN;
-    bump: number;
-};
-type EpochHistoryItem = {
-    epoch: number;
-    deposits: number;
-    withdrawals: number;
-    balanceChange: number;
-    signatures: string[];
-};
-type TransactionHistoryItem = {
-    signature: string;
-    slot: number;
-    epoch: number;
-    type: BondTransactionType;
-    amount: number;
-    beforeBalance?: number;
-    afterBalance?: number;
-};
-declare enum BondTransactionType {
-    Deposit = "deposit",
-    Withdrawal = "withdrawal",
-    Compensation = "compensation"
-}
+import * as _solana_web3_js 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';
 
 /**
  * Program IDL in camelCase format in order to be used in JS/TS.
@@ -89,38 +9,46 @@ declare enum BondTransactionType {
  * IDL can be found at `target/idl/jbond.json`.
  */
 type Jbond = {
-    address: '8vrqsFHnDdjMYMwahytRzmmYgRqCMmka8X6DJUXGQzWr';
-    metadata: {
-        name: 'jbond';
-        version: '0.1.0';
-        spec: '0.1.0';
-        description: 'Validator compensation program for boosting APR';
+    "address": "BondQ7KqZreTcW2UbeTNDcLCJQ3aXAtLn2Fm6ftaJDU";
+    "metadata": {
+        "name": "jbond";
+        "version": "0.2.0";
+        "spec": "0.1.0";
+        "description": "Jpool Bond Program";
     };
-    instructions: [
+    "instructions": [
         {
-            name: 'bondInit';
-            docs: [
-                'Register validator and fund initial collateral'
+            "name": "claim";
+            "docs": [
+                "Claims compensation for a validator.",
+                "Transfers funds from the validator's bond account to reserve.",
+                "",
+                "# Arguments",
+                "* `amount` - Amount of compensation to claim (must be positive).",
+                "",
+                "# Errors",
+                "Fails if the authority is invalid, if the validator is not active,",
+                "if the amount is zero, or if there are insufficient funds."
             ];
-            discriminator: [
-                220,
+            "discriminator": [
+                62,
+                198,
+                214,
+                193,
+                213,
+                159,
                 108,
-                156,
-                81,
-                16,
-                185,
-                144,
-                157
+                210
             ];
-            accounts: [
+            "accounts": [
                 {
-                    name: 'globalState';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "globalState";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
+                                "kind": "const";
+                                "value": [
                                     103,
                                     108,
                                     111,
@@ -139,13 +67,13 @@ type Jbond = {
                     };
                 },
                 {
-                    name: 'validatorBondAccount';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "validatorBond";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
+                                "kind": "const";
+                                "value": [
                                     118,
                                     97,
                                     108,
@@ -163,130 +91,155 @@ type Jbond = {
                                 ];
                             },
                             {
-                                kind: 'account';
-                                path: 'voteAccount';
+                                "kind": "account";
+                                "path": "validator_bond.vote_account";
+                                "account": "validatorBond";
                             }
                         ];
                     };
                 },
                 {
-                    name: 'identity';
-                },
-                {
-                    name: 'voteAccount';
+                    "name": "reserve";
+                    "writable": true;
                 },
                 {
-                    name: 'creator';
-                    docs: [
-                        'The account creating the bond (pays for account creation and initial collateral)'
+                    "name": "authority";
+                    "docs": [
+                        "Authority that can trigger claims"
                     ];
-                    writable: true;
-                    signer: true;
+                    "signer": true;
                 },
                 {
-                    name: 'systemProgram';
-                    address: '11111111111111111111111111111111';
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
                 }
             ];
-            args: [
+            "args": [
                 {
-                    name: 'initialCollateral';
-                    type: 'u64';
-                },
-                {
-                    name: 'withdrawalAuthority';
-                    type: {
-                        option: 'pubkey';
-                    };
+                    "name": "amount";
+                    "type": "u64";
                 }
             ];
         },
         {
-            name: 'bondTopUp';
-            docs: [
-                'Top up collateral for existing validator'
+            "name": "initialize";
+            "docs": [
+                "Initializes the global state for the bonding program.",
+                "Sets the authority and reserve account for managing validator bonds.",
+                "",
+                "# Errors",
+                "Fails if the global state account is already initialized or if the payer lacks",
+                "sufficient funds."
             ];
-            discriminator: [
-                132,
-                225,
-                254,
-                187,
+            "discriminator": [
+                175,
+                175,
+                109,
+                31,
+                13,
                 152,
-                162,
-                176,
-                66
+                155,
+                237
             ];
-            accounts: [
+            "accounts": [
                 {
-                    name: 'validatorBondAccount';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "globalState";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
-                                    118,
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
                                     97,
                                     108,
-                                    105,
-                                    100,
+                                    95,
+                                    115,
+                                    116,
                                     97,
                                     116,
-                                    111,
-                                    114,
-                                    95,
-                                    98,
-                                    111,
-                                    110,
-                                    100
+                                    101
                                 ];
-                            },
-                            {
-                                kind: 'account';
-                                path: 'validator_bond_account.vote_account';
-                                account: 'validatorBondAccount';
                             }
                         ];
                     };
                 },
                 {
-                    name: 'depositor';
-                    writable: true;
-                    signer: true;
+                    "name": "authority";
+                    "writable": true;
+                    "signer": true;
                 },
                 {
-                    name: 'systemProgram';
-                    address: '11111111111111111111111111111111';
-                }
-            ];
-            args: [
+                    "name": "reserve";
+                },
                 {
-                    name: 'amount';
-                    type: 'u64';
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
                 }
             ];
+            "args": [];
         },
         {
-            name: 'bondWithdraw';
-            discriminator: [
-                99,
-                64,
-                127,
+            "name": "register";
+            "docs": [
+                "Registers a new validator with the bonding program.",
+                "Sets up the validator's bond account and deposits initial collateral.",
+                "",
+                "# Arguments",
+                "* `initial_collateral` - Amount of collateral to lock (must be positive).",
+                "* `withdrawal_authority` - Optional key that can withdraw collateral later.",
+                "",
+                "# Errors",
+                "Fails if the validator is already registered, if the vote account is invalid,",
+                "or if the initial collateral transfer fails."
+            ];
+            "discriminator": [
+                211,
+                124,
+                67,
+                15,
+                211,
+                194,
                 178,
-                53,
-                117,
-                70,
-                204
+                240
             ];
-            accounts: [
+            "accounts": [
                 {
-                    name: 'validatorBondAccount';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "globalState";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    115,
+                                    116,
+                                    97,
+                                    116,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
                                     118,
                                     97,
                                     108,
@@ -304,100 +257,57 @@ type Jbond = {
                                 ];
                             },
                             {
-                                kind: 'account';
-                                path: 'validator_bond_account.vote_account';
-                                account: 'validatorBondAccount';
+                                "kind": "account";
+                                "path": "voteAccount";
                             }
                         ];
                     };
                 },
                 {
-                    name: 'withdrawalAuthority';
-                    writable: true;
-                    signer: true;
+                    "name": "identity";
                 },
                 {
-                    name: 'destination';
-                    writable: true;
+                    "name": "voteAccount";
                 },
                 {
-                    name: 'epochSchedule';
-                    address: 'SysvarEpochSchedu1e111111111111111111111111';
+                    "name": "creator";
+                    "docs": [
+                        "The account creating the bond (pays for account creation and initial collateral)"
+                    ];
+                    "writable": true;
+                    "signer": true;
                 },
                 {
-                    name: 'systemProgram';
-                    address: '11111111111111111111111111111111';
-                }
-            ];
-            args: [
-                {
-                    name: 'amount';
-                    type: 'u64';
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
                 }
             ];
-        },
-        {
-            name: 'initialize';
-            docs: [
-                'Initialize the global state and reserve vault'
-            ];
-            discriminator: [
-                175,
-                175,
-                109,
-                31,
-                13,
-                152,
-                155,
-                237
-            ];
-            accounts: [
-                {
-                    name: 'globalState';
-                    writable: true;
-                    pda: {
-                        seeds: [
-                            {
-                                kind: 'const';
-                                value: [
-                                    103,
-                                    108,
-                                    111,
-                                    98,
-                                    97,
-                                    108,
-                                    95,
-                                    115,
-                                    116,
-                                    97,
-                                    116,
-                                    101
-                                ];
-                            }
-                        ];
-                    };
-                },
-                {
-                    name: 'authority';
-                    writable: true;
-                    signer: true;
-                },
+            "args": [
                 {
-                    name: 'reserve';
+                    "name": "initialCollateral";
+                    "type": "u64";
                 },
                 {
-                    name: 'systemProgram';
-                    address: '11111111111111111111111111111111';
+                    "name": "withdrawalAuthority";
+                    "type": {
+                        "option": "pubkey";
+                    };
                 }
             ];
-            args: [];
         },
         {
-            name: 'setAuthority';
-            docs: [
-                'Change the bond authority'
+            "name": "setAuthority";
+            "docs": [
+                "Sets a new withdrawal authority for a validator's bond account.",
+                "Allows changing who can withdraw collateral in the future.",
+                "",
+                "# Arguments",
+                "* `new_authority` - Optional new authority key (None to restrict to identity).",
+                "",
+                "# Errors",
+                "Fails if the signer is not authorized to change the authority."
             ];
-            discriminator: [
+            "discriminator": [
                 133,
                 250,
                 37,
@@ -407,15 +317,15 @@ type Jbond = {
                 26,
                 121
             ];
-            accounts: [
+            "accounts": [
                 {
-                    name: 'globalState';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "globalState";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
+                                "kind": "const";
+                                "value": [
                                     103,
                                     108,
                                     111,
@@ -434,67 +344,124 @@ type Jbond = {
                     };
                 },
                 {
-                    name: 'authority';
-                    signer: true;
-                    relations: [
-                        'globalState'
+                    "name": "authority";
+                    "signer": true;
+                    "relations": [
+                        "globalState"
                     ];
                 },
                 {
-                    name: 'newAuthority';
+                    "name": "newAuthority";
                 }
             ];
-            args: [];
+            "args": [];
         },
         {
-            name: 'withdrawCompensation';
-            docs: [
-                'Withdraw compensation from validator to reserve (oracle only)'
+            "name": "topUp";
+            "docs": [
+                "Adds additional collateral to an existing validator's bond.",
+                "Increases the collateral balance, enhancing the validator's stake.",
+                "",
+                "# Arguments",
+                "* `amount` - Amount to add.",
+                "",
+                "# Errors",
+                "Fails if the validator is not active, if the amount is zero,",
+                "or if the transfer of funds fails."
             ];
-            discriminator: [
-                10,
-                228,
-                22,
-                213,
-                205,
-                117,
-                181,
-                75
+            "discriminator": [
+                236,
+                225,
+                96,
+                9,
+                60,
+                106,
+                77,
+                208
             ];
-            accounts: [
+            "accounts": [
                 {
-                    name: 'globalState';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "validatorBond";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
-                                    103,
-                                    108,
-                                    111,
-                                    98,
+                                "kind": "const";
+                                "value": [
+                                    118,
                                     97,
                                     108,
-                                    95,
-                                    115,
-                                    116,
+                                    105,
+                                    100,
                                     97,
                                     116,
-                                    101
+                                    111,
+                                    114,
+                                    95,
+                                    98,
+                                    111,
+                                    110,
+                                    100
                                 ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "validator_bond.vote_account";
+                                "account": "validatorBond";
                             }
                         ];
                     };
                 },
                 {
-                    name: 'validatorBondAccount';
-                    writable: true;
-                    pda: {
-                        seeds: [
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "withdraw";
+            "docs": [
+                "Withdraws collateral from a validator's bond.",
+                "Decreases the collateral balance, allowing the validator to reclaim funds.",
+                "",
+                "# Arguments",
+                "* `amount` - Amount to withdraw (must not exceed available balance).",
+                "",
+                "# Errors",
+                "Fails if the validator is not active, if the amount is zero,",
+                "if the withdrawal authority is invalid, or if the withdrawal would",
+                "leave insufficient collateral."
+            ];
+            "discriminator": [
+                183,
+                18,
+                70,
+                156,
+                148,
+                109,
+                161,
+                34
+            ];
+            "accounts": [
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
                             {
-                                kind: 'const';
-                                value: [
+                                "kind": "const";
+                                "value": [
                                     118,
                                     97,
                                     108,
@@ -512,41 +479,43 @@ type Jbond = {
                                 ];
                             },
                             {
-                                kind: 'account';
-                                path: 'validator_bond_account.vote_account';
-                                account: 'validatorBondAccount';
+                                "kind": "account";
+                                "path": "validator_bond.vote_account";
+                                "account": "validatorBond";
                             }
                         ];
                     };
                 },
                 {
-                    name: 'reserve';
-                    writable: true;
+                    "name": "withdrawalAuthority";
+                    "writable": true;
+                    "signer": true;
                 },
                 {
-                    name: 'authority';
-                    docs: [
-                        'Authority that can trigger claims'
-                    ];
-                    signer: true;
+                    "name": "destination";
+                    "writable": true;
                 },
                 {
-                    name: 'systemProgram';
-                    address: '11111111111111111111111111111111';
+                    "name": "epochSchedule";
+                    "address": "SysvarEpochSchedu1e111111111111111111111111";
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
                 }
             ];
-            args: [
+            "args": [
                 {
-                    name: 'amount';
-                    type: 'u64';
+                    "name": "amount";
+                    "type": "u64";
                 }
             ];
         }
     ];
-    accounts: [
+    "accounts": [
         {
-            name: 'globalState';
-            discriminator: [
+            "name": "globalState";
+            "discriminator": [
                 163,
                 46,
                 74,
@@ -558,23 +527,23 @@ type Jbond = {
             ];
         },
         {
-            name: 'validatorBondAccount';
-            discriminator: [
-                25,
-                67,
-                241,
-                227,
-                226,
-                104,
-                108,
-                73
+            "name": "validatorBond";
+            "discriminator": [
+                82,
+                127,
+                243,
+                208,
+                195,
+                42,
+                80,
+                35
             ];
         }
     ];
-    events: [
+    "events": [
         {
-            name: 'collateralToppedUp';
-            discriminator: [
+            "name": "collateralToppedUp";
+            "discriminator": [
                 189,
                 137,
                 204,
@@ -586,8 +555,8 @@ type Jbond = {
             ];
         },
         {
-            name: 'collateralWithdrawn';
-            discriminator: [
+            "name": "collateralWithdrawn";
+            "discriminator": [
                 51,
                 224,
                 133,
@@ -599,8 +568,8 @@ type Jbond = {
             ];
         },
         {
-            name: 'compensationClaimed';
-            discriminator: [
+            "name": "compensationClaimed";
+            "discriminator": [
                 36,
                 159,
                 41,
@@ -612,8 +581,8 @@ type Jbond = {
             ];
         },
         {
-            name: 'validatorRegistered';
-            discriminator: [
+            "name": "validatorRegistered";
+            "discriminator": [
                 20,
                 20,
                 190,
@@ -625,233 +594,278 @@ type Jbond = {
             ];
         }
     ];
-    errors: [
+    "errors": [
         {
-            code: 6000;
-            name: 'invalidVoteAccount';
-            msg: 'Invalid vote account';
+            "code": 6000;
+            "name": "invalidVoteAccount";
+            "msg": "Invalid vote account";
         },
         {
-            code: 6001;
-            name: 'identityMismatch';
-            msg: 'Identity does not match vote account';
+            "code": 6001;
+            "name": "identityMismatch";
+            "msg": "Identity does not match vote account";
         },
         {
-            code: 6002;
-            name: 'insufficientCollateral';
-            msg: 'Insufficient collateral amount';
+            "code": 6002;
+            "name": "insufficientCollateral";
+            "msg": "Insufficient collateral amount";
         },
         {
-            code: 6003;
-            name: 'targetAprTooLow';
-            msg: 'Target APR is below minimum threshold';
+            "code": 6003;
+            "name": "targetAprTooLow";
+            "msg": "Target APR is below minimum threshold";
         },
         {
-            code: 6004;
-            name: 'mathOverflow';
-            msg: 'Math overflow';
+            "code": 6004;
+            "name": "mathOverflow";
+            "msg": "Math overflow";
         },
         {
-            code: 6005;
-            name: 'invalidAmount';
-            msg: 'Invalid amount';
+            "code": 6005;
+            "name": "invalidAmount";
+            "msg": "Invalid amount";
         },
         {
-            code: 6006;
-            name: 'validatorNotActive';
-            msg: 'Validator boost account is not active';
+            "code": 6006;
+            "name": "validatorNotActive";
+            "msg": "Validator boost account is not active";
         },
         {
-            code: 6007;
-            name: 'validatorAlreadyRegistered';
-            msg: 'Validator already registered';
+            "code": 6007;
+            "name": "validatorAlreadyRegistered";
+            "msg": "Validator already registered";
         },
         {
-            code: 6008;
-            name: 'unauthorized';
-            msg: 'unauthorized';
+            "code": 6008;
+            "name": "unauthorized";
+            "msg": "unauthorized";
         },
         {
-            code: 6009;
-            name: 'withdrawalLockedNearEpochEnd';
-            msg: 'Withdrawals are locked near the end of the epoch.';
+            "code": 6009;
+            "name": "withdrawalLockedNearEpochEnd";
+            "msg": "Withdrawals are locked near the end of the epoch.";
         }
     ];
-    types: [
+    "types": [
         {
-            name: 'collateralToppedUp';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "collateralToppedUp";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'validator';
-                        type: 'pubkey';
+                        "name": "validator";
+                        "type": "pubkey";
                     },
                     {
-                        name: 'amount';
-                        type: 'u64';
+                        "name": "amount";
+                        "type": "u64";
                     },
                     {
-                        name: 'newTotal';
-                        type: 'u64';
+                        "name": "postBalance";
+                        "type": "u64";
                     },
                     {
-                        name: 'timestamp';
-                        type: 'i64';
+                        "name": "timestamp";
+                        "type": "i64";
                     }
                 ];
             };
         },
         {
-            name: 'collateralWithdrawn';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "collateralWithdrawn";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'validator';
-                        type: 'pubkey';
+                        "name": "validator";
+                        "type": "pubkey";
                     },
                     {
-                        name: 'amount';
-                        type: 'u64';
+                        "name": "amount";
+                        "type": "u64";
                     },
                     {
-                        name: 'remainingCollateral';
-                        type: 'u64';
+                        "name": "postBalance";
+                        "type": "u64";
                     },
                     {
-                        name: 'timestamp';
-                        type: 'i64';
+                        "name": "timestamp";
+                        "type": "i64";
                     }
                 ];
             };
         },
         {
-            name: 'compensationClaimed';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "compensationClaimed";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'validator';
-                        type: 'pubkey';
+                        "name": "validator";
+                        "type": "pubkey";
                     },
                     {
-                        name: 'amount';
-                        type: 'u64';
+                        "name": "amount";
+                        "type": "u64";
                     },
                     {
-                        name: 'remainingCollateral';
-                        type: 'u64';
+                        "name": "postBalance";
+                        "type": "u64";
                     },
                     {
-                        name: 'totalWithdrawn';
-                        type: 'u64';
+                        "name": "epoch";
+                        "type": "u64";
                     },
                     {
-                        name: 'epoch';
-                        type: 'u64';
-                    },
-                    {
-                        name: 'timestamp';
-                        type: 'i64';
+                        "name": "timestamp";
+                        "type": "i64";
                     }
                 ];
             };
         },
         {
-            name: 'globalState';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "globalState";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'authority';
-                        type: 'pubkey';
+                        "name": "authority";
+                        "docs": [
+                            "The authority allowed to manage the program"
+                        ];
+                        "type": "pubkey";
                     },
                     {
-                        name: 'reserve';
-                        type: 'pubkey';
+                        "name": "reserve";
+                        "docs": [
+                            "The reserve vault holding SOL for bonding and compensation"
+                        ];
+                        "type": "pubkey";
                     },
                     {
-                        name: 'totalValidators';
-                        type: 'u32';
+                        "name": "totalValidators";
+                        "docs": [
+                            "Total number of registered validators"
+                        ];
+                        "type": "u16";
                     },
                     {
-                        name: 'totalWithdrawn';
-                        type: 'u64';
+                        "name": "totalCompensationAmount";
+                        "docs": [
+                            "Total compensation amount paid out"
+                        ];
+                        "type": "u64";
                     },
                     {
-                        name: 'bump';
-                        type: 'u8';
+                        "name": "bump";
+                        "docs": [
+                            "Bump for the PDA"
+                        ];
+                        "type": "u8";
                     }
                 ];
             };
         },
         {
-            name: 'validatorBondAccount';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "validatorBond";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'identity';
-                        type: 'pubkey';
+                        "name": "identity";
+                        "docs": [
+                            "The validator identity pubkey"
+                        ];
+                        "type": "pubkey";
                     },
                     {
-                        name: 'voteAccount';
-                        type: 'pubkey';
+                        "name": "voteAccount";
+                        "docs": [
+                            "The validator vote account pubkey"
+                        ];
+                        "type": "pubkey";
                     },
                     {
-                        name: 'creator';
-                        type: 'pubkey';
+                        "name": "creator";
+                        "docs": [
+                            "Creator of the validator bond account"
+                        ];
+                        "type": "pubkey";
                     },
                     {
-                        name: 'withdrawalAuthority';
-                        type: {
-                            option: 'pubkey';
+                        "name": "withdrawalAuthority";
+                        "docs": [
+                            "Authority allowed to withdraw funds (if None, only identity can withdraw)"
+                        ];
+                        "type": {
+                            "option": "pubkey";
                         };
                     },
                     {
-                        name: 'totalWithdrawn';
-                        type: 'u64';
+                        "name": "totalCompensationAmount";
+                        "docs": [
+                            "Total compensation claimed for the validator"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "lastCompensationAmount";
+                        "docs": [
+                            "Last compensation amount claimed"
+                        ];
+                        "type": "u64";
                     },
                     {
-                        name: 'lastWithdrawalEpoch';
-                        type: 'u64';
+                        "name": "lastCompensationEpoch";
+                        "docs": [
+                            "Last epoch when compensation was claimed"
+                        ];
+                        "type": "u64";
                     },
                     {
-                        name: 'isActive';
-                        type: 'bool';
+                        "name": "createdAt";
+                        "docs": [
+                            "Timestamp when the bond account was created"
+                        ];
+                        "type": "i64";
                     },
                     {
-                        name: 'createdAt';
-                        type: 'i64';
+                        "name": "isActive";
+                        "docs": [
+                            "Whether the validator is currently active"
+                        ];
+                        "type": "bool";
                     },
                     {
-                        name: 'bump';
-                        type: 'u8';
+                        "name": "bump";
+                        "docs": [
+                            "Bump for the PDA"
+                        ];
+                        "type": "u8";
                     }
                 ];
             };
         },
         {
-            name: 'validatorRegistered';
-            type: {
-                kind: 'struct';
-                fields: [
+            "name": "validatorRegistered";
+            "type": {
+                "kind": "struct";
+                "fields": [
                     {
-                        name: 'validator';
-                        type: 'pubkey';
+                        "name": "identity";
+                        "type": "pubkey";
                     },
                     {
-                        name: 'voteAccount';
-                        type: 'pubkey';
+                        "name": "voteAccount";
+                        "type": "pubkey";
                     },
                     {
-                        name: 'collateralAmount';
-                        type: 'u64';
+                        "name": "initialCollateral";
+                        "type": "u64";
                     },
                     {
-                        name: 'timestamp';
-                        type: 'i64';
+                        "name": "timestamp";
+                        "type": "i64";
                     }
                 ];
             };
@@ -859,28 +873,125 @@ type Jbond = {
     ];
 };
 
+type ValidatorBond = {
+    identity: PublicKey;
+    voteAccount: PublicKey;
+    withdrawalAuthority?: string;
+    totalWithdrawn: number;
+    lastWithdrawalEpoch: number;
+    isActive: boolean;
+    createdAt: number;
+    bump: number;
+};
+type InitializeProps = {
+    authority?: PublicKey;
+    reserve: PublicKey;
+};
+type RegisterValidatorProps = {
+    identity: PublicKey;
+    voteAccount: PublicKey;
+    initialCollateral: number;
+    withdrawalAuthority?: PublicKey;
+    creator?: PublicKey;
+};
+type TopUpCollateralProps = {
+    amount: number;
+    voteAccount: PublicKey;
+    payer?: PublicKey;
+};
+type WithdrawCollateralProps = {
+    amount: number;
+    voteAccount: PublicKey;
+    destination?: PublicKey;
+    withdrawalAuthority?: PublicKey;
+};
+type ClaimProps = {
+    amount: number;
+    voteAccount: PublicKey;
+    reserve?: PublicKey;
+    authority?: PublicKey;
+};
+type GetHistoryProps = {
+    voteAccount: PublicKey;
+    options?: {
+        limit?: number;
+        before?: string;
+        until?: string;
+    };
+};
+type GetHistoryGroupedProps = {
+    voteAccount: PublicKey;
+    epochsCount?: number;
+};
+type SetAuthorityProps = {
+    newAuthority: PublicKey;
+    authority?: PublicKey;
+};
+type GlobalState = {
+    authority: PublicKey;
+    totalValidators: number;
+    totalCollateral: BN;
+    totalWithdrawn: BN;
+    bump: number;
+};
+type EpochHistoryItem = {
+    epoch: number;
+    deposits: number;
+    withdrawals: number;
+    balanceChange: number;
+    signatures: string[];
+};
+type TransactionHistoryItem = {
+    signature: string;
+    slot: number;
+    epoch: number;
+    type: BondTransactionType;
+    amount: number;
+    beforeBalance?: number;
+    afterBalance?: number;
+};
+declare enum BondTransactionType {
+    Deposit = "deposit",
+    Withdrawal = "withdrawal",
+    Compensation = "compensation"
+}
+
+/**
+ * Enum for different client environments.
+ */
 declare enum BondClientEnv {
     DEV = "dev",
+    STAGE = "stage",
     PROD = "prod"
 }
+/**
+ * Options for configuring the JBondClient.
+ */
+type ClientOptions = {
+    programId?: PublicKey;
+    debug?: boolean;
+} & Record<string, any>;
 declare class JBondClient {
-    connection: Connection;
-    program: Program<Jbond>;
-    provider: AnchorProvider;
+    readonly provider: AnchorProvider;
     readonly options: ClientOptions;
-    constructor(options: ClientOptions, wallet?: Wallet);
+    readonly program: Program<Jbond>;
+    constructor(provider: AnchorProvider, options?: ClientOptions);
     /**
      * Creates an instance of `JBondClient` using a provided connection and wallet.
      */
-    static fromWallet(options: ClientOptions, wallet?: Wallet): JBondClient;
+    static fromWallet(connection: Connection, wallet?: Wallet$1, options?: ClientOptions): JBondClient;
     /**
      * Creates an instance of `JBondClient` using the provided connection and keypair.
      */
-    static fromKeypair(options: ClientOptions, keypair: Keypair): JBondClient;
+    static fromKeypair(connection: Connection, keypair: Keypair, options?: ClientOptions): JBondClient;
     /**
      * Get the current program ID.
      */
     get programId(): PublicKey;
+    /**
+     * Get the current connection.
+     */
+    private get connection();
     /**
      * Set the environment.
      */
@@ -889,62 +1000,150 @@ declare class JBondClient {
      * Configure a specific option.
      */
     configure<K extends keyof ClientOptions>(key: K, val: ClientOptions[K]): this;
-    getGlobalStatePDA(): [PublicKey, number];
-    getValidatorBondPDA(voteAccount: PublicKey): [PublicKey, number];
-    buildInitializeInstruction(props: InitializeProps): Promise<TransactionInstruction>;
-    buildRegisterValidatorInstruction(props: RegisterValidatorProps): Promise<TransactionInstruction>;
-    buildTopUpCollateralInstruction(props: TopUpCollateralProps): Promise<TransactionInstruction>;
-    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<TransactionInstruction>;
-    buildWithdrawCompensationInstruction(props: WithdrawCompensationProps): Promise<TransactionInstruction>;
-    buildWithdrawCompensationsInstructions(authority: PublicKey, withdrawals: Array<{
-        voteAccount: PublicKey;
-        amount: number;
-    }>): Promise<TransactionInstruction[]>;
-    getValidatorBondAccount(voteAccount: PublicKey): Promise<ValidatorBondAccount | null>;
-    buildSetAuthorityInstruction(props: {
-        authority: PublicKey;
-        newAuthority: PublicKey;
-    }): Promise<TransactionInstruction>;
     /**
-     * Get the collateral balance of a validator bond account
-     * @param voteAccount - The vote account public key
-     * @returns The available collateral balance in SOL (excluding rent-exempt amount)
+     * Program Derived Addresses (PDAs)
+     */
+    pda: {
+        globalState: () => [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
+     */
+    buildInitializeInstruction(props: InitializeProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Build register validator instruction
+     */
+    buildRegisterValidatorInstruction(props: RegisterValidatorProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Build top up collateral instruction
+     */
+    buildTopUpCollateralInstruction(props: TopUpCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Build withdraw collateral instruction
+     */
+    buildWithdrawCollateralInstruction(props: WithdrawCollateralProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Build claim compensation instruction
+     */
+    buildClaimInstruction(props: ClaimProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Build set authority instruction
+     */
+    buildSetAuthorityInstruction(props: SetAuthorityProps): Promise<_solana_web3_js.TransactionInstruction>;
+    /**
+     * Fetch global state or throw if not found
      */
-    getValidatorCollateralBalance(voteAccount: PublicKey): Promise<number>;
     getGlobalState(): Promise<{
-        authority: string;
+        authority: PublicKey;
+        reserve: PublicKey;
         totalValidators: number;
-        totalWithdrawn: number;
-        reserveAddress: string;
+        totalCompensationAmount: BN;
+        bump: number;
+    }>;
+    /**
+     * Fetch validator bond data or null if not found
+     * @param vote
+     */
+    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>;
-    getCurrentEpoch(): Promise<number>;
-    initialize(reserveAddress: PublicKey, authority?: PublicKey): 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>;
+    /**
+     * Get validator bond account balance (in SOL)
+     * @param vote - Vote account public key
+     * @return Balance in SOL
+     */
+    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;
         until?: string;
     }): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get full transaction history by paginating through results
+     * @param voteAccount
+     * @param pageSize
+     */
     getFullHistory(voteAccount: PublicKey, pageSize?: number): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get instruction discriminator from IDL
+     * @param instructionName
+     * @private
+     */
     private getInstructionDiscriminator;
 }
-type ClientOptions = {
-    rpcUrl: string;
-    programId?: PublicKey;
-} & Record<string, any>;
 
-declare const PROGRAM_ID: PublicKey;
-declare const DEV_PROGRAM_ID: PublicKey;
+/**
+ * Program IDs for different environments
+ */
+declare const ENV_PROGRAM_ID: Record<string, PublicKey>;
+
+type Wallet = {
+    publicKey: PublicKey;
+    signMessage?: (message: Uint8Array) => Promise<Uint8Array>;
+    signTransaction: <T extends Transaction | VersionedTransaction>(tx: T) => Promise<T>;
+    signAllTransactions: <T extends Transaction | VersionedTransaction>(txs: T[]) => Promise<T[]>;
+};
+declare class NodeWallet implements Wallet {
+    readonly payer: Keypair;
+    constructor(payer: Keypair);
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+    get publicKey(): PublicKey;
+}
 
-export { BondClientEnv, BondTransactionType, type ClientOptions, type Config, DEV_PROGRAM_ID, type EpochHistoryItem, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalState, type InitializeProps, JBondClient, type Jbond, PROGRAM_ID, type RegisterValidatorProps, type TopUpCollateralProps, type TransactionHistoryItem, type ValidatorBondAccount, 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 };