@x1scroll/agent-sdk 1.0.1 → 1.0.3

package/README.md

@@ -122,35 +122,38 @@ const { txSig, memoryEntryPDA } = await client.storeMemory(
 
 **Fee:** 0.001 XNT (same as `storeMemory`)
 
+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
-// Using x1scroll.io IPFS (free, rate-limited — good for dev/testing)
+// 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'] }
+  { summary: 'Discussed SDK launch', decisions: ['publish to npm', 'BSL license'] },
+  { tags: ['session', 'daily'] }
 );
 
-// Using Pinata (production — persistent pinning guaranteed)
+// 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, tags: ['session', 'daily'] }
+  { provider: 'pinata', pinataJwt: process.env.PINATA_JWT }
 );
 ```
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `provider` | `string` | `'x1scroll'` | `'pinata'` or `'x1scroll'` |
-| `pinataJwt` | `string` | — | Required if provider is `'pinata'` |
+| `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.1",
+  "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

@@ -562,14 +562,31 @@ class AgentClient {
 
     let cid;
 
-    if (provider === 'pinata') {
+    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'
         );
       }
-      // Upload to Pinata — returns IpfsHash
       const res = await fetch('https://api.pinata.cloud/pinning/pinJSONToIPFS', {
         method:  'POST',
         headers: {
@@ -585,25 +602,9 @@ class AgentClient {
       const json = await res.json();
       cid = json.IpfsHash;
 
-    } else if (provider === 'x1scroll') {
-      // Upload to x1scroll.io IPFS node (free, rate-limited)
-      const res = await fetch('https://ipfs.x1scroll.io/upload', {
-        method:  'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body:    JSON.stringify({ content: body, topic, agentPubkey: agentKeypair.publicKey.toBase58() }),
-      });
-      if (!res.ok) {
-        throw new AgentSDKError(
-          `x1scroll IPFS upload failed (${res.status}). Use provider='pinata' for production workloads.`,
-          'X1SCROLL_IPFS_ERROR'
-        );
-      }
-      const json = await res.json();
-      cid = json.cid;
-
     } else {
       throw new AgentSDKError(
-        `Unknown provider "${provider}". Supported: 'pinata', 'x1scroll'`,
+        `Unknown provider "${provider}". Supported: 'x1scroll' (default), 'pinata'`,
         'INVALID_PROVIDER'
       );
     }