ethereum-hooks 1.0.1

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721CollectionVolume.ts

@@ -0,0 +1,19 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Collection Volume Hook
+export const useFetchERC721CollectionVolume = async (port: number) => {
+
+    // Set options for request
+    let options = {
+        method: 'POST',
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-collection-volume`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721Holdings.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Holdings hook
+export const useFetchERC721Holdings = async (walletAddress: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ walletAddress }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-holdings`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721LookupData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Lookup Data hook
+export const useFetchERC721LookupData = async (contractAddress: string, tokenID: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-lookup-data`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721OpenseaData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Opensea data hook
+export const useFetchERC721OpenseaData = async (contractAddress: string, tokenID: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-opensea-data`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721RarityData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Rarity data hook
+export const useFetchERC721RarityData = async (contractAddress: string, tokenID: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-rarity-data`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721SalesData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Sales data hook
+export const useFetchERC721SalesData = async (contractAddress: string, tokenID: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-sales-data`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721TransferLookupData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Transfer Lookup data hook
+export const useFetchERC721TransferLookupData = async (contractAddress: string, tokenID: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-token-transfer-lookup-data`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc721Tokens/useFetchERC721TransfersData.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Transfer data hook
+export const useFetchERC721TransfersData = async (walletAddress: string, port: number) => {
+    
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ walletAddress }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-wallet-transfers`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/gas/useFetchGasLookup.ts

@@ -0,0 +1,17 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching Address to ENS Custom hook
+export const useFetchGasLookup = (port: number) => {
+    const URL = `http://localhost:${port}/gas-information`; // Define the API endpoint
+    
+    const options = {
+        method: 'GET',
+        headers: {
+            'accept': 'application/json'
+        }
+    };
+
+    const state = useFetch(URL, options); // Use the custom hook to fetch data
+
+    return state; // Return the state from the custom hook
+}

package/client/src/crypto_hooks/prices/useFetchERC20Price.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC20 Prices Hook
+export const useFetchERC20Price = async (contractAddress: string, currentPrice: boolean, duration: 2 | 14 | 30, port: number) => {
+
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, currentPrice, duration }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc20-token-price`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/prices/useFetchERC721Price.ts

@@ -0,0 +1,19 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Prices Hook
+export const useFetchERC721Price = async (contractAddress: string, tokenID: number, port: number) => {
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, tokenID }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-token-price`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/prices/useFetchETHPrice.ts

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ETH Prices Hook
+export const useFetchETHPrice = async (currentPrice: boolean, duration: 2 | 14 | 30, port: number) => {
+
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ currentPrice, duration }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/eth-price`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/prices/useFetchLayerTwoPrice.ts

@@ -0,0 +1,21 @@
+import { LayerTwoNetworks } from "../../types/LayerTwoType";
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching Layer Two Prices Hook
+export const useFetchLayerTwoPrice = async (layerTwo: LayerTwoNetworks, currentPrice: boolean, duration: 2 | 14 | 30, port: number) => {
+
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ layerTwo: LayerTwoNetworks[layerTwo], currentPrice, duration }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/layer-two-prices`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/custom_hooks/useFetch.ts

@@ -0,0 +1,34 @@
+import { useEffect, useState } from 'react';
+import { FetchStateType } from '../types/FetchStateType';
+
+// Custom hook for fetching data using the FETCH Client API
+export const useFetch = <T = any>(URL: string, options: RequestInit = {}) => {
+    const [state, setState] = useState<FetchStateType<T>>({
+        data: null,
+        loading: false,
+        error: false
+    });
+
+    // On useFetch call, make the appropriate API request
+    // Set the state accordingly
+    useEffect(() => {
+        (async () => {
+            setState({ data: null, loading: true, error: false });
+            try {
+                const response = await fetch(URL, options);
+                if (response.ok) {
+                    const json = await response.json();
+                    setState({ data: json, loading: false, error: false });
+                } 
+                else {
+                    setState({ data: null, loading: false, error: true });
+                }
+            } 
+            catch (err) {
+                setState({ data: null, loading: false, error: true });
+            }
+        })();
+    }, [URL]);
+
+    return state;
+}

package/client/src/types/FetchStateType.ts

@@ -0,0 +1,6 @@
+// Custom interface for working with the Fetch State
+export interface FetchStateType<T = any> {
+    data: T | null;
+    loading: boolean;
+    error: boolean;
+}

package/client/src/types/LayerTwoType.ts

@@ -0,0 +1,22 @@
+export enum LayerTwoNetworks { // Added export keyword
+    Optimism = "optimism",
+    Arbitrum = "arbitrum",
+    Polygon = "matic-network",
+    ZkSync = "zksync",
+    ImmutableX = "immutable-x",
+    StarkNet = "starknet",
+    BobaNetwork = "boba-network",
+    Sushiswap = "sushi",
+    Metis = "metis-token",
+    HermezNetwork = "hermez-network-token",
+    CelerNetwork = "celer-network",
+    SynthetixSNXOnOptimism = "havven",
+    Deversifi = "devve",
+    Loopring = "loopring",
+    Biconomy = "biconomy",
+    BancorOnArbitrum = "bancor",
+    AaveOnOptimism = "aave",
+    PerpetualProtocol = "perpetual-protocol",
+    Cartesi = "cartesi",
+    Zora = "zora-bridged-weth-zora-network",
+}

package/hooksinformation.txt

@@ -0,0 +1,49 @@
+List of the 30 React Hooks
+
+Prices
+useFetchETHPrice - [Current Price, Duration]
+useFetchERC20Price - [Contract Address, Current Price, Duration]
+useFetchERC721Price - [Contract Address, Token ID]
+useFetchLayerTwoPrice - [Layer Two Network, Current Price, Duration]
+
+-
+
+ERC20 Tokens
+useFetchERC20CollectionOwners - [Contract Address]
+useFetchERC20CollectionTopCoins - []
+useFetchERC20CollectionTransfers - [Contract Address]
+useFetchERC20Holdings - [Contract Address]
+useFetchERC20Transfers - [Contract Address]
+
+-
+
+ERC721 Tokens
+useFetchERC721CollectionAttributes - [Contract Address]
+useFetchERC721CollectionData - [Contract Address]
+useFetchERC721CollectionExtraData - [Contract Address]
+useFetchERC721CollectionFloorPrice - [Contract Address]
+useFetchERC721CollectionMarketCap - [Contract Address, Duration]
+useFetchERC721CollectionSales - [Contract Address]
+useFetchERC721CollectionTransfers - [Contract Address]
+useFetchERC721CollectionTrends - []
+useFetchERC721CollectionVolume - []
+useFetchERC721Holdings - [Wallet Address]
+useFetchERC721LookupData - [Contract Address, Token ID]
+useFetchERC721OpenseaData - [Contract Address, Token ID]
+useFetchERC721RarityData - [Contract Address, Token ID]
+useFetchERC721SalesData - [Contract Address, Token ID]
+useFetchERC721TransferLookupData - [Contract Address, Token ID]
+useFetchERC721Transfers - [Wallet Address]
+
+-
+
+ENS
+useFetchAddressENSLookup - [Address]
+useFetchENSAddressLookup - [ENS Name]
+useFetchENSIDLookup - [ID]
+useFetchENSNameLookup - [ENS Name]
+
+-
+
+Gas
+useFetchGasLookup - []

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ethereum-hooks",
+  "version": "1.0.1",
+  "description": "Package containing useful React hooks for working with the Ethereum Blockchain.",
+  "main": "server/server.ts",
+  "scripts": {
+    "start": "ts-node server/server.ts",
+    "client": "cd client && npm start",
+    "build": "cd client && npm run build",
+    "install-all": "cd client && npm install && cd ../server && npm install",
+    "build-server": "tsc -p server/tsconfig.json",
+    "test": "echo \"No tests specified\" && exit 0"
+  },
+  "keywords": [
+    "api",
+    "blockchain",
+    "client",
+    "crypto",
+    "ethereum",
+    "expressjs",
+    "hooks",
+    "nodejs",
+    "reactjs",
+    "server"
+  ],
+  "author": "CodingAbdullah",
+  "license": "MIT",
+  "private": false,
+  "devDependencies": {
+    "ts-node": "^10.9.0",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "ethereum-hooks": "file:"
+  }
+}

package/server/Controller/ENS/AddressToENSController.ts

@@ -0,0 +1,30 @@
+require("dotenv").config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from 'axios';
+
+// Address to ENS information
+export const addressToENSInformation = (req: Request, res: Response) => {
+    const { address } = JSON.parse(req.body.body);
+
+    const MORALIS_URL = 'https://deep-index.moralis.io/api/v2/';
+    const options = {   
+        method: 'GET', 
+        mode: 'cors', // *cors, same-origin
+        headers: { 
+            'content-type' : 'application/json', 
+            'access-control-allow-origin': '*',
+            'X-API-KEY' : process.env.MORALIS_API_KEY // Transpose API key hidden 
+        }
+    }
+
+    // Making back-end request call for information
+    axios.get(MORALIS_URL + 'resolve/' + address + "/reverse", options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        })
+    })
+    .catch(() => {
+        res.status(400).json({});
+    })
+}

package/server/Controller/ENS/ENSIDController.ts

@@ -0,0 +1,32 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from 'axios';
+
+// ENS Transfers By ID
+export const ensTransfersById = (req: Request, res: Response) => {
+    const { id } = JSON.parse(req.body.body);
+
+    const params = {
+        chain_id : 'ethereum',
+        token_id: id
+    }
+
+    const options = {
+        headers: {
+            'accept' : 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.TRANSPOSE_API_KEY
+        } 
+    }
+
+    // Making back-end request call to fetch data
+    axios.get('https://api.transpose.io/ens/ens-transfers-by-token-id?' + new URLSearchParams(params), options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        })
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}

