@reap-protocol/sdk 0.1.0 → 0.1.1

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@reap-protocol/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc"
   },
   "dependencies": {
-    "axios": "^1.6.0",
+    "axios": "^1.13.2",
     "ethers": "^6.0.0"
   },
   "devDependencies": {
@@ -15,5 +15,9 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Apriloracle/Reap-protocol-sdk.git"
   }
 }

package/src/README.md

@@ -1,58 +1,66 @@
-Reap Protocol
+# @reap-protocol/sdk
 
-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.
+**The official TypeScript/Node.js SDK for the Reap Protocol: The Agentic Commerce Grid.**
 
+The Reap Protocol enables AI Agents to search for products, register them on-chain, and execute atomic purchases without needing to understand smart contract ABIs. It acts as the bridge between Web2 products data and Web3 commerce settlement.
 
-
-📦 Installation
-
+## 📦 Installation
+```bash
 npm install @reap-protocol/sdk ethers axios
+```
 
+## 🚀 Quick Start
 
+This example demonstrates the full Agentic Commerce Loop: Identity -> Discovery -> Settlement.
 
-🚀 Quick Start
+### 1. Setup
 
-1. Setup
 If using TypeScript, ensure your tsconfig.json targets ES2020 or higher.
 
-2. The Agent Code
-
-TypeScript
+### 2. The Agent Code (agent.ts)
+```typescript
 import { ReapClient } from "@reap-protocol/sdk";
 
-// Use a Base Sepolia Wallet
+// Load your private key securely
 const PRIVATE_KEY = process.env.MY_WALLET_KEY || "";
 
 async function main() {
-  // 1. Initialize
+  // 1. Initialize the Agent
+  // (Points to official middleware by default)
   const client = new ReapClient(PRIVATE_KEY);
   console.log("🤖 Agent Online");
 
   try {
-    // 2. Identity
-    // Ensures this wallet is registered to trade
+    // 2. Identity (One-time setup)
+    // Registers your wallet as an authorized Agent on the Protocol
+    console.log("🆔 Checking Identity...");
     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");
+    // 3. JIT Stocking (Discovery)
+    // Searches Web2 (Reap Deals), registers items on-chain, and returns inventory
+    console.log("📦 Stocking Shelf with 'Gaming Laptop'...");
+    const result = await client.stockShelf("Gaming Laptop");
     
     const inventory = result.items;
-    console.log(`   🔍 Found ${inventory.length} items.`);
+    console.log(`   🔍 Found ${inventory.length} items on-chain.`);
 
     if (inventory.length > 0) {
-        // 4. Decision Engine
+        // 4. Decision Logic
+        // Example: Pick the first available item
         const target = inventory[0];
-        console.log(`   🎯 Target: ${target.name} ($${target.price})`);
+        console.log(`   🎯 Selected: ${target.name} ($${target.price})`);
+        console.log(`      ID: ${target.id}`);
 
-        // 5. Settlement (Agentic Cart)
-        // Automatically approves USDC and executes the purchase
-        console.log("💸 Purchasing...");
+        // 5. Agentic Cart (Settlement)
+        // Automatically approves USDC and executes the atomic purchase
+        console.log("💸 Buying Item...");
         const receipt = await client.buyProduct(target.id);
         
-        console.log(`🎉 SUCCESS! Tx: ${receipt.hash}`);
+        if (receipt) {
+            console.log(`🎉 SUCCESS! Transaction Hash: ${receipt.hash}`);
+        }
+    } else {
+        console.log("❌ No items found.");
     }
 
   } catch (e: any) {
@@ -61,26 +69,35 @@ async function main() {
 }
 
 main();
+```
 
+### 3. Run It
+```bash
+# Install execution tools if you haven't already
+npm install --save-dev ts-node typescript @types/node
 
+# Run
+npx ts-node agent.ts
+```
 
-✨ 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
 
-
-🔧 Configuration
-code
-TypeScript
+You can override defaults for custom RPCs or self-hosted middleware.
+```typescript
 const client = new ReapClient(
   "YOUR_PRIVATE_KEY",
-  "https://sepolia.base.org", // Custom RPC
+  "https://base-sepolia.g.alchemy.com/v2/YOUR_KEY", // Custom RPC
   "https://api.reap.deals"    // Middleware URL
 );
+```
+
+## ✨ Features
 
+* **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
 
-License
 MIT

package/src/index.ts

@@ -8,7 +8,7 @@ export class ReapClient {
 
   constructor(
     privateKey: string, 
-    chainRpc: string = "https://sepolia.base.org", 
+    chainRpc: string = "https://avalanche-fuji.drpc.org", 
     builderUrl: string = "https://api.reap.deals"
   ) {
     this.provider = new ethers.JsonRpcProvider(chainRpc);