@buildonspark/spark-sdk 0.2.13 → 0.3.0

package/src/proto/spark.ts

@@ -65,6 +65,39 @@ export function networkToJSON(object: Network): string {
   }
 }
 
+export enum Direction {
+  NEXT = 0,
+  PREVIOUS = 1,
+  UNRECOGNIZED = -1,
+}
+
+export function directionFromJSON(object: any): Direction {
+  switch (object) {
+    case 0:
+    case "NEXT":
+      return Direction.NEXT;
+    case 1:
+    case "PREVIOUS":
+      return Direction.PREVIOUS;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return Direction.UNRECOGNIZED;
+  }
+}
+
+export function directionToJSON(object: Direction): string {
+  switch (object) {
+    case Direction.NEXT:
+      return "NEXT";
+    case Direction.PREVIOUS:
+      return "PREVIOUS";
+    case Direction.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 export enum TokenTransactionStatus {
   TOKEN_TRANSACTION_STARTED = 0,
   TOKEN_TRANSACTION_SIGNED = 1,
@@ -412,6 +445,19 @@ export interface DepositEvent {
   deposit: TreeNode | undefined;
 }
 
+export interface PageRequest {
+  pageSize: number;
+  cursor: string;
+  direction: Direction;
+}
+
+export interface PageResponse {
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+  nextCursor: string;
+  previousCursor: string;
+}
+
 /**
  * DepositAddressProof is the proof of possession of the deposit address.
  * When a user wants to generate a deposit address, they are sending their public key to the SE,
@@ -1079,8 +1125,11 @@ export interface StartTransferRequest {
     | Date
     | undefined;
   /** If this field is set, the leaves_to_send and key_tweak_proofs will be ignored. */
-  transferPackage: TransferPackage | undefined;
-  sparkPaymentIntent: string;
+  transferPackage:
+    | TransferPackage
+    | undefined;
+  /** The invoice this transfer pays. */
+  sparkInvoice: string;
 }
 
 export interface StartTransferResponse {
@@ -1160,6 +1209,7 @@ export interface Transfer {
   createdTime: Date | undefined;
   updatedTime: Date | undefined;
   type: TransferType;
+  sparkInvoice: string;
 }
 
 export interface TransferLeaf {
@@ -2123,6 +2173,206 @@ export const DepositEvent: MessageFns<DepositEvent> = {
   },
 };
 
+function createBasePageRequest(): PageRequest {
+  return { pageSize: 0, cursor: "", direction: 0 };
+}
+
+export const PageRequest: MessageFns<PageRequest> = {
+  encode(message: PageRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.pageSize !== 0) {
+      writer.uint32(8).int32(message.pageSize);
+    }
+    if (message.cursor !== "") {
+      writer.uint32(18).string(message.cursor);
+    }
+    if (message.direction !== 0) {
+      writer.uint32(24).int32(message.direction);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): PageRequest {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBasePageRequest();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 8) {
+            break;
+          }
+
+          message.pageSize = reader.int32();
+          continue;
+        }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+
+          message.cursor = reader.string();
+          continue;
+        }
+        case 3: {
+          if (tag !== 24) {
+            break;
+          }
+
+          message.direction = reader.int32() as any;
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+
+  fromJSON(object: any): PageRequest {
+    return {
+      pageSize: isSet(object.pageSize) ? globalThis.Number(object.pageSize) : 0,
+      cursor: isSet(object.cursor) ? globalThis.String(object.cursor) : "",
+      direction: isSet(object.direction) ? directionFromJSON(object.direction) : 0,
+    };
+  },
+
+  toJSON(message: PageRequest): unknown {
+    const obj: any = {};
+    if (message.pageSize !== 0) {
+      obj.pageSize = Math.round(message.pageSize);
+    }
+    if (message.cursor !== "") {
+      obj.cursor = message.cursor;
+    }
+    if (message.direction !== 0) {
+      obj.direction = directionToJSON(message.direction);
+    }
+    return obj;
+  },
+
+  create(base?: DeepPartial<PageRequest>): PageRequest {
+    return PageRequest.fromPartial(base ?? {});
+  },
+  fromPartial(object: DeepPartial<PageRequest>): PageRequest {
+    const message = createBasePageRequest();
+    message.pageSize = object.pageSize ?? 0;
+    message.cursor = object.cursor ?? "";
+    message.direction = object.direction ?? 0;
+    return message;
+  },
+};
+
+function createBasePageResponse(): PageResponse {
+  return { hasNextPage: false, hasPreviousPage: false, nextCursor: "", previousCursor: "" };
+}
+
+export const PageResponse: MessageFns<PageResponse> = {
+  encode(message: PageResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.hasNextPage !== false) {
+      writer.uint32(8).bool(message.hasNextPage);
+    }
+    if (message.hasPreviousPage !== false) {
+      writer.uint32(16).bool(message.hasPreviousPage);
+    }
+    if (message.nextCursor !== "") {
+      writer.uint32(26).string(message.nextCursor);
+    }
+    if (message.previousCursor !== "") {
+      writer.uint32(34).string(message.previousCursor);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): PageResponse {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBasePageResponse();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 8) {
+            break;
+          }
+
+          message.hasNextPage = reader.bool();
+          continue;
+        }
+        case 2: {
+          if (tag !== 16) {
+            break;
+          }
+
+          message.hasPreviousPage = reader.bool();
+          continue;
+        }
+        case 3: {
+          if (tag !== 26) {
+            break;
+          }
+
+          message.nextCursor = reader.string();
+          continue;
+        }
+        case 4: {
+          if (tag !== 34) {
+            break;
+          }
+
+          message.previousCursor = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+
+  fromJSON(object: any): PageResponse {
+    return {
+      hasNextPage: isSet(object.hasNextPage) ? globalThis.Boolean(object.hasNextPage) : false,
+      hasPreviousPage: isSet(object.hasPreviousPage) ? globalThis.Boolean(object.hasPreviousPage) : false,
+      nextCursor: isSet(object.nextCursor) ? globalThis.String(object.nextCursor) : "",
+      previousCursor: isSet(object.previousCursor) ? globalThis.String(object.previousCursor) : "",
+    };
+  },
+
+  toJSON(message: PageResponse): unknown {
+    const obj: any = {};
+    if (message.hasNextPage !== false) {
+      obj.hasNextPage = message.hasNextPage;
+    }
+    if (message.hasPreviousPage !== false) {
+      obj.hasPreviousPage = message.hasPreviousPage;
+    }
+    if (message.nextCursor !== "") {
+      obj.nextCursor = message.nextCursor;
+    }
+    if (message.previousCursor !== "") {
+      obj.previousCursor = message.previousCursor;
+    }
+    return obj;
+  },
+
+  create(base?: DeepPartial<PageResponse>): PageResponse {
+    return PageResponse.fromPartial(base ?? {});
+  },
+  fromPartial(object: DeepPartial<PageResponse>): PageResponse {
+    const message = createBasePageResponse();
+    message.hasNextPage = object.hasNextPage ?? false;
+    message.hasPreviousPage = object.hasPreviousPage ?? false;
+    message.nextCursor = object.nextCursor ?? "";
+    message.previousCursor = object.previousCursor ?? "";
+    return message;
+  },
+};
+
 function createBaseDepositAddressProof(): DepositAddressProof {
   return { addressSignatures: {}, proofOfPossessionSignature: new Uint8Array(0) };
 }
@@ -8639,7 +8889,7 @@ function createBaseStartTransferRequest(): StartTransferRequest {
     receiverIdentityPublicKey: new Uint8Array(0),
     expiryTime: undefined,
     transferPackage: undefined,
-    sparkPaymentIntent: "",
+    sparkInvoice: "",
   };
 }
 
@@ -8663,8 +8913,8 @@ export const StartTransferRequest: MessageFns<StartTransferRequest> = {
     if (message.transferPackage !== undefined) {
       TransferPackage.encode(message.transferPackage, writer.uint32(58).fork()).join();
     }
-    if (message.sparkPaymentIntent !== "") {
-      writer.uint32(74).string(message.sparkPaymentIntent);
+    if (message.sparkInvoice !== "") {
+      writer.uint32(82).string(message.sparkInvoice);
     }
     return writer;
   },
@@ -8724,12 +8974,12 @@ export const StartTransferRequest: MessageFns<StartTransferRequest> = {
           message.transferPackage = TransferPackage.decode(reader, reader.uint32());
           continue;
         }
-        case 9: {
-          if (tag !== 74) {
+        case 10: {
+          if (tag !== 82) {
             break;
           }
 
-          message.sparkPaymentIntent = reader.string();
+          message.sparkInvoice = reader.string();
           continue;
         }
       }
@@ -8755,7 +9005,7 @@ export const StartTransferRequest: MessageFns<StartTransferRequest> = {
         : new Uint8Array(0),
       expiryTime: isSet(object.expiryTime) ? fromJsonTimestamp(object.expiryTime) : undefined,
       transferPackage: isSet(object.transferPackage) ? TransferPackage.fromJSON(object.transferPackage) : undefined,
-      sparkPaymentIntent: isSet(object.sparkPaymentIntent) ? globalThis.String(object.sparkPaymentIntent) : "",
+      sparkInvoice: isSet(object.sparkInvoice) ? globalThis.String(object.sparkInvoice) : "",
     };
   },
 
@@ -8779,8 +9029,8 @@ export const StartTransferRequest: MessageFns<StartTransferRequest> = {
     if (message.transferPackage !== undefined) {
       obj.transferPackage = TransferPackage.toJSON(message.transferPackage);
     }
-    if (message.sparkPaymentIntent !== "") {
-      obj.sparkPaymentIntent = message.sparkPaymentIntent;
+    if (message.sparkInvoice !== "") {
+      obj.sparkInvoice = message.sparkInvoice;
     }
     return obj;
   },
@@ -8798,7 +9048,7 @@ export const StartTransferRequest: MessageFns<StartTransferRequest> = {
     message.transferPackage = (object.transferPackage !== undefined && object.transferPackage !== null)
       ? TransferPackage.fromPartial(object.transferPackage)
       : undefined;
-    message.sparkPaymentIntent = object.sparkPaymentIntent ?? "";
+    message.sparkInvoice = object.sparkInvoice ?? "";
     return message;
   },
 };
@@ -9747,6 +9997,7 @@ function createBaseTransfer(): Transfer {
     createdTime: undefined,
     updatedTime: undefined,
     type: 0,
+    sparkInvoice: "",
   };
 }
 
@@ -9782,6 +10033,9 @@ export const Transfer: MessageFns<Transfer> = {
     if (message.type !== 0) {
       writer.uint32(80).int32(message.type);
     }
+    if (message.sparkInvoice !== "") {
+      writer.uint32(90).string(message.sparkInvoice);
+    }
     return writer;
   },
 
@@ -9872,6 +10126,14 @@ export const Transfer: MessageFns<Transfer> = {
           message.type = reader.int32() as any;
           continue;
         }
+        case 11: {
+          if (tag !== 90) {
+            break;
+          }
+
+          message.sparkInvoice = reader.string();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -9897,6 +10159,7 @@ export const Transfer: MessageFns<Transfer> = {
       createdTime: isSet(object.createdTime) ? fromJsonTimestamp(object.createdTime) : undefined,
       updatedTime: isSet(object.updatedTime) ? fromJsonTimestamp(object.updatedTime) : undefined,
       type: isSet(object.type) ? transferTypeFromJSON(object.type) : 0,
+      sparkInvoice: isSet(object.sparkInvoice) ? globalThis.String(object.sparkInvoice) : "",
     };
   },
 
@@ -9932,6 +10195,9 @@ export const Transfer: MessageFns<Transfer> = {
     if (message.type !== 0) {
       obj.type = transferTypeToJSON(message.type);
     }
+    if (message.sparkInvoice !== "") {
+      obj.sparkInvoice = message.sparkInvoice;
+    }
     return obj;
   },
 
@@ -9950,6 +10216,7 @@ export const Transfer: MessageFns<Transfer> = {
     message.createdTime = object.createdTime ?? undefined;
     message.updatedTime = object.updatedTime ?? undefined;
     message.type = object.type ?? 0;
+    message.sparkInvoice = object.sparkInvoice ?? "";
     return message;
   },
 };

