@shelby-protocol/react 0.0.4 → 0.0.5

package/dist/mutations/useDeleteBlobs.d.ts

@@ -0,0 +1,77 @@
+import type { InputGenerateTransactionOptions } from "@aptos-labs/ts-sdk";
+import type { UseMutationOptionsWithClient } from "../types/mutations";
+import type { Signer } from "../types/signers";
+export type UseDeleteBlobsVariables = {
+    /**
+     * The signer to use for the transaction.
+     *
+     * @see {@link Signer}
+     *
+     * @example
+     * ```tsx
+     * const signer = new Account.generate();
+     * deleteBlobs.mutate({
+     *   signer,
+     *   blobNames: ["folder/file1.txt", "folder/file2.txt"],
+     * });
+     * ```
+     */
+    signer: Signer;
+    /**
+     * The names/paths of the blobs to delete, without the account address prefix
+     * (e.g. ["folder/file1.txt", "folder/file2.txt"], NOT ["0x1/folder/file1.txt"]).
+     * The account address prefix is automatically derived from the signer.
+     */
+    blobNames: string[];
+    /**
+     * Optional transaction building options.
+     */
+    options?: InputGenerateTransactionOptions;
+};
+export type UseDeleteBlobsOptions = UseMutationOptionsWithClient<{
+    hash: string;
+}, Error, UseDeleteBlobsVariables>;
+/**
+ * Deletes one or more blobs on-chain.
+ *
+ * This hook automatically optimizes gas costs by using `delete_blob` for single
+ * blob deletion and `delete_multiple_blobs` for multiple blobs.
+ *
+ * **Note:** Deleting multiple blobs (more than one) requires the `delete_multiple_blobs`
+ * entry function which will be deployed to the smart contract on 2026-02-04.
+ * Using this hook with multiple blobs before that date will result in a transaction failure.
+ * Single blob deletion works immediately.
+ *
+ * This mutation deletes blob metadata from the Shelby contract. It supports
+ * both account signers and wallet adapter signers.
+ *
+ * When deleting multiple blobs, the operation is atomic: if any blob deletion
+ * fails (e.g., blob not found), the entire transaction fails and no blobs are deleted.
+ *
+ * @example
+ * ```tsx
+ * import { ShelbyClient } from "@shelby-protocol/sdk/browser";
+ * import { Network } from "@aptos-labs/ts-sdk";
+ * import { useDeleteBlobs } from "@shelby-protocol/react";
+ *
+ * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });
+ * const deleteBlobs = useDeleteBlobs({
+ *   client: shelbyClient,
+ *   onSuccess: ({ hash }) => console.log("Delete tx:", hash),
+ * });
+ *
+ * // Delete a single blob
+ * deleteBlobs.mutate({
+ *   signer,
+ *   blobNames: ["folder/file.txt"],
+ * });
+ *
+ * // Delete multiple blobs in one transaction
+ * deleteBlobs.mutate({
+ *   signer,
+ *   blobNames: ["folder/file1.txt", "folder/file2.txt"],
+ * });
+ * ```
+ */
+export declare function useDeleteBlobs({ client, ...options }: UseDeleteBlobsOptions): import("@tanstack/react-query").UseMutationResult<import("@aptos-labs/wallet-adapter-react").AptosSignAndSubmitTransactionOutput, Error, UseDeleteBlobsVariables, readonly unknown[]>;
+//# sourceMappingURL=useDeleteBlobs.d.ts.map

package/dist/mutations/useDeleteBlobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteBlobs.d.ts","sourceRoot":"","sources":["../../src/mutations/useDeleteBlobs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAI1E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,+BAA+B,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAC9D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChB,KAAK,EACL,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,qBAAqB,yLAuD3E"}

package/dist/mutations/useEncodeBlobs.d.ts

@@ -1,5 +1,5 @@
 import { type BlobCommitments, type ErasureCodingProvider } from "@shelby-protocol/sdk/browser";
