@shelby-protocol/sdk 0.0.9 → 0.2.0

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

@@ -2,6 +2,60 @@ import { AptosConfig } from '@aptos-labs/ts-sdk';
 import { ShelbyClientConfig } from './ShelbyClientConfig.js';
 import '../networks.js';
 
+/**
+ * Creates an AptosConfig from a ShelbyClientConfig.
+ *
+ * This function handles the translation between Shelby's configuration format
+ * and the Aptos SDK's configuration format.
+ *
+ * ## Authoritative Settings (cannot be overridden by `config.aptos`)
+ *
+ * - `network` — always comes from `config.network`
+ * - `faucet.authToken` — always maps to `faucetConfig.AUTH_TOKEN`
+ *
+ * ## Merged Settings (from `config.aptos`)
+ *
+ * When `config.aptos` is provided, the following are merged:
+ * - `clientConfig` — `config.apiKey` provides the default `API_KEY`,
+ *   but `config.aptos.clientConfig` values (including `API_KEY`) take precedence
+ * - `faucetConfig` — `config.aptos.faucetConfig` provides non-AUTH_TOKEN defaults
+ *   (e.g. HEADERS), but `config.faucet.authToken` always wins for AUTH_TOKEN
+ * - All other `AptosSettings` fields (e.g. `fullnode`, `indexer`, `pluginSettings`)
+ *   are passed through from `config.aptos`
+ *
+ * @param config - The ShelbyClientConfig to convert
+ * @returns An AptosConfig instance configured for the specified network
+ *
+ * @example
+ * ```typescript
+ * import { Network } from "@aptos-labs/ts-sdk";
+ *
+ * // Simple usage - network and apiKey only
+ * const aptosConfig = getAptosConfig({
+ *   network: Network.SHELBYNET,
+ *   apiKey: "your-api-key",
+ * });
+ *
+ * // With faucet auth token
+ * const aptosConfig = getAptosConfig({
+ *   network: Network.SHELBYNET,
+ *   apiKey: "your-api-key",
+ *   faucet: {
+ *     authToken: "faucet-auth-token",
+ *   },
+ * });
+ *
+ * // With custom aptos settings (advanced)
+ * const aptosConfig = getAptosConfig({
+ *   network: Network.SHELBYNET,
+ *   apiKey: "your-api-key",
+ *   aptos: {
+ *     fullnode: "https://custom-fullnode.example.com",
+ *     clientConfig: { HEADERS: { "X-Custom": "value" } },
+ *   },
+ * });
+ * ```
+ */
 declare const getAptosConfig: (config: ShelbyClientConfig) => AptosConfig;
 
 export { getAptosConfig };

package/dist/core/clients/utils.mjs

@@ -1,6 +1,6 @@
 import {
   getAptosConfig
-} from "../../chunk-RBFWGDMY.mjs";
+} from "../../chunk-AABBONAF.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
   getAptosConfig

package/dist/core/commitments.d.ts

@@ -1,8 +1,12 @@
 import { Hex } from '@aptos-labs/ts-sdk';
 import { z } from 'zod';
-import { a as ErasureCodingProvider } from '../clay-codes-pdZFxI_B.js';
+import { a as ErasureCodingProvider } from '../clay-codes-DHP-bYcP.js';
 import '@shelby-protocol/clay-codes';
 
+/**
+ * Current schema version for blob commitments
+ */
+declare const COMMITMENT_SCHEMA_VERSION = "1.3";
 /**
  * Defines the schema for the commitment format in commitments.json
  * This is used for `shelby encode` and oher commands
@@ -129,4 +133,4 @@ declare function generateMerkleRoot(leafHashes: Hex[]): Promise<Hex>;
  */
 declare function generateCommitments(provider: ErasureCodingProvider, fullData: ReadableStream<Uint8Array> | Uint8Array, onChunk?: (chunksetIdx: number, chunkIdx: number, chunkData: Uint8Array) => Promise<void> | void, options?: GenerateCommitmentsOptions): Promise<BlobCommitments>;
 
-export { type BlobCommitments, BlobCommitmentsSchema, type ChunksetCommitment, ChunksetCommitmentSchema, type GenerateCommitmentsOptions, expectedTotalChunksets, generateCommitments, generateMerkleRoot };
+export { type BlobCommitments, BlobCommitmentsSchema, COMMITMENT_SCHEMA_VERSION, type ChunksetCommitment, ChunksetCommitmentSchema, type GenerateCommitmentsOptions, expectedTotalChunksets, generateCommitments, generateMerkleRoot };

package/dist/core/commitments.mjs

@@ -1,16 +1,18 @@
 import {
   BlobCommitmentsSchema,
+  COMMITMENT_SCHEMA_VERSION,
   ChunksetCommitmentSchema,
   expectedTotalChunksets,
   generateCommitments,
   generateMerkleRoot
-} from "../chunk-XWAPNLU6.mjs";
+} from "../chunk-2WEX3K7C.mjs";
 import "../chunk-4JZO2D7T.mjs";
