Added canDeposit, canWithdraw, and canHold methods

Enhanced `Bank` and `Account` APIs with balance operation checks. Implemented default behaviors and updated wrappers to align with the new methods for consistent validation logic.

Author: NonSwag

plugin/src/main/java/net/thenextlvl/service/wrapper/service/model/WrappedAccount.java

@@ -59,4 +59,9 @@ public BigDecimal setBalance(Number balance, Currency currency) {
         else if (difference < 0) return withdraw(-difference, currency);
         return BigDecimal.ZERO;
     }
+
+    @Override
+    public boolean canHold(Currency currency) {
+        return true;
+    }
 }

plugin/src/main/java/net/thenextlvl/service/wrapper/service/model/WrappedBank.java

@@ -69,6 +69,11 @@ public BigDecimal setBalance(Number balance, Currency currency) {
         return current;
     }
 
+    @Override
+    public boolean canHold(Currency currency) {
+        return false;
+    }
+
     @Override
     public @Unmodifiable Set<UUID> getMembers() {
         return Arrays.stream(plugin.getServer().getOfflinePlayers())
@@ -101,4 +106,24 @@ public boolean removeMember(UUID uuid) {
     public boolean setOwner(UUID uuid) {
         return false;
     }
+
+    @Override
+    public boolean canDeposit(OfflinePlayer player, Number amount, Currency currency) {
+        return economy.isBankOwner(getName(), player).transactionSuccess();
+    }
+
+    @Override
+    public boolean canDeposit(UUID uuid, Number amount, Currency currency) {
+        return canDeposit(plugin.getServer().getOfflinePlayer(uuid), amount, currency);
+    }
+
+    @Override
+    public boolean canWithdraw(OfflinePlayer player, Number amount, Currency currency) {
+        return economy.isBankOwner(getName(), player).transactionSuccess();
+    }
+
+    @Override
+    public boolean canWithdraw(UUID uuid, Number amount, Currency currency) {
+        return canWithdraw(plugin.getServer().getOfflinePlayer(uuid), amount, currency);
+    }
 }

src/main/java/net/thenextlvl/service/api/economy/Account.java

@@ -91,4 +91,12 @@ default int compareTo(Account account, Currency currency) {
      * @since 3.0.0
      */
     BigDecimal setBalance(Number balance, Currency currency);
+
+    /**
+     * Checks if the account can hold the specified currency.
+     *
+     * @param currency the currency to check support for
+     * @return {@code true} if the account can hold the specified currency, otherwise {@code false}
+     */
+    boolean canHold(Currency currency);
 }

src/main/java/net/thenextlvl/service/api/economy/bank/Bank.java

@@ -109,4 +109,56 @@ default boolean setOwner(OfflinePlayer player) {
      * @return {@code true} if the owner was successfully set, otherwise {@code false}
      */
     boolean setOwner(UUID uuid);
+
+    /**
+     * Checks whether the specified player can deposit the specified amount in the given currency.
+     * <p>
+     * Returns {@code false} if {@link #canHold(Currency)} returns {@code false}
+     *
+     * @param player   the player attempting to make the deposit
+     * @param amount   the amount being attempted to deposit
+     * @param currency the currency of the deposit
+     * @return {@code true} if the player can deposit the specified amount, otherwise {@code false}
+     */
+    default boolean canDeposit(OfflinePlayer player, Number amount, Currency currency) {
+        return canDeposit(player.getUniqueId(), amount, currency);
+    }
+
+    /**
+     * Checks whether the specified uuid can deposit the specified amount in the given currency.
+     * <p>
+     * Returns {@code false} if {@link #canHold(Currency)} returns {@code false}
+     *
+     * @param uuid     the uuid of the player attempting to make the deposit
+     * @param amount   the amount being attempted to deposit
+     * @param currency the currency of the deposit
+     * @return {@code true} if the player can deposit the specified amount, otherwise {@code false}
+     */
+    boolean canDeposit(UUID uuid, Number amount, Currency currency);
+
+    /**
+     * Checks whether the specified player can withdraw the specified amount in the given currency.
+     * <p>
+     * Returns {@code false} if {@link #canHold(Currency)} returns {@code false}
+     *
+     * @param player   the player attempting to make the withdrawal
+     * @param amount   the amount being attempted to withdraw
+     * @param currency the currency of the withdrawal
+     * @return {@code true} if the player can withdraw the specified amount, otherwise {@code false}
+     */
+    default boolean canWithdraw(OfflinePlayer player, Number amount, Currency currency) {
+        return canWithdraw(player.getUniqueId(), amount, currency);
+    }
+
+    /**
+     * Checks whether the specified uuid can withdraw the specified amount in the given currency.
+     * <p>
+     * Returns {@code false} if {@link #canHold(Currency)} returns {@code false}
+     *
+     * @param uuid     the UUID of the player attempting to make the withdrawal
+     * @param amount   the amount being attempted to withdraw
+     * @param currency the currency of the withdrawal
+     * @return {@code true} if the player can withdraw the specified amount, otherwise {@code false}
+     */
+    boolean canWithdraw(UUID uuid, Number amount, Currency currency);
 }