@shelby-protocol/sdk 0.2.4 → 0.3.1

package/dist/core/rpc-responses.d.ts

@@ -7,6 +7,43 @@ import { z } from 'zod';
  * Both the server (apps/server) and SDK client (ShelbyRPCClient) should use
  * these schemas to ensure type safety and runtime validation.
  */
+/**
+ * Response from POST /v1/auth/challenge
+ */
+declare const ChallengeResponseSchema: z.ZodObject<{
+    challenge: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    challenge: string;
+    expiresAt: number;
+}, {
+    challenge: string;
+    expiresAt: number;
+}>;
+type ChallengeResponse = z.infer<typeof ChallengeResponseSchema>;
+/**
+ * Response from GET /v1/multipart-uploads?account=X&blobName=Y
+ */
+declare const MultipartUploadStatusResponseSchema: z.ZodObject<{
+    uploadId: z.ZodString;
+    completedParts: z.ZodArray<z.ZodNumber, "many">;
+    partSize: z.ZodNumber;
+    nParts: z.ZodNumber;
+    uploadedBytes: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    uploadId: string;
+    completedParts: number[];
+    partSize: number;
+    nParts: number;
+    uploadedBytes: number;
+}, {
+    uploadId: string;
+    completedParts: number[];
+    partSize: number;
+    nParts: number;
+    uploadedBytes: number;
+}>;
+type MultipartUploadStatusResponse = z.infer<typeof MultipartUploadStatusResponseSchema>;
 /**
  * Response from POST /v1/multipart-uploads
  */
@@ -66,4 +103,4 @@ declare const StaleMicropaymentErrorResponseSchema: z.ZodObject<{
 }>;
 type StaleMicropaymentErrorResponse = z.infer<typeof StaleMicropaymentErrorResponseSchema>;
 
-export { type CompleteMultipartUploadResponse, CompleteMultipartUploadResponseSchema, type RPCErrorResponse, RPCErrorResponseSchema, type StaleMicropaymentErrorResponse, StaleMicropaymentErrorResponseSchema, type StartMultipartUploadResponse, StartMultipartUploadResponseSchema, type UploadPartResponse, UploadPartResponseSchema };
+export { type ChallengeResponse, ChallengeResponseSchema, type CompleteMultipartUploadResponse, CompleteMultipartUploadResponseSchema, type MultipartUploadStatusResponse, MultipartUploadStatusResponseSchema, type RPCErrorResponse, RPCErrorResponseSchema, type StaleMicropaymentErrorResponse, StaleMicropaymentErrorResponseSchema, type StartMultipartUploadResponse, StartMultipartUploadResponseSchema, type UploadPartResponse, UploadPartResponseSchema };

package/dist/core/rpc-responses.mjs

