@x1scroll/agent-sdk 1.0.2 → 1.0.3

package/README.md

@@ -122,28 +122,38 @@ const { txSig, memoryEntryPDA } = await client.storeMemory(
 
 **Fee:** 0.001 XNT (same as `storeMemory`)
 
-Requires a free [Pinata](https://pinata.cloud) API key (free tier: 100 pins, 1GB — enough for development and testing).
+By default, content is pinned to the **x1scroll validator network** — no API key, no configuration needed. Pinata is available as an alternative for production workloads requiring independent pinning.
 
 ```js
+// Default: pinned to x1scroll validator network (zero config)
 const { txSig, cid } = await client.uploadMemory(
   agentKeypair,
   humanWallet.publicKey.toBase58(),
   'session-2026-04-06',
   { summary: 'Discussed SDK launch', decisions: ['publish to npm', 'BSL license'] },
-  { pinataJwt: process.env.PINATA_JWT, tags: ['session', 'daily'] }
+  { tags: ['session', 'daily'] }
+);
+
+// Alternative: Pinata (bring your own key)
+const { txSig, cid } = await client.uploadMemory(
+  agentKeypair,
+  humanWallet.publicKey.toBase58(),
+  'session-2026-04-06',
+  { summary: 'Discussed SDK launch' },
+  { provider: 'pinata', pinataJwt: process.env.PINATA_JWT }
 );
-// Content is pinned on IPFS, CID stored on X1. Done.
 ```
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `pinataJwt` | `string` | — | **Required.** Get free at pinata.cloud |
+| `provider` | `string` | `'x1scroll'` | `'x1scroll'` (validator network) or `'pinata'` |
+| `pinataJwt` | `string` | — | Required only if provider is `'pinata'` |
 | `tags` | `string[]` | `[]` | Up to 5 tags |
 | `encrypted` | `boolean` | `false` | Whether content is encrypted |
 
 **Returns:** `Promise<{ txSig: string, memoryEntryPDA: string, cid: string }>`
 
-> **Use `uploadMemory()` if you want zero IPFS configuration.** Use `storeMemory()` directly if you manage your own pinning infrastructure.
+> **Use `uploadMemory()` for zero-config IPFS pinning.** Content is pinned to x1scroll validator infrastructure — as long as X1 runs, your agent remembers. Use `storeMemory()` directly if you manage your own pinning.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x1scroll/agent-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Agent identity and on-chain memory protocol for X1 blockchain",
   "license": "BSL-1.1",
   "main": "src/index.js",

package/src/index.js

@@ -551,38 +551,63 @@ class AgentClient {
    */
   async uploadMemory(agentKeypair, agentRecordHuman, topic, content, options = {}) {
     const {
+      provider  = 'x1scroll',
       pinataJwt = null,
       tags      = [],
       encrypted = false,
     } = options;
 
-    if (!pinataJwt) {
-      throw new AgentSDKError(
-        'pinataJwt is required for uploadMemory(). Get a free API key at https://pinata.cloud (free tier: 100 pins, 1GB). Pass it as options.pinataJwt.',
-        'MISSING_PINATA_JWT'
-      );
-    }
-
     // Serialize content
     const body = (typeof content === 'string') ? content : JSON.stringify(content);
 
     let cid;
 
-    // Upload to Pinata — auto-pinned, persistent
-    const res = await fetch('https://api.pinata.cloud/pinning/pinJSONToIPFS', {
-      method:  'POST',
-      headers: {
-        'Content-Type':  'application/json',
-        'Authorization': `Bearer ${pinataJwt}`,
-      },
-      body: JSON.stringify({ pinataContent: body, pinataMetadata: { name: topic } }),
-    });
-    if (!res.ok) {
-      const err = await res.text();
-      throw new AgentSDKError(`Pinata upload failed: ${err}`, 'PINATA_ERROR');
+    if (provider === 'x1scroll' || !provider) {
+      // Upload to x1scroll validator network — pinned across X1 infrastructure
+      const res = await fetch('https://x1scroll.io/api/ipfs/upload', {
+        method:  'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body:    JSON.stringify({
+          content:    body,
+          topic,
+          agentPubkey: agentKeypair.publicKey.toBase58(),
+        }),
+      });
+      if (!res.ok) {
+        const err = await res.text();
+        throw new AgentSDKError(`x1scroll IPFS upload failed (${res.status}): ${err}`, 'X1SCROLL_IPFS_ERROR');
+      }
+      const json = await res.json();
+      cid = json.cid;
+
+    } else if (provider === 'pinata') {
+      if (!pinataJwt) {
+        throw new AgentSDKError(
+          'pinataJwt is required when provider is "pinata". Get one at https://pinata.cloud',
+          'MISSING_PINATA_JWT'
+        );
+      }
+      const res = await fetch('https://api.pinata.cloud/pinning/pinJSONToIPFS', {
+        method:  'POST',
+        headers: {
+          'Content-Type':  'application/json',
+          'Authorization': `Bearer ${pinataJwt}`,
+        },
+        body: JSON.stringify({ pinataContent: body, pinataMetadata: { name: topic } }),
+      });
+      if (!res.ok) {
+        const err = await res.text();
+        throw new AgentSDKError(`Pinata upload failed: ${err}`, 'PINATA_ERROR');
+      }
+      const json = await res.json();
+      cid = json.IpfsHash;
+
+    } else {
+      throw new AgentSDKError(
+        `Unknown provider "${provider}". Supported: 'x1scroll' (default), 'pinata'`,
+        'INVALID_PROVIDER'
+      );
     }
-    const json = await res.json();
-    cid = json.IpfsHash;
 
     if (!cid) {
       throw new AgentSDKError('IPFS upload returned no CID', 'NO_CID');