Add bankhistory to nation and town endpoints

Only the leader/mayor, chancellor/councillor, and/or treasurer can access this info with their API key

Author: Veyronity

docs/nations.md

@@ -210,7 +210,23 @@ Example **POST** response
         }
       },
       "pending": {} // A JSON dictionary representing pending pacts this nation has.
-    }
+    },
+    "bankhistory": [
+      {
+        "time": 1779962429347, // The time the transaction took place, in epoch milliseconds
+        "type": "WITHDRAW", // Transaction type (DEPOSIT, WITHDRAW, ADD, SUBTRACT)
+        "amount": 270, // Transaction amount
+        "balance": 4500, // Balance after the transaction
+        "reason": "Withdraw by Veyronity" // The transaction reason. Either caused by a player or server-side action (e.g. upkeep)
+      },
+      {
+        "time": 1779962436293,
+        "type": "DEPOSIT",
+        "amount": 1000,
+        "balance": 5500,
+        "reason": "Deposit from Veyronity"
+      }
+    ]
   }
 ]
 ```

docs/towns.md

@@ -287,8 +287,30 @@ Example **POST** response
           "z": -9
         }
       }
+    ],
+    "bankhistory": [
+      {
+        "time": 1779962429347, // The time the transaction took place, in epoch milliseconds
+        "type": "WITHDRAW", // Transaction type (DEPOSIT, WITHDRAW, ADD, SUBTRACT)
+        "amount": 300.0, // Transaction amount
+        "balance": 700.0, // Balance after the transaction
+        "reason": "Withdraw by Veyronity" // The transaction reason. Either caused by a player or server-side action (e.g. upkeep)
+      },
+      {
+        "time": 1779962434994,
+        "type": "DEPOSIT",
+        "amount": 200.0,
+        "balance": 900.0,
+        "reason": "Deposit from Veyronity"
+      },
+      {
+        "time": 1779962436293,
+        "type": "DEPOSIT",
+        "amount": 100.0,
+        "balance": 1000.0,
+        "reason": "Deposit from Veyronity"
+      }
     ]
   }
-  }
 ]
 ```

src/main/java/net/earthmc/emcapi/endpoint/towny/NationsEndpoint.java

@@ -14,6 +14,7 @@
 import net.earthmc.emcapi.integration.EmbargoesIntegration;
 import net.earthmc.emcapi.integration.Integrations;
 import net.earthmc.emcapi.integration.PactsIntegration;
+import net.earthmc.emcapi.manager.KeyManager;
 import net.earthmc.emcapi.manager.NationMetadataManager;
 import net.earthmc.emcapi.object.endpoint.PostEndpoint;
 import net.earthmc.emcapi.util.EndpointUtils;
@@ -99,6 +100,7 @@ public JsonElement getJsonElement(Nation nation, @Nullable String key) {
 
         nationObject.add("embargoes", getEmbargoesObject(nation));
         nationObject.add("pacts", getPactsObject(nation));
+        nationObject.add("bankhistory", getBankHistory(nation, key));
 
         return nationObject;
     }
@@ -150,4 +152,21 @@ private JsonObject getPactsObject(Nation nation) {
 
         return json;
     }
+
+    private JsonArray getBankHistory(Nation nation, @Nullable String key) {
+        JsonArray empty = new JsonArray();
+        if (!TownyEconomyHandler.isActive()) {
+            return empty;
+        }
+        UUID keyOwner = KeyManager.getKeyOwner(key);
+        if (keyOwner == null) {
+            return empty;
+        }
+        Resident res = TownyAPI.getInstance().getResident(keyOwner);
+        if (res == null || !nation.equals(res.getNationOrNull()) || !(nation.isKing(res) || res.hasNationRank("Chancellor") || res.hasNationRank("Treasurer"))) {
+            return empty;
+        }
+
+        return EndpointUtils.getBankHistoryArray(nation);
+    }
 }

