@lightsparkdev/lightspark-sdk 1.2.2 → 1.3.0

package/dist/index.cjs

@@ -1949,7 +1949,7 @@ var import_core9 = require("@lightsparkdev/core");
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.2.2",
+  version: "1.3.0",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -2018,7 +2018,7 @@ var package_default = {
   ],
   scripts: {
     build: "yarn tsc && tsup",
-    "build:watch": "yarn build --watch",
+    "build:watch": "yarn build --watch --clean=false",
     clean: "rm -rf .turbo && rm -rf dist",
     dev: "yarn build -- --watch",
     docs: "typedoc src",
@@ -2037,7 +2037,7 @@ var package_default = {
   },
   license: "Apache-2.0",
   dependencies: {
-    "@lightsparkdev/core": "1.0.10",
+    "@lightsparkdev/core": "1.0.12",
     "@lightsparkdev/crypto-wasm": "0.1.2",
     "auto-bind": "^5.0.1",
     "crypto-browserify": "^3.12.0",
@@ -2064,7 +2064,184 @@ var package_default = {
     "tsc-absolute": "^1.0.1",
     tsup: "^7.2.0",
     typedoc: "^0.24.7",
-    typescript: "^4.9.5"
+    typescript: "^5.0.0"
+  }
+};
+
+// src/NodeKeyLoaderCache.ts
+var import_core3 = require("@lightsparkdev/core");
+
+// src/SigningKeyLoader.ts
+var import_core2 = require("@lightsparkdev/core");
+
+// src/graphql/RecoverNodeSigningKey.ts
+var RecoverNodeSigningKey = `
+  query RecoverNodeSigningKey($nodeId: ID!) {
+    entity(id: $nodeId) {
+      __typename
+      ... on LightsparkNodeWithOSK {
+        encrypted_signing_private_key {
+          encrypted_value
+          cipher
+        }
+      }
+    }
+  }
+`;
+
+// src/SigningKeyLoader.ts
+var SIGNING_KEY_PATH = "m/5";
+function isNodeIdAndPasswordSigningKeyLoaderArgs(args) {
+  return args.password !== void 0;
+}
+function isMasterSeedSigningKeyLoaderArgs(args) {
+  return args.masterSeed !== void 0;
+}
+var NodeIdAndPasswordSigningKeyLoader = class {
+  nodeId;
+  password;
+  requester;
+  cryptoImpl;
+  constructor(args, requester, cryptoImpl) {
+    this.nodeId = args.nodeId;
+    this.password = args.password;
+    this.requester = requester;
+    this.cryptoImpl = cryptoImpl;
+  }
+  async loadSigningKey() {
+    const encryptedKey = await this.recoverNodeSigningKey();
+    if (!encryptedKey) {
+      console.warn("No encrypted key found for node " + this.nodeId);
+      return;
+    }
+    const signingPrivateKey = await this.cryptoImpl.decryptSecretWithNodePassword(
+      encryptedKey.cipher,
+      encryptedKey.encrypted_value,
+      this.password
+    );
+    if (!signingPrivateKey) {
+      throw new import_core2.LightsparkSigningException(
+        "Unable to decrypt signing key with provided password. Please try again."
+      );
+    }
+    let signingPrivateKeyPEM = "";
+    if (new Uint8Array(signingPrivateKey)[0] === 48) {
+      signingPrivateKeyPEM = (0, import_core2.b64encode)(signingPrivateKey);
+    } else {
+      const dec = new TextDecoder();
+      signingPrivateKeyPEM = dec.decode(signingPrivateKey);
+    }
+    return { key: signingPrivateKeyPEM, type: import_core2.SigningKeyType.RSASigningKey };
+  }
+  async recoverNodeSigningKey() {
+    const response = await this.requester.makeRawRequest(
+      RecoverNodeSigningKey,
+      { nodeId: this.nodeId }
+    );
+    const nodeEntity = response.entity;
+    if (nodeEntity?.__typename === "LightsparkNodeWithOSK") {
+      return nodeEntity.encrypted_signing_private_key;
+    }
+    return null;
+  }
+};
+var MasterSeedSigningKeyLoader = class {
+  masterSeed;
+  network;
+  constructor(args) {
+    this.masterSeed = args.masterSeed;
+    this.network = args.network;
+  }
+  async loadSigningKey() {
+    if (import_core2.isBrowser) {
+      throw new import_core2.LightsparkSigningException(
+        "Browser environments not supported for master seed signing key loader."
+      );
+    }
+    const { LightsparkSigner, Network } = await import("@lightsparkdev/crypto-wasm");
+    let cryptoLibNetwork;
+    switch (this.network) {
+      case BitcoinNetwork_default.MAINNET:
+        cryptoLibNetwork = Network.Bitcoin;
+        break;
+      case BitcoinNetwork_default.TESTNET:
+        cryptoLibNetwork = Network.Testnet;
+        break;
+      case BitcoinNetwork_default.REGTEST:
+        cryptoLibNetwork = Network.Regtest;
+        break;
+      default:
+        throw new Error(
+          `Unsupported lightspark_crypto network ${this.network}.`
+        );
+    }
+    const lightsparkSigner = LightsparkSigner.from_bytes(
+      this.masterSeed,
+      cryptoLibNetwork
+    );
+    const privateKey = lightsparkSigner.derive_private_key(SIGNING_KEY_PATH);
+    return { key: privateKey, type: import_core2.SigningKeyType.Secp256k1SigningKey };
+  }
+};
+
+// src/NodeKeyLoaderCache.ts
+var NodeKeyLoaderCache = class {
+  constructor(nodeKeyCache, cryptoImpl = import_core3.DefaultCrypto) {
+    this.nodeKeyCache = nodeKeyCache;
+    this.cryptoImpl = cryptoImpl;
+    this.idToLoader = /* @__PURE__ */ new Map();
+  }
+  idToLoader;
+  /**
+   * Sets the signing key loader for a node.
+   * Instantiates a signing key loader based on the type of args passed in by
+   * the user.
+   *
+   * @param nodeId The ID of the node to get the key for
+   * @param loaderArgs Loader arguments for loading the key
+   * @param requester Requester used for loading the key
+   */
+  setLoader(nodeId, loaderArgs, requester) {
+    let loader;
+    if (isNodeIdAndPasswordSigningKeyLoaderArgs(loaderArgs)) {
+      loader = new NodeIdAndPasswordSigningKeyLoader(
+        { nodeId, ...loaderArgs },
+        requester,
+        this.cryptoImpl
+      );
+    } else if (isMasterSeedSigningKeyLoaderArgs(loaderArgs)) {
+      loader = new MasterSeedSigningKeyLoader({ ...loaderArgs });
+    } else {
+      throw new import_core3.LightsparkSigningException("Invalid signing key loader args");
+    }
+    this.idToLoader.set(nodeId, loader);
+  }
+  /**
+   * Gets the key for a node using the loader set by [setLoader]
+   *
+   * @param id The ID of the node to get the key for
+   * @returns The loaded key
+   */
+  async getKeyWithLoader(id) {
+    if (this.nodeKeyCache.hasKey(id)) {
+      return this.nodeKeyCache.getKey(id);
+    }
+    const loader = this.idToLoader.get(id);
+    if (!loader) {
+      throw new import_core3.LightsparkSigningException(
+        "No signing key loader found for node " + id
+      );
+    }
+    const loaderResult = await loader.loadSigningKey();
+    if (!loaderResult) {
+      return;
+    }
+    const key = await this.nodeKeyCache.loadKey(
+      id,
+      { key: loaderResult.key },
+      loaderResult.type
+    );
+    return key || void 0;
   }
 };
 
@@ -2150,217 +2327,6 @@ var BitcoinFeeEstimate = `
   ${FRAGMENT2}
 `;
 
-// src/objects/IncentivesIneligibilityReason.ts
-var IncentivesIneligibilityReason = /* @__PURE__ */ ((IncentivesIneligibilityReason2) => {
-  IncentivesIneligibilityReason2["FUTURE_VALUE"] = "FUTURE_VALUE";
-  IncentivesIneligibilityReason2["DISABLED"] = "DISABLED";
-  IncentivesIneligibilityReason2["SENDER_NOT_ELIGIBLE"] = "SENDER_NOT_ELIGIBLE";
-  IncentivesIneligibilityReason2["RECEIVER_NOT_ELIGIBLE"] = "RECEIVER_NOT_ELIGIBLE";
-  IncentivesIneligibilityReason2["SENDING_VASP_NOT_ELIGIBLE"] = "SENDING_VASP_NOT_ELIGIBLE";
-  IncentivesIneligibilityReason2["RECEIVING_VASP_NOT_ELIGIBLE"] = "RECEIVING_VASP_NOT_ELIGIBLE";
-  IncentivesIneligibilityReason2["NOT_CROSS_BORDER"] = "NOT_CROSS_BORDER";
-  return IncentivesIneligibilityReason2;
-})(IncentivesIneligibilityReason || {});
-var IncentivesIneligibilityReason_default = IncentivesIneligibilityReason;
-
-// src/objects/IncentivesStatus.ts
-var IncentivesStatus = /* @__PURE__ */ ((IncentivesStatus2) => {
-  IncentivesStatus2["FUTURE_VALUE"] = "FUTURE_VALUE";
-  IncentivesStatus2["PENDING"] = "PENDING";
-  IncentivesStatus2["VALIDATED"] = "VALIDATED";
-  IncentivesStatus2["INELIGIBLE"] = "INELIGIBLE";
-  return IncentivesStatus2;
-})(IncentivesStatus || {});
-var IncentivesStatus_default = IncentivesStatus;
-
-// src/objects/UmaInvitation.ts
-var UmaInvitationFromJson = (obj) => {
-  return {
-    id: obj["uma_invitation_id"],
-    createdAt: obj["uma_invitation_created_at"],
-    updatedAt: obj["uma_invitation_updated_at"],
-    code: obj["uma_invitation_code"],
-    url: obj["uma_invitation_url"],
-    inviterUma: obj["uma_invitation_inviter_uma"],
-    incentivesStatus: IncentivesStatus_default[obj["uma_invitation_incentives_status"]] ?? IncentivesStatus_default.FUTURE_VALUE,
-    typename: "UmaInvitation",
-    inviteeUma: obj["uma_invitation_invitee_uma"],
-    incentivesIneligibilityReason: !!obj["uma_invitation_incentives_ineligibility_reason"] ? IncentivesIneligibilityReason_default[obj["uma_invitation_incentives_ineligibility_reason"]] ?? IncentivesIneligibilityReason_default.FUTURE_VALUE : null
-  };
-};
-var FRAGMENT3 = `
-fragment UmaInvitationFragment on UmaInvitation {
-    __typename
-    uma_invitation_id: id
-    uma_invitation_created_at: created_at
-    uma_invitation_updated_at: updated_at
-    uma_invitation_code: code
-    uma_invitation_url: url
-    uma_invitation_inviter_uma: inviter_uma
-    uma_invitation_invitee_uma: invitee_uma
-    uma_invitation_incentives_status: incentives_status
-    uma_invitation_incentives_ineligibility_reason: incentives_ineligibility_reason
-}`;
-var getUmaInvitationQuery = (id) => {
-  return {
-    queryPayload: `
-query GetUmaInvitation($id: ID!) {
-    entity(id: $id) {
-        ... on UmaInvitation {
-            ...UmaInvitationFragment
-        }
-    }
-}
-
-${FRAGMENT3}    
-`,
-    variables: { id },
-    constructObject: (data) => UmaInvitationFromJson(data.entity)
-  };
-};
-
-// src/graphql/ClaimUmaInvitation.ts
-var ClaimUmaInvitation = `
-    mutation ClaimUmaInvitation(
-        $invitationCode: String!
-        $inviteeUma: String!
-    ) {
-        claim_uma_invitation(input: {
-            invitation_code: $invitationCode
-            invitee_uma: $inviteeUma
-        }) {
-            invitation {
-                ...UmaInvitationFragment
-            }
-        }
-    }
-
-${FRAGMENT3}
-`;
-
-// src/graphql/ClaimUmaInvitationWithIncentives.ts
-var ClaimUmaInvitationWithIncentives = `
-    mutation ClaimUmaInvitationWithIncentives(
-        $invitationCode: String!
-        $inviteeUma: String!
-        $inviteePhoneHash: String!
-        $inviteeRegion: RegionCode!
-    ) {
-        claim_uma_invitation_with_incentives(input: {
-            invitation_code: $invitationCode
-            invitee_uma: $inviteeUma
-            invitee_phone_hash: $inviteePhoneHash
-            invitee_region: $inviteeRegion
-        }) {
-            invitation {
-                ...UmaInvitationFragment
-            }
-        }
-    }
-
-${FRAGMENT3}
-`;
-
-// src/objects/Permission.ts
-var Permission = /* @__PURE__ */ ((Permission2) => {
-  Permission2["FUTURE_VALUE"] = "FUTURE_VALUE";
-  Permission2["ALL"] = "ALL";
-  Permission2["MAINNET_VIEW"] = "MAINNET_VIEW";
-  Permission2["MAINNET_TRANSACT"] = "MAINNET_TRANSACT";
-  Permission2["MAINNET_MANAGE"] = "MAINNET_MANAGE";
-  Permission2["TESTNET_VIEW"] = "TESTNET_VIEW";
-  Permission2["TESTNET_TRANSACT"] = "TESTNET_TRANSACT";
-  Permission2["TESTNET_MANAGE"] = "TESTNET_MANAGE";
-  Permission2["REGTEST_VIEW"] = "REGTEST_VIEW";
-  Permission2["REGTEST_TRANSACT"] = "REGTEST_TRANSACT";
-  Permission2["REGTEST_MANAGE"] = "REGTEST_MANAGE";
-  Permission2["USER_VIEW"] = "USER_VIEW";
-  Permission2["USER_MANAGE"] = "USER_MANAGE";
-  Permission2["ACCOUNT_VIEW"] = "ACCOUNT_VIEW";
-  Permission2["ACCOUNT_MANAGE"] = "ACCOUNT_MANAGE";
-  return Permission2;
-})(Permission || {});
-var Permission_default = Permission;
-
-// src/objects/ApiToken.ts
-var ApiTokenFromJson = (obj) => {
-  return {
-    id: obj["api_token_id"],
-    createdAt: obj["api_token_created_at"],
-    updatedAt: obj["api_token_updated_at"],
-    clientId: obj["api_token_client_id"],
-    name: obj["api_token_name"],
-    permissions: obj["api_token_permissions"].map((e) => Permission_default[e]),
-    typename: "ApiToken"
-  };
-};
-var FRAGMENT4 = `
-fragment ApiTokenFragment on ApiToken {
-    __typename
-    api_token_id: id
-    api_token_created_at: created_at
-    api_token_updated_at: updated_at
-    api_token_client_id: client_id
-    api_token_name: name
-    api_token_permissions: permissions
-}`;
-var getApiTokenQuery = (id) => {
-  return {
-    queryPayload: `
-query GetApiToken($id: ID!) {
-    entity(id: $id) {
-        ... on ApiToken {
-            ...ApiTokenFragment
-        }
-    }
-}
-
-${FRAGMENT4}    
-`,
-    variables: { id },
-    constructObject: (data) => ApiTokenFromJson(data.entity)
-  };
-};
-
-// src/graphql/CreateApiToken.ts
-var CreateApiToken = `
-    mutation CreateApiToken(
-        $name: String!
-        $permissions: [Permission!]!
-    ) {
-        create_api_token(input: {
-            name: $name
-            permissions: $permissions
-        }) {
-            api_token {
-                ...ApiTokenFragment
-            }
-            client_secret
-        }
-    }
-
-${FRAGMENT4}
-`;
-
-// src/graphql/CreateInvoice.ts
-var CreateInvoice = `
-  mutation CreateInvoice(
-    $node_id: ID!
-    $amount_msats: Long!
-    $memo: String
-    $type: InvoiceType = null
-    $expiry_secs: Int = null
-  ) {
-    create_invoice(input: { node_id: $node_id, amount_msats: $amount_msats, memo: $memo, invoice_type: $type, expiry_secs: $expiry_secs }) {
-      invoice {
-        data {
-          encoded_payment_request
-        }
-      }
-    }
-  }
-`;
-
 // src/objects/BitcoinNetwork.ts
 var BitcoinNetwork = /* @__PURE__ */ ((BitcoinNetwork2) => {
   BitcoinNetwork2["FUTURE_VALUE"] = "FUTURE_VALUE";
@@ -2373,7 +2339,7 @@ var BitcoinNetwork = /* @__PURE__ */ ((BitcoinNetwork2) => {
 var BitcoinNetwork_default = BitcoinNetwork;
 
 // src/objects/Node.ts
-var import_core2 = require("@lightsparkdev/core");
+var import_core4 = require("@lightsparkdev/core");
 
 // src/objects/Balances.ts
 var BalancesFromJson = (obj) => {
@@ -2504,7 +2470,7 @@ query GetGraphNode($id: ID!) {
     }
 }
 
-${FRAGMENT5}    
+${FRAGMENT3}    
 `,
       variables: { id },
       constructObject: (data) => GraphNodeFromJson(data.entity)
@@ -2539,7 +2505,7 @@ var GraphNodeFromJson = (obj) => {
     obj["graph_node_public_key"]
   );
 };
-var FRAGMENT5 = `
+var FRAGMENT3 = `
 fragment GraphNodeFragment on GraphNode {
     __typename
     graph_node_id: id
@@ -2728,7 +2694,7 @@ query GetChannel($id: ID!) {
     }
 }
 
-${FRAGMENT6}    
+${FRAGMENT4}    
 `,
       variables: { id },
       constructObject: (data) => ChannelFromJson(data.entity)
@@ -2781,7 +2747,7 @@ var ChannelFromJson = (obj) => {
     obj["channel_short_channel_id"]
   );
 };
-var FRAGMENT6 = `
+var FRAGMENT4 = `
 fragment ChannelFragment on Channel {
     __typename
     channel_id: id
@@ -3105,7 +3071,7 @@ query GetLightsparkNodeWithOSK($id: ID!) {
     }
 }
 
-${FRAGMENT7}    
+${FRAGMENT5}    
 `,
       variables: { id },
       constructObject: (data) => LightsparkNodeWithOSKFromJson(data.entity)
@@ -3166,7 +3132,7 @@ var LightsparkNodeWithOSKFromJson = (obj) => {
     ) : void 0
   );
 };
-var FRAGMENT7 = `
+var FRAGMENT5 = `
 fragment LightsparkNodeWithOSKFragment on LightsparkNodeWithOSK {
     __typename
     lightspark_node_with_o_s_k_id: id
@@ -3490,7 +3456,7 @@ query GetLightsparkNodeWithRemoteSigning($id: ID!) {
     }
 }
 
-${FRAGMENT8}    
+${FRAGMENT6}    
 `,
       variables: { id },
       constructObject: (data) => LightsparkNodeWithRemoteSigningFromJson(data.entity)
@@ -3553,7 +3519,7 @@ var LightsparkNodeWithRemoteSigningFromJson = (obj) => {
     !!obj["lightspark_node_with_remote_signing_balances"] ? BalancesFromJson(obj["lightspark_node_with_remote_signing_balances"]) : void 0
   );
 };
-var FRAGMENT8 = `
+var FRAGMENT6 = `
 fragment LightsparkNodeWithRemoteSigningFragment on LightsparkNodeWithRemoteSigning {
     __typename
     lightspark_node_with_remote_signing_id: id
@@ -3768,7 +3734,7 @@ var NodeFromJson = (obj) => {
       !!obj["lightspark_node_with_remote_signing_balances"] ? BalancesFromJson(obj["lightspark_node_with_remote_signing_balances"]) : void 0
     );
   }
-  throw new import_core2.LightsparkException(
+  throw new import_core4.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface Node corresponding to the typename=${obj["__typename"]}`
   );
@@ -3844,12 +3810,12 @@ var NodeToJson = (obj) => {
       lightspark_node_with_remote_signing_balances: lightsparkNodeWithRemoteSigning.balances ? BalancesToJson(lightsparkNodeWithRemoteSigning.balances) : void 0
     };
   }
-  throw new import_core2.LightsparkException(
+  throw new import_core4.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface Node corresponding to the typename=${obj.typename}`
   );
 };
-var FRAGMENT9 = `
+var FRAGMENT7 = `
 fragment NodeFragment on Node {
     __typename
     ... on GraphNode {
@@ -4135,7 +4101,7 @@ query GetNode($id: ID!) {
     }
 }
 
-${FRAGMENT9}    
+${FRAGMENT7}    
 `,
     variables: { id },
     constructObject: (data) => NodeFromJson(data.entity)
@@ -4156,7 +4122,7 @@ var InvoiceDataFromJson = (obj) => {
     memo: obj["invoice_data_memo"]
   };
 };
-var FRAGMENT10 = `
+var FRAGMENT8 = `
 fragment InvoiceDataFragment on InvoiceData {
     __typename
     invoice_data_encoded_payment_request: encoded_payment_request
@@ -4470,7 +4436,7 @@ var InvoiceFromJson = (obj) => {
     amountPaid: !!obj["invoice_amount_paid"] ? CurrencyAmountFromJson(obj["invoice_amount_paid"]) : void 0
   };
 };
-var FRAGMENT11 = `
+var FRAGMENT9 = `
 fragment InvoiceFragment on Invoice {
     __typename
     invoice_id: id
@@ -4767,23 +4733,210 @@ fragment InvoiceFragment on Invoice {
             }
         }
     }
-    invoice_status: status
-    invoice_amount_paid: amount_paid {
-        __typename
-        currency_amount_original_value: original_value
-        currency_amount_original_unit: original_unit
-        currency_amount_preferred_currency_unit: preferred_currency_unit
-        currency_amount_preferred_currency_value_rounded: preferred_currency_value_rounded
-        currency_amount_preferred_currency_value_approx: preferred_currency_value_approx
+    invoice_status: status
+    invoice_amount_paid: amount_paid {
+        __typename
+        currency_amount_original_value: original_value
+        currency_amount_original_unit: original_unit
+        currency_amount_preferred_currency_unit: preferred_currency_unit
+        currency_amount_preferred_currency_value_rounded: preferred_currency_value_rounded
+        currency_amount_preferred_currency_value_approx: preferred_currency_value_approx
+    }
+}`;
+var getInvoiceQuery = (id) => {
+  return {
+    queryPayload: `
+query GetInvoice($id: ID!) {
+    entity(id: $id) {
+        ... on Invoice {
+            ...InvoiceFragment
+        }
+    }
+}
+
+${FRAGMENT9}    
+`,
+    variables: { id },
+    constructObject: (data) => InvoiceFromJson(data.entity)
+  };
+};
+
+// src/graphql/CancelInvoice.ts
+var CancelInvoice = `
+  mutation CancelInvoice(
+    $invoice_id: ID!
+  ) {
+    cancel_invoice(input: { invoice_id: $invoice_id }) {
+      invoice {
+        ...InvoiceFragment
+      }
+    }
+  }
+
+  ${FRAGMENT9}
+`;
+
+// src/objects/IncentivesIneligibilityReason.ts
+var IncentivesIneligibilityReason = /* @__PURE__ */ ((IncentivesIneligibilityReason2) => {
+  IncentivesIneligibilityReason2["FUTURE_VALUE"] = "FUTURE_VALUE";
+  IncentivesIneligibilityReason2["DISABLED"] = "DISABLED";
+  IncentivesIneligibilityReason2["SENDER_NOT_ELIGIBLE"] = "SENDER_NOT_ELIGIBLE";
+  IncentivesIneligibilityReason2["RECEIVER_NOT_ELIGIBLE"] = "RECEIVER_NOT_ELIGIBLE";
+  IncentivesIneligibilityReason2["SENDING_VASP_NOT_ELIGIBLE"] = "SENDING_VASP_NOT_ELIGIBLE";
+  IncentivesIneligibilityReason2["RECEIVING_VASP_NOT_ELIGIBLE"] = "RECEIVING_VASP_NOT_ELIGIBLE";
+  IncentivesIneligibilityReason2["NOT_CROSS_BORDER"] = "NOT_CROSS_BORDER";
+  return IncentivesIneligibilityReason2;
+})(IncentivesIneligibilityReason || {});
+var IncentivesIneligibilityReason_default = IncentivesIneligibilityReason;
+
+// src/objects/IncentivesStatus.ts
+var IncentivesStatus = /* @__PURE__ */ ((IncentivesStatus2) => {
+  IncentivesStatus2["FUTURE_VALUE"] = "FUTURE_VALUE";
+  IncentivesStatus2["PENDING"] = "PENDING";
+  IncentivesStatus2["VALIDATED"] = "VALIDATED";
+  IncentivesStatus2["INELIGIBLE"] = "INELIGIBLE";
+  return IncentivesStatus2;
+})(IncentivesStatus || {});
+var IncentivesStatus_default = IncentivesStatus;
+
+// src/objects/UmaInvitation.ts
+var UmaInvitationFromJson = (obj) => {
+  return {
+    id: obj["uma_invitation_id"],
+    createdAt: obj["uma_invitation_created_at"],
+    updatedAt: obj["uma_invitation_updated_at"],
+    code: obj["uma_invitation_code"],
+    url: obj["uma_invitation_url"],
+    inviterUma: obj["uma_invitation_inviter_uma"],
+    incentivesStatus: IncentivesStatus_default[obj["uma_invitation_incentives_status"]] ?? IncentivesStatus_default.FUTURE_VALUE,
+    typename: "UmaInvitation",
+    inviteeUma: obj["uma_invitation_invitee_uma"],
+    incentivesIneligibilityReason: !!obj["uma_invitation_incentives_ineligibility_reason"] ? IncentivesIneligibilityReason_default[obj["uma_invitation_incentives_ineligibility_reason"]] ?? IncentivesIneligibilityReason_default.FUTURE_VALUE : null
+  };
+};
+var FRAGMENT10 = `
+fragment UmaInvitationFragment on UmaInvitation {
+    __typename
+    uma_invitation_id: id
+    uma_invitation_created_at: created_at
+    uma_invitation_updated_at: updated_at
+    uma_invitation_code: code
+    uma_invitation_url: url
+    uma_invitation_inviter_uma: inviter_uma
+    uma_invitation_invitee_uma: invitee_uma
+    uma_invitation_incentives_status: incentives_status
+    uma_invitation_incentives_ineligibility_reason: incentives_ineligibility_reason
+}`;
+var getUmaInvitationQuery = (id) => {
+  return {
+    queryPayload: `
+query GetUmaInvitation($id: ID!) {
+    entity(id: $id) {
+        ... on UmaInvitation {
+            ...UmaInvitationFragment
+        }
+    }
+}
+
+${FRAGMENT10}    
+`,
+    variables: { id },
+    constructObject: (data) => UmaInvitationFromJson(data.entity)
+  };
+};
+
+// src/graphql/ClaimUmaInvitation.ts
+var ClaimUmaInvitation = `
+    mutation ClaimUmaInvitation(
+        $invitationCode: String!
+        $inviteeUma: String!
+    ) {
+        claim_uma_invitation(input: {
+            invitation_code: $invitationCode
+            invitee_uma: $inviteeUma
+        }) {
+            invitation {
+                ...UmaInvitationFragment
+            }
+        }
+    }
+
+${FRAGMENT10}
+`;
+
+// src/graphql/ClaimUmaInvitationWithIncentives.ts
+var ClaimUmaInvitationWithIncentives = `
+    mutation ClaimUmaInvitationWithIncentives(
+        $invitationCode: String!
+        $inviteeUma: String!
+        $inviteePhoneHash: String!
+        $inviteeRegion: RegionCode!
+    ) {
+        claim_uma_invitation_with_incentives(input: {
+            invitation_code: $invitationCode
+            invitee_uma: $inviteeUma
+            invitee_phone_hash: $inviteePhoneHash
+            invitee_region: $inviteeRegion
+        }) {
+            invitation {
+                ...UmaInvitationFragment
+            }
+        }
     }
+
+${FRAGMENT10}
+`;
+
+// src/objects/Permission.ts
+var Permission = /* @__PURE__ */ ((Permission2) => {
+  Permission2["FUTURE_VALUE"] = "FUTURE_VALUE";
+  Permission2["ALL"] = "ALL";
+  Permission2["MAINNET_VIEW"] = "MAINNET_VIEW";
+  Permission2["MAINNET_TRANSACT"] = "MAINNET_TRANSACT";
+  Permission2["MAINNET_MANAGE"] = "MAINNET_MANAGE";
+  Permission2["TESTNET_VIEW"] = "TESTNET_VIEW";
+  Permission2["TESTNET_TRANSACT"] = "TESTNET_TRANSACT";
+  Permission2["TESTNET_MANAGE"] = "TESTNET_MANAGE";
+  Permission2["REGTEST_VIEW"] = "REGTEST_VIEW";
+  Permission2["REGTEST_TRANSACT"] = "REGTEST_TRANSACT";
+  Permission2["REGTEST_MANAGE"] = "REGTEST_MANAGE";
+  Permission2["USER_VIEW"] = "USER_VIEW";
+  Permission2["USER_MANAGE"] = "USER_MANAGE";
+  Permission2["ACCOUNT_VIEW"] = "ACCOUNT_VIEW";
+  Permission2["ACCOUNT_MANAGE"] = "ACCOUNT_MANAGE";
+  return Permission2;
+})(Permission || {});
+var Permission_default = Permission;
+
+// src/objects/ApiToken.ts
+var ApiTokenFromJson = (obj) => {
+  return {
+    id: obj["api_token_id"],
+    createdAt: obj["api_token_created_at"],
+    updatedAt: obj["api_token_updated_at"],
+    clientId: obj["api_token_client_id"],
+    name: obj["api_token_name"],
+    permissions: obj["api_token_permissions"].map((e) => Permission_default[e]),
+    typename: "ApiToken"
+  };
+};
+var FRAGMENT11 = `
+fragment ApiTokenFragment on ApiToken {
+    __typename
+    api_token_id: id
+    api_token_created_at: created_at
+    api_token_updated_at: updated_at
+    api_token_client_id: client_id
+    api_token_name: name
+    api_token_permissions: permissions
 }`;
-var getInvoiceQuery = (id) => {
+var getApiTokenQuery = (id) => {
   return {
     queryPayload: `
-query GetInvoice($id: ID!) {
+query GetApiToken($id: ID!) {
     entity(id: $id) {
-        ... on Invoice {
-            ...InvoiceFragment
+        ... on ApiToken {
+            ...ApiTokenFragment
         }
     }
 }
@@ -4791,10 +4944,49 @@ query GetInvoice($id: ID!) {
 ${FRAGMENT11}    
 `,
     variables: { id },
-    constructObject: (data) => InvoiceFromJson(data.entity)
+    constructObject: (data) => ApiTokenFromJson(data.entity)
   };
 };
 
+// src/graphql/CreateApiToken.ts
+var CreateApiToken = `
+    mutation CreateApiToken(
+        $name: String!
+        $permissions: [Permission!]!
+    ) {
+        create_api_token(input: {
+            name: $name
+            permissions: $permissions
+        }) {
+            api_token {
+                ...ApiTokenFragment
+            }
+            client_secret
+        }
+    }
+
+${FRAGMENT11}
+`;
+
+// src/graphql/CreateInvoice.ts
+var CreateInvoice = `
+  mutation CreateInvoice(
+    $node_id: ID!
+    $amount_msats: Long!
+    $memo: String
+    $type: InvoiceType = null
+    $expiry_secs: Int = null
+  ) {
+    create_invoice(input: { node_id: $node_id, amount_msats: $amount_msats, memo: $memo, invoice_type: $type, expiry_secs: $expiry_secs }) {
+      invoice {
+        data {
+          encoded_payment_request
+        }
+      }
+    }
+  }
+`;
+
 // src/graphql/CreateLnurlInvoice.ts
 var CreateLnurlInvoice = `
 mutation CreateLnurlInvoice(
@@ -4814,7 +5006,7 @@ mutation CreateLnurlInvoice(
       }
   }
 }
-${FRAGMENT11}
+${FRAGMENT9}
 `;
 
 // src/graphql/CreateNodeWalletAddress.ts
@@ -5146,7 +5338,7 @@ var CreateUmaInvitation = `
         }
     }
 
-${FRAGMENT3}
+${FRAGMENT10}
 `;
 
 // src/graphql/CreateUmaInvitationWithIncentives.ts
@@ -5167,7 +5359,7 @@ var CreateUmaInvitationWithIncentives = `
         }
     }
 
-${FRAGMENT3}
+${FRAGMENT10}
 `;
 
 // src/graphql/CreateUmaInvoice.ts
@@ -5189,7 +5381,7 @@ mutation CreateUmaInvoice(
       }
   }
 }
-${FRAGMENT11}
+${FRAGMENT9}
 `;
 
 // src/graphql/DecodeInvoice.ts
@@ -5203,7 +5395,7 @@ var DecodeInvoice = `
     }
   }
 
