@reap-protocol/sdk 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reap-protocol/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/README.md

@@ -24,8 +24,6 @@ import { ReapClient } from "@reap-protocol/sdk";
 
 // Load your private key securely
 const PRIVATE_KEY = process.env.MY_WALLET_KEY || "";
-
-// Optional: Use a specific RPC (e.g., Celo Alfajores or Avalanche Fuji)
 const CHAIN_RPC = "https://api.avax-test.network/ext/bc/C/rpc"; 
 
 async function main() {
@@ -97,6 +95,21 @@ npm install --save-dev ts-node typescript @types/node
 npx ts-node agent.ts
 ```
 
+## 🕵️ Agent Discovery (New)
+
+You can now search for other AI Agents (MCP, x402, A2A).
+
+```typescript
+// 1. Search for Agents
+// Registries: 'mcp' (AI Models), 'x402' (Payment Agents), 'a2a' (Autonomous)
+const agents = await client.searchAgents("ecommerce", "x402");
+
+if (agents.length > 0) {
+    const targetAgent = agents[0];
+    console.log(`Found: ${targetAgent.name}`);
+}
+```
+
 ## 🔧 Configuration
 
 You can override defaults for custom RPCs or self-hosted middleware.
@@ -110,10 +123,12 @@ const client = new ReapClient(
 
 ## ✨ Features
 
+* **Agent Discovery**: Search thousands of AI Agents from MCP, x402, and A2A registries.
 * **JIT Stocking**: "Just-In-Time" inventory system. If an agent searches for an item not yet on the blockchain, the Protocol indexes it in real-time.
 * **Agentic Cart**: Automatically routes purchases through the Protocol's batch processor.
 * **Protocol Negotiation**: Built-in support for HTTP 402 Payment Negotiation loops.
-* **Gas Optimized**: Checks on-chain state before sending registration transactions.
+
+
 
 ## License
 

package/src/index.ts

@@ -1,5 +1,9 @@
 import { ethers } from "ethers";
-import axios, { AxiosRequestConfig } from "axios";
+import axios from "axios";
+
+// ==========================================
+// CONSTANTS & CONFIGURATION
+// ==========================================
 
 const HOLOCRON_ROUTER_ADDRESS = "0x2cEC5Bf3a0D3fEe4E13e8f2267176BdD579F4fd8";
 
@@ -9,12 +13,26 @@ const NETWORKS: Record<string, string> = {
   "CELO": "https://forno.celo-sepolia.celo-testnet.org"
 };
 
-
 const HOLOCRON_ABI = [
   "function checkExistence(uint256 _c) view returns (bool)",
   "function stock(uint256 _c) external"
 ];
 
+// --- Agent Registry Configuration ---
+export type AgentRegistry = 'mcp' | 'x402' | 'a2a';
+
+const REGISTRY_MAP: Record<AgentRegistry, string> = {
+  "mcp": "pulsemcp",
+  "x402": "coinbase-x402-bazaar",
+  "a2a": "a2a-registry"
+};
+
+const SEARCH_API_URL = "https://www.reap.deals/api/search-agents";
+
+// ==========================================
+// REAP CLIENT CLASS
+// ==========================================
+
 export class ReapClient {
   private wallet: ethers.Wallet;
   private builderUrl: string;
@@ -37,22 +55,34 @@ export class ReapClient {
     this.init();
   }
 
+  /**
+   * Async initialization to fetch Chain ID
+   */
   private async init() {
-    const net = await this.provider.getNetwork();
-    this.chainId = Number(net.chainId);
-    console.log(`🤖 Reap Agent Online: ${this.wallet.address} (Chain: ${this.chainId})`);
+    try {
+      const net = await this.provider.getNetwork();
+      this.chainId = Number(net.chainId);
+      console.log(`🤖 Reap Agent Online: ${this.wallet.address} (Chain: ${this.chainId})`);
+    } catch (e) {
+      console.error("⚠️ Failed to fetch chain ID. Defaulting to 43113.");
+    }
   }
 
+  // ==========================================
+  // CORE TRANSACTION LOGIC
+  // ==========================================
+
   /**
-   * Execute Transactions with Nonce & Gas Fixes
+   * Execute Transactions with Nonce & Gas Fixes.
+   * Handles sequential nonce increments locally to prevent RPC lag.
    */
   private async executeTransactions(txList: any[]) {
     let lastReceipt;
     
-    // FIX 1: Use pending nonce
+    // 1. Fetch Nonce ONCE
     let currentNonce = await this.provider.getTransactionCount(this.wallet.address, "pending");
     
-    // FIX 2: Gas Price Buffer (1.1x)
+    // 2. Gas Price Buffer (1.1x) for fast propagation
     const feeData = await this.provider.getFeeData();
     const gasPrice = feeData.gasPrice ? (feeData.gasPrice * 110n) / 100n : undefined;
 
@@ -64,10 +94,10 @@ export class ReapClient {
         to: txData.to,
         data: txData.data,
         value: BigInt(txData.value),
-        gasLimit: 500000,
+        gasLimit: 500000, // Safe default limit
         nonce: currentNonce,
         chainId: this.chainId,
-        gasPrice: gasPrice // Apply buffered gas price
+        gasPrice: gasPrice 
       };
 
       try {
@@ -86,6 +116,7 @@ export class ReapClient {
 
       } catch (e: any) {
         console.error(`   ❌ Tx Failed: ${e.message}`);
+        // Stop execution if payment or approval fails. Continue for others if needed.
         if (label.includes("Approve") || label.includes("Payment")) throw e;
       }
     }
@@ -94,7 +125,7 @@ export class ReapClient {
 
   private async callBuilder(endpoint: string, payload: any) {
     try {
-        // Inject Chain ID
+        // Inject Chain ID for Middleware routing
         payload.chain_id = this.chainId;
         const { data } = await axios.post(`${this.builderUrl}${endpoint}`, payload);
         return data;
@@ -104,8 +135,13 @@ export class ReapClient {
     }
   }
 
-  // --- SMART AVAILABILITY (Holocron Only) ---
+  // ==========================================
+  // HOLOCRON & SMART SYNC
+  // ==========================================
 
+  /**
+   * Check if a coordinate exists in the Holocron Registry.
+   */
   async checkHolocron(coordinate: string) {
     console.log(`🔎 Scanning Holocron for ${coordinate}...`);
     
@@ -118,10 +154,12 @@ export class ReapClient {
     return exists;
   }
 
+  /**
+   * Internal method to execute the 'stock' function on the Holocron.
+   */
   private async indexToHolocron(coordinate: string) {
     console.log(`   📝 Indexing Coordinate ${coordinate} to Holocron...`);
     
-    // Re-fetch nonce/gas
     const nonce = await this.provider.getTransactionCount(this.wallet.address, "pending");
     const feeData = await this.provider.getFeeData();
     const gasPrice = feeData.gasPrice ? (feeData.gasPrice * 110n) / 100n : undefined;
@@ -140,8 +178,11 @@ export class ReapClient {
     await new Promise(r => setTimeout(r, 2000));
   }
 
-// --- src/index.ts ---
-
+  /**
+   * Smart Sync: Checks Holocron first.
+   * If item exists -> Skip registration (Save Gas).
+   * If missing -> Execute registration TX -> Index to Holocron.
+   */
   async smartSync(item: any, transaction: any) {
     const coordinate = item.id;
     
@@ -158,11 +199,8 @@ export class ReapClient {
     // 2. Register Data (if transaction exists)
     if (transaction) {
         console.log("   🔸 Registering Data on-chain...");
-        
-        // ⚠️ THE FIX: Wrap the single 'transaction' object in brackets [ ] 
-        // to make it a list, because executeTransactions expects a list.
+        // Wrap single transaction in array
         await this.executeTransactions([transaction]);
-        
     } else {
         console.log("   ⚠️ No registration transaction provided. Skipping to index.");
     }
@@ -171,7 +209,41 @@ export class ReapClient {
     await this.indexToHolocron(coordinate);
   }
 
-  // --- PUBLIC API ---
+  // ==========================================
+  // AGENT DISCOVERY (NEW)
+  // ==========================================
+
+  /**
+   * Search for AI Agents across different registries (MCP, x402, A2A).
+   * @param query Keywords to search for (e.g. "customer support", "ecommerce")
+   * @param registry 'mcp' | 'x402' | 'a2a'
+   * @param limit Max results (default 40)
+   */
+  async searchAgents(query: string, registry: AgentRegistry = 'mcp', limit: number = 40) {
+    console.log(`🔎 Searching Registry [${REGISTRY_MAP[registry]}] for: "${query}"...`);
+    
+    try {
+        const payload = {
+            limit: limit,
+            query: query,
+            registry: REGISTRY_MAP[registry] // Maps 'mcp' -> 'pulsemcp', etc.
+        };
+
+        const response = await axios.post(SEARCH_API_URL, payload);
+        const hits = response.data.hits || [];
+        
+        console.log(`   ✅ Found ${hits.length} agents.`);
+        return hits;
+
+    } catch (error: any) {
+        console.error("   ❌ Search Failed:", error.message);
+        return [];
+    }
+  }
+
+  // ==========================================
+  // PUBLIC API (Commerce & Identity)
+  // ==========================================
 
   async registerIdentity(profileUri: string = "ipfs://default") {
     console.log("🆔 Registering Protocol Identity...");
@@ -187,6 +259,10 @@ export class ReapClient {
     return this.executeTransactions(res.transactions);
   }
 
+  /**
+   * Search for Products/Inventory.
+   * Use dryRun=true to get items without executing on-chain registration immediately.
+   */
   async stockShelf(productQuery: string, dryRun: boolean = false) {
     console.log(`📦 Stocking Shelf: '${productQuery}' (Dry Run: ${dryRun})`);