@reap-protocol/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { ethers } from "ethers";
+import { AxiosRequestConfig } from "axios";
+export declare class ReapClient {
+    private wallet;
+    private builderUrl;
+    private provider;
+    constructor(privateKey: string, chainRpc?: string, builderUrl?: string);
+    /**
+     * Core Logic: Signs and Broadcasts transactions sequentially.
+     * Uses manual nonce management to prevent RPC lag errors.
+     */
+    private executeTransactions;
+    private callBuilder;
+    getProduct(productId: string): Promise<any>;
+    registerIdentity(profileUri?: string): Promise<ethers.TransactionReceipt | null | undefined>;
+    stockShelf(productQuery: string): Promise<{
+        receipt: ethers.TransactionReceipt | null | undefined;
+        items: any;
+    }>;
+    buyProduct(productId: string): Promise<ethers.TransactionReceipt | null | undefined>;
+    buyCart(productIds: string[]): Promise<ethers.TransactionReceipt | null | undefined>;
+    fetch(url: string, config?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<any, any, {}>>;
+}

package/dist/index.js

@@ -0,0 +1,152 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReapClient = void 0;
+const ethers_1 = require("ethers");
+const axios_1 = __importDefault(require("axios"));
+class ReapClient {
+    constructor(privateKey, chainRpc = "https://sepolia.base.org", builderUrl = "https://api.reap.deals") {
+        this.provider = new ethers_1.ethers.JsonRpcProvider(chainRpc);
+        this.wallet = new ethers_1.ethers.Wallet(privateKey, this.provider);
+        this.builderUrl = builderUrl.replace(/\/$/, ""); // Remove trailing slash
+        console.log(`🤖 Reap Agent Online: ${this.wallet.address}`);
+    }
+    /**
+     * Core Logic: Signs and Broadcasts transactions sequentially.
+     * Uses manual nonce management to prevent RPC lag errors.
+     */
+    async executeTransactions(txList) {
+        let lastReceipt;
+        // 1. Fetch Nonce ONCE
+        let currentNonce = await this.provider.getTransactionCount(this.wallet.address, "pending");
+        for (const txData of txList) {
+            const label = txData.label || "Transaction";
+            console.log(`   📝 Signing: ${label}...`);
+            const tx = {
+                to: txData.to,
+                data: txData.data,
+                value: BigInt(txData.value),
+                gasLimit: 500000, // Safety limit
+                nonce: currentNonce,
+                chainId: (await this.provider.getNetwork()).chainId
+            };
+            try {
+                // 2. Sign & Send
+                const response = await this.wallet.sendTransaction(tx);
+                console.log(`   🚀 Broadcasting: ${response.hash}`);
+                // 3. Wait
+                const receipt = await response.wait();
+                // 4. Check Status (1 = Success, 0 = Revert)
+                if (receipt && receipt.status === 0) {
+                    throw new Error(`Transaction Reverted! Hash: ${receipt.hash}`);
+                }
+                console.log(`   ✅ Settled on-chain.`);
+                lastReceipt = receipt;
+                // 5. Increment Nonce
+                currentNonce++;
+            }
+            catch (e) {
+                console.error(`   ❌ Tx Failed: ${e.message}`);
+                if (label.includes("Approve") || label.includes("Payment"))
+                    throw e;
+            }
+        }
+        return lastReceipt;
+    }
+    async callBuilder(endpoint, payload) {
+        try {
+            const { data } = await axios_1.default.post(`${this.builderUrl}${endpoint}`, payload);
+            return data;
+        }
+        catch (error) {
+            const msg = error.response?.data?.detail || error.message;
+            throw new Error(`Reap Protocol Error: ${msg}`);
+        }
+    }
+    // --- PUBLIC API ---
+    async getProduct(productId) {
+        const safeId = encodeURIComponent(productId);
+        const { data } = await axios_1.default.get(`${this.builderUrl}/read/product/${safeId}`);
+        return data;
+    }
+    // ... inside ReapClient class ...
+    async registerIdentity(profileUri = "ipfs://default") {
+        console.log("🆔 Registering Protocol Identity...");
+        const res = await this.callBuilder("/build/identity/register", {
+            user_address: this.wallet.address,
+            profile_uri: profileUri
+        });
+        if (res.status === "already_registered") {
+            console.log(`   ✅ Already Registered (Agent #${res.agent_id}). Skipping transaction.`);
+            return null;
+        }
+        return this.executeTransactions(res.transactions);
+    }
+    async stockShelf(productQuery) {
+        console.log(`📦 Stocking Shelf: '${productQuery}'`);
+        const res = await this.callBuilder("/build/inventory/stock", {
+            product_query: productQuery,
+            provider_address: this.wallet.address
+        });
+        if (res.status === "payment_required") {
+            console.log("🛑 402 Payment Required via JSON Spec.");
+            console.log(`   🧾 Invoice: ${res.meta.description}`);
+        }
+        else {
+            console.log(`   🔍 Found ${res.meta.count || 0} items.`);
+        }
+        const receipt = await this.executeTransactions(res.transactions);
+        // --- THE FIX: Return both Receipt AND Items ---
+        return {
+            receipt,
+            items: res.meta?.items || []
+        };
+        // ----------------------------------------------
+    }
+    async buyProduct(productId) {
+        console.log(`💸 Initiating Agentic Cart (Single Item): ${productId}`);
+        // Route to batch endpoint
+        const res = await this.callBuilder("/build/commerce/batch", {
+            product_ids: [productId]
+        });
+        return this.executeTransactions(res.transactions);
+    }
+    async buyCart(productIds) {
+        console.log(`🛒 Initiating Agentic Cart (Batch): ${productIds.length} items`);
+        const res = await this.callBuilder("/build/commerce/batch", {
+            product_ids: productIds
+        });
+        return this.executeTransactions(res.transactions);
+    }
+    async fetch(url, config = {}) {
+        console.log(`🌍 Accessing ${url}...`);
+        try {
+            return await axios_1.default.get(url, config);
+        }
+        catch (error) {
+            if (error.response && error.response.status === 402) {
+                console.log("🛑 x402 Payment Required. Engaging Protocol...");
+                const header = error.response.headers["www-authenticate"];
+                if (header && header.includes("X402")) {
+                    const match = header.match(/resource_id="([^"]+)"/);
+                    if (match && match[1]) {
+                        const rid = match[1];
+                        // Pay Protocol
+                        const receipt = await this.buyProduct(rid);
+                        if (!receipt)
+                            throw new Error("Payment Transaction failed");
+                        const proof = receipt.hash;
+                        console.log(`   🔄 Submitting Proof for Reactive Release: ${proof}`);
+                        // Release Data
+                        const newConfig = { ...config, headers: { ...config.headers, "Authorization": `X402-Proof ${proof}` } };
+                        return await axios_1.default.get(url, newConfig);
+                    }
+                }
+            }
+            throw error;
+        }
+    }
+}
+exports.ReapClient = ReapClient;

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@reap-protocol/sdk",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/README.md

