@shelby-protocol/sdk 0.1.0 → 0.2.1

package/dist/browser/index.d.ts

@@ -4,16 +4,17 @@ export { CHUNK_SIZE_PARAMS, ChunkSizeScheme, DEFAULT_CHUNKSET_SIZE_BYTES, DEFAUL
 export { AckTransactionOptions, BuildOptions, MissingTransactionSubmitterError, ShelbyBlobClient, UsdSponsorOptions, WriteBlobCommitmentsOptions } from '../core/clients/ShelbyBlobClient.js';
 export { ShelbyClient, UploadOptions } from '../core/clients/ShelbyClient.js';
 export { ShelbyClientConfig, ShelbyIndexerConfig, ShelbyRPCConfig } from '../core/clients/ShelbyClientConfig.js';
+export { ShelbyMetadataClient } from '../core/clients/ShelbyMetadataClient.js';
 export { ShelbyMicropaymentChannelClient } from '../core/clients/ShelbyMicropaymentChannelClient.js';
 export { ShelbyPlacementGroupClient } from '../core/clients/ShelbyPlacementGroupClient.js';
 export { BlobDataSource, PutBlobProgress, ShelbyRPCClient } from '../core/clients/ShelbyRPCClient.js';
 export { BlobCommitments, BlobCommitmentsSchema, COMMITMENT_SCHEMA_VERSION, ChunksetCommitment, ChunksetCommitmentSchema, GenerateCommitmentsOptions, expectedTotalChunksets, generateCommitments, generateMerkleRoot } from '../core/commitments.js';
-export { DEFAULT_PROJECT_DESCRIPTION, DEFAULT_PROJECT_NAME, MICROPAYMENTS_DEPLOYER, NetworkToShelbyBlobIndexerBaseUrl, NetworkToShelbyRPCBaseUrl, SHELBYUSD_FA_METADATA_ADDRESS, SHELBYUSD_TOKEN_ADDRESS, SHELBYUSD_TOKEN_MODULE, SHELBYUSD_TOKEN_NAME, SHELBY_DEPLOYER, TOKEN_DEPLOYER, TOKEN_OBJECT_ADDRESS } from '../core/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_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 '../core/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 '../core/erasure/constants.js';
-export { createDefaultErasureCodingProvider } from '../core/erasure/default.js';
+export { createDefaultErasureCodingProvider, defaultErasureCodingConfig, erasureCodingConfig16Total10Data13Helper, erasureCodingConfig4Total2Data3Helper } from '../core/erasure/default.js';
 export { ShelbyErrorCodes, isAccessDeniedError, isBlobAlreadyExistsError, isBlobExpiredError, isBlobNotFoundError } from '../core/errors.js';
-export { BlobName, BlobNameSchema, ChunkKey, allChunksForBlob, roundSize } from '../core/layout.js';
+export { BlobName, BlobNameSchema, ChunkKey } from '../core/layout.js';
 export { ShelbyNetwork, isShelbyNetwork, shelbyNetworks } from '../core/networks.js';
 export { ShelbyIndexerClient, createShelbyIndexerClient, getShelbyIndexerClient } from '../core/operations/index.js';
 export { CompleteMultipartUploadResponse, CompleteMultipartUploadResponseSchema, RPCErrorResponse, RPCErrorResponseSchema, StaleMicropaymentErrorResponse, StaleMicropaymentErrorResponseSchema, StartMultipartUploadResponse, StartMultipartUploadResponseSchema, UploadPartResponse, UploadPartResponseSchema } from '../core/rpc-responses.js';
@@ -22,7 +23,7 @@ export { BlobActivity, BlobActivityType, BlobEncoding, BlobMetadata, ClayEncodin
 export { ChannelInfo, SenderBuiltMicropayment, StaleChannelStateError } from '../core/types/payments.js';
 export { PlacementGroupInfo, PlacementGroupSlot, PlacementGroupSlotStatus } from '../core/types/placement_groups.js';
 export { ActiveStateDetails, FrozenStateDetails, StorageProviderInfo, StorageProviderStateDetails, WaitlistedStateDetails } from '../core/types/storage_providers.js';
-export { buildRequestUrl, concatHashes, getBlobNameSuffix, readInChunks, zeroPadBytes } from '../core/utils.js';
+export { buildRequestUrl, concatHashes, getBlobNameSuffix, normalizeAddress, readInChunks, zeroPadBytes } from '../core/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, 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 '../core/operations/generated/sdk.js';
 import '@aptos-labs/ts-sdk';
 import 'zod';

package/dist/browser/index.mjs

@@ -1,44 +1,50 @@
 import "../chunk-EM67QTMR.mjs";
-import "../chunk-FGUK6IBA.mjs";
+import "../chunk-WTICJPDB.mjs";
+import {
+  ShelbyPlacementGroupClient
+} from "../chunk-W37FZSMA.mjs";
 import {
   ShelbyClient
-} from "../chunk-W6YL46DT.mjs";
+} from "../chunk-5CES6RPZ.mjs";
+import {
+  ShelbyRPCClient
+} from "../chunk-EFR6H3RT.mjs";
 import {
   MissingTransactionSubmitterError,
   ShelbyBlobClient
-} from "../chunk-AGRRYZWV.mjs";
+} from "../chunk-IBAUPQOF.mjs";
 import "../chunk-XNEIWM4O.mjs";
 import {
-  createDefaultErasureCodingProvider
-} from "../chunk-OMZOR2ZF.mjs";
+  ReedSolomonErasureCodingProvider
+} from "../chunk-NHWWORCH.mjs";
 import {
-  ClayErasureCodingProvider
-} from "../chunk-UCDAABAS.mjs";
+  createDefaultErasureCodingProvider,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper
+} from "../chunk-HPPMI7DC.mjs";
 import {
-  ReedSolomonErasureCodingProvider
-} from "../chunk-PZF2VTGP.mjs";
+  ClayErasureCodingProvider
+} from "../chunk-OGKZ575S.mjs";
 import "../chunk-Z7RFCADT.mjs";
