@shelby-protocol/sdk 0.2.4 → 0.3.1

package/dist/chunk-7OV5ZYW6.mjs

@@ -1,55 +0,0 @@
-// src/core/constants.ts
-import { Network } from "@aptos-labs/ts-sdk";
-var DEFAULT_PROJECT_NAME = "shelby";
-var DEFAULT_PROJECT_DESCRIPTION = "High performance, decentralized storage";
-var NetworkToShelbyRPCBaseUrl = {
-  [Network.SHELBYNET]: "https://api.shelbynet.shelby.xyz/shelby",
-  [Network.NETNA]: void 0,
-  [Network.DEVNET]: void 0,
-  [Network.TESTNET]: "https://api.testnet.shelby.xyz/shelby",
-  [Network.MAINNET]: void 0,
-  [Network.LOCAL]: void 0,
-  [Network.CUSTOM]: void 0
-};
-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]: "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
-};
-var SHELBY_DEPLOYER = "0x85fdb9a176ab8ef1d9d9c1b60d60b3924f0800ac1de1cc2085fb0b8bb4988e6a";
-var MICROPAYMENTS_DEPLOYER = "0x1ae7275148bf6ef742b658fd9cbcc2e094201606f4a7bc707bab0201da8043ee";
-var TOKEN_DEPLOYER = "0x33009e852be7f93762dd0bf303383c2cb2c5cab7a30d8238ca5f9f177ae75124";
-var TOKEN_OBJECT_ADDRESS = "0x249f5c642a63885ff88a5113b3ba0079840af5a1357706f8c7f3bfc5dd12511f";
-var SHELBYUSD_TOKEN_ADDRESS = TOKEN_OBJECT_ADDRESS;
-var SHELBYUSD_TOKEN_MODULE = "shelby_usd";
-var SHELBYUSD_TOKEN_NAME = "ShelbyUSD";
-var SHELBYUSD_FA_METADATA_ADDRESS = "0x1b18363a9f1fe5e6ebf247daba5cc1c18052bb232efdc4c50f556053922d98e1";
-
-export {
-  DEFAULT_PROJECT_NAME,
-  DEFAULT_PROJECT_DESCRIPTION,
-  NetworkToShelbyRPCBaseUrl,
-  NetworkToShelbyBlobIndexerBaseUrl,
-  NetworkToGasStationBaseUrl,
-  SHELBY_DEPLOYER,
-  MICROPAYMENTS_DEPLOYER,
-  TOKEN_DEPLOYER,
-  TOKEN_OBJECT_ADDRESS,
-  SHELBYUSD_TOKEN_ADDRESS,
-  SHELBYUSD_TOKEN_MODULE,
-  SHELBYUSD_TOKEN_NAME,
-  SHELBYUSD_FA_METADATA_ADDRESS
-};

package/dist/chunk-7P6ASYW6.mjs

@@ -1,9 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};

package/dist/chunk-A4IG6GSE.mjs

@@ -1,21 +0,0 @@
-import {
-  __export
-} from "./chunk-7P6ASYW6.mjs";
-
-// src/node/testUtil.ts
-var testUtil_exports = {};
-__export(testUtil_exports, {
-  makeChunk: () => makeChunk
-});
-function makeChunk(n) {
-  const c = Buffer.alloc(n);
-  for (let i = 0; i < n; ++i) {
-    c[i] = i % 256;
-  }
-  return c;
-}
-
-export {
-  makeChunk,
-  testUtil_exports
-};

package/dist/chunk-AEDVYYGD.mjs

@@ -1,11 +0,0 @@
-import {
-  ShelbyClient
-} from "./chunk-3PCG7PNP.mjs";
-
-// src/node/clients/ShelbyNodeClient.ts
-var ShelbyNodeClient = class extends ShelbyClient {
-};
-
-export {
-  ShelbyNodeClient
-};

package/dist/chunk-AUQDI5BS.mjs

