silo-agent 1.0.2 → 1.0.3

package/README.md

@@ -13,9 +13,10 @@ AI agents are accumulating sensitive personal data — medical records, financia
 | **Encrypted Vault** | AES-256-GCM encryption with PBKDF2 key derivation. Data is encrypted in-memory and stored on 0G — never at rest in plaintext. |
 | **Execution Attestation** | Every store/retrieve is hashed into a Merkle tree. Commit a session to publish a verifiable proof of agent behavior without revealing content. |
 | **Multi-Agent Sharing** | Agents can securely share encrypted memories via `vault_share` and `vault_import` — enabling cross-agent collaboration with cryptographic accountability. |
-| **MCP Server** | 8 tools for Claude Desktop, Cursor, or any MCP-compatible client. |
+| **MCP Server** | 21 tools for Claude Desktop, Cursor, or any MCP-compatible client (vault + DeFAI + shared memory + autonomy). |
 | **Real-Time Dashboard** | Live WebSocket-powered UI showing stores, retrieves, Merkle tree visualization, and session attestation ceremonies. |
 | **CLI Tools** | `verify` to prove data exists, `doctor` to validate setup, `demo` to run the full cycle. |
+| **DeFAI Copilot** | Intent-to-plan API with guardrails, risk previews, explicit user approval, and optional 0G Compute rationale. |
 
 ---
 
@@ -24,7 +25,7 @@ AI agents are accumulating sensitive personal data — medical records, financia
 ```bash
 # Clone and install
 git clone https://github.com/rohanpotta/ethdenverhack.git
-cd silo
+cd ethdenverhack
 
 # Install backend
 cd 0g-agent-shield
@@ -49,6 +50,35 @@ npm run dev
 
 Open `http://localhost:5173` to see the SILO dashboard.
 
+## Common Failures (Fast Fixes)
+
+- `EADDRINUSE: address already in use :::3000`
+  - Cause: another process already uses port `3000`.
+  - Fix:
+    ```bash
+    lsof -i :3000
+    kill -9 <PID>
+    npm start
+    ```
+- `ngrok ERR_NGROK_334` endpoint already online
+  - Cause: previous tunnel is still active.
+  - Fix:
+    ```bash
+    pkill -f ngrok
+    ngrok http 3000
+    ```
+- `MCP silo: ... is not valid JSON`
+  - Cause: non-protocol logs leaked to MCP stdout.
+  - Fix:
+    - Upgrade to latest `silo-agent`.
+    - Keep MCP as `npx silo-agent mcp` (do not wrap in extra shell logging).
+    - Restart Claude Desktop after config updates.
+- `0 balance — get testnet tokens from https://faucet.0g.ai`
+  - Cause: wallet is unfunded.
+  - Fix:
+    - Fund the exact address in your MCP/backend `PRIVATE_KEY` via faucet.
+    - Re-run `npm run doctor`.
+
 ---
 
 ## Use With Claude Desktop / Cursor
@@ -79,7 +109,9 @@ No build step or absolute paths needed — `npx` resolves the package from npm.
 
 ---
 
-## MCP Tools (8)
+## MCP Tools
+
+SILO exposes 21 MCP tools. Core vault tools:
 
 | Tool | Description |
 |---|---|
@@ -92,6 +124,13 @@ No build step or absolute paths needed — `npx` resolves the package from npm.
 | `vault_share` | Encrypt, store, and generate a share descriptor for another agent |
 | `vault_import` | Retrieve and decrypt shared memory from another agent's descriptor |
 
+DeFAI tools:
+
+| Tool | Description |
+|---|---|
+| `defai_plan` | Generate a structured DeFi plan with guardrails + risk preview |
+| `defai_approve` | Explicit user approval/rejection gate before execution |
+
 ---
 
 ## Multi-Agent Sharing
@@ -191,7 +230,7 @@ console.log(proof.merkleRoot); // public commitment
 ```
 ┌────────────────────────────────────────────────────────┐
 │                   MCP Server (mcp.ts)                  │
-│              8 tools for any AI client                 │
+│              21 tools for any AI client                │
 │        pushes events to dashboard via REST             │
 └────────────────────┬───────────────────────────────────┘
                      │
@@ -233,6 +272,9 @@ npm run doctor
 # Run the full demo cycle
 npm run demo
 
+# Run the DeFAI safe-execution demo
+npm run defai:demo
+
 # Verify a specific stored memory
 npm run verify -- <rootHash>
 
@@ -243,6 +285,44 @@ npm run verify -- <traceRootHash> --trace
 npm run verify-flow
 ```
 
