@lightsparkdev/lightspark-sdk 0.3.3 → 0.4.0

package/dist/objects/index.d.ts

@@ -1,3 +1,3 @@
-export { A as Account, a as AccountToApiTokensConnection, b as AccountToChannelsConnection, c as AccountToNodesConnection, d as AccountToPaymentRequestsConnection, e as AccountToTransactionsConnection, f as AccountToWalletsConnection, g as ApiToken, B as Balances, i as BitcoinNetwork, j as BlockchainBalance, C as Channel, k as ChannelClosingTransaction, m as ChannelFees, n as ChannelOpeningTransaction, p as ChannelStatus, q as ChannelToTransactionsConnection, r as CreateApiTokenInput, s as CreateApiTokenOutput, t as CreateInvoiceInput, u as CreateInvoiceOutput, v as CreateNodeWalletAddressInput, w as CreateNodeWalletAddressOutput, x as CreateTestModeInvoiceInput, y as CreateTestModeInvoiceOutput, z as CreateTestModePaymentInput, D as CreateTestModePaymentoutput, E as CurrencyAmount, F as CurrencyUnit, G as DeleteApiTokenInput, H as DeleteApiTokenOutput, I as Deposit, K as Entity, M as FeeEstimate, N as FundNodeInput, O as FundNodeOutput, P as GraphNode, Q as Hop, S as HtlcAttemptFailureCode, T as IncomingPayment, U as IncomingPaymentAttempt, X as IncomingPaymentAttemptStatus, Y as IncomingPaymentToAttemptsConnection, Z as Invoice, $ as InvoiceData, a0 as InvoiceType, a1 as LightningFeeEstimateForInvoiceInput, a2 as LightningFeeEstimateForNodeInput, a3 as LightningFeeEstimateOutput, a4 as LightningTransaction, a6 as LightsparkNode, a7 as LightsparkNodePurpose, a8 as LightsparkNodeStatus, a9 as LightsparkNodeToChannelsConnection, aa as Node, ab as NodeAddress, ac as NodeAddressType, ad as NodeToAddressesConnection, ae as OnChainTransaction, ag as OutgoingPayment, ah as OutgoingPaymentAttempt, ai as OutgoingPaymentAttemptStatus, aj as OutgoingPaymentAttemptToHopsConnection, ak as OutgoingPaymentToAttemptsConnection, al as PageInfo, am as PayInvoiceInput, an as PayInvoiceOutput, ao as PaymentFailureReason, ap as PaymentRequest, ar as PaymentRequestData, as as PaymentRequestStatus, at as Permission, au as RequestWithdrawalInput, av as RequestWithdrawalOutput, aw as RichText, ax as RoutingTransaction, az as RoutingTransactionFailureReason, aA as Secret, aB as SendPaymentInput, aC as SendPaymentOutput, aD as SingleNodeDashboard, aE as Transaction, aG as TransactionFailures, aH as TransactionStatus, aI as TransactionType, aJ as TransactionUpdate, aK as Wallet, W as WebhookEventType, aL as Withdrawal, aN as WithdrawalMode, aO as WithdrawalRequest, aP as WithdrawalRequestStatus, aQ as WithdrawalRequestToChannelClosingTransactionsConnection, aR as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, l as getChannelClosingTransactionQuery, o as getChannelOpeningTransactionQuery, J as getDepositQuery, R as getHopQuery, V as getIncomingPaymentAttemptQuery, _ as getInvoiceQuery, a5 as getLightningTransactionQuery, af as getOnChainTransactionQuery, aq as getPaymentRequestQuery, ay as getRoutingTransactionQuery, aF as getTransactionQuery, aM as getWithdrawalQuery } from '../index-d2343f8f.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 ApiToken, B as Balances, i as BitcoinNetwork, j as BlockchainBalance, C as Channel, k as ChannelClosingTransaction, m as ChannelFees, n as ChannelOpeningTransaction, p as ChannelStatus, q as ChannelToTransactionsConnection, r as CreateApiTokenInput, s as CreateApiTokenOutput, t as CreateInvoiceInput, u as CreateInvoiceOutput, v as CreateLnurlInvoiceInput, w as CreateNodeWalletAddressInput, x as CreateNodeWalletAddressOutput, y as CreateTestModeInvoiceInput, z as CreateTestModeInvoiceOutput, D as CreateTestModePaymentInput, E as CreateTestModePaymentoutput, F as CurrencyAmount, G as CurrencyUnit, H as DeleteApiTokenInput, I as DeleteApiTokenOutput, J as Deposit, M as Entity, N as FeeEstimate, O as FundNodeInput, P as FundNodeOutput, Q as GraphNode, R as Hop, T as HtlcAttemptFailureCode, U as IncomingPayment, V as IncomingPaymentAttempt, Y as IncomingPaymentAttemptStatus, Z as IncomingPaymentToAttemptsConnection, _ as Invoice, a0 as InvoiceData, a1 as InvoiceType, a2 as LightningFeeEstimateForInvoiceInput, a3 as LightningFeeEstimateForNodeInput, a4 as LightningFeeEstimateOutput, a5 as LightningTransaction, a7 as LightsparkNode, a8 as LightsparkNodeOwner, aa as LightsparkNodePurpose, ab as LightsparkNodeStatus, ac as LightsparkNodeToChannelsConnection, ad as Node, ae as NodeAddress, af as NodeAddressType, ag as NodeToAddressesConnection, ah as OnChainTransaction, aj as OutgoingPayment, ak as OutgoingPaymentAttempt, al as OutgoingPaymentAttemptStatus, am as OutgoingPaymentAttemptToHopsConnection, an as OutgoingPaymentToAttemptsConnection, ao as PageInfo, ap as PayInvoiceInput, aq as PayInvoiceOutput, ar as PaymentFailureReason, as as PaymentRequest, au as PaymentRequestData, av as PaymentRequestStatus, aw as Permission, ax as RequestWithdrawalInput, ay as RequestWithdrawalOutput, az as RichText, aA as RoutingTransaction, aC as RoutingTransactionFailureReason, aD as Secret, aE as SendPaymentInput, aF as SendPaymentOutput, aG as SingleNodeDashboard, aH as Transaction, aJ as TransactionFailures, aK as TransactionStatus, aL as TransactionType, aM as TransactionUpdate, aN as Wallet, aO as WalletStatus, W as WebhookEventType, aP as Withdrawal, aR as WithdrawalMode, aS as WithdrawalRequest, aT as WithdrawalRequestStatus, aU as WithdrawalRequestToChannelClosingTransactionsConnection, aV as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, l as getChannelClosingTransactionQuery, o as getChannelOpeningTransactionQuery, K as getDepositQuery, S as getHopQuery, X as getIncomingPaymentAttemptQuery, $ as getInvoiceQuery, a6 as getLightningTransactionQuery, a9 as getLightsparkNodeOwnerQuery, ai as getOnChainTransactionQuery, at as getPaymentRequestQuery, aB as getRoutingTransactionQuery, aI as getTransactionQuery, aQ as getWithdrawalQuery } from '../index-aa922ada.js';
 import '@lightsparkdev/core';
 import 'zen-observable';