package/server/Controller/ENS/ENSNameController.ts

@@ -0,0 +1,32 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from 'axios';
+
+// ENS Transfers By Name
+export const ensTransfersByName = (req: Request, res: Response) => {
+    const { ensName } = JSON.parse(req.body.body);
+
+    const params = {
+        chain_id : 'ethereum',
+        ens_name: ensName
+    }
+
+    const options = {
+        headers: {
+            'accept' : 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.TRANSPOSE_API_KEY
+        } 
+    }
+
+    // Making back-end request call for information
+    axios.get('https://api.transpose.io/ens/ens-transfers-by-name?' + new URLSearchParams(params), options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        });
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}

package/server/Controller/ENS/ENSToAddressController.ts

@@ -0,0 +1,32 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express'
+import axios from 'axios';
+
+// ENS to Address Controller
+export const additionalENSInformation = (req: Request, res: Response) => {
+    const { ensName } = JSON.parse(req.body.body);
+    
+    const params = {
+        "chain_id": "ethereum",
+        "ens_names": ensName,
+    }
+    
+    const options = {
+        headers: {
+            'accept' : 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.TRANSPOSE_API_KEY
+        } 
+    }
+
+    // Making back-end request call for information
+    axios.get("https://api.transpose.io/ens/ens-records-by-name?" + new URLSearchParams(params), options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        })
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}

