Add support for ERC-721 (NFT) Tokens

Author: Nathan Guggenberger

src/main/java/io/api/etherscan/core/IAccountApi.java

@@ -93,7 +93,7 @@ public interface IAccountApi {
     List<TxInternal> txsInternalByHash(String txhash) throws ApiException;
 
     /**
-     * All token txs for given address
+     * All ERC-20 token txs for given address
      * 
      * @param address    get txs for
      * @param startBlock tx from this blockNumber
@@ -110,6 +110,24 @@ public interface IAccountApi {
     @NotNull
     List<TxToken> txsToken(String address) throws ApiException;
 
+    /**
+     * All ERC-721 (NFT) token txs for given address
+     *
+     * @param address    get txs for
+     * @param startBlock tx from this blockNumber
+     * @param endBlock   tx to this blockNumber
+     * @return txs for address
+     * @throws ApiException parent exception class
+     */
+    @NotNull
+    List<TxToken> txsNftToken(String address, long startBlock, long endBlock) throws ApiException;
+
+    @NotNull
+    List<TxToken> txsNftToken(String address, long startBlock) throws ApiException;
+
+    @NotNull
+    List<TxToken> txsNftToken(String address) throws ApiException;
+
     /**
      * All blocks mined by address
      * 

src/main/java/io/api/etherscan/core/impl/AccountApiProvider.java

@@ -34,6 +34,7 @@ public class AccountApiProvider extends BasicProvider implements IAccountApi {
     private static final String ACT_TX_ACTION = ACT_PREFIX + "txlist";
     private static final String ACT_TX_INTERNAL_ACTION = ACT_PREFIX + "txlistinternal";
     private static final String ACT_TX_TOKEN_ACTION = ACT_PREFIX + "tokentx";
+    private static final String ACT_TX_NFT_TOKEN_ACTION = ACT_PREFIX + "tokennfttx";
     private static final String ACT_MINED_ACTION = ACT_PREFIX + "getminedblocks";
 
     private static final String BLOCK_TYPE_PARAM = "&blocktype=blocks";
@@ -229,6 +230,29 @@ public List<TxToken> txsToken(final String address, final long startBlock, final
         return getRequestUsingOffset(urlParams, TxTokenResponseTO.class);
     }
 
+
+    @Override
+    public @NotNull List<TxToken> txsNftToken(String address) throws ApiException {
+        return txsNftToken(address, MIN_START_BLOCK);
+    }
+
+    @Override
+    public @NotNull List<TxToken> txsNftToken(String address, long startBlock) throws ApiException {
+        return txsNftToken(address, startBlock, MAX_END_BLOCK);
+    }
+
+    @Override
+    public @NotNull List<TxToken> txsNftToken(String address, long startBlock, long endBlock) throws ApiException {
+        BasicUtils.validateAddress(address);
+        final BlockParam blocks = BasicUtils.compensateBlocks(startBlock, endBlock);
+
+        final String offsetParam = PAGE_PARAM + "%s" + OFFSET_PARAM + OFFSET_MAX;
+        final String blockParam = START_BLOCK_PARAM + blocks.start() + END_BLOCK_PARAM + blocks.end();
+        final String urlParams = ACT_TX_NFT_TOKEN_ACTION + offsetParam + ADDRESS_PARAM + address + blockParam + SORT_ASC_PARAM;
+
+        return getRequestUsingOffset(urlParams, TxTokenResponseTO.class);
+    }
+
     @NotNull
     @Override
     public List<Block> minedBlocks(final String address) throws ApiException {