@lightsparkdev/lightspark-sdk 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @lightsparkdev/lightspark-sdk
 
+## 1.1.4
+
+### Patch Changes
+
+- 1372f3a: Move transaction polling into new client method
+- Updated dependencies [24782f5]
+  - @lightsparkdev/core@1.0.7
+
+## 1.1.3
+
+### Patch Changes
+
+- baeb7a1: [lightspark-sdk] Fix improper fundNode var ref and add tests
+- Updated dependencies [ffcedbe]
+- Updated dependencies [d9f6d5b]
+- Updated dependencies [baeb7a1]
+  - @lightsparkdev/core@1.0.6
+
 ## 1.1.2
 
 ### Patch Changes

package/dist/{index-95299cb4.d.ts → index-2ac27fbd.d.ts}

@@ -1420,6 +1420,7 @@ declare class LightsparkClient {
      * @returns An array of transactions for the given node ID.
      */
     getRecentTransactions(nodeId: string, numTransactions?: number, bitcoinNetwork?: BitcoinNetwork, afterDate?: Maybe<string>): Promise<Transaction[]>;
+    getTransaction(transactionId: string): Promise<Maybe<Transaction>>;
     /**
      * Retrieves the most recent payment requests for a given node.
      *
@@ -1577,6 +1578,13 @@ declare class LightsparkClient {
      * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
      */
     payUmaInvoice(payerNodeId: string, encodedInvoice: string, maximumFeesMsats: number, timeoutSecs?: number, amountMsats?: number | undefined): Promise<OutgoingPayment | undefined>;
+    /**
+     * 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
+     */
+    waitForTransactionComplete(transactionId: string, pollTimeoutSecs?: number): Promise<Transaction>;
     /**
      * Sends a payment directly to a node on the Lightning Network through the public key of the node without an invoice.
      *

package/dist/index.cjs

@@ -1938,7 +1938,7 @@ var import_core9 = require("@lightsparkdev/core");
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.1.2",
+  version: "1.1.4",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -2026,7 +2026,7 @@ var package_default = {
   },
   license: "Apache-2.0",
   dependencies: {
-    "@lightsparkdev/core": "1.0.5",
+    "@lightsparkdev/core": "1.0.7",
     "@lightsparkdev/crypto-wasm": "0.1.2",
     "auto-bind": "^5.0.1",
     crypto: "^1.0.1",
@@ -4650,9 +4650,9 @@ var DeleteApiToken = `
 var FundNode = `
     mutation FundNode(
         $node_id: ID!,
-        $amountSats: Long
+        $amount_sats: Long
     ) {
-        fund_node(input: { node_id: $node_id, amount_sats: $amountSats }) {
+        fund_node(input: { node_id: $node_id, amount_sats: $amount_sats }) {
             amount {
                 ...CurrencyAmountFragment
             }
@@ -10595,6 +10595,11 @@ var LightsparkClient = class {
       (transaction) => TransactionFromJson(transaction)
     ) ?? [];
   }
+  getTransaction(transactionId) {
+    return this.requester.executeQuery(
+      getTransactionQuery(transactionId)
+    );
+  }
   /**
    * Retrieves the most recent payment requests for a given node.
    *
@@ -11036,6 +11041,43 @@ 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.
+   *
+   * @param transactionId The ID of the transaction to wait for
+   * @param pollTimeoutSecs The timeout in seconds that we will wait before throwing an exception
+   */
+  async waitForTransactionComplete(transactionId, pollTimeoutSecs = 60) {
+    const pollIntervalMs = 250;
+    const pollMaxTimeouts = pollTimeoutSecs * 1e3 / pollIntervalMs;
+    const pollIgnoreErrors = false;
+    const transaction = await (0, import_core9.pollUntil)(
+      () => {
+        return this.getTransaction(transactionId);
+      },
+      (current, response) => {
+        if (current && [
+          TransactionStatus_default.SUCCESS,
+          TransactionStatus_default.CANCELLED,
+          TransactionStatus_default.FAILED
+        ].includes(current.status)) {
+          return {
+            stopPolling: true,
+            value: current
+          };
+        }
+        return response;
+      },
+      pollIntervalMs,
+      pollMaxTimeouts,
+      pollIgnoreErrors,
+      () => new import_core9.LightsparkException(
+        "Timeout",
+        "Timeout waiting for transaction to complete."
+      )
+    );
+    return transaction;
+  }
   /**
    * Sends a payment directly to a node on the Lightning Network through the public key of the node without an invoice.
    *

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AuthProvider } from '@lightsparkdev/core';
-import { W as WebhookEventType, L as LightsparkClient } from './index-95299cb4.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 BlockchainBalance, C as Channel, j as ChannelClosingTransaction, l as ChannelFees, m as ChannelOpeningTransaction, o as ChannelStatus, p as ChannelToTransactionsConnection, q as ComplianceProvider, r as Connection, s as CreateApiTokenInput, t as CreateApiTokenOutput, u as CreateInvoiceInput, v as CreateInvoiceOutput, w as CreateLnurlInvoiceInput, x as CreateNodeWalletAddressInput, y as CreateNodeWalletAddressOutput, z as CreateTestModeInvoiceInput, D as CreateTestModeInvoiceOutput, E as CreateTestModePaymentInput, F as CreateTestModePaymentoutput, G as CreateUmaInvoiceInput, H as CurrencyAmount, I as CurrencyUnit, J as DeclineToSignMessagesInput, K as DeclineToSignMessagesOutput, M as DeleteApiTokenInput, N as DeleteApiTokenOutput, O as Deposit, Q as Entity, R as FeeEstimate, S as FundNodeInput, T as FundNodeOutput, U as GraphNode, V as Hop, Y as HtlcAttemptFailureCode, Z as IdAndSignature, _ as IncomingPayment, $ as IncomingPaymentAttempt, a1 as IncomingPaymentAttemptStatus, a2 as IncomingPaymentToAttemptsConnection, a3 as Invoice, a5 as InvoiceData, a6 as InvoiceType, a7 as LightningFeeEstimateForInvoiceInput, a8 as LightningFeeEstimateForNodeInput, a9 as LightningFeeEstimateOutput, aa as LightningTransaction, ac as LightsparkNode, ad as LightsparkNodeOwner, af as LightsparkNodeStatus, ag as LightsparkNodeToChannelsConnection, ah as LightsparkNodeWithOSK, ai as LightsparkNodeWithRemoteSigning, aj as Node, ak as NodeAddress, al as NodeAddressType, am as NodeToAddressesConnection, an as OnChainTransaction, ap as OutgoingPayment, aq as OutgoingPaymentAttempt, ar as OutgoingPaymentAttemptStatus, as as OutgoingPaymentAttemptToHopsConnection, av as OutgoingPaymentToAttemptsConnection, at as OutgoingPaymentsForInvoiceQueryInput, au as OutgoingPaymentsForInvoiceQueryOutput, aw as PageInfo, ax as PayInvoiceInput, ay as PayInvoiceOutput, aF as PayUmaInvoiceInput, az as PaymentDirection, aA as PaymentFailureReason, aB as PaymentRequest, aD as PaymentRequestData, aE as PaymentRequestStatus, aG as Permission, aH as PostTransactionData, aI as RegisterPaymentInput, aJ as RegisterPaymentOutput, aK as ReleaseChannelPerCommitmentSecretInput, aL as ReleaseChannelPerCommitmentSecretOutput, aM as ReleasePaymentPreimageInput, aN as ReleasePaymentPreimageOutput, aO as RemoteSigningSubEventType, aP as RequestWithdrawalInput, aQ as RequestWithdrawalOutput, aR as RichText, aS as RiskRating, aT as RoutingTransaction, aV as RoutingTransactionFailureReason, aW as ScreenNodeInput, aX as ScreenNodeOutput, aY as Secret, aZ as SendPaymentInput, a_ as SendPaymentOutput, a$ as SetInvoicePaymentHashInput, b0 as SetInvoicePaymentHashOutput, b6 as SignInvoiceInput, b7 as SignInvoiceOutput, b8 as SignMessagesInput, b9 as SignMessagesOutput, b1 as Signable, b3 as SignablePayload, b5 as SignablePayloadStatus, ba as SingleNodeDashboard, bb as Transaction, bd as TransactionFailures, be as TransactionStatus, bf as TransactionType, bg as TransactionUpdate, bh as UpdateChannelPerCommitmentPointInput, bi as UpdateChannelPerCommitmentPointOutput, bj as UpdateNodeSharedSecretInput, bk as UpdateNodeSharedSecretOutput, bl as Wallet, bm as WalletStatus, bn as WalletToPaymentRequestsConnection, bo as WalletToTransactionsConnection, bp as Withdrawal, br as WithdrawalMode, bs as WithdrawalRequest, bt as WithdrawalRequestStatus, bu as WithdrawalRequestToChannelClosingTransactionsConnection, bv as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, k as getChannelClosingTransactionQuery, n as getChannelOpeningTransactionQuery, P as getDepositQuery, X as getHopQuery, a0 as getIncomingPaymentAttemptQuery, a4 as getInvoiceQuery, ab as getLightningTransactionQuery, ae as getLightsparkNodeOwnerQuery, ao as getOnChainTransactionQuery, aC as getPaymentRequestQuery, aU as getRoutingTransactionQuery, b4 as getSignablePayloadQuery, b2 as getSignableQuery, bc as getTransactionQuery, bq as getWithdrawalQuery } from './index-95299cb4.js';
+import { W as WebhookEventType, L as LightsparkClient } from './index-2ac27fbd.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 BlockchainBalance, C as Channel, j as ChannelClosingTransaction, l as ChannelFees, m as ChannelOpeningTransaction, o as ChannelStatus, p as ChannelToTransactionsConnection, q as ComplianceProvider, r as Connection, s as CreateApiTokenInput, t as CreateApiTokenOutput, u as CreateInvoiceInput, v as CreateInvoiceOutput, w as CreateLnurlInvoiceInput, x as CreateNodeWalletAddressInput, y as CreateNodeWalletAddressOutput, z as CreateTestModeInvoiceInput, D as CreateTestModeInvoiceOutput, E as CreateTestModePaymentInput, F as CreateTestModePaymentoutput, G as CreateUmaInvoiceInput, H as CurrencyAmount, I as CurrencyUnit, J as DeclineToSignMessagesInput, K as DeclineToSignMessagesOutput, M as DeleteApiTokenInput, N as DeleteApiTokenOutput, O as Deposit, Q as Entity, R as FeeEstimate, S as FundNodeInput, T as FundNodeOutput, U as GraphNode, V as Hop, Y as HtlcAttemptFailureCode, Z as IdAndSignature, _ as IncomingPayment, $ as IncomingPaymentAttempt, a1 as IncomingPaymentAttemptStatus, a2 as IncomingPaymentToAttemptsConnection, a3 as Invoice, a5 as InvoiceData, a6 as InvoiceType, a7 as LightningFeeEstimateForInvoiceInput, a8 as LightningFeeEstimateForNodeInput, a9 as LightningFeeEstimateOutput, aa as LightningTransaction, ac as LightsparkNode, ad as LightsparkNodeOwner, af as LightsparkNodeStatus, ag as LightsparkNodeToChannelsConnection, ah as LightsparkNodeWithOSK, ai as LightsparkNodeWithRemoteSigning, aj as Node, ak as NodeAddress, al as NodeAddressType, am as NodeToAddressesConnection, an as OnChainTransaction, ap as OutgoingPayment, aq as OutgoingPaymentAttempt, ar as OutgoingPaymentAttemptStatus, as as OutgoingPaymentAttemptToHopsConnection, av as OutgoingPaymentToAttemptsConnection, at as OutgoingPaymentsForInvoiceQueryInput, au as OutgoingPaymentsForInvoiceQueryOutput, aw as PageInfo, ax as PayInvoiceInput, ay as PayInvoiceOutput, aF as PayUmaInvoiceInput, az as PaymentDirection, aA as PaymentFailureReason, aB as PaymentRequest, aD as PaymentRequestData, aE as PaymentRequestStatus, aG as Permission, aH as PostTransactionData, aI as RegisterPaymentInput, aJ as RegisterPaymentOutput, aK as ReleaseChannelPerCommitmentSecretInput, aL as ReleaseChannelPerCommitmentSecretOutput, aM as ReleasePaymentPreimageInput, aN as ReleasePaymentPreimageOutput, aO as RemoteSigningSubEventType, aP as RequestWithdrawalInput, aQ as RequestWithdrawalOutput, aR as RichText, aS as RiskRating, aT as RoutingTransaction, aV as RoutingTransactionFailureReason, aW as ScreenNodeInput, aX as ScreenNodeOutput, aY as Secret, aZ as SendPaymentInput, a_ as SendPaymentOutput, a$ as SetInvoicePaymentHashInput, b0 as SetInvoicePaymentHashOutput, b6 as SignInvoiceInput, b7 as SignInvoiceOutput, b8 as SignMessagesInput, b9 as SignMessagesOutput, b1 as Signable, b3 as SignablePayload, b5 as SignablePayloadStatus, ba as SingleNodeDashboard, bb as Transaction, bd as TransactionFailures, be as TransactionStatus, bf as TransactionType, bg as TransactionUpdate, bh as UpdateChannelPerCommitmentPointInput, bi as UpdateChannelPerCommitmentPointOutput, bj as UpdateNodeSharedSecretInput, bk as UpdateNodeSharedSecretOutput, bl as Wallet, bm as WalletStatus, bn as WalletToPaymentRequestsConnection, bo as WalletToTransactionsConnection, bp as Withdrawal, br as WithdrawalMode, bs as WithdrawalRequest, bt as WithdrawalRequestStatus, bu as WithdrawalRequestToChannelClosingTransactionsConnection, bv as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, k as getChannelClosingTransactionQuery, n as getChannelOpeningTransactionQuery, P as getDepositQuery, X as getHopQuery, a0 as getIncomingPaymentAttemptQuery, a4 as getInvoiceQuery, ab as getLightningTransactionQuery, ae as getLightsparkNodeOwnerQuery, ao as getOnChainTransactionQuery, aC as getPaymentRequestQuery, aU as getRoutingTransactionQuery, b4 as getSignablePayloadQuery, b2 as getSignableQuery, bc as getTransactionQuery, bq as getWithdrawalQuery } from './index-2ac27fbd.js';
 import { B as BitcoinNetwork } from './BitcoinNetwork-a816c0be.js';
 import 'zen-observable';
 

package/dist/index.js

@@ -125,6 +125,7 @@ import {
   LightsparkException,
   LightsparkSigningException as LightsparkSigningException3,
   NodeKeyCache,
+  pollUntil,
   Requester,
   SigningKeyType as SigningKeyType2,
   StubAuthProvider
@@ -133,7 +134,7 @@ import {
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.1.2",
+  version: "1.1.4",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -221,7 +222,7 @@ var package_default = {
   },
   license: "Apache-2.0",
   dependencies: {
-    "@lightsparkdev/core": "1.0.5",
+    "@lightsparkdev/core": "1.0.7",
     "@lightsparkdev/crypto-wasm": "0.1.2",
     "auto-bind": "^5.0.1",
     crypto: "^1.0.1",
@@ -432,9 +433,9 @@ var DeleteApiToken = `
 var FundNode = `
     mutation FundNode(
         $node_id: ID!,
-        $amountSats: Long
+        $amount_sats: Long
     ) {
-        fund_node(input: { node_id: $node_id, amount_sats: $amountSats }) {
+        fund_node(input: { node_id: $node_id, amount_sats: $amount_sats }) {
             amount {
                 ...CurrencyAmountFragment
             }
@@ -1149,6 +1150,11 @@ var LightsparkClient = class {
       (transaction) => TransactionFromJson(transaction)
     ) ?? [];
   }
+  getTransaction(transactionId) {
+    return this.requester.executeQuery(
+      getTransactionQuery(transactionId)
+    );
+  }
   /**
    * Retrieves the most recent payment requests for a given node.
    *
@@ -1590,6 +1596,43 @@ 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.
+   *
+   * @param transactionId The ID of the transaction to wait for
+   * @param pollTimeoutSecs The timeout in seconds that we will wait before throwing an exception
+   */
+  async waitForTransactionComplete(transactionId, pollTimeoutSecs = 60) {
+    const pollIntervalMs = 250;
+    const pollMaxTimeouts = pollTimeoutSecs * 1e3 / pollIntervalMs;
+    const pollIgnoreErrors = false;
+    const transaction = await pollUntil(
+      () => {
+        return this.getTransaction(transactionId);
+      },
+      (current, response) => {
+        if (current && [
+          TransactionStatus_default.SUCCESS,
+          TransactionStatus_default.CANCELLED,
+          TransactionStatus_default.FAILED
+        ].includes(current.status)) {
+          return {
+            stopPolling: true,
+            value: current
+          };
+        }
+        return response;
+      },
+      pollIntervalMs,
+      pollMaxTimeouts,
+      pollIgnoreErrors,
+      () => new LightsparkException(
+        "Timeout",
+        "Timeout waiting for transaction to complete."
+      )
+    );
+    return transaction;
+  }
   /**
    * Sends a payment directly to a node on the Lightning Network through the public key of the node without an invoice.
    *

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 ApiToken, B as Balances, i as BlockchainBalance, C as Channel, j as ChannelClosingTransaction, l as ChannelFees, m as ChannelOpeningTransaction, o as ChannelStatus, p as ChannelToTransactionsConnection, q as ComplianceProvider, r as Connection, s as CreateApiTokenInput, t as CreateApiTokenOutput, u as CreateInvoiceInput, v as CreateInvoiceOutput, w as CreateLnurlInvoiceInput, x as CreateNodeWalletAddressInput, y as CreateNodeWalletAddressOutput, z as CreateTestModeInvoiceInput, D as CreateTestModeInvoiceOutput, E as CreateTestModePaymentInput, F as CreateTestModePaymentoutput, G as CreateUmaInvoiceInput, H as CurrencyAmount, I as CurrencyUnit, J as DeclineToSignMessagesInput, K as DeclineToSignMessagesOutput, M as DeleteApiTokenInput, N as DeleteApiTokenOutput, O as Deposit, Q as Entity, R as FeeEstimate, S as FundNodeInput, T as FundNodeOutput, U as GraphNode, V as Hop, Y as HtlcAttemptFailureCode, Z as IdAndSignature, _ as IncomingPayment, $ as IncomingPaymentAttempt, a1 as IncomingPaymentAttemptStatus, a2 as IncomingPaymentToAttemptsConnection, a3 as Invoice, a5 as InvoiceData, a6 as InvoiceType, a7 as LightningFeeEstimateForInvoiceInput, a8 as LightningFeeEstimateForNodeInput, a9 as LightningFeeEstimateOutput, aa as LightningTransaction, ac as LightsparkNode, ad as LightsparkNodeOwner, af as LightsparkNodeStatus, ag as LightsparkNodeToChannelsConnection, ah as LightsparkNodeWithOSK, ai as LightsparkNodeWithRemoteSigning, aj as Node, ak as NodeAddress, al as NodeAddressType, am as NodeToAddressesConnection, an as OnChainTransaction, ap as OutgoingPayment, aq as OutgoingPaymentAttempt, ar as OutgoingPaymentAttemptStatus, as as OutgoingPaymentAttemptToHopsConnection, av as OutgoingPaymentToAttemptsConnection, at as OutgoingPaymentsForInvoiceQueryInput, au as OutgoingPaymentsForInvoiceQueryOutput, aw as PageInfo, ax as PayInvoiceInput, ay as PayInvoiceOutput, aF as PayUmaInvoiceInput, az as PaymentDirection, aA as PaymentFailureReason, aB as PaymentRequest, aD as PaymentRequestData, aE as PaymentRequestStatus, aG as Permission, aH as PostTransactionData, aI as RegisterPaymentInput, aJ as RegisterPaymentOutput, aK as ReleaseChannelPerCommitmentSecretInput, aL as ReleaseChannelPerCommitmentSecretOutput, aM as ReleasePaymentPreimageInput, aN as ReleasePaymentPreimageOutput, aO as RemoteSigningSubEventType, aP as RequestWithdrawalInput, aQ as RequestWithdrawalOutput, aR as RichText, aS as RiskRating, aT as RoutingTransaction, aV as RoutingTransactionFailureReason, aW as ScreenNodeInput, aX as ScreenNodeOutput, aY as Secret, aZ as SendPaymentInput, a_ as SendPaymentOutput, a$ as SetInvoicePaymentHashInput, b0 as SetInvoicePaymentHashOutput, b6 as SignInvoiceInput, b7 as SignInvoiceOutput, b8 as SignMessagesInput, b9 as SignMessagesOutput, b1 as Signable, b3 as SignablePayload, b5 as SignablePayloadStatus, ba as SingleNodeDashboard, bb as Transaction, bd as TransactionFailures, be as TransactionStatus, bf as TransactionType, bg as TransactionUpdate, bh as UpdateChannelPerCommitmentPointInput, bi as UpdateChannelPerCommitmentPointOutput, bj as UpdateNodeSharedSecretInput, bk as UpdateNodeSharedSecretOutput, bl as Wallet, bm as WalletStatus, bn as WalletToPaymentRequestsConnection, bo as WalletToTransactionsConnection, W as WebhookEventType, bp as Withdrawal, br as WithdrawalMode, bs as WithdrawalRequest, bt as WithdrawalRequestStatus, bu as WithdrawalRequestToChannelClosingTransactionsConnection, bv as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, k as getChannelClosingTransactionQuery, n as getChannelOpeningTransactionQuery, P as getDepositQuery, X as getHopQuery, a0 as getIncomingPaymentAttemptQuery, a4 as getInvoiceQuery, ab as getLightningTransactionQuery, ae as getLightsparkNodeOwnerQuery, ao as getOnChainTransactionQuery, aC as getPaymentRequestQuery, aU as getRoutingTransactionQuery, b4 as getSignablePayloadQuery, b2 as getSignableQuery, bc as getTransactionQuery, bq as getWithdrawalQuery } from '../index-95299cb4.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 BlockchainBalance, C as Channel, j as ChannelClosingTransaction, l as ChannelFees, m as ChannelOpeningTransaction, o as ChannelStatus, p as ChannelToTransactionsConnection, q as ComplianceProvider, r as Connection, s as CreateApiTokenInput, t as CreateApiTokenOutput, u as CreateInvoiceInput, v as CreateInvoiceOutput, w as CreateLnurlInvoiceInput, x as CreateNodeWalletAddressInput, y as CreateNodeWalletAddressOutput, z as CreateTestModeInvoiceInput, D as CreateTestModeInvoiceOutput, E as CreateTestModePaymentInput, F as CreateTestModePaymentoutput, G as CreateUmaInvoiceInput, H as CurrencyAmount, I as CurrencyUnit, J as DeclineToSignMessagesInput, K as DeclineToSignMessagesOutput, M as DeleteApiTokenInput, N as DeleteApiTokenOutput, O as Deposit, Q as Entity, R as FeeEstimate, S as FundNodeInput, T as FundNodeOutput, U as GraphNode, V as Hop, Y as HtlcAttemptFailureCode, Z as IdAndSignature, _ as IncomingPayment, $ as IncomingPaymentAttempt, a1 as IncomingPaymentAttemptStatus, a2 as IncomingPaymentToAttemptsConnection, a3 as Invoice, a5 as InvoiceData, a6 as InvoiceType, a7 as LightningFeeEstimateForInvoiceInput, a8 as LightningFeeEstimateForNodeInput, a9 as LightningFeeEstimateOutput, aa as LightningTransaction, ac as LightsparkNode, ad as LightsparkNodeOwner, af as LightsparkNodeStatus, ag as LightsparkNodeToChannelsConnection, ah as LightsparkNodeWithOSK, ai as LightsparkNodeWithRemoteSigning, aj as Node, ak as NodeAddress, al as NodeAddressType, am as NodeToAddressesConnection, an as OnChainTransaction, ap as OutgoingPayment, aq as OutgoingPaymentAttempt, ar as OutgoingPaymentAttemptStatus, as as OutgoingPaymentAttemptToHopsConnection, av as OutgoingPaymentToAttemptsConnection, at as OutgoingPaymentsForInvoiceQueryInput, au as OutgoingPaymentsForInvoiceQueryOutput, aw as PageInfo, ax as PayInvoiceInput, ay as PayInvoiceOutput, aF as PayUmaInvoiceInput, az as PaymentDirection, aA as PaymentFailureReason, aB as PaymentRequest, aD as PaymentRequestData, aE as PaymentRequestStatus, aG as Permission, aH as PostTransactionData, aI as RegisterPaymentInput, aJ as RegisterPaymentOutput, aK as ReleaseChannelPerCommitmentSecretInput, aL as ReleaseChannelPerCommitmentSecretOutput, aM as ReleasePaymentPreimageInput, aN as ReleasePaymentPreimageOutput, aO as RemoteSigningSubEventType, aP as RequestWithdrawalInput, aQ as RequestWithdrawalOutput, aR as RichText, aS as RiskRating, aT as RoutingTransaction, aV as RoutingTransactionFailureReason, aW as ScreenNodeInput, aX as ScreenNodeOutput, aY as Secret, aZ as SendPaymentInput, a_ as SendPaymentOutput, a$ as SetInvoicePaymentHashInput, b0 as SetInvoicePaymentHashOutput, b6 as SignInvoiceInput, b7 as SignInvoiceOutput, b8 as SignMessagesInput, b9 as SignMessagesOutput, b1 as Signable, b3 as SignablePayload, b5 as SignablePayloadStatus, ba as SingleNodeDashboard, bb as Transaction, bd as TransactionFailures, be as TransactionStatus, bf as TransactionType, bg as TransactionUpdate, bh as UpdateChannelPerCommitmentPointInput, bi as UpdateChannelPerCommitmentPointOutput, bj as UpdateNodeSharedSecretInput, bk as UpdateNodeSharedSecretOutput, bl as Wallet, bm as WalletStatus, bn as WalletToPaymentRequestsConnection, bo as WalletToTransactionsConnection, W as WebhookEventType, bp as Withdrawal, br as WithdrawalMode, bs as WithdrawalRequest, bt as WithdrawalRequestStatus, bu as WithdrawalRequestToChannelClosingTransactionsConnection, bv as WithdrawalRequestToChannelOpeningTransactionsConnection, h as getApiTokenQuery, k as getChannelClosingTransactionQuery, n as getChannelOpeningTransactionQuery, P as getDepositQuery, X as getHopQuery, a0 as getIncomingPaymentAttemptQuery, a4 as getInvoiceQuery, ab as getLightningTransactionQuery, ae as getLightsparkNodeOwnerQuery, ao as getOnChainTransactionQuery, aC as getPaymentRequestQuery, aU as getRoutingTransactionQuery, b4 as getSignablePayloadQuery, b2 as getSignableQuery, bc as getTransactionQuery, bq as getWithdrawalQuery } from '../index-2ac27fbd.js';
 export { B as BitcoinNetwork } from '../BitcoinNetwork-a816c0be.js';
 import '@lightsparkdev/core';
 import 'zen-observable';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [
@@ -88,7 +88,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@lightsparkdev/core": "1.0.5",
+    "@lightsparkdev/core": "1.0.7",
     "@lightsparkdev/crypto-wasm": "0.1.2",
     "auto-bind": "^5.0.1",
     "crypto": "^1.0.1",

package/src/client.ts

@@ -18,6 +18,7 @@ import {
   LightsparkException,
   LightsparkSigningException,
   NodeKeyCache,
+  pollUntil,
   Requester,
   SigningKeyType,
   StubAuthProvider,
@@ -46,6 +47,7 @@ import { SendPayment } from "./graphql/SendPayment.js";
 import { SingleNodeDashboard as SingleNodeDashboardQuery } from "./graphql/SingleNodeDashboard.js";
 import { TransactionsForNode } from "./graphql/TransactionsForNode.js";
 import { TransactionSubscription } from "./graphql/TransactionSubscription.js";
+import { TransactionStatus } from "./index.js";
 import NodeKeyLoaderCache from "./NodeKeyLoaderCache.js";
 import Account from "./objects/Account.js";
 import { ApiTokenFromJson } from "./objects/ApiToken.js";
@@ -68,7 +70,10 @@ import { PaymentRequestFromJson } from "./objects/PaymentRequest.js";
 import Permission from "./objects/Permission.js";
 import type SingleNodeDashboard from "./objects/SingleNodeDashboard.js";
 import type Transaction from "./objects/Transaction.js";
-import { TransactionFromJson } from "./objects/Transaction.js";
+import {
+  getTransactionQuery,
+  TransactionFromJson,
+} from "./objects/Transaction.js";
 import type TransactionUpdate from "./objects/TransactionUpdate.js";
 import { TransactionUpdateFromJson } from "./objects/TransactionUpdate.js";
 import type WithdrawalMode from "./objects/WithdrawalMode.js";
@@ -230,6 +235,12 @@ class LightsparkClient {
     );
   }
 
+  public getTransaction(transactionId: string): Promise<Maybe<Transaction>> {
+    return this.requester.executeQuery<Transaction>(
+      getTransactionQuery(transactionId),
+    );
+  }
+
   /**
    * Retrieves the most recent payment requests for a given node.
    *
@@ -780,6 +791,53 @@ class LightsparkClient {
     );
   }
 
+  /**
+   * 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
+   */
+  public async waitForTransactionComplete(
+    transactionId: string,
+    pollTimeoutSecs = 60,
+  ) {
+    const pollIntervalMs = 250;
+    const pollMaxTimeouts = (pollTimeoutSecs * 1000) / pollIntervalMs;
+    const pollIgnoreErrors = false;
+
+    const transaction = (await pollUntil(
+      () => {
+        return this.getTransaction(transactionId);
+      },
+      (current, response) => {
+        if (
+          current &&
+          [
+            TransactionStatus.SUCCESS,
+            TransactionStatus.CANCELLED,
+            TransactionStatus.FAILED,
+          ].includes(current.status)
+        ) {
+          return {
+            stopPolling: true,
+            value: current,
+          };
+        }
+        return response;
+      },
+      pollIntervalMs,
+      pollMaxTimeouts,
+      pollIgnoreErrors,
+      () =>
+        new LightsparkException(
+          "Timeout",
+          "Timeout waiting for transaction to complete.",
+        ),
+    )) as Transaction;
+
+    return transaction;
+  }
+
   /**
    * Sends a payment directly to a node on the Lightning Network through the public key of the node without an invoice.
    *

package/src/graphql/FundNode.ts

@@ -5,9 +5,9 @@ import { FRAGMENT as CurrencyAmountFragment } from "../objects/CurrencyAmount.js
 export const FundNode = `
     mutation FundNode(
         $node_id: ID!,
-        $amountSats: Long
+        $amount_sats: Long
     ) {
-        fund_node(input: { node_id: $node_id, amount_sats: $amountSats }) {
+        fund_node(input: { node_id: $node_id, amount_sats: $amount_sats }) {
             amount {
                 ...CurrencyAmountFragment
             }

package/src/logger.ts

@@ -0,0 +1,3 @@
+import { Logger } from "@lightsparkdev/core";
+
+export const logger = new Logger("@lightsparkdev/lightspark-sdk");

package/src/tests/integration/client.test.ts

@@ -1,10 +1,33 @@
+import { pollUntil } from "@lightsparkdev/core";
 import LightsparkClient from "../../client.js";
 import { getCredentialsFromEnvOrThrow } from "../../env.js";
 import {
   AccountTokenAuthProvider,
   BitcoinNetwork,
   PaymentRequestStatus,
+  TransactionStatus,
 } from "../../index.js";
+import { logger } from "../../logger.js";
+
+const REGTEST_SIGNING_KEY_PASSWORD = "1234!@#$";
+const pollIntervalMs = 250;
+const pollTimeoutSecs = 20;
+const pollMaxTimeouts = (pollTimeoutSecs * 1000) / pollIntervalMs;
+const pollIgnoreErrors = false;
+
+const suiteName = "lightspark-sdk client";
+
+function log(msg: string, ...args: unknown[]) {
+  logger.info(
+    `${expect
+      .getState()
+      .currentTestName?.replace(
+        new RegExp(`^(${suiteName})\\s`, "g"),
+        "",
+      )}: ${msg}`,
+    ...args,
+  );
+}
 
 describe("lightspark-sdk client", () => {
   const { apiTokenClientId, apiTokenClientSecret, baseUrl } =
@@ -23,12 +46,12 @@ describe("lightspark-sdk client", () => {
     return regtestNodeId as string;
   }
 
-  it("should get env vars and construct the client successfully", async () => {
+  it("Should get env vars and construct the client successfully", async () => {
     const lightsparkClient = new LightsparkClient(accountAuthProvider, baseUrl);
     expect(lightsparkClient).toBeDefined();
   });
 
-  it("should successfully get the current account regtest node", async () => {
+  it("Should successfully get the current account regtest node", async () => {
     const lightsparkClient = new LightsparkClient(accountAuthProvider, baseUrl);
 
     const account = await lightsparkClient.getCurrentAccount();
@@ -38,10 +61,11 @@ describe("lightspark-sdk client", () => {
 
     const regtestNode = nodesConnection?.entities[0];
     expect(regtestNode).toBeDefined();
+    log("regtestNodeId", regtestNode?.id);
     regtestNodeId = regtestNode?.id;
   });
 
-  it("should successfully create an uma invoice", async () => {
+  it("Should successfully create an uma invoice", async () => {
     const nodeId = getRegtestNodeId();
     const lightsparkClient = new LightsparkClient(accountAuthProvider, baseUrl);
 
@@ -56,5 +80,89 @@ describe("lightspark-sdk client", () => {
       metadata,
     );
     expect(umaInvoice?.status).toEqual(PaymentRequestStatus.OPEN);
-  });
+  }, 10000);
+
+  const satsToFund = 50_000;
+  test("Should deposit funds to wallet with a defined amount of sats", async () => {
+    const lightsparkClient = new LightsparkClient(accountAuthProvider, baseUrl);
+    const account = await lightsparkClient.getCurrentAccount();
+
+    if (!account) {
+      throw new Error("No account");
+    }
+
+    const nodesConnection = await account?.getNodes(lightsparkClient, 1, [
+      BitcoinNetwork.REGTEST,
+    ]);
+    let regtestNode = nodesConnection?.entities[0];
+    const initialLocalBalance = regtestNode?.localBalance?.originalValue;
+    const nodeId = getRegtestNodeId();
+
+    await lightsparkClient.fundNode(nodeId, satsToFund);
+
+    regtestNode = await pollUntil(
+      () => {
+        return account?.getNodes(lightsparkClient, 1, [BitcoinNetwork.REGTEST]);
+      },
+      (current, response) => {
+        if (
+          current &&
+          current.entities[0]?.localBalance?.originalValue !==
+            initialLocalBalance
+        ) {
+          return {
+            stopPolling: true,
+            value: current.entities[0],
+          };
+        }
+        return response;
+      },
+      pollIntervalMs,
+      pollMaxTimeouts,
+      pollIgnoreErrors,
+      () => new Error("Timeout waiting for payment to be received"),
+    );
+
+    expect(
+      regtestNode.localBalance?.originalValue !== initialLocalBalance,
+    ).toBe(true);
+  }, 120_000);
+
+  test("Should send test mode payment", async () => {
+    const lightsparkClient = new LightsparkClient(accountAuthProvider, baseUrl);
+    const account = await lightsparkClient.getCurrentAccount();
+
+    if (!account) {
+      throw new Error("No account");
+    }
+
+    const nodeId = getRegtestNodeId();
+
+    const invoice = await lightsparkClient.createTestModeInvoice(
+      nodeId,
+      satsToFund * 1000, // convert to msats
+    );
+
+    await lightsparkClient.loadNodeSigningKey(nodeId, {
+      password: REGTEST_SIGNING_KEY_PASSWORD,
+    });
+
+    if (!invoice) {
+      throw new Error("No invoice");
+    }
+
+    const payment = await lightsparkClient.payInvoice(nodeId, invoice, 60);
+    log("payment.id", payment?.id);
+
+    if (!payment) {
+      throw new Error("No payment");
+    }
+
+    const transaction = await lightsparkClient.waitForTransactionComplete(
+      payment.id,
+      pollTimeoutSecs,
+    );
+
+    expect(transaction.status).toEqual(TransactionStatus.SUCCESS);
+  }, 30_000);
 });