@@ -1,43 +0,0 @@
-// 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 = {
-  ["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */]: {
-    // total chunks (data + parity)
-    erasure_n: 16,
-    // data chunks
-    erasure_k: 10,
-    // helper nodes
-    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;
-var DEFAULT_ERASURE_K = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_k;
-var DEFAULT_ERASURE_D = ERASURE_CODE_PARAMS["ClayCode_16Total_10Data_13Helper" /* ClayCode_16Total_10Data_13Helper */].erasure_d;
-var DEFAULT_ERASURE_M = DEFAULT_ERASURE_N - DEFAULT_ERASURE_K;
-var DEFAULT_SAMPLE_SIZE = 1024;
-
-export {
-  ErasureCodingScheme,
-  ERASURE_CODE_PARAMS,
-  DEFAULT_ERASURE_N,
-  DEFAULT_ERASURE_K,
-  DEFAULT_ERASURE_D,
-  DEFAULT_ERASURE_M,
-  DEFAULT_SAMPLE_SIZE
-};

package/dist/chunk-BDSW5PHM.mjs

@@ -1,37 +0,0 @@
-// src/core/shelby-explorer.ts
-import { Network } from "@aptos-labs/ts-sdk";
-function getShelbyExplorerBaseUrl(network) {
-  const normalizedNetwork = network.toLowerCase();
-  switch (normalizedNetwork) {
-    case Network.MAINNET.toLowerCase():
-      return "https://explorer.shelby.xyz/mainnet";
-    case Network.TESTNET.toLowerCase():
-      return "https://explorer.shelby.xyz/testnet";
-    case Network.DEVNET.toLowerCase():
-      return "https://explorer.shelby.xyz/devnet";
-    case Network.LOCAL.toLowerCase():
-      return "https://explorer.shelby.xyz/local";
-    case Network.SHELBYNET.toLowerCase():
-      return "https://explorer.shelby.xyz/shelbynet";
-    default:
-      return `https://explorer.shelby.xyz/${normalizedNetwork}`;
-  }
-}
-function getShelbyAccountBlobsExplorerUrl(network, accountAddress) {
-  const baseUrl = getShelbyExplorerBaseUrl(network);
-  return `${baseUrl}/account/${accountAddress}/blobs`;
-}
-function getShelbyBlobExplorerUrl(network, accountAddress, blobName) {
-  const baseUrl = getShelbyExplorerBaseUrl(network);
-  return `${baseUrl}/account/${accountAddress}/blob/${encodeURIComponent(blobName)}`;
-}
-function getShelbyAccountExplorerUrl(network, accountAddress) {
-  const baseUrl = getShelbyExplorerBaseUrl(network);
-  return `${baseUrl}/account/${accountAddress}`;
-}
-
-export {
-  getShelbyAccountBlobsExplorerUrl,
-  getShelbyBlobExplorerUrl,
-  getShelbyAccountExplorerUrl
-};

package/dist/chunk-BKL7NCUB.mjs

@@ -1,412 +0,0 @@
-import {
-  StaleChannelStateError
-} from "./chunk-TVLV7C74.mjs";
-import {
-  getShelbyIndexerClient
-} from "./chunk-KYQRWJ3U.mjs";
-import {
-  getShelbyRPCBaseUrl
-} from "./chunk-IKRWBDG5.mjs";
-import {
-  sleep
-} from "./chunk-I6NG5GNL.mjs";
-import {
-  StaleMicropaymentErrorResponseSchema,
-  StartMultipartUploadResponseSchema
-} from "./chunk-IE6LYVIA.mjs";
-import {
-  buildRequestUrl,
-  normalizeAddress,
-  readInChunks
-} from "./chunk-UEZNZBJO.mjs";
-import {
-  BlobNameSchema
-} from "./chunk-Z4FZ7W6L.mjs";
-
-// src/core/clients/ShelbyRPCClient.ts
-var MICROPAYMENT_HEADER = "X-Shelby-Micropayment";
-function encodeURIComponentKeepSlashes(str) {
-  return encodeURIComponent(str).replace(/%2F/g, "/");
-}
-function validateTotalBytes(totalBytes) {
-  if (!Number.isInteger(totalBytes) || totalBytes < 0) {
-    throw new Error("totalBytes must be a non-negative integer");
-  }
-}
-function getErrorCode(error) {
-  if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string") {
-    return error.code;
-  }
-  if (error instanceof Error) {
-    const match = error.message.match(/\bE[A-Z0-9_]+\b/);
-    return match?.[0];
-  }
-  return void 0;
-}
-var ShelbyRPCClient = class {
-  baseUrl;
-  apiKey;
-  rpcConfig;
-  indexer;
-  /**
-   * Creates a new ShelbyRPCClient for interacting with Shelby RPC nodes.
-   * This client handles blob storage operations including upload and download.
-   *
-   * @param config - The client configuration object.
-   * @param config.network - The Shelby network to use.
-   *
-   * @example
-   * ```typescript
-   * const client = new ShelbyRPCClient({
-   *   network: Network.SHELBYNET,
-   *   apiKey: "AG-***",
-   * });
-   * ```
-   */
-  constructor(config) {
-    this.baseUrl = getShelbyRPCBaseUrl(config);
-    this.apiKey = config.apiKey ?? config.rpc?.apiKey;
-    this.rpcConfig = config.rpc ?? {};
-    this.indexer = getShelbyIndexerClient(config);
-  }
-  async #uploadPart(uploadId, partIdx, partData) {
-    const nRetries = 5;
-    let lastResponse;
-    let lastError;
-    const partUrl = buildRequestUrl(
-      `/v1/multipart-uploads/${uploadId}/parts/${partIdx}`,
-      this.baseUrl
-    );
-    for (let i = 0; i < nRetries; ++i) {
-      try {
-        lastResponse = await fetch(partUrl, {
-          method: "PUT",
-          headers: {
-            "Content-Type": "application/octet-stream",
-            ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-          },
-          body: partData
-        });
-        lastError = void 0;
-      } catch (error) {
-        lastError = error;
-        if (i < nRetries - 1) {
-          const delay = 2 ** i * 100;
-          await sleep(delay);
-          continue;
-        }
-        break;
-      }
-      if (lastResponse.ok) return;
-      if (i < nRetries - 1) {
-        const delay = 2 ** i * 100;
-        await sleep(delay);
-      }
-    }
-    if (lastError !== void 0) {
-      const errorCode = getErrorCode(lastError);
-      const errorMessage = lastError instanceof Error ? lastError.message : String(lastError);
-      throw new Error(
-        `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${nRetries} attempts. The connection to the Shelby RPC endpoint was interrupted while sending data${errorCode ? ` (${errorCode})` : ""}. Endpoint: ${partUrl.toString()}, partBytes: ${partData.length}. Last error: ${errorMessage}`,
-        { cause: lastError }
-      );
-    }
-    const errorBody = await lastResponse?.text().catch(() => "");
-    throw new Error(
-      `Failed to upload part ${partIdx} for multipart upload ${uploadId} after ${nRetries} attempts. status: ${lastResponse?.status}, body: ${errorBody}`
-    );
-  }
-  async #putBlobMultipart(account, blobName, blobData, totalBytes, partSize = 5 * 1024 * 1024, onProgress) {
-    validateTotalBytes(totalBytes);
-    const startResponse = await fetch(
-      buildRequestUrl("/v1/multipart-uploads", this.baseUrl),
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-        },
-        body: JSON.stringify({
-          rawAccount: account.toString(),
-          rawBlobName: blobName,
-          rawPartSize: partSize
-        })
-      }
-    );
-    if (!startResponse.ok) {
-      let errorBodyText = "Could not read error body";
-      try {
-        errorBodyText = await startResponse.text();
-      } catch (_e) {
-      }
-      throw new Error(
-        `Failed to start multipart upload! status: ${startResponse.status}, body: ${errorBodyText}`
-      );
-    }
-    const { uploadId } = StartMultipartUploadResponseSchema.parse(
-      await startResponse.json()
-    );
-    const totalParts = Math.ceil(totalBytes / partSize);
-    let uploadedBytes = 0;
-    for await (const [partIdx, partData] of readInChunks(blobData, partSize)) {
-      await this.#uploadPart(uploadId, partIdx, partData);
-      uploadedBytes += partData.length;
-      onProgress?.({
-        phase: "uploading",
-        partIdx,
-        totalParts,
-        partBytes: partData.length,
-        uploadedBytes,
-        totalBytes
-      });
-    }
-    if (uploadedBytes !== totalBytes) {
-      throw new Error(
-        `Uploaded bytes (${uploadedBytes}) did not match declared totalBytes (${totalBytes})`
-      );
-    }
-    const finalPartIdx = totalParts > 0 ? totalParts - 1 : 0;
-    onProgress?.({
-      phase: "finalizing",
-      partIdx: finalPartIdx,
-      totalParts,
-      // no part uploaded in this phase
-      partBytes: 0,
-      uploadedBytes: totalBytes,
-      totalBytes
-    });
-    const completeResponse = await fetch(
-      buildRequestUrl(
-        `/v1/multipart-uploads/${uploadId}/complete`,
-        this.baseUrl
-      ),
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
-        }
-      }
-    );
-    if (!completeResponse.ok) {
-      let errorBodyText = "Could not read error body";
-      try {
-        errorBodyText = await completeResponse.text();
-      } catch (_e) {
-      }
-      throw new Error(
-        `Failed to complete multipart upload! status: ${completeResponse.status}, body: ${errorBodyText}`
-      );
-    }
-  }
-  /**
-   * Uploads blob data to the Shelby RPC node for storage by storage providers.
-   * This method should be called after blob commitments have been registered on the blockchain.
-   * Uses multipart upload for efficient handling of large files.
-   *
-   * @param params.account - The account that owns the blob.
-   * @param params.blobName - The name/path of the blob (e.g. "folder/file.txt").
-   * @param params.blobData - The raw blob data as a Uint8Array or ReadableStream.
-   * @param params.totalBytes - Total byte length. Required for streams; optional for Uint8Array.
-   *
-   * @example
-   * ```typescript
-   * const blobData = new TextEncoder().encode("Hello, world!");
-   *
-   * await client.putBlob({
-   *   account: AccountAddress.from("0x1"),
-   *   blobName: "greetings/hello.txt",
-   *   blobData,
-   * });
-   * ```
-   */
-  async putBlob(params) {
-    BlobNameSchema.parse(params.blobName);
-    let totalBytes;
-    if (params.blobData instanceof Uint8Array) {
-      totalBytes = params.totalBytes ?? params.blobData.length;
-      if (totalBytes !== params.blobData.length) {
-        throw new Error(
-          "totalBytes must match blobData.length when blobData is a Uint8Array"
-        );
-      }
-    } else {
-      if (params.totalBytes === void 0) {
-        throw new Error(
-          "totalBytes is required when blobData is a ReadableStream"
-        );
-      }
-      totalBytes = params.totalBytes;
-    }
-    validateTotalBytes(totalBytes);
-    await this.#putBlobMultipart(
-      params.account,
-      params.blobName,
-      params.blobData,
-      totalBytes,
-      void 0,
-      params.onProgress
-    );
-  }
-  /**
-   * Downloads a blob from the Shelby RPC node.
-   * Returns a streaming response with validation to ensure data integrity.
-   *
-   * @param params.account - The account that owns the blob.
-   * @param params.blobName - The name/path of the blob (e.g. "folder/file.txt").
-   * @param params.range - Optional byte range for partial downloads.
-   * @param params.range.start - Starting byte position (inclusive).
-   * @param params.range.end - Ending byte position (inclusive, optional).
-   * @param params.micropayment - Optional micropayment to attach to the request.
-   *
-   * @returns A ShelbyBlob object containing the account, name, readable stream, and content length.
-   *
-   * @throws Error if the download fails or content length doesn't match.
-   * @throws StaleChannelStateError if the micropayment is stale (server has newer state).
-   *
-   * @example
-   * ```typescript
-   * // Download entire blob
-   * const blob = await client.getBlob({
-   *   account: AccountAddress.from("0x1"),
-   *   blobName: "documents/report.pdf"
-   * });
-   *
-   * // Download partial content (bytes 100-199)
-   * const partial = await client.getBlob({
-   *   account: AccountAddress.from("0x1"),
-   *   blobName: "large-file.bin",
-   *   range: { start: 100, end: 199 }
-   * });
-   *
-   * // Download with micropayment
-   * const blob = await client.getBlob({
-   *   account: AccountAddress.from("0x1"),
-   *   blobName: "documents/report.pdf",
-   *   micropayment: senderBuiltMicropayment
-   * });
-   * ```
-   */
-  async getBlob(params) {
-    BlobNameSchema.parse(params.blobName);
-    const url = buildRequestUrl(
-      `/v1/blobs/${params.account.toString()}/${encodeURIComponentKeepSlashes(
-        params.blobName
-      )}`,
-      this.baseUrl
-    );
-    const headers = new Headers();
-    if (params.range !== void 0) {
-      const { start, end } = params.range;
-      if (end === void 0) {
-        headers.set("Range", `bytes=${start}-`);
-      } else {
-        if (end < start) {
-          throw new Error("Range end cannot be less than start.");
-        }
-        headers.set("Range", `bytes=${start}-${end}`);
-      }
-    }
-    if (this.apiKey) {
-      headers.set("Authorization", `Bearer ${this.apiKey}`);
-    }
-    if (params.micropayment) {
-      const bytes = params.micropayment.bcsToBytes();
-      const binaryString = Array.from(
-        bytes,
-        (byte) => String.fromCharCode(byte)
-      ).join("");
-      headers.set(MICROPAYMENT_HEADER, btoa(binaryString));
-    }
-    const response = await fetch(url, { headers });
-    if (response.status === 409) {
-      let json;
-      try {
-        json = await response.json();
-      } catch {
-        throw new Error(
-          `Failed to download blob: ${response.status} ${response.statusText}`
-        );
-      }
-      const parseResult = StaleMicropaymentErrorResponseSchema.safeParse(json);
-      if (!parseResult.success) {
-        throw new Error(
-          `Failed to download blob: ${response.status} ${response.statusText}`
-        );
-      }
-      const errorBody = parseResult.data;
-      if (errorBody.storedMicropayment) {
-        throw StaleChannelStateError.fromBase64(
-          errorBody.storedMicropayment,
-          errorBody.error
-        );
-      }
-      throw new Error(
-        errorBody.error ?? `Failed to download blob: ${response.status} ${response.statusText}`
-      );
-    }
-    if (!response.ok) {
-      throw new Error(
-        `Failed to download blob: ${response.status} ${response.statusText}`
-      );
-    }
-    if (!response.body) {
-      throw new Error("Response body is null");
-    }
-    const contentLengthHeader = response.headers.get("content-length");
-    if (contentLengthHeader === null) {
-      throw new Error(
-        "Response did not have content-length header, which is required"
-      );
-    }
-    const expectedContentLength = Number.parseInt(contentLengthHeader, 10);
-    if (Number.isNaN(expectedContentLength)) {
-      throw new Error(
-        `Invalid content-length header received: ${contentLengthHeader}`
-      );
-    }
-    const validatingStream = new ReadableStream({
-      start(controller) {
-        const maybeReader = response.body?.getReader();
-        if (!maybeReader) {
-          controller.error(new Error("Response body reader is unavailable"));
-          return;
-        }
-        const reader = maybeReader;
-        let bytesReceived = 0;
-        function pump() {
-          return reader.read().then(({ done, value }) => {
-            if (done) {
-              if (bytesReceived !== expectedContentLength) {
-                controller.error(
-                  new Error(
-                    `Downloaded data size (${bytesReceived} bytes) does not match content-length header (${expectedContentLength} bytes). This might indicate a partial or corrupted download.`
-                  )
-                );
-                return;
-              }
-              controller.close();
-              return;
-            }
-            bytesReceived += value.byteLength;
-            controller.enqueue(value);
-            return pump();
-          }).catch((error) => {
-            controller.error(error);
-          });
-        }
-        return pump();
-      }
-    });
-    return {
-      account: normalizeAddress(params.account),
-      name: params.blobName,
-      readable: validatingStream,
-      contentLength: expectedContentLength
-    };
-  }
-};
-
-export {
-  ShelbyRPCClient
-};