-  ${FRAGMENT10}
+  ${FRAGMENT8}
 `;
 
 // src/graphql/DeleteApiToken.ts
@@ -5229,7 +5421,7 @@ var FetchUmaInvitation = `
         }
     }
 
-${FRAGMENT3}
+${FRAGMENT10}
 `;
 
 // src/graphql/FundNode.ts
@@ -5766,7 +5958,7 @@ var PaymentFailureReason = /* @__PURE__ */ ((PaymentFailureReason2) => {
 var PaymentFailureReason_default = PaymentFailureReason;
 
 // src/objects/PaymentRequestData.ts
-var import_core3 = require("@lightsparkdev/core");
+var import_core5 = require("@lightsparkdev/core");
 var PaymentRequestDataFromJson = (obj) => {
   if (obj["__typename"] == "InvoiceData") {
     return {
@@ -5781,7 +5973,7 @@ var PaymentRequestDataFromJson = (obj) => {
       memo: obj["invoice_data_memo"]
     };
   }
-  throw new import_core3.LightsparkException(
+  throw new import_core5.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface PaymentRequestData corresponding to the typename=${obj["__typename"]}`
   );
@@ -5801,7 +5993,7 @@ var PaymentRequestDataToJson = (obj) => {
       invoice_data_destination: NodeToJson(invoiceData.destination)
     };
   }
