token-loader

A solidity smart contract which returns information about tokens for a given array of addresses. The contract is designed to handle incomplete interface implementations. The returned value is an array of structs containing the following properties:

• bool definitelyIsERC721: is true for contract which implements the ERC165 interface and all the mandatory ERC721 methods
• address addr: token contract address
• string name: name of the token, when not present defaults to an empty string
• string symbol: symbol of the token, when not present defaults to an empty string
• uint8 decimals: number of decimals in ERC20, when not present is set to 0 (always the case for ERC721)
• uint256 totalSupply: the total token supply, when not present defaults to 0

TokenLoader is deployed on mainnet at 0x497Ccb13988c3255F52422B5080caa7379cF6850.

Installation and deployment

1. Install the dependencies:

       npm install

2. Build the project:

       npm run-script build

3. Run the tests:

       npm test

4. Deploy:

       npx hardhat run scripts/deploy.ts --network NETWORK

5. Verify on Etherscan:

        npx hardhat verify ADDRESS --network NETWORK

   ADDRESS: the address of the deployed contract

   NETWORK: mainnet, ropsten,... (has to be defined in hardhat.config.ts)

uni-token-loader

A solidity smart contract which determines whether a list of tokens are a Uniswap v2 liquidity tokens or not. In case the token is, it returns information about the ERC20 tokens belonging to the pair on the corresponding position in the output ([2i] and [2i + 1]. The returned value is an array of structs containing the following properties:

• address addr: token contract address
• string name: name of the token, when not present defaults to an empty string
• string symbol: symbol of the token, when not present defaults to an empty string
• uint8 decimals: number of decimals in ERC20, when not present is set to 0 (always the case for ERC721)
• uint256 totalSupply: the total token supply, when not present defaults to 0

In case the token is not a Uniswap v2 token, the struct values are set to their defaults and the return value is as follows:

[["0x0000000000000000000000000000000000000000", "", "", 0, 0], ["0x0000000000000000000000000000000000000000", "", "", 0, 0]]

Deployment

1. Deploy:

       npx hardhat run scripts/deploy-uni.ts --network NETWORK

2. Verify on Etherscan:

        npx hardhat verify ADDRESS --network NETWORK

   ADDRESS: the address of the deployed contract

   NETWORK: mainnet, ropsten,... (has to be defined in hardhat.config.ts)