chore: final cleanup and documentation sync for v1.4.0 release

Author: gitsofaryan

contracts/ConfidentialFinance.sol

@@ -39,7 +39,7 @@ contract ConfidentialFinance is GatewayCaller {
      * @dev Verify if a proposed trade amount is within the encrypted risk threshold.
      * This allows an agent to prove it is following its private strategy without revealing the threshold.
      */
-    function verifyTradeLimit(einput tradeAmountHandle, bytes memory inputProof) public view returns (ebool) {
+    function verifyTradeLimit(einput tradeAmountHandle, bytes memory inputProof) public returns (ebool) {
         require(hasStrategy[msg.sender], "No strategy stored");
 
         euint64 tradeAmount = TFHE.asEuint64(tradeAmountHandle, inputProof);

src/demo-cli.ts

@@ -25,7 +25,7 @@ async function main() {
     console.log("  Delegation Token Issued!\n");
 
     console.log("Step 4: Agent B fetches Agent A's thoughts...");
-    const thoughts1 = await agentB.fetchMemoryStream(ipnsNameId, delegation.delegation);
+    const thoughts1 = await agentB.fetchMemoryStream(ipnsNameId, delegation);
     console.log(`  🤖 Agent B read: ${JSON.stringify(thoughts1)}\n`);
 
     console.log("Step 5: Agent A executes a task and updates its thoughts...");
@@ -36,7 +36,7 @@ async function main() {
     });
 
     console.log("\nStep 6: Agent B fetches from the EXACT SAME IPNS Name and sees the update!");
-    const thoughts2 = await agentB.fetchMemoryStream(ipnsNameId, delegation.delegation);
+    const thoughts2 = await agentB.fetchMemoryStream(ipnsNameId, delegation);
     console.log(`  🤖 Agent B read: ${JSON.stringify(thoughts2)}\n`);
 
     console.log("🚀 DEMONSTRATION COMPLETE!");

src/lib/index.ts

@@ -3,5 +3,7 @@ export { StorachaService } from './storacha.js';
 export { UcanService } from './ucan.js';
 export { AgentDbLangchainMemory } from './langchain.js';
 export { EncryptionService } from './encryption.js';
+export { AgentDbOpenClawMemory } from './openclaw.js';
+export { LitVincentService } from './lit-vincent.js';
 export * from './errors.js';
 

src/lib/storacha.ts

@@ -8,6 +8,19 @@ export class StorachaService {
     // Persistent local cache directory for simulated memories when Storacha space is missing.
     private static STORAGE_DIR = path.join(process.cwd(), '.agent_storage');
 
+    // Cached Storacha client (singleton to avoid re-creating on every call)
+    private static _cachedClient: any = null;
+
+    /**
+     * Returns a cached Storacha client instance.
+     */
+    private static async getClient() {
+        if (!StorachaService._cachedClient) {
+            StorachaService._cachedClient = await create();
+        }
+        return StorachaService._cachedClient;
+    }
+
     /**
      * Initializes the local storage directory.
      */
@@ -53,7 +66,7 @@ export class StorachaService {
         await StorachaService.ensureCacheDir();
         try {
             return await StorachaService.withRetry(async () => {
-                const client = await create();
+                const client = await StorachaService.getClient();
                 const blob = new Blob([JSON.stringify(memory)], { type: 'application/json' });
                 const files = [new File([blob], 'memory.json')];
 
@@ -120,7 +133,7 @@ export class StorachaService {
      * @returns The CID where the delegation token is stored.
      */
     static async publishDelegation(delegationBytes: Uint8Array): Promise<string> {
-        const client = await create();
+        const client = await StorachaService.getClient();
 
         const blob = new Blob([delegationBytes as any], { type: 'application/vnd.ipld.car' });
         const files = [new File([blob], 'delegation.car')];
@@ -162,7 +175,7 @@ export class StorachaService {
      * @returns The CID of the uploaded content.
      */
     static async uploadRaw(data: Uint8Array, filename: string, mimeType: string = 'application/octet-stream'): Promise<string> {
-        const client = await create();
+        const client = await StorachaService.getClient();
 
         const blob = new Blob([data as any], { type: mimeType });
         const files = [new File([blob], filename)];

src/mcp-server.ts

@@ -158,9 +158,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           capability: string; 
           expiry_hours: number 
         };
-        const token = await activeAgent.delegateTo(target_did, capability || "agent/read", expiry_hours || 24);
+        const targetPrincipal = { did: () => target_did };
+        const delegation = await activeAgent.delegateTo(targetPrincipal, capability || "agent/read", expiry_hours || 24);
+        const base64Token = await activeAgent.exportDelegationForApi(delegation);
         return {
-          content: [{ type: "text", text: `Access delegated. UCAN Token: ${token}` }],
+          content: [{ type: "text", text: `Access delegated to ${target_did}. UCAN Token (base64): ${base64Token}` }],
         };
       }
 

src/test-cold-start.ts

@@ -53,7 +53,7 @@ async function main() {
         const delegation = await agent.delegateTo(subAgent, 'agent/read');
         console.log(`  ✅ Issued delegation UCAN to sub-agent.`);
 
-        const verification = agent.verifyIncoming(delegation);
+        const verification = agent.verifyIncoming(delegation, agent.did);
         console.log(`  Verification for sub-agent: ${verification.valid ? '✅ VALID' : '❌ INVALID'}`);
         console.log('');