-import "../chunk-67F5YZ25.mjs";
-import "../chunk-ZPW742E7.mjs";
+import "../chunk-JTXYKO3U.mjs";
+import "../chunk-AUQDI5BS.mjs";
 import "../chunk-7P6ASYW6.mjs";
 export {
   BlobCommitmentsSchema,
+  COMMITMENT_SCHEMA_VERSION,
   ChunksetCommitmentSchema,
   expectedTotalChunksets,
   generateCommitments,

package/dist/core/constants.d.ts

@@ -2,8 +2,9 @@ declare const DEFAULT_PROJECT_NAME = "shelby";
 declare const DEFAULT_PROJECT_DESCRIPTION = "High performance, decentralized storage";
 declare const NetworkToShelbyRPCBaseUrl: {
     readonly shelbynet: "https://api.shelbynet.shelby.xyz/shelby";
+    readonly netna: undefined;
     readonly devnet: undefined;
-    readonly testnet: undefined;
+    readonly testnet: "https://api.testnet.shelby.xyz/shelby";
     readonly mainnet: undefined;
     readonly local: undefined;
     readonly custom: undefined;
@@ -13,13 +14,27 @@ declare const NetworkToShelbyRPCBaseUrl: {
  */
 declare const NetworkToShelbyBlobIndexerBaseUrl: {
     readonly shelbynet: "https://api.shelbynet.aptoslabs.com/nocode/v1/public/cmforrguw0042s601fn71f9l2/v1/graphql";
+    readonly netna: undefined;
     readonly devnet: undefined;
-    readonly testnet: undefined;
+    readonly testnet: "https://api.testnet.aptoslabs.com/nocode/v1/public/cmlfqs5wt00qrs601zt5s4kfj/v1/graphql";
+    readonly mainnet: undefined;
+    readonly local: undefined;
+    readonly custom: undefined;
+};
+/**
+ * Mapping of Aptos networks to gas station URL.
+ */
+declare const NetworkToGasStationBaseUrl: {
+    readonly shelbynet: "https://api.shelbynet.shelby.xyz/gs/v1";
+    readonly netna: undefined;
+    readonly devnet: undefined;
+    readonly testnet: "https://api.testnet.shelby.xyz/gs/v1";
     readonly mainnet: undefined;
     readonly local: undefined;
     readonly custom: undefined;
 };
 declare const SHELBY_DEPLOYER = "0xc63d6a5efb0080a6029403131715bd4971e1149f7cc099aac69bb0069b3ddbf5";
+declare const MICROPAYMENTS_DEPLOYER = "0xb42ac038b6dae86f6171e28e297aab9555ce09909445ec579e4ffe6b8d4d63bf";
 declare const TOKEN_DEPLOYER = "0x33009e852be7f93762dd0bf303383c2cb2c5cab7a30d8238ca5f9f177ae75124";
 declare const TOKEN_OBJECT_ADDRESS = "0x249f5c642a63885ff88a5113b3ba0079840af5a1357706f8c7f3bfc5dd12511f";
 declare const SHELBYUSD_TOKEN_ADDRESS = "0x249f5c642a63885ff88a5113b3ba0079840af5a1357706f8c7f3bfc5dd12511f";
@@ -27,4 +42,4 @@ declare const SHELBYUSD_TOKEN_MODULE = "shelby_usd";
 declare const SHELBYUSD_TOKEN_NAME = "ShelbyUSD";
 declare const SHELBYUSD_FA_METADATA_ADDRESS = "0x1b18363a9f1fe5e6ebf247daba5cc1c18052bb232efdc4c50f556053922d98e1";
 
-export { DEFAULT_PROJECT_DESCRIPTION, DEFAULT_PROJECT_NAME, NetworkToShelbyBlobIndexerBaseUrl, NetworkToShelbyRPCBaseUrl, SHELBYUSD_FA_METADATA_ADDRESS, SHELBYUSD_TOKEN_ADDRESS, SHELBYUSD_TOKEN_MODULE, SHELBYUSD_TOKEN_NAME, SHELBY_DEPLOYER, TOKEN_DEPLOYER, TOKEN_OBJECT_ADDRESS };
+export { DEFAULT_PROJECT_DESCRIPTION, DEFAULT_PROJECT_NAME, MICROPAYMENTS_DEPLOYER, NetworkToGasStationBaseUrl, NetworkToShelbyBlobIndexerBaseUrl, NetworkToShelbyRPCBaseUrl, SHELBYUSD_FA_METADATA_ADDRESS, SHELBYUSD_TOKEN_ADDRESS, SHELBYUSD_TOKEN_MODULE, SHELBYUSD_TOKEN_NAME, SHELBY_DEPLOYER, TOKEN_DEPLOYER, TOKEN_OBJECT_ADDRESS };

package/dist/core/constants.mjs

@@ -1,6 +1,8 @@
 import {
   DEFAULT_PROJECT_DESCRIPTION,
   DEFAULT_PROJECT_NAME,
+  MICROPAYMENTS_DEPLOYER,
+  NetworkToGasStationBaseUrl,
   NetworkToShelbyBlobIndexerBaseUrl,
   NetworkToShelbyRPCBaseUrl,
   SHELBYUSD_FA_METADATA_ADDRESS,
@@ -10,11 +12,13 @@ import {
   SHELBY_DEPLOYER,
   TOKEN_DEPLOYER,
   TOKEN_OBJECT_ADDRESS
-} from "../chunk-SEXQTDX6.mjs";
+} from "../chunk-4ZOFT75Q.mjs";
 import "../chunk-7P6ASYW6.mjs";
 export {
   DEFAULT_PROJECT_DESCRIPTION,
   DEFAULT_PROJECT_NAME,
+  MICROPAYMENTS_DEPLOYER,
+  NetworkToGasStationBaseUrl,
   NetworkToShelbyBlobIndexerBaseUrl,
   NetworkToShelbyRPCBaseUrl,
   SHELBYUSD_FA_METADATA_ADDRESS,

package/dist/core/erasure/clay-codes.d.ts

@@ -1,2 +1,2 @@
 import '@shelby-protocol/clay-codes';
-export { e as ClayConfig, g as ClayDecodeConfig, f as ClayErasureCodeParams, C as ClayErasureCodingProvider, b as ClayProviderOptions } from '../../clay-codes-pdZFxI_B.js';
+export { b as ClayConfig, g as ClayDecodeConfig, f as ClayErasureCodeParams, C as ClayErasureCodingProvider, c as ClayProviderOptions, h as buildClayConfig } from '../../clay-codes-DHP-bYcP.js';

package/dist/core/erasure/clay-codes.mjs

@@ -1,9 +1,9 @@
 import {
-  ClayErasureCodingProvider
-} from "../../chunk-NLPIHQ7K.mjs";
-import "../../chunk-67F5YZ25.mjs";
-import "../../chunk-ZPW742E7.mjs";
+  ClayErasureCodingProvider,
+  buildClayConfig
+} from "../../chunk-OGKZ575S.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
-  ClayErasureCodingProvider
+  ClayErasureCodingProvider,
+  buildClayConfig
 };

package/dist/core/erasure/constants.d.ts

@@ -6,13 +6,14 @@
  * Erasure coding schemes supported by Shelby.
  */
 declare enum ErasureCodingScheme {
-    ClayCode_16Total_10Data_13Helper = "ClayCode_16Total_10Data_13Helper"
+    ClayCode_16Total_10Data_13Helper = "ClayCode_16Total_10Data_13Helper",
+    ClayCode_4Total_2Data_3Helper = "ClayCode_4Total_2Data_3Helper"
 }
 /**
  * Union of all supported erasure coding parameter types.
  * When new erasure schemes are added, union them to this type.
  */
-type ErasureSchemeParams = (typeof ERASURE_CODE_PARAMS)["ClayCode_16Total_10Data_13Helper"] /** | ReedSolomonErasureCodeParams */;
+type ErasureSchemeParams = (typeof ERASURE_CODE_PARAMS)["ClayCode_16Total_10Data_13Helper"] | (typeof ERASURE_CODE_PARAMS)["ClayCode_4Total_2Data_3Helper"];
 type ErasureCodeParams = Record<ErasureCodingScheme, ErasureSchemeParams>;
 /**
  * Parameters for each supported erasure coding scheme.
@@ -26,6 +27,13 @@ declare const ERASURE_CODE_PARAMS: {
         readonly erasure_n: 16;
         readonly erasure_k: 10;
         readonly erasure_d: 13;
+        readonly enumIndex: 0;
+    };
+    readonly ClayCode_4Total_2Data_3Helper: {
+        readonly erasure_n: 4;
+        readonly erasure_k: 2;
+        readonly erasure_d: 3;
+        readonly enumIndex: 1;
     };
 };
 /**
@@ -44,5 +52,9 @@ declare const DEFAULT_ERASURE_D: 13;
  * The number of parity chunks in the erasure coding scheme (derived as n - k).
  */
 declare const DEFAULT_ERASURE_M: number;
+/**
+ * The size of a sample in a Chunk.
+ */
+declare const DEFAULT_SAMPLE_SIZE = 1024;
 
-export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, ERASURE_CODE_PARAMS, type ErasureCodeParams, ErasureCodingScheme, type ErasureSchemeParams };
+export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, DEFAULT_SAMPLE_SIZE, ERASURE_CODE_PARAMS, type ErasureCodeParams, ErasureCodingScheme, type ErasureSchemeParams };

