@opendatalabs/vana-sdk 3.12.0 → 3.13.0

package/README.md

@@ -108,41 +108,32 @@ const result = await storage.upload(myBlob, "report.json");
 console.log(result.url);
 ```
 
-### Scope Vana storage to a protocol network
+### Scope Vana storage by chain ID
 
-`VanaStorage` has two independent axes. `endpoint` is the **product host**
-(e.g. `https://storage.vana.org` for production, `https://storage-dev.vana.org`
-for internal staging). `network` is the **protocol network** (`mainnet` or
-`moksha`) that scopes the blob path. They are not synonyms — `storage-dev` is a
-staging host, not a stand-in for Moksha.
+Set `chainId` when writing to Vana Storage for a specific chain (e.g. `1480` for
+Vana mainnet, `14800` for Moksha). Uploads then use chain-scoped routes
+(`/v1/chains/{chainId}/blobs/...`) so data for different chains never collides.
 
 ```typescript
 import { createVanaStorageProvider } from "@opendatalabs/vana-sdk/node";
 
 const storage = createVanaStorageProvider({
-  endpoint: "https://storage.vana.org", // product host
-  network: "moksha", // protocol namespace within that host
+  endpoint: "https://storage.vana.org",
+  chainId: 14800,
   signer: {
     address: account.address,
     signMessage: (msg) => account.signMessage({ message: msg }),
   },
 });
 
-// Uploads to /v1/networks/moksha/blobs/{owner}/{scope}/{collectedAt}
 const result = await storage.upload(
   myBlob,
   "instagram.profile/2026-05-08T20:00:00.000Z",
 );
 ```
 
-When `network` is omitted, `VanaStorage` uses the legacy `/v1/blobs/...` routes,
-preserving backward compatibility. The Web3Signed audience is always the
-endpoint origin, never the network.
-
-A network-configured provider still accepts legacy same-endpoint
-`/v1/blobs/...` URLs so it can read or delete objects written before the opt-in,
-but it rejects URLs scoped to a _different_ explicit network — a Moksha provider
-won't act on a `mainnet`-scoped URL, and vice versa.
+Chain-configured providers reject legacy blob URLs and URLs scoped to a
+different explicit chain ID.
 
 ## Build a Vana app
 

package/dist/index.browser.js

@@ -29034,7 +29034,7 @@ var MAX_UPLOAD_ATTEMPTS = 4;
 var MAX_RATE_LIMIT_DELAY_MS = 3e4;
 var VanaStorage = class {
   endpoint;
-  network;
+  chainId;
   blobPathPrefix;
   signer;
   ownerAddress;
@@ -29048,15 +29048,15 @@ var VanaStorage = class {
       );
     }
     this.endpoint = (config.endpoint ?? DEFAULT_ENDPOINT).replace(/\/+$/, "");
-    if (config.network !== void 0 && !isProtocolNetwork(config.network)) {
+    if (config.chainId !== void 0 && !isValidChainId(config.chainId)) {
       throw new StorageError(
-        `Unsupported vana-storage network '${String(config.network)}'`,
-        "INVALID_NETWORK",
+        `Unsupported vana-storage chainId '${String(config.chainId)}'`,
+        "INVALID_CHAIN_ID",
         "vana-storage"
       );
     }
-    this.network = config.network;
-    this.blobPathPrefix = this.network ? `/v1/networks/${this.network}/blobs` : LEGACY_BLOB_PATH_PREFIX;
+    this.chainId = config.chainId;
+    this.blobPathPrefix = this.chainId !== void 0 ? `/v1/chains/${this.chainId}/blobs` : LEGACY_BLOB_PATH_PREFIX;
     this.signer = config.signer;
     this.ownerAddress = (config.ownerAddress ?? config.signer.address).toLowerCase();
     this.fetchImpl = config.fetchImpl ?? globalThis.fetch.bind(globalThis);
@@ -29253,10 +29253,9 @@ var VanaStorage = class {
         "vana-storage"
       );
     }
-    const crossNetwork = this.network ? route.network !== void 0 && route.network !== this.network : route.network !== void 0;
-    if (crossNetwork) {
+    if (route.chainId !== this.chainId) {
       throw new StorageError(
-        `URL network '${route.network ?? "legacy"}' does not match provider network '${this.network ?? "legacy"}'`,
+        `URL chainId '${route.chainId ?? "legacy"}' does not match provider chainId '${this.chainId ?? "legacy"}'`,
         "INVALID_URL",
         "vana-storage"
       );
@@ -29264,9 +29263,8 @@ var VanaStorage = class {
     return parsed.pathname;
   }
 };
-var PROTOCOL_NETWORKS = ["mainnet", "moksha"];
-function isProtocolNetwork(value) {
-  return typeof value === "string" && PROTOCOL_NETWORKS.includes(value);
+function isValidChainId(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
 }
 function parseBlobPath(pathname) {
   const segments = pathname.split("/").filter((s) => s.length > 0);
@@ -29276,11 +29274,13 @@ function parseBlobPath(pathname) {
     if (isTraversal(scope) || isTraversal(collectedAt)) return null;
     return { owner, scope, collectedAt };
   }
-  if (segments.length === 7 && segments[0] === "v1" && segments[1] === "networks" && segments[3] === "blobs") {
-    const [, , network, , owner, scope, collectedAt] = segments;
-    if (!isProtocolNetwork(network)) return null;
+  if (segments.length === 7 && segments[0] === "v1" && segments[1] === "chains" && segments[3] === "blobs") {
+    const [, , chainIdSegment, , owner, scope, collectedAt] = segments;
+    if (!/^[0-9]+$/.test(chainIdSegment)) return null;
+    const chainId = Number(chainIdSegment);
+    if (!isValidChainId(chainId)) return null;
     if (isTraversal(scope) || isTraversal(collectedAt)) return null;
-    return { network, owner, scope, collectedAt };
+    return { chainId, owner, scope, collectedAt };
   }
   return null;
 }