package/server/Controller/ERC20Tokens/ERC20CollectionOwnersController.ts

@@ -0,0 +1,29 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from "axios";
+
+// Controller function for fetching ERC20 Collection Owners data
+export const ERC20CollectionOwnersController = (req: Request, res: Response) => {
+    const { contractAddress } = JSON.parse(req.body.body);
+    
+    // Add ERC20 Collection Owners Controller data parameters
+    const options = {
+        method: 'GET',
+        headers: {
+            'accept': 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.MORALIS_API_KEY
+        }
+    }
+
+    // Conditionally making API calls for ERC20 Collection Owners Controller
+    axios.get('https://deep-index.moralis.io/api/v2.2/erc20/' + contractAddress + '/owners?chain=eth&order=DESC', options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        });
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}

package/server/Controller/ERC20Tokens/ERC20CollectionTopCoinsController.ts

@@ -0,0 +1,27 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from "axios";
+
+// Controller function for fetching ERC20 Collection Top Coins data
+export const ERC20CollectionTopCoinsController = (req: Request, res: Response) => {    
+    // Add ERC20 Top Coins Controller data parameters
+    const options = {
+        method: 'GET',
+        headers: {
+            'accept': 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.MORALIS_API_KEY
+        }
+    }
+
+    // Conditionally making API calls for ERC20 Top Coins Controller
+    axios.get('https://deep-index.moralis.io/api/v2.2/market-data/erc20s/top-tokens', options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        });
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}

package/server/Controller/ERC20Tokens/ERC20CollectionTransfersController.ts

@@ -0,0 +1,29 @@
+require('dotenv').config({ path: '../.env' });
+import { Request, Response } from 'express';
+import axios from "axios";
+
+// Controller function for fetching ERC20 Collection Transfers data
+export const ERC20CollectionTransfersController = (req: Request, res: Response) => {   
+    const { contractAddress } = JSON.parse(req.body.body);
+
+    // Add ERC20 Collection Transfers Controller data parameters
+    const options = {
+        method: 'GET',
+        headers: {
+            'accept': 'application/json',
+            'content-type': 'application/json',
+            'X-API-KEY' : process.env.MORALIS_API_KEY
+        }
+    }
+
+    // Conditionally making API calls for ERC20 Collection Transfers Controller
+    axios.get("https://deep-index.moralis.io/api/v2.2/erc20/" + contractAddress + '/transfers', options)
+    .then(response => {
+        res.status(200).json({
+            information: response.data
+        });
+    })
+    .catch(() => {
+        res.status(400).json({});
+    });
+}