package/dist/core/erasure/constants.mjs

@@ -3,15 +3,17 @@ import {
   DEFAULT_ERASURE_K,
   DEFAULT_ERASURE_M,
   DEFAULT_ERASURE_N,
+  DEFAULT_SAMPLE_SIZE,
   ERASURE_CODE_PARAMS,
   ErasureCodingScheme
-} from "../../chunk-ZPW742E7.mjs";
+} from "../../chunk-AUQDI5BS.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
   DEFAULT_ERASURE_D,
   DEFAULT_ERASURE_K,
   DEFAULT_ERASURE_M,
   DEFAULT_ERASURE_N,
+  DEFAULT_SAMPLE_SIZE,
   ERASURE_CODE_PARAMS,
   ErasureCodingScheme
 };

package/dist/core/erasure/default.d.ts

@@ -1,6 +1,9 @@
-import { C as ClayErasureCodingProvider } from '../../clay-codes-pdZFxI_B.js';
+import { C as ClayErasureCodingProvider, b as ClayConfig } from '../../clay-codes-DHP-bYcP.js';
 import '@shelby-protocol/clay-codes';
 
 declare function createDefaultErasureCodingProvider(): Promise<ClayErasureCodingProvider>;
+declare function defaultErasureCodingConfig(): ClayConfig;
+declare function erasureCodingConfig16Total10Data13Helper(): ClayConfig;
+declare function erasureCodingConfig4Total2Data3Helper(): ClayConfig;
 