package/src/proto/spark_token.ts

@@ -8,7 +8,7 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 import type { CallContext, CallOptions } from "nice-grpc-common";
 import { Timestamp } from "./google/protobuf/timestamp.js";
-import { Network, networkFromJSON, networkToJSON, SigningKeyshare } from "./spark.js";
+import { Network, networkFromJSON, networkToJSON, PageRequest, PageResponse, SigningKeyshare } from "./spark.js";
 
 export const protobufPackage = "spark_token";
 
@@ -343,6 +343,8 @@ export interface QueryTokenOutputsRequest {
   tokenIdentifiers: Uint8Array[];
   /** defaults to mainnet when no network is provided. */
   network: Network;
+  /** For pagination */
+  pageRequest: PageRequest | undefined;
 }
 
 /** Request constraints are combined using an AND relation. */
@@ -374,6 +376,7 @@ export interface OutputWithPreviousTransactionData {
 
 export interface QueryTokenOutputsResponse {
   outputsWithPreviousTransactionData: OutputWithPreviousTransactionData[];
+  pageResponse: PageResponse | undefined;
 }
 
 export interface SpentTokenOutputMetadata {
@@ -2283,7 +2286,7 @@ export const QueryTokenMetadataResponse: MessageFns<QueryTokenMetadataResponse>
 };
 
 function createBaseQueryTokenOutputsRequest(): QueryTokenOutputsRequest {
-  return { ownerPublicKeys: [], issuerPublicKeys: [], tokenIdentifiers: [], network: 0 };
+  return { ownerPublicKeys: [], issuerPublicKeys: [], tokenIdentifiers: [], network: 0, pageRequest: undefined };
 }
 
 export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
@@ -2300,6 +2303,9 @@ export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
     if (message.network !== 0) {
       writer.uint32(24).int32(message.network);
     }
+    if (message.pageRequest !== undefined) {
+      PageRequest.encode(message.pageRequest, writer.uint32(42).fork()).join();
+    }
     return writer;
   },
 
