ethereum-hooks 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Abdullah Muhammad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,246 @@
+# ethereum-hooks
+A package containing useful hooks for working with the Ethereum blockchain using crypto APIs. The following resources will be referenced when building these hooks:
+
+- <a href="https://docs.alchemy.com/reference/api-overview">Alchemy</a>
+- <a href="https://docs.blocknative.com/">Blocknative</a>
+- <a href="https://docs.coingecko.com/v3.0.1/reference/introduction">CoinGecko</a>
+- <a href="https://docs.moralis.com/">Moralis</a>
+- <a href="https://docs.opensea.io/reference/api-overview">Opensea</a>
+- <a href="https://docs.transpose.io/">Transpose</a>
+
+<br />
+
+## React Hooks Client-Server Setup
+When working with this package, you will need to implement the typical MERN design pattern. Set up <code>.env</code> variables and set up the server to allow the client hooks to establish communication.
+
+<b>You will need to set the following environment variables in your <code>.env</code> file: </b>
+
+- <code>ALCHEMY_API_KEY</code>
+- <code>BLK_API_KEY</code>
+- <code>CLIENT_PORT</code>
+- <code>COINGECKO_API_KEY</code>
+- <code>MORALIS_API_KEY</code>
+- <code>OPENSEA_API_KEY</code>
+- <code>PORT</code>
+- <code>TRANSPOSE_API_KEY</code>
+
+The following diagram will help you understand the flow of how everything works:
+
+<img src="https://genericbucket95.s3.us-east-2.amazonaws.com/hook-server-design.png" alt="Hook Server" width="600" height="400" />
+
+<br />
+
+## Link to Published NPM Package
+- <a href="https://www.npmjs.com/package/ethereum-hooks">Ethereum Hooks</a>
+
+<br />
+
+## Server Setup
+
+For this part, you will need to incorporate the server object exported from the <code>server.ts</code> file inside the server directory.
+<b>You will need to build on top of this built-in server any additional routes and configurations as this server contains all the routes needed to effectively use the client hooks. </b>
+
+<br />
+
+## React Client Hooks
+
+The hooks cover several areas of the Ethereum blockchain and can be used for Layer Two chains as well. You will need to specify the <b>server port number</b> in order to access it for local development API calls.
+A list of what chains are supported is provided below in the <code>Types</code> section.
+
+The following table highlights the 30 different client hooks:
+
+<table>
+    <tr>
+        <th>Category</th>
+        <th>Client Hook Name</th>
+        <th>Description</th>
+    <tr>
+    <tr>
+        <td>ENS</td>
+        <td><code>useFetchAddressENSLookup(address: string, port: number)</code></td>
+        <td>Fetch the equivalent ENS name from a given address</td>
+    </tr>
+    <tr>
+        <td>ENS</td>
+        <td><code>useFetchENSAddressLookup(ensName: string, port: number)</code></td>
+        <td>Fetch the equivalent ETH address from a given ENS name</td>
+    </tr>
+    <tr>
+        <td>ENS</td>
+        <td><code>useFetchENSIDLookup(id: string, port: number)</code></td>
+        <td>Fetch information of a given ENS ID</td>
+    </tr>
+    <tr>
+        <td>ENS</td>
+        <td><code>useFetchENSNameLookup(ensName: string, port: number)</code></td>
+        <td>Fetch information of a given ENS name</td>
+    </tr>
+    <tr>
+        <td>ERC20</td>
+        <td><code>useFetchERC20CollectionOwners(contractAddress: string, port: number)</code></td>
+        <td>Fetch list of owners of a particular ERC20 collection</td>
+    </tr>
+    <tr>
+        <td>ERC20</td>
+        <td><code>useFetchERC20CollectionTopCoins(port: number)</code></td>
+        <td>Fetch list of the top ERC20 collections</td>
+    </tr>
+    <tr>
+        <td>ERC20</td>
+        <td><code>useFetchERC20CollectionTransfers(contractAddress: string, port: number)</code></td>
+        <td>Fetch transfer activity of a particular ERC20 collection</td>
+    </tr>
+    <tr>
+        <td>ERC20</td>
+        <td><code>useFetchERC20Holdings(contractAddress: string, port: number)</code></td>
+        <td>Track wallet holdings of a particular ERC20 token activity</td>
+    </tr>
+    <tr>
+        <td>ERC20</td>
+        <td><code>useFetchERC20Transfers(contractAddress: string, port: number)</code></td>
+        <td>Track the transfer activity of a particular ERC20 token in a wallet</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionAttributes(contractAddress: string, port: number)</code></td>
+        <td>Fetch attributes of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionData(contractAddress: string, port: number)</code></td>
+        <td>Fetch data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionExtraData(contractAddress: string, port: number)</code></td>
+        <td>Fetch extra data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionFloorPrice(contractAddress: string, port: number)</code></td>
+        <td>Fetch floor price data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionMarketCap(contractAddress: string, duration: 2 | 14 | 30, port: number)</code></td>
+        <td>Fetch market cap data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionSales(contractAddress: string, port: number)</code></td>
+        <td>Fetch sales data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionTransfers(contractAddress: string, port: number)</code></td>
+        <td>Fetch transfer activity of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionTrends(port: number)</code></td>
+        <td>Fetch trending ERC721 collection data</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721CollectionVolume(port: number)</code></td>
+        <td>Fetch ERC721 collections by volume data</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721Holdings(walletAddress: string, port: number)</code></td>
+        <td>Fetch ERC721 holdings of a particular wallet</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721LookupData(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch data of a particular ERC721 token</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721OpenseaData(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch Opensea data of a particular ERC721 token</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721RarityData(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch rarity data of a particular ERC721 token</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721SalesData(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch sales data of a particular ERC721 token</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721TransferLookupData(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch transfer data of a particular ERC721 token</td>
+    </tr>
+    <tr>
+        <td>ERC721</td>
+        <td><code>useFetchERC721TransfersData(walletAddress: string, port: number)</code></td>
+        <td>Fetch ERC721 transfer activity of a particular wallet</td>
+    </tr>
+    <tr>
+        <td>Gas</td>
+        <td><code>useFetchGasLookup(port: number)</code></td>
+        <td>Fetch gas information related to Ethereum or a supported layer two</td>
+    </tr>
+    <tr>
+        <td>Prices</td>
+        <td><code>useFetchERC20Price(contractAddress: string, currentPrice: boolean, duration: 2 | 14 | 30, port: number)</code></td>
+        <td>Fetch pricing data of a particular ERC20 collection</td>
+    </tr>
+    <tr>
+        <td>Prices</td>
+        <td><code>useFetchERC721Price(contractAddress: string, tokenID: string, port: number)</code></td>
+        <td>Fetch pricing data of a particular ERC721 collection</td>
+    </tr>
+    <tr>
+        <td>Prices</td>
+        <td><code>useFetchETHPrice(currentPrice: boolean, duration: 2 | 14 | 30, port: number)</code></td>
+        <td>Fetch Ethereum price data</td>
+    </tr>
+    <tr>
+        <td>Prices</td>
+        <td><code>useFetchLayerTwoPrice(layerTwo: LayerTwoNetworks, currentPrice: boolean, duration: 2 | 14 | 30, port: number)</code></td>
+        <td>Fetch Layer Two price data</td>
+    </tr>
+</table>
+
+<br />
+
+## Custom Hooks
+Custom hooks were used for development convenience and were fully incorporated into the main client hooks. The following table depicts the custom hooks:
+
+<table>
+    <tr>
+        <th>Custom Hook</th>
+        <th>Function</th>
+    <tr>
+    <tr>
+        <td><code>useFetch</code></td>
+        <td>To fetch data readily using a set of defined parameters</td>
+    </tr>
+</table>
+
+<br />
+
+## Types
+Custom data types were developed for fetch state and defining a set of available layer two networks 
+
+<table>
+    <tr>
+        <th>Custom Data Type</th>
+        <th>Function</th>
+    <tr>
+    <tr>
+        <td><code>FetchStateType</code></td>
+        <td>To fetch data readily using a set of defined parameters</td>
+    </tr>
+    <tr>
+        <td><code>LayerTwoType</code></td>
+        <td>
+            Set of defined Layer Two Networks: <code>optimism</code>, <code>arbitrum</code>, <code>matic-network</code>, <code>zksync</code>, <code>immutable-x</code>, <code>starknet</code>, <code>boba-network</code>, <code>sushi</code>, <code>metis-token</code>, <code>hermez-network-token</code>, <code>celer-network</code>, <code>havven</code>, <code>devve</code>, <code>loopring</code>, <code>biconomy</code>, <code>bancor</code>, <code>aave</code>, <code>perpetual-protocol</code>, <code>cartesi</code>, <code>zora</code>
+        </td>
+    </tr>
+</table>

package/client/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "client",
+  "version": "1.0.1",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@types/node": "^22.9.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "axios": "^1.7.7",
+    "client": "file:",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router": "^6.27.0",
+    "react-router-dom": "^6.27.0",
+    "react-scripts": "^5.0.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.2"
+  }
+}

package/client/src/crypto_hooks/ens/useFetchAddressENSLookup.ts

@@ -0,0 +1,18 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching Address to ENS Custom hook
+export const useFetchAddressENSLookup = (address: string, port: number) => {
+    const URL = `http://localhost:${port}/address-to-ens-information`; // Define the API endpoint
+    
+    const options = {
+        method: 'POST',
+        body: JSON.stringify({ address }),
+        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/ens/useFetchENSAddressLookup.ts

@@ -0,0 +1,19 @@
+import axios from "axios";
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ENS to Address Custom hook
+export const useFetchENSAddressLookup = (ensName: string, port: number) => {
+    const URL = `http://localhost:${port}/additional-address-to-ens-information`; // Define the API endpoint
+    
+    const options = {
+        method: 'POST',
+        body: JSON.stringify({ ensName }),
+        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/ens/useFetchENSIDLookup.ts

@@ -0,0 +1,18 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetch ENS ID lookups
+export const useFetchENSIDLookup = (id: string, port: number) => {
+    const URL = `https://localhost:${port}/ens-transfers-by-id`; // Define the API endpoint
+    
+    const options = {
+        method: 'POST',
+        body: JSON.stringify({ id }),
+        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/ens/useFetchENSNameLookup.ts

@@ -0,0 +1,18 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetch ENS Name lookups
+export const useFetchENSNameLookup = (ensName: string, port: number) => {
+    const URL = `https://localhost:${port}/ens-transfers-by-name`; // Define the API endpoint
+    
+    const options = {
+        method: 'POST',
+        body: JSON.stringify({ ensName }),
+        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/erc20Tokens/useFetchERC20CollectionOwners.ts

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

package/client/src/crypto_hooks/erc20Tokens/useFetchERC20CollectionTopCoins.ts

@@ -0,0 +1,19 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC20 Collection Top Coins
+export const useFetchERC20CollectionTopCoins = 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}/erc20-top-coins`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

package/client/src/crypto_hooks/erc20Tokens/useFetchERC20CollectionTransfers.ts

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

package/client/src/crypto_hooks/erc20Tokens/useFetchERC20Holdings.ts

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

package/client/src/crypto_hooks/erc20Tokens/useFetchERC20Transfers.ts

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,20 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Collection Market Cap Hook
+export const useFetchERC721CollectionMarketCap = async (contractAddress: string, duration: 2 | 14 | 30, port: number) => {
+
+    // Set options for request
+    let options = {
+        method: 'POST',
+        body: JSON.stringify({ contractAddress, duration }),
+        headers : {
+            'accept' : 'application/json'
+        }
+    }
+
+    // Use the custom hook to fetch data
+    const state = useFetch(`http://localhost:${port}/erc721-collection-market-cap`, options);
+
+    // Return the state from the custom hook
+    return state;
+}

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

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

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

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

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

@@ -0,0 +1,19 @@
+import { useFetch } from "../../custom_hooks/useFetch";
+
+// Fetching ERC721 Collection Trends Hook
+export const useFetchERC721CollectionTrends = 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-trends`, options);
+
+    // Return the state from the custom hook
+    return state;
+}