@@ -1,13 +1,36 @@
-import {
-  CompleteMultipartUploadResponseSchema,
-  RPCErrorResponseSchema,
-  StaleMicropaymentErrorResponseSchema,
-  StartMultipartUploadResponseSchema,
-  UploadPartResponseSchema
-} from "../chunk-IE6LYVIA.mjs";
-import "../chunk-7P6ASYW6.mjs";
+// src/core/rpc-responses.ts
+import { z } from "zod";
+var ChallengeResponseSchema = z.object({
+  challenge: z.string(),
+  expiresAt: z.number()
+});
+var MultipartUploadStatusResponseSchema = z.object({
+  uploadId: z.string(),
+  completedParts: z.array(z.number()),
+  partSize: z.number(),
+  nParts: z.number(),
+  uploadedBytes: z.number()
+});
+var StartMultipartUploadResponseSchema = z.object({
+  uploadId: z.string()
+});
+var UploadPartResponseSchema = z.object({
+  success: z.literal(true)
+});
+var CompleteMultipartUploadResponseSchema = z.object({
+  success: z.literal(true)
+});
+var RPCErrorResponseSchema = z.object({
+  error: z.string()
+});
+var StaleMicropaymentErrorResponseSchema = z.object({
+  error: z.string().optional(),
+  storedMicropayment: z.string().optional()
+});
 export {
+  ChallengeResponseSchema,
   CompleteMultipartUploadResponseSchema,
+  MultipartUploadStatusResponseSchema,
   RPCErrorResponseSchema,
   StaleMicropaymentErrorResponseSchema,
   StartMultipartUploadResponseSchema,

package/dist/core/shelby-explorer.mjs

@@ -1,9 +1,34 @@
-import {
-  getShelbyAccountBlobsExplorerUrl,
-  getShelbyAccountExplorerUrl,
-  getShelbyBlobExplorerUrl
-} from "../chunk-BDSW5PHM.mjs";
-import "../chunk-7P6ASYW6.mjs";
+// 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,
   getShelbyAccountExplorerUrl,

package/dist/core/strings.mjs

@@ -1,5 +1,3 @@
-import "../chunk-7P6ASYW6.mjs";
-
 // src/core/strings.ts
 var ciEquals = (a, b) => {
   return a.toLowerCase() === b.toLowerCase();

package/dist/core/types/blobs.d.ts

@@ -1,5 +1,5 @@
 import { AccountAddress } from '@aptos-labs/ts-sdk';
-import { c as ClayProviderOptions } from '../../clay-codes-DHP-bYcP.js';
+import { c as ClayProviderOptions } from '../../clay-codes-DdXABBDx.js';
 import { BlobName } from '../layout.js';
 import '@shelby-protocol/clay-codes';
 import 'zod';

package/dist/core/types/blobs.mjs

@@ -1 +0,0 @@
-import "../../chunk-ZHXCVRZX.mjs";

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

@@ -3,7 +3,7 @@ export { ChannelInfo, SenderBuiltMicropayment, StaleChannelStateError } from './
 export { PlacementGroupInfo, PlacementGroupSlot, PlacementGroupSlotStatus } from './placement_groups.js';
 export { ActiveStateDetails, FrozenStateDetails, StorageProviderInfo, StorageProviderStateDetails, WaitlistedStateDetails } from './storage_providers.js';
 import '@aptos-labs/ts-sdk';
-import '../../clay-codes-DHP-bYcP.js';
+import '../../clay-codes-DdXABBDx.js';
 import '@shelby-protocol/clay-codes';
 import '../layout.js';
 import 'zod';

package/dist/core/types/index.mjs

@@ -1,13 +1,234 @@
-import "../../chunk-QQ57OGQ2.mjs";
-import "../../chunk-ZHXCVRZX.mjs";
-import "../../chunk-AD2G3QYD.mjs";
-import "../../chunk-MQUVYMNQ.mjs";
+// src/core/types/payments.ts
 import {
-  SenderBuiltMicropayment,
-  StaleChannelStateError
-} from "../../chunk-TVLV7C74.mjs";
-import "../../chunk-7OV5ZYW6.mjs";
-import "../../chunk-7P6ASYW6.mjs";
+  AccountAddress,
+  Deserializer,
+  Hex,
+  Serializer
+} from "@aptos-labs/ts-sdk";
+
+// src/core/constants.ts
+import { Network } from "@aptos-labs/ts-sdk";
+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]: "http://localhost:9090",
+  [Network.CUSTOM]: void 0
+};
+var NetworkToShelbyBlobIndexerBaseUrl = {
+  [Network.SHELBYNET]: "https://api.shelbynet.aptoslabs.com/nocode/v1/public/alias/shelby/shelbynet/v1/graphql",
+  [Network.NETNA]: void 0,
+  [Network.DEVNET]: void 0,
+  [Network.TESTNET]: "https://api.testnet.aptoslabs.com/nocode/v1/public/alias/shelby/testnet/v1/graphql",
+  [Network.MAINNET]: void 0,
+  [Network.LOCAL]: "http://localhost:8091/v1/graphql",
+  [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 MICROPAYMENTS_DEPLOYER = "0x1ae7275148bf6ef742b658fd9cbcc2e094201606f4a7bc707bab0201da8043ee";
+
+// src/core/types/payments.ts
+var MICROPAYMENTS_MODULE_NAME = "micropayments";
+var WITHDRAW_APPROVAL_STRUCT_NAME = "WithdrawApproval";
+function serializeTypeInfo(serializer, moduleAddress, moduleName, structName) {
+  moduleAddress.serialize(serializer);
+  const moduleNameBytes = new TextEncoder().encode(moduleName);
+  serializer.serializeBytes(moduleNameBytes);
+  const structNameBytes = new TextEncoder().encode(structName);
+  serializer.serializeBytes(structNameBytes);
+}
+var StaleChannelStateError = class _StaleChannelStateError extends Error {
+  /**
+   * The last valid micropayment stored by the server.
+   * Clients can use this to reset their local channel state.
+   */
+  storedMicropayment;
+  constructor(storedMicropayment, message) {
+    super(
+      message ?? "Client has stale channel state. Use the returned micropayment to reset local state."
+    );
+    this.name = "StaleChannelStateError";
+    this.storedMicropayment = storedMicropayment;
+  }
+  /**
+   * Returns the stored micropayment as a base64-encoded string.
+   */
+  toBase64() {
+    const bytes = this.storedMicropayment.bcsToBytes();
+    const binaryString = Array.from(
+      bytes,
+      (byte) => String.fromCharCode(byte)
+    ).join("");
+    return btoa(binaryString);
+  }
+  /**
+   * Creates a StaleChannelStateError from a base64-encoded micropayment string.
+   */
+  static fromBase64(base64, message) {
+    const binaryString = atob(base64);
+    const bytes = Uint8Array.from(binaryString, (char) => char.charCodeAt(0));
+    const micropayment = SenderBuiltMicropayment.deserialize(bytes);
+    return new _StaleChannelStateError(micropayment, message);
+  }
+};
+var SenderBuiltMicropayment = class _SenderBuiltMicropayment {
+  /**
+   * The sender's address (owner of the payment channel).
+   */
+  sender;
+  /**
+   * The receiver's address (beneficiary of the withdrawal).
+   */
+  receiver;
+  /**
+   * The unique ID of the payment channel.
+   */
+  paymentChannelId;
+  /**
+   * The cumulative amount the receiver is authorized to withdraw.
+   */
+  amount;
+  /**
+   * The fungible asset metadata address.
+   */
+  fungibleAssetAddress;
+  /**
+   * Monotonically increasing sequence number for replay protection.
+   */
+  sequenceNumber;
+  /**
+   * The sender's Ed25519 public key (32 bytes).
+   * Used by the receiver to verify the signature before submitting.
+   */
+  publicKey;
+  /**
+   * The Ed25519 signature of the SignedMessage<WithdrawApproval> struct.
+   * The SignedMessage includes TypeInfo for domain separation.
+   */
+  signature;
+  /**
+   * The deployer address of the micropayments module.
+   * This is needed to reconstruct the TypeInfo for signature verification.
+   */
+  deployer;
+  constructor(sender, receiver, paymentChannelId, amount, fungibleAssetAddress, sequenceNumber, publicKey, signature, deployer) {
+    this.sender = sender;
+    this.receiver = receiver;
+    this.paymentChannelId = paymentChannelId;
+    this.amount = amount;
+    this.fungibleAssetAddress = fungibleAssetAddress;
+    this.sequenceNumber = sequenceNumber;
+    this.publicKey = publicKey;
+    this.signature = signature;
+    this.deployer = deployer ?? AccountAddress.fromString(MICROPAYMENTS_DEPLOYER);
+  }
+  /**
+   * Creates the BCS-serialized message that was signed.
+   * This is a SignedMessage<WithdrawApproval> which includes:
+   * 1. TypeInfo (module_address, module_name, struct_name)
+   * 2. WithdrawApproval struct fields
+   *
+   * This format is used with signature_verify_strict_t for domain separation.
+   */
+  getSignedMessage() {
+    return _SenderBuiltMicropayment.buildSignedMessage({
+      deployer: this.deployer,
+      sender: this.sender,
+      receiver: this.receiver,
+      fungibleAssetAddress: this.fungibleAssetAddress,
+      amount: this.amount,
+      paymentChannelId: this.paymentChannelId,
+      sequenceNumber: this.sequenceNumber
+    });
+  }
+  /**
+   * Static helper to build the SignedMessage<WithdrawApproval> bytes from raw parameters.
+   * This can be used to create the message for signing without constructing the full object.
+   *
+   * @param params - The withdrawal approval parameters.
+   * @returns The BCS-serialized SignedMessage<WithdrawApproval> bytes.
+   */
+  static buildSignedMessage(params) {
+    const serializer = new Serializer();
+    serializeTypeInfo(
+      serializer,
+      params.deployer,
+      MICROPAYMENTS_MODULE_NAME,
+      WITHDRAW_APPROVAL_STRUCT_NAME
+    );
+    params.sender.serialize(serializer);
+    params.receiver.serialize(serializer);
+    params.fungibleAssetAddress.serialize(serializer);
+    serializer.serializeU64(params.amount);
+    serializer.serializeU64(params.paymentChannelId);
+    serializer.serializeU64(params.sequenceNumber);
+    return serializer.toUint8Array();
+  }
+  serialize(serializer) {
+    this.sender.serialize(serializer);
+    this.receiver.serialize(serializer);
+    this.fungibleAssetAddress.serialize(serializer);
+    serializer.serializeU64(this.amount);
+    serializer.serializeU64(this.paymentChannelId);
+    serializer.serializeU64(this.sequenceNumber);
+    serializer.serializeBytes(this.publicKey);
+    serializer.serializeBytes(this.signature);
+    this.deployer.serialize(serializer);
+  }
+  bcsToBytes() {
+    const serializer = new Serializer();
+    this.serialize(serializer);
+    return serializer.toUint8Array();
+  }
+  bcsToHex() {
+    return Hex.fromHexInput(this.bcsToBytes());
+  }
+  toStringWithoutPrefix() {
+    return this.bcsToHex().toStringWithoutPrefix();
+  }
+  toString() {
+    return this.bcsToHex().toString();
+  }
+  /**
+   * Deserializes a SenderBuiltMicropayment from BCS bytes.
+   * @param bytes - The bytes to deserialize from (Uint8Array or hex string).
+   * @returns A new SenderBuiltMicropayment instance.
+   */
+  static deserialize(bytes) {
+    const bytesArray = typeof bytes === "string" ? Hex.fromHexInput(bytes).toUint8Array() : bytes;
+    const deserializer = new Deserializer(bytesArray);
+    const sender = AccountAddress.deserialize(deserializer);
+    const receiver = AccountAddress.deserialize(deserializer);
+    const fungibleAssetAddress = AccountAddress.deserialize(deserializer);
+    const amount = deserializer.deserializeU64();
+    const paymentChannelId = deserializer.deserializeU64();
+    const sequenceNumber = deserializer.deserializeU64();
+    const publicKey = deserializer.deserializeBytes();
+    const signature = deserializer.deserializeBytes();
+    const deployer = AccountAddress.deserialize(deserializer);
+    return new _SenderBuiltMicropayment(
+      sender,
+      receiver,
+      paymentChannelId,
+      amount,
+      fungibleAssetAddress,
+      sequenceNumber,
+      publicKey,
+      signature,
+      deployer
+    );
+  }
+};
 export {
   SenderBuiltMicropayment,
   StaleChannelStateError

package/dist/core/types/payments.d.ts

@@ -137,27 +137,27 @@ interface ChannelInfo {
     /**
      * The balance of the channel.
      */
-    balance: number;
+    balance: bigint;
     /**
      * The creation timestamp of the channel.
      */
-    creationMicros: number;
+    creationMicros: bigint;
     /**
      * The current expiration timestamp of the channel.
      */
-    expirationMicros: number;
+    expirationMicros: bigint;
     /**
      * The sequence number for the next allowed withdrawal.
      */
-    nextWithdrawnSequenceNumber: number;
+    nextWithdrawnSequenceNumber: bigint;
     /**
      * The channel's payment id.
      */
-    paymentChannelId: number;
+    paymentChannelId: bigint;
     /**
      * The amount already withdrawn by the receiver.
      */
-    receiverWithdrawnAmount: number;
+    receiverWithdrawnAmount: bigint;
     /**
      * The Ed25519 public key used to verify withdrawal signatures.
      */

package/dist/core/types/payments.mjs

@@ -1,9 +1,234 @@
+// src/core/types/payments.ts
 import {
-  SenderBuiltMicropayment,
-  StaleChannelStateError
-} from "../../chunk-TVLV7C74.mjs";
-import "../../chunk-7OV5ZYW6.mjs";
-import "../../chunk-7P6ASYW6.mjs";
+  AccountAddress,
+  Deserializer,
+  Hex,
+  Serializer
+} from "@aptos-labs/ts-sdk";
+
+// src/core/constants.ts
+import { Network } from "@aptos-labs/ts-sdk";
+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]: "http://localhost:9090",
+  [Network.CUSTOM]: void 0
+};
+var NetworkToShelbyBlobIndexerBaseUrl = {
+  [Network.SHELBYNET]: "https://api.shelbynet.aptoslabs.com/nocode/v1/public/alias/shelby/shelbynet/v1/graphql",
+  [Network.NETNA]: void 0,
+  [Network.DEVNET]: void 0,
+  [Network.TESTNET]: "https://api.testnet.aptoslabs.com/nocode/v1/public/alias/shelby/testnet/v1/graphql",
+  [Network.MAINNET]: void 0,
+  [Network.LOCAL]: "http://localhost:8091/v1/graphql",
+  [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 MICROPAYMENTS_DEPLOYER = "0x1ae7275148bf6ef742b658fd9cbcc2e094201606f4a7bc707bab0201da8043ee";
+
+// src/core/types/payments.ts
+var MICROPAYMENTS_MODULE_NAME = "micropayments";
+var WITHDRAW_APPROVAL_STRUCT_NAME = "WithdrawApproval";
+function serializeTypeInfo(serializer, moduleAddress, moduleName, structName) {
+  moduleAddress.serialize(serializer);
+  const moduleNameBytes = new TextEncoder().encode(moduleName);
+  serializer.serializeBytes(moduleNameBytes);
+  const structNameBytes = new TextEncoder().encode(structName);
+  serializer.serializeBytes(structNameBytes);
+}
+var StaleChannelStateError = class _StaleChannelStateError extends Error {
+  /**
+   * The last valid micropayment stored by the server.
+   * Clients can use this to reset their local channel state.
+   */
+  storedMicropayment;
+  constructor(storedMicropayment, message) {
+    super(
+      message ?? "Client has stale channel state. Use the returned micropayment to reset local state."
+    );
+    this.name = "StaleChannelStateError";
+    this.storedMicropayment = storedMicropayment;
+  }
+  /**
+   * Returns the stored micropayment as a base64-encoded string.
+   */
+  toBase64() {
+    const bytes = this.storedMicropayment.bcsToBytes();
+    const binaryString = Array.from(
+      bytes,
+      (byte) => String.fromCharCode(byte)
+    ).join("");
+    return btoa(binaryString);
+  }
+  /**
+   * Creates a StaleChannelStateError from a base64-encoded micropayment string.
+   */
+  static fromBase64(base64, message) {
+    const binaryString = atob(base64);
+    const bytes = Uint8Array.from(binaryString, (char) => char.charCodeAt(0));
+    const micropayment = SenderBuiltMicropayment.deserialize(bytes);
+    return new _StaleChannelStateError(micropayment, message);
+  }
+};
+var SenderBuiltMicropayment = class _SenderBuiltMicropayment {
+  /**
+   * The sender's address (owner of the payment channel).
+   */
+  sender;
+  /**
+   * The receiver's address (beneficiary of the withdrawal).
+   */
+  receiver;
+  /**
+   * The unique ID of the payment channel.
+   */
+  paymentChannelId;
+  /**
+   * The cumulative amount the receiver is authorized to withdraw.
+   */
+  amount;
+  /**
+   * The fungible asset metadata address.
+   */
+  fungibleAssetAddress;
+  /**
+   * Monotonically increasing sequence number for replay protection.
+   */
+  sequenceNumber;
+  /**
+   * The sender's Ed25519 public key (32 bytes).
+   * Used by the receiver to verify the signature before submitting.
+   */
+  publicKey;
+  /**
+   * The Ed25519 signature of the SignedMessage<WithdrawApproval> struct.
+   * The SignedMessage includes TypeInfo for domain separation.
+   */
+  signature;
+  /**
+   * The deployer address of the micropayments module.
+   * This is needed to reconstruct the TypeInfo for signature verification.
+   */
+  deployer;
+  constructor(sender, receiver, paymentChannelId, amount, fungibleAssetAddress, sequenceNumber, publicKey, signature, deployer) {
+    this.sender = sender;
+    this.receiver = receiver;
+    this.paymentChannelId = paymentChannelId;
+    this.amount = amount;
+    this.fungibleAssetAddress = fungibleAssetAddress;
+    this.sequenceNumber = sequenceNumber;
+    this.publicKey = publicKey;
+    this.signature = signature;
+    this.deployer = deployer ?? AccountAddress.fromString(MICROPAYMENTS_DEPLOYER);
+  }
+  /**
+   * Creates the BCS-serialized message that was signed.
+   * This is a SignedMessage<WithdrawApproval> which includes:
+   * 1. TypeInfo (module_address, module_name, struct_name)
+   * 2. WithdrawApproval struct fields
+   *
+   * This format is used with signature_verify_strict_t for domain separation.
+   */
+  getSignedMessage() {
+    return _SenderBuiltMicropayment.buildSignedMessage({
+      deployer: this.deployer,
+      sender: this.sender,
+      receiver: this.receiver,
+      fungibleAssetAddress: this.fungibleAssetAddress,
+      amount: this.amount,
+      paymentChannelId: this.paymentChannelId,
+      sequenceNumber: this.sequenceNumber
+    });
+  }
+  /**
+   * Static helper to build the SignedMessage<WithdrawApproval> bytes from raw parameters.
+   * This can be used to create the message for signing without constructing the full object.
+   *
+   * @param params - The withdrawal approval parameters.
+   * @returns The BCS-serialized SignedMessage<WithdrawApproval> bytes.
+   */
+  static buildSignedMessage(params) {
+    const serializer = new Serializer();
+    serializeTypeInfo(
+      serializer,
+      params.deployer,
+      MICROPAYMENTS_MODULE_NAME,
+      WITHDRAW_APPROVAL_STRUCT_NAME
+    );
+    params.sender.serialize(serializer);
+    params.receiver.serialize(serializer);
+    params.fungibleAssetAddress.serialize(serializer);
+    serializer.serializeU64(params.amount);
+    serializer.serializeU64(params.paymentChannelId);
+    serializer.serializeU64(params.sequenceNumber);
+    return serializer.toUint8Array();
+  }
+  serialize(serializer) {
+    this.sender.serialize(serializer);
+    this.receiver.serialize(serializer);
+    this.fungibleAssetAddress.serialize(serializer);
+    serializer.serializeU64(this.amount);
+    serializer.serializeU64(this.paymentChannelId);
+    serializer.serializeU64(this.sequenceNumber);
+    serializer.serializeBytes(this.publicKey);
+    serializer.serializeBytes(this.signature);
+    this.deployer.serialize(serializer);
+  }
+  bcsToBytes() {
+    const serializer = new Serializer();
+    this.serialize(serializer);
+    return serializer.toUint8Array();
+  }
+  bcsToHex() {
+    return Hex.fromHexInput(this.bcsToBytes());
+  }
+  toStringWithoutPrefix() {
+    return this.bcsToHex().toStringWithoutPrefix();
+  }
+  toString() {
+    return this.bcsToHex().toString();
+  }
+  /**
+   * Deserializes a SenderBuiltMicropayment from BCS bytes.
+   * @param bytes - The bytes to deserialize from (Uint8Array or hex string).
+   * @returns A new SenderBuiltMicropayment instance.
+   */
+  static deserialize(bytes) {
+    const bytesArray = typeof bytes === "string" ? Hex.fromHexInput(bytes).toUint8Array() : bytes;
+    const deserializer = new Deserializer(bytesArray);
+    const sender = AccountAddress.deserialize(deserializer);
+    const receiver = AccountAddress.deserialize(deserializer);
+    const fungibleAssetAddress = AccountAddress.deserialize(deserializer);
+    const amount = deserializer.deserializeU64();
+    const paymentChannelId = deserializer.deserializeU64();
+    const sequenceNumber = deserializer.deserializeU64();
+    const publicKey = deserializer.deserializeBytes();
+    const signature = deserializer.deserializeBytes();
+    const deployer = AccountAddress.deserialize(deserializer);
+    return new _SenderBuiltMicropayment(
+      sender,
+      receiver,
+      paymentChannelId,
+      amount,
+      fungibleAssetAddress,
+      sequenceNumber,
+      publicKey,
+      signature,
+      deployer
+    );
+  }
+};
 export {
   SenderBuiltMicropayment,
   StaleChannelStateError

package/dist/core/types/placement_groups.mjs

@@ -1 +0,0 @@
-import "../../chunk-AD2G3QYD.mjs";

package/dist/core/types/storage_providers.mjs

@@ -1 +0,0 @@
-import "../../chunk-MQUVYMNQ.mjs";