-import type { UseMutationOptionsWithClient } from "../types/mutations";
+import type { UseMutationOptions } from "../types/mutations";
 export type UseEncodeBlobsOnChunkEvent = {
     /**
      * The index of the blob being encoded.
@@ -18,7 +18,14 @@ export type UseEncodeBlobsOnChunkEvent = {
      */
     chunkData: Uint8Array;
     /**
-     * The progress of the encoding.
+     * The progress of the encoding in percentage.
+     *
+     * @example
+     * ```tsx
+     * onChunk: ({ progress }) => {
+     *   console.log(`Encoding progress: ${progress * 100}%`);
+     * },
+     * ```
      */
     progress: number;
 };
@@ -38,7 +45,7 @@ export type UseEncodeBlobsVariables = {
      */
     onChunk?: (event: UseEncodeBlobsOnChunkEvent) => void;
 };
-export type UseEncodeBlobsOptions = UseMutationOptionsWithClient<BlobCommitments[], Error, UseEncodeBlobsVariables>;
+export type UseEncodeBlobsOptions = UseMutationOptions<BlobCommitments[], Error, UseEncodeBlobsVariables>;
 /**
  * Encodes blobs using erasure coding.
  *
@@ -48,13 +55,9 @@ export type UseEncodeBlobsOptions = UseMutationOptionsWithClient<BlobCommitments
  *
  * @example
  * ```tsx
- * import { ShelbyClient } from "@shelby-protocol/sdk/browser";
- * import { Network } from "@aptos-labs/ts-sdk";
  * import { useEncodeBlobs } from "@shelby-protocol/react";
  *
- * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });
  * const encodeBlobs = useEncodeBlobs({
- *   client: shelbyClient,
  *   onSuccess: (commitments) => console.log('Encoded', commitments.length, 'blobs'),
  * });
  *
@@ -66,7 +69,7 @@ export type UseEncodeBlobsOptions = UseMutationOptionsWithClient<BlobCommitments
  * });
  * ```
  */