-  throw new import_core3.LightsparkException(
+  throw new import_core5.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface PaymentRequestData corresponding to the typename=${obj.typename}`
   );
@@ -6378,8 +6570,35 @@ var PayInvoice = `
   ${FRAGMENT17}
 `;
 
+// src/graphql/PayUmaInvoice.ts
+var PayUmaInvoice = `
+  mutation PayUmaInvoice(
+    $node_id: ID!
+    $encoded_invoice: String!
+    $timeout_secs: Int!
+    $maximum_fees_msats: Long!
+    $amount_msats: Long
+  ) {
+    pay_uma_invoice(
+      input: {
+        node_id: $node_id
+        encoded_invoice: $encoded_invoice
+        timeout_secs: $timeout_secs
+        maximum_fees_msats: $maximum_fees_msats
+        amount_msats: $amount_msats
+      }
+    ) {
+      payment {
+        ...OutgoingPaymentFragment
+      }
+    }
+  }
+
+  ${FRAGMENT17}
+`;
+
 // src/objects/PaymentRequest.ts
-var import_core4 = require("@lightsparkdev/core");
+var import_core6 = require("@lightsparkdev/core");
 var PaymentRequestFromJson = (obj) => {
   if (obj["__typename"] == "Invoice") {
     return {
@@ -6392,7 +6611,7 @@ var PaymentRequestFromJson = (obj) => {
       amountPaid: !!obj["invoice_amount_paid"] ? CurrencyAmountFromJson(obj["invoice_amount_paid"]) : void 0
     };
   }
-  throw new import_core4.LightsparkException(
+  throw new import_core6.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface PaymentRequest corresponding to the typename=${obj["__typename"]}`
   );