@@ -2342,6 +2348,14 @@ export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
           message.network = reader.int32() as any;
           continue;
         }
+        case 5: {
+          if (tag !== 42) {
+            break;
+          }
+
+          message.pageRequest = PageRequest.decode(reader, reader.uint32());
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -2363,6 +2377,7 @@ export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
         ? object.tokenIdentifiers.map((e: any) => bytesFromBase64(e))
         : [],
       network: isSet(object.network) ? networkFromJSON(object.network) : 0,
+      pageRequest: isSet(object.pageRequest) ? PageRequest.fromJSON(object.pageRequest) : undefined,
     };
   },
 
@@ -2380,6 +2395,9 @@ export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
     if (message.network !== 0) {
       obj.network = networkToJSON(message.network);
     }
+    if (message.pageRequest !== undefined) {
+      obj.pageRequest = PageRequest.toJSON(message.pageRequest);
+    }
     return obj;
   },
 
@@ -2392,6 +2410,9 @@ export const QueryTokenOutputsRequest: MessageFns<QueryTokenOutputsRequest> = {
     message.issuerPublicKeys = object.issuerPublicKeys?.map((e) => e) || [];
     message.tokenIdentifiers = object.tokenIdentifiers?.map((e) => e) || [];
     message.network = object.network ?? 0;
+    message.pageRequest = (object.pageRequest !== undefined && object.pageRequest !== null)
+      ? PageRequest.fromPartial(object.pageRequest)
+      : undefined;
     return message;
   },
 };