@@ -0,0 +1,86 @@
+Reap Protocol
+
+The official TypeScript/Node.js SDK for the **Reap Protocol**: The Agentic Commerce Layer.  
+Enable Autonomous Agents to buy and sell on-chain with zero smart contract knowledge.
+
+
+
+📦 Installation
+
+npm install @reap-protocol/sdk ethers axios
+
+
+
+🚀 Quick Start
+
+1. Setup
+If using TypeScript, ensure your tsconfig.json targets ES2020 or higher.
+
+2. The Agent Code
+
+TypeScript
+import { ReapClient } from "@reap-protocol/sdk";
+
+// Use a Base Sepolia Wallet
+const PRIVATE_KEY = process.env.MY_WALLET_KEY || "";
+
+async function main() {
+  // 1. Initialize
+  const client = new ReapClient(PRIVATE_KEY);
+  console.log("🤖 Agent Online");
+
+  try {
+    // 2. Identity
+    // Ensures this wallet is registered to trade
+    await client.registerIdentity();
+
+    // 3. Discovery (Stocking)
+    // Fetches data, registers it on Base Sepolia, and returns the list
+    console.log("📦 Stocking Shelf...");
+    const result = await client.stockShelf("Tonnino Tuna");
+    
+    const inventory = result.items;
+    console.log(`   🔍 Found ${inventory.length} items.`);
+
+    if (inventory.length > 0) {
+        // 4. Decision Engine
+        const target = inventory[0];
+        console.log(`   🎯 Target: ${target.name} ($${target.price})`);
+
+        // 5. Settlement (Agentic Cart)
+        // Automatically approves USDC and executes the purchase
+        console.log("💸 Purchasing...");
+        const receipt = await client.buyProduct(target.id);
+        
+        console.log(`🎉 SUCCESS! Tx: ${receipt.hash}`);
+    }
+
+  } catch (e: any) {
+    console.error("❌ Error:", e.message);
+  }
+}
+
+main();
+
+
+
+✨ Features
+Typed Interfaces: Full TypeScript support for Product Data and Transactions.
+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.
+
+
+🔧 Configuration
+code
+TypeScript
+const client = new ReapClient(
+  "YOUR_PRIVATE_KEY",
+  "https://sepolia.base.org", // Custom RPC
+  "https://api.reap.deals"    // Middleware URL
+);
+
+
+
+License
+MIT