-export declare function useEncodeBlobs({ client: shelbyClient, ...options }: UseEncodeBlobsOptions): import("@tanstack/react-query").UseMutationResult<{
+export declare function useEncodeBlobs({ ...options }?: UseEncodeBlobsOptions): import("@tanstack/react-query").UseMutationResult<{
     schema_version: string;
     raw_data_size: number;
     blob_merkle_root: string;

package/dist/mutations/useEncodeBlobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEncodeBlobs.d.ts","sourceRoot":"","sources":["../../src/mutations/useEncodeBlobs.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IACtB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,KAAK,EAAE;QAAE,QAAQ,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAC9D,eAAe,EAAE,EACjB,KAAK,EACL,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,qBAAqB;;;;;;;;yDAsCvB"}
+{"version":3,"file":"useEncodeBlobs.d.ts","sourceRoot":"","sources":["../../src/mutations/useEncodeBlobs.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,qBAAqB,EAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IACtB;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,KAAK,EAAE;QAAE,QAAQ,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CACpD,eAAe,EAAE,EACjB,KAAK,EACL,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,GAAE,qBAA0B;;;;;;;;yDAsCxE"}

package/dist/mutations/useRegisterCommitments.d.ts

@@ -65,5 +65,5 @@ export type UseRegisterCommitmentsOptions = UseMutationOptionsWithClient<{
  * });
  * ```
  */
-export declare function useRegisterCommitments({ client: shelbyClient, ...options }: UseRegisterCommitmentsOptions): import("@tanstack/react-query").UseMutationResult<import("@aptos-labs/wallet-adapter-react").AptosSignAndSubmitTransactionOutput, Error, UseRegisterCommitmentsVariables, readonly unknown[]>;
+export declare function useRegisterCommitments({ client, ...options }: UseRegisterCommitmentsOptions): import("@tanstack/react-query").UseMutationResult<import("@aptos-labs/wallet-adapter-react").AptosSignAndSubmitTransactionOutput, Error, UseRegisterCommitmentsVariables, readonly unknown[]>;
 //# sourceMappingURL=useRegisterCommitments.d.ts.map

package/dist/mutations/useRegisterCommitments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRegisterCommitments.d.ts","sourceRoot":"","sources":["../../src/mutations/useRegisterCommitments.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAIpB,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,MAAM,+BAA+B,GAAG;IAC5C;;;;;;;;;;;;;;OAcG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,CAAA;KAAE,EAAE,CAAC;IACjE;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,CACtE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChB,KAAK,EACL,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,6BAA6B,iMAgD/B"}
+{"version":3,"file":"useRegisterCommitments.d.ts","sourceRoot":"","sources":["../../src/mutations/useRegisterCommitments.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAIpB,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,MAAM,+BAA+B,GAAG;IAC5C;;;;;;;;;;;;;;OAcG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,CAAA;KAAE,EAAE,CAAC;IACjE;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,CACtE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChB,KAAK,EACL,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,GAAG,OAAO,EACX,EAAE,6BAA6B,iMA6D/B"}

package/dist/mutations/useUploadBlobs.d.ts

@@ -75,5 +75,5 @@ export type UseUploadBlobsOptions = UseMutationOptionsWithClient<void, Error, Us
  * });
  * ```
  */
-export declare function useUploadBlobs({ client: shelbyClient, ...options }: UseUploadBlobsOptions): import("@tanstack/react-query").UseMutationResult<void, Error, UseUploadBlobsVariables, readonly unknown[]>;
+export declare function useUploadBlobs({ client, ...options }: UseUploadBlobsOptions): import("@tanstack/react-query").UseMutationResult<void, Error, UseUploadBlobsVariables, readonly unknown[]>;
 //# sourceMappingURL=useUploadBlobs.d.ts.map

package/dist/mutations/useUploadBlobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUploadBlobs.d.ts","sourceRoot":"","sources":["../../src/mutations/useUploadBlobs.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,UAAU,CAAC;KACtB,EAAE,CAAC;IACJ;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAC9D,IAAI,EACJ,KAAK,EACL,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,qBAAqB,+GA+FvB"}
+{"version":3,"file":"useUploadBlobs.d.ts","sourceRoot":"","sources":["../../src/mutations/useUploadBlobs.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,UAAU,CAAC;KACtB,EAAE,CAAC;IACJ;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAC9D,IAAI,EACJ,KAAK,EACL,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,qBAAqB,+GAiH3E"}

package/dist/queries/useAccountBlobs.d.ts

@@ -26,5 +26,5 @@ export type UseAccountBlobsOptions = UseQueryOptionsWithClient<BlobMetadata[]> &
  * });
  * ```
  */
-export declare function useAccountBlobs({ account, pagination, orderBy, where, client: shelbyClient, ...options }: UseAccountBlobsOptions): import("@tanstack/react-query").UseQueryResult<BlobMetadata[], Error>;
+export declare function useAccountBlobs({ account, pagination, orderBy, where, client, ...options }: UseAccountBlobsOptions): import("@tanstack/react-query").UseQueryResult<BlobMetadata[], Error>;
 //# sourceMappingURL=useAccountBlobs.d.ts.map

package/dist/queries/useAccountBlobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAccountBlobs.d.ts","sourceRoot":"","sources":["../../src/queries/useAccountBlobs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,0BAA0B,GACrC,QAAQ,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB,mKASF,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,CAAC,YAAY,EAAE,CAAC,GAC5E,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,UAAU,EACV,OAAO,EACP,KAAK,EACL,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,sBAAsB,yEAkBxB"}
+{"version":3,"file":"useAccountBlobs.d.ts","sourceRoot":"","sources":["../../src/queries/useAccountBlobs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,0BAA0B,GACrC,QAAQ,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB,mKASF,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,CAAC,YAAY,EAAE,CAAC,GAC5E,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,UAAU,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,GAAG,OAAO,EACX,EAAE,sBAAsB,yEAmBxB"}

package/dist/queries/useBlobMetadata.d.ts

@@ -25,5 +25,5 @@ export type UseBlobMetadataOptions = UseQueryOptionsWithClient<BlobMetadata | nu
  * });
  * ```
  */
-export declare function useBlobMetadata({ account, name, client: shelbyClient, ...options }: UseBlobMetadataOptions): import("@tanstack/react-query").UseQueryResult<BlobMetadata | null, Error>;
+export declare function useBlobMetadata({ account, name, client, ...options }: UseBlobMetadataOptions): import("@tanstack/react-query").UseQueryResult<BlobMetadata | null, Error>;
 //# sourceMappingURL=useBlobMetadata.d.ts.map

package/dist/queries/useBlobMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBlobMetadata.d.ts","sourceRoot":"","sources":["../../src/queries/useBlobMetadata.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,0BAA0B,GACrC,QAAQ,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB,aAC2E,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAChC,yBAAyB,CAAC,YAAY,GAAG,IAAI,CAAC,GAC5C,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,IAAI,EACJ,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,sBAAsB,8EAYxB"}
+{"version":3,"file":"useBlobMetadata.d.ts","sourceRoot":"","sources":["../../src/queries/useBlobMetadata.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,0BAA0B,GACrC,QAAQ,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB,aAC2E,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAChC,yBAAyB,CAAC,YAAY,GAAG,IAAI,CAAC,GAC5C,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,IAAI,EACJ,MAAM,EACN,GAAG,OAAO,EACX,EAAE,sBAAsB,8EAaxB"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./signers";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/types/mutations.d.ts

@@ -1,6 +1,7 @@
 import type { ShelbyClient } from "@shelby-protocol/sdk/browser";
-import type { DefaultError, MutationKey, UseMutationOptions } from "@tanstack/react-query";
-export type UseMutationOptionsWithClient<TMutationFnData = unknown, TError = DefaultError, TData = TMutationFnData, TMutationKey extends MutationKey = MutationKey> = Omit<UseMutationOptions<TMutationFnData, TError, TData, TMutationKey>, "mutationFn"> & {
-    client: ShelbyClient;
+import type { DefaultError, MutationKey, UseMutationOptions as UseMutationOptionsTanstack } from "@tanstack/react-query";
+export type UseMutationOptions<TMutationFnData = unknown, TError = DefaultError, TData = TMutationFnData, TMutationKey extends MutationKey = MutationKey> = Omit<UseMutationOptionsTanstack<TMutationFnData, TError, TData, TMutationKey>, "mutationFn">;
+export type UseMutationOptionsWithClient<TMutationFnData = unknown, TError = DefaultError, TData = TMutationFnData, TMutationKey extends MutationKey = MutationKey> = UseMutationOptions<TMutationFnData, TError, TData, TMutationKey> & {
+    client?: ShelbyClient | null;
 };
 //# sourceMappingURL=mutations.d.ts.map

package/dist/types/mutations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/types/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,4BAA4B,CACtC,eAAe,GAAG,OAAO,EACzB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,eAAe,EACvB,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,IAAI,CACN,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EAChE,YAAY,CACb,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/types/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,IAAI,0BAA0B,EACjD,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,kBAAkB,CAC5B,eAAe,GAAG,OAAO,EACzB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,eAAe,EACvB,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,IAAI,CACN,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EACxE,YAAY,CACb,CAAC;AAEF,MAAM,MAAM,4BAA4B,CACtC,eAAe,GAAG,OAAO,EACzB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,eAAe,EACvB,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG;IACrE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B,CAAC"}

package/dist/types/queries.d.ts

@@ -1,6 +1,6 @@
 import type { ShelbyClient } from "@shelby-protocol/sdk/browser";
 import type { DefaultError, QueryKey, UseQueryOptions } from "@tanstack/react-query";
 export type UseQueryOptionsWithClient<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> = Omit<UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>, "queryFn" | "queryKey"> & {
-    client: ShelbyClient;
+    client?: ShelbyClient | null;
 };
 //# sourceMappingURL=queries.d.ts.map

package/dist/types/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/types/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,yBAAyB,CACnC,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,YAAY,EACpB,SAAS,SAAS,QAAQ,GAAG,QAAQ,IACnC,IAAI,CACN,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EACvD,SAAS,GAAG,UAAU,CACvB,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/types/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,yBAAyB,CACnC,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,YAAY,EACpB,SAAS,SAAS,QAAQ,GAAG,QAAQ,IACnC,IAAI,CACN,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EACvD,SAAS,GAAG,UAAU,CACvB,GAAG;IAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC"}

package/dist/types/signers.d.ts

@@ -2,8 +2,28 @@ import type { Account, AccountAddressInput } from "@aptos-labs/ts-sdk";
 import type { SignAndSubmitTransactionFn } from "./walletAdapter";
 export type AccountSigner = Account;
 export type WalletAdapterSigner = {
-    account: AccountAddressInput;
+    account?: AccountAddressInput | {
+        address: AccountAddressInput;
+    } | null;
     signAndSubmitTransaction: SignAndSubmitTransactionFn;
 };
+/**
+ * A signer is a user who can sign transactions on the Shelby network.
+ * It can be an account signer or a wallet adapter signer.
+ *
+ * @example AccountSigner
+ * ```tsx
+ * const signer = new Account.generate();
+ * ```
+ *
+ * @example WalletAdapterSigner
+ * ```tsx
+ * const walletAdapterSigner = useWallet();
+ *
+ * if (!walletAdapterSigner.account) throw new Error("A wallet must be connected to sign transactions");
+ *
+ * const signer = walletAdapterSigner;
+ * ```
+ */
 export type Signer = AccountSigner | WalletAdapterSigner;
 //# sourceMappingURL=signers.d.ts.map

package/dist/types/signers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../../src/types/signers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,wBAAwB,EAAE,0BAA0B,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../../src/types/signers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,mBAAmB,GAAG;QAAE,OAAO,EAAE,mBAAmB,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,wBAAwB,EAAE,0BAA0B,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shelby-protocol/react",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "React library for the Shelby Protocol",
   "private": false,
   "type": "module",
@@ -46,6 +46,7 @@
   "devDependencies": {
     "@aptos-labs/ts-sdk": "^5.1.1",
     "@aptos-labs/wallet-adapter-react": "^6.0.0 || ^7.0.0",
+    "@tanstack/react-query": "^5.90.16",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "19.2.1",
@@ -54,6 +55,8 @@
     "@vitest/coverage-v8": "^3.2.4",
     "dotenv": "^16.5.0",
     "happy-dom": "^20.0.10",
+    "react": "19.2.1",
+    "react-dom": "19.2.1",
     "tsup": "^8.4.0",
     "vitest": "^3.1.2",
     "@shelby-protocol/sdk": "0.0.9"
@@ -75,6 +78,7 @@
     "lint": "biome check .",
     "fmt": "biome check . --write",
     "test": "vitest dev --coverage",
-    "test:once": "vitest run --coverage"
+    "test:once": "echo 'React tests require RPC server - use test:integration instead' && exit 0",
+    "test:integration": "vitest run --coverage"
   }
 }

package/src/components/ShelbyClientProvider.tsx

@@ -0,0 +1,26 @@
+import type { ShelbyClient } from "@shelby-protocol/sdk/browser";
+import { createContext, type PropsWithChildren, useContext } from "react";
+
+export const ShelbyClientContext = createContext<ShelbyClient | null>(null);
+
+export function ShelbyClientProvider({
+  children,
+  client,
+}: PropsWithChildren & { client: ShelbyClient }) {
+  return (
+    <ShelbyClientContext.Provider value={client}>
+      {children}
+    </ShelbyClientContext.Provider>
+  );
+}
+
+export function useShelbyClient(client?: ShelbyClient | null) {
+  const contextClient = useContext(ShelbyClientContext);
+  const resolvedClient = client ?? contextClient;
+  if (!resolvedClient) {
+    throw new Error(
+      "`useShelbyClient` requires a client or `ShelbyClientProvider`",
+    );
+  }
+  return resolvedClient;
+}

package/src/components/index.ts

@@ -0,0 +1 @@
+export * from "./ShelbyClientProvider";

package/src/index.ts

@@ -1,2 +1,4 @@
+export * from "./components/index";
 export * from "./mutations/index";
 export * from "./queries/index";
+export * from "./types/index";

package/src/mutations/index.ts

@@ -1,4 +1,6 @@
 export * from "./useCommitBlobs";
+export * from "./useDeleteBlob";
+export * from "./useDeleteBlobs";
 export * from "./useEncodeBlobs";
 export * from "./useRegisterCommitments";
 export * from "./useUploadBlobs";

package/src/mutations/useCommitBlobs.tsx

@@ -1,6 +1,7 @@
 import type { AccountAddressInput } from "@aptos-labs/ts-sdk";
 import { useMutation } from "@tanstack/react-query";
 import pLimit from "p-limit";
+import { useShelbyClient } from "../components/ShelbyClientProvider";
 import type { UseMutationOptionsWithClient } from "../types/mutations";
 
 export type UseCommitBlobsVariables = {
@@ -55,10 +56,8 @@ export type UseCommitBlobsOptions = UseMutationOptionsWithClient<
  * });
  * ```
  */
-export function useCommitBlobs({
-  client: shelbyClient,
-  ...options
-}: UseCommitBlobsOptions) {
+export function useCommitBlobs({ client, ...options }: UseCommitBlobsOptions) {
+  const shelbyClient = useShelbyClient(client);
   return useMutation({
     mutationFn: async ({
       account,

package/src/mutations/useDeleteBlob.tsx

@@ -0,0 +1,93 @@
+import type { InputGenerateTransactionOptions } from "@aptos-labs/ts-sdk";
+import { ShelbyBlobClient } from "@shelby-protocol/sdk/browser";
+import { useMutation } from "@tanstack/react-query";
+import { useShelbyClient } from "../components/ShelbyClientProvider";
+import type { UseMutationOptionsWithClient } from "../types/mutations";
+import type { AccountSigner, Signer } from "../types/signers";
+
+export type UseDeleteBlobVariables = {
+  /**
+   * The signer to use for the transaction.
+   *
+   * @see {@link Signer}
+   *
+   * @example
+   * ```tsx
+   * const signer = new Account.generate();
+   * deleteBlob.mutate({
+   *   signer,
+   *   blobName: "folder/file.txt",
+   * });
+   * ```
+   */
+  signer: Signer;
+  /**
+   * The name/path of the blob (e.g. "folder/file.txt").
+   */
+  blobName: string;
+  /**
+   * Optional transaction building options.
+   */
+  options?: InputGenerateTransactionOptions;
+};
+
+export type UseDeleteBlobOptions = UseMutationOptionsWithClient<
+  { hash: string },
+  Error,
+  UseDeleteBlobVariables
+>;
+
+/**
+ * Deletes a blob on-chain.
+ *
+ * @deprecated Use {@link useDeleteBlobs} instead, which supports both single
+ * and multiple blob deletion with automatic gas optimization.
+ *
+ * This mutation deletes blob metadata from the Shelby contract. It supports
+ * both account signers and wallet adapter signers.
+ *
+ * @example
+ * ```tsx
+ * import { ShelbyClient } from "@shelby-protocol/sdk/browser";
+ * import { Network } from "@aptos-labs/ts-sdk";
+ * import { useDeleteBlobs } from "@shelby-protocol/react";
+ *
+ * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });
+ * const deleteBlobs = useDeleteBlobs({
+ *   client: shelbyClient,
+ *   onSuccess: ({ hash }) => console.log("Delete tx:", hash),
+ * });
+ *
+ * deleteBlobs.mutate({
+ *   signer,
+ *   blobNames: ["folder/file.txt"],
+ * });
+ * ```
+ */
+export function useDeleteBlob({ client, ...options }: UseDeleteBlobOptions) {
+  const shelbyClient = useShelbyClient(client);
+  return useMutation({
+    mutationFn: async ({ blobName, signer: signerOrFn, options }) => {
+      if (!("signAndSubmitTransaction" in signerOrFn)) {
+        const accountSigner: AccountSigner = signerOrFn;
+
+        const { transaction } = await shelbyClient.coordination.deleteBlob({
+          account: accountSigner,
+          blobName,
+          options,
+        });
+
+        return transaction;
+      }
+
+      const { signAndSubmitTransaction } = signerOrFn;
+      const transaction = await signAndSubmitTransaction({
+        data: ShelbyBlobClient.createDeleteBlobPayload({ blobName }),
+        options,
+      });
+
+      return transaction;
+    },
+    ...options,
+  });
+}

package/src/mutations/useDeleteBlobs.tsx

@@ -0,0 +1,139 @@
+import type { InputGenerateTransactionOptions } from "@aptos-labs/ts-sdk";
+import { ShelbyBlobClient } from "@shelby-protocol/sdk/browser";
+import { useMutation } from "@tanstack/react-query";
+import { useShelbyClient } from "../components/ShelbyClientProvider";
+import type { UseMutationOptionsWithClient } from "../types/mutations";
+import type { AccountSigner, Signer } from "../types/signers";
+
+export type UseDeleteBlobsVariables = {
+  /**
+   * The signer to use for the transaction.
+   *
+   * @see {@link Signer}
+   *
+   * @example
+   * ```tsx
+   * const signer = new Account.generate();
+   * deleteBlobs.mutate({
+   *   signer,
+   *   blobNames: ["folder/file1.txt", "folder/file2.txt"],
+   * });
+   * ```
+   */
+  signer: Signer;
+  /**
+   * The names/paths of the blobs to delete, without the account address prefix
+   * (e.g. ["folder/file1.txt", "folder/file2.txt"], NOT ["0x1/folder/file1.txt"]).
+   * The account address prefix is automatically derived from the signer.
+   */
+  blobNames: string[];
+  /**
+   * Optional transaction building options.
+   */
+  options?: InputGenerateTransactionOptions;
+};
+
+export type UseDeleteBlobsOptions = UseMutationOptionsWithClient<
+  { hash: string },
+  Error,
+  UseDeleteBlobsVariables
+>;
+
+/**
+ * Deletes one or more blobs on-chain.
+ *
+ * This hook automatically optimizes gas costs by using `delete_blob` for single
+ * blob deletion and `delete_multiple_blobs` for multiple blobs.
+ *
+ * **Note:** Deleting multiple blobs (more than one) requires the `delete_multiple_blobs`
+ * entry function which will be deployed to the smart contract on 2026-02-04.
+ * Using this hook with multiple blobs before that date will result in a transaction failure.
+ * Single blob deletion works immediately.
+ *
+ * This mutation deletes blob metadata from the Shelby contract. It supports
+ * both account signers and wallet adapter signers.
+ *
+ * When deleting multiple blobs, the operation is atomic: if any blob deletion
+ * fails (e.g., blob not found), the entire transaction fails and no blobs are deleted.
+ *
+ * @example
+ * ```tsx
+ * import { ShelbyClient } from "@shelby-protocol/sdk/browser";
+ * import { Network } from "@aptos-labs/ts-sdk";
+ * import { useDeleteBlobs } from "@shelby-protocol/react";
+ *
+ * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });
+ * const deleteBlobs = useDeleteBlobs({
+ *   client: shelbyClient,
+ *   onSuccess: ({ hash }) => console.log("Delete tx:", hash),
+ * });
+ *
+ * // Delete a single blob
+ * deleteBlobs.mutate({
+ *   signer,
+ *   blobNames: ["folder/file.txt"],
+ * });
+ *
+ * // Delete multiple blobs in one transaction
+ * deleteBlobs.mutate({
+ *   signer,
+ *   blobNames: ["folder/file1.txt", "folder/file2.txt"],
+ * });
+ * ```
+ */
+export function useDeleteBlobs({ client, ...options }: UseDeleteBlobsOptions) {
+  const shelbyClient = useShelbyClient(client);
+  return useMutation({
+    mutationFn: async ({ blobNames, signer: signerOrFn, options }) => {
+      if (blobNames.length === 0) {
+        throw new Error("blobNames must contain at least one blob name");
+      }
+
+      const isSingleBlob = blobNames.length === 1;
+
+      if (!("signAndSubmitTransaction" in signerOrFn)) {
+        const accountSigner: AccountSigner = signerOrFn;
+
+        // Use single delete for gas optimization
+        if (isSingleBlob) {
+          const { transaction } = await shelbyClient.coordination.deleteBlob({
+            account: accountSigner,
+            blobName: blobNames[0],
+            options,
+          });
+          return transaction;
+        }
+
+        // Use batch delete for multiple blobs
+        const { transaction } =
+          await shelbyClient.coordination.deleteMultipleBlobs({
+            account: accountSigner,
+            blobNames,
+            options,
+          });
+        return transaction;
+      }
+
+      const { signAndSubmitTransaction } = signerOrFn;
+
+      if (isSingleBlob) {
+        // Use single delete for gas optimization
+        const transaction = await signAndSubmitTransaction({
+          data: ShelbyBlobClient.createDeleteBlobPayload({
+            blobName: blobNames[0],
+          }),
+          options,
+        });
+        return transaction;
+      }
+
+      // Use batch delete for multiple blobs
+      const transaction = await signAndSubmitTransaction({
+        data: ShelbyBlobClient.createDeleteMultipleBlobsPayload({ blobNames }),
+        options,
+      });
+      return transaction;
+    },
+    ...options,
+  });
+}