@shelby-protocol/sdk 0.3.1 → 0.4.1

package/dist/core/clients/ShelbyRPCClient.mjs

@@ -3,6 +3,65 @@ import {
   Hex as Hex3
 } from "@aptos-labs/ts-sdk";
 
+// src/core/erasure/constants.ts
+var ERASURE_CODE_PARAMS = {
+  ["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */]: {
+    // total chunks (data + parity)
+    erasure_n: 16,
+    // data chunks
+    erasure_k: 10,
+    // helper nodes
+    erasure_d: 13,
+    // enum index
+    enumIndex: 0
+  },
+  ["ClayCode_4Total_2Data_3Helper" /* ClayCode_4Total_2Data_3Helper */]: {
+    // total chunks (data + parity)
+    erasure_n: 4,
+    // data chunks
+    erasure_k: 2,
+    // helper nodes
+    erasure_d: 3,
+    // enum index
+    enumIndex: 1
+  }
+};
+function findErasureSchemeByErasureN(erasureN) {
+  return Object.entries(ERASURE_CODE_PARAMS).find(
+    ([, params]) => params.erasure_n === erasureN
+  );
+}
+var DEFAULT_ERASURE_N = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_n;
+var DEFAULT_ERASURE_K = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_k;
+var DEFAULT_ERASURE_D = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_d;
+var DEFAULT_ERASURE_M = DEFAULT_ERASURE_N - DEFAULT_ERASURE_K;
+
+// src/core/chunk.ts
+var CHUNK_SIZE_PARAMS = {
+  ["ChunkSet10MiB_Chunk1MiB" /* ChunkSet10MiB_Chunk1MiB */]: {
+    // 1MiB
+    chunkSizeBytes: 1 * 1024 * 1024,
+    // 10MiB
+    chunksetSizeBytes: 10 * 1024 * 1024
+  },
+  ["ChunkSet2MiB_Chunk1MiB" /* ChunkSet2MiB_Chunk1MiB */]: {
+    // 1MiB
+    chunkSizeBytes: 1 * 1024 * 1024,
+    // 2MiB
+    chunksetSizeBytes: 2 * 1024 * 1024
+  }
+};
+var DEFAULT_CHUNK_SIZE_BYTES = CHUNK_SIZE_PARAMS["ChunkSet10MiB_Chunk1MiB" /* ChunkSet10MiB_Chunk1MiB */].chunkSizeBytes;
+var DEFAULT_CHUNKSET_SIZE_BYTES = CHUNK_SIZE_PARAMS["ChunkSet10MiB_Chunk1MiB" /* ChunkSet10MiB_Chunk1MiB */].chunksetSizeBytes;
+var ERASURE_CODE_AND_CHUNK_MAPPING = {
+  ["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */]: {
+    ...CHUNK_SIZE_PARAMS.ChunkSet10MiB_Chunk1MiB
+  },
+  ["ClayCode_4Total_2Data_3Helper" /* ClayCode_4Total_2Data_3Helper */]: {
+    ...CHUNK_SIZE_PARAMS.ChunkSet2MiB_Chunk1MiB
+  }
+};
+
 // src/core/layout.ts
 import { z } from "zod";
 var BlobNameSchema = z.string().min(1, "Blob name path parameter cannot be empty.").max(
@@ -22,7 +81,7 @@ import { AptosConfig } from "@aptos-labs/ts-sdk";
 // src/core/constants.ts
 import { Network } from "@aptos-labs/ts-sdk";
 var NetworkToShelbyRPCBaseUrl = {
-  [Network.SHELBYNET]: "https://api.shelbynet.shelby.xyz/shelby",
+  [Network.SHELBYNET]: "https://shelby.shelbynet.shelby.xyz/shelby",
   [Network.NETNA]: void 0,
   [Network.DEVNET]: void 0,
   [Network.TESTNET]: "https://api.testnet.shelby.xyz/shelby",
@@ -88,18 +147,20 @@ import gql from "graphql-tag";
 var GetBlobsDocument = gql`
     query getBlobs($where: blobs_bool_exp, $orderBy: [blobs_order_by!], $limit: Int, $offset: Int) {
   blobs(where: $where, order_by: $orderBy, limit: $limit, offset: $offset) {
+    uid
+    object_name
     owner
     blob_commitment
-    blob_name
     created_at
     expires_at
+    updated_at
     num_chunksets
-    is_deleted
-    is_written
-    placement_group
     size
-    updated_at
     slice_address
+    placement_group
+    is_persisted
+    is_committed
+    is_deleted
   }
 }
     `;
@@ -111,7 +172,8 @@ var GetBlobActivitiesDocument = gql`
     limit: $limit
     offset: $offset
   ) {
-    blob_name
+    uid
+    object_name
     event_index
     event_type
     transaction_hash
@@ -259,22 +321,6 @@ var ChallengeResponseSchema = z2.object({
   challenge: z2.string(),
   expiresAt: z2.number()
 });
-var MultipartUploadStatusResponseSchema = z2.object({
-  uploadId: z2.string(),
-  completedParts: z2.array(z2.number()),
-  partSize: z2.number(),
-  nParts: z2.number(),
-  uploadedBytes: z2.number()
-});
-var StartMultipartUploadResponseSchema = z2.object({
-  uploadId: z2.string()
-});
-var UploadPartResponseSchema = z2.object({
-  success: z2.literal(true)
-});
-var CompleteMultipartUploadResponseSchema = z2.object({
-  success: z2.literal(true)
-});
 var RPCErrorResponseSchema = z2.object({
   error: z2.string()
 });
@@ -534,6 +580,19 @@ async function* readInChunks(input, chunkSize) {
     ];
   }
 }
+async function concatHashes(parts) {
+  const chunks = parts.map((part) => Hex2.fromHexInput(part).toUint8Array());
+  const totalLength = chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+  const combined = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const chunk of chunks) {
+    combined.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return Hex2.fromHexInput(
+    new Uint8Array(await crypto.subtle.digest("SHA-256", combined))
+  );
+}
 function isReadableStream(value) {
   return typeof value === "object" && value !== null && "getReader" in value && typeof value.getReader === "function";
 }
@@ -559,6 +618,7 @@ var BLOB_OWNER_AUTH_SCHEME_HEADER = "X-Shelby-Auth-Scheme";
 var BLOB_OWNER_IDENTITY_HEADER = "X-Shelby-Identity";
 var BLOB_OWNER_DOMAIN_HEADER = "X-Shelby-Domain";
 var BLOB_OWNER_AUTH_FUNCTION_HEADER = "X-Shelby-Auth-Function";
+var INCLUSION_PROOF_HEADER = "X-Shelby-Inclusion-Proof";
 function buildAuthHeaders(auth) {
   const signatureBase64 = btoa(
     Array.from(auth.signature, (byte) => String.fromCharCode(byte)).join("")
@@ -582,6 +642,58 @@ function buildAuthHeaders(auth) {
 function encodeURIComponentKeepSlashes(str) {
   return encodeURIComponent(str).replace(/%2F/g, "/");
 }
+async function generateChunksetInclusionProof(chunksetRoots, chunksetIndex) {
+  if (chunksetRoots.length === 0) {
+    throw new Error("Cannot generate inclusion proof for empty chunkset roots");
+  }
+  if (chunksetIndex < 0 || chunksetIndex >= chunksetRoots.length) {
+    throw new Error(
+      `Chunkset index ${chunksetIndex} out of range [0, ${chunksetRoots.length})`
+    );
+  }
+  if (chunksetRoots.length === 1) {
+    return [];
+  }
+  const zeroHash = new Uint8Array(32);
+  const siblings = [];
+  let currentLeaves = chunksetRoots.map((h) => h.toUint8Array());
+  let currentIdx = chunksetIndex;
+  while (currentLeaves.length > 1) {
+    if (currentLeaves.length % 2 !== 0) {
+      currentLeaves.push(zeroHash);
+    }
+    const siblingIdx = currentIdx % 2 === 0 ? currentIdx + 1 : currentIdx - 1;
+    siblings.push(currentLeaves[siblingIdx]);
+    const nextLeaves = [];
+    for (let i = 0; i < currentLeaves.length; i += 2) {
+      const combined = await concatHashes([
+        currentLeaves[i],
+        currentLeaves[i + 1]
+      ]);
+      nextLeaves.push(combined.toUint8Array());
+    }
+    currentLeaves = nextLeaves;
+    currentIdx = Math.floor(currentIdx / 2);
+  }
+  return siblings;
+}
+function encodeInclusionProof(siblings) {
+  if (siblings.length === 0) {
+    return "NONE";
+  }
+  const totalBytes = siblings.length * 32;
+  const combined = new Uint8Array(totalBytes);
+  let offset = 0;
+  for (const sibling of siblings) {
+    combined.set(sibling, offset);
+    offset += 32;
+  }
+  const binaryString = Array.from(
+    combined,
+    (byte) => String.fromCharCode(byte)
+  ).join("");
+  return btoa(binaryString);
+}
 function validateTotalBytes(totalBytes) {
   if (!Number.isInteger(totalBytes) || totalBytes < 0) {
     throw new Error("totalBytes must be a non-negative integer");
@@ -613,7 +725,7 @@ var ShelbyRPCClient = class {
    * @param config - The client configuration object.
    * @param config.network - The Shelby network to use.
    * @param options.signChallengeHandler - Optional override for challenge
-   *   signing. When set, `putBlobResumable` uses this instead of the built-in
+   *   signing. When set, `putBlobChunksets` uses this instead of the built-in
    *   `signChallenge`. Intended for kit-level overrides (e.g. Solana DAA).
    *
    * @example
@@ -664,43 +776,6 @@ var ShelbyRPCClient = class {
     }
     return ChallengeResponseSchema.parse(await response.json());
   }
-  /**
-   * Check if there's an existing multipart upload for a blob.
-   * Returns the upload status including which parts have been uploaded.
-   *
-   * @param account - The account that owns the blob.
-   * @param blobName - The name of the blob.
-   * @returns The upload status, or undefined if no pending upload exists.
-   *
-   * @example
-   * ```typescript
-   * const status = await client.getMultipartUploadStatus(account, "myblob.txt");
-   * if (status) {
-   *   console.log(`Resuming upload ${status.uploadId}, ${status.completedParts.length} parts done`);
-   * }
-   * ```
-   */
-  async getMultipartUploadStatus(account, blobName) {
-    const url = new URL(buildRequestUrl("/v1/multipart-uploads", this.baseUrl));
-    url.searchParams.set("account", account.toString());
-    url.searchParams.set("blobName", blobName);
-    const response = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-      }
-    });
-    if (response.status === 404) {
-      return void 0;
-    }
-    if (!response.ok) {
-      const errorBody = await response.text().catch(() => "");
-      throw new Error(
-        `Failed to get multipart upload status: status ${response.status}, body: ${errorBody}`
-      );
-    }
-    return MultipartUploadStatusResponseSchema.parse(await response.json());
-  }
   /**
    * Sign a challenge using the given account and return auth credentials.
    *
@@ -717,269 +792,142 @@ var ShelbyRPCClient = class {
       publicKey: account.publicKey.toUint8Array()
     };
   }
-  async #uploadPart(uploadId, partIdx, partData) {
-    const nRetries = 5;
-    let lastResponse;
-    let lastError;
-    let attempts = 0;
-    const partUrl = buildRequestUrl(
-      `/v1/multipart-uploads/${uploadId}/parts/${partIdx}`,
-      this.baseUrl
-    );
-    for (let i = 0; i < nRetries; ++i) {
-      attempts++;
-      try {
-        lastResponse = await fetch(partUrl, {
-          method: "PUT",
-          headers: {
-            "Content-Type": "application/octet-stream",
-            ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-          },
-          body: partData
-        });
-        lastError = void 0;
-      } catch (error) {
-        lastError = error;
-        if (i < nRetries - 1) {
-          const delay = 2 ** i * 100;
-          await sleep(delay);
-          continue;
-        }
-        break;
-      }
-      if (lastResponse.ok) return;
-      if (!isRetryableStatus(lastResponse.status)) {
-        break;
-      }
-      if (i < nRetries - 1) {
-        const delay = 2 ** i * 100;
-        await sleep(delay);
-      }
-    }
-    if (lastError !== void 0) {
-      const errorCode = getErrorCode(lastError);
-      const errorMessage = lastError instanceof Error ? lastError.message : String(lastError);
-      throw new Error(
-        `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${attempts} attempt${attempts === 1 ? "" : "s"}. The connection to the Shelby RPC endpoint was interrupted while sending data${errorCode ? ` (${errorCode})` : ""}. Endpoint: ${partUrl.toString()}, partBytes: ${partData.length}. Last error: ${errorMessage}`,
-        { cause: lastError }
-      );
-    }
-    const errorBody = await lastResponse?.text().catch(() => "");
-    throw new Error(
-      `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${attempts} attempt${attempts === 1 ? "" : "s"}. status: ${lastResponse?.status}, body: ${errorBody}`
-    );
-  }
-  async #putBlobMultipart(account, blobName, blobData, totalBytes, partSize = 5 * 1024 * 1024, onProgress) {
-    validateTotalBytes(totalBytes);
-    const startResponse = await fetch(
-      buildRequestUrl("/v1/multipart-uploads", this.baseUrl),
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-        },
-        body: JSON.stringify({
-          rawAccount: account.toString(),
-          rawBlobName: blobName,
-          rawPartSize: partSize
-        })
-      }
-    );
-    if (!startResponse.ok) {
-      let errorBodyText = "Could not read error body";
-      try {
-        errorBodyText = await startResponse.text();
-      } catch (_e) {
-      }
-      throw new Error(
-        `Failed to start multipart upload! status: ${startResponse.status}, body: ${errorBodyText}`
-      );
-    }
-    const { uploadId } = StartMultipartUploadResponseSchema.parse(
-      await startResponse.json()
-    );
-    const totalParts = Math.ceil(totalBytes / partSize);
-    let uploadedBytes = 0;
-    for await (const [partIdx, partData] of readInChunks(blobData, partSize)) {
-      await this.#uploadPart(uploadId, partIdx, partData);
-      uploadedBytes += partData.length;
-      onProgress?.({
-        phase: "uploading",
-        partIdx,
-        totalParts,
-        partBytes: partData.length,
-        uploadedBytes,
-        totalBytes
-      });
-    }
-    if (uploadedBytes !== totalBytes) {
-      throw new Error(
-        `Uploaded bytes (${uploadedBytes}) did not match declared totalBytes (${totalBytes})`
-      );
-    }
-    const finalPartIdx = totalParts > 0 ? totalParts - 1 : 0;
-    onProgress?.({
-      phase: "finalizing",
-      partIdx: finalPartIdx,
-      totalParts,
-      // no part uploaded in this phase
-      partBytes: 0,
-      uploadedBytes: totalBytes,
-      totalBytes
-    });
-    const completeResponse = await fetch(
-      buildRequestUrl(
-        `/v1/multipart-uploads/${uploadId}/complete`,
-        this.baseUrl
-      ),
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-        }
-      }
-    );
-    if (!completeResponse.ok) {
-      let errorBodyText = "Could not read error body";
-      try {
-        errorBodyText = await completeResponse.text();
-      } catch (_e) {
-      }
-      throw new Error(
-        `Failed to complete multipart upload! status: ${completeResponse.status}, body: ${errorBodyText}`
-      );
-    }
-  }
   /**
-   * Uploads blob data to the Shelby RPC node for storage by storage providers.
-   * This method should be called after blob commitments have been registered on the blockchain.
-   * Uses multipart upload for efficient handling of large files.
-   *
-   * @param params.account - The account that owns the blob.
-   * @param params.blobName - The name/path of the blob (e.g. "folder/file.txt").
-   * @param params.blobData - The raw blob data as a Uint8Array or ReadableStream.
-   * @param params.totalBytes - Total byte length. Required for streams; optional for Uint8Array.
-   *
-   * @example
-   * ```typescript
-   * const blobData = new TextEncoder().encode("Hello, world!");
-   *
-   * await client.putBlob({
-   *   account: AccountAddress.from("0x1"),
-   *   blobName: "greetings/hello.txt",
-   *   blobData,
-   * });
-   * ```
-   */
-  async putBlob(params) {
-    BlobNameSchema.parse(params.blobName);
-    let totalBytes;
-    if (params.blobData instanceof Uint8Array) {
-      totalBytes = params.totalBytes ?? params.blobData.length;
-      if (totalBytes !== params.blobData.length) {
-        throw new Error(
-          "totalBytes must match blobData.length when blobData is a Uint8Array"
-        );
-      }
-    } else {
-      if (params.totalBytes === void 0) {
-        throw new Error(
-          "totalBytes is required when blobData is a ReadableStream"
-        );
-      }
-      totalBytes = params.totalBytes;
-    }
-    validateTotalBytes(totalBytes);
-    await this.#putBlobMultipart(
-      params.account,
-      params.blobName,
-      params.blobData,
-      totalBytes,
-      void 0,
-      params.onProgress
-    );
-  }
-  /**
-   * Upload a part with authentication headers.
+   * Upload a single chunkset via the v2 chunkset API.
    */
-  async #uploadPartWithAuth(uploadId, partIdx, partData, auth) {
-    const nRetries = 5;
+  async #uploadChunkset(params) {
+    const maxNonBusyRetries = 5;
     let lastResponse;
     let lastError;
     let attempts = 0;
-    const partUrl = buildRequestUrl(
-      `/v1/multipart-uploads/${uploadId}/parts/${partIdx}`,
+    let consecutive429s = 0;
+    let nonBusyRetries = 0;
+    const chunksetUrl = buildRequestUrl(
+      `/v2/chunksets/${params.account}/${params.chunksetIndex}/${params.uid}`,
       this.baseUrl
     );
-    const authHeaders = buildAuthHeaders(auth);
-    for (let i = 0; i < nRetries; ++i) {
+    const authHeaders = buildAuthHeaders(params.auth);
+    while (true) {
+      if (params.signal?.aborted) {
+        throw new DOMException("Upload aborted", "AbortError");
+      }
       attempts++;
       try {
-        lastResponse = await fetch(partUrl, {
+        lastResponse = await fetch(chunksetUrl, {
           method: "PUT",
           headers: {
             "Content-Type": "application/octet-stream",
             ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
-            ...authHeaders
+            ...authHeaders,
+            [INCLUSION_PROOF_HEADER]: params.inclusionProof
           },
-          body: partData
+          body: params.chunksetData,
+          signal: params.signal
         });
         lastError = void 0;
       } catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+          throw error;
+        }
         lastError = error;
-        if (i < nRetries - 1) {
-          const delay = 2 ** i * 100;
-          await sleep(delay);
+        consecutive429s = 0;
+        nonBusyRetries++;
+        if (nonBusyRetries < maxNonBusyRetries) {
+          const delay2 = 2 ** nonBusyRetries * 100;
+          await sleep(delay2);
           continue;
         }
         break;
       }
-      if (lastResponse.ok) return;
+      if (lastResponse.ok) {
+        const json = await lastResponse.json();
+        const spAcks = json.spAcks?.map((ack) => ({
+          slot: ack.slot,
+          signature: Uint8Array.from(
+            atob(ack.signature),
+            (c) => c.charCodeAt(0)
+          )
+        }));
+        return {
+          success: json.success,
+          acksReceived: json.acksReceived,
+          spAcks
+        };
+      }
+      if (lastResponse.status === 429) {
+        consecutive429s++;
+        const baseDelay = 500;
+        const jitter = Math.random() * 200;
+        const delay2 = Math.min(
+          3e4,
+          2 ** consecutive429s * baseDelay + jitter
+        );
+        await sleep(delay2);
+        continue;
+      }
+      consecutive429s = 0;
       if (!isRetryableStatus(lastResponse.status)) {
         break;
       }
-      if (i < nRetries - 1) {
-        const delay = 2 ** i * 100;
-        await sleep(delay);
+      nonBusyRetries++;
+      if (nonBusyRetries >= maxNonBusyRetries) {
+        break;
       }
+      const delay = 2 ** nonBusyRetries * 100;
+      await sleep(delay);
     }
     if (lastError !== void 0) {
       const errorCode = getErrorCode(lastError);
       const errorMessage = lastError instanceof Error ? lastError.message : String(lastError);
       throw new Error(
-        `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${attempts} attempt${attempts === 1 ? "" : "s"}. ${errorCode ? `(${errorCode}) ` : ""}Last error: ${errorMessage}`,
+        `Failed to upload chunkset ${params.chunksetIndex} after ${attempts} attempt${attempts === 1 ? "" : "s"}. ${errorCode ? `(${errorCode}) ` : ""}Last error: ${errorMessage}`,
         { cause: lastError }
       );
     }
     const errorBody = await lastResponse?.text().catch(() => "");
     throw new Error(
-      `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${attempts} attempt${attempts === 1 ? "" : "s"}. status: ${lastResponse?.status}, body: ${errorBody}`
+      `Failed to upload chunkset ${params.chunksetIndex} after ${attempts} attempt${attempts === 1 ? "" : "s"}. status: ${lastResponse?.status}, body: ${errorBody}`
     );
   }
   /**
-   * Uploads blob data to the Shelby RPC node with authentication and resume support.
-   * This method authenticates using challenge-response and can resume interrupted uploads.
+   * Uploads blob data to the Shelby RPC node using the v2 chunkset API.
+   * This method authenticates using challenge-response and uploads chunksets
+   * directly to storage providers via the RPC's worker pool.
+   *
+   * This method:
+   * - Sends raw chunkset data directly to the RPC for erasure encoding
+   * - Requires pre-computed blob commitments to generate inclusion proofs
+   * - Does not support resume (each chunkset is idempotent on the SP side)
    *
    * @param params.account - The Aptos Account (with signing capability) that owns the blob.
-   * @param params.blobName - The name/path of the blob (e.g. "folder/file.txt").
+   * @param params.uid - The blob's on-chain UID (from `BlobRegisteredEvent` at registration).
    * @param params.blobData - The raw blob data as a Uint8Array or ReadableStream.
+   * @param params.commitments - Pre-computed blob commitments (from generateCommitments).
    * @param params.totalBytes - Total byte length. Required for streams; optional for Uint8Array.
+   * @param params.chunksetConcurrency - Number of chunksets to upload in parallel. Defaults to 4.
    * @param params.onProgress - Optional callback for upload progress.
+   * @param params.signal - Optional AbortSignal for cancellation. When aborted, in-flight
+   *   HTTP requests are cancelled and an AbortError is thrown.
    *
    * @example
    * ```typescript
-   * await client.putBlobResumable({
-   *   account: myAccount, // Aptos Account with signing capability
-   *   blobName: "documents/report.pdf",
+   * // First, generate commitments for the blob
+   * const commitments = await generateCommitments(provider, fileData);
+   *
+   * // Register the blob on chain, then read its UID from the register tx's
+   * // BlobRegisteredEvent (see ShelbyBlobClient.registeredBlobUids).
+   *
+   * // Upload using chunkset API
+   * await rpcClient.putBlobChunksets({
+   *   account: myAccount,
+   *   uid: blobUid,
    *   blobData: fileData,
-   *   totalBytes: fileData.length,
+   *   commitments,
+   *   chunksetConcurrency: 8,
    * });
    * ```
    */
-  async putBlobResumable(params) {
-    BlobNameSchema.parse(params.blobName);
+  async putBlobChunksets(params) {
     let totalBytes;
     if (params.blobData instanceof Uint8Array) {
       totalBytes = params.totalBytes ?? params.blobData.length;
@@ -997,110 +945,146 @@ var ShelbyRPCClient = class {
       totalBytes = params.totalBytes;
     }
     validateTotalBytes(totalBytes);
-    const partSize = params.partSize ?? 5 * 1024 * 1024;
+    const chunksetConcurrency = params.chunksetConcurrency ?? 4;
+    const totalChunksets = params.commitments.chunkset_commitments.length;
+    const rawDataSizeFromCommitments = params.commitments.raw_data_size;
+    if (rawDataSizeFromCommitments !== totalBytes) {
+      throw new Error(
+        `Data size mismatch: commitments were generated for ${rawDataSizeFromCommitments} bytes, but totalBytes=${totalBytes}. This will cause inclusion proof verification to fail.`
+      );
+    }
+    const chunksetRoots = params.commitments.chunkset_commitments.map(
+      (c) => Hex3.fromHexString(c.chunkset_root)
+    );
     const { challenge } = await this.getChallenge(
       params.account.accountAddress
     );
     const signFn = this.#signChallengeOverride ?? this.signChallenge.bind(this);
     const auth = signFn(params.account, challenge);
-    const authHeaders = buildAuthHeaders(auth);
-    const existingUpload = await this.getMultipartUploadStatus(
-      params.account.accountAddress,
-      params.blobName
-    );
-    let uploadId;
-    let completedPartsSet;
-    let totalParts;
-    if (existingUpload) {
-      uploadId = existingUpload.uploadId;
-      completedPartsSet = new Set(existingUpload.completedParts);
-      totalParts = existingUpload.nParts;
-      if (existingUpload.partSize !== partSize) {
-        throw new Error(
-          `Cannot resume upload: part size mismatch. Existing upload uses ${existingUpload.partSize} bytes, but ${partSize} was requested.`
-        );
-      }
-    } else {
-      const startResponse = await fetch(
-        buildRequestUrl("/v1/multipart-uploads", this.baseUrl),
-        {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
-            ...authHeaders
-          },
-          body: JSON.stringify({
-            rawAccount: params.account.accountAddress.toString(),
-            rawBlobName: params.blobName,
-            rawPartSize: partSize
-          })
-        }
+    const firstChunkset = params.commitments.chunkset_commitments[0];
+    if (!firstChunkset) {
+      throw new Error("Commitments must have at least one chunkset");
+    }
+    const erasure_n = firstChunkset.chunk_commitments.length;
+    const matchingEntry = findErasureSchemeByErasureN(erasure_n);
+    if (!matchingEntry) {
+      throw new Error(
+        `Unknown erasure coding scheme with erasure_n=${erasure_n}`
       );
-      if (!startResponse.ok) {
-        const errorBodyText = await startResponse.text().catch(() => "");
-        throw new Error(
-          `Failed to start multipart upload! status: ${startResponse.status}, body: ${errorBodyText}`
-        );
-      }
-      const parsed = StartMultipartUploadResponseSchema.parse(
-        await startResponse.json()
+    }
+    const [schemeKey, matchingParams] = matchingEntry;
+    const erasure_k = matchingParams.erasure_k;
+    const { chunkSizeBytes } = ERASURE_CODE_AND_CHUNK_MAPPING[schemeKey];
+    const chunksetSize = erasure_k * chunkSizeBytes;
+    const expectedChunksetCount = totalBytes === 0 ? 1 : Math.ceil(totalBytes / chunksetSize);
+    if (expectedChunksetCount !== totalChunksets) {
+      throw new Error(
+        `Chunkset count mismatch: expected ${expectedChunksetCount} chunksets for ${totalBytes} bytes with chunksetSize=${chunksetSize}, but commitments have ${totalChunksets} chunksets. This suggests the commitments were generated with a different encoding scheme.`
       );
-      uploadId = parsed.uploadId;
-      completedPartsSet = /* @__PURE__ */ new Set();
-      totalParts = Math.ceil(totalBytes / partSize);
     }
     let uploadedBytes = 0;
-    let partIdx = 0;
-    for await (const [idx, partData] of readInChunks(
-      params.blobData,
-      partSize
-    )) {
-      partIdx = idx;
-      if (completedPartsSet.has(partIdx)) {
-        uploadedBytes += partData.length;
-        continue;
+    let bytesReadFromSource = 0;
+    const inFlight = /* @__PURE__ */ new Set();
+    async function* chunksetsFromBlob() {
+      if (totalBytes === 0) {
+        yield [0, new Uint8Array(chunksetSize)];
+        return;
       }
-      await this.#uploadPartWithAuth(uploadId, partIdx, partData, auth);
-      uploadedBytes += partData.length;
-      params.onProgress?.({
-        phase: "uploading",
-        partIdx,
-        totalParts,
-        partBytes: partData.length,
-        uploadedBytes,
-        totalBytes
+      yield* readInChunks(params.blobData, chunksetSize);
+    }
+    const chunksetIterator = chunksetsFromBlob();
+    const aggregatedAcks = /* @__PURE__ */ new Map();
+    const internalAbort = new AbortController();
+    if (params.signal?.aborted) {
+      internalAbort.abort();
+    } else if (params.signal) {
+      params.signal.addEventListener("abort", () => internalAbort.abort(), {
+        once: true
       });
     }
-    const finalPartIdx = totalParts > 0 ? totalParts - 1 : 0;
-    params.onProgress?.({
-      phase: "finalizing",
-      partIdx: finalPartIdx,
-      totalParts,
-      partBytes: 0,
-      uploadedBytes: totalBytes,
-      totalBytes
-    });
-    const completeResponse = await fetch(
-      buildRequestUrl(
-        `/v1/multipart-uploads/${uploadId}/complete`,
-        this.baseUrl
-      ),
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
-          ...authHeaders
+    let iteratorDone = false;
+    let firstError = null;
+    while (!iteratorDone || inFlight.size > 0) {
+      if (internalAbort.signal.aborted) {
+        throw firstError ?? new DOMException("Upload aborted", "AbortError");
+      }
+      while (inFlight.size < chunksetConcurrency && !iteratorDone) {
+        const { value, done } = await chunksetIterator.next();
+        if (done) {
+          iteratorDone = true;
+          break;
         }
+        const [chunksetIdx, chunksetData] = value;
+        bytesReadFromSource += totalBytes === 0 ? 0 : chunksetData.byteLength;
+        const expectedCommitment = params.commitments.chunkset_commitments[chunksetIdx];
+        if (!expectedCommitment) {
+          throw new Error(
+            `Chunkset index ${chunksetIdx} out of range. Commitments only have ${totalChunksets} chunksets. This suggests a chunkset size mismatch between commitment generation and upload.`
+          );
+        }
+        const proofSiblings = await generateChunksetInclusionProof(
+          chunksetRoots,
+          chunksetIdx
+        );
+        const inclusionProof = encodeInclusionProof(proofSiblings);
+        const chunksetDataCopy = new Uint8Array(chunksetData);
+        const chunksetBytes = chunksetDataCopy.length;
+        const uploadPromise = (async () => {
+          const result = await this.#uploadChunkset({
+            account: params.account.accountAddress.toString(),
+            uid: params.uid,
+            chunksetIndex: chunksetIdx,
+            inclusionProof,
+            chunksetData: chunksetDataCopy,
+            auth,
+            signal: internalAbort.signal
+          });
+          const chunksetSpAcks = result.spAcks?.map((ack) => ({
+            slot: ack.slot,
+            signature: ack.signature
+          }));
+          if (chunksetSpAcks) {
+            for (const ack of chunksetSpAcks) {
+              aggregatedAcks.set(ack.slot, ack.signature);
+            }
+          }
+          uploadedBytes += chunksetBytes;
+          params.onProgress?.({
+            phase: "uploading",
+            chunksetIdx,
+            totalChunksets,
+            chunksetBytes,
+            uploadedBytes,
+            totalBytes,
+            acksReceived: result.acksReceived,
+            spAcks: chunksetSpAcks
+          });
+        })().catch((err) => {
+          if (!firstError) {
+            firstError = err;
+            internalAbort.abort();
+          }
+        }).finally(() => {
+          inFlight.delete(uploadPromise);
+        });
+        inFlight.add(uploadPromise);
       }
-    );
-    if (!completeResponse.ok) {
-      const errorBodyText = await completeResponse.text().catch(() => "");
+      if (inFlight.size > 0) {
+        await Promise.race(inFlight);
+      }
+    }
+    if (firstError) {
+      throw firstError;
+    }
+    if (bytesReadFromSource !== totalBytes) {
       throw new Error(
-        `Failed to complete multipart upload! status: ${completeResponse.status}, body: ${errorBodyText}`
+        `Data source produced ${bytesReadFromSource} bytes, but expected ${totalBytes} bytes. The stream may have ended prematurely, resulting in an incomplete upload.`
       );
     }
+    const spAcks = Array.from(
+      aggregatedAcks.entries()
+    ).map(([slot, signature]) => ({ slot, signature }));
+    return { spAcks };
   }
   /**
    * Downloads a blob from the Shelby RPC node.