-export { createDefaultErasureCodingProvider };
+export { createDefaultErasureCodingProvider, defaultErasureCodingConfig, erasureCodingConfig16Total10Data13Helper, erasureCodingConfig4Total2Data3Helper };

package/dist/core/erasure/default.mjs

@@ -1,10 +1,16 @@
 import {
-  createDefaultErasureCodingProvider
-} from "../../chunk-CPNZAQVY.mjs";
-import "../../chunk-NLPIHQ7K.mjs";
-import "../../chunk-67F5YZ25.mjs";
-import "../../chunk-ZPW742E7.mjs";
+  createDefaultErasureCodingProvider,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper
+} from "../../chunk-HPPMI7DC.mjs";
+import "../../chunk-OGKZ575S.mjs";
+import "../../chunk-JTXYKO3U.mjs";
+import "../../chunk-AUQDI5BS.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
-  createDefaultErasureCodingProvider
+  createDefaultErasureCodingProvider,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper
 };

package/dist/core/erasure/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ClayErasureCodingProvider, D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, R as ReedSolomonErasureCodingProvider } from '../../clay-codes-pdZFxI_B.js';
-export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, ERASURE_CODE_PARAMS, ErasureCodeParams, ErasureCodingScheme, ErasureSchemeParams } from './constants.js';
-export { createDefaultErasureCodingProvider } from './default.js';
+export { C as ClayErasureCodingProvider, D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, R as ReedSolomonErasureCodingProvider } from '../../clay-codes-DHP-bYcP.js';
+export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, DEFAULT_SAMPLE_SIZE, ERASURE_CODE_PARAMS, ErasureCodeParams, ErasureCodingScheme, ErasureSchemeParams } from './constants.js';
+export { createDefaultErasureCodingProvider, defaultErasureCodingConfig, erasureCodingConfig16Total10Data13Helper, erasureCodingConfig4Total2Data3Helper } from './default.js';
 import '@shelby-protocol/clay-codes';

package/dist/core/erasure/index.mjs

@@ -1,22 +1,26 @@
 import "../../chunk-XNEIWM4O.mjs";
 import {
-  createDefaultErasureCodingProvider
-} from "../../chunk-CPNZAQVY.mjs";
+  createDefaultErasureCodingProvider,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper
+} from "../../chunk-HPPMI7DC.mjs";
 import {
   ClayErasureCodingProvider
-} from "../../chunk-NLPIHQ7K.mjs";
+} from "../../chunk-OGKZ575S.mjs";
 import {
   ReedSolomonErasureCodingProvider
-} from "../../chunk-PZF2VTGP.mjs";
-import "../../chunk-67F5YZ25.mjs";
+} from "../../chunk-NHWWORCH.mjs";
+import "../../chunk-JTXYKO3U.mjs";
 import {
   DEFAULT_ERASURE_D,
   DEFAULT_ERASURE_K,
   DEFAULT_ERASURE_M,
   DEFAULT_ERASURE_N,
+  DEFAULT_SAMPLE_SIZE,
   ERASURE_CODE_PARAMS,
   ErasureCodingScheme
-} from "../../chunk-ZPW742E7.mjs";
+} from "../../chunk-AUQDI5BS.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
   ClayErasureCodingProvider,
@@ -24,8 +28,12 @@ export {
   DEFAULT_ERASURE_K,
   DEFAULT_ERASURE_M,
   DEFAULT_ERASURE_N,
+  DEFAULT_SAMPLE_SIZE,
   ERASURE_CODE_PARAMS,
   ErasureCodingScheme,
   ReedSolomonErasureCodingProvider,
-  createDefaultErasureCodingProvider
+  createDefaultErasureCodingProvider,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper
 };

package/dist/core/erasure/provider.d.ts

@@ -1,2 +1,2 @@
 import '@shelby-protocol/clay-codes';
-export { D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, I as InitConfig } from '../../clay-codes-pdZFxI_B.js';
+export { D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, I as InitConfig } from '../../clay-codes-DHP-bYcP.js';

package/dist/core/erasure/reed-solomon.d.ts

@@ -1,2 +1,2 @@
 import '@shelby-protocol/clay-codes';
-export { c as ReedSolomonConfig, R as ReedSolomonErasureCodingProvider, d as ReedSolomonProviderOptions } from '../../clay-codes-pdZFxI_B.js';
+export { d as ReedSolomonConfig, R as ReedSolomonErasureCodingProvider, e as ReedSolomonProviderOptions } from '../../clay-codes-DHP-bYcP.js';

package/dist/core/erasure/reed-solomon.mjs

