diff --git a/src/main/java/org/qortal/repository/AccountRepository.java b/src/main/java/org/qortal/repository/AccountRepository.java
index 7f82ac9b..f6997fae 100644
--- a/src/main/java/org/qortal/repository/AccountRepository.java
+++ b/src/main/java/org/qortal/repository/AccountRepository.java
@@ -82,7 +82,8 @@ public interface AccountRepository {
*/
public void setMintedBlockCount(AccountData accountData) throws DataException;
- /** Modifies account's minted block count only.
+ /**
+ * Modifies account's minted block count only.
*
* @return 2 if minted block count updated, 1 if block count set to delta, 0 if address not found.
*/
@@ -96,18 +97,32 @@ public interface AccountRepository {
// Account balances
+ /**
+ * Returns account's balance for specific assetID.
+ *
+ * Note: returns null if account has no/zero balance for
+ * that specific assetID. This does not mean
+ * the account itself does not exist.
+ */
public AccountBalanceData getBalance(String address, long assetId) throws DataException;
+ /** How to order results when fetching asset balances. */
public enum BalanceOrdering {
+ /** assetID first, then balance, then account address */
ASSET_BALANCE_ACCOUNT,
+ /** account address first, then assetID */
ACCOUNT_ASSET,
+ /** assetID first, then account address */
ASSET_ACCOUNT
}
+ /** Returns all account balances for given assetID, optionally excluding zero balances. */
public List getAssetBalances(long assetId, Boolean excludeZero) throws DataException;
+ /** Returns account balances for matching addresses / assetIDs, optionally excluding zero balances, with pagination, used by API. */
public List getAssetBalances(List addresses, List assetIds, BalanceOrdering balanceOrdering, Boolean excludeZero, Integer limit, Integer offset, Boolean reverse) throws DataException;
+ /** Modifies account's asset balance by deltaBalance. */
public void modifyAssetBalance(String address, long assetId, long deltaBalance) throws DataException;
public void save(AccountBalanceData accountBalanceData) throws DataException;
diff --git a/src/main/java/org/qortal/repository/AssetRepository.java b/src/main/java/org/qortal/repository/AssetRepository.java
index 3aa70451..94b1ceb0 100644
--- a/src/main/java/org/qortal/repository/AssetRepository.java
+++ b/src/main/java/org/qortal/repository/AssetRepository.java
@@ -25,7 +25,7 @@ public interface AssetRepository {
return getAllAssets(null, null, null);
}
- public List getRecentAssetIds(long start) throws DataException;
+ public List getRecentAssetIds(long startTimestamp) throws DataException;
// For a list of asset holders, see AccountRepository.getAssetBalances
diff --git a/src/main/java/org/qortal/repository/NameRepository.java b/src/main/java/org/qortal/repository/NameRepository.java
index 2dff8df1..e056fb1d 100644
--- a/src/main/java/org/qortal/repository/NameRepository.java
+++ b/src/main/java/org/qortal/repository/NameRepository.java
@@ -28,7 +28,7 @@ public interface NameRepository {
return getNamesByOwner(address, null, null, null);
}
- public List getRecentNames(long start) throws DataException;
+ public List getRecentNames(long startTimestamp) throws DataException;
public void save(NameData nameData) throws DataException;