@@ -6744,43 +6963,16 @@ query PaymentRequestsForNode(
         ) {
             count
             entities {
-                ...PaymentRequestFragment
-                __typename
-            }
-            __typename
-        }
-        __typename
-    }
-}
-
-${FRAGMENT18}
-`;
-
-// src/graphql/PayUmaInvoice.ts
-var PayUmaInvoice = `
-  mutation PayUmaInvoice(
-    $node_id: ID!
-    $encoded_invoice: String!
-    $timeout_secs: Int!
-    $maximum_fees_msats: Long!
-    $amount_msats: Long
-  ) {
-    pay_uma_invoice(
-      input: {
-        node_id: $node_id
-        encoded_invoice: $encoded_invoice
-        timeout_secs: $timeout_secs
-        maximum_fees_msats: $maximum_fees_msats
-        amount_msats: $amount_msats
-      }
-    ) {
-      payment {
-        ...OutgoingPaymentFragment
-      }
+                ...PaymentRequestFragment
+                __typename
+            }
+            __typename
+        }
+        __typename
     }
-  }
+}
 
-  ${FRAGMENT17}
+${FRAGMENT18}
 `;
 
 // src/objects/WithdrawalRequest.ts
@@ -7239,7 +7431,7 @@ var SendPayment = `
 `;
 
 // src/objects/Transaction.ts
-var import_core5 = require("@lightsparkdev/core");
+var import_core7 = require("@lightsparkdev/core");
 
 // src/objects/RoutingTransactionFailureReason.ts
 var RoutingTransactionFailureReason = /* @__PURE__ */ ((RoutingTransactionFailureReason2) => {
@@ -7383,7 +7575,7 @@ var TransactionFromJson = (obj) => {
       numConfirmations: obj["withdrawal_num_confirmations"]
     };
   }
-  throw new import_core5.LightsparkException(
+  throw new import_core7.LightsparkException(
     "DeserializationError",
     `Couldn't find a concrete type for interface Transaction corresponding to the typename=${obj["__typename"]}`
   );
