@shelby-protocol/sdk 0.3.1 → 0.4.0

package/dist/core/clients/ShelbyClient.d.ts

@@ -15,6 +15,7 @@ import '../operations/generated/sdk.js';
 import 'graphql';
 import '../networks.js';
 import '../types/storage_providers.js';
+import '../commitments.js';
 import '../rpc-responses.js';
 import '../types/payments.js';
 
@@ -91,6 +92,28 @@ declare class ShelbyClient {
      * This allows lazy initialization for users who don't provide a provider.
      */
     private getProvider;
+    /**
+     * Build orderless transaction options (a random replay-protection nonce) for
+     * the per-blob commit transactions. batchUpload finalizes blobs
+     * concurrently, so without orderless replay protection the parallel
+     * same-account submissions collide on the sequence number ("transaction
+     * already in mempool with a different payload"). The nonce makes each commit
+     * independent regardless of the client's `orderless` config flag.
+     */
+    private orderlessCommitOptions;
+    /**
+     * Resolve the on-chain UID assigned to `blobName` from a committed register
+     * transaction. `register_blob` only publishes the uid -> name mapping via
+     * `BlobRegisteredEvent` (a pending blob is not yet in the `objects` map, so it
+     * cannot be read back by name), so the upload flow must parse it here before
+     * uploading bytes or committing.
+     */
+    private uidFromRegisterTx;
+    /**
+     * Await a blob-registration transaction, rephrasing on-chain location
+     * failures into a human-readable message.
+     */
+    private waitForRegistration;
     /**
      * The base URL for the Shelby RPC node.
      */
@@ -102,8 +125,8 @@ declare class ShelbyClient {
      *
      * Note: This method accepts only `Uint8Array` and buffers the entire blob in memory.
      * For streaming uploads of large files (e.g. >2 GiB), orchestrate the steps manually
-     * using `generateCommitments()`, `coordination.registerBlob()`, and `rpc.putBlob()`
-     * with a `ReadableStream`.
+     * using `generateCommitments()`, `coordination.registerBlob()`, `rpc.putBlobChunksets()`,
+     * and `coordination.commitObject()` with a `ReadableStream`.
      *
      * @param params.blobData - The raw data to upload as a Uint8Array.
      * @param params.signer - The account that signs and pays for the transaction.
@@ -139,8 +162,8 @@ declare class ShelbyClient {
      *
      * Note: This method accepts only `Uint8Array` and buffers each blob in memory.
      * For streaming uploads of large files, orchestrate the steps manually using
-     * `generateCommitments()`, `coordination.registerBlob()`, and `rpc.putBlob()`
-     * with a `ReadableStream`.
+     * `generateCommitments()`, `coordination.registerBlob()`, `rpc.putBlobChunksets()`,
+     * and `coordination.commitObject()` with a `ReadableStream`.
      *
      * @param params.blobs - The blobs to upload.
      * @param params.blobs.blobData - The raw data to upload as a Uint8Array.