@@ -1,6 +1,6 @@
 import {
   ReedSolomonErasureCodingProvider
-} from "../../chunk-PZF2VTGP.mjs";
+} from "../../chunk-NHWWORCH.mjs";
 import "../../chunk-7P6ASYW6.mjs";
 export {
   ReedSolomonErasureCodingProvider

package/dist/core/erasure/utils.d.ts

@@ -1,4 +1,4 @@
-import { a as ErasureCodingProvider } from '../../clay-codes-pdZFxI_B.js';
+import { a as ErasureCodingProvider } from '../../clay-codes-DHP-bYcP.js';
 import '@shelby-protocol/clay-codes';
 
 declare function allocateAndCopy(data: Uint8Array, desiredLength: number): Uint8Array;

package/dist/core/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shelby contract error codes from Move modules.
+ *
+ * These error codes are returned by the Shelby Move contracts when
+ * transactions fail due to validation or authorization errors.
+ *
+ * @see move/shelby_contract/sources/blob_metadata.move
+ */
+declare const ShelbyErrorCodes: {
+    readonly E_BLOB_NOT_FOUND: "E_BLOB_NOT_FOUND";
+    readonly E_INVALID_EXPIRATION_TIME: "E_INVALID_EXPIRATION_TIME";
+    readonly E_TEST_ENCODING_NOT_ALLOWED: "E_TEST_ENCODING_NOT_ALLOWED";
+    readonly E_BLOB_NOT_EXPIRED: "E_BLOB_NOT_EXPIRED";
+    readonly E_INVALID_CHUNKSET_COUNT: "E_INVALID_CHUNKSET_COUNT";
+    readonly E_NOT_BLOB_OWNER: "E_NOT_BLOB_OWNER";
+    readonly E_NOT_ADMIN: "E_NOT_ADMIN";
+    readonly E_BLOB_EXPIRED: "E_BLOB_EXPIRED";
+    readonly E_BLOB_NAME_TOO_LONG: "E_BLOB_NAME_TOO_LONG";
+    readonly E_INVALID_PAYMENT_EPOCHS: "E_INVALID_PAYMENT_EPOCHS";
+    readonly E_NO_SLICES_AVAILABLE: "E_NO_SLICES_AVAILABLE";
+    readonly EALREADY_EXISTS: "EALREADY_EXISTS";
+};
+/**
+ * Check if an error message indicates a blob already exists on chain.
+ *
+ * This occurs when trying to register a blob with a name that's already
+ * registered under the same account.
+ *
+ * @param errorMessage - The error message from a failed transaction
+ * @returns true if the error indicates the blob already exists
+ */
+declare function isBlobAlreadyExistsError(errorMessage: string): boolean;
+/**
+ * Check if an error message indicates an access/permission denied error.
+ *
+ * This covers scenarios where the caller doesn't have permission to
+ * perform the requested operation on a blob or account.
+ *
+ * @param errorMessage - The error message from a failed transaction
+ * @returns true if the error indicates access was denied
+ */
+declare function isAccessDeniedError(errorMessage: string): boolean;
+/**
+ * Check if an error message indicates the blob was not found.
+ *
+ * @param errorMessage - The error message from a failed transaction
+ * @returns true if the error indicates the blob doesn't exist
+ */
+declare function isBlobNotFoundError(errorMessage: string): boolean;
+/**
+ * Check if an error message indicates the blob has expired.
+ *
+ * @param errorMessage - The error message from a failed transaction
+ * @returns true if the error indicates the blob has expired
+ */
+declare function isBlobExpiredError(errorMessage: string): boolean;
+
+export { ShelbyErrorCodes, isAccessDeniedError, isBlobAlreadyExistsError, isBlobExpiredError, isBlobNotFoundError };

package/dist/core/errors.mjs

@@ -0,0 +1,15 @@
+import {
+  ShelbyErrorCodes,
+  isAccessDeniedError,
+  isBlobAlreadyExistsError,
+  isBlobExpiredError,
+  isBlobNotFoundError
+} from "../chunk-CQ6QPIZK.mjs";
+import "../chunk-7P6ASYW6.mjs";
+export {
+  ShelbyErrorCodes,
+  isAccessDeniedError,
+  isBlobAlreadyExistsError,
+  isBlobExpiredError,
+  isBlobNotFoundError
+};

package/dist/core/index.d.ts

@@ -1,23 +1,30 @@
 export { getAptosAccountExplorerUrl, getAptosTransactionExplorerUrl } from './aptos-explorer.js';
 export { ShelbyBlob, createBlobKey } from './blobs.js';
 export { CHUNK_SIZE_PARAMS, ChunkSizeScheme, DEFAULT_CHUNKSET_SIZE_BYTES, DEFAULT_CHUNK_SIZE_BYTES, ERASURE_CODE_AND_CHUNK_MAPPING } from './chunk.js';
-export { ShelbyBlobClient } from './clients/ShelbyBlobClient.js';
+export { AckTransactionOptions, BuildOptions, MissingTransactionSubmitterError, ShelbyBlobClient, UsdSponsorOptions, WriteBlobCommitmentsOptions } from './clients/ShelbyBlobClient.js';
 export { ShelbyClient, UploadOptions } from './clients/ShelbyClient.js';
 export { ShelbyClientConfig, ShelbyIndexerConfig, ShelbyRPCConfig } from './clients/ShelbyClientConfig.js';
-export { ShelbyRPCClient } from './clients/ShelbyRPCClient.js';
-export { BlobCommitments, BlobCommitmentsSchema, ChunksetCommitment, ChunksetCommitmentSchema, GenerateCommitmentsOptions, expectedTotalChunksets, generateCommitments, generateMerkleRoot } from './commitments.js';
-export { DEFAULT_PROJECT_DESCRIPTION, DEFAULT_PROJECT_NAME, NetworkToShelbyBlobIndexerBaseUrl, NetworkToShelbyRPCBaseUrl, SHELBYUSD_FA_METADATA_ADDRESS, SHELBYUSD_TOKEN_ADDRESS, SHELBYUSD_TOKEN_MODULE, SHELBYUSD_TOKEN_NAME, SHELBY_DEPLOYER, TOKEN_DEPLOYER, TOKEN_OBJECT_ADDRESS } from './constants.js';
-export { C as ClayErasureCodingProvider, D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, R as ReedSolomonErasureCodingProvider } from '../clay-codes-pdZFxI_B.js';
-export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, ERASURE_CODE_PARAMS, ErasureCodeParams, ErasureCodingScheme, ErasureSchemeParams } from './erasure/constants.js';
-export { createDefaultErasureCodingProvider } from './erasure/default.js';
-export { BlobName, BlobNameSchema, ChunkKey, allChunksForBlob, roundSize } from './layout.js';
+export { ShelbyMetadataClient } from './clients/ShelbyMetadataClient.js';
+export { ShelbyMicropaymentChannelClient } from './clients/ShelbyMicropaymentChannelClient.js';
+export { ShelbyPlacementGroupClient } from './clients/ShelbyPlacementGroupClient.js';
+export { BlobDataSource, PutBlobProgress, ShelbyRPCClient } from './clients/ShelbyRPCClient.js';
+export { BlobCommitments, BlobCommitmentsSchema, COMMITMENT_SCHEMA_VERSION, ChunksetCommitment, ChunksetCommitmentSchema, GenerateCommitmentsOptions, expectedTotalChunksets, generateCommitments, generateMerkleRoot } from './commitments.js';
+export { DEFAULT_PROJECT_DESCRIPTION, DEFAULT_PROJECT_NAME, MICROPAYMENTS_DEPLOYER, NetworkToGasStationBaseUrl, NetworkToShelbyBlobIndexerBaseUrl, NetworkToShelbyRPCBaseUrl, SHELBYUSD_FA_METADATA_ADDRESS, SHELBYUSD_TOKEN_ADDRESS, SHELBYUSD_TOKEN_MODULE, SHELBYUSD_TOKEN_NAME, SHELBY_DEPLOYER, TOKEN_DEPLOYER, TOKEN_OBJECT_ADDRESS } from './constants.js';
+export { C as ClayErasureCodingProvider, D as DecodeConfig, E as ErasureCodingConfig, a as ErasureCodingProvider, R as ReedSolomonErasureCodingProvider } from '../clay-codes-DHP-bYcP.js';
+export { DEFAULT_ERASURE_D, DEFAULT_ERASURE_K, DEFAULT_ERASURE_M, DEFAULT_ERASURE_N, DEFAULT_SAMPLE_SIZE, ERASURE_CODE_PARAMS, ErasureCodeParams, ErasureCodingScheme, ErasureSchemeParams } from './erasure/constants.js';
+export { createDefaultErasureCodingProvider, defaultErasureCodingConfig, erasureCodingConfig16Total10Data13Helper, erasureCodingConfig4Total2Data3Helper } from './erasure/default.js';
+export { ShelbyErrorCodes, isAccessDeniedError, isBlobAlreadyExistsError, isBlobExpiredError, isBlobNotFoundError } from './errors.js';
+export { BlobName, BlobNameSchema, ChunkKey } from './layout.js';
 export { ShelbyNetwork, isShelbyNetwork, shelbyNetworks } from './networks.js';
 export { ShelbyIndexerClient, createShelbyIndexerClient, getShelbyIndexerClient } from './operations/index.js';