@@ -8064,45 +8256,6 @@ ${FRAGMENT22}
 ${FRAGMENT}
 `;
 
-// src/graphql/TransactionsForNode.ts
-var TransactionsForNode = `
-query TransactionsForNode(
-    $network: BitcoinNetwork!,
-    $nodeId: ID!,
-    $numTransactions: Int,
-    $afterDate: DateTime,
-    $transactionTypes: [TransactionType!] = [PAYMENT, PAYMENT_REQUEST, ROUTE, L1_WITHDRAW, L1_DEPOSIT]
-    $transaction_statuses: [TransactionStatus!] = null
-) {
-    current_account {
-        id
-        name
-        recent_transactions: transactions(
-            first: $numTransactions
-            types: $transactionTypes
-            bitcoin_network: $network
-            lightning_node_id: $nodeId
-            statuses: $transaction_statuses
-            after_date: $afterDate
-        ) {
-            count
-            total_amount_transacted {
-                ...CurrencyAmountFragment
-            }
-            entities {
-                ...TransactionFragment
-                __typename
-            }
-            __typename
-        }
-        __typename
-    }
-}
-
-${FRAGMENT22}
-${FRAGMENT}
-`;
-
 // src/objects/TransactionUpdate.ts
 var TransactionUpdateFromJson = (obj) => {
   return {
@@ -8149,181 +8302,44 @@ subscription TransactionSubscription(
 ${FRAGMENT23}
 `;
 
-// src/NodeKeyLoaderCache.ts
-var import_core7 = require("@lightsparkdev/core");
-
-// src/SigningKeyLoader.ts
-var import_core6 = require("@lightsparkdev/core");
-
-// src/graphql/RecoverNodeSigningKey.ts
-var RecoverNodeSigningKey = `
-  query RecoverNodeSigningKey($nodeId: ID!) {
-    entity(id: $nodeId) {
-      __typename
-      ... on LightsparkNodeWithOSK {
-        encrypted_signing_private_key {
-          encrypted_value
-          cipher
+// src/graphql/TransactionsForNode.ts
+var TransactionsForNode = `
+query TransactionsForNode(
+    $network: BitcoinNetwork!,
+    $nodeId: ID!,
+    $numTransactions: Int,
+    $afterDate: DateTime,
+    $transactionTypes: [TransactionType!] = [PAYMENT, PAYMENT_REQUEST, ROUTE, L1_WITHDRAW, L1_DEPOSIT]
+    $transaction_statuses: [TransactionStatus!] = null
+) {
+    current_account {
+        id
+        name
+        recent_transactions: transactions(
+            first: $numTransactions
+            types: $transactionTypes
+            bitcoin_network: $network
+            lightning_node_id: $nodeId
+            statuses: $transaction_statuses
+            after_date: $afterDate
+        ) {
+            count
+            total_amount_transacted {
+                ...CurrencyAmountFragment
+            }
+            entities {
+                ...TransactionFragment
+                __typename
+            }
+            __typename
         }
-      }
+        __typename
     }