+## DeFAI Endpoints
+
+```bash
+POST /api/defai/plan
+POST /api/defai/approve
+```
+
+`/api/defai/plan` creates a structured swap plan with guardrails and simulation preview.  
+`/api/defai/approve` enforces explicit user control by requiring an approval/rejection action.
+
+Set `OG_COMPUTE_URL` to route planning rationale through 0G Compute. If unavailable, SILO falls back to deterministic heuristics.
+
+If you use the 0G starter-kit query API (`/api/services/query`), also set:
+- `OG_COMPUTE_PROVIDER_ADDRESS`
+- `OG_COMPUTE_FALLBACK_FEE` (default `0.01`)
+
+### DeFAI Scenario Card (Judge-Ready)
+
+- Intent: `Rebalance 500 USD from ETH to USDC`
+- Guardrails: `maxSlippageBps=75`, `timeoutSec=90`, `maxNotionalUsd=1000`, allowlist=`ETH,USDC,DAI,WBTC`
+- AI output: structured plan with route preview, risk rationale, and simulation (`expectedOutUsd`, `minOutUsd`)
+- User control: explicit `defai_approve` / `defai_reject` gate before any execution
+- Evidence: plan + approval artifacts encrypted to 0G with attestation trail
+- Execution mode in this MVP: `dry_run_only` (no automatic transaction broadcast)
+
+### DeFAI Safety Guarantees
+
+- No transaction is auto-broadcast by SILO DeFAI MVP.
+- Guardrail violations block planning before approval.
+- User approval is mandatory and explicit for every plan.
+- Rejection path is first-class (`defai_rejected`) and halts execution intent.
+- Plan and approval artifacts are persisted on 0G for post-hoc auditability.
+
+### DeFAI Scope Boundary (Honest MVP)
+
+SILO currently stops at planning + safety + approval + dry-run execution payload.  
+Execution adapters are pluggable via `execute(plan)` style integration and intentionally out-of-scope for this MVP.
+
 ---
 
 ## Project Structure
@@ -256,7 +336,7 @@ silo/
 │   │   │   ├── storage.ts        # 0G Storage SDK wrapper + ABI fix
 │   │   │   ├── attestation.ts    # Merkle-based execution proofs
 │   │   │   └── vault.ts          # Unified public API (AgentVault)
-│   │   ├── mcp.ts                # MCP server (8 tools)
+│   │   ├── mcp.ts                # MCP server (21 tools)
 │   │   ├── server.ts             # Express API + WebSocket server
 │   │   ├── verify.ts             # CLI: verify stored data
 │   │   ├── doctor.ts             # CLI: validate environment

package/build/defai-demo.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SILO DeFAI Demo
+ *
+ * Demonstrates:
+ *  1) Intent -> structured DeFi plan
+ *  2) Guardrails + risk explanation
+ *  3) Simulation preview
+ *  4) Explicit user approval gate
+ *  5) Encrypted attestation artifacts on 0G
+ *
+ * Usage:
+ *   npm run defai:demo
+ */
+export {};

package/build/defai-demo.js

