Merge pull request #39 from pattern-tech/feat/adding-goldrush

Feat/adding goldrush

Author: yasinfakhar

api/README.md

@@ -8,20 +8,68 @@ To install the required dependencies, run:
 
 ```sh
 cp .env.example .env
+cp config.json.example config.json
 pip install -r requirements.txt
 ```
 
-Note: Fill up the .env file according to your config
-
-Check the services dependency and make sure all services are up with config provided in `.env` file
-- postgres
-- minio
-- qdrant
+Note: Fill up the .env and config.json file according to your config
+
+### Configuration
+Configuration file is in `config.json`. Edit it according to your needs.
+
+Notes:
+- Add your own tool services or use existing ones
+- Add provided agents. (on top of each service tool is an agent so the name of agent should be same as service name)
+- Choose the llm provider
+  <table>
+  <thead>
+    <tr>
+      <th>Supported Provider</th>
+      <th>Recommended Model</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>openai</td>
+      <td>gpt-4o-mini</td>
+    </tr>
+    <tr>
+      <td>google</td>
+      <td>gemini-2.0-flash</td>
+    </tr>
+    <tr>
+      <td>together</td>
+      <td>deepseek-ai/DeepSeek-R1-Distill-Llama-70B-free</td>
+    </tr>
+    <tr>
+      <td>ollama</td>
+      <td>llama3.3</td>
+    </tr>
+    <tr>
+      <td>groq</td>
+      <td>llama-3.3-70b-versatile</td>
+    </tr>
+    <tr>
+      <td>firework</td>
+      <td>accounts/fireworks/models/firefunction-v2</td>
+    </tr>
+    <tr>
+      <td>huggingface</td>
+      <td>meta-llama/Llama-3.3-70B-Instruct</td>
+    </tr>
+  </tbody>
+</table>
 
 ### Running the Application
 
-#### Locally
+#### method 1) Locally
+
+Check the services dependency and make sure all services are up with config provided in `.env` file
+
+depend services:
+- postgres
 
+##### Run main app
 If you have `make` installed on your machine, you can start the application using:
 
 ```sh
@@ -34,7 +82,7 @@ Otherwise, you can manually run it with:
 python3 -m uvicorn src.main:app --host 0.0.0.0 --reload
 ```
 
-#### Docker Compose
+#### method 2) Docker Compose
 
 If you have docker compose installed, run:
 
@@ -57,15 +105,40 @@ We support both Swagger and Scalar documentation:
 
 ## AI Features
 
-### 1. Ethereum Blockchain Queries
+### 1. EtherScan Agent
+
+Agent for handling Ethereum blockchain-related queries and tasks.:
+
+- Get the current Unix timestamp
+- Convert a natural language date string into a Unix timestamp
+- Retrieve the source code of a smart contract
+- Retrieve the ABI of a smart contract
+- Retrieve the ABI of a specific event from a smart contract
+- Fetch events for a given smart contract event within a block range
+- Retrieve the latest Ethereum block number
+- Convert a Unix timestamp to the nearest Ethereum block number
+
+### 2. Moralis Agent
+
+Agent for handling Ethereum blockchain-related queries and tasks.:
+
+  - Get active chains for a wallet address across all chains
+  - Get token balances for a specific wallet address and their prices in USD. (paginated)
+  - Get the stats for a wallet address.
+  - Retrieve the full transaction history of a specified wallet address, including sends, receives, token and NFT transfers and contract interactions.
+  - Get the contents of a transaction by the given transaction hash.
+  - Get ERC20 approvals for one or many wallet addresses and/or contract addresses, ordered by block number in descending order.
+
+### 3. GoldRush Agent
 
-This feature allows handling Ethereum blockchain-related queries and tasks, including:
+Agent for handling Ethereum blockchain-related queries and tasks.:
 
-- Retrieving smart contract source code
-- Fetching contract ABIs (Application Binary Interface)
-- Getting contract events and their details
-- Querying contract transactions
-- Converting between timestamps and block numbers
+- Get activity across all chains for address
+- fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address
+- Fetch transactions for a given wallet address (paginated)
+- Fetch a summary of transactions (earliest and latest) for a given wallet address.
+- Fetch a single transaction including its decoded event logs
+- Fetch list of approvals across all token contracts categorized by spenders for a wallet’s assets
 
 ### 2. Web Search Integration
 

api/config.json.sample

@@ -10,6 +10,16 @@
             "url": "https://api.covalenthq.com",
             "api_key": ""
         },
+        {
+            "name": "moralis",
+            "url": "https://deep-index.moralis.io/api/v2",
+            "api_key": ""
+        },
+        {
+            "name": "eth_rpc",
+            "url": "https://eth.llamarpc.com",
+            "api_key": ""
+        },
         {
             "name": "exa",
             "url": "https://api.exa.ai",
@@ -24,7 +34,7 @@
             "name": "tavily",
             "url": "https://api.tavily.com",
             "api_key": ""
-        }
+        },
     ],
     "llm": {
         "provider": "openai",
@@ -37,6 +47,7 @@
     },
     "agents": [
         "etherscan",
-        "goldrush"
+        "goldrush",
+        "moralis"
     ]
 }

api/hello_copy/__init__.py

@@ -30,4 +30,5 @@ langchain-google-genai==2.0.7
 langchain-google-vertexai==2.0.9
 langchain-groq==0.2.4
 langchain-huggingface==0.1.2
-sentry-sdk==2.22.0
+sentry-sdk==2.22.0
+siwe==4.4.0

api/hello_copy/main.py

@@ -14,12 +14,12 @@ def goldrush_agent(query: str):
     An agent for handling Ethereum blockchain-related queries and tasks.
     This agent can perform the following tasks:
 
-    - Fetch wallet activity for a given address
+    - Get activity across all chains for address
     - fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address
-    - Fetch the transactions involving an address including the decoded log events in a paginated fashion
-    - Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet
-    - Fetch and render a single transaction including its decoded event logs
-    - Fetch a list of approvals across all token contracts categorized by spenders for a wallet’s assets
+    - Fetch transactions for a given wallet address (paginated)
+    - Fetch a summary of transactions (earliest and latest) for a given wallet address.
+    - Fetch a single transaction including its decoded event logs
+    - Fetch list of approvals across all token contracts categorized by spenders for a wallet’s assets
 
     Args:
         query (str): query about Ethereum blockchain tasks.

api/requirements.txt

@@ -8,8 +8,8 @@
 from langchain.tools import tool
 from typing import List, Any, Optional, Dict
 
-from src.agentflow.utils.shared_tools import handle_exceptions
 from src.util.configuration import Config
+from src.agentflow.utils.shared_tools import handle_exceptions
 
 
 _config = Config.get_config()