feat: Add Onchain workflow template (#66)

* feat: Add Onchain workflow template

* polish

---------

Co-authored-by: Ganesh Swami <[email protected]>

Author: karanpargal

packages/create-zee-app/src/index.ts

@@ -90,6 +90,10 @@ async function main() {
                 value: "001-zee-barebones",
                 label: "Just a barebones template",
             },
+            {
+                value: "002-onchain-workflow",
+                label: "Analyze blockchain data to get a wallet's token balances, etc.",
+            },
         ],
     });
 
@@ -102,19 +106,15 @@ async function main() {
     const templateDir = path.resolve(TEMPLATES_DIR, template);
 
     try {
-        // Create project directory
         await fs.mkdir(targetDir, { recursive: true });
 
-        // Copy template files
         await copyTemplateFiles(templateDir, targetDir);
 
-        // Create .env file with OpenAI API key
         const envPath = path.join(targetDir, ".env");
         await fs.writeFile(envPath, `OPENAI_API_KEY=${openaiApiKey}\n`, {
             flag: "a",
         });
 
-        // Update package.json with project name
         const packageJsonPath = path.join(targetDir, "package.json");
         const packageJson = JSON.parse(
             await fs.readFile(packageJsonPath, "utf-8")
@@ -125,7 +125,6 @@ async function main() {
             JSON.stringify(packageJson, null, 2)
         );
 
-        // Update agent name in index.ts
         const indexTsPath = path.join(targetDir, "src/index.ts");
         const indexTsContent = await fs.readFile(indexTsPath, "utf-8");
         const updatedContent = indexTsContent.replace(

packages/create-zee-app/templates/002-onchain-workflow/.env.example

@@ -0,0 +1,2 @@
+GOLDRUSH_API_KEY!
+OPENAI_API_KEY!

packages/create-zee-app/templates/002-onchain-workflow/.gitignore

@@ -0,0 +1,2 @@
+.env
+node_modules

packages/create-zee-app/templates/002-onchain-workflow/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Covalent
+
+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.

packages/create-zee-app/templates/002-onchain-workflow/README.md

@@ -0,0 +1,101 @@
+# Your AI Agent - Onchain Workflow
+
+This template demonstrates how to create AI agents that can analyze blockchain data using the GoldRush API tools. It showcases various capabilities like analyzing token balances, NFT holdings, and transaction history across multiple blockchains.
+
+## Features
+
+- Token balance analysis across supported blockchains
+- NFT holdings tracking with metadata
+- Transaction history monitoring
+- Historical token price analysis
+- Multi-agent workflow coordination
+
+## Getting Started
+
+1. Install dependencies:
+
+```bash
+npm install
+```
+
+2. Create a `.env` file in the root directory with your API keys:
+
+```bash
+OPENAI_API_KEY=your_openai_api_key
+GOLDRUSH_API_KEY=your_goldrush_api_key
+```
+
+3. Run the development server:
+
+```bash
+npm run dev
+```
+
+
+## Available Tools
+
+### 1. Token Balances Tool
+Fetches token balances for any wallet address with:
+- Token amounts and USD values
+- Token metadata (symbol, decimals, contract address)
+
+### 2. NFT Holdings Tool
+Retrieves NFT holdings with:
+- Collection information
+- Token IDs and ownership details
+- Media URLs and metadata
+
+### 3. Transaction History Tool
+Analyzes transaction history including:
+- Transaction types (transfers, swaps, mints)
+- Token movements and values
+- Timestamps and block information
+
+### 4. Historical Token Price Tool
+Provides historical price data with:
+- Price history over customizable timeframes (1h, 24h, 7d, 30d)
+- Token prices in USD
+- Detailed price data points
+
+## Example Usage
+
+```typescript
+import {
+    Agent,
+    ZeeWorkflow,
+    TokenBalancesTool,
+    NFTBalancesTool,
+    TransactionsTool,
+} from "@covalenthq/ai-agent-sdk";
+
+const tools = {
+    tokenBalances: new TokenBalancesTool(process.env.GOLDRUSH_API_KEY),
+    nftBalances: new NFTBalancesTool(process.env.GOLDRUSH_API_KEY),
+    transactions: new TransactionsTool(process.env.GOLDRUSH_API_KEY),
+};
+
+const walletAnalyzer = new Agent({
+    name: "WalletAnalyzer",
+    model: {
+        provider: "OPEN_AI",
+        name: "gpt-4o-mini",
+    },
+    description: "An AI assistant that analyzes wallet activities and provides insights about holdings and transactions.",
+    instructions: [
+        "Analyze wallet token balances and provide insights about holdings",
+        "Check NFT collections owned by the wallet",
+        "Review recent transactions and identify patterns",
+        "Provide comprehensive analysis of the wallet's activity",
+    ],
+    tools,
+});
+```
+
+
+## License
+
+MIT - See [LICENSE](./LICENSE) file for details.
+
+## Support
+
+For support and discussions, join our [Telegram community](https://t.me/CXT_Agent_SDK).