+export { CompleteMultipartUploadResponse, CompleteMultipartUploadResponseSchema, RPCErrorResponse, RPCErrorResponseSchema, StaleMicropaymentErrorResponse, StaleMicropaymentErrorResponseSchema, StartMultipartUploadResponse, StartMultipartUploadResponseSchema, UploadPartResponse, UploadPartResponseSchema } from './rpc-responses.js';
 export { getShelbyAccountBlobsExplorerUrl, getShelbyAccountExplorerUrl, getShelbyBlobExplorerUrl } from './shelby-explorer.js';
 export { BlobActivity, BlobActivityType, BlobEncoding, BlobMetadata, ClayEncoding, StorageProviderAck } from './types/blobs.js';
-export { StorageProviderInfo } from './types/storage_providers.js';
+export { ChannelInfo, SenderBuiltMicropayment, StaleChannelStateError } from './types/payments.js';
+export { PlacementGroupInfo, PlacementGroupSlot, PlacementGroupSlotStatus } from './types/placement_groups.js';
+export { ActiveStateDetails, FrozenStateDetails, StorageProviderInfo, StorageProviderStateDetails, WaitlistedStateDetails } from './types/storage_providers.js';
 export { buildRequestUrl, concatHashes, getBlobNameSuffix, readInChunks, zeroPadBytes } from './utils.js';