src/main/java/net/earthmc/emcapi/endpoint/towny/TownsEndpoint.java

@@ -5,6 +5,7 @@
 import com.google.gson.JsonObject;
 import com.palmergames.bukkit.towny.TownyAPI;
 import com.palmergames.bukkit.towny.TownyEconomyHandler;
+import com.palmergames.bukkit.towny.object.Resident;
 import com.palmergames.bukkit.towny.object.Town;
 import com.palmergames.bukkit.towny.object.TownBlock;
 import com.palmergames.bukkit.towny.permissions.TownyPerms;
@@ -13,6 +14,7 @@
 import net.earthmc.emcapi.integration.Integrations;
 import net.earthmc.emcapi.integration.QuartersIntegration;
 import net.earthmc.emcapi.integration.WarpsIntegration;
+import net.earthmc.emcapi.manager.KeyManager;
 import net.earthmc.emcapi.manager.TownMetadataManager;
 import net.earthmc.emcapi.object.endpoint.PostEndpoint;
 import net.earthmc.emcapi.util.EndpointUtils;
@@ -125,6 +127,7 @@ public JsonElement getJsonElement(Town town, @Nullable String key) {
         townObject.add("ranks", ranksObject);
 
         townObject.add("warps", getWarpsObject(town));
+        townObject.add("bankhistory", getBankHistory(town, key));
 
         return townObject;
     }
@@ -142,4 +145,21 @@ private JsonArray getWarpsObject(Town town) {
 
         return json;
     }
+
+    private JsonArray getBankHistory(Town town, @Nullable String key) {
+        JsonArray empty = new JsonArray();
+        if (!TownyEconomyHandler.isActive()) {
+            return empty;
+        }
+        UUID keyOwner = KeyManager.getKeyOwner(key);
+        if (keyOwner == null) {
+            return empty;
+        }
+        Resident res = TownyAPI.getInstance().getResident(keyOwner);
+        if (res == null || !town.equals(res.getTownOrNull()) || !(town.isMayor(res) || res.hasTownRank("Councillor") || res.hasTownRank("Treasurer"))) {
+            return empty;
+        }
+
+        return EndpointUtils.getBankHistoryArray(town);
+    }
 }

src/main/java/net/earthmc/emcapi/util/EndpointUtils.java

@@ -7,6 +7,8 @@
 import com.palmergames.bukkit.towny.object.Resident;
 import com.palmergames.bukkit.towny.object.Town;
 import com.palmergames.bukkit.towny.object.TownyPermission;
+import com.palmergames.bukkit.towny.object.Government;
+import com.palmergames.bukkit.towny.object.economy.BankTransaction;
 import net.earthmc.emcapi.EMCAPI;
 import net.earthmc.lynchpin.api.towny.pacts.Pact;
 import net.earthmc.lynchpin.api.towny.warps.Warp;
@@ -231,4 +233,30 @@ public static JsonObject getWarpObject(Warp warp) {
 
         return json;
     }
+
+    public static JsonArray getBankHistoryArray(Government government) {
+        JsonArray json = new JsonArray();
+        List<BankTransaction> history = government.getAccount().getAuditor().getTransactions();
+        if (history.isEmpty()) {
+            return json;
+        }
+        for (int i = 0; i < Math.min(10, history.size()); i++) {
+            BankTransaction transaction = history.get(i);
+            json.add(getBankTransactionObject(transaction));
+        }
+
+        return json;
+    }
+
+    private static JsonObject getBankTransactionObject(BankTransaction transaction) {
+        JsonObject json = new JsonObject();
+
+        json.addProperty("time", transaction.time());
+        json.addProperty("type", transaction.getType().name());
+        json.addProperty("amount", transaction.getAmount());
+        json.addProperty("balance", transaction.getBalance());
+        json.addProperty("reason", transaction.getReason());
+
+        return json;
+    }
 }