package/src/index.ts

@@ -0,0 +1,178 @@
+import { ethers } from "ethers";
+import axios, { AxiosRequestConfig } from "axios";
+
+export class ReapClient {
+  private wallet: ethers.Wallet;
+  private builderUrl: string;
+  private provider: ethers.JsonRpcProvider;
+
+  constructor(
+    privateKey: string, 
+    chainRpc: string = "https://sepolia.base.org", 
+    builderUrl: string = "https://api.reap.deals"
+  ) {
+    this.provider = new ethers.JsonRpcProvider(chainRpc);
+    this.wallet = new ethers.Wallet(privateKey, this.provider);
+    this.builderUrl = builderUrl.replace(/\/$/, ""); // Remove trailing slash
+    console.log(`🤖 Reap Agent Online: ${this.wallet.address}`);
+  }
+
+  /**
+   * Core Logic: Signs and Broadcasts transactions sequentially.
+   * Uses manual nonce management to prevent RPC lag errors.
+   */
+  private async executeTransactions(txList: any[]) {
+    let lastReceipt;
+    
+    // 1. Fetch Nonce ONCE
+    let currentNonce = await this.provider.getTransactionCount(this.wallet.address, "pending");
+
+    for (const txData of txList) {
+      const label = txData.label || "Transaction";
+      console.log(`   📝 Signing: ${label}...`);
+
+      const tx = {
+        to: txData.to,
+        data: txData.data,
+        value: BigInt(txData.value),
+        gasLimit: 500000, // Safety limit
+        nonce: currentNonce,
+        chainId: (await this.provider.getNetwork()).chainId
+      };
+
+      try {
+        // 2. Sign & Send
+        const response = await this.wallet.sendTransaction(tx);
+        console.log(`   🚀 Broadcasting: ${response.hash}`);
+        
+        // 3. Wait
+        const receipt = await response.wait();
+        
+        // 4. Check Status (1 = Success, 0 = Revert)
+        if (receipt && receipt.status === 0) {
+            throw new Error(`Transaction Reverted! Hash: ${receipt.hash}`);
+        }
+
+        console.log(`   ✅ Settled on-chain.`);
+        lastReceipt = receipt;
+        
+        // 5. Increment Nonce
+        currentNonce++;
+
+      } catch (e: any) {
+        console.error(`   ❌ Tx Failed: ${e.message}`);
+       
+        if (label.includes("Approve") || label.includes("Payment")) throw e;
+      }
+    }
+    return lastReceipt;
+  }
+
+  private async callBuilder(endpoint: string, payload: any) {
+    try {
+      const { data } = await axios.post(`${this.builderUrl}${endpoint}`, payload);
+      return data;
+    } catch (error: any) {
+      const msg = error.response?.data?.detail || error.message;
+      throw new Error(`Reap Protocol Error: ${msg}`);
+    }
+  }
+
+  // --- PUBLIC API ---
+
+  async getProduct(productId: string) {
+    const safeId = encodeURIComponent(productId);
+    const { data } = await axios.get(`${this.builderUrl}/read/product/${safeId}`);
+    return data;
+  }
+
+ // ... inside ReapClient class ...
+
+  async registerIdentity(profileUri: string = "ipfs://default") {
+    console.log("🆔 Registering Protocol Identity...");
+    const res = await this.callBuilder("/build/identity/register", { 
+        user_address: this.wallet.address,
+        profile_uri: profileUri 
+    });
+
+    if (res.status === "already_registered") {
+        console.log(`   ✅ Already Registered (Agent #${res.agent_id}). Skipping transaction.`);
+        return null;
+    }
+
+    return this.executeTransactions(res.transactions);
+  }
+
+async stockShelf(productQuery: string) {
+    console.log(`📦 Stocking Shelf: '${productQuery}'`);
+    const res = await this.callBuilder("/build/inventory/stock", {
+      product_query: productQuery,
+      provider_address: this.wallet.address
+    });
+
+    if (res.status === "payment_required") {
+        console.log("🛑 402 Payment Required via JSON Spec.");
+        console.log(`   🧾 Invoice: ${res.meta.description}`);
+    } else {
+        console.log(`   🔍 Found ${res.meta.count || 0} items.`);
+    }
+
+    const receipt = await this.executeTransactions(res.transactions);
+
+    // --- THE FIX: Return both Receipt AND Items ---
+    return {
+        receipt,
+        items: res.meta?.items || []
+    };
+    // ----------------------------------------------
+  }
+
+  async buyProduct(productId: string) {
+    console.log(`💸 Initiating Agentic Cart (Single Item): ${productId}`);
+    // Route to batch endpoint
+    const res = await this.callBuilder("/build/commerce/batch", {
+      product_ids: [productId]
+    });
+    return this.executeTransactions(res.transactions);
+  }
+
+  async buyCart(productIds: string[]) {
+    console.log(`🛒 Initiating Agentic Cart (Batch): ${productIds.length} items`);
+    const res = await this.callBuilder("/build/commerce/batch", {
+      product_ids: productIds
+    });
+    return this.executeTransactions(res.transactions);
+  }
+
+  async fetch(url: string, config: AxiosRequestConfig = {}) {
+    console.log(`🌍 Accessing ${url}...`);
+    try {
+      return await axios.get(url, config);
+    } catch (error: any) {
+      if (error.response && error.response.status === 402) {
+        console.log("🛑 x402 Payment Required. Engaging Protocol...");
+        const header = error.response.headers["www-authenticate"];
+
+        if (header && header.includes("X402")) {
+            const match = header.match(/resource_id="([^"]+)"/);
+            if (match && match[1]) {
+                const rid = match[1];
+                
+                // Pay Protocol
+                const receipt = await this.buyProduct(rid);
+                
+                if (!receipt) throw new Error("Payment Transaction failed");
+                const proof = receipt.hash;
+                
+                console.log(`   🔄 Submitting Proof for Reactive Release: ${proof}`);
+
+                // Release Data
+                const newConfig = { ...config, headers: { ...config.headers, "Authorization": `X402-Proof ${proof}` } };
+                return await axios.get(url, newConfig);
+            }
+        }
+      }
+      throw error;
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "declaration": true,   // <--- IMPORTANT: Generates .d.ts files
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}