-export { Bigint_Comparison_Exp, Blob_Activities, Blob_Activities_Aggregate, Blob_Activities_Aggregate_Fields, Blob_Activities_Aggregate_FieldsCountArgs, Blob_Activities_Avg_Fields, Blob_Activities_Bool_Exp, Blob_Activities_Max_Fields, Blob_Activities_Min_Fields, Blob_Activities_Order_By, Blob_Activities_Select_Column, Blob_Activities_Stddev_Fields, Blob_Activities_Stddev_Pop_Fields, Blob_Activities_Stddev_Samp_Fields, Blob_Activities_Stream_Cursor_Input, Blob_Activities_Stream_Cursor_Value_Input, Blob_Activities_Sum_Fields, Blob_Activities_Var_Pop_Fields, Blob_Activities_Var_Samp_Fields, Blob_Activities_Variance_Fields, Blobs, BlobsPlacement_Group_SlotsArgs, Blobs_Aggregate, Blobs_Aggregate_Fields, Blobs_Aggregate_FieldsCountArgs, Blobs_Avg_Fields, Blobs_Bool_Exp, Blobs_Max_Fields, Blobs_Min_Fields, Blobs_Order_By, Blobs_Select_Column, Blobs_Stddev_Fields, Blobs_Stddev_Pop_Fields, Blobs_Stddev_Samp_Fields, Blobs_Stream_Cursor_Input, Blobs_Stream_Cursor_Value_Input, Blobs_Sum_Fields, Blobs_Var_Pop_Fields, Blobs_Var_Samp_Fields, Blobs_Variance_Fields, Cursor_Ordering, Exact, GetBlobActivitiesCountDocument, GetBlobActivitiesCountQuery, GetBlobActivitiesCountQueryVariables, GetBlobActivitiesDocument, GetBlobActivitiesQuery, GetBlobActivitiesQueryVariables, GetBlobsCountDocument, GetBlobsCountQuery, GetBlobsCountQueryVariables, GetBlobsDocument, GetBlobsQuery, GetBlobsQueryVariables, Incremental, InputMaybe, MakeEmpty, MakeMaybe, MakeOptional, Maybe, Numeric_Comparison_Exp, Order_By, Placement_Group_Slots, Placement_Group_Slots_Aggregate_Order_By, Placement_Group_Slots_Avg_Order_By, Placement_Group_Slots_Bool_Exp, Placement_Group_Slots_Max_Order_By, Placement_Group_Slots_Min_Order_By, Placement_Group_Slots_Order_By, Placement_Group_Slots_Select_Column, Placement_Group_Slots_Stddev_Order_By, Placement_Group_Slots_Stddev_Pop_Order_By, Placement_Group_Slots_Stddev_Samp_Order_By, Placement_Group_Slots_Stream_Cursor_Input, Placement_Group_Slots_Stream_Cursor_Value_Input, Placement_Group_Slots_Sum_Order_By, Placement_Group_Slots_Var_Pop_Order_By, Placement_Group_Slots_Var_Samp_Order_By, Placement_Group_Slots_Variance_Order_By, Processor_Status, Processor_Status_Bool_Exp, Processor_Status_Order_By, Processor_Status_Select_Column, Processor_Status_Stream_Cursor_Input, Processor_Status_Stream_Cursor_Value_Input, Query_Root, Query_RootBlob_ActivitiesArgs, Query_RootBlob_Activities_AggregateArgs, Query_RootBlob_Activities_By_PkArgs, Query_RootBlobsArgs, Query_RootBlobs_AggregateArgs, Query_RootBlobs_By_PkArgs, Query_RootPlacement_Group_SlotsArgs, Query_RootPlacement_Group_Slots_By_PkArgs, Query_RootProcessor_StatusArgs, Scalars, Sdk, SdkFunctionWrapper, String_Comparison_Exp, Subscription_Root, Subscription_RootBlob_ActivitiesArgs, Subscription_RootBlob_Activities_AggregateArgs, Subscription_RootBlob_Activities_By_PkArgs, Subscription_RootBlob_Activities_StreamArgs, Subscription_RootBlobsArgs, Subscription_RootBlobs_AggregateArgs, Subscription_RootBlobs_By_PkArgs, Subscription_RootBlobs_StreamArgs, Subscription_RootPlacement_Group_SlotsArgs, Subscription_RootPlacement_Group_Slots_By_PkArgs, Subscription_RootPlacement_Group_Slots_StreamArgs, Subscription_RootProcessor_StatusArgs, Subscription_RootProcessor_Status_StreamArgs, Timestamp_Comparison_Exp, getSdk } from './operations/generated/sdk.js';
+export { Bigint_Comparison_Exp, Blob_Activities, Blob_Activities_Aggregate, Blob_Activities_Aggregate_Fields, Blob_Activities_Aggregate_FieldsCountArgs, Blob_Activities_Avg_Fields, Blob_Activities_Bool_Exp, Blob_Activities_Max_Fields, Blob_Activities_Min_Fields, Blob_Activities_Order_By, Blob_Activities_Select_Column, Blob_Activities_Stddev_Fields, Blob_Activities_Stddev_Pop_Fields, Blob_Activities_Stddev_Samp_Fields, Blob_Activities_Stream_Cursor_Input, Blob_Activities_Stream_Cursor_Value_Input, Blob_Activities_Sum_Fields, Blob_Activities_Var_Pop_Fields, Blob_Activities_Var_Samp_Fields, Blob_Activities_Variance_Fields, Blobs, BlobsPlacement_Group_SlotsArgs, BlobsPlacement_Group_Slots_AggregateArgs, Blobs_Aggregate, Blobs_Aggregate_Fields, Blobs_Aggregate_FieldsCountArgs, Blobs_Avg_Fields, Blobs_Bool_Exp, Blobs_Max_Fields, Blobs_Min_Fields, Blobs_Order_By, Blobs_Select_Column, Blobs_Stddev_Fields, Blobs_Stddev_Pop_Fields, Blobs_Stddev_Samp_Fields, Blobs_Stream_Cursor_Input, Blobs_Stream_Cursor_Value_Input, Blobs_Sum_Fields, Blobs_Var_Pop_Fields, Blobs_Var_Samp_Fields, Blobs_Variance_Fields, Cursor_Ordering, Exact, GetBlobActivitiesCountDocument, GetBlobActivitiesCountQuery, GetBlobActivitiesCountQueryVariables, GetBlobActivitiesDocument, GetBlobActivitiesQuery, GetBlobActivitiesQueryVariables, GetBlobsCountDocument, GetBlobsCountQuery, GetBlobsCountQueryVariables, GetBlobsDocument, GetBlobsQuery, GetBlobsQueryVariables, GetPlacementGroupSlotsCountDocument, GetPlacementGroupSlotsCountQuery, GetPlacementGroupSlotsCountQueryVariables, GetPlacementGroupSlotsDocument, GetPlacementGroupSlotsQuery, GetPlacementGroupSlotsQueryVariables, GetProcessorStatusDocument, GetProcessorStatusQuery, GetProcessorStatusQueryVariables, Incremental, InputMaybe, Int_Comparison_Exp, MakeEmpty, MakeMaybe, MakeOptional, Maybe, Numeric_Comparison_Exp, Order_By, Placement_Group_Slots, Placement_Group_Slots_Aggregate, Placement_Group_Slots_Aggregate_Bool_Exp, Placement_Group_Slots_Aggregate_Bool_Exp_Count, Placement_Group_Slots_Aggregate_Fields, Placement_Group_Slots_Aggregate_FieldsCountArgs, Placement_Group_Slots_Aggregate_Order_By, Placement_Group_Slots_Avg_Fields, Placement_Group_Slots_Avg_Order_By, Placement_Group_Slots_Bool_Exp, Placement_Group_Slots_Max_Fields, Placement_Group_Slots_Max_Order_By, Placement_Group_Slots_Min_Fields, Placement_Group_Slots_Min_Order_By, Placement_Group_Slots_Order_By, Placement_Group_Slots_Select_Column, Placement_Group_Slots_Stddev_Fields, Placement_Group_Slots_Stddev_Order_By, Placement_Group_Slots_Stddev_Pop_Fields, Placement_Group_Slots_Stddev_Pop_Order_By, Placement_Group_Slots_Stddev_Samp_Fields, Placement_Group_Slots_Stddev_Samp_Order_By, Placement_Group_Slots_Stream_Cursor_Input, Placement_Group_Slots_Stream_Cursor_Value_Input, Placement_Group_Slots_Sum_Fields, Placement_Group_Slots_Sum_Order_By, Placement_Group_Slots_Var_Pop_Fields, Placement_Group_Slots_Var_Pop_Order_By, Placement_Group_Slots_Var_Samp_Fields, Placement_Group_Slots_Var_Samp_Order_By, Placement_Group_Slots_Variance_Fields, Placement_Group_Slots_Variance_Order_By, Processor_Status, Processor_Status_Bool_Exp, Processor_Status_Order_By, Processor_Status_Select_Column, Processor_Status_Stream_Cursor_Input, Processor_Status_Stream_Cursor_Value_Input, Query_Root, Query_RootBlob_ActivitiesArgs, Query_RootBlob_Activities_AggregateArgs, Query_RootBlob_Activities_By_PkArgs, Query_RootBlobsArgs, Query_RootBlobs_AggregateArgs, Query_RootBlobs_By_PkArgs, Query_RootPlacement_Group_SlotsArgs, Query_RootPlacement_Group_Slots_AggregateArgs, Query_RootPlacement_Group_Slots_By_PkArgs, Query_RootProcessor_StatusArgs, Scalars, Sdk, SdkFunctionWrapper, String_Comparison_Exp, Subscription_Root, Subscription_RootBlob_ActivitiesArgs, Subscription_RootBlob_Activities_AggregateArgs, Subscription_RootBlob_Activities_By_PkArgs, Subscription_RootBlob_Activities_StreamArgs, Subscription_RootBlobsArgs, Subscription_RootBlobs_AggregateArgs, Subscription_RootBlobs_By_PkArgs, Subscription_RootBlobs_StreamArgs, Subscription_RootPlacement_Group_SlotsArgs, Subscription_RootPlacement_Group_Slots_AggregateArgs, Subscription_RootPlacement_Group_Slots_By_PkArgs, Subscription_RootPlacement_Group_Slots_StreamArgs, Subscription_RootProcessor_StatusArgs, Subscription_RootProcessor_Status_StreamArgs, Timestamp_Comparison_Exp, getSdk } from './operations/generated/sdk.js';
 import '@aptos-labs/ts-sdk';
 import 'zod';
 import '@shelby-protocol/clay-codes';