+import {
+  ShelbyMetadataClient
+} from "../chunk-7O77OM4T.mjs";
 import {
   ShelbyMicropaymentChannelClient
-} from "../chunk-66GI734H.mjs";
+} from "../chunk-OQNP5QXH.mjs";
 import "../chunk-QQ57OGQ2.mjs";
+import "../chunk-MQUVYMNQ.mjs";
 import "../chunk-ZHXCVRZX.mjs";
 import "../chunk-AD2G3QYD.mjs";
-import "../chunk-MQUVYMNQ.mjs";
-import {
-  ShelbyPlacementGroupClient
-} from "../chunk-MSCUDBMH.mjs";
-import {
-  ShelbyRPCClient
-} from "../chunk-ZAM2EUVN.mjs";
 import {
   SenderBuiltMicropayment,
   StaleChannelStateError
-} from "../chunk-4MG4XGY4.mjs";
+} from "../chunk-KTVNKLBT.mjs";
 import {
   createShelbyIndexerClient,
   getShelbyIndexerClient
-} from "../chunk-3ZL3FSNA.mjs";
+} from "../chunk-CGYJLKBU.mjs";
 import {
   Blob_Activities_Select_Column,
   Blobs_Select_Column,
@@ -56,16 +62,21 @@ import {
   getSdk
 } from "../chunk-KJ24NKPH.mjs";
 import "../chunk-AABBONAF.mjs";
+import {
+  ShelbyErrorCodes,
+  isAccessDeniedError,
+  isBlobAlreadyExistsError,
+  isBlobExpiredError,
+  isBlobNotFoundError
+} from "../chunk-CQ6QPIZK.mjs";
 import {
   BlobNameSchema,
-  ChunkKey,
-  allChunksForBlob,
-  roundSize
-} from "../chunk-W5NRGZEP.mjs";
+  ChunkKey
+} from "../chunk-Z4FZ7W6L.mjs";
 import {
   isShelbyNetwork,
   shelbyNetworks
-} from "../chunk-VRLIOKWG.mjs";
+} from "../chunk-D6GQHO6G.mjs";
 import "../chunk-I6NG5GNL.mjs";
 import {
   CompleteMultipartUploadResponseSchema,
@@ -85,7 +96,7 @@ import {
 } from "../chunk-C6RQ3AEU.mjs";
 import {
   createBlobKey
-} from "../chunk-OTBLZL2S.mjs";
+} from "../chunk-3NRBHSMQ.mjs";
 import {
   BlobCommitmentsSchema,
   COMMITMENT_SCHEMA_VERSION,
@@ -93,21 +104,22 @@ import {
   expectedTotalChunksets,
   generateCommitments,
   generateMerkleRoot
-} from "../chunk-RLRI2533.mjs";
+} from "../chunk-BXEVML7N.mjs";
 import {
   buildRequestUrl,
   concatHashes,
   getBlobNameSuffix,
+  normalizeAddress,
   readInChunks,
   zeroPadBytes
-} from "../chunk-4JZO2D7T.mjs";
+} from "../chunk-UEZNZBJO.mjs";
 import {
   CHUNK_SIZE_PARAMS,
   ChunkSizeScheme,
   DEFAULT_CHUNKSET_SIZE_BYTES,
   DEFAULT_CHUNK_SIZE_BYTES,
   ERASURE_CODE_AND_CHUNK_MAPPING
-} from "../chunk-67F5YZ25.mjs";
+} from "../chunk-JTXYKO3U.mjs";
 import {
   DEFAULT_ERASURE_D,
   DEFAULT_ERASURE_K,
@@ -116,11 +128,12 @@ import {
   DEFAULT_SAMPLE_SIZE,
   ERASURE_CODE_PARAMS,
   ErasureCodingScheme
-} from "../chunk-LZSIZJYR.mjs";
+} from "../chunk-AUQDI5BS.mjs";
 import {
   DEFAULT_PROJECT_DESCRIPTION,
   DEFAULT_PROJECT_NAME,
   MICROPAYMENTS_DEPLOYER,
+  NetworkToGasStationBaseUrl,
   NetworkToShelbyBlobIndexerBaseUrl,
   NetworkToShelbyRPCBaseUrl,
   SHELBYUSD_FA_METADATA_ADDRESS,
@@ -130,14 +143,7 @@ import {
   SHELBY_DEPLOYER,
   TOKEN_DEPLOYER,
   TOKEN_OBJECT_ADDRESS
-} from "../chunk-FLLOQZVD.mjs";
-import {
-  ShelbyErrorCodes,
-  isAccessDeniedError,
-  isBlobAlreadyExistsError,
-  isBlobExpiredError,
-  isBlobNotFoundError
-} from "../chunk-CQ6QPIZK.mjs";
+} from "../chunk-4ZOFT75Q.mjs";
 import "../chunk-7P6ASYW6.mjs";
 export {
   BlobCommitmentsSchema,
@@ -173,6 +179,7 @@ export {
   GetProcessorStatusDocument,
   MICROPAYMENTS_DEPLOYER,
   MissingTransactionSubmitterError,
+  NetworkToGasStationBaseUrl,
   NetworkToShelbyBlobIndexerBaseUrl,
   NetworkToShelbyRPCBaseUrl,
   Order_By,
@@ -189,6 +196,7 @@ export {
   ShelbyBlobClient,
   ShelbyClient,
   ShelbyErrorCodes,
+  ShelbyMetadataClient,
   ShelbyMicropaymentChannelClient,
   ShelbyPlacementGroupClient,
   ShelbyRPCClient,
@@ -198,12 +206,14 @@ export {
   TOKEN_DEPLOYER,
   TOKEN_OBJECT_ADDRESS,
   UploadPartResponseSchema,
-  allChunksForBlob,
   buildRequestUrl,
   concatHashes,
   createBlobKey,
   createDefaultErasureCodingProvider,
   createShelbyIndexerClient,
+  defaultErasureCodingConfig,
+  erasureCodingConfig16Total10Data13Helper,
+  erasureCodingConfig4Total2Data3Helper,
   expectedTotalChunksets,
   generateCommitments,
   generateMerkleRoot,
@@ -220,8 +230,8 @@ export {
   isBlobExpiredError,
   isBlobNotFoundError,
   isShelbyNetwork,
+  normalizeAddress,
   readInChunks,
-  roundSize,
   shelbyNetworks,
   zeroPadBytes
 };

package/dist/{chunk-DI2K6OUG.mjs → chunk-33BZ7KYA.mjs}

@@ -1,6 +1,6 @@
 import {
   ShelbyClient
-} from "./chunk-W6YL46DT.mjs";
+} from "./chunk-5CES6RPZ.mjs";
 
 // src/node/clients/ShelbyNodeClient.ts
 var ShelbyNodeClient = class extends ShelbyClient {

package/dist/chunk-3NRBHSMQ.mjs

@@ -0,0 +1,12 @@
+import {
+  normalizeAddress
+} from "./chunk-UEZNZBJO.mjs";
+
+// src/core/blobs.ts
+var createBlobKey = (params) => {
+  return `@${normalizeAddress(params.account).toStringLongWithoutPrefix()}/${params.blobName}`;
+};
+
+export {
+  createBlobKey
+};

package/dist/{chunk-FLLOQZVD.mjs → chunk-4ZOFT75Q.mjs}

@@ -6,7 +6,7 @@ var NetworkToShelbyRPCBaseUrl = {
   [Network.SHELBYNET]: "https://api.shelbynet.shelby.xyz/shelby",
   [Network.NETNA]: void 0,
   [Network.DEVNET]: void 0,
-  [Network.TESTNET]: void 0,
+  [Network.TESTNET]: "https://api.testnet.shelby.xyz/shelby",
   [Network.MAINNET]: void 0,
   [Network.LOCAL]: void 0,
   [Network.CUSTOM]: void 0
@@ -15,7 +15,16 @@ var NetworkToShelbyBlobIndexerBaseUrl = {
   [Network.SHELBYNET]: "https://api.shelbynet.aptoslabs.com/nocode/v1/public/cmforrguw0042s601fn71f9l2/v1/graphql",
   [Network.NETNA]: void 0,
   [Network.DEVNET]: void 0,
-  [Network.TESTNET]: void 0,
+  [Network.TESTNET]: "https://api.testnet.aptoslabs.com/nocode/v1/public/cmlfqs5wt00qrs601zt5s4kfj/v1/graphql",
+  [Network.MAINNET]: void 0,
+  [Network.LOCAL]: void 0,
+  [Network.CUSTOM]: void 0
+};
+var NetworkToGasStationBaseUrl = {
+  [Network.SHELBYNET]: "https://api.shelbynet.shelby.xyz/gs/v1",
+  [Network.NETNA]: void 0,
+  [Network.DEVNET]: void 0,
+  [Network.TESTNET]: "https://api.testnet.shelby.xyz/gs/v1",
   [Network.MAINNET]: void 0,
   [Network.LOCAL]: void 0,
   [Network.CUSTOM]: void 0
@@ -34,6 +43,7 @@ export {
   DEFAULT_PROJECT_DESCRIPTION,
   NetworkToShelbyRPCBaseUrl,
   NetworkToShelbyBlobIndexerBaseUrl,
+  NetworkToGasStationBaseUrl,
   SHELBY_DEPLOYER,
   MICROPAYMENTS_DEPLOYER,
   TOKEN_DEPLOYER,

package/dist/{chunk-W6YL46DT.mjs → chunk-5CES6RPZ.mjs}

@@ -1,30 +1,39 @@
+import {
+  ShelbyRPCClient
+} from "./chunk-EFR6H3RT.mjs";
 import {
   ShelbyBlobClient
-} from "./chunk-AGRRYZWV.mjs";
+} from "./chunk-IBAUPQOF.mjs";
+import {
+  defaultErasureCodingConfig
+} from "./chunk-HPPMI7DC.mjs";
 import {
   ClayErasureCodingProvider
-} from "./chunk-UCDAABAS.mjs";
+} from "./chunk-OGKZ575S.mjs";
 import {
-  ShelbyRPCClient
-} from "./chunk-ZAM2EUVN.mjs";
+  ShelbyMetadataClient
+} from "./chunk-7O77OM4T.mjs";
 import {
   getAptosConfig
 } from "./chunk-AABBONAF.mjs";
 import {
   createBlobKey
-} from "./chunk-OTBLZL2S.mjs";
+} from "./chunk-3NRBHSMQ.mjs";
 import {
   generateCommitments
-} from "./chunk-RLRI2533.mjs";
+} from "./chunk-BXEVML7N.mjs";
+import {
+  normalizeAddress
+} from "./chunk-UEZNZBJO.mjs";
 import {
   NetworkToShelbyRPCBaseUrl
-} from "./chunk-FLLOQZVD.mjs";
+} from "./chunk-4ZOFT75Q.mjs";
 
 // src/core/clients/ShelbyClient.ts
 import {
-  AccountAddress,
   Aptos,
   DEFAULT_TXN_TIMEOUT_SEC,
+  Network,
   TransactionResponseType
 } from "@aptos-labs/ts-sdk";
 import pLimit from "p-limit";
@@ -34,6 +43,10 @@ var ShelbyClient = class {
    * and metadata for blobs.
    */
   coordination;
+  /**
+   * The metadata client is used for protocol-level metadata queries.
+   */
+  metadata;
   /**
    * The RPC client is used to interact with the Shelby RPC node which can be responsible for storing,
    * confirming, and retrieving blobs from the storage layer.
@@ -85,6 +98,7 @@ var ShelbyClient = class {
     this.config = config;
     this.aptos = new Aptos(getAptosConfig(config));
     this.coordination = new ShelbyBlobClient(config);
+    this.metadata = new ShelbyMetadataClient(config);
     this.rpc = new ShelbyRPCClient(config);
     this._provider = provider;
   }
@@ -94,7 +108,9 @@ var ShelbyClient = class {
    */
   async getProvider() {
     if (!this._provider) {
-      this._provider = await ClayErasureCodingProvider.create();
+      this._provider = await ClayErasureCodingProvider.create(
+        defaultErasureCodingConfig()
+      );
     }
     return this._provider;
   }
@@ -151,6 +167,7 @@ var ShelbyClient = class {
         blobMerkleRoot: blobCommitments.blob_merkle_root,
         size: params.blobData.length,
         expirationMicros: params.expirationMicros,
+        config: provider.config,
         options: params.options
       });
       await this.coordination.aptos.waitForTransaction({
@@ -231,6 +248,7 @@ var ShelbyClient = class {
           blobSize: blob.blobData.length,
           blobMerkleRoot: blobCommitments[index].blob_merkle_root
         })),
+        config: provider.config,
         options: params.options
       });
       await this.coordination.aptos.waitForTransaction({
@@ -288,6 +306,11 @@ var ShelbyClient = class {
    * ```
    */
   async fundAccountWithShelbyUSD(params) {
+    if (this.config.network === Network.TESTNET) {
+      throw new Error(
+        `ShelbyUSD cannot be minted programmatically on ${Network.TESTNET}. Please use the faucet at https://docs.shelby.xyz/apis/faucet/shelbyusd instead.`
+      );
+    }
     const { address, amount } = params;
     try {
       const faucet = this.config.faucet?.baseUrl ?? "https://faucet.shelbynet.shelby.xyz/fund?asset=shelbyusd";
@@ -295,7 +318,7 @@ var ShelbyClient = class {
       const response = await fetch(`${faucet}`, {
         method: "POST",
         body: JSON.stringify({
-          address: AccountAddress.from(address).toString(),
+          address: normalizeAddress(address).toString(),
           amount
         }),
         headers: {

package/dist/{chunk-YZXIPUVQ.mjs → chunk-7O77OM4T.mjs}

@@ -1,25 +1,28 @@
 import {
   getAptosConfig
 } from "./chunk-AABBONAF.mjs";
+import {
+  normalizeAddress
+} from "./chunk-UEZNZBJO.mjs";
 import {
   SHELBY_DEPLOYER
-} from "./chunk-FLLOQZVD.mjs";
+} from "./chunk-4ZOFT75Q.mjs";
 
-// src/node/clients/ShelbyMetadataClient.ts
+// src/core/clients/ShelbyMetadataClient.ts
 import {
   AccountAddress,
   Aptos,
   Hex
 } from "@aptos-labs/ts-sdk";
 function parseStorageProviderState(raw) {
-  switch (raw.variant) {
+  switch (raw.__variant__) {
     case "Active":
       return {
         variant: "Active",
-        quota: raw.Active.quota.value,
-        stakeAtStartOfStakingEpoch: raw.Active.stake_at_start_of_staking_epoch,
-        faulty: raw.Active.faulty,
-        leaving: raw.Active.leaving
+        quota: raw.quota.value,
+        stakeAtStartOfStakingEpoch: raw.stake_at_start_of_staking_epoch,
+        faulty: raw.faulty,
+        leaving: raw.leaving
       };
     case "Waitlisted":
       return {
@@ -28,9 +31,9 @@ function parseStorageProviderState(raw) {
     case "Frozen":
       return {
         variant: "Frozen",
-        frozenReason: raw.Frozen.frozen_reason,
-        frozenFrom: raw.Frozen.frozen_from,
-        frozenTill: raw.Frozen.frozen_till
+        frozenReason: raw.frozen_reason,
+        frozenFrom: raw.frozen_from,
+        frozenTill: raw.frozen_till
       };
   }
 }
@@ -74,11 +77,11 @@ var ShelbyMetadataClient = class {
       });
       const metadata = rawMetadata[0];
       return metadata.map((provider) => ({
-        address: AccountAddress.fromString(provider.address),
+        address: normalizeAddress(provider.address),
         ipAddress: provider.ip_address,
         port: provider.port,
         blsPublicKey: Hex.fromHexInput(provider.bls_public_key).toUint8Array(),
-        failureDomain: provider.failure_domain,
+        availabilityZone: provider.availability_zone,
         state: parseStorageProviderState(provider.state)
       }));
     } catch (error) {
@@ -115,7 +118,7 @@ var ShelbyMetadataClient = class {
         }
       });
       const metadata = addressMetadataArray[0];
-      return metadata.map((pg) => AccountAddress.fromString(pg));
+      return metadata.map((pg) => normalizeAddress(pg));
     } catch (error) {
       if (error instanceof Error && // Depending on the network, the error message may show up differently.
       (error.message?.includes("sub_status: Some(404)") || error.message?.includes("E_PLACEMENT_GROUP_NOT_FOUND"))) {
@@ -150,7 +153,7 @@ var ShelbyMetadataClient = class {
         }
       });
       const metadata = addressMetadataArray[0];
-      return metadata.map((slice) => AccountAddress.fromString(slice));
+      return metadata.map((slice) => normalizeAddress(slice));
     } catch (error) {
       if (error instanceof Error && // Depending on the network, the error message may show up differently.
       (error.message?.includes("sub_status: Some(404)") || error.message?.includes("E_SLICE_NOT_FOUND"))) {
@@ -160,37 +163,113 @@ var ShelbyMetadataClient = class {
     }
   }
   /**
-   * Retrieves the storage providers assigned to a slice, through a placement group.
+   * Gets the placement group address for a slice.
+   *
+   * @param sliceAddress - The address of the slice account.
+   * @returns The placement group address as a string.
+   */
+  async getPlacementGroupAddressForSlice(sliceAddress) {
+    const sliceMetadata = await this.aptos.view({
+      payload: {
+        function: `${this.deployer.toString()}::slice::get_slice_info`,
+        functionArguments: [sliceAddress.toString()]
+      }
+    });
+    return sliceMetadata[0].placement_group_assignments[0].placement_group_address;
+  }
+  /**
+   * Retrieves the designated storage providers for a slice.
+   *
+   * Designated SPs are those appointed to store data for their slots:
+   * - Active: Currently serving data
+   * - Receiving: Receiving data during slot transfer
+   * - Repairing: Repairing data after crash or failed transfer
+   * - Reconstructing: Reconstructing data if the repair fails
    *
    * @param params.account - The address of the slice account.
-   * @returns The list of storage providers for the slice, or an empty array if none exist.
+   * @returns An array where result[i] is the designated SP for slot i, or null if no SP is designated.
    *
    * @example
    * ```typescript
-   * const pgInfo = await client.getStorageProvidersForSlice();
+   * const providers = await client.getDesignatedStorageProvidersForSlice({ account: sliceAddress });
    * ```
    */
-  async getStorageProvidersForSlice(params) {
-    const sliceMetadata = await this.aptos.view({
+  async getDesignatedStorageProvidersForSlice(params) {
+    const placementGroupAddress = await this.getPlacementGroupAddressForSlice(
+      params.account
+    );
+    const rawMetadata = await this.aptos.view({
       payload: {
-        function: `${this.deployer.toString()}::slice::get_slice_info`,
-        functionArguments: [params.account.toString()]
+        function: `${this.deployer.toString()}::placement_group::get_designated_storage_providers`,
+        functionArguments: [placementGroupAddress]
       }
     });
-    const placementGroupAddress = sliceMetadata[0].placement_group_assignments[0].placement_group_address;
+    const providers = rawMetadata[0];
+    return providers.map(
+      (opt) => opt.vec.length > 0 ? normalizeAddress(opt.vec[0]) : null
+    );
+  }
+  /**
+   * Retrieves the active storage providers for a slice.
+   *
+   * Active SPs have a complete copy of the data for the slot, and are not in any data transfer/repair/reconstruction phase.
+   * Active SP can be audited for the data it contains.
+   * Each slot has at most one active SP.
+   *
+   * @param params.account - The address of the slice account.
+   * @returns An array where result[i] is the active SP for slot i, or null if no SP is active.
+   *
+   * @example
+   * ```typescript
+   * const providers = await client.getActiveStorageProvidersForSlice({ account: sliceAddress });
+   * ```
+   */
+  async getActiveStorageProvidersForSlice(params) {
+    const placementGroupAddress = await this.getPlacementGroupAddressForSlice(
+      params.account
+    );
     const rawMetadata = await this.aptos.view({
       payload: {
-        function: `${this.deployer.toString()}::placement_group::get_placement_group_info`,
+        function: `${this.deployer.toString()}::placement_group::get_active_storage_providers`,
         functionArguments: [placementGroupAddress]
       }
     });
-    const members = rawMetadata[0].members;
-    const keys = members.flatMap((m) => {
-      const active = m.active?.vec.map((a) => a.address) ?? [];
-      const others = m.others?.data.map((o) => o.key) ?? [];
-      return [...active, ...others];
+    const providers = rawMetadata[0];
+    return providers.map(
+      (opt) => opt.vec.length > 0 ? normalizeAddress(opt.vec[0]) : null
+    );
+  }
+  /**
+   * Retrieves the serving storage providers for a slice.
+   *
+   * Serving SPs are those that can respond to read requests. The serving logic is:
+   * - If an Active SP exists for a slot: Only the Active SP is serving
+   * - If no Active SP (transition in progress): Both Designated and Vacating SPs serve
+   *
+   * Each slot may have multiple serving SPs during transitions.
+   *
+   * @param params.account - The address of the slice account.
+   * @returns An array where result[i] contains the serving SPs for slot i.
+   *
+   * @example
+   * ```typescript
+   * const providers = await client.getServingStorageProvidersForSlice({ account: sliceAddress });
+   * ```
+   */
+  async getServingStorageProvidersForSlice(params) {
+    const placementGroupAddress = await this.getPlacementGroupAddressForSlice(
+      params.account
+    );
+    const rawMetadata = await this.aptos.view({
+      payload: {
+        function: `${this.deployer.toString()}::placement_group::get_serving_storage_providers`,
+        functionArguments: [placementGroupAddress]
+      }
     });
-    return keys.map((k) => AccountAddress.fromString(k));
+    const providers = rawMetadata[0];
+    return providers.map(
+      (slotProviders) => slotProviders.map((addr) => normalizeAddress(addr))
+    );
   }
 };
 

package/dist/{chunk-LZSIZJYR.mjs → chunk-AUQDI5BS.mjs}

@@ -1,6 +1,7 @@
 // src/core/erasure/constants.ts
 var ErasureCodingScheme = /* @__PURE__ */ ((ErasureCodingScheme2) => {
   ErasureCodingScheme2["ClayCode_16Total_10Data_13Helper"] = "ClayCode_16Total_10Data_13Helper";
+  ErasureCodingScheme2["ClayCode_4Total_2Data_3Helper"] = "ClayCode_4Total_2Data_3Helper";
   return ErasureCodingScheme2;
 })(ErasureCodingScheme || {});
 var ERASURE_CODE_PARAMS = {
@@ -10,7 +11,19 @@ var ERASURE_CODE_PARAMS = {
     // data chunks
     erasure_k: 10,
     // helper nodes
-    erasure_d: 13
+    erasure_d: 13,
+    // enum index
+    enumIndex: 0
+  },
+  ["ClayCode_4Total_2Data_3Helper" /* ClayCode_4Total_2Data_3Helper */]: {
+    // total chunks (data + parity)
+    erasure_n: 4,
+    // data chunks
+    erasure_k: 2,
+    // helper nodes
+    erasure_d: 3,
+    // enum index
+    enumIndex: 1
   }
 };
 var DEFAULT_ERASURE_N = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_n;

package/dist/{chunk-RLRI2533.mjs → chunk-BXEVML7N.mjs}

@@ -2,14 +2,14 @@ import {
   concatHashes,
   readInChunks,
   zeroPadBytes
-} from "./chunk-4JZO2D7T.mjs";
+} from "./chunk-UEZNZBJO.mjs";
 import {
   DEFAULT_CHUNKSET_SIZE_BYTES
-} from "./chunk-67F5YZ25.mjs";
+} from "./chunk-JTXYKO3U.mjs";
 import {
   DEFAULT_ERASURE_K,
   DEFAULT_ERASURE_M
-} from "./chunk-LZSIZJYR.mjs";
+} from "./chunk-AUQDI5BS.mjs";
 
 // src/core/commitments.ts
 import { Hex } from "@aptos-labs/ts-sdk";
@@ -111,7 +111,7 @@ async function generateChunksetCommitments(shouldPad, chunksetIdx, chunksetData,
   return { h: a, entry };
 }
 async function generateCommitments(provider, fullData, onChunk, options) {
-  const expectedChunksetSize = DEFAULT_CHUNKSET_SIZE_BYTES;
+  const expectedChunksetSize = provider.config.chunkSizeBytes * provider.config.erasure_k;
   const shouldPad = options?.pad ?? true;
   const chunksetCommitments = [];
   const chunksetCommitmentHashes = [];