-  }
-`;
-
-// src/SigningKeyLoader.ts
-var SIGNING_KEY_PATH = "m/5";
-function isNodeIdAndPasswordSigningKeyLoaderArgs(args) {
-  return args.password !== void 0;
-}
-function isMasterSeedSigningKeyLoaderArgs(args) {
-  return args.masterSeed !== void 0;
 }
-var NodeIdAndPasswordSigningKeyLoader = class {
-  nodeId;
-  password;
-  requester;
-  cryptoImpl;
-  constructor(args, requester, cryptoImpl) {
-    this.nodeId = args.nodeId;
-    this.password = args.password;
-    this.requester = requester;
-    this.cryptoImpl = cryptoImpl;
-  }
-  async loadSigningKey() {
-    const encryptedKey = await this.recoverNodeSigningKey();
-    if (!encryptedKey) {
-      console.warn("No encrypted key found for node " + this.nodeId);
-      return;
-    }
-    const signingPrivateKey = await this.cryptoImpl.decryptSecretWithNodePassword(
-      encryptedKey.cipher,
-      encryptedKey.encrypted_value,
-      this.password
-    );
-    if (!signingPrivateKey) {
-      throw new import_core6.LightsparkSigningException(
-        "Unable to decrypt signing key with provided password. Please try again."
-      );
-    }
-    let signingPrivateKeyPEM = "";
-    if (new Uint8Array(signingPrivateKey)[0] === 48) {
-      signingPrivateKeyPEM = (0, import_core6.b64encode)(signingPrivateKey);
-    } else {
-      const dec = new TextDecoder();
-      signingPrivateKeyPEM = dec.decode(signingPrivateKey);
-    }
-    return { key: signingPrivateKeyPEM, type: import_core6.SigningKeyType.RSASigningKey };
-  }
-  async recoverNodeSigningKey() {
-    const response = await this.requester.makeRawRequest(
-      RecoverNodeSigningKey,
-      { nodeId: this.nodeId }
-    );
-    const nodeEntity = response.entity;
-    if (nodeEntity?.__typename === "LightsparkNodeWithOSK") {
-      return nodeEntity.encrypted_signing_private_key;
-    }
-    return null;
-  }
-};
-var MasterSeedSigningKeyLoader = class {
-  masterSeed;
-  network;
-  constructor(args) {
-    this.masterSeed = args.masterSeed;
-    this.network = args.network;
-  }
-  async loadSigningKey() {
-    if (import_core6.isBrowser) {
-      throw new import_core6.LightsparkSigningException(
-        "Browser environments not supported for master seed signing key loader."
-      );
-    }
-    const { LightsparkSigner, Network } = await import("@lightsparkdev/crypto-wasm");
-    let cryptoLibNetwork;
-    switch (this.network) {
-      case BitcoinNetwork_default.MAINNET:
-        cryptoLibNetwork = Network.Bitcoin;
-        break;
-      case BitcoinNetwork_default.TESTNET:
-        cryptoLibNetwork = Network.Testnet;
-        break;
-      case BitcoinNetwork_default.REGTEST:
-        cryptoLibNetwork = Network.Regtest;
-        break;
-      default:
-        throw new Error(
-          `Unsupported lightspark_crypto network ${this.network}.`
-        );
-    }
-    const lightsparkSigner = LightsparkSigner.from_bytes(
-      this.masterSeed,
-      cryptoLibNetwork
-    );
-    const privateKey = lightsparkSigner.derive_private_key(SIGNING_KEY_PATH);
-    return { key: privateKey, type: import_core6.SigningKeyType.Secp256k1SigningKey };
-  }
-};
 
-// src/NodeKeyLoaderCache.ts
-var NodeKeyLoaderCache = class {
-  constructor(nodeKeyCache, cryptoImpl = import_core7.DefaultCrypto) {
-    this.nodeKeyCache = nodeKeyCache;
-    this.cryptoImpl = cryptoImpl;
-    this.idToLoader = /* @__PURE__ */ new Map();
-  }
-  idToLoader;
-  /**
-   * Sets the signing key loader for a node.
-   * Instantiates a signing key loader based on the type of args passed in by the user.
-   *
-   * @param nodeId The ID of the node to get the key for
-   * @param loaderArgs Loader arguments for loading the key
-   * @param requester Requester used for loading the key
-   */
-  setLoader(nodeId, loaderArgs, requester) {
-    let loader;
-    if (isNodeIdAndPasswordSigningKeyLoaderArgs(loaderArgs)) {
-      loader = new NodeIdAndPasswordSigningKeyLoader(
-        { nodeId, ...loaderArgs },
-        requester,
-        this.cryptoImpl
-      );
-    } else if (isMasterSeedSigningKeyLoaderArgs(loaderArgs)) {
-      loader = new MasterSeedSigningKeyLoader({ ...loaderArgs });
-    } else {
-      throw new import_core7.LightsparkSigningException("Invalid signing key loader args");
-    }
-    this.idToLoader.set(nodeId, loader);
-  }
-  /**
-   * Gets the key for a node using the loader set by [setLoader]
-   *
-   * @param id The ID of the node to get the key for
-   * @returns The loaded key
-   */
-  async getKeyWithLoader(id) {
-    if (this.nodeKeyCache.hasKey(id)) {
-      return this.nodeKeyCache.getKey(id);
-    }
-    const loader = this.idToLoader.get(id);
-    if (!loader) {
-      throw new import_core7.LightsparkSigningException(
-        "No signing key loader found for node " + id
-      );
-    }
-    const loaderResult = await loader.loadSigningKey();
-    if (!loaderResult) {
-      return;
-    }
-    const key = await this.nodeKeyCache.loadKey(
-      id,
-      { key: loaderResult.key },
-      loaderResult.type
-    );
-    return key || void 0;
-  }
-};
+${FRAGMENT22}
+${FRAGMENT}
+`;
 
 // src/objects/Account.ts
 var import_auto_bind12 = __toESM(require("auto-bind"), 1);
