@shelby-protocol/react 0.0.3 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/index.cjs.map +1 -1
  3. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # @shelby-protocol/react
2
2
 
3
+ ## 0.0.4
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [8202274]
8
+ - Updated dependencies [313eb10]
9
+ - @shelby-protocol/sdk@0.0.9
10
+
3
11
  ## 0.0.3
4
12
 
5
13
  ### Patch Changes
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/mutations/useCommitBlobs.tsx","../src/mutations/useEncodeBlobs.tsx","../src/mutations/useRegisterCommitments.tsx","../src/mutations/useUploadBlobs.tsx","../src/queries/useAccountBlobs.tsx","../src/queries/useBlobMetadata.tsx"],"names":["useCommitBlobs","shelbyClient","options","useMutation","account","blobs","maxConcurrentUploads","limit","pLimit","uploadPromises","blob","useEncodeBlobs","provider","onChunk","activeProvider","createDefaultErasureCodingProvider","results","blobData","blobIndex","chunksetCount","blobCommitments","generateCommitments","chunksetIndex","chunkIndex","chunkData","useRegisterCommitments","commitments","expirationMicros","signerOrFn","accountSigner","transaction","commitment","signAndSubmitTransaction","ShelbyBlobClient","AccountAddress","expectedTotalChunksets","DEFAULT_CHUNKSET_SIZE_BYTES","useUploadBlobs","chunksetSize","existingBlobs","createBlobKey","blobsToRegister","existingBlob","pendingRegisterBlobTransaction","index","blobName","getUseAccountBlobsQueryKey","params","useAccountBlobs","pagination","orderBy","where","useQuery","getUseBlobMetadataQueryKey","useBlobMetadata","name"],"mappings":"AACA,y7BAA4B,iFACT,SAuDHA,CAAAA,CAAe,CAC7B,MAAA,CAAQC,CAAAA,CACR,GAAGC,CACL,CAAA,CAA0B,CACxB,OAAOC,qCAAAA,CACL,UAAA,CAAY,KAAA,CAAO,CACjB,OAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,oBAAA,CAAAC,CAAAA,CAAuB,CACzB,CAAA,CAAA,EAA+B,CAC7B,IAAMC,CAAAA,CAAQC,8BAAAA,CAA2B,CAAA,CACnCC,CAAAA,CAAiBJ,CAAAA,CAAM,GAAA,CAAKK,CAAAA,EAChCH,CAAAA,CAAM,CAAA,CAAA,EACJN,CAAAA,CAAa,GAAA,CAAI,OAAA,CAAQ,CACvB,OAAA,CAAAG,CAAAA,CACA,QAAA,CAAUM,CAAAA,CAAK,QAAA,CACf,QAAA,CAAUA,CAAAA,CAAK,QACjB,CAAC,CACH,CACF,CAAA,CAEA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAc,CAClC,CAAA,CACA,GAAGP,CACL,CAAC,CACH,CClFA,uDAKO,SA2ESS,CAAAA,CAAe,CAC7B,MAAA,CAAQV,CAAAA,CACR,GAAGC,CACL,CAAA,CAA0B,CACxB,OAAOC,qCAAAA,CACL,UAAA,CAAY,KAAA,CAAO,CAAE,KAAA,CAAAE,CAAAA,CAAO,QAAA,CAAAO,CAAAA,CAAU,OAAA,CAAAC,CAAQ,CAAA,CAAA,EAAM,CAClD,IAAMC,CAAAA,6BACJF,CAAAA,eAAa,MAAMG,yDAAAA,GAAmC,CAElDC,CAAAA,CAA6B,IAAI,KAAA,CAAMX,CAAAA,CAAM,MAAM,CAAA,CACzD,OAAA,MAAM,OAAA,CAAQ,GAAA,CACZA,CAAAA,CAAM,GAAA,CAAI,KAAA,CAAO,CAAE,QAAA,CAAAY,CAAS,CAAA,CAAGC,CAAAA,CAAAA,EAAc,CAC3C,IAAMC,CAAAA,CAAgB,IAAA,CAAK,IAAA,CACzBF,CAAAA,CAAS,MAAA,CAASH,CAAAA,CAAe,MAAA,CAAO,cAC1C,CAAA,CAEMM,CAAAA,CAAkB,MAAMC,0CAAAA,CAC5BP,CACAG,CAAAA,CACA,CACEK,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CAAAA,kBAEAX,CAAAA,0BAAAA,CAAU,CACR,SAAA,CAAAK,CAAAA,CACA,aAAA,CAAAI,CAAAA,CACA,UAAA,CAAAC,CAAAA,CACA,SAAA,CAAAC,CAAAA,CACA,QAAA,CAAUF,CAAAA,CAAgBH,CAC5B,CAAC,GACL,CAAA,CAEAH,CAAAA,CAAQE,CAAS,CAAA,CAAIE,CACvB,CAAC,CACH,CAAA,CAEOJ,CACT,CAAA,CACA,GAAGd,CACL,CAAC,CACH,CCzHA,2CAA+B,SA6EfuB,CAAAA,CAAuB,CACrC,MAAA,CAAQxB,CAAAA,CACR,GAAGC,CACL,CAAA,CAAkC,CAChC,OAAOC,qCAAAA,CACL,UAAA,CAAY,KAAA,CAAO,CACjB,WAAA,CAAAuB,CAAAA,CACA,gBAAA,CAAAC,CAAAA,CACA,OAAA,CAAAzB,CAAAA,CACA,MAAA,CAAQ0B,CACV,CAAA,CAAA,EAAM,CACJ,EAAA,CAAI,CAAA,CAAE,SAAA,GAAaA,CAAAA,CAAAA,CAAa,CAC9B,IAAMC,CAAAA,CAA+BD,CAAAA,CAE/B,CAAE,WAAA,CAAAE,CAAY,CAAA,CAClB,MAAM7B,CAAAA,CAAa,YAAA,CAAa,kBAAA,CAAmB,CACjD,OAAA,CAAS4B,CAAAA,CACT,gBAAA,CAAAF,CAAAA,CACA,OAAA,CAAAzB,CAAAA,CACA,KAAA,CAAOwB,CAAAA,CAAY,GAAA,CAAKK,CAAAA,EAAAA,CAAgB,CACtC,QAAA,CAAUA,CAAAA,CAAW,QAAA,CACrB,QAAA,CAAUA,CAAAA,CAAW,UAAA,CAAW,aAAA,CAChC,cAAA,CAAgBA,CAAAA,CAAW,UAAA,CAAW,gBACxC,CAAA,CAAE,CACJ,CAAC,CAAA,CAEH,OAAOD,CACT,CAEA,GAAM,CAAE,OAAA,CAAA1B,CAAAA,CAAS,wBAAA,CAAA4B,CAAyB,CAAA,CAAIJ,CAAAA,CAkB9C,OAjBoB,MAAMI,CAAAA,CAAyB,CACjD,IAAA,CAAMC,yBAAAA,CAAiB,+BAAA,CAAgC,CACrD,OAAA,CAASC,qBAAAA,CAAe,IAAA,CAAK9B,CAAO,CAAA,CACpC,gBAAA,CAAAuB,CAAAA,CACA,KAAA,CAAOD,CAAAA,CAAY,GAAA,CAAKK,CAAAA,EAAAA,CAAgB,CACtC,QAAA,CAAUA,CAAAA,CAAW,QAAA,CACrB,QAAA,CAAUA,CAAAA,CAAW,UAAA,CAAW,aAAA,CAChC,cAAA,CAAgBA,CAAAA,CAAW,UAAA,CAAW,gBAAA,CACtC,YAAA,CAAcI,6CAAAA,CACZJ,CAAW,UAAA,CAAW,aAAA,kCACtB7B,CAAAA,6BAAS,mBAAA,SAAqBkC,sCAChC,CACF,CAAA,CAAE,CACJ,CAAC,CAAA,CACD,OAAA,iBAASlC,CAAAA,6BAAS,KAAA,6BAAO,SAC3B,CAAC,CAGH,CAAA,CACA,GAAGA,CACL,CAAC,CACH,CChIA,SA+FgBmC,EAAAA,CAAe,CAC7B,MAAA,CAAQpC,CAAAA,CACR,GAAGC,CACL,CAAA,CAA0B,CACxB,OAAOC,qCAAAA,CACL,UAAA,CAAY,KAAA,CAAO,CACjB,KAAA,CAAAE,CAAAA,CACA,gBAAA,CAAAsB,CAAAA,CACA,OAAA,CAAAzB,CAAAA,CACA,MAAA,CAAQ0B,CAAAA,CACR,oBAAA,CAAAtB,CAAAA,CAAuB,CACzB,CAAA,CAAA,EAA+B,CAC7B,EAAA,CAAM,SAAA,GAAasB,CAAAA,CAYZ,CACL,GAAM,CAAE,OAAA,CAAAxB,CAAAA,CAAS,wBAAA,CAAA4B,CAAyB,CAAA,CAAIJ,CAAAA,CAExCU,CAAAA,kCACJpC,CAAAA,6BAAS,mBAAA,SAAqBkC,sCAAAA,CAE1BG,CAAAA,CAAgB,MAAMtC,CAAAA,CAAa,YAAA,CAAa,QAAA,CAAS,CAC7D,KAAA,CAAO,CACL,SAAA,CAAW,CACT,GAAA,CAAKI,CAAAA,CAAM,GAAA,CAAKK,CAAAA,EACd8B,oCAAAA,CAAgB,OAAA,CAAApC,CAAAA,CAAS,QAAA,CAAUM,CAAAA,CAAK,QAAS,CAAC,CACpD,CACF,CACF,CACF,CAAC,CAAA,CAEK+B,CAAAA,CAAkBpC,CAAAA,CAAM,MAAA,CAC3BK,CAAAA,EACC,CAAC6B,CAAAA,CAAc,IAAA,CACZG,CAAAA,EACCA,CAAAA,CAAa,IAAA,GACbF,oCAAAA,CAAgB,OAAA,CAAApC,CAAAA,CAAS,QAAA,CAAUM,CAAAA,CAAK,QAAS,CAAC,CACtD,CACJ,CAAA,CAEA,EAAA,CAAI+B,CAAAA,CAAgB,MAAA,CAAS,CAAA,CAAG,CAC9B,IAAM7B,CAAAA,CAAW,MAAMG,yDAAAA,CAAmC,CAEpDK,CAAAA,CAAkB,MAAM,OAAA,CAAQ,GAAA,CACpCqB,CAAAA,CAAgB,GAAA,CAAI,MAAO/B,CAAAA,EACzBW,0CAAAA,CAAoBT,CAAUF,CAAAA,CAAK,QAAQ,CAC7C,CACF,CAAA,CAEMiC,CAAAA,CAAiC,MAAMX,CAAAA,CAC3C,CACE,IAAA,CAAMC,yBAAAA,CAAiB,+BAAA,CAAgC,CACrD,OAAA,CAASC,qBAAAA,CAAe,IAAA,CAAK9B,CAAO,CAAA,CACpC,gBAAA,CAAAuB,CAAAA,CACA,KAAA,CAAOc,CAAAA,CAAgB,GAAA,CAAI,CAAC/B,CAAAA,CAAMkC,CAAAA,CAAAA,EAAAA,CAAW,CAC3C,QAAA,CAAUlC,CAAAA,CAAK,QAAA,CACf,QAAA,CAAUA,CAAAA,CAAK,QAAA,CAAS,MAAA,CACxB,cAAA,CAAgBU,CAAAA,CAAgBwB,CAAK,CAAA,CAAE,gBAAA,CACvC,YAAA,CAAcT,6CAAAA,CACZzB,CAAK,QAAA,CAAS,MAAA,CACd4B,CACF,CACF,CAAA,CAAE,CACJ,CAAC,CAAA,CACD,OAAA,iBAASpC,CAAAA,6BAAS,KAAA,6BAAO,SAC3B,CACF,CAAA,CAEA,MAAMD,CAAAA,CAAa,YAAA,CAAa,KAAA,CAAM,kBAAA,CAAmB,CACvD,eAAA,CAAiB0C,CAAAA,CAA+B,IAClD,CAAC,CACH,CAEA,IAAMpC,CAAAA,CAAQC,8BAAAA,CAA2B,CAAA,CACnCC,CAAAA,CAAiBJ,CAAAA,CAAM,GAAA,CAAKK,CAAAA,EAChCH,CAAAA,CAAM,CAAA,CAAA,EACJN,CAAAA,CAAa,GAAA,CAAI,OAAA,CAAQ,CACvB,OAAA,CAAAG,CAAAA,CACA,QAAA,CAAUM,CAAAA,CAAK,QAAA,CACf,QAAA,CAAUA,CAAAA,CAAK,QACjB,CAAC,CACH,CACF,CAAA,CAEA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAc,CAClC,CAAA,IAlFgC,CAC9B,IAAMoB,CAAAA,CAA+BD,CAAAA,CAErC,MAAM3B,CAAAA,CAAa,WAAA,CAAY,CAC7B,KAAA,CAAOI,CAAAA,CAAM,GAAA,CAAI,CAAC,CAAE,QAAA,CAAAY,CAAAA,CAAU,QAAA,CAAA4B,CAAS,CAAA,CAAA,EAAA,CAAO,CAC5C,QAAA,CAAA5B,CAAAA,CACA,QAAA,CAAA4B,CACF,CAAA,CAAE,CAAA,CACF,gBAAA,CAAAlB,CAAAA,CACA,MAAA,CAAQE,CAAAA,CACR,OAAA,CAAA3B,CACF,CAAC,CACH,CAuEF,CAAA,CACA,GAAGA,CACL,CAAC,CACH,CC5LA,IAGa4C,CAAAA,CACXC,CAAAA,EAGG,CACH,eAAA,CACAA,CAAAA,CAAO,OAAA,CACPA,CAAAA,CAAO,OAAA,CAAQ,QAAA,CAAS,CAAA,iBACxBA,CAAAA,qBAAO,UAAA,+BAAY,OAAA,iBACnBA,CAAAA,uBAAO,UAAA,+BAAY,QAAA,CACnBA,CAAAA,CAAO,OAAA,CACPA,CAAAA,CAAO,KACT,CAAA,CA0BO,SAASC,EAAAA,CAAgB,CAC9B,OAAA,CAAA5C,CAAAA,CACA,UAAA,CAAA6C,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,MAAA,CAAQlD,CAAAA,CACR,GAAGC,CACL,CAAA,CAA2B,CACzB,OAAOkD,kCAAAA,CACL,QAAA,CAAUN,CAAAA,CAA2B,CACnC,OAAA,CAAS7C,CAAAA,CAAa,MAAA,CAAO,OAAA,CAC7B,OAAA,CAAAG,CAAAA,CACA,UAAA,CAAA6C,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CACF,CAAC,CAAA,CACD,OAAA,CAAS,KAAA,CAAA,CAAA,EACP,MAAMlD,CAAAA,CAAa,YAAA,CAAa,eAAA,CAAgB,CAC9C,OAAA,CAAAG,CAAAA,CACA,UAAA,CAAA6C,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CACF,CAAC,CAAA,CACH,GAAGjD,CACL,CAAC,CACH,CClEA,IAGamD,CAAAA,CACXN,CAAAA,EAGG,CAAC,eAAA,CAAiBA,CAAAA,CAAO,OAAA,CAASA,CAAAA,CAAO,OAAA,CAAQ,QAAA,CAAS,CAAA,CAAGA,CAAAA,CAAO,IAAI,CAAA,CA0BtE,SAASO,EAAAA,CAAgB,CAC9B,OAAA,CAAAlD,CAAAA,CACA,IAAA,CAAAmD,CAAAA,CACA,MAAA,CAAQtD,CAAAA,CACR,GAAGC,CACL,CAAA,CAA2B,CACzB,OAAOkD,kCAAAA,CACL,QAAA,CAAUC,CAAAA,CAA2B,CACnC,OAAA,CAASpD,CAAAA,CAAa,MAAA,CAAO,OAAA,CAC7B,OAAA,CAAAG,CAAAA,CACA,IAAA,CAAAmD,CACF,CAAC,CAAA,CACD,OAAA,CAAS,KAAA,CAAA,CAAA,8BACN,MAAMtD,CAAAA,CAAa,YAAA,CAAa,eAAA,CAAgB,CAAE,OAAA,CAAAG,CAAAA,CAAS,IAAA,CAAAmD,CAAK,CAAC,CAAA,eAClE,MAAA,CACF,GAAGrD,CACL,CAAC,CACH,CAAA,oQAAA","file":"/data/svc_shelby/actions-runner/shelby/shelby/_work/shelby/shelby/typescript/packages/react/dist/index.cjs","sourcesContent":["import type { AccountAddressInput } from \"@aptos-labs/ts-sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport pLimit from \"p-limit\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\n\nexport type UseCommitBlobsVariables = {\n /**\n * The account to commit the blobs to.\n */\n account: AccountAddressInput;\n /**\n * The blobs to commit.\n */\n blobs: {\n blobName: string;\n blobData: Uint8Array;\n }[];\n /**\n * The maximum number of concurrent uploads.\n * @default 3\n */\n maxConcurrentUploads?: number;\n};\n\nexport type UseCommitBlobsOptions = UseMutationOptionsWithClient<\n void,\n Error,\n UseCommitBlobsVariables\n>;\n\n/**\n * Uploads blobs data to the Shelby RPCs.\n *\n * This mutation uploads multiple blobs data to the RPC endpoint with configurable\n * concurrency control.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useCommitBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const commitBlobs = useCommitBlobs({\n * client: shelbyClient,\n * onSuccess: () => console.log('Blobs committed successfully'),\n * });\n *\n * commitBlobs.mutate({\n * account: '0x123...',\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * { blobName: 'file2.txt', blobData: new Uint8Array([...]) },\n * ],\n * });\n * ```\n */\nexport function useCommitBlobs({\n client: shelbyClient,\n ...options\n}: UseCommitBlobsOptions) {\n return useMutation({\n mutationFn: async ({\n account,\n blobs,\n maxConcurrentUploads = 3,\n }: UseCommitBlobsVariables) => {\n const limit = pLimit(maxConcurrentUploads);\n const uploadPromises = blobs.map((blob) =>\n limit(() =>\n shelbyClient.rpc.putBlob({\n account,\n blobName: blob.blobName,\n blobData: blob.blobData,\n }),\n ),\n );\n\n await Promise.all(uploadPromises);\n },\n ...options,\n });\n}\n","import {\n type BlobCommitments,\n createDefaultErasureCodingProvider,\n type ErasureCodingProvider,\n generateCommitments,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\n\nexport type UseEncodeBlobsOnChunkEvent = {\n /**\n * The index of the blob being encoded.\n */\n blobIndex: number;\n /**\n * The index of the chunkset being encoded.\n */\n chunksetIndex: number;\n /**\n * The index of the chunk being encoded.\n */\n chunkIndex: number;\n /**\n * The data of the chunk being encoded.\n */\n chunkData: Uint8Array;\n /**\n * The progress of the encoding.\n */\n progress: number;\n};\n\nexport type UseEncodeBlobsVariables = {\n /**\n * The blobs to encode.\n */\n blobs: { blobData: Uint8Array }[];\n /**\n * The erasure coding provider to use.\n */\n provider?: ErasureCodingProvider;\n /**\n * The callback to call when a chunk is encoded.\n */\n onChunk?: (event: UseEncodeBlobsOnChunkEvent) => void;\n};\n\nexport type UseEncodeBlobsOptions = UseMutationOptionsWithClient<\n BlobCommitments[],\n Error,\n UseEncodeBlobsVariables\n>;\n\n/**\n * Encodes blobs using erasure coding.\n *\n * This mutation generates blob commitments (merkle roots and erasure coding chunks)\n * from raw blob data. It supports custom erasure coding providers and progress callbacks\n * for tracking encoding progress.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useEncodeBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const encodeBlobs = useEncodeBlobs({\n * client: shelbyClient,\n * onSuccess: (commitments) => console.log('Encoded', commitments.length, 'blobs'),\n * });\n *\n * encodeBlobs.mutate({\n * blobs: [{ blobData: new Uint8Array([...]) }],\n * onChunk: ({ blobIndex, progress }) => {\n * console.log(`Blob ${blobIndex}: ${(progress * 100).toFixed(1)}%`);\n * },\n * });\n * ```\n */\nexport function useEncodeBlobs({\n client: shelbyClient,\n ...options\n}: UseEncodeBlobsOptions) {\n return useMutation({\n mutationFn: async ({ blobs, provider, onChunk }) => {\n const activeProvider =\n provider ?? (await createDefaultErasureCodingProvider());\n\n const results: BlobCommitments[] = new Array(blobs.length);\n await Promise.all(\n blobs.map(async ({ blobData }, blobIndex) => {\n const chunksetCount = Math.ceil(\n blobData.length / activeProvider.config.chunkSizeBytes,\n );\n\n const blobCommitments = await generateCommitments(\n activeProvider,\n blobData,\n (\n chunksetIndex: number,\n chunkIndex: number,\n chunkData: Uint8Array,\n ) =>\n onChunk?.({\n blobIndex,\n chunksetIndex,\n chunkIndex,\n chunkData,\n progress: chunksetIndex / chunksetCount,\n }),\n );\n\n results[blobIndex] = blobCommitments;\n }),\n );\n\n return results;\n },\n ...options,\n });\n}\n","import { AccountAddress } from \"@aptos-labs/ts-sdk\";\nimport {\n type BlobCommitments,\n DEFAULT_CHUNKSET_SIZE_BYTES,\n expectedTotalChunksets,\n ShelbyBlobClient,\n type UploadOptions,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\nimport type { AccountSigner, Signer } from \"../types/signers\";\n\nexport type UseRegisterCommitmentsVariables = {\n /**\n * The signer to use for the transaction.\n * @see {@link Signer}\n *\n * @example\n * ```tsx\n * const signer = new Account.generate();\n * registerCommitments.mutate({\n * signer,\n * commitments: [\n * { blobName: 'file1.txt', commitment: blobCommitments[0] },\n * ],\n * });\n * ```\n */\n signer: Signer;\n /**\n * The commitments to register.\n */\n commitments: { blobName: string; commitment: BlobCommitments }[];\n /**\n * The expiration time of the commitments in microseconds.\n */\n expirationMicros: number;\n /**\n * Optional transaction building options.\n */\n options?: UploadOptions;\n};\n\nexport type UseRegisterCommitmentsOptions = UseMutationOptionsWithClient<\n { hash: string },\n Error,\n UseRegisterCommitmentsVariables\n>;\n\n/**\n * Registers blob commitments on-chain.\n *\n * This mutation registers blob commitments (merkle roots) on the Aptos blockchain\n * as part of the blob upload process. It supports both account signers and wallet adapter\n * signers, and handles batch registration of multiple blobs.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useRegisterCommitments } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const registerCommitments = useRegisterCommitments({\n * client: shelbyClient,\n * onSuccess: ({ hash }) => console.log('Transaction hash:', hash),\n * });\n *\n * registerCommitments.mutate({\n * signer: accountSigner,\n * commitments: [\n * { blobName: 'file1.txt', commitment: blobCommitments[0] },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000, // 1 day\n * });\n * ```\n */\nexport function useRegisterCommitments({\n client: shelbyClient,\n ...options\n}: UseRegisterCommitmentsOptions) {\n return useMutation({\n mutationFn: async ({\n commitments,\n expirationMicros,\n options,\n signer: signerOrFn,\n }) => {\n if (!(\"account\" in signerOrFn)) {\n const accountSigner: AccountSigner = signerOrFn;\n\n const { transaction } =\n await shelbyClient.coordination.batchRegisterBlobs({\n account: accountSigner,\n expirationMicros,\n options,\n blobs: commitments.map((commitment) => ({\n blobName: commitment.blobName,\n blobSize: commitment.commitment.raw_data_size,\n blobMerkleRoot: commitment.commitment.blob_merkle_root,\n })),\n });\n\n return transaction;\n }\n\n const { account, signAndSubmitTransaction } = signerOrFn;\n const transaction = await signAndSubmitTransaction({\n data: ShelbyBlobClient.createBatchRegisterBlobsPayload({\n account: AccountAddress.from(account),\n expirationMicros,\n blobs: commitments.map((commitment) => ({\n blobName: commitment.blobName,\n blobSize: commitment.commitment.raw_data_size,\n blobMerkleRoot: commitment.commitment.blob_merkle_root,\n numChunksets: expectedTotalChunksets(\n commitment.commitment.raw_data_size,\n options?.chunksetSizeBytes ?? DEFAULT_CHUNKSET_SIZE_BYTES,\n ),\n })),\n }),\n options: options?.build?.options,\n });\n\n return transaction;\n },\n ...options,\n });\n}\n","import { AccountAddress } from \"@aptos-labs/ts-sdk\";\nimport {\n createBlobKey,\n createDefaultErasureCodingProvider,\n DEFAULT_CHUNKSET_SIZE_BYTES,\n expectedTotalChunksets,\n generateCommitments,\n ShelbyBlobClient,\n type UploadOptions,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport pLimit from \"p-limit\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\nimport type { AccountSigner, Signer } from \"../types/signers\";\n\nexport type UseUploadBlobsVariables = {\n /**\n * The signer to use for the transaction.\n *\n * @see {@link Signer}\n *\n * @example\n * ```tsx\n * const signer = new Account.generate();\n * uploadBlobs.mutate({\n * signer,\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000,\n * });\n * ```\n */\n signer: Signer;\n /**\n * The blobs to upload.\n */\n blobs: {\n blobName: string;\n blobData: Uint8Array;\n }[];\n /**\n * The expiration time of the blobs in microseconds.\n */\n expirationMicros: number;\n /**\n * Optional transaction building options.\n */\n options?: UploadOptions;\n /**\n * The maximum number of concurrent uploads.\n * @default 3\n */\n maxConcurrentUploads?: number;\n};\n\nexport type UseUploadBlobsOptions = UseMutationOptionsWithClient<\n void,\n Error,\n UseUploadBlobsVariables\n>;\n\n/**\n * Uploads blobs to the Shelby network.\n *\n * This mutation handles the complete blob upload process including:\n * - Encoding blobs with erasure coding\n * - Registering commitments on-chain (if not already registered)\n * - Uploading blob data to the RPC endpoint\n *\n * It supports both account signers and wallet adapter signers, and includes\n * logic to skip registration for blobs that already exist.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useUploadBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const uploadBlobs = useUploadBlobs({\n * client: shelbyClient,\n * onSuccess: () => console.log('Upload complete'),\n * });\n *\n * const signer = new Account.generate();\n * uploadBlobs.mutate({\n * signer,\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000,\n * });\n * ```\n */\nexport function useUploadBlobs({\n client: shelbyClient,\n ...options\n}: UseUploadBlobsOptions) {\n return useMutation({\n mutationFn: async ({\n blobs,\n expirationMicros,\n options,\n signer: signerOrFn,\n maxConcurrentUploads = 3,\n }: UseUploadBlobsVariables) => {\n if (!(\"account\" in signerOrFn)) {\n const accountSigner: AccountSigner = signerOrFn;\n\n await shelbyClient.batchUpload({\n blobs: blobs.map(({ blobData, blobName }) => ({\n blobData,\n blobName,\n })),\n expirationMicros,\n signer: accountSigner,\n options,\n });\n } else {\n const { account, signAndSubmitTransaction } = signerOrFn;\n\n const chunksetSize =\n options?.chunksetSizeBytes ?? DEFAULT_CHUNKSET_SIZE_BYTES;\n\n const existingBlobs = await shelbyClient.coordination.getBlobs({\n where: {\n blob_name: {\n _in: blobs.map((blob) =>\n createBlobKey({ account, blobName: blob.blobName }),\n ),\n },\n },\n });\n\n const blobsToRegister = blobs.filter(\n (blob) =>\n !existingBlobs.some(\n (existingBlob) =>\n existingBlob.name ===\n createBlobKey({ account, blobName: blob.blobName }),\n ),\n );\n\n if (blobsToRegister.length > 0) {\n const provider = await createDefaultErasureCodingProvider();\n\n const blobCommitments = await Promise.all(\n blobsToRegister.map(async (blob) =>\n generateCommitments(provider, blob.blobData),\n ),\n );\n\n const pendingRegisterBlobTransaction = await signAndSubmitTransaction(\n {\n data: ShelbyBlobClient.createBatchRegisterBlobsPayload({\n account: AccountAddress.from(account),\n expirationMicros,\n blobs: blobsToRegister.map((blob, index) => ({\n blobName: blob.blobName,\n blobSize: blob.blobData.length,\n blobMerkleRoot: blobCommitments[index].blob_merkle_root,\n numChunksets: expectedTotalChunksets(\n blob.blobData.length,\n chunksetSize,\n ),\n })),\n }),\n options: options?.build?.options,\n },\n );\n\n await shelbyClient.coordination.aptos.waitForTransaction({\n transactionHash: pendingRegisterBlobTransaction.hash,\n });\n }\n\n const limit = pLimit(maxConcurrentUploads);\n const uploadPromises = blobs.map((blob) =>\n limit(() =>\n shelbyClient.rpc.putBlob({\n account,\n blobName: blob.blobName,\n blobData: blob.blobData,\n }),\n ),\n );\n\n await Promise.all(uploadPromises);\n }\n },\n ...options,\n });\n}\n","import type { Network } from \"@aptos-labs/ts-sdk\";\nimport type {\n BlobMetadata,\n ShelbyBlobClient,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { UseQueryOptionsWithClient } from \"../types/queries\";\n\nexport const getUseAccountBlobsQueryKey = (\n params: Parameters<ShelbyBlobClient[\"getAccountBlobs\"]>[0] & {\n network: Network;\n },\n) => [\n \"account-blobs\",\n params.network,\n params.account.toString(),\n params.pagination?.limit,\n params.pagination?.offset,\n params.orderBy,\n params.where,\n];\n\nexport type UseAccountBlobsOptions = UseQueryOptionsWithClient<BlobMetadata[]> &\n Parameters<ShelbyBlobClient[\"getAccountBlobs\"]>[0];\n\n/**\n * Queries blobs associated with an account.\n *\n * This query fetches blob metadata for a specific account with support for\n * pagination, filtering, and ordering.\n *\n * @example\n * ```tsx\n * import { ShelbyClient, Order_By} from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useAccountBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const { data: blobs, isLoading } = useAccountBlobs({\n * client: shelbyClient,\n * account: '0x123...',\n * pagination: { limit: 10, offset: 0 },\n * orderBy: { updated_at: Order_By.Desc },\n * });\n * ```\n */\nexport function useAccountBlobs({\n account,\n pagination,\n orderBy,\n where,\n client: shelbyClient,\n ...options\n}: UseAccountBlobsOptions) {\n return useQuery<BlobMetadata[]>({\n queryKey: getUseAccountBlobsQueryKey({\n network: shelbyClient.config.network,\n account,\n pagination,\n orderBy,\n where,\n }),\n queryFn: async () =>\n await shelbyClient.coordination.getAccountBlobs({\n account,\n pagination,\n orderBy,\n where,\n }),\n ...options,\n });\n}\n","import type { Network } from \"@aptos-labs/ts-sdk\";\nimport type {\n BlobMetadata,\n ShelbyBlobClient,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { UseQueryOptionsWithClient } from \"../types/queries\";\n\nexport const getUseBlobMetadataQueryKey = (\n params: Parameters<ShelbyBlobClient[\"getBlobMetadata\"]>[0] & {\n network: Network;\n },\n) => [\"blob-metadata\", params.network, params.account.toString(), params.name];\n\nexport type UseBlobMetadataOptions =\n UseQueryOptionsWithClient<BlobMetadata | null> &\n Parameters<ShelbyBlobClient[\"getBlobMetadata\"]>[0];\n\n/**\n * Queries the metadata for a specific blob.\n *\n * This query fetches the metadata for a single blob identified by account and blob name.\n * Returns `null` if the blob is not found.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useBlobMetadata } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const { data: metadata } = useBlobMetadata({\n * client: shelbyClient,\n * account: '0x123...',\n * name: 'file1.txt',\n * });\n * ```\n */\nexport function useBlobMetadata({\n account,\n name,\n client: shelbyClient,\n ...options\n}: UseBlobMetadataOptions) {\n return useQuery<BlobMetadata | null>({\n queryKey: getUseBlobMetadataQueryKey({\n network: shelbyClient.config.network,\n account,\n name,\n }),\n queryFn: async () =>\n (await shelbyClient.coordination.getBlobMetadata({ account, name })) ??\n null,\n ...options,\n });\n}\n"]}
1
+ {"version":3,"sources":["../src/mutations/useCommitBlobs.tsx","../src/mutations/useEncodeBlobs.tsx","../src/mutations/useRegisterCommitments.tsx","../src/mutations/useUploadBlobs.tsx","../src/queries/useAccountBlobs.tsx","../src/queries/useBlobMetadata.tsx"],"names":["useCommitBlobs","shelbyClient","options","useMutation","account","blobs","maxConcurrentUploads","limit","pLimit","uploadPromises","blob","useEncodeBlobs","provider","onChunk","activeProvider","createDefaultErasureCodingProvider","results","blobData","blobIndex","chunksetCount","blobCommitments","generateCommitments","chunksetIndex","chunkIndex","chunkData","useRegisterCommitments","commitments","expirationMicros","signerOrFn","accountSigner","transaction","commitment","signAndSubmitTransaction","ShelbyBlobClient","AccountAddress","expectedTotalChunksets","DEFAULT_CHUNKSET_SIZE_BYTES","useUploadBlobs","chunksetSize","existingBlobs","createBlobKey","blobsToRegister","existingBlob","pendingRegisterBlobTransaction","index","blobName","getUseAccountBlobsQueryKey","params","useAccountBlobs","pagination","orderBy","where","useQuery","getUseBlobMetadataQueryKey","useBlobMetadata","name"],"mappings":"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","file":"/Users/andrewhariri/Desktop/shelby/typescript/packages/react/dist/index.cjs","sourcesContent":["import type { AccountAddressInput } from \"@aptos-labs/ts-sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport pLimit from \"p-limit\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\n\nexport type UseCommitBlobsVariables = {\n /**\n * The account to commit the blobs to.\n */\n account: AccountAddressInput;\n /**\n * The blobs to commit.\n */\n blobs: {\n blobName: string;\n blobData: Uint8Array;\n }[];\n /**\n * The maximum number of concurrent uploads.\n * @default 3\n */\n maxConcurrentUploads?: number;\n};\n\nexport type UseCommitBlobsOptions = UseMutationOptionsWithClient<\n void,\n Error,\n UseCommitBlobsVariables\n>;\n\n/**\n * Uploads blobs data to the Shelby RPCs.\n *\n * This mutation uploads multiple blobs data to the RPC endpoint with configurable\n * concurrency control.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useCommitBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const commitBlobs = useCommitBlobs({\n * client: shelbyClient,\n * onSuccess: () => console.log('Blobs committed successfully'),\n * });\n *\n * commitBlobs.mutate({\n * account: '0x123...',\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * { blobName: 'file2.txt', blobData: new Uint8Array([...]) },\n * ],\n * });\n * ```\n */\nexport function useCommitBlobs({\n client: shelbyClient,\n ...options\n}: UseCommitBlobsOptions) {\n return useMutation({\n mutationFn: async ({\n account,\n blobs,\n maxConcurrentUploads = 3,\n }: UseCommitBlobsVariables) => {\n const limit = pLimit(maxConcurrentUploads);\n const uploadPromises = blobs.map((blob) =>\n limit(() =>\n shelbyClient.rpc.putBlob({\n account,\n blobName: blob.blobName,\n blobData: blob.blobData,\n }),\n ),\n );\n\n await Promise.all(uploadPromises);\n },\n ...options,\n });\n}\n","import {\n type BlobCommitments,\n createDefaultErasureCodingProvider,\n type ErasureCodingProvider,\n generateCommitments,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\n\nexport type UseEncodeBlobsOnChunkEvent = {\n /**\n * The index of the blob being encoded.\n */\n blobIndex: number;\n /**\n * The index of the chunkset being encoded.\n */\n chunksetIndex: number;\n /**\n * The index of the chunk being encoded.\n */\n chunkIndex: number;\n /**\n * The data of the chunk being encoded.\n */\n chunkData: Uint8Array;\n /**\n * The progress of the encoding.\n */\n progress: number;\n};\n\nexport type UseEncodeBlobsVariables = {\n /**\n * The blobs to encode.\n */\n blobs: { blobData: Uint8Array }[];\n /**\n * The erasure coding provider to use.\n */\n provider?: ErasureCodingProvider;\n /**\n * The callback to call when a chunk is encoded.\n */\n onChunk?: (event: UseEncodeBlobsOnChunkEvent) => void;\n};\n\nexport type UseEncodeBlobsOptions = UseMutationOptionsWithClient<\n BlobCommitments[],\n Error,\n UseEncodeBlobsVariables\n>;\n\n/**\n * Encodes blobs using erasure coding.\n *\n * This mutation generates blob commitments (merkle roots and erasure coding chunks)\n * from raw blob data. It supports custom erasure coding providers and progress callbacks\n * for tracking encoding progress.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useEncodeBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const encodeBlobs = useEncodeBlobs({\n * client: shelbyClient,\n * onSuccess: (commitments) => console.log('Encoded', commitments.length, 'blobs'),\n * });\n *\n * encodeBlobs.mutate({\n * blobs: [{ blobData: new Uint8Array([...]) }],\n * onChunk: ({ blobIndex, progress }) => {\n * console.log(`Blob ${blobIndex}: ${(progress * 100).toFixed(1)}%`);\n * },\n * });\n * ```\n */\nexport function useEncodeBlobs({\n client: shelbyClient,\n ...options\n}: UseEncodeBlobsOptions) {\n return useMutation({\n mutationFn: async ({ blobs, provider, onChunk }) => {\n const activeProvider =\n provider ?? (await createDefaultErasureCodingProvider());\n\n const results: BlobCommitments[] = new Array(blobs.length);\n await Promise.all(\n blobs.map(async ({ blobData }, blobIndex) => {\n const chunksetCount = Math.ceil(\n blobData.length / activeProvider.config.chunkSizeBytes,\n );\n\n const blobCommitments = await generateCommitments(\n activeProvider,\n blobData,\n (\n chunksetIndex: number,\n chunkIndex: number,\n chunkData: Uint8Array,\n ) =>\n onChunk?.({\n blobIndex,\n chunksetIndex,\n chunkIndex,\n chunkData,\n progress: chunksetIndex / chunksetCount,\n }),\n );\n\n results[blobIndex] = blobCommitments;\n }),\n );\n\n return results;\n },\n ...options,\n });\n}\n","import { AccountAddress } from \"@aptos-labs/ts-sdk\";\nimport {\n type BlobCommitments,\n DEFAULT_CHUNKSET_SIZE_BYTES,\n expectedTotalChunksets,\n ShelbyBlobClient,\n type UploadOptions,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\nimport type { AccountSigner, Signer } from \"../types/signers\";\n\nexport type UseRegisterCommitmentsVariables = {\n /**\n * The signer to use for the transaction.\n * @see {@link Signer}\n *\n * @example\n * ```tsx\n * const signer = new Account.generate();\n * registerCommitments.mutate({\n * signer,\n * commitments: [\n * { blobName: 'file1.txt', commitment: blobCommitments[0] },\n * ],\n * });\n * ```\n */\n signer: Signer;\n /**\n * The commitments to register.\n */\n commitments: { blobName: string; commitment: BlobCommitments }[];\n /**\n * The expiration time of the commitments in microseconds.\n */\n expirationMicros: number;\n /**\n * Optional transaction building options.\n */\n options?: UploadOptions;\n};\n\nexport type UseRegisterCommitmentsOptions = UseMutationOptionsWithClient<\n { hash: string },\n Error,\n UseRegisterCommitmentsVariables\n>;\n\n/**\n * Registers blob commitments on-chain.\n *\n * This mutation registers blob commitments (merkle roots) on the Aptos blockchain\n * as part of the blob upload process. It supports both account signers and wallet adapter\n * signers, and handles batch registration of multiple blobs.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useRegisterCommitments } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const registerCommitments = useRegisterCommitments({\n * client: shelbyClient,\n * onSuccess: ({ hash }) => console.log('Transaction hash:', hash),\n * });\n *\n * registerCommitments.mutate({\n * signer: accountSigner,\n * commitments: [\n * { blobName: 'file1.txt', commitment: blobCommitments[0] },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000, // 1 day\n * });\n * ```\n */\nexport function useRegisterCommitments({\n client: shelbyClient,\n ...options\n}: UseRegisterCommitmentsOptions) {\n return useMutation({\n mutationFn: async ({\n commitments,\n expirationMicros,\n options,\n signer: signerOrFn,\n }) => {\n if (!(\"account\" in signerOrFn)) {\n const accountSigner: AccountSigner = signerOrFn;\n\n const { transaction } =\n await shelbyClient.coordination.batchRegisterBlobs({\n account: accountSigner,\n expirationMicros,\n options,\n blobs: commitments.map((commitment) => ({\n blobName: commitment.blobName,\n blobSize: commitment.commitment.raw_data_size,\n blobMerkleRoot: commitment.commitment.blob_merkle_root,\n })),\n });\n\n return transaction;\n }\n\n const { account, signAndSubmitTransaction } = signerOrFn;\n const transaction = await signAndSubmitTransaction({\n data: ShelbyBlobClient.createBatchRegisterBlobsPayload({\n account: AccountAddress.from(account),\n expirationMicros,\n blobs: commitments.map((commitment) => ({\n blobName: commitment.blobName,\n blobSize: commitment.commitment.raw_data_size,\n blobMerkleRoot: commitment.commitment.blob_merkle_root,\n numChunksets: expectedTotalChunksets(\n commitment.commitment.raw_data_size,\n options?.chunksetSizeBytes ?? DEFAULT_CHUNKSET_SIZE_BYTES,\n ),\n })),\n }),\n options: options?.build?.options,\n });\n\n return transaction;\n },\n ...options,\n });\n}\n","import { AccountAddress } from \"@aptos-labs/ts-sdk\";\nimport {\n createBlobKey,\n createDefaultErasureCodingProvider,\n DEFAULT_CHUNKSET_SIZE_BYTES,\n expectedTotalChunksets,\n generateCommitments,\n ShelbyBlobClient,\n type UploadOptions,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport pLimit from \"p-limit\";\nimport type { UseMutationOptionsWithClient } from \"../types/mutations\";\nimport type { AccountSigner, Signer } from \"../types/signers\";\n\nexport type UseUploadBlobsVariables = {\n /**\n * The signer to use for the transaction.\n *\n * @see {@link Signer}\n *\n * @example\n * ```tsx\n * const signer = new Account.generate();\n * uploadBlobs.mutate({\n * signer,\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000,\n * });\n * ```\n */\n signer: Signer;\n /**\n * The blobs to upload.\n */\n blobs: {\n blobName: string;\n blobData: Uint8Array;\n }[];\n /**\n * The expiration time of the blobs in microseconds.\n */\n expirationMicros: number;\n /**\n * Optional transaction building options.\n */\n options?: UploadOptions;\n /**\n * The maximum number of concurrent uploads.\n * @default 3\n */\n maxConcurrentUploads?: number;\n};\n\nexport type UseUploadBlobsOptions = UseMutationOptionsWithClient<\n void,\n Error,\n UseUploadBlobsVariables\n>;\n\n/**\n * Uploads blobs to the Shelby network.\n *\n * This mutation handles the complete blob upload process including:\n * - Encoding blobs with erasure coding\n * - Registering commitments on-chain (if not already registered)\n * - Uploading blob data to the RPC endpoint\n *\n * It supports both account signers and wallet adapter signers, and includes\n * logic to skip registration for blobs that already exist.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useUploadBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const uploadBlobs = useUploadBlobs({\n * client: shelbyClient,\n * onSuccess: () => console.log('Upload complete'),\n * });\n *\n * const signer = new Account.generate();\n * uploadBlobs.mutate({\n * signer,\n * blobs: [\n * { blobName: 'file1.txt', blobData: new Uint8Array([...]) },\n * ],\n * expirationMicros: Date.now() * 1000 + 86400000000,\n * });\n * ```\n */\nexport function useUploadBlobs({\n client: shelbyClient,\n ...options\n}: UseUploadBlobsOptions) {\n return useMutation({\n mutationFn: async ({\n blobs,\n expirationMicros,\n options,\n signer: signerOrFn,\n maxConcurrentUploads = 3,\n }: UseUploadBlobsVariables) => {\n if (!(\"account\" in signerOrFn)) {\n const accountSigner: AccountSigner = signerOrFn;\n\n await shelbyClient.batchUpload({\n blobs: blobs.map(({ blobData, blobName }) => ({\n blobData,\n blobName,\n })),\n expirationMicros,\n signer: accountSigner,\n options,\n });\n } else {\n const { account, signAndSubmitTransaction } = signerOrFn;\n\n const chunksetSize =\n options?.chunksetSizeBytes ?? DEFAULT_CHUNKSET_SIZE_BYTES;\n\n const existingBlobs = await shelbyClient.coordination.getBlobs({\n where: {\n blob_name: {\n _in: blobs.map((blob) =>\n createBlobKey({ account, blobName: blob.blobName }),\n ),\n },\n },\n });\n\n const blobsToRegister = blobs.filter(\n (blob) =>\n !existingBlobs.some(\n (existingBlob) =>\n existingBlob.name ===\n createBlobKey({ account, blobName: blob.blobName }),\n ),\n );\n\n if (blobsToRegister.length > 0) {\n const provider = await createDefaultErasureCodingProvider();\n\n const blobCommitments = await Promise.all(\n blobsToRegister.map(async (blob) =>\n generateCommitments(provider, blob.blobData),\n ),\n );\n\n const pendingRegisterBlobTransaction = await signAndSubmitTransaction(\n {\n data: ShelbyBlobClient.createBatchRegisterBlobsPayload({\n account: AccountAddress.from(account),\n expirationMicros,\n blobs: blobsToRegister.map((blob, index) => ({\n blobName: blob.blobName,\n blobSize: blob.blobData.length,\n blobMerkleRoot: blobCommitments[index].blob_merkle_root,\n numChunksets: expectedTotalChunksets(\n blob.blobData.length,\n chunksetSize,\n ),\n })),\n }),\n options: options?.build?.options,\n },\n );\n\n await shelbyClient.coordination.aptos.waitForTransaction({\n transactionHash: pendingRegisterBlobTransaction.hash,\n });\n }\n\n const limit = pLimit(maxConcurrentUploads);\n const uploadPromises = blobs.map((blob) =>\n limit(() =>\n shelbyClient.rpc.putBlob({\n account,\n blobName: blob.blobName,\n blobData: blob.blobData,\n }),\n ),\n );\n\n await Promise.all(uploadPromises);\n }\n },\n ...options,\n });\n}\n","import type { Network } from \"@aptos-labs/ts-sdk\";\nimport type {\n BlobMetadata,\n ShelbyBlobClient,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { UseQueryOptionsWithClient } from \"../types/queries\";\n\nexport const getUseAccountBlobsQueryKey = (\n params: Parameters<ShelbyBlobClient[\"getAccountBlobs\"]>[0] & {\n network: Network;\n },\n) => [\n \"account-blobs\",\n params.network,\n params.account.toString(),\n params.pagination?.limit,\n params.pagination?.offset,\n params.orderBy,\n params.where,\n];\n\nexport type UseAccountBlobsOptions = UseQueryOptionsWithClient<BlobMetadata[]> &\n Parameters<ShelbyBlobClient[\"getAccountBlobs\"]>[0];\n\n/**\n * Queries blobs associated with an account.\n *\n * This query fetches blob metadata for a specific account with support for\n * pagination, filtering, and ordering.\n *\n * @example\n * ```tsx\n * import { ShelbyClient, Order_By} from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useAccountBlobs } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const { data: blobs, isLoading } = useAccountBlobs({\n * client: shelbyClient,\n * account: '0x123...',\n * pagination: { limit: 10, offset: 0 },\n * orderBy: { updated_at: Order_By.Desc },\n * });\n * ```\n */\nexport function useAccountBlobs({\n account,\n pagination,\n orderBy,\n where,\n client: shelbyClient,\n ...options\n}: UseAccountBlobsOptions) {\n return useQuery<BlobMetadata[]>({\n queryKey: getUseAccountBlobsQueryKey({\n network: shelbyClient.config.network,\n account,\n pagination,\n orderBy,\n where,\n }),\n queryFn: async () =>\n await shelbyClient.coordination.getAccountBlobs({\n account,\n pagination,\n orderBy,\n where,\n }),\n ...options,\n });\n}\n","import type { Network } from \"@aptos-labs/ts-sdk\";\nimport type {\n BlobMetadata,\n ShelbyBlobClient,\n} from \"@shelby-protocol/sdk/browser\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { UseQueryOptionsWithClient } from \"../types/queries\";\n\nexport const getUseBlobMetadataQueryKey = (\n params: Parameters<ShelbyBlobClient[\"getBlobMetadata\"]>[0] & {\n network: Network;\n },\n) => [\"blob-metadata\", params.network, params.account.toString(), params.name];\n\nexport type UseBlobMetadataOptions =\n UseQueryOptionsWithClient<BlobMetadata | null> &\n Parameters<ShelbyBlobClient[\"getBlobMetadata\"]>[0];\n\n/**\n * Queries the metadata for a specific blob.\n *\n * This query fetches the metadata for a single blob identified by account and blob name.\n * Returns `null` if the blob is not found.\n *\n * @example\n * ```tsx\n * import { ShelbyClient } from \"@shelby-protocol/sdk/browser\";\n * import { Network } from \"@aptos-labs/ts-sdk\";\n * import { useBlobMetadata } from \"@shelby-protocol/react\";\n *\n * const shelbyClient = new ShelbyClient({ network: Network.SHELBYNET });\n * const { data: metadata } = useBlobMetadata({\n * client: shelbyClient,\n * account: '0x123...',\n * name: 'file1.txt',\n * });\n * ```\n */\nexport function useBlobMetadata({\n account,\n name,\n client: shelbyClient,\n ...options\n}: UseBlobMetadataOptions) {\n return useQuery<BlobMetadata | null>({\n queryKey: getUseBlobMetadataQueryKey({\n network: shelbyClient.config.network,\n account,\n name,\n }),\n queryFn: async () =>\n (await shelbyClient.coordination.getBlobMetadata({ account, name })) ??\n null,\n ...options,\n });\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shelby-protocol/react",
3
- "version": "0.0.3",
3
+ "version": "0.0.4",
4
4
  "description": "React library for the Shelby Protocol",
5
5
  "private": false,
6
6
  "type": "module",
@@ -36,7 +36,7 @@
36
36
  "react": "^18.0.0 || ^19.0.0",
37
37
  "react-dom": "^18.0.0 || ^19.0.0",
38
38
  "typescript": ">=5.0.4",
39
- "@shelby-protocol/sdk": "0.0.8"
39
+ "@shelby-protocol/sdk": "0.0.9"
40
40
  },
41
41
  "peerDependenciesMeta": {
42
42
  "@aptos-labs/wallet-adapter-react": {
@@ -56,7 +56,7 @@
56
56
  "happy-dom": "^20.0.10",
57
57
  "tsup": "^8.4.0",
58
58
  "vitest": "^3.1.2",
59
- "@shelby-protocol/sdk": "0.0.8"
59
+ "@shelby-protocol/sdk": "0.0.9"
60
60
  },
61
61
  "keywords": [
62
62
  "aptos",