Merge pull request #143 from manishdait/issue-98

feat: Implemented TokenRepository to interact with MirrorNodeClient API

Author: hendrikebbers

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/Balance.java

@@ -0,0 +1,12 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.AccountId;
+import org.jspecify.annotations.NonNull;
+
+import java.util.Objects;
+
+public record Balance(@NonNull AccountId accountId, long balance, long decimals) {
+    public Balance {
+        Objects.requireNonNull(accountId, "accountId must not be null");
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/CustomFee.java

@@ -0,0 +1,18 @@
+package com.openelements.hiero.base.data;
+
+import org.jspecify.annotations.NonNull;
+
+import java.util.List;
+import java.util.Objects;
+
+public record CustomFee(
+        @NonNull List<FixedFee> fixedFees,
+        @NonNull List<FractionalFee> fractionalFees,
+        @NonNull List<RoyaltyFee> royaltyFees
+) {
+    public CustomFee {
+        Objects.requireNonNull(fixedFees, "fixedFees must not be null");
+        Objects.requireNonNull(fractionalFees, "fractionalFees must not be null");
+        Objects.requireNonNull(royaltyFees, "royaltyFees must not be null");
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/FixedFee.java

@@ -0,0 +1,9 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.AccountId;
+import com.hedera.hashgraph.sdk.TokenId;
+import org.jspecify.annotations.Nullable;
+
+public record FixedFee(long amount, @Nullable AccountId collectorAccountId, @Nullable TokenId denominatingTokenId) {
+    public FixedFee {}
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/FractionalFee.java

@@ -0,0 +1,21 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.AccountId;
+import com.hedera.hashgraph.sdk.TokenId;
+import org.jspecify.annotations.Nullable;
+
+public record FractionalFee(
+        long numeratorAmount,
+        long denominatorAmount,
+        @Nullable AccountId collectorAccountId,
+        @Nullable TokenId denominatingTokenId
+) {
+    public FractionalFee {
+        if (numeratorAmount < 0) {
+            throw new IllegalArgumentException("numeratorAmount must be greater than or equal to 0");
+        }
+        if (denominatorAmount < 0) {
+            throw new IllegalArgumentException("denominatorAmount must be greater than or equal to 0");
+        }
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/RoyaltyFee.java

@@ -0,0 +1,22 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.AccountId;
+import com.hedera.hashgraph.sdk.TokenId;
+import org.jspecify.annotations.Nullable;
+
+public record RoyaltyFee(
+        long numeratorAmount,
+        long denominatorAmount,
+        long fallbackFeeAmount,
+        @Nullable AccountId collectorAccountId,
+        @Nullable TokenId denominatingTokenId
+) {
+    public RoyaltyFee {
+        if (numeratorAmount < 0) {
+            throw new IllegalArgumentException("numeratorAmount must be greater than or equal to 0");
+        }
+        if (denominatorAmount < 0) {
+            throw new IllegalArgumentException("denominatorAmount must be greater than or equal to 0");
+        }
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/Token.java

@@ -0,0 +1,24 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.TokenId;
+import com.hedera.hashgraph.sdk.TokenType;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
+
+import java.util.Objects;
+
+public record Token(
+        long decimals,
+        byte[] metadata,
+        @NonNull String name,
+        @NonNull String symbol,
+        @Nullable TokenId tokenId,
+        @NonNull TokenType type
+) {
+    public Token {
+        Objects.requireNonNull(type, "type must not be null");
+        Objects.requireNonNull(name, "name must not be null");
+        Objects.requireNonNull(symbol, "symbol must not be null");
+        Objects.requireNonNull(metadata, "metadata must not be null");
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/data/TokenInfo.java

@@ -0,0 +1,47 @@
+package com.openelements.hiero.base.data;
+
+import com.hedera.hashgraph.sdk.AccountId;
+import com.hedera.hashgraph.sdk.TokenId;
+import com.hedera.hashgraph.sdk.TokenSupplyType;
+import com.hedera.hashgraph.sdk.TokenType;
+import org.jspecify.annotations.NonNull;
+import org.jspecify.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.Objects;
+
+public record TokenInfo(
+        @NonNull TokenId tokenId,
+        @NonNull TokenType type,
+        @NonNull String name,
+        @NonNull String symbol,
+        @Nullable String memo,
+        long decimals,
+        byte[] metadata,
+        @NonNull Instant createdTimestamp,
+        @NonNull Instant modifiedTimestamp,
+        @Nullable Instant expiryTimestamp,
+        @NonNull TokenSupplyType supplyType,
+        @NonNull String initialSupply,
+        @NonNull String totalSupply,
+        @NonNull String maxSupply,
+        @NonNull AccountId treasuryAccountId,
+        boolean deleted,
+        @NonNull CustomFee customFees
+) {
+    public TokenInfo {
+        Objects.requireNonNull(tokenId, "tokenId must not be null");
+        Objects.requireNonNull(type, "type must not be null");
+        Objects.requireNonNull(name, "name must not be null");
+        Objects.requireNonNull(symbol, "symbol must not be null");
+        Objects.requireNonNull(metadata, "metadata must not be null");
+        Objects.requireNonNull(createdTimestamp, "createdTimestamp must not be null");
+        Objects.requireNonNull(modifiedTimestamp, "modifiedTimestamp must not be null");
+        Objects.requireNonNull(supplyType, "supplyType must not be null");
+        Objects.requireNonNull(initialSupply, "initialSupply must not be null");
+        Objects.requireNonNull(totalSupply, "totalSupply must not be null");
+        Objects.requireNonNull(maxSupply, "maxSupply must not be null");
+        Objects.requireNonNull(treasuryAccountId, "treasuryAccountId must not be null");
+        Objects.requireNonNull(customFees, "customFees must not be null");
+    }
+}

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/implementation/AbstractMirrorNodeClient.java

@@ -10,6 +10,7 @@
 import com.openelements.hiero.base.data.NetworkSupplies;
 import com.openelements.hiero.base.data.Nft;
 import com.openelements.hiero.base.data.NftMetadata;
+import com.openelements.hiero.base.data.TokenInfo;
 import com.openelements.hiero.base.mirrornode.MirrorNodeClient;
 import java.util.List;
 import java.util.Objects;
@@ -68,6 +69,12 @@ final Optional<NetworkSupplies> queryNetworkSupplies() throws HieroException {
         return getJsonConverter().toNetworkSupplies(json);
     }
 
+    @NonNull
+    public final Optional<TokenInfo> queryTokenById(@NonNull TokenId tokenId) throws HieroException {
+        final JSON json = getRestClient().queryTokenById(tokenId);
+        return getJsonConverter().toTokenInfo(json);
+    }
+
     @Override
     public @NonNull Optional<NftMetadata> getNftMetadata(TokenId tokenId) throws HieroException {
         throw new UnsupportedOperationException("Not yet implemented");

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/implementation/MirrorNodeJsonConverter.java

@@ -7,6 +7,10 @@
 import com.openelements.hiero.base.data.NetworkSupplies;
 import com.openelements.hiero.base.data.Nft;
 import com.openelements.hiero.base.data.TransactionInfo;
+import com.openelements.hiero.base.data.Token;
+import com.openelements.hiero.base.data.TokenInfo;
+import com.openelements.hiero.base.data.Balance;
+
 import java.util.List;
 import java.util.Optional;
 import org.jspecify.annotations.NonNull;
@@ -36,4 +40,9 @@ public interface MirrorNodeJsonConverter<JSON> {
 
     List<Nft> toNfts(@NonNull JSON json);
 
+    Optional<TokenInfo> toTokenInfo(JSON json);
+
+    List<Balance> toBalances(JSON node);
+
+    List<Token> toTokens(JSON node);
 }

hiero-enterprise-base/src/main/java/com/openelements/hiero/base/implementation/MirrorNodeRestClient.java

@@ -50,6 +50,11 @@ default JSON queryNetworkSupplies() throws HieroException {
         return doGetCall("/api/v1/network/supply");
     }
 
+    @NonNull
+    default  JSON queryTokenById(TokenId tokenId) throws HieroException {
+        return doGetCall("/api/v1/tokens/" + tokenId);
+    }
+
     @NonNull
     JSON doGetCall(@NonNull String path) throws HieroException;
 }