@lightsparkdev/lightspark-sdk 1.6.0 → 1.7.0

package/dist/index.js

@@ -53,6 +53,7 @@ import {
   Permission_default,
   RegionCode_default,
   RemoteSigningSubEventType_default,
+  RequestInitiator_default,
   RiskRating_default,
   RoutingTransactionFailureReason_default,
   SignablePayloadStatus_default,
@@ -92,7 +93,7 @@ import {
   getTransactionQuery,
   getUmaInvitationQuery,
   getWithdrawalQuery
-} from "./chunk-UHTZSOPX.js";
+} from "./chunk-DSWMAFFH.js";
 import {
   BitcoinNetwork_default
 } from "./chunk-K6SAUSAX.js";
@@ -141,6 +142,7 @@ import {
   Requester,
   SigningKeyType as SigningKeyType2,
   StubAuthProvider,
+  bytesToHex,
   createSha256Hash,
   pollUntil
 } from "@lightsparkdev/core";
@@ -148,7 +150,7 @@ import {
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.6.0",
+  version: "1.7.0",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -679,12 +681,14 @@ mutation CreateUmaInvoice(
   $amount_msats: Long!
   $metadata_hash: String!
   $expiry_secs: Int = null
+  $receiver_hash: String = null
 ) {
   create_uma_invoice(input: {
       node_id: $node_id
       amount_msats: $amount_msats
       metadata_hash: $metadata_hash
       expiry_secs: $expiry_secs
+      receiver_hash: $receiver_hash
   }) {
       invoice {
           ...InvoiceFragment
@@ -932,6 +936,7 @@ var PayUmaInvoice = `
     $timeout_secs: Int!
     $maximum_fees_msats: Long!
     $amount_msats: Long
+    $sender_hash: String = null
   ) {
     pay_uma_invoice(
       input: {
@@ -940,6 +945,7 @@ var PayUmaInvoice = `
         timeout_secs: $timeout_secs
         maximum_fees_msats: $maximum_fees_msats
         amount_msats: $amount_msats
+        sender_hash: $sender_hash
       }
     ) {
       payment {
@@ -1632,16 +1638,35 @@ var LightsparkClient = class {
    *     h-tag (SHA256 purpose of payment) of the resulting Bolt 11 invoice. See
    *     [this spec](https://github.com/lnurl/luds/blob/luds/06.md#pay-to-static-qrnfclink) for details.
    * @param expirySecs The number of seconds until the invoice expires. Defaults to 3600 (1 hour).
+   * @param signingPrivateKey The receiver's signing private key. Used to hash the receiver identifier.
+   * @param receiverIdentifier Optional identifier of the receiver. If provided, this will be hashed using a
+   *     monthly-rotated seed and used for anonymized analysis.
    * @returns An Invoice object representing the generated invoice.
    */
-  async createUmaInvoice(nodeId, amountMsats, metadata, expirySecs = void 0) {
+  async createUmaInvoice(nodeId, amountMsats, metadata, expirySecs = void 0, signingPrivateKey = void 0, receiverIdentifier = void 0) {
     const metadataHash = await createSha256Hash(metadata, true);
+    let receiverHash = void 0;
+    if (receiverIdentifier !== void 0) {
+      if (signingPrivateKey == void 0) {
+        throw new LightsparkException(
+          "CreateUmaInvoiceError",
+          "Receiver identifier provided without signing private key"
+        );
+      }
+      receiverHash = await this.hashUmaIdentifier(
+        receiverIdentifier,
+        signingPrivateKey
+      );
+    }
     const variables = {
       node_id: nodeId,
       amount_msats: amountMsats,
       metadata_hash: metadataHash,
       expiry_secs: expirySecs !== void 0 ? expirySecs : 3600
     };
+    if (receiverHash !== void 0) {
+      variables.receiver_hash = receiverHash;
+    }
     const response = await this.requester.makeRawRequest(
       CreateUmaInvoice,
       variables
@@ -1847,12 +1872,28 @@ var LightsparkClient = class {
    * @param amountMsats The amount to pay in msats for a zero-amount invoice. Defaults to the full amount of the
    *     invoice. NOTE: This parameter can only be passed for a zero-amount
    *     invoice. Otherwise, the call will fail.
+   * @param signingPrivateKey The sender's signing private key. Used to hash the sender identifier.
+   * @param senderIdentifier Optional identifier of the sender. If provided, this will be hashed using a
+   *     monthly-rotated seed and used for anonymized analysis.
    * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
    */
-  async payUmaInvoice(payerNodeId, encodedInvoice, maximumFeesMsats, timeoutSecs = 60, amountMsats = void 0) {
+  async payUmaInvoice(payerNodeId, encodedInvoice, maximumFeesMsats, timeoutSecs = 60, amountMsats = void 0, signingPrivateKey = void 0, senderIdentifier = void 0) {
     if (!this.nodeKeyCache.hasKey(payerNodeId)) {
       throw new LightsparkSigningException3("Paying node is not unlocked");
     }
+    let senderHash = void 0;
+    if (senderIdentifier !== void 0) {
+      if (signingPrivateKey == void 0) {
+        throw new LightsparkException(
+          "PayUmaInvoiceError",
+          "Sender identifier provided without signing private key"
+        );
+      }
+      senderHash = await this.hashUmaIdentifier(
+        senderIdentifier,
+        signingPrivateKey
+      );
+    }
     const variables = {
       node_id: payerNodeId,
       encoded_invoice: encodedInvoice,
@@ -1862,6 +1903,9 @@ var LightsparkClient = class {
     if (amountMsats !== void 0) {
       variables.amount_msats = amountMsats;
     }
+    if (senderHash !== void 0) {
+      variables.sender_hash = senderHash;
+    }
     const response = await this.requester.makeRawRequest(
       PayUmaInvoice,
       variables,
@@ -2351,6 +2395,14 @@ var LightsparkClient = class {
     }
     return await createSha256Hash(e164PhoneNumber, true);
   }
+  async hashUmaIdentifier(identifier, signingPrivateKey) {
+    const now = this.getUtcDateTime();
+    const input = identifier + `${now.getUTCMonth() + 1}-${now.getUTCFullYear()}` + bytesToHex(signingPrivateKey);
+    return await createSha256Hash(input, true);
+  }
+  getUtcDateTime() {
+    return /* @__PURE__ */ new Date();
+  }
   /**
    * Executes a raw `Query` against the Lightspark API.
    *
@@ -2460,6 +2512,7 @@ export {
   RegionCode_default as RegionCode,
   RemoteSigningSubEventType_default as RemoteSigningSubEventType,
   RemoteSigningWebhookHandler,
+  RequestInitiator_default as RequestInitiator,
   RiskRating_default as RiskRating,
   RoutingTransactionFailureReason_default as RoutingTransactionFailureReason,
   SignablePayloadStatus_default as SignablePayloadStatus,

package/dist/objects/index.cjs

@@ -48,6 +48,7 @@ __export(objects_exports, {
   Permission: () => Permission_default,
   RegionCode: () => RegionCode_default,
   RemoteSigningSubEventType: () => RemoteSigningSubEventType_default,
+  RequestInitiator: () => RequestInitiator_default,
   RiskRating: () => RiskRating_default,
   RoutingTransactionFailureReason: () => RoutingTransactionFailureReason_default,
   SignablePayloadStatus: () => SignablePayloadStatus_default,
@@ -4815,6 +4816,15 @@ var WalletToTransactionsConnectionFromJson = (obj) => {
   };
 };
 
+// src/objects/RequestInitiator.ts
+var RequestInitiator = /* @__PURE__ */ ((RequestInitiator2) => {
+  RequestInitiator2["FUTURE_VALUE"] = "FUTURE_VALUE";
+  RequestInitiator2["CUSTOMER"] = "CUSTOMER";
+  RequestInitiator2["LIGHTSPARK"] = "LIGHTSPARK";
+  return RequestInitiator2;
+})(RequestInitiator || {});
+var RequestInitiator_default = RequestInitiator;
+
 // src/objects/WithdrawalMode.ts
 var WithdrawalMode = /* @__PURE__ */ ((WithdrawalMode2) => {
   WithdrawalMode2["FUTURE_VALUE"] = "FUTURE_VALUE";
@@ -5083,7 +5093,7 @@ var WithdrawalRequestToWithdrawalsConnectionFromJson = (obj) => {
 
 // src/objects/WithdrawalRequest.ts
 var WithdrawalRequest = class {
-  constructor(id, createdAt, updatedAt, requestedAmount, amount, bitcoinAddress, withdrawalMode, status, typename, estimatedAmount, amountWithdrawn, totalFees, completedAt, withdrawalId, idempotencyKey) {
+  constructor(id, createdAt, updatedAt, requestedAmount, amount, bitcoinAddress, withdrawalMode, status, initiator, typename, estimatedAmount, amountWithdrawn, totalFees, completedAt, withdrawalId, idempotencyKey) {
     this.id = id;
     this.createdAt = createdAt;
     this.updatedAt = updatedAt;
@@ -5092,6 +5102,7 @@ var WithdrawalRequest = class {
     this.bitcoinAddress = bitcoinAddress;
     this.withdrawalMode = withdrawalMode;
     this.status = status;
+    this.initiator = initiator;
     this.typename = typename;
     this.estimatedAmount = estimatedAmount;
     this.amountWithdrawn = amountWithdrawn;
@@ -5313,7 +5324,8 @@ ${FRAGMENT18}
       withdrawal_request_status: this.status,
       withdrawal_request_completed_at: this.completedAt,
       withdrawal_request_withdrawal: { id: this.withdrawalId },
-      withdrawal_request_idempotency_key: this.idempotencyKey
+      withdrawal_request_idempotency_key: this.idempotencyKey,
+      withdrawal_request_initiator: this.initiator
     };
   }
 };
@@ -5327,6 +5339,7 @@ var WithdrawalRequestFromJson = (obj) => {
     obj["withdrawal_request_bitcoin_address"],
     WithdrawalMode_default[obj["withdrawal_request_withdrawal_mode"]] ?? WithdrawalMode_default.FUTURE_VALUE,
     WithdrawalRequestStatus_default[obj["withdrawal_request_status"]] ?? WithdrawalRequestStatus_default.FUTURE_VALUE,
+    RequestInitiator_default[obj["withdrawal_request_initiator"]] ?? RequestInitiator_default.FUTURE_VALUE,
     "WithdrawalRequest",
     !!obj["withdrawal_request_estimated_amount"] ? CurrencyAmountFromJson(obj["withdrawal_request_estimated_amount"]) : void 0,
     !!obj["withdrawal_request_amount_withdrawn"] ? CurrencyAmountFromJson(obj["withdrawal_request_amount_withdrawn"]) : void 0,
@@ -5390,6 +5403,7 @@ fragment WithdrawalRequestFragment on WithdrawalRequest {
         id
     }
     withdrawal_request_idempotency_key: idempotency_key
+    withdrawal_request_initiator: initiator
 }`;
 var WithdrawalRequest_default = WithdrawalRequest;
 
@@ -6448,6 +6462,7 @@ query FetchWalletToWithdrawalRequestsConnection($entity_id: ID!, $first: Int, $a
                         id
                     }
                     withdrawal_request_idempotency_key: idempotency_key
+                    withdrawal_request_initiator: initiator
                 }
             }
         }
@@ -8265,6 +8280,7 @@ query FetchAccountToWithdrawalRequestsConnection($first: Int, $after: String, $b
                         id
                     }
                     withdrawal_request_idempotency_key: idempotency_key
+                    withdrawal_request_initiator: initiator
                 }
             }
         }
@@ -10410,6 +10426,7 @@ var WebhookEventType_default = WebhookEventType;
   Permission,
   RegionCode,
   RemoteSigningSubEventType,
+  RequestInitiator,
   RiskRating,
   RoutingTransactionFailureReason,
   SignablePayloadStatus,

package/dist/objects/index.d.cts

@@ -1,4 +1,4 @@
-export { A as Account, a as AccountToApiTokensConnection, b as AccountToChannelsConnection, c as AccountToNodesConnection, d as AccountToPaymentRequestsConnection, e as AccountToTransactionsConnection, f as AccountToWalletsConnection, g as AccountToWithdrawalRequestsConnection, h as ApiToken, j as AuditLogActor, B as Balances, l as BlockchainBalance, C as CancelInvoiceInput, m as CancelInvoiceOutput, n as Channel, o as ChannelClosingTransaction, q as ChannelFees, r as ChannelOpeningTransaction, t as ChannelSnapshot, v as ChannelStatus, w as ChannelToTransactionsConnection, x as ClaimUmaInvitationInput, y as ClaimUmaInvitationOutput, z as ClaimUmaInvitationWithIncentivesInput, D as ClaimUmaInvitationWithIncentivesOutput, E as ComplianceProvider, F as Connection, G as CreateApiTokenInput, H as CreateApiTokenOutput, I as CreateInvitationWithIncentivesInput, J as CreateInvitationWithIncentivesOutput, K as CreateInvoiceInput, M as CreateInvoiceOutput, N as CreateLnurlInvoiceInput, O as CreateNodeWalletAddressInput, P as CreateNodeWalletAddressOutput, Q as CreateTestModeInvoiceInput, R as CreateTestModeInvoiceOutput, S as CreateTestModePaymentInput, T as CreateTestModePaymentoutput, U as CreateUmaInvitationInput, V as CreateUmaInvitationOutput, X as CreateUmaInvoiceInput, Y as CurrencyAmount, Z as CurrencyUnit, _ as DailyLiquidityForecast, $ as DeclineToSignMessagesInput, a0 as DeclineToSignMessagesOutput, a1 as DeleteApiTokenInput, a2 as DeleteApiTokenOutput, a3 as Deposit, a5 as Entity, a6 as FailHtlcsInput, a7 as FailHtlcsOutput, a8 as FeeEstimate, a9 as FundNodeInput, aa as FundNodeOutput, ab as GraphNode, ac as Hop, ae as HtlcAttemptFailureCode, af as IdAndSignature, ag as IncentivesIneligibilityReason, ah as IncentivesStatus, ai as IncomingPayment, aj as IncomingPaymentAttempt, al as IncomingPaymentAttemptStatus, am as IncomingPaymentToAttemptsConnection, an as IncomingPaymentsForInvoiceQueryInput, ao as IncomingPaymentsForInvoiceQueryOutput, ap as Invoice, ar as InvoiceData, as as InvoiceForPaymentHashInput, at as InvoiceForPaymentHashOutput, au as InvoiceType, av as LightningFeeEstimateForInvoiceInput, aw as LightningFeeEstimateForNodeInput, ax as LightningFeeEstimateOutput, ay as LightningPaymentDirection, az as LightningTransaction, aB as LightsparkNode, aD as LightsparkNodeOwner, aF as LightsparkNodeStatus, aG as LightsparkNodeToChannelsConnection, aH as LightsparkNodeToDailyLiquidityForecastsConnection, aI as LightsparkNodeWithOSK, aJ as LightsparkNodeWithRemoteSigning, aK as MultiSigAddressValidationParameters, aL as Node, aN as NodeAddress, aO as NodeAddressType, aP as NodeToAddressesConnection, aQ as OnChainFeeTarget, aR as OnChainTransaction, aT as OutgoingPayment, aU as OutgoingPaymentAttempt, aV as OutgoingPaymentAttemptStatus, aW as OutgoingPaymentAttemptToHopsConnection, aX as OutgoingPaymentForIdempotencyKeyInput, aY as OutgoingPaymentForIdempotencyKeyOutput, aZ as OutgoingPaymentToAttemptsConnection, a_ as OutgoingPaymentsForInvoiceQueryInput, a$ as OutgoingPaymentsForInvoiceQueryOutput, b0 as OutgoingPaymentsForPaymentHashQueryInput, b1 as OutgoingPaymentsForPaymentHashQueryOutput, b2 as PageInfo, b3 as PayInvoiceInput, b4 as PayInvoiceOutput, b5 as PayUmaInvoiceInput, b6 as PaymentDirection, b7 as PaymentFailureReason, b8 as PaymentRequest, ba as PaymentRequestData, bb as PaymentRequestStatus, bc as Permission, bd as PostTransactionData, be as RegionCode, bf as RegisterPaymentInput, bg as RegisterPaymentOutput, bh as ReleaseChannelPerCommitmentSecretInput, bi as ReleaseChannelPerCommitmentSecretOutput, bj as ReleasePaymentPreimageInput, bk as ReleasePaymentPreimageOutput, bl as RemoteSigningSubEventType, bm as RequestWithdrawalInput, bn as RequestWithdrawalOutput, bo as RichText, bp as RiskRating, bq as RoutingTransaction, bs as RoutingTransactionFailureReason, bt as ScreenNodeInput, bu as ScreenNodeOutput, bv as Secret, bw as SendPaymentInput, bx as SendPaymentOutput, by as SetInvoicePaymentHashInput, bz as SetInvoicePaymentHashOutput, bA as SignInvoiceInput, bB as SignInvoiceOutput, bC as SignMessagesInput, bD as SignMessagesOutput, bE as Signable, bG as SignablePayload, bI as SignablePayloadStatus, bJ as SingleNodeDashboard, bK as Transaction, bM as TransactionFailures, bN as TransactionStatus, bO as TransactionType, bP as TransactionUpdate, bQ as UmaInvitation, bS as UpdateChannelPerCommitmentPointInput, bT as UpdateChannelPerCommitmentPointOutput, bU as UpdateNodeSharedSecretInput, bV as UpdateNodeSharedSecretOutput, bW as Wallet, bX as WalletStatus, bY as WalletToPaymentRequestsConnection, bZ as WalletToTransactionsConnection, b_ as WalletToWithdrawalRequestsConnection, W as WebhookEventType, b$ as Withdrawal, c1 as WithdrawalFeeEstimateInput, c2 as WithdrawalFeeEstimateOutput, c3 as WithdrawalMode, c4 as WithdrawalRequest, c5 as WithdrawalRequestStatus, c6 as WithdrawalRequestToChannelClosingTransactionsConnection, c7 as WithdrawalRequestToChannelOpeningTransactionsConnection, c8 as WithdrawalRequestToWithdrawalsConnection, i as getApiTokenQuery, k as getAuditLogActorQuery, p as getChannelClosingTransactionQuery, s as getChannelOpeningTransactionQuery, u as getChannelSnapshotQuery, a4 as getDepositQuery, ad as getHopQuery, ak as getIncomingPaymentAttemptQuery, aq as getInvoiceQuery, aA as getLightningTransactionQuery, aE as getLightsparkNodeOwnerQuery, aC as getLightsparkNodeQuery, aM as getNodeQuery, aS as getOnChainTransactionQuery, b9 as getPaymentRequestQuery, br as getRoutingTransactionQuery, bH as getSignablePayloadQuery, bF as getSignableQuery, bL as getTransactionQuery, bR as getUmaInvitationQuery, c0 as getWithdrawalQuery } from '../index-145ff316.js';
+export { A as Account, a as AccountToApiTokensConnection, b as AccountToChannelsConnection, c as AccountToNodesConnection, d as AccountToPaymentRequestsConnection, e as AccountToTransactionsConnection, f as AccountToWalletsConnection, g as AccountToWithdrawalRequestsConnection, h as ApiToken, j as AuditLogActor, B as Balances, l as BlockchainBalance, C as CancelInvoiceInput, m as CancelInvoiceOutput, n as Channel, o as ChannelClosingTransaction, q as ChannelFees, r as ChannelOpeningTransaction, t as ChannelSnapshot, v as ChannelStatus, w as ChannelToTransactionsConnection, x as ClaimUmaInvitationInput, y as ClaimUmaInvitationOutput, z as ClaimUmaInvitationWithIncentivesInput, D as ClaimUmaInvitationWithIncentivesOutput, E as ComplianceProvider, F as Connection, G as CreateApiTokenInput, H as CreateApiTokenOutput, I as CreateInvitationWithIncentivesInput, J as CreateInvitationWithIncentivesOutput, K as CreateInvoiceInput, M as CreateInvoiceOutput, N as CreateLnurlInvoiceInput, O as CreateNodeWalletAddressInput, P as CreateNodeWalletAddressOutput, Q as CreateTestModeInvoiceInput, R as CreateTestModeInvoiceOutput, S as CreateTestModePaymentInput, T as CreateTestModePaymentoutput, U as CreateUmaInvitationInput, V as CreateUmaInvitationOutput, X as CreateUmaInvoiceInput, Y as CurrencyAmount, Z as CurrencyUnit, _ as DailyLiquidityForecast, $ as DeclineToSignMessagesInput, a0 as DeclineToSignMessagesOutput, a1 as DeleteApiTokenInput, a2 as DeleteApiTokenOutput, a3 as Deposit, a5 as Entity, a6 as FailHtlcsInput, a7 as FailHtlcsOutput, a8 as FeeEstimate, a9 as FundNodeInput, aa as FundNodeOutput, ab as GraphNode, ac as Hop, ae as HtlcAttemptFailureCode, af as IdAndSignature, ag as IncentivesIneligibilityReason, ah as IncentivesStatus, ai as IncomingPayment, aj as IncomingPaymentAttempt, al as IncomingPaymentAttemptStatus, am as IncomingPaymentToAttemptsConnection, an as IncomingPaymentsForInvoiceQueryInput, ao as IncomingPaymentsForInvoiceQueryOutput, ap as Invoice, ar as InvoiceData, as as InvoiceForPaymentHashInput, at as InvoiceForPaymentHashOutput, au as InvoiceType, av as LightningFeeEstimateForInvoiceInput, aw as LightningFeeEstimateForNodeInput, ax as LightningFeeEstimateOutput, ay as LightningPaymentDirection, az as LightningTransaction, aB as LightsparkNode, aD as LightsparkNodeOwner, aF as LightsparkNodeStatus, aG as LightsparkNodeToChannelsConnection, aH as LightsparkNodeToDailyLiquidityForecastsConnection, aI as LightsparkNodeWithOSK, aJ as LightsparkNodeWithRemoteSigning, aK as MultiSigAddressValidationParameters, aL as Node, aN as NodeAddress, aO as NodeAddressType, aP as NodeToAddressesConnection, aQ as OnChainFeeTarget, aR as OnChainTransaction, aT as OutgoingPayment, aU as OutgoingPaymentAttempt, aV as OutgoingPaymentAttemptStatus, aW as OutgoingPaymentAttemptToHopsConnection, aX as OutgoingPaymentForIdempotencyKeyInput, aY as OutgoingPaymentForIdempotencyKeyOutput, aZ as OutgoingPaymentToAttemptsConnection, a_ as OutgoingPaymentsForInvoiceQueryInput, a$ as OutgoingPaymentsForInvoiceQueryOutput, b0 as OutgoingPaymentsForPaymentHashQueryInput, b1 as OutgoingPaymentsForPaymentHashQueryOutput, b2 as PageInfo, b3 as PayInvoiceInput, b4 as PayInvoiceOutput, b5 as PayUmaInvoiceInput, b6 as PaymentDirection, b7 as PaymentFailureReason, b8 as PaymentRequest, ba as PaymentRequestData, bb as PaymentRequestStatus, bc as Permission, bd as PostTransactionData, be as RegionCode, bf as RegisterPaymentInput, bg as RegisterPaymentOutput, bh as ReleaseChannelPerCommitmentSecretInput, bi as ReleaseChannelPerCommitmentSecretOutput, bj as ReleasePaymentPreimageInput, bk as ReleasePaymentPreimageOutput, bl as RemoteSigningSubEventType, bm as RequestInitiator, bn as RequestWithdrawalInput, bo as RequestWithdrawalOutput, bp as RichText, bq as RiskRating, br as RoutingTransaction, bt as RoutingTransactionFailureReason, bu as ScreenNodeInput, bv as ScreenNodeOutput, bw as Secret, bx as SendPaymentInput, by as SendPaymentOutput, bz as SetInvoicePaymentHashInput, bA as SetInvoicePaymentHashOutput, bB as SignInvoiceInput, bC as SignInvoiceOutput, bD as SignMessagesInput, bE as SignMessagesOutput, bF as Signable, bH as SignablePayload, bJ as SignablePayloadStatus, bK as SingleNodeDashboard, bL as Transaction, bN as TransactionFailures, bO as TransactionStatus, bP as TransactionType, bQ as TransactionUpdate, bR as UmaInvitation, bT as UpdateChannelPerCommitmentPointInput, bU as UpdateChannelPerCommitmentPointOutput, bV as UpdateNodeSharedSecretInput, bW as UpdateNodeSharedSecretOutput, bX as Wallet, bY as WalletStatus, bZ as WalletToPaymentRequestsConnection, b_ as WalletToTransactionsConnection, b$ as WalletToWithdrawalRequestsConnection, W as WebhookEventType, c0 as Withdrawal, c2 as WithdrawalFeeEstimateInput, c3 as WithdrawalFeeEstimateOutput, c4 as WithdrawalMode, c5 as WithdrawalRequest, c6 as WithdrawalRequestStatus, c7 as WithdrawalRequestToChannelClosingTransactionsConnection, c8 as WithdrawalRequestToChannelOpeningTransactionsConnection, c9 as WithdrawalRequestToWithdrawalsConnection, i as getApiTokenQuery, k as getAuditLogActorQuery, p as getChannelClosingTransactionQuery, s as getChannelOpeningTransactionQuery, u as getChannelSnapshotQuery, a4 as getDepositQuery, ad as getHopQuery, ak as getIncomingPaymentAttemptQuery, aq as getInvoiceQuery, aA as getLightningTransactionQuery, aE as getLightsparkNodeOwnerQuery, aC as getLightsparkNodeQuery, aM as getNodeQuery, aS as getOnChainTransactionQuery, b9 as getPaymentRequestQuery, bs as getRoutingTransactionQuery, bI as getSignablePayloadQuery, bG as getSignableQuery, bM as getTransactionQuery, bS as getUmaInvitationQuery, c1 as getWithdrawalQuery } from '../index-2f0cac65.js';
 export { B as BitcoinNetwork } from '../BitcoinNetwork-4f6ea015.js';
 import '@lightsparkdev/core';
 import 'zen-observable';

package/dist/objects/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Account, a as AccountToApiTokensConnection, b as AccountToChannelsConnection, c as AccountToNodesConnection, d as AccountToPaymentRequestsConnection, e as AccountToTransactionsConnection, f as AccountToWalletsConnection, g as AccountToWithdrawalRequestsConnection, h as ApiToken, j as AuditLogActor, B as Balances, l as BlockchainBalance, C as CancelInvoiceInput, m as CancelInvoiceOutput, n as Channel, o as ChannelClosingTransaction, q as ChannelFees, r as ChannelOpeningTransaction, t as ChannelSnapshot, v as ChannelStatus, w as ChannelToTransactionsConnection, x as ClaimUmaInvitationInput, y as ClaimUmaInvitationOutput, z as ClaimUmaInvitationWithIncentivesInput, D as ClaimUmaInvitationWithIncentivesOutput, E as ComplianceProvider, F as Connection, G as CreateApiTokenInput, H as CreateApiTokenOutput, I as CreateInvitationWithIncentivesInput, J as CreateInvitationWithIncentivesOutput, K as CreateInvoiceInput, M as CreateInvoiceOutput, N as CreateLnurlInvoiceInput, O as CreateNodeWalletAddressInput, P as CreateNodeWalletAddressOutput, Q as CreateTestModeInvoiceInput, R as CreateTestModeInvoiceOutput, S as CreateTestModePaymentInput, T as CreateTestModePaymentoutput, U as CreateUmaInvitationInput, V as CreateUmaInvitationOutput, X as CreateUmaInvoiceInput, Y as CurrencyAmount, Z as CurrencyUnit, _ as DailyLiquidityForecast, $ as DeclineToSignMessagesInput, a0 as DeclineToSignMessagesOutput, a1 as DeleteApiTokenInput, a2 as DeleteApiTokenOutput, a3 as Deposit, a5 as Entity, a6 as FailHtlcsInput, a7 as FailHtlcsOutput, a8 as FeeEstimate, a9 as FundNodeInput, aa as FundNodeOutput, ab as GraphNode, ac as Hop, ae as HtlcAttemptFailureCode, af as IdAndSignature, ag as IncentivesIneligibilityReason, ah as IncentivesStatus, ai as IncomingPayment, aj as IncomingPaymentAttempt, al as IncomingPaymentAttemptStatus, am as IncomingPaymentToAttemptsConnection, an as IncomingPaymentsForInvoiceQueryInput, ao as IncomingPaymentsForInvoiceQueryOutput, ap as Invoice, ar as InvoiceData, as as InvoiceForPaymentHashInput, at as InvoiceForPaymentHashOutput, au as InvoiceType, av as LightningFeeEstimateForInvoiceInput, aw as LightningFeeEstimateForNodeInput, ax as LightningFeeEstimateOutput, ay as LightningPaymentDirection, az as LightningTransaction, aB as LightsparkNode, aD as LightsparkNodeOwner, aF as LightsparkNodeStatus, aG as LightsparkNodeToChannelsConnection, aH as LightsparkNodeToDailyLiquidityForecastsConnection, aI as LightsparkNodeWithOSK, aJ as LightsparkNodeWithRemoteSigning, aK as MultiSigAddressValidationParameters, aL as Node, aN as NodeAddress, aO as NodeAddressType, aP as NodeToAddressesConnection, aQ as OnChainFeeTarget, aR as OnChainTransaction, aT as OutgoingPayment, aU as OutgoingPaymentAttempt, aV as OutgoingPaymentAttemptStatus, aW as OutgoingPaymentAttemptToHopsConnection, aX as OutgoingPaymentForIdempotencyKeyInput, aY as OutgoingPaymentForIdempotencyKeyOutput, aZ as OutgoingPaymentToAttemptsConnection, a_ as OutgoingPaymentsForInvoiceQueryInput, a$ as OutgoingPaymentsForInvoiceQueryOutput, b0 as OutgoingPaymentsForPaymentHashQueryInput, b1 as OutgoingPaymentsForPaymentHashQueryOutput, b2 as PageInfo, b3 as PayInvoiceInput, b4 as PayInvoiceOutput, b5 as PayUmaInvoiceInput, b6 as PaymentDirection, b7 as PaymentFailureReason, b8 as PaymentRequest, ba as PaymentRequestData, bb as PaymentRequestStatus, bc as Permission, bd as PostTransactionData, be as RegionCode, bf as RegisterPaymentInput, bg as RegisterPaymentOutput, bh as ReleaseChannelPerCommitmentSecretInput, bi as ReleaseChannelPerCommitmentSecretOutput, bj as ReleasePaymentPreimageInput, bk as ReleasePaymentPreimageOutput, bl as RemoteSigningSubEventType, bm as RequestWithdrawalInput, bn as RequestWithdrawalOutput, bo as RichText, bp as RiskRating, bq as RoutingTransaction, bs as RoutingTransactionFailureReason, bt as ScreenNodeInput, bu as ScreenNodeOutput, bv as Secret, bw as SendPaymentInput, bx as SendPaymentOutput, by as SetInvoicePaymentHashInput, bz as SetInvoicePaymentHashOutput, bA as SignInvoiceInput, bB as SignInvoiceOutput, bC as SignMessagesInput, bD as SignMessagesOutput, bE as Signable, bG as SignablePayload, bI as SignablePayloadStatus, bJ as SingleNodeDashboard, bK as Transaction, bM as TransactionFailures, bN as TransactionStatus, bO as TransactionType, bP as TransactionUpdate, bQ as UmaInvitation, bS as UpdateChannelPerCommitmentPointInput, bT as UpdateChannelPerCommitmentPointOutput, bU as UpdateNodeSharedSecretInput, bV as UpdateNodeSharedSecretOutput, bW as Wallet, bX as WalletStatus, bY as WalletToPaymentRequestsConnection, bZ as WalletToTransactionsConnection, b_ as WalletToWithdrawalRequestsConnection, W as WebhookEventType, b$ as Withdrawal, c1 as WithdrawalFeeEstimateInput, c2 as WithdrawalFeeEstimateOutput, c3 as WithdrawalMode, c4 as WithdrawalRequest, c5 as WithdrawalRequestStatus, c6 as WithdrawalRequestToChannelClosingTransactionsConnection, c7 as WithdrawalRequestToChannelOpeningTransactionsConnection, c8 as WithdrawalRequestToWithdrawalsConnection, i as getApiTokenQuery, k as getAuditLogActorQuery, p as getChannelClosingTransactionQuery, s as getChannelOpeningTransactionQuery, u as getChannelSnapshotQuery, a4 as getDepositQuery, ad as getHopQuery, ak as getIncomingPaymentAttemptQuery, aq as getInvoiceQuery, aA as getLightningTransactionQuery, aE as getLightsparkNodeOwnerQuery, aC as getLightsparkNodeQuery, aM as getNodeQuery, aS as getOnChainTransactionQuery, b9 as getPaymentRequestQuery, br as getRoutingTransactionQuery, bH as getSignablePayloadQuery, bF as getSignableQuery, bL as getTransactionQuery, bR as getUmaInvitationQuery, c0 as getWithdrawalQuery } from '../index-145ff316.js';
+export { A as Account, a as AccountToApiTokensConnection, b as AccountToChannelsConnection, c as AccountToNodesConnection, d as AccountToPaymentRequestsConnection, e as AccountToTransactionsConnection, f as AccountToWalletsConnection, g as AccountToWithdrawalRequestsConnection, h as ApiToken, j as AuditLogActor, B as Balances, l as BlockchainBalance, C as CancelInvoiceInput, m as CancelInvoiceOutput, n as Channel, o as ChannelClosingTransaction, q as ChannelFees, r as ChannelOpeningTransaction, t as ChannelSnapshot, v as ChannelStatus, w as ChannelToTransactionsConnection, x as ClaimUmaInvitationInput, y as ClaimUmaInvitationOutput, z as ClaimUmaInvitationWithIncentivesInput, D as ClaimUmaInvitationWithIncentivesOutput, E as ComplianceProvider, F as Connection, G as CreateApiTokenInput, H as CreateApiTokenOutput, I as CreateInvitationWithIncentivesInput, J as CreateInvitationWithIncentivesOutput, K as CreateInvoiceInput, M as CreateInvoiceOutput, N as CreateLnurlInvoiceInput, O as CreateNodeWalletAddressInput, P as CreateNodeWalletAddressOutput, Q as CreateTestModeInvoiceInput, R as CreateTestModeInvoiceOutput, S as CreateTestModePaymentInput, T as CreateTestModePaymentoutput, U as CreateUmaInvitationInput, V as CreateUmaInvitationOutput, X as CreateUmaInvoiceInput, Y as CurrencyAmount, Z as CurrencyUnit, _ as DailyLiquidityForecast, $ as DeclineToSignMessagesInput, a0 as DeclineToSignMessagesOutput, a1 as DeleteApiTokenInput, a2 as DeleteApiTokenOutput, a3 as Deposit, a5 as Entity, a6 as FailHtlcsInput, a7 as FailHtlcsOutput, a8 as FeeEstimate, a9 as FundNodeInput, aa as FundNodeOutput, ab as GraphNode, ac as Hop, ae as HtlcAttemptFailureCode, af as IdAndSignature, ag as IncentivesIneligibilityReason, ah as IncentivesStatus, ai as IncomingPayment, aj as IncomingPaymentAttempt, al as IncomingPaymentAttemptStatus, am as IncomingPaymentToAttemptsConnection, an as IncomingPaymentsForInvoiceQueryInput, ao as IncomingPaymentsForInvoiceQueryOutput, ap as Invoice, ar as InvoiceData, as as InvoiceForPaymentHashInput, at as InvoiceForPaymentHashOutput, au as InvoiceType, av as LightningFeeEstimateForInvoiceInput, aw as LightningFeeEstimateForNodeInput, ax as LightningFeeEstimateOutput, ay as LightningPaymentDirection, az as LightningTransaction, aB as LightsparkNode, aD as LightsparkNodeOwner, aF as LightsparkNodeStatus, aG as LightsparkNodeToChannelsConnection, aH as LightsparkNodeToDailyLiquidityForecastsConnection, aI as LightsparkNodeWithOSK, aJ as LightsparkNodeWithRemoteSigning, aK as MultiSigAddressValidationParameters, aL as Node, aN as NodeAddress, aO as NodeAddressType, aP as NodeToAddressesConnection, aQ as OnChainFeeTarget, aR as OnChainTransaction, aT as OutgoingPayment, aU as OutgoingPaymentAttempt, aV as OutgoingPaymentAttemptStatus, aW as OutgoingPaymentAttemptToHopsConnection, aX as OutgoingPaymentForIdempotencyKeyInput, aY as OutgoingPaymentForIdempotencyKeyOutput, aZ as OutgoingPaymentToAttemptsConnection, a_ as OutgoingPaymentsForInvoiceQueryInput, a$ as OutgoingPaymentsForInvoiceQueryOutput, b0 as OutgoingPaymentsForPaymentHashQueryInput, b1 as OutgoingPaymentsForPaymentHashQueryOutput, b2 as PageInfo, b3 as PayInvoiceInput, b4 as PayInvoiceOutput, b5 as PayUmaInvoiceInput, b6 as PaymentDirection, b7 as PaymentFailureReason, b8 as PaymentRequest, ba as PaymentRequestData, bb as PaymentRequestStatus, bc as Permission, bd as PostTransactionData, be as RegionCode, bf as RegisterPaymentInput, bg as RegisterPaymentOutput, bh as ReleaseChannelPerCommitmentSecretInput, bi as ReleaseChannelPerCommitmentSecretOutput, bj as ReleasePaymentPreimageInput, bk as ReleasePaymentPreimageOutput, bl as RemoteSigningSubEventType, bm as RequestInitiator, bn as RequestWithdrawalInput, bo as RequestWithdrawalOutput, bp as RichText, bq as RiskRating, br as RoutingTransaction, bt as RoutingTransactionFailureReason, bu as ScreenNodeInput, bv as ScreenNodeOutput, bw as Secret, bx as SendPaymentInput, by as SendPaymentOutput, bz as SetInvoicePaymentHashInput, bA as SetInvoicePaymentHashOutput, bB as SignInvoiceInput, bC as SignInvoiceOutput, bD as SignMessagesInput, bE as SignMessagesOutput, bF as Signable, bH as SignablePayload, bJ as SignablePayloadStatus, bK as SingleNodeDashboard, bL as Transaction, bN as TransactionFailures, bO as TransactionStatus, bP as TransactionType, bQ as TransactionUpdate, bR as UmaInvitation, bT as UpdateChannelPerCommitmentPointInput, bU as UpdateChannelPerCommitmentPointOutput, bV as UpdateNodeSharedSecretInput, bW as UpdateNodeSharedSecretOutput, bX as Wallet, bY as WalletStatus, bZ as WalletToPaymentRequestsConnection, b_ as WalletToTransactionsConnection, b$ as WalletToWithdrawalRequestsConnection, W as WebhookEventType, c0 as Withdrawal, c2 as WithdrawalFeeEstimateInput, c3 as WithdrawalFeeEstimateOutput, c4 as WithdrawalMode, c5 as WithdrawalRequest, c6 as WithdrawalRequestStatus, c7 as WithdrawalRequestToChannelClosingTransactionsConnection, c8 as WithdrawalRequestToChannelOpeningTransactionsConnection, c9 as WithdrawalRequestToWithdrawalsConnection, i as getApiTokenQuery, k as getAuditLogActorQuery, p as getChannelClosingTransactionQuery, s as getChannelOpeningTransactionQuery, u as getChannelSnapshotQuery, a4 as getDepositQuery, ad as getHopQuery, ak as getIncomingPaymentAttemptQuery, aq as getInvoiceQuery, aA as getLightningTransactionQuery, aE as getLightsparkNodeOwnerQuery, aC as getLightsparkNodeQuery, aM as getNodeQuery, aS as getOnChainTransactionQuery, b9 as getPaymentRequestQuery, bs as getRoutingTransactionQuery, bI as getSignablePayloadQuery, bG as getSignableQuery, bM as getTransactionQuery, bS as getUmaInvitationQuery, c1 as getWithdrawalQuery } from '../index-2f0cac65.js';
 export { B as BitcoinNetwork } from '../BitcoinNetwork-4f6ea015.js';
 import '@lightsparkdev/core';
 import 'zen-observable';

package/dist/objects/index.js

@@ -26,6 +26,7 @@ import {
   Permission_default,
   RegionCode_default,
   RemoteSigningSubEventType_default,
+  RequestInitiator_default,
   RiskRating_default,
   RoutingTransactionFailureReason_default,
   SignablePayloadStatus_default,
@@ -58,7 +59,7 @@ import {
   getTransactionQuery,
   getUmaInvitationQuery,
   getWithdrawalQuery
-} from "../chunk-UHTZSOPX.js";
+} from "../chunk-DSWMAFFH.js";
 import {
   BitcoinNetwork_default
 } from "../chunk-K6SAUSAX.js";
@@ -92,6 +93,7 @@ export {
   Permission_default as Permission,
   RegionCode_default as RegionCode,
   RemoteSigningSubEventType_default as RemoteSigningSubEventType,
+  RequestInitiator_default as RequestInitiator,
   RiskRating_default as RiskRating,
   RoutingTransactionFailureReason_default as RoutingTransactionFailureReason,
   SignablePayloadStatus_default as SignablePayloadStatus,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [

package/src/client.ts

@@ -20,6 +20,7 @@ import {
   Requester,
   SigningKeyType,
   StubAuthProvider,
+  bytesToHex,
   createSha256Hash,
   pollUntil,
 } from "@lightsparkdev/core";
@@ -588,6 +589,9 @@ class LightsparkClient {
    *     h-tag (SHA256 purpose of payment) of the resulting Bolt 11 invoice. See
    *     [this spec](https://github.com/lnurl/luds/blob/luds/06.md#pay-to-static-qrnfclink) for details.
    * @param expirySecs The number of seconds until the invoice expires. Defaults to 3600 (1 hour).
+   * @param signingPrivateKey The receiver's signing private key. Used to hash the receiver identifier.
+   * @param receiverIdentifier Optional identifier of the receiver. If provided, this will be hashed using a
+   *     monthly-rotated seed and used for anonymized analysis.
    * @returns An Invoice object representing the generated invoice.
    */
   public async createUmaInvoice(
@@ -595,14 +599,33 @@ class LightsparkClient {
     amountMsats: number,
     metadata: string,
     expirySecs: number | undefined = undefined,
+    signingPrivateKey: Uint8Array | undefined = undefined,
+    receiverIdentifier: string | undefined = undefined,
   ): Promise<Invoice | undefined> {
     const metadataHash = await createSha256Hash(metadata, true);
-    const variables = {
+    let receiverHash: string | undefined = undefined;
+    if (receiverIdentifier !== undefined) {
+      if (signingPrivateKey == undefined) {
+        throw new LightsparkException(
+          "CreateUmaInvoiceError",
+          "Receiver identifier provided without signing private key",
+        );
+      }
+      receiverHash = await this.hashUmaIdentifier(
+        receiverIdentifier,
+        signingPrivateKey,
+      );
+    }
+
+    const variables: Record<string, string | number> = {
       node_id: nodeId,
       amount_msats: amountMsats,
       metadata_hash: metadataHash,
       expiry_secs: expirySecs !== undefined ? expirySecs : 3600,
     };
+    if (receiverHash !== undefined) {
+      variables.receiver_hash = receiverHash;
+    }
     const response = await this.requester.makeRawRequest(
       CreateUmaInvoice,
       variables,
@@ -851,6 +874,9 @@ class LightsparkClient {
    * @param amountMsats The amount to pay in msats for a zero-amount invoice. Defaults to the full amount of the
    *     invoice. NOTE: This parameter can only be passed for a zero-amount
    *     invoice. Otherwise, the call will fail.
+   * @param signingPrivateKey The sender's signing private key. Used to hash the sender identifier.
+   * @param senderIdentifier Optional identifier of the sender. If provided, this will be hashed using a
+   *     monthly-rotated seed and used for anonymized analysis.
    * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
    */
   public async payUmaInvoice(
@@ -859,10 +885,27 @@ class LightsparkClient {
     maximumFeesMsats: number,
     timeoutSecs: number = 60,
     amountMsats: number | undefined = undefined,
+    signingPrivateKey: Uint8Array | undefined = undefined,
+    senderIdentifier: string | undefined = undefined,
   ): Promise<OutgoingPayment | undefined> {
     if (!this.nodeKeyCache.hasKey(payerNodeId)) {
       throw new LightsparkSigningException("Paying node is not unlocked");
     }
+
+    let senderHash: string | undefined = undefined;
+    if (senderIdentifier !== undefined) {
+      if (signingPrivateKey == undefined) {
+        throw new LightsparkException(
+          "PayUmaInvoiceError",
+          "Sender identifier provided without signing private key",
+        );
+      }
+      senderHash = await this.hashUmaIdentifier(
+        senderIdentifier,
+        signingPrivateKey,
+      );
+    }
+
     const variables: Record<string, string | number> = {
       node_id: payerNodeId,
       encoded_invoice: encodedInvoice,
@@ -872,6 +915,9 @@ class LightsparkClient {
     if (amountMsats !== undefined) {
       variables.amount_msats = amountMsats;
     }
+    if (senderHash !== undefined) {
+      variables.sender_hash = senderHash;
+    }
     const response = await this.requester.makeRawRequest(
       PayUmaInvoice,
       variables,
@@ -1496,6 +1542,22 @@ class LightsparkClient {
     return await createSha256Hash(e164PhoneNumber, true);
   }
 
+  public async hashUmaIdentifier(
+    identifier: string,
+    signingPrivateKey: Uint8Array,
+  ): Promise<string> {
+    const now = this.getUtcDateTime();
+    const input =
+      identifier +
+      `${now.getUTCMonth() + 1}-${now.getUTCFullYear()}` +
+      bytesToHex(signingPrivateKey);
+    return await createSha256Hash(input, true);
+  }
+
+  getUtcDateTime(): Date {
+    return new Date();
+  }
+
   /**
    * Executes a raw `Query` against the Lightspark API.
    *

package/src/graphql/CreateUmaInvoice.ts

@@ -7,12 +7,14 @@ mutation CreateUmaInvoice(
   $amount_msats: Long!
   $metadata_hash: String!
   $expiry_secs: Int = null
+  $receiver_hash: String = null
 ) {
   create_uma_invoice(input: {
       node_id: $node_id
       amount_msats: $amount_msats
       metadata_hash: $metadata_hash
       expiry_secs: $expiry_secs
+      receiver_hash: $receiver_hash
   }) {
       invoice {
           ...InvoiceFragment

package/src/graphql/PayUmaInvoice.ts

@@ -9,6 +9,7 @@ export const PayUmaInvoice = `
     $timeout_secs: Int!
     $maximum_fees_msats: Long!
     $amount_msats: Long
+    $sender_hash: String = null
   ) {
     pay_uma_invoice(
       input: {
@@ -17,6 +18,7 @@ export const PayUmaInvoice = `
         timeout_secs: $timeout_secs
         maximum_fees_msats: $maximum_fees_msats
         amount_msats: $amount_msats
+        sender_hash: $sender_hash
       }
     ) {
       payment {

package/src/objects/Account.ts

@@ -1777,6 +1777,7 @@ query FetchAccountToWithdrawalRequestsConnection($first: Int, $after: String, $b
                         id
                     }
                     withdrawal_request_idempotency_key: idempotency_key
+                    withdrawal_request_initiator: initiator
                 }
             }
         }

package/src/objects/CreateLnurlInvoiceInput.ts

@@ -15,6 +15,10 @@ interface CreateLnurlInvoiceInput {
 
   /** The expiry of the invoice in seconds. Default value is 86400 (1 day). **/
   expirySecs?: number | undefined;
+
+  /** An optional, monthly-rotated, unique hashed identifier corresponding to the receiver of the
+   * payment. **/
+  receiverHash?: string | undefined;
 }
 
 export const CreateLnurlInvoiceInputFromJson = (
@@ -25,6 +29,7 @@ export const CreateLnurlInvoiceInputFromJson = (
     amountMsats: obj["create_lnurl_invoice_input_amount_msats"],
     metadataHash: obj["create_lnurl_invoice_input_metadata_hash"],
     expirySecs: obj["create_lnurl_invoice_input_expiry_secs"],
+    receiverHash: obj["create_lnurl_invoice_input_receiver_hash"],
   } as CreateLnurlInvoiceInput;
 };
 export const CreateLnurlInvoiceInputToJson = (
@@ -35,6 +40,7 @@ export const CreateLnurlInvoiceInputToJson = (
     create_lnurl_invoice_input_amount_msats: obj.amountMsats,
     create_lnurl_invoice_input_metadata_hash: obj.metadataHash,
     create_lnurl_invoice_input_expiry_secs: obj.expirySecs,
+    create_lnurl_invoice_input_receiver_hash: obj.receiverHash,
   };
 };
 

package/src/objects/CreateUmaInvoiceInput.ts

@@ -8,6 +8,8 @@ interface CreateUmaInvoiceInput {
   metadataHash: string;
 
   expirySecs?: number | undefined;
+
+  receiverHash?: string | undefined;
 }
 
 export const CreateUmaInvoiceInputFromJson = (
@@ -18,6 +20,7 @@ export const CreateUmaInvoiceInputFromJson = (
     amountMsats: obj["create_uma_invoice_input_amount_msats"],
     metadataHash: obj["create_uma_invoice_input_metadata_hash"],
     expirySecs: obj["create_uma_invoice_input_expiry_secs"],
+    receiverHash: obj["create_uma_invoice_input_receiver_hash"],
   } as CreateUmaInvoiceInput;
 };
 export const CreateUmaInvoiceInputToJson = (
@@ -28,6 +31,7 @@ export const CreateUmaInvoiceInputToJson = (
     create_uma_invoice_input_amount_msats: obj.amountMsats,
     create_uma_invoice_input_metadata_hash: obj.metadataHash,
     create_uma_invoice_input_expiry_secs: obj.expirySecs,
+    create_uma_invoice_input_receiver_hash: obj.receiverHash,
   };
 };
 

package/src/objects/CurrencyUnit.ts

@@ -18,7 +18,7 @@ export enum CurrencyUnit {
    */
   SATOSHI = "SATOSHI",
   /**
-   * 0.001 Satoshi, or 10e-11 Bitcoin. We recommend using the Satoshi unit instead when possible. *
+   * 0.001 Satoshi, or 10e-11 Bitcoin. We recommend using the Satoshi unit instead when possible.
    */
   MILLISATOSHI = "MILLISATOSHI",
   /** United States Dollar. **/

package/src/objects/Entity.ts

@@ -1515,6 +1515,7 @@ fragment EntityFragment on Entity {
             id
         }
         withdrawal_request_idempotency_key: idempotency_key
+        withdrawal_request_initiator: initiator
     }
 }`;
 

package/src/objects/PayUmaInvoiceInput.ts

@@ -12,6 +12,12 @@ interface PayUmaInvoiceInput {
   amountMsats?: number | undefined;
 
   idempotencyKey?: string | undefined;
+
+  /**
+   * An optional, monthly-rotated, unique hashed identifier corresponding to the sender of the
+   * payment. *
+   */
+  senderHash?: string | undefined;
 }
 
 export const PayUmaInvoiceInputFromJson = (obj: any): PayUmaInvoiceInput => {
@@ -22,6 +28,7 @@ export const PayUmaInvoiceInputFromJson = (obj: any): PayUmaInvoiceInput => {
     maximumFeesMsats: obj["pay_uma_invoice_input_maximum_fees_msats"],
     amountMsats: obj["pay_uma_invoice_input_amount_msats"],
     idempotencyKey: obj["pay_uma_invoice_input_idempotency_key"],
+    senderHash: obj["pay_uma_invoice_input_sender_hash"],
   } as PayUmaInvoiceInput;
 };
 export const PayUmaInvoiceInputToJson = (obj: PayUmaInvoiceInput): any => {
@@ -32,6 +39,7 @@ export const PayUmaInvoiceInputToJson = (obj: PayUmaInvoiceInput): any => {
     pay_uma_invoice_input_maximum_fees_msats: obj.maximumFeesMsats,
     pay_uma_invoice_input_amount_msats: obj.amountMsats,
     pay_uma_invoice_input_idempotency_key: obj.idempotencyKey,
+    pay_uma_invoice_input_sender_hash: obj.senderHash,
   };
 };
 

package/src/objects/RequestInitiator.ts

@@ -0,0 +1,15 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+export enum RequestInitiator {
+  /**
+   * This is an enum value that represents values that could be added in the future.
+   * Clients should support unknown values as more of them could be added without notice.
+   */
+  FUTURE_VALUE = "FUTURE_VALUE",
+
+  CUSTOMER = "CUSTOMER",
+
+  LIGHTSPARK = "LIGHTSPARK",
+}
+
+export default RequestInitiator;

package/src/objects/TransactionStatus.ts

@@ -17,7 +17,7 @@ export enum TransactionStatus {
   /** Transaction has been initiated and is currently in-flight. **/
   PENDING = "PENDING",
   /**
-   * For transaction type PAYMENT_REQUEST only. No payments have been made to a payment request. *
+   * For transaction type PAYMENT_REQUEST only. No payments have been made to a payment request.
    */
   NOT_STARTED = "NOT_STARTED",
   /** For transaction type PAYMENT_REQUEST only. A payment request has expired. **/

package/src/objects/Wallet.ts

@@ -1109,6 +1109,7 @@ query FetchWalletToWithdrawalRequestsConnection($entity_id: ID!, $first: Int, $a
                         id
                     }
                     withdrawal_request_idempotency_key: idempotency_key
+                    withdrawal_request_initiator: initiator
                 }
             }
         }

package/src/objects/WalletStatus.ts

@@ -33,8 +33,8 @@ export enum WalletStatus {
   TERMINATING = "TERMINATING",
   /**
    * The wallet has been terminated and is not available in the Lightspark infrastructure anymore.
-   * It is not connected to the Lightning network and its funds can only be accessed using the
-   * Funds Recovery flow. *
+   * It is not connected to the Lightning network and its funds can only be accessed using the Funds
+   * Recovery flow. *
    */
   TERMINATED = "TERMINATED",
 }