@@ -11623,7 +11639,8 @@ var LightsparkClient = class {
    *     use, you should use the `AccountTokenAuthProvider`.
    * @param serverUrl The base URL of the server to connect to. Defaults to lightspark production.
    * @param cryptoImpl The crypto implementation to use. Defaults to web and node compatible crypto.
-   *     For React Native, you should use the `ReactNativeCrypto` implementation from `@lightsparkdev/react-native`.
+   *     For React Native, you should use the `ReactNativeCrypto`
+   *     implementation from `@lightsparkdev/react-native`.
    */
   constructor(authProvider = new import_core9.StubAuthProvider(), serverUrl = "api.lightspark.com", cryptoImpl = import_core9.DefaultCrypto) {
     this.authProvider = authProvider;
@@ -11649,9 +11666,11 @@ var LightsparkClient = class {
   nodeKeyLoaderCache;
   LIGHTSPARK_SDK_ENDPOINT = process.env.LIGHTSPARK_SDK_ENDPOINT || "graphql/server/2023-09-13";
   /**
-   * Sets the key loader for a node. This unlocks client operations that require a private key.
-   * Passing in [NodeIdAndPasswordSigningKeyLoaderArgs] loads the RSA key for an OSK node.
-   * Passing in [MasterSeedSigningKeyLoaderArgs] loads the Secp256k1 key for a remote signing node.
+   * Sets the key loader for a node. This unlocks client operations that
+   * require a private key. Passing in [NodeIdAndPasswordSigningKeyLoaderArgs]
+   * loads the RSA key for an OSK node.
+   * Passing in [MasterSeedSigningKeyLoaderArgs] loads the Secp256k1 key for a
+   * remote signing node.
    *
    * @param nodeId The ID of the node the key is for
    * @param loader The loader for the key
@@ -11662,7 +11681,8 @@ var LightsparkClient = class {
     return !!key;
   }
   /**
-   * Gets the signing key for a node. Must have previously called [loadNodeSigningKey].
+   * Gets the signing key for a node. Must have previously called
+   * [loadNodeSigningKey].
    *
    * @param nodeId The ID of the node the key is for
    * @returns The signing key for the node
@@ -11671,7 +11691,8 @@ var LightsparkClient = class {
     return await this.nodeKeyLoaderCache.getKeyWithLoader(nodeId);
   }
   /**
-   * Sets the auth provider for the client. This is useful for switching between auth providers if you are using
+   * Sets the auth provider for the client.
+   * This is useful for switching between auth providers if you are using
    * multiple accounts or waiting for the user to log in.
    *
    * @param authProvider
@@ -11750,7 +11771,8 @@ var LightsparkClient = class {
     ) ?? [];
   }
   /**
-   * Starts listening for new transactions or updates to existing transactions for a list of nodes.
+   * Starts listening for new transactions or updates to existing transactions
+   * for a list of nodes.
    *
    * @param nodeIds The node IDs for which to listen to transactions.
    * @returns A zen-observable that emits transaction updates for the given node IDs.
@@ -11767,8 +11789,8 @@ var LightsparkClient = class {
     );
   }
   /**
-   * Retrieves a dashboard of basic info for the authenticated account. See `AccountDashboard` for which info is
-   * included.
+   * Retrieves a dashboard of basic info for the authenticated account.
+   * See `AccountDashboard` for which info is included.
    *
    * @param nodeIds The node IDs to include in the dashboard. Defaults to undefined (all nodes).
    * @param bitcoinNetwork The bitcoin network to include in the dashboard. Defaults to MAINNET.
@@ -11835,8 +11857,8 @@ var LightsparkClient = class {
     };
   }
   /**
-   * Gets a basic dashboard for a single node, including recent transactions. See `SingleNodeDashboard` for which info is
-   * included.
+   * Gets a basic dashboard for a single node, including recent transactions.
+   * See `SingleNodeDashboard` for which info is included.
    *
    * @param nodeId The node ID for which to get a dashboard.
    * @param bitcoinNetwork The bitcoin network for which to get a dashboard. Defaults to MAINNET.
@@ -11907,7 +11929,8 @@ var LightsparkClient = class {
   /**
    * Creates an invoice for the given node.
    *
-   * Test mode note: You can simulate a payment of this invoice in test move using [createTestModePayment].
+   * Test mode note: You can simulate a payment of this invoice in test move
+   * using [createTestModePayment].
    *
    * @param nodeId The node ID for which to create an invoice.
    * @param amountMsats The amount of the invoice in msats. You can create a zero-amount invoice to accept any payment amount.
@@ -11935,11 +11958,13 @@ var LightsparkClient = class {
     return response.create_invoice?.invoice.data?.encoded_payment_request;
   }
   /**
-   * Generates a Lightning Invoice (follows the Bolt 11 specification) to request a payment
-   * from another Lightning Node. This should only be used for generating invoices for LNURLs,
+   * Generates a Lightning Invoice (follows the Bolt 11 specification) to
+   * request a payment from another Lightning Node.
+   * This should only be used for generating invoices for LNURLs,
    * with [createInvoice] preferred in the general case.
    *
-   * Test mode note: You can simulate a payment of this invoice in test move using [createTestModePayment].
+   * Test mode note: You can simulate a payment of this invoice in test move
+   * using [createTestModePayment].
    *
    * @param nodeId The node ID for which to create an invoice.
    * @param amountMsats The amount of the invoice in msats. You can create a zero-amount invoice to accept any payment amount.
@@ -11970,10 +11995,12 @@ var LightsparkClient = class {
     return InvoiceFromJson(invoiceJson);
   }
   /**
-   * Creates a new invoice for the UMA protocol. The metadata is hashed and included in the invoice.
-   * This API generates a Lightning Invoice (follows the Bolt 11 specification) to request a payment
-   * from another Lightning Node. This should only be used for generating invoices for UMA, with `createInvoice`
-   * preferred in the general case.
+   * Creates a new invoice for the UMA protocol.
+   * The metadata is hashed and included in the invoice.
+   * This API generates a Lightning Invoice (follows the Bolt 11 specification)
+   * to request a payment from another Lightning Node.
+   * This should only be used for generating invoices for UMA,
+   * with `createInvoice` preferred in the general case.
    *
    * @param nodeId The node ID for which to create an invoice.
    * @param amountMsats The amount of the invoice in msats. You can create a zero-amount invoice to accept any payment amount.
@@ -12001,6 +12028,22 @@ var LightsparkClient = class {
     }
     return InvoiceFromJson(invoiceJson);
   }
+  /**
+   * Cancels an existing unpaid invoice and returns that invoice. Cancelled invoices cannot be paid.
+   *
+   * @param invoiceId The ID of the invoice to cancel.
+   * @returns The cancelled invoice, or undefined if the invoice could not be cancelled.
+   */
+  async cancelInvoice(invoiceId) {
+    const response = await this.requester.makeRawRequest(CancelInvoice, {
+      invoice_id: invoiceId
+    });
+    const invoiceJson = response.cancel_invoice?.invoice;
+    if (!invoiceJson) {
+      return void 0;
+    }
+    return InvoiceFromJson(invoiceJson);
+  }
   /**
    * Decodes an encoded lightning invoice string.
    *
@@ -12014,7 +12057,8 @@ var LightsparkClient = class {
     return InvoiceDataFromJson(response.decoded_payment_request);
   }
   /**
-   * Gets an estimate of the fee for sending a payment over the given bitcoin network.
+   * Gets an estimate of the fee for sending a payment over the given bitcoin
+   * network.
    *
    * @param bitcoinNetwork The bitcoin network for which to get a fee estimate. Defaults to MAINNET.
    * @returns A fee estimate for the given bitcoin network including a minimum fee rate, and a max-speed fee rate.
@@ -12051,7 +12095,8 @@ var LightsparkClient = class {
     );
   }
   /**
-   * Returns an estimate of the fees that will be paid to send a payment to another Lightning node.
+   * Returns an estimate of the fees that will be paid to send a payment to
+   * another Lightning node.
    *
    * @param nodeId The node from where you want to send the payment.
    * @param destinationNodePublicKey The public key of the node that you want to pay.
@@ -12087,17 +12132,20 @@ var LightsparkClient = class {
   /**
    * Sends a lightning payment for a given invoice.
    *
-   * Test mode note: For test mode, you can use the [createTestModeInvoice] function to create an invoice you can
-   * pay in test mode.
+   * Test mode note: For test mode, you can use the [createTestModeInvoice]
+   * function to create an invoice you can pay in test mode.
    *
    * @param payerNodeId The ID of the node that will pay the invoice.
    * @param encodedInvoice The encoded invoice to pay.
    * @param maximumFeesMsats Maximum fees (in msats) to pay for the payment. This parameter is required.
-   *     As guidance, a maximum fee of 16 basis points should make almost all transactions succeed. For example,
-   *     for a transaction between 10k sats and 100k sats, this would mean a fee limit of 16 to 160 sats.
+   *     As guidance, a maximum fee of 16 basis points should make almost all
+   *     transactions succeed. For example,
+   *     for a transaction between 10k sats and 100k sats,
+   *     this would mean a fee limit of 16 to 160 sats.
    * @param timeoutSecs A timeout for the payment in seconds. Defaults to 60 seconds.
    * @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.
+   *     invoice. NOTE: This parameter can only be passed for a zero-amount
+   *     invoice. Otherwise, the call will fail.
    * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
    */
   async payInvoice(payerNodeId, encodedInvoice, maximumFeesMsats, timeoutSecs = 60, amountMsats = void 0) {
@@ -12127,18 +12175,23 @@ var LightsparkClient = class {
     return response.pay_invoice && OutgoingPaymentFromJson(response.pay_invoice.payment);
   }
   /**
-   * sends an UMA payment to a node on the Lightning Network, based on the invoice
-   * (as defined by the BOLT11 specification) that you provide.
-   * This should only be used for paying UMA invoices, with `payInvoice` preferred in the general case.
+   * sends an UMA payment to a node on the Lightning Network,
+   * based on the invoice (as defined by the BOLT11 specification) that you
+   * provide.
+   * This should only be used for paying UMA invoices,
+   * with `payInvoice` preferred in the general case.
    *
    * @param payerNodeId The ID of the node that will pay the invoice.
    * @param encodedInvoice The encoded invoice to pay.
    * @param maximumFeesMsats Maximum fees (in msats) to pay for the payment. This parameter is required.
-   *     As guidance, a maximum fee of 16 basis points should make almost all transactions succeed. For example,
-   *     for a transaction between 10k sats and 100k sats, this would mean a fee limit of 16 to 160 sats.
+   *     As guidance, a maximum fee of 16 basis points should make almost all
+   *     transactions succeed. For example,
+   *     for a transaction between 10k sats and 100k sats,
+   *     this would mean a fee limit of 16 to 160 sats.
    * @param timeoutSecs A timeout for the payment in seconds. Defaults to 60 seconds.
    * @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.
+   *     invoice. NOTE: This parameter can only be passed for a zero-amount
+   *     invoice. Otherwise, the call will fail.
    * @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) {
@@ -12168,7 +12221,8 @@ var LightsparkClient = class {
     return response.pay_uma_invoice && OutgoingPaymentFromJson(response.pay_invoice.payment);
   }
   /**
-   * Waits for a transaction to have a completed status, and returns the transaction.
+   * Waits for a transaction to have a completed status, and returns the
+   * transaction.
    *
    * @param transactionId The ID of the transaction to wait for
    * @param pollTimeoutSecs The timeout in seconds that we will wait before throwing an exception
@@ -12205,15 +12259,18 @@ var LightsparkClient = class {
     return transaction;
   }
   /**
-   * Sends a payment directly to a node on the Lightning Network through the public key of the node without an invoice.
+   * Sends a payment directly to a node on the Lightning Network through the
+   * public key of the node without an invoice.
    *
    * @param payerNodeId The ID of the node that will send the payment.
    * @param destinationPublicKey The public key of the destination node.
    * @param timeoutSecs The timeout in seconds that we will try to make the payment.
    * @param amountMsats The amount to pay in msats.
    * @param maximumFeesMsats Maximum fees (in msats) to pay for the payment. This parameter is required.
-   *     As guidance, a maximum fee of 15 basis points should make almost all transactions succeed. For example,
-   *     for a transaction between 10k sats and 100k sats, this would mean a fee limit of 15 to 150 sats.
+   *     As guidance, a maximum fee of 15 basis points should make almost all
+   *     transactions succeed. For example,
+   *     for a transaction between 10k sats and 100k sats,
+   *     this would mean a fee limit of 15 to 150 sats.
    * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
    */
   async sendPayment(payerNodeId, destinationPublicKey, timeoutSecs = 60, amountMsats, maximumFeesMsats) {
@@ -12240,7 +12297,8 @@ var LightsparkClient = class {
     return response.send_payment && OutgoingPaymentFromJson(response.send_payment.payment);
   }
   /**
-   * Creates an L1 Bitcoin wallet address for a given node which can be used to deposit or withdraw funds.
+   * Creates an L1 Bitcoin wallet address for a given node which can be used to
+   * deposit or withdraw funds.
    *
    * @param nodeId The ID of the node to create a wallet address for.
    * @returns A string containing the wallet address for the given node.
@@ -12253,12 +12311,15 @@ var LightsparkClient = class {
     return response.create_node_wallet_address.wallet_address;
   }
   /**
-   * Withdraws funds from the account and sends it to the requested bitcoin address.
+   * Withdraws funds from the account and sends it to the requested bitcoin
+   * address.
    *
-   * Depending on the chosen mode, it will first take the funds from the wallet, and if applicable, close channels
-   * appropriately to recover enough funds and reopen channels with the remaining funds.
-   * The process is asynchronous and may take up to a few minutes. You can check the progress by polling the
-   * `WithdrawalRequest` that is created, or by subscribing to a webhook.
+   * Depending on the chosen mode, it will first take the funds from the
+   * wallet, and if applicable, close channels appropriately to recover enough
+   * funds and reopen channels with the remaining funds.
+   * The process is asynchronous and may take up to a few minutes.
+   * You can check the progress by polling the `WithdrawalRequest` that is
+   * created, or by subscribing to a webhook.
    *
    * @param nodeId The ID of the node from which to withdraw funds.
    * @param amountSats The amount of funds to withdraw in satoshis.
@@ -12279,9 +12340,10 @@ var LightsparkClient = class {
     return WithdrawalRequestFromJson(response.request_withdrawal.request);
   }
   /**
-   * Adds funds to a Lightspark node on the REGTEST network. If the amount is not specified, 10,000,000 SATOSHI will be
-   * added. This API only functions for nodes created on the REGTEST network and will return an error when called for
-   * any non-REGTEST node.
+   * Adds funds to a Lightspark node on the REGTEST network.
+   * If the amount is not specified, 10,000,000 SATOSHI will be added.
+   * This API only functions for nodes created on the REGTEST network and will
+   * return an error when called for any non-REGTEST node.
    *
    * @param nodeId The ID of the node to fund. Must be a REGTEST node.
    * @param amountSats The amount of funds to add to the node in satoshis. Defaults to 10,000,000 SATOSHI.
@@ -12295,8 +12357,8 @@ var LightsparkClient = class {
     return CurrencyAmountFromJson(response.fund_node.amount);
   }
   /**
-   * Creates a new API token that can be used to authenticate requests for this account when using the Lightspark APIs
-   * and SDKs.
+   * Creates a new API token that can be used to authenticate requests for this
+   * account when using the Lightspark APIs and SDKs.
    *
    * @param name Creates a new API token that can be used to authenticate requests for this account when using the
    *     Lightspark APIs and SDKs.
@@ -12333,8 +12395,9 @@ var LightsparkClient = class {
     await this.requester.makeRawRequest(DeleteApiToken, { api_token_id: id });
   }
   /**
-   * In test mode, generates a Lightning Invoice which can be paid by a local node.
-   * This call is only valid in test mode. You can then pay the invoice using [payInvoice].
+   * In test mode, generates a Lightning Invoice which can be paid by a local
+   * node. This call is only valid in test mode.
+   * You can then pay the invoice using [payInvoice].
    *
    * @param localNodeId The ID of the node that will pay the invoice.
    * @param amountMsats The amount to pay in milli-satoshis.
@@ -12363,8 +12426,9 @@ var LightsparkClient = class {
     });
   }
   /**
-   * In test mode, simulates a payment of a Lightning Invoice from another node.
-   * This can only be used in test mode and should be used with invoices generated by [createInvoice].
+   * In test mode, simulates a payment of a Lightning Invoice from another
+   * node. This can only be used in test mode and should be used with invoices
+   * generated by [createInvoice].
    *
    * @param localNodeId The ID of the node that will receive the payment.
    * @param encodedInvoice The encoded invoice to pay.
@@ -12387,8 +12451,8 @@ var LightsparkClient = class {
     });
   }
   /**
-   * Creates an UMA invitation. If you are part of the incentive program, you should use
-   * [createUmaInvitationWithIncentives].
+   * Creates an UMA invitation. If you are part of the incentive program,
+   * you should use [createUmaInvitationWithIncentives].
    *
    * @param inviterUma The UMA of the inviter.
    * @returns The invitation that was created.
@@ -12442,8 +12506,8 @@ var LightsparkClient = class {
     });
   }
   /**
-   * Claims an UMA invitation. If you are part of the incentive program, you should use
-   * [claimUmaInvitationWithIncentives].
+   * Claims an UMA invitation. If you are part of the incentive program,
+   * you should use [claimUmaInvitationWithIncentives].
    *
    * @param invitationCode The invitation code to claim.
    * @param inviteeUma The UMA of the invitee.
@@ -12534,7 +12598,8 @@ var LightsparkClient = class {
   /**
    * Executes a raw `Query` against the Lightspark API.
    *
-   * This generally should not be used directly, but is exposed for advanced use cases and for internal use to retrieve
+   * This generally should not be used directly,
+   * but is exposed for advanced use cases and for internal use to retrieve
    * complex fields from objects.
    *
    * @param query The `Query` to execute.