@@ -2750,7 +2771,7 @@ export const OutputWithPreviousTransactionData: MessageFns<OutputWithPreviousTra
 };
 
 function createBaseQueryTokenOutputsResponse(): QueryTokenOutputsResponse {
-  return { outputsWithPreviousTransactionData: [] };
+  return { outputsWithPreviousTransactionData: [], pageResponse: undefined };
 }
 
 export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> = {
@@ -2758,6 +2779,9 @@ export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> =
     for (const v of message.outputsWithPreviousTransactionData) {
       OutputWithPreviousTransactionData.encode(v!, writer.uint32(10).fork()).join();
     }
+    if (message.pageResponse !== undefined) {
+      PageResponse.encode(message.pageResponse, writer.uint32(18).fork()).join();
+    }
     return writer;
   },
 
@@ -2778,6 +2802,14 @@ export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> =
           );
           continue;
         }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+
+          message.pageResponse = PageResponse.decode(reader, reader.uint32());
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -2792,6 +2824,7 @@ export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> =
       outputsWithPreviousTransactionData: globalThis.Array.isArray(object?.outputsWithPreviousTransactionData)
         ? object.outputsWithPreviousTransactionData.map((e: any) => OutputWithPreviousTransactionData.fromJSON(e))
         : [],
+      pageResponse: isSet(object.pageResponse) ? PageResponse.fromJSON(object.pageResponse) : undefined,
     };
   },
 
