@jpool/bond-sdk 0.11.0-next.4 → 0.11.0-next.7

package/dist/index.d.mts

@@ -260,6 +260,50 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondLockFunds";
+            "docs": [
+                "Locks funds for both the current and upcoming epoch.",
+                "Moves collateral from available to locked state, making it unavailable for withdrawal for the current and next epoch.",
+                "# Errors",
+                "Fails if the validator is not active, or if there are insufficient available funds."
+            ];
+            "discriminator": [
+                117,
+                166,
+                195,
+                99,
+                103,
+                45,
+                195,
+                2
+            ];
+            "accounts": [
+                {
+                    "name": "bondState";
+                    "writable": true;
+                },
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "bondTokenAccount";
+                    "optional": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "bondRegister";
             "docs": [
@@ -372,6 +416,42 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondReleaseFunds";
+            "docs": [
+                "Releases locked funds after an epoch ends.",
+                "Moves collateral from locked back to available state, allowing withdrawals.",
+                "# Errors",
+                "Fails if the validator is not active, or if there are insufficient locked funds."
+            ];
+            "discriminator": [
+                184,
+                224,
+                14,
+                24,
+                76,
+                14,
+                226,
+                190
+            ];
+            "accounts": [
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "bondSetWithdrawAuthority";
             "docs": [
@@ -551,6 +631,42 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondUpdate";
+            "docs": [
+                "Transitions locked funds between epochs for a validator bond.",
+                "",
+                "This function should be called at epoch boundaries to update the bond's",
+                "`last_update_epoch` and move the `next_epoch_locked` amount into",
+                "`current_epoch_locked`. It ensures that the update only occurs once per epoch.",
+                "",
+                "# Errors",
+                "Returns [`BondError::InvalidEpoch`] if called more than once in the same epoch,",
+                "or if the system clock cannot be accessed."
+            ];
+            "discriminator": [
+                237,
+                102,
+                183,
+                192,
+                94,
+                83,
+                52,
+                82
+            ];
+            "accounts": [
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "bondWithdraw";
             "docs": [
@@ -1151,6 +1267,11 @@ type Jbond = {
             "code": 6023;
             "name": "bondNotEnabled";
             "msg": "Bond is not enabled";
+        },
+        {
+            "code": 6024;
+            "name": "invalidEpoch";
+            "msg": "Invalid epoch for this operation";
         }
     ];
     "types": [
@@ -1582,6 +1703,27 @@ type Jbond = {
                             "Bump for the PDA"
                         ];
                         "type": "u8";
+                    },
+                    {
+                        "name": "nextEpochLocked";
+                        "docs": [
+                            "Amount of collateral locked for the next epoch"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "currentEpochLocked";
+                        "docs": [
+                            "Amount of collateral locked for the current epoch"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "lastUpdateEpoch";
+                        "docs": [
+                            "The last epoch when the bond was updated"
+                        ];
+                        "type": "u64";
                     }
                 ];
             };
@@ -1686,6 +1828,19 @@ type ClaimProps = {
     reserve?: PublicKey;
     authority?: PublicKey;
 };
+type BondLockFunds = {
+    bondType: BondType;
+    name: string;
+    amount: number;
+    voteAccount: PublicKey;
+    collateralType?: CollateralType;
+};
+type BondReleaseFunds = {
+    bondType: BondType;
+    name: string;
+    amount: number;
+    voteAccount: PublicKey;
+};
 type ClaimAllProps = {
     bondType: BondType;
     name: string;
@@ -1936,6 +2091,14 @@ declare class JBondClient {
      * Build start crowdfunding session instruction
      */
     getBondSessionStartIx(props: BondStartProps): Promise<TransactionInstruction>;
+    /**
+     * Build lock funds instruction
+     */
+    getLockFundsIx(props: BondLockFunds): Promise<TransactionInstruction>;
+    /**
+     * Build release funds instruction
+     */
+    getReleaseFundsIx(props: BondReleaseFunds): Promise<TransactionInstruction>;
     /**
      * Get all bond states with total collected collateral
      */
@@ -2063,6 +2226,9 @@ declare class JBondClient {
         withdrawalAuthority: PublicKey | null;
         createdAt: bn_js;
         bump: number;
+        nextEpochLocked: bn_js;
+        currentEpochLocked: bn_js;
+        lastUpdateEpoch: bn_js;
         publicKey: PublicKey;
     }>;
     /**
@@ -2107,4 +2273,4 @@ declare const CROWDFUNDING_BOND_SEED = "crowdfunding";
  */
 declare const ENV_PROGRAM_ID: Record<string, PublicKey>;
 
-export { BOND_STATE_SEED, type BondConfigureProps, type BondFinishProps, type BondInitializeProps, type BondStartProps, type BondState, type BondStateStats, type BondStateStatus, BondTransactionType, BondType, CROWDFUNDING_BOND_SEED, type ClaimAllProps, type ClaimProps, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, GLOBAL_STATE_SEED, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JBondClientEnv, type JBondClientOptions, type Jbond, NodeWallet, type RegisterValidatorProps, STANDARD_BOND_SEED, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, VALIDATOR_BOND_SEED, type ValidatorBond, type WithdrawCollateralProps };
+export { BOND_STATE_SEED, type BondConfigureProps, type BondFinishProps, type BondInitializeProps, type BondLockFunds, type BondReleaseFunds, type BondStartProps, type BondState, type BondStateStats, type BondStateStatus, BondTransactionType, BondType, CROWDFUNDING_BOND_SEED, type ClaimAllProps, type ClaimProps, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, GLOBAL_STATE_SEED, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JBondClientEnv, type JBondClientOptions, type Jbond, NodeWallet, type RegisterValidatorProps, STANDARD_BOND_SEED, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, VALIDATOR_BOND_SEED, type ValidatorBond, type WithdrawCollateralProps };

package/dist/index.d.ts

@@ -260,6 +260,50 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondLockFunds";
+            "docs": [
+                "Locks funds for both the current and upcoming epoch.",
+                "Moves collateral from available to locked state, making it unavailable for withdrawal for the current and next epoch.",
+                "# Errors",
+                "Fails if the validator is not active, or if there are insufficient available funds."
+            ];
+            "discriminator": [
+                117,
+                166,
+                195,
+                99,
+                103,
+                45,
+                195,
+                2
+            ];
+            "accounts": [
+                {
+                    "name": "bondState";
+                    "writable": true;
+                },
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "bondTokenAccount";
+                    "optional": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "bondRegister";
             "docs": [
@@ -372,6 +416,42 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondReleaseFunds";
+            "docs": [
+                "Releases locked funds after an epoch ends.",
+                "Moves collateral from locked back to available state, allowing withdrawals.",
+                "# Errors",
+                "Fails if the validator is not active, or if there are insufficient locked funds."
+            ];
+            "discriminator": [
+                184,
+                224,
+                14,
+                24,
+                76,
+                14,
+                226,
+                190
+            ];
+            "accounts": [
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "bondSetWithdrawAuthority";
             "docs": [
@@ -551,6 +631,42 @@ type Jbond = {
                 }
             ];
         },
+        {
+            "name": "bondUpdate";
+            "docs": [
+                "Transitions locked funds between epochs for a validator bond.",
+                "",
+                "This function should be called at epoch boundaries to update the bond's",
+                "`last_update_epoch` and move the `next_epoch_locked` amount into",
+                "`current_epoch_locked`. It ensures that the update only occurs once per epoch.",
+                "",
+                "# Errors",
+                "Returns [`BondError::InvalidEpoch`] if called more than once in the same epoch,",
+                "or if the system clock cannot be accessed."
+            ];
+            "discriminator": [
+                237,
+                102,
+                183,
+                192,
+                94,
+                83,
+                52,
+                82
+            ];
+            "accounts": [
+                {
+                    "name": "validatorBond";
+                    "writable": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "bondWithdraw";
             "docs": [
@@ -1151,6 +1267,11 @@ type Jbond = {
             "code": 6023;
             "name": "bondNotEnabled";
             "msg": "Bond is not enabled";
+        },
+        {
+            "code": 6024;
+            "name": "invalidEpoch";
+            "msg": "Invalid epoch for this operation";
         }
     ];
     "types": [
@@ -1582,6 +1703,27 @@ type Jbond = {
                             "Bump for the PDA"
                         ];
                         "type": "u8";
+                    },
+                    {
+                        "name": "nextEpochLocked";
+                        "docs": [
+                            "Amount of collateral locked for the next epoch"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "currentEpochLocked";
+                        "docs": [
+                            "Amount of collateral locked for the current epoch"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "lastUpdateEpoch";
+                        "docs": [
+                            "The last epoch when the bond was updated"
+                        ];
+                        "type": "u64";
                     }
                 ];
             };
@@ -1686,6 +1828,19 @@ type ClaimProps = {
     reserve?: PublicKey;
     authority?: PublicKey;
 };
+type BondLockFunds = {
+    bondType: BondType;
+    name: string;
+    amount: number;
+    voteAccount: PublicKey;
+    collateralType?: CollateralType;
+};
+type BondReleaseFunds = {
+    bondType: BondType;
+    name: string;
+    amount: number;
+    voteAccount: PublicKey;
+};
 type ClaimAllProps = {
     bondType: BondType;
     name: string;
@@ -1936,6 +2091,14 @@ declare class JBondClient {
      * Build start crowdfunding session instruction
      */
     getBondSessionStartIx(props: BondStartProps): Promise<TransactionInstruction>;
+    /**
+     * Build lock funds instruction
+     */
+    getLockFundsIx(props: BondLockFunds): Promise<TransactionInstruction>;
+    /**
+     * Build release funds instruction
+     */
+    getReleaseFundsIx(props: BondReleaseFunds): Promise<TransactionInstruction>;
     /**
      * Get all bond states with total collected collateral
      */
@@ -2063,6 +2226,9 @@ declare class JBondClient {
         withdrawalAuthority: PublicKey | null;
         createdAt: bn_js;
         bump: number;
+        nextEpochLocked: bn_js;
+        currentEpochLocked: bn_js;
+        lastUpdateEpoch: bn_js;
         publicKey: PublicKey;
     }>;
     /**
@@ -2107,4 +2273,4 @@ declare const CROWDFUNDING_BOND_SEED = "crowdfunding";
  */
 declare const ENV_PROGRAM_ID: Record<string, PublicKey>;
 
-export { BOND_STATE_SEED, type BondConfigureProps, type BondFinishProps, type BondInitializeProps, type BondStartProps, type BondState, type BondStateStats, type BondStateStatus, BondTransactionType, BondType, CROWDFUNDING_BOND_SEED, type ClaimAllProps, type ClaimProps, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, GLOBAL_STATE_SEED, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JBondClientEnv, type JBondClientOptions, type Jbond, NodeWallet, type RegisterValidatorProps, STANDARD_BOND_SEED, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, VALIDATOR_BOND_SEED, type ValidatorBond, type WithdrawCollateralProps };
+export { BOND_STATE_SEED, type BondConfigureProps, type BondFinishProps, type BondInitializeProps, type BondLockFunds, type BondReleaseFunds, type BondStartProps, type BondState, type BondStateStats, type BondStateStatus, BondTransactionType, BondType, CROWDFUNDING_BOND_SEED, type ClaimAllProps, type ClaimProps, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, GLOBAL_STATE_SEED, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JBondClientEnv, type JBondClientOptions, type Jbond, NodeWallet, type RegisterValidatorProps, STANDARD_BOND_SEED, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, VALIDATOR_BOND_SEED, type ValidatorBond, type WithdrawCollateralProps };

package/dist/index.js

@@ -5008,6 +5008,50 @@ var jbond_default = {
         }
       ]
     },
+    {
+      name: "bond_lock_funds",
+      docs: [
+        "Locks funds for both the current and upcoming epoch.",
+        "Moves collateral from available to locked state, making it unavailable for withdrawal for the current and next epoch.",
+        "# Errors",
+        "Fails if the validator is not active, or if there are insufficient available funds."
+      ],
+      discriminator: [
+        117,
+        166,
+        195,
+        99,
+        103,
+        45,
+        195,
+        2
+      ],
+      accounts: [
+        {
+          name: "bond_state",
+          writable: true
+        },
+        {
+          name: "validator_bond",
+          writable: true
+        },
+        {
+          name: "bond_token_account",
+          optional: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        }
+      ],
+      args: [
+        {
+          name: "amount",
+          type: "u64"
+        }
+      ]
+    },
     {
       name: "bond_register",
       docs: [
@@ -5120,6 +5164,42 @@ var jbond_default = {
         }
       ]
     },
+    {
+      name: "bond_release_funds",
+      docs: [
+        "Releases locked funds after an epoch ends.",
+        "Moves collateral from locked back to available state, allowing withdrawals.",
+        "# Errors",
+        "Fails if the validator is not active, or if there are insufficient locked funds."
+      ],
+      discriminator: [
+        184,
+        224,
+        14,
+        24,
+        76,
+        14,
+        226,
+        190
+      ],
+      accounts: [
+        {
+          name: "validator_bond",
+          writable: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        }
+      ],
+      args: [
+        {
+          name: "amount",
+          type: "u64"
+        }
+      ]
+    },
     {
       name: "bond_set_withdraw_authority",
       docs: [
@@ -5299,6 +5379,42 @@ var jbond_default = {
         }
       ]
     },
+    {
+      name: "bond_update",
+      docs: [
+        "Transitions locked funds between epochs for a validator bond.",
+        "",
+        "This function should be called at epoch boundaries to update the bond's",
+        "`last_update_epoch` and move the `next_epoch_locked` amount into",
+        "`current_epoch_locked`. It ensures that the update only occurs once per epoch.",
+        "",
+        "# Errors",
+        "Returns [`BondError::InvalidEpoch`] if called more than once in the same epoch,",
+        "or if the system clock cannot be accessed."
+      ],
+      discriminator: [
+        237,
+        102,
+        183,
+        192,
+        94,
+        83,
+        52,
+        82
+      ],
+      accounts: [
+        {
+          name: "validator_bond",
+          writable: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        }
+      ],
+      args: []
+    },
     {
       name: "bond_withdraw",
       docs: [
@@ -5899,6 +6015,11 @@ var jbond_default = {
       code: 6023,
       name: "BondNotEnabled",
       msg: "Bond is not enabled"
+    },
+    {
+      code: 6024,
+      name: "InvalidEpoch",
+      msg: "Invalid epoch for this operation"
     }
   ],
   types: [
@@ -6330,6 +6451,27 @@ var jbond_default = {
               "Bump for the PDA"
             ],
             type: "u8"
+          },
+          {
+            name: "next_epoch_locked",
+            docs: [
+              "Amount of collateral locked for the next epoch"
+            ],
+            type: "u64"
+          },
+          {
+            name: "current_epoch_locked",
+            docs: [
+              "Amount of collateral locked for the current epoch"
+            ],
+            type: "u64"
+          },
+          {
+            name: "last_update_epoch",
+            docs: [
+              "The last epoch when the bond was updated"
+            ],
+            type: "u64"
           }
         ]
       }
@@ -6937,6 +7079,48 @@ var JBondClient = class _JBondClient {
     const authority = this.provider.wallet?.publicKey;
     return this.program.methods.sessionStart(new import_bn.BN(props.duration)).accountsPartial({ bondState, authority }).instruction();
   }
+  /**
+   * Build lock funds instruction
+   */
+  async getLockFundsIx(props) {
+    const { bondType, name, voteAccount, amount } = props;
+    const [bondState] = this.pda.bondState(bondType, name);
+    let collateralType = props.collateralType;
+    if (!collateralType) {
+      const bondState2 = await this.getBondState(bondType, name);
+      collateralType = bondState2.collateralType;
+    }
+    const [validatorBond] = this.pda.validatorBond(bondType, name, voteAccount);
+    const authority = this.provider.wallet?.publicKey;
+    const accounts = {
+      bondState,
+      validatorBond,
+      payer: authority,
+      bondTokenAccount: null
+    };
+    matchVariant(collateralType, {
+      native: () => {
+      },
+      token: (mint) => {
+        const bondTokenAccount = splToken.getAssociatedTokenAddressSync(mint, validatorBond, true);
+        accounts.bondTokenAccount = bondTokenAccount;
+      }
+    });
+    return this.program.methods.bondLockFunds(solToLamports(amount)).accountsPartial(accounts).instruction();
+  }
+  /**
+   * Build release funds instruction
+   */
+  async getReleaseFundsIx(props) {
+    const { bondType, name, voteAccount, amount } = props;
+    const [validatorBond] = this.pda.validatorBond(bondType, name, voteAccount);
+    const authority = this.provider.wallet?.publicKey;
+    const accounts = {
+      validatorBond,
+      payer: authority
+    };
+    return this.program.methods.bondReleaseFunds(solToLamports(amount)).accountsPartial(accounts).instruction();
+  }
   /**
    * Get all bond states with total collected collateral
    */