package/dist/objects/index.js

@@ -24,6 +24,7 @@ import {
   RoutingTransactionFailureReason_default,
   TransactionStatus_default,
   TransactionType_default,
+  WalletStatus_default,
   Wallet_default,
   WebhookEventType_default,
   WithdrawalMode_default,
@@ -37,12 +38,13 @@ import {
   getIncomingPaymentAttemptQuery,
   getInvoiceQuery,
   getLightningTransactionQuery,
+  getLightsparkNodeOwnerQuery,
   getOnChainTransactionQuery,
   getPaymentRequestQuery,
   getRoutingTransactionQuery,
   getTransactionQuery,
   getWithdrawalQuery
-} from "../chunk-PD33OHE4.js";
+} from "../chunk-VAJWSX3C.js";
 import "../chunk-NIMBE7W3.js";
 export {
   Account_default as Account,
@@ -71,6 +73,7 @@ export {
   TransactionStatus_default as TransactionStatus,
   TransactionType_default as TransactionType,
   Wallet_default as Wallet,
+  WalletStatus_default as WalletStatus,
   WebhookEventType_default as WebhookEventType,
   WithdrawalMode_default as WithdrawalMode,
   WithdrawalRequest_default as WithdrawalRequest,
@@ -83,6 +86,7 @@ export {
   getIncomingPaymentAttemptQuery,
   getInvoiceQuery,
   getLightningTransactionQuery,
+  getLightsparkNodeOwnerQuery,
   getOnChainTransactionQuery,
   getPaymentRequestQuery,
   getRoutingTransactionQuery,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [
@@ -69,7 +69,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@lightsparkdev/core": "0.3.2",
+    "@lightsparkdev/core": "0.3.3",
     "auto-bind": "^5.0.1",
     "crypto": "^1.0.1",
     "crypto-browserify": "^3.12.0",
@@ -85,6 +85,7 @@
     "@types/ws": "^8.5.4",
     "jest": "^29.4.1",
     "prettier": "2.8.7",
+    "prettier-plugin-organize-imports": "^3.2.2",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
     "tsconfig": "*",

package/src/client.ts

@@ -19,9 +19,11 @@ import {
   Requester,
   StubAuthProvider,
 } from "@lightsparkdev/core";
+import { createHash } from "crypto";
 import { BitcoinFeeEstimate as BitcoinFeeEstimateQuery } from "./graphql/BitcoinFeeEstimate.js";
 import { CreateApiToken } from "./graphql/CreateApiToken.js";
 import { CreateInvoice } from "./graphql/CreateInvoice.js";
+import { CreateLnurlInvoice } from "./graphql/CreateLnurlInvoice.js";
 import { CreateNodeWalletAddress } from "./graphql/CreateNodeWalletAddress.js";
 import { CreateTestModeInvoice } from "./graphql/CreateTestModeInvoice.js";
 import { CreateTestModePayment } from "./graphql/CreateTestModePayment.js";
@@ -49,6 +51,7 @@ import CurrencyAmount, {
   CurrencyAmountFromJson,
 } from "./objects/CurrencyAmount.js";
 import FeeEstimate, { FeeEstimateFromJson } from "./objects/FeeEstimate.js";
+import Invoice, { InvoiceFromJson } from "./objects/Invoice.js";
 import InvoiceData, { InvoiceDataFromJson } from "./objects/InvoiceData.js";
 import InvoiceType from "./objects/InvoiceType.js";
 import OutgoingPayment, {
@@ -405,6 +408,37 @@ class LightsparkClient {
     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,
+   * with [createInvoice] preferred in the general case.
+   *
+   * 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.
+   * @param metadata The LNURL metadata payload field in the initial payreq response. This wil be hashed and present in the
+   *     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.
+   * @returns An Invoice object representing the generated invoice.
+   */
+  public async createLnurlInvoice(
+    nodeId: string,
+    amountMsats: number,
+    metadata: string
+  ): Promise<Invoice | undefined> {
+    const response = await this.requester.makeRawRequest(CreateLnurlInvoice, {
+      node_id: nodeId,
+      amount_msats: amountMsats,
+      metadata_hash: createHash("sha256").update(metadata).digest("hex"),
+    });
+    const invoiceJson = response.create_lnurl_invoice?.invoice;
+    if (!invoiceJson) {
+      return undefined;
+    }
+    return InvoiceFromJson(invoiceJson);
+  }
+
   /**
    * Decodes an encoded lightning invoice string.
    *

package/src/graphql/CreateLnurlInvoice.ts

@@ -0,0 +1,21 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+import { FRAGMENT as InvoiceFragment } from "../objects/Invoice.js";
+
+export const CreateLnurlInvoice = `
+mutation CreateLnurlInvoice(
+  $node_id: ID!
+  $amount_msats: Long!
+  $metadata_hash: String!
+) {
+  create_lnurl_invoice(input: {
+      node_id: $node_id
+      amount_msats: $amount_msats
+      metadata_hash: $metadata_hash
+  }) {
+      invoice {
+          ...InvoiceFragment
+      }
+  }
+}
+${InvoiceFragment}
+`;

package/src/objects/Account.ts

@@ -26,12 +26,12 @@ import BlockchainBalance, {
   BlockchainBalanceFromJson,
 } from "./BlockchainBalance.js";
 import CurrencyAmount, { CurrencyAmountFromJson } from "./CurrencyAmount.js";
-import Entity from "./Entity.js";
+import LightsparkNodeOwner from "./LightsparkNodeOwner.js";
 import TransactionFailures from "./TransactionFailures.js";
 import TransactionStatus from "./TransactionStatus.js";
 import TransactionType from "./TransactionType.js";
 
-class Account implements Entity {
+class Account implements LightsparkNodeOwner {
   constructor(
     public readonly id: string,
     public readonly createdAt: string,
@@ -245,6 +245,9 @@ query FetchAccountToNodesConnection($first: Int, $bitcoin_networks: [BitcoinNetw
                     lightspark_node_account: account {
                         id
                     }
+                    lightspark_node_owner: owner {
+                        id
+                    }
                     lightspark_node_blockchain_balance: blockchain_balance {
                         __typename
                         blockchain_balance_total_balance: total_balance {
@@ -786,6 +789,9 @@ query FetchAccountToTransactionsConnection($first: Int, $after: String, $types:
                                         lightspark_node_account: account {
                                             id
                                         }
+                                        lightspark_node_owner: owner {
+                                            id
+                                        }
                                         lightspark_node_blockchain_balance: blockchain_balance {
                                             __typename
                                             blockchain_balance_total_balance: total_balance {
@@ -1053,6 +1059,9 @@ query FetchAccountToPaymentRequestsConnection($first: Int, $after: String, $afte
                                     lightspark_node_account: account {
                                         id
                                     }
+                                    lightspark_node_owner: owner {
+                                        id
+                                    }
                                     lightspark_node_blockchain_balance: blockchain_balance {
                                         __typename
                                         blockchain_balance_total_balance: total_balance {
@@ -1237,6 +1246,7 @@ query FetchAccountToWalletsConnection($first: Int) {
                         }
                     }
                     wallet_third_party_identifier: third_party_identifier
+                    wallet_status: status
                 }
             }
         }

package/src/objects/CreateLnurlInvoiceInput.ts

@@ -0,0 +1,27 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+type CreateLnurlInvoiceInput = {
+  /** The node from which to create the invoice. **/
+  nodeId: string;
+
+  /** The amount for which the invoice should be created, in millisatoshis. **/
+  amountMsats: number;
+
+  /**
+   * The SHA256 hash of the LNURL metadata payload. This will be present in the h-tag (SHA256 purpose of
+   * payment) of the resulting Bolt 11 invoice.
+   **/
+  metadataHash: string;
+};
+
+export const CreateLnurlInvoiceInputFromJson = (
+  obj: any
+): CreateLnurlInvoiceInput => {
+  return {
+    nodeId: obj["create_lnurl_invoice_input_node_id"],
+    amountMsats: obj["create_lnurl_invoice_input_amount_msats"],
+    metadataHash: obj["create_lnurl_invoice_input_metadata_hash"],
+  } as CreateLnurlInvoiceInput;
+};
+
+export default CreateLnurlInvoiceInput;

package/src/objects/Entity.ts

@@ -361,6 +361,9 @@ fragment EntityFragment on Entity {
                     lightspark_node_account: account {
                         id
                     }
+                    lightspark_node_owner: owner {
+                        id
+                    }
                     lightspark_node_blockchain_balance: blockchain_balance {
                         __typename
                         blockchain_balance_total_balance: total_balance {
@@ -478,6 +481,9 @@ fragment EntityFragment on Entity {
         lightspark_node_account: account {
             id
         }
+        lightspark_node_owner: owner {
+            id
+        }
         lightspark_node_blockchain_balance: blockchain_balance {
             __typename
             blockchain_balance_total_balance: total_balance {
@@ -645,6 +651,9 @@ fragment EntityFragment on Entity {
                         lightspark_node_account: account {
                             id
                         }
+                        lightspark_node_owner: owner {
+                            id
+                        }
                         lightspark_node_blockchain_balance: blockchain_balance {
                             __typename
                             blockchain_balance_total_balance: total_balance {
@@ -844,6 +853,7 @@ fragment EntityFragment on Entity {
             }
         }
         wallet_third_party_identifier: third_party_identifier
+        wallet_status: status
     }
     ... on Withdrawal {
         __typename

package/src/objects/Invoice.ts

@@ -101,6 +101,9 @@ fragment InvoiceFragment on Invoice {
                 lightspark_node_account: account {
                     id
                 }
+                lightspark_node_owner: owner {
+                    id
+                }
                 lightspark_node_blockchain_balance: blockchain_balance {
                     __typename
                     blockchain_balance_total_balance: total_balance {

package/src/objects/InvoiceData.ts

@@ -97,6 +97,9 @@ fragment InvoiceDataFragment on InvoiceData {
             lightspark_node_account: account {
                 id
             }
+            lightspark_node_owner: owner {
+                id
+            }
             lightspark_node_blockchain_balance: blockchain_balance {
                 __typename
                 blockchain_balance_total_balance: total_balance {

package/src/objects/LightningTransaction.ts

@@ -232,6 +232,9 @@ fragment LightningTransactionFragment on LightningTransaction {
                         lightspark_node_account: account {
                             id
                         }
+                        lightspark_node_owner: owner {
+                            id
+                        }
                         lightspark_node_blockchain_balance: blockchain_balance {
                             __typename
                             blockchain_balance_total_balance: total_balance {

package/src/objects/LightsparkNode.ts

@@ -30,6 +30,7 @@ class LightsparkNode implements Node {
     public readonly bitcoinNetwork: BitcoinNetwork,
     public readonly displayName: string,
     public readonly accountId: string,
+    public readonly ownerId: string,
     public readonly typename: string,
     public readonly alias?: string,
     public readonly color?: string,
@@ -233,6 +234,7 @@ export const LightsparkNodeFromJson = (obj: any): LightsparkNode => {
       BitcoinNetwork.FUTURE_VALUE,
     obj["lightspark_node_display_name"],
     obj["lightspark_node_account"].id,
+    obj["lightspark_node_owner"].id,
     "LightsparkNode",
     obj["lightspark_node_alias"],
     obj["lightspark_node_color"],
@@ -282,6 +284,9 @@ fragment LightsparkNodeFragment on LightsparkNode {
     lightspark_node_account: account {
         id
     }
+    lightspark_node_owner: owner {
+        id
+    }
     lightspark_node_blockchain_balance: blockchain_balance {
         __typename
         blockchain_balance_total_balance: total_balance {

package/src/objects/LightsparkNodeOwner.ts

@@ -0,0 +1,125 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+import { LightsparkException, Query } from "@lightsparkdev/core";
+import Account from "./Account.js";
+import { BalancesFromJson } from "./Balances.js";
+import Entity from "./Entity.js";
+import Wallet from "./Wallet.js";
+import WalletStatus from "./WalletStatus.js";
+
+type LightsparkNodeOwner = Entity & {
+  /**
+   * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
+   * string.
+   **/
+  id: string;
+
+  /** The date and time when the entity was first created. **/
+  createdAt: string;
+
+  /** The date and time when the entity was last updated. **/
+  updatedAt: string;
+
+  /** The typename of the object **/
+  typename: string;
+};
+
+export const LightsparkNodeOwnerFromJson = (obj: any): LightsparkNodeOwner => {
+  if (obj["__typename"] == "Account") {
+    return new Account(
+      obj["account_id"],
+      obj["account_created_at"],
+      obj["account_updated_at"],
+      "Account",
+      obj["account_name"]
+    );
+  }
+  if (obj["__typename"] == "Wallet") {
+    return new Wallet(
+      obj["wallet_id"],
+      obj["wallet_created_at"],
+      obj["wallet_updated_at"],
+      obj["wallet_third_party_identifier"],
+      WalletStatus[obj["wallet_status"]] ?? WalletStatus.FUTURE_VALUE,
+      "Wallet",
+      obj["wallet_last_login_at"],
+      !!obj["wallet_balances"]
+        ? BalancesFromJson(obj["wallet_balances"])
+        : undefined
+    );
+  }
+  throw new LightsparkException(
+    "DeserializationError",
+    `Couldn't find a concrete type for interface LightsparkNodeOwner corresponding to the typename=${obj["__typename"]}`
+  );
+};
+
+export const FRAGMENT = `
+fragment LightsparkNodeOwnerFragment on LightsparkNodeOwner {
+    __typename
+    ... on Account {
+        __typename
+        account_id: id
+        account_created_at: created_at
+        account_updated_at: updated_at
+        account_name: name
+    }
+    ... on Wallet {
+        __typename
+        wallet_id: id
+        wallet_created_at: created_at
+        wallet_updated_at: updated_at
+        wallet_last_login_at: last_login_at
+        wallet_balances: balances {
+            __typename
+            balances_owned_balance: owned_balance {
+                __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
+            }
+            balances_available_to_send_balance: available_to_send_balance {
+                __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
+            }
+            balances_available_to_withdraw_balance: available_to_withdraw_balance {
+                __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
+            }
+        }
+        wallet_third_party_identifier: third_party_identifier
+        wallet_status: status
+    }
+}`;
+
+export const getLightsparkNodeOwnerQuery = (
+  id: string
+): Query<LightsparkNodeOwner> => {
+  return {
+    queryPayload: `
+query GetLightsparkNodeOwner($id: ID!) {
+    entity(id: $id) {
+        ... on LightsparkNodeOwner {
+            ...LightsparkNodeOwnerFragment
+        }
+    }
+}
+
+${FRAGMENT}    
+`,
+    variables: { id },
+    constructObject: (data: any) => LightsparkNodeOwnerFromJson(data.entity),
+  };
+};
+
+export default LightsparkNodeOwner;

package/src/objects/Node.ts

@@ -109,6 +109,7 @@ export const NodeFromJson = (obj: any): Node => {
         BitcoinNetwork.FUTURE_VALUE,
       obj["lightspark_node_display_name"],
       obj["lightspark_node_account"].id,
+      obj["lightspark_node_owner"].id,
       "LightsparkNode",
       obj["lightspark_node_alias"],
       obj["lightspark_node_color"],
@@ -177,6 +178,9 @@ fragment NodeFragment on Node {
         lightspark_node_account: account {
             id
         }
+        lightspark_node_owner: owner {
+            id
+        }
         lightspark_node_blockchain_balance: blockchain_balance {
             __typename
             blockchain_balance_total_balance: total_balance {

package/src/objects/OutgoingPayment.ts

@@ -215,6 +215,9 @@ fragment OutgoingPaymentFragment on OutgoingPayment {
                     lightspark_node_account: account {
                         id
                     }
+                    lightspark_node_owner: owner {
+                        id
+                    }
                     lightspark_node_blockchain_balance: blockchain_balance {
                         __typename
                         blockchain_balance_total_balance: total_balance {

package/src/objects/PaymentRequest.ts

@@ -105,6 +105,9 @@ fragment PaymentRequestFragment on PaymentRequest {
                     lightspark_node_account: account {
                         id
                     }
+                    lightspark_node_owner: owner {
+                        id
+                    }
                     lightspark_node_blockchain_balance: blockchain_balance {
                         __typename
                         blockchain_balance_total_balance: total_balance {

package/src/objects/PaymentRequestData.ts

@@ -85,6 +85,9 @@ fragment PaymentRequestDataFragment on PaymentRequestData {
                 lightspark_node_account: account {
                     id
                 }
+                lightspark_node_owner: owner {
+                    id
+                }
                 lightspark_node_blockchain_balance: blockchain_balance {
                     __typename
                     blockchain_balance_total_balance: total_balance {

package/src/objects/Transaction.ts

@@ -418,6 +418,9 @@ fragment TransactionFragment on Transaction {
                         lightspark_node_account: account {
                             id
                         }
+                        lightspark_node_owner: owner {
+                            id
+                        }
                         lightspark_node_blockchain_balance: blockchain_balance {
                             __typename
                             blockchain_balance_total_balance: total_balance {

package/src/objects/Wallet.ts

@@ -5,14 +5,16 @@ import autoBind from "auto-bind";
 import LightsparkClient from "../client.js";
 import Balances, { BalancesFromJson } from "./Balances.js";
 import CurrencyAmount, { CurrencyAmountFromJson } from "./CurrencyAmount.js";
-import Entity from "./Entity.js";
+import LightsparkNodeOwner from "./LightsparkNodeOwner.js";
+import WalletStatus from "./WalletStatus.js";
 
-class Wallet implements Entity {
+class Wallet implements LightsparkNodeOwner {
   constructor(
     public readonly id: string,
     public readonly createdAt: string,
     public readonly updatedAt: string,
     public readonly thirdPartyIdentifier: string,
+    public readonly status: WalletStatus,
     public readonly typename: string,
     public readonly lastLoginAt?: string,
     public readonly balances?: Balances
@@ -86,11 +88,11 @@ query FetchWalletTotalAmountSent($created_after_date: DateTime, $created_before_
     }))!;
   }
 
-  static getWalletQuery(): Query<Wallet> {
+  static getWalletQuery(id: string): Query<Wallet> {
     return {
       queryPayload: `
-query GetWallet {
-    current_wallet {
+query GetWallet($id: ID!) {
+    entity(id: $id) {
         ... on Wallet {
             ...WalletFragment
         }
@@ -99,8 +101,8 @@ query GetWallet {
 
 ${FRAGMENT}    
 `,
-      variables: {},
-      constructObject: (data: any) => WalletFromJson(data.current_wallet),
+      variables: { id },
+      constructObject: (data: any) => WalletFromJson(data.entity),
     };
   }
 }
@@ -111,6 +113,7 @@ export const WalletFromJson = (obj: any): Wallet => {
     obj["wallet_created_at"],
     obj["wallet_updated_at"],
     obj["wallet_third_party_identifier"],
+    WalletStatus[obj["wallet_status"]] ?? WalletStatus.FUTURE_VALUE,
     "Wallet",
     obj["wallet_last_login_at"],
     !!obj["wallet_balances"]
@@ -154,6 +157,7 @@ fragment WalletFragment on Wallet {
         }
     }
     wallet_third_party_identifier: third_party_identifier
+    wallet_status: status
 }`;
 
 export default Wallet;

package/src/objects/WalletStatus.ts

@@ -0,0 +1,29 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+export enum WalletStatus {
+  /**
+   * 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",
+  /** The wallet has not been set up yet and is ready to be deployed. This is the default status after the first login. **/
+  NOT_SETUP = "NOT_SETUP",
+  /** The wallet is currently being deployed in the Lightspark infrastructure. **/
+  DEPLOYING = "DEPLOYING",
+  /** The wallet has been deployed in the Lightspark infrastructure and is ready to be initialized. **/
+  DEPLOYED = "DEPLOYED",
+  /** The wallet is currently being initialized. **/
+  INITIALIZING = "INITIALIZING",
+  /** The wallet is available and ready to be used. **/
+  READY = "READY",
+  /** The wallet is temporarily available, due to a transient issue or a scheduled maintenance. **/
+  UNAVAILABLE = "UNAVAILABLE",
+  /** The wallet had an unrecoverable failure. This status is not expected to happend and will be investigated by the Lightspark team. **/
+  FAILED = "FAILED",
+  /** The wallet is being terminated. **/
+  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. **/
+  TERMINATED = "TERMINATED",
+}
+
+export default WalletStatus;

package/src/objects/index.ts

@@ -25,6 +25,7 @@ export { default as CreateApiTokenInput } from "./CreateApiTokenInput.js";
 export { default as CreateApiTokenOutput } from "./CreateApiTokenOutput.js";
 export { default as CreateInvoiceInput } from "./CreateInvoiceInput.js";
 export { default as CreateInvoiceOutput } from "./CreateInvoiceOutput.js";
+export { default as CreateLnurlInvoiceInput } from "./CreateLnurlInvoiceInput.js";
 export { default as CreateNodeWalletAddressInput } from "./CreateNodeWalletAddressInput.js";
 export { default as CreateNodeWalletAddressOutput } from "./CreateNodeWalletAddressOutput.js";
 export { default as CreateTestModeInvoiceInput } from "./CreateTestModeInvoiceInput.js";
@@ -61,6 +62,10 @@ export {
   getLightningTransactionQuery,
 } from "./LightningTransaction.js";
 export { default as LightsparkNode } from "./LightsparkNode.js";
+export {
+  default as LightsparkNodeOwner,
+  getLightsparkNodeOwnerQuery,
+} from "./LightsparkNodeOwner.js";
 export { default as LightsparkNodePurpose } from "./LightsparkNodePurpose.js";
 export { default as LightsparkNodeStatus } from "./LightsparkNodeStatus.js";
 export { default as LightsparkNodeToChannelsConnection } from "./LightsparkNodeToChannelsConnection.js";
@@ -106,6 +111,7 @@ export { default as TransactionStatus } from "./TransactionStatus.js";
 export { default as TransactionType } from "./TransactionType.js";
 export { default as TransactionUpdate } from "./TransactionUpdate.js";
 export { default as Wallet } from "./Wallet.js";
+export { default as WalletStatus } from "./WalletStatus.js";
 export { default as WebhookEventType } from "./WebhookEventType.js";
 export { default as Withdrawal, getWithdrawalQuery } from "./Withdrawal.js";
 export { default as WithdrawalMode } from "./WithdrawalMode.js";

package/src/webhooks.ts

@@ -8,6 +8,7 @@ export interface WebhookEvent {
   event_id: string;
   timestamp: Date;
   entity_id: string;
+  wallet_id?: string;
 }
 
 export const verifyAndParseWebhook = (
@@ -38,5 +39,6 @@ const parseWebhook = async (data: Uint8Array): Promise<WebhookEvent> => {
     event_id: event.event_id,
     timestamp: new Date(event.timestamp),
     entity_id: event.entity_id,
+    wallet_id: event.wallet_id,
   };
 };