@@ -2802,6 +2835,9 @@ export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> =
         OutputWithPreviousTransactionData.toJSON(e)
       );
     }
+    if (message.pageResponse !== undefined) {
+      obj.pageResponse = PageResponse.toJSON(message.pageResponse);
+    }
     return obj;
   },
 
@@ -2812,6 +2848,9 @@ export const QueryTokenOutputsResponse: MessageFns<QueryTokenOutputsResponse> =
     const message = createBaseQueryTokenOutputsResponse();
     message.outputsWithPreviousTransactionData =
       object.outputsWithPreviousTransactionData?.map((e) => OutputWithPreviousTransactionData.fromPartial(e)) || [];
+    message.pageResponse = (object.pageResponse !== undefined && object.pageResponse !== null)
+      ? PageResponse.fromPartial(object.pageResponse)
+      : undefined;
     return message;
   },
 };

package/src/services/token-transactions.ts

@@ -11,6 +11,7 @@ import {
   ValidationError,
 } from "../errors/types.js";
 import {
+  Direction,
   OperatorSpecificOwnerSignature,
   OperatorSpecificTokenTransactionSignablePayload,
   OutputWithPreviousTransactionData,
@@ -29,7 +30,11 @@ import {
 } from "../proto/spark_token.js";
 import { TokenOutputsMap } from "../spark-wallet/types.js";
 import { SparkCallOptions } from "../types/grpc.js";
-import { decodeSparkAddress, SparkAddressFormat } from "../utils/address.js";
+import {
+  decodeSparkAddress,
+  SparkAddressFormat,
+  isValidPublicKey,
+} from "../utils/address.js";
 import { collectResponses } from "../utils/response-validation.js";
 import {
   hashOperatorSpecificTokenTransactionSignablePayload,
@@ -57,6 +62,7 @@ import { ConnectionManager } from "./connection.js";
 import { SigningOperator } from "./wallet-config.js";
 
 const MAX_TOKEN_OUTPUTS = 500;
+const QUERY_TOKEN_OUTPUTS_PAGE_SIZE = 100;
 
 export interface FetchOwnedTokenOutputsParams {
   ownerPublicKeys: Uint8Array[];
@@ -979,6 +985,38 @@ export class TokenTransactionService {
   public async fetchOwnedTokenOutputs(
     params: FetchOwnedTokenOutputsParams,
   ): Promise<OutputWithPreviousTransactionData[]> {
+    const {
+      ownerPublicKeys,
+      issuerPublicKeys = [],
+      tokenIdentifiers = [],
+    } = params;
+
+    if (ownerPublicKeys.length === 0) {
+      throw new ValidationError("Owner public keys cannot be empty", {
+        field: "ownerPublicKeys",
+        value: ownerPublicKeys,
+        expected: "Non-empty array",
+      });
+    }
+    for (const ownerPublicKey of ownerPublicKeys) {
+      isValidPublicKey(bytesToHex(ownerPublicKey));
+    }
+    for (const issuerPublicKey of issuerPublicKeys) {
+      isValidPublicKey(bytesToHex(issuerPublicKey));
+    }
+    for (const tokenIdentifier of tokenIdentifiers) {
+      if (tokenIdentifier.length !== 32) {
+        throw new ValidationError(
+          "Token identifier must be 32 bytes (64 hex characters) long.",
+          {
+            field: "tokenIdentifier",
+            value: tokenIdentifier,
+            expected: "32 bytes",
+          },
+        );
+      }
+    }
+
     if (this.config.getTokenTransactionVersion() === "V0") {
       return this.fetchOwnedTokenOutputsV0(params);
     } else {
@@ -1045,14 +1083,34 @@ export class TokenTransactionService {
     );
 
     try {
-      const result = await tokenClient.query_token_outputs({
-        ownerPublicKeys,
-        issuerPublicKeys,
-        tokenIdentifiers,
-        network: this.config.getNetworkProto(),
-      });
+      const allOutputs: OutputWithPreviousTransactionData[] = [];
+      let after: string | undefined = undefined;
+
+      do {
+        const result = await tokenClient.query_token_outputs({
+          ownerPublicKeys,
+          issuerPublicKeys,
+          tokenIdentifiers,
+          network: this.config.getNetworkProto(),
+          pageRequest: {
+            pageSize: QUERY_TOKEN_OUTPUTS_PAGE_SIZE,
+            cursor: after,
+            direction: Direction.NEXT,
+          },
+        });
 
-      return result.outputsWithPreviousTransactionData;
+        if (Array.isArray(result.outputsWithPreviousTransactionData)) {
+          allOutputs.push(...result.outputsWithPreviousTransactionData);
+        }
+
+        if (result.pageResponse?.hasNextPage) {
+          after = result.pageResponse.nextCursor;
+        } else {
+          break;
+        }
+      } while (after);
+
+      return allOutputs;
     } catch (error) {
       throw new NetworkError(
         "Failed to fetch owned token outputs",

package/src/services/transfer.ts

@@ -42,6 +42,7 @@ import {
   KeyDerivationType,
   SigningCommitmentWithOptionalNonce,
 } from "../signer/types.js";
+import { SparkAddressFormat } from "../utils/address.js";
 import {
   getSigHashFromTx,
   getTxFromRawTxBytes,
@@ -113,7 +114,6 @@ function getSigningJobProto(
     signingNonceCommitment: signingJob.signingNonceCommitment.commitment,
   };
 }
-
 export class BaseTransferService {
   protected readonly config: WalletConfigService;
   protected readonly connectionManager: ConnectionManager;
@@ -243,6 +243,7 @@ export class BaseTransferService {
   async sendTransferWithKeyTweaks(
     leaves: LeafKeyTweak[],
     receiverIdentityPubkey: Uint8Array,
+    sparkInvoice?: SparkAddressFormat,
   ): Promise<Transfer> {
     const transferID = uuidv7();
 
@@ -274,6 +275,7 @@ export class BaseTransferService {
         ownerIdentityPublicKey: await this.config.signer.getIdentityPublicKey(),
         receiverIdentityPublicKey: receiverIdentityPubkey,
         transferPackage,
+        sparkInvoice,
       });
     } catch (error) {
       throw new NetworkError(