@@ -0,0 +1,75 @@
+/**
+ * SILO DeFAI Demo
+ *
+ * Demonstrates:
+ *  1) Intent -> structured DeFi plan
+ *  2) Guardrails + risk explanation
+ *  3) Simulation preview
+ *  4) Explicit user approval gate
+ *  5) Encrypted attestation artifacts on 0G
+ *
+ * Usage:
+ *   npm run defai:demo
+ */
+import dotenv from "dotenv";
+import { AgentVault } from "./lib/vault.js";
+import { buildStructuredPlan, guardrailViolations } from "./lib/defai.js";
+dotenv.config();
+async function run() {
+    const vault = new AgentVault({
+        privateKey: process.env.PRIVATE_KEY,
+        evmRpc: process.env.EVM_RPC,
+        indexerRpc: process.env.INDEXER_RPC,
+        vaultSecret: process.env.VAULT_SECRET,
+    });
+    await vault.init();
+    const input = {
+        intent: "Rebalance 500 USD from ETH to USDC with strict risk limits",
+        tokenIn: "ETH",
+        tokenOut: "USDC",
+        amountUsd: 500,
+        guardrails: {
+            maxSlippageBps: 75,
+            timeoutSec: 90,
+            tokenAllowlist: ["ETH", "USDC", "DAI", "WBTC"],
+            maxNotionalUsd: 1000,
+        },
+    };
+    console.log("\n=== SILO DeFAI Demo ===");
+    console.log(`Agent: ${vault.address}`);
+    console.log(`Intent: ${input.intent}`);
+    const violations = guardrailViolations(input);
+    if (violations.length > 0) {
+        console.log("Guardrail violations:");
+        for (const v of violations)
+            console.log(`  - ${v}`);
+        process.exit(1);
+    }
+    const plan = await buildStructuredPlan(input);
+    console.log(`\nPlan ID: ${plan.planId}`);
+    console.log(`Risk: ${plan.risk.level.toUpperCase()} — ${plan.risk.explanation}`);
+    console.log(`Preview: expectedOut=$${plan.preview.expectedOutUsd}, minOut=$${plan.preview.minOutUsd}, impact=${plan.preview.simulatedPriceImpactBps}bps`);
+    console.log(`Compute: ${plan.compute.provider} (${plan.compute.used ? "used" : "fallback"})`);
+    console.log(`Approval required: ${plan.userApprovalRequired ? "yes" : "no"}`);
+    const planStore = await vault.store(JSON.stringify(plan, null, 2), "defai_plan");
+    console.log(`Plan artifact rootHash: ${planStore.rootHash}`);
+    const approved = true; // Demo path: explicit user approval
+    const approval = {
+        planId: plan.planId,
+        approved,
+        reason: "User reviewed preview and accepted guardrails",
+        timestamp: Date.now(),
+    };
+    const approvalStore = await vault.store(JSON.stringify(approval, null, 2), "defai_user_approved");
+    console.log(`Approval artifact rootHash: ${approvalStore.rootHash}`);
+    const commit = await vault.commitSession();
+    console.log(`\nCommitted session ${commit.sessionId}`);
+    console.log(`Merkle root: ${commit.merkleRoot}`);
+    console.log(`Trace rootHash: ${commit.traceRootHash}`);
+    console.log("\nDeFAI flow complete: intent -> plan -> approval -> attestation.");
+}
+run().catch((err) => {
+    console.error("DeFAI demo failed:", err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=defai-demo.js.map

package/build/defai-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defai-demo.js","sourceRoot":"","sources":["../src/defai-demo.ts"],"names":[],"mappings":"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"}

package/build/doctor.js

@@ -55,13 +55,25 @@ const checks = [
     {
         name: "Indexer RPC reachable",
         fn: async () => {
-            // Simple fetch to check the indexer is up
             const url = process.env.INDEXER_RPC;
-            // The indexer doesn't have a simple health endpoint,
-            // so we just verify the URL is set and looks valid
             if (!url.startsWith("http"))
                 throw new Error("Invalid URL");
-            return url;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            try {
+                const response = await fetch(url, {
+                    method: "GET",
+                    signal: controller.signal,
+                });
+                return `${url} (HTTP ${response.status})`;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Unknown indexer error";
+                throw new Error(message);
+            }
+            finally {
+                clearTimeout(timeout);
+            }
         },
     },
     {

package/build/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}

package/build/lib/defai.d.ts

@@ -0,0 +1,51 @@
+export interface Guardrails {
+    maxSlippageBps: number;
+    timeoutSec: number;
+    tokenAllowlist: string[];
+    maxNotionalUsd: number;
+}
+export interface PlanInput {
+    intent: string;
+    tokenIn: string;
+    tokenOut: string;
+    amountUsd: number;
+    guardrails: Guardrails;
+}
+export interface PlanStep {
+    id: string;
+    action: "quote" | "approve" | "swap" | "confirm";
+    description: string;
+}
+export interface RiskReport {
+    level: "low" | "medium" | "high";
+    reasons: string[];
+    explanation: string;
+}
+export interface PlanPreview {
+    expectedOutUsd: number;
+    minOutUsd: number;
+    simulatedPriceImpactBps: number;
+    route: string[];
+}
+export interface StructuredPlan {
+    planId: string;
+    createdAt: number;
+    input: PlanInput;
+    steps: PlanStep[];
+    constraints: Guardrails;
+    risk: RiskReport;
+    preview: PlanPreview;
+    userApprovalRequired: true;
+    compute: {
+        used: boolean;
+        provider: "heuristic" | "0g-compute";
+        rationale: string;
+    };
+}
+export declare function maybeComputeRationale(input: PlanInput): Promise<{
+    used: boolean;
+    provider: "heuristic" | "0g-compute";
+    rationale: string;
+}>;
+export declare function buildStructuredPlan(input: PlanInput): Promise<StructuredPlan>;
+export declare function guardrailViolations(input: PlanInput): string[];

package/build/lib/defai.js

@@ -0,0 +1,163 @@
+function clamp(num, min, max) {
+    return Math.max(min, Math.min(max, num));
+}
+function estimateImpactBps(amountUsd) {
+    if (amountUsd <= 250)
+        return 15;
+    if (amountUsd <= 1000)
+        return 35;
+    if (amountUsd <= 5000)
+        return 85;
+    return 150;
+}
+function evaluateRisk(input, impactBps) {
+    const reasons = [];
+    if (impactBps > 100)
+        reasons.push("Estimated price impact is elevated for requested size.");
+    if (input.guardrails.maxSlippageBps > 150)
+        reasons.push("Max slippage setting is permissive.");
+    if (input.amountUsd > input.guardrails.maxNotionalUsd * 0.8)
+        reasons.push("Trade size is near your configured notional limit.");
+    const level = reasons.length >= 2 ? "high" : reasons.length === 1 ? "medium" : "low";
+    const explanation = level === "low"
+        ? "Plan is within configured limits and expected impact is small."
+        : level === "medium"
+            ? "Plan is executable but has one notable risk signal. Review before approval."
+            : "Plan crosses multiple risk signals. Consider reducing size or tightening guardrails.";
+    return { level, reasons, explanation };
+}
+export async function maybeComputeRationale(input) {
+    const computeUrl = process.env.OG_COMPUTE_URL?.trim();
+    if (!computeUrl) {
+        return {
+            used: false,
+            provider: "heuristic",
+            rationale: `Heuristic plan for ${input.intent.toLowerCase()} with strict user guardrails.`,
+        };
+    }
+    try {
+        const model = process.env.OG_COMPUTE_MODEL?.trim() || "qwen-2.5-7b-instruct";
+        const authToken = process.env.OG_COMPUTE_API_KEY?.trim();
+        const providerAddress = process.env.OG_COMPUTE_PROVIDER_ADDRESS?.trim();
+        const fallbackFee = Number(process.env.OG_COMPUTE_FALLBACK_FEE ?? "0.01");
+        const headers = { "Content-Type": "application/json" };
+        if (authToken)
+            headers.Authorization = `Bearer ${authToken}`;
+        // We support three request/response styles:
+        // 1) 0G starter kit query endpoint:
+        //    POST /api/services/query
+        //    { providerAddress, query, fallbackFee }
+        //    -> { success: true, response: { content: "..." } }
+        // 1) Custom endpoint: { rationale: "..." }
+        // 2) OpenAI-compatible chat completions:
+        //    { choices: [{ message: { content: "..." } }] }
+        const isStarterKitQuery = computeUrl.includes("/api/services/query") && !!providerAddress;
+        const starterKitQuery = JSON.stringify({
+            providerAddress,
+            query: [
+                `Intent: ${input.intent}`,
+                `Pair: ${input.tokenIn} -> ${input.tokenOut}`,
+                `Amount: ${input.amountUsd} USD`,
+                `Constraints: ${JSON.stringify(input.guardrails)}`,
+                `Return concise risk-aware rationale only.`,
+            ].join("\n"),
+            fallbackFee,
+        });
+        const defaultQuery = JSON.stringify({
+            model,
+            task: "defi-planning-rationale",
+            messages: [
+                {
+                    role: "system",
+                    content: "You are a DeFi risk planner. Return concise rationale aligned to guardrails.",
+                },
+                {
+                    role: "user",
+                    content: JSON.stringify({
+                        intent: input.intent,
+                        tokenIn: input.tokenIn,
+                        tokenOut: input.tokenOut,
+                        amountUsd: input.amountUsd,
+                        constraints: input.guardrails,
+                    }),
+                },
+            ],
+            input: {
+                intent: input.intent,
+                tokenIn: input.tokenIn,
+                tokenOut: input.tokenOut,
+                amountUsd: input.amountUsd,
+                constraints: input.guardrails,
+            }
+        });
+        const res = await fetch(computeUrl, {
+            method: "POST",
+            headers,
+            body: isStarterKitQuery ? starterKitQuery : defaultQuery,
+        });
+        if (!res.ok)
+            throw new Error(`status ${res.status}`);
+        const data = await res.json();
+        const rationale = data.response?.content?.trim()
+            || data.rationale?.trim()
+            || data.output_text?.trim()
+            || data.text?.trim()
+            || data.choices?.[0]?.message?.content?.trim();
+        if (!rationale)
+            throw new Error("missing rationale");
+        return {
+            used: true,
+            provider: "0g-compute",
+            rationale,
+        };
+    }
+    catch {
+        return {
+            used: false,
+            provider: "heuristic",
+            rationale: `Fallback heuristic plan for ${input.intent.toLowerCase()} (0G Compute unavailable).`,
+        };
+    }
+}
+export async function buildStructuredPlan(input) {
+    const planId = `plan_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+    const impactBps = estimateImpactBps(input.amountUsd);
+    const slippageCap = clamp(input.guardrails.maxSlippageBps, 5, 500);
+    const effectiveSlip = Math.max(impactBps, Math.min(slippageCap, impactBps + 20));
+    const expectedOutUsd = Number((input.amountUsd * (1 - impactBps / 10000)).toFixed(2));
+    const minOutUsd = Number((input.amountUsd * (1 - effectiveSlip / 10000)).toFixed(2));
+    const risk = evaluateRisk(input, impactBps);
+    const compute = await maybeComputeRationale(input);
+    return {
+        planId,
+        createdAt: Date.now(),
+        input,
+        steps: [
+            { id: "s1", action: "quote", description: "Fetch route quote and verify token allowlist." },
+            { id: "s2", action: "approve", description: `Set token approval cap to exact notional (${input.amountUsd} USD equivalent).` },
+            { id: "s3", action: "swap", description: `Swap ${input.tokenIn} -> ${input.tokenOut} with max slippage ${input.guardrails.maxSlippageBps} bps.` },
+            { id: "s4", action: "confirm", description: "Require explicit user confirmation before final transaction broadcast." },
+        ],
+        constraints: input.guardrails,
+        risk,
+        preview: {
+            expectedOutUsd,
+            minOutUsd,
+            simulatedPriceImpactBps: impactBps,
+            route: [input.tokenIn, "USDC", input.tokenOut],
+        },
+        userApprovalRequired: true,
+        compute,
+    };
+}
+export function guardrailViolations(input) {
+    const violations = [];
+    if (!input.guardrails.tokenAllowlist.includes(input.tokenIn))
+        violations.push(`${input.tokenIn} is not in token allowlist.`);
+    if (!input.guardrails.tokenAllowlist.includes(input.tokenOut))
+        violations.push(`${input.tokenOut} is not in token allowlist.`);
+    if (input.amountUsd > input.guardrails.maxNotionalUsd)
+        violations.push(`Amount ${input.amountUsd} exceeds max notional ${input.guardrails.maxNotionalUsd}.`);
+    return violations;
+}
+//# sourceMappingURL=defai.js.map

package/build/lib/defai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defai.js","sourceRoot":"","sources":["../../src/lib/defai.ts"],"names":[],"mappings":"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"}

package/build/mcp.d.ts

@@ -16,6 +16,8 @@
  *   vault_status         — Show vault status and session info
  *   vault_share          — Store + generate share descriptor for another agent
  *   vault_import         — Retrieve shared memory from another agent
+ *   defai_plan           — Intent -> structured DeFi plan with guardrails
+ *   defai_approve        — Explicit approval/rejection gate for a plan
  *
  * Tools (Shared Memory):
  *   memory_write         — Write data to a named shared memory channel