@lightsparkdev/lightspark-sdk 0.2.8 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AuthProvider } from '@lightsparkdev/core';
-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, W as IncomingPaymentAttemptStatus, X as IncomingPaymentToAttemptsConnection, Y as Invoice, _ as InvoiceData, $ as InvoiceType, a0 as LightningFeeEstimateForInvoiceInput, a1 as LightningFeeEstimateForNodeInput, a2 as LightningFeeEstimateOutput, a3 as LightningTransaction, L as LightsparkClient, a5 as LightsparkNode, a6 as LightsparkNodePurpose, a7 as LightsparkNodeStatus, a8 as LightsparkNodeToChannelsConnection, a9 as Node, aa as NodeAddress, ab as NodeAddressType, ac as NodeToAddressesConnection, ad as OnChainTransaction, af as OutgoingPayment, ag as OutgoingPaymentAttempt, ah as OutgoingPaymentAttemptStatus, ai as OutgoingPaymentAttemptToHopsConnection, aj as OutgoingPaymentToAttemptsConnection, ak as PageInfo, al as PayInvoiceInput, am as PayInvoiceOutput, an as PaymentFailureReason, ao as PaymentRequest, aq as PaymentRequestData, ar as PaymentRequestStatus, as as Permission, at as RequestWithdrawalInput, au as RequestWithdrawalOutput, av as RichText, aw as RoutingTransaction, ay as RoutingTransactionFailureReason, az as Secret, aA as SendPaymentInput, aB as SendPaymentOutput, aC as SingleNodeDashboard, aD as Transaction, aF as TransactionFailures, aG as TransactionStatus, aH as TransactionType, aI as TransactionUpdate, aJ as Wallet, aK 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, Z as getInvoiceQuery, a4 as getLightningTransactionQuery, ae as getOnChainTransactionQuery, ap as getPaymentRequestQuery, ax as getRoutingTransactionQuery, aE as getTransactionQuery, aM as getWithdrawalQuery } from './Withdrawal-82dbbfd6.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 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, W as IncomingPaymentAttemptStatus, X as IncomingPaymentToAttemptsConnection, Y as Invoice, _ as InvoiceData, $ as InvoiceType, a0 as LightningFeeEstimateForInvoiceInput, a1 as LightningFeeEstimateForNodeInput, a2 as LightningFeeEstimateOutput, a3 as LightningTransaction, L as LightsparkClient, a5 as LightsparkNode, a6 as LightsparkNodePurpose, a7 as LightsparkNodeStatus, a8 as LightsparkNodeToChannelsConnection, a9 as Node, aa as NodeAddress, ab as NodeAddressType, ac as NodeToAddressesConnection, ad as OnChainTransaction, af as OutgoingPayment, ag as OutgoingPaymentAttempt, ah as OutgoingPaymentAttemptStatus, ai as OutgoingPaymentAttemptToHopsConnection, aj as OutgoingPaymentToAttemptsConnection, ak as PageInfo, al as PayInvoiceInput, am as PayInvoiceOutput, an as PaymentFailureReason, ao as PaymentRequest, aq as PaymentRequestData, ar as PaymentRequestStatus, as as Permission, at as RequestWithdrawalInput, au as RequestWithdrawalOutput, av as RichText, aw as RoutingTransaction, ay as RoutingTransactionFailureReason, az as Secret, aA as SendPaymentInput, aB as SendPaymentOutput, aC as SingleNodeDashboard, aD as Transaction, aF as TransactionFailures, aG as TransactionStatus, aH as TransactionType, aI as TransactionUpdate, aJ as Wallet, aK 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, Z as getInvoiceQuery, a4 as getLightningTransactionQuery, ae as getOnChainTransactionQuery, ap as getPaymentRequestQuery, ax as getRoutingTransactionQuery, aE as getTransactionQuery, aM as getWithdrawalQuery } from './Withdrawal-e4b8b697.js';
 import 'zen-observable';
 
 declare class AccountTokenAuthProvider implements AuthProvider {

package/dist/index.js

@@ -60,14 +60,14 @@ import {
   getRoutingTransactionQuery,
   getTransactionQuery,
   getWithdrawalQuery
-} from "./chunk-2T6E6TXJ.js";
+} from "./chunk-7GDCZ2RB.js";
 
 // package.json
 var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@lightsparkdev/lightspark-sdk",
-      version: "0.2.8",
+      version: "0.3.0",
       description: "Lightspark JS SDK",
       author: "Lightspark Inc.",
       keywords: [
@@ -135,7 +135,7 @@ var require_package = __commonJS({
       },
       license: "Apache-2.0",
       dependencies: {
-        "@lightsparkdev/core": "0.2.5",
+        "@lightsparkdev/core": "0.3.0",
         "auto-bind": "^5.0.1",
         crypto: "^1.0.1",
         "crypto-browserify": "^3.12.0",
@@ -192,13 +192,14 @@ var AccountTokenAuthProvider = class {
 var AccountTokenAuthProvider_default = AccountTokenAuthProvider;
 
 // src/client.ts
-import { LightsparkSigningException } from "@lightsparkdev/core";
 import autoBind2 from "auto-bind";
 import {
   b64encode as b64encode2,
   DefaultCrypto,
+  KeyOrAlias,
   LightsparkAuthException,
   LightsparkException,
+  LightsparkSigningException,
   NodeKeyCache,
   Requester,
   StubAuthProvider
@@ -266,6 +267,46 @@ var CreateNodeWalletAddress = `
   }
 `;
 
+// src/graphql/CreateTestModeInvoice.ts
+var CreateTestModeInvoice = `
+mutation CreateTestModeInvoice(
+  $local_node_id: ID!
+  $amount_msats: Long!
+  $memo: String
+  $invoice_type: InvoiceType
+) {
+  create_test_mode_invoice(input: {
+      local_node_id: $local_node_id
+      amount_msats: $amount_msats
+      memo: $memo
+      invoice_type: $invoice_type
+  }) {
+      encoded_payment_request
+  }
+}
+`;
+
+// src/graphql/CreateTestModePayment.ts
+var CreateTestModePayment = `
+mutation CreateTestModePayment(
+  $local_node_id: ID!
+  $encoded_invoice: String!
+  $amount_msats: Long
+) {
+  create_test_mode_payment(input: {
+      local_node_id: $local_node_id
+      encoded_invoice: $encoded_invoice
+      amount_msats: $amount_msats
+  }) {
+      payment {
+          ...OutgoingPaymentFragment
+      }
+  }
+}
+
+${FRAGMENT4}
+`;
+
 // src/graphql/DecodeInvoice.ts
 var DecodeInvoice = `
   query DecodeInvoice($encoded_payment_request: String!) {
@@ -277,7 +318,7 @@ var DecodeInvoice = `
     }
   }
 
-  ${FRAGMENT4}
+  ${FRAGMENT5}
 `;
 
 // src/graphql/DeleteApiToken.ts
@@ -325,7 +366,7 @@ var LightningFeeEstimateForInvoice = `
     }
   }
 
-  ${FRAGMENT5}
+  ${FRAGMENT6}
 `;
 
 // src/graphql/LightningFeeEstimateForNode.ts
@@ -344,7 +385,7 @@ var LightningFeeEstimateForNode = `
     }
   }
 
-  ${FRAGMENT5}
+  ${FRAGMENT6}
 `;
 
 // src/graphql/MultiNodeDashboard.ts
@@ -447,7 +488,7 @@ var PayInvoice = `
     }
   }
 
-  ${FRAGMENT6}
+  ${FRAGMENT4}
 `;
 
 // src/graphql/RecoverNodeSigningKey.ts
@@ -512,7 +553,7 @@ var SendPayment = `
     }
   }
 
-  ${FRAGMENT6}
+  ${FRAGMENT4}
 `;
 
 // src/graphql/SingleNodeDashboard.ts
@@ -689,8 +730,8 @@ var LightsparkClient = class {
    * @param authProvider The auth provider to use for authentication. Defaults to a stub auth provider. For server-side
    *     use, you should use the `AccountTokenAuthProvider`.
    * @param serverUrl The base URL of the server to connect to. Defaults to lightspark production.
-   * @param nodeKeyCache This is used to cache node keys for the duration of the session. Defaults to a new instance of
-   *     `NodeKeyCache`. You should not need to change this.
+   * @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`.
    */
   constructor(authProvider = new StubAuthProvider(), serverUrl = "api.lightspark.com", cryptoImpl = DefaultCrypto) {
     this.authProvider = authProvider;
@@ -919,6 +960,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].
+   *
    * @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 memo A string memo to include in the invoice as a description.
@@ -1036,7 +1079,10 @@ var LightsparkClient = class {
       const dec = new TextDecoder();
       signingPrivateKeyPEM = dec.decode(signingPrivateKey);
     }
-    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyPEM);
+    await this.nodeKeyCache.loadKey(
+      nodeId,
+      KeyOrAlias.key(signingPrivateKeyPEM)
+    );
     return true;
   }
   async recoverNodeSigningKey(nodeId) {
@@ -1051,17 +1097,20 @@ var LightsparkClient = class {
     return null;
   }
   /**
-   * Directly unlocks a node with a signing private key.
+   * Directly unlocks a node with a signing private key or alias.
    *
    * @param nodeId The ID of the node to unlock.
    * @param signingPrivateKeyPEM The PEM-encoded signing private key.
    */
-  async loadNodeKey(nodeId, signingPrivateKeyPEM) {
-    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyPEM);
+  async loadNodeKey(nodeId, signingPrivateKeyOrAlias) {
+    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyOrAlias);
   }
   /**
    * 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.
+   *
    * @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.
@@ -1226,6 +1275,60 @@ var LightsparkClient = class {
   async deleteApiToken(id) {
     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].
+   *
+   * @param localNodeId The ID of the node that will pay the invoice.
+   * @param amountMsats The amount to pay in milli-satoshis.
+   * @param memo An optional memo to attach to the invoice.
+   * @param invoiceType The type of invoice to create.
+   */
+  async createTestModeInvoice(localNodeId, amountMsats, memo = void 0, invoiceType = InvoiceType_default.STANDARD) {
+    return await this.executeRawQuery({
+      queryPayload: CreateTestModeInvoice,
+      variables: {
+        local_node_id: localNodeId,
+        amount_msats: amountMsats,
+        memo,
+        invoice_type: invoiceType
+      },
+      constructObject: (responseJson) => {
+        const encodedPaymentRequest = responseJson.create_test_mode_invoice?.encoded_payment_request;
+        if (!encodedPaymentRequest) {
+          throw new LightsparkException(
+            "CreateTestModeInvoiceError",
+            "Unable to create test mode invoice"
+          );
+        }
+        return encodedPaymentRequest;
+      }
+    });
+  }
+  /**
+   * 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.
+   * @param amountMsats The amount to pay in milli-satoshis for 0-amount invoices. This should be null for non-zero
+   *     amount invoices.
+   */
+  async createTestModePayment(localNodeId, encodedInvoice, amountMsats = void 0) {
+    return await this.executeRawQuery({
+      queryPayload: CreateTestModePayment,
+      variables: {
+        local_node_id: localNodeId,
+        encoded_invoice: encodedInvoice,
+        amount_msats: amountMsats
+      },
+      constructObject: (responseJson) => {
+        return OutgoingPaymentFromJson(
+          responseJson.create_test_mode_payment?.payment
+        );
+      }
+    });
+  }
   /**
    * Executes a raw `Query` against the Lightspark API.
    *

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, W as IncomingPaymentAttemptStatus, X as IncomingPaymentToAttemptsConnection, Y as Invoice, _ as InvoiceData, $ as InvoiceType, a0 as LightningFeeEstimateForInvoiceInput, a1 as LightningFeeEstimateForNodeInput, a2 as LightningFeeEstimateOutput, a3 as LightningTransaction, a5 as LightsparkNode, a6 as LightsparkNodePurpose, a7 as LightsparkNodeStatus, a8 as LightsparkNodeToChannelsConnection, a9 as Node, aa as NodeAddress, ab as NodeAddressType, ac as NodeToAddressesConnection, ad as OnChainTransaction, af as OutgoingPayment, ag as OutgoingPaymentAttempt, ah as OutgoingPaymentAttemptStatus, ai as OutgoingPaymentAttemptToHopsConnection, aj as OutgoingPaymentToAttemptsConnection, ak as PageInfo, al as PayInvoiceInput, am as PayInvoiceOutput, an as PaymentFailureReason, ao as PaymentRequest, aq as PaymentRequestData, ar as PaymentRequestStatus, as as Permission, at as RequestWithdrawalInput, au as RequestWithdrawalOutput, av as RichText, aw as RoutingTransaction, ay as RoutingTransactionFailureReason, az as Secret, aA as SendPaymentInput, aB as SendPaymentOutput, aC as SingleNodeDashboard, aD as Transaction, aF as TransactionFailures, aG as TransactionStatus, aH as TransactionType, aI as TransactionUpdate, aJ as Wallet, aK 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, Z as getInvoiceQuery, a4 as getLightningTransactionQuery, ae as getOnChainTransactionQuery, ap as getPaymentRequestQuery, ax as getRoutingTransactionQuery, aE as getTransactionQuery, aM as getWithdrawalQuery } from '../Withdrawal-82dbbfd6.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 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, W as IncomingPaymentAttemptStatus, X as IncomingPaymentToAttemptsConnection, Y as Invoice, _ as InvoiceData, $ as InvoiceType, a0 as LightningFeeEstimateForInvoiceInput, a1 as LightningFeeEstimateForNodeInput, a2 as LightningFeeEstimateOutput, a3 as LightningTransaction, a5 as LightsparkNode, a6 as LightsparkNodePurpose, a7 as LightsparkNodeStatus, a8 as LightsparkNodeToChannelsConnection, a9 as Node, aa as NodeAddress, ab as NodeAddressType, ac as NodeToAddressesConnection, ad as OnChainTransaction, af as OutgoingPayment, ag as OutgoingPaymentAttempt, ah as OutgoingPaymentAttemptStatus, ai as OutgoingPaymentAttemptToHopsConnection, aj as OutgoingPaymentToAttemptsConnection, ak as PageInfo, al as PayInvoiceInput, am as PayInvoiceOutput, an as PaymentFailureReason, ao as PaymentRequest, aq as PaymentRequestData, ar as PaymentRequestStatus, as as Permission, at as RequestWithdrawalInput, au as RequestWithdrawalOutput, av as RichText, aw as RoutingTransaction, ay as RoutingTransactionFailureReason, az as Secret, aA as SendPaymentInput, aB as SendPaymentOutput, aC as SingleNodeDashboard, aD as Transaction, aF as TransactionFailures, aG as TransactionStatus, aH as TransactionType, aI as TransactionUpdate, aJ as Wallet, aK 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, Z as getInvoiceQuery, a4 as getLightningTransactionQuery, ae as getOnChainTransactionQuery, ap as getPaymentRequestQuery, ax as getRoutingTransactionQuery, aE as getTransactionQuery, aM as getWithdrawalQuery } from '../Withdrawal-e4b8b697.js';
 import '@lightsparkdev/core';
 import 'zen-observable';

package/dist/objects/index.js

@@ -42,7 +42,7 @@ import {
   getRoutingTransactionQuery,
   getTransactionQuery,
   getWithdrawalQuery
-} from "../chunk-2T6E6TXJ.js";
+} from "../chunk-7GDCZ2RB.js";
 export {
   Account_default as Account,
   AccountToChannelsConnection_default as AccountToChannelsConnection,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [
@@ -68,7 +68,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@lightsparkdev/core": "0.2.5",
+    "@lightsparkdev/core": "0.3.0",
     "auto-bind": "^5.0.1",
     "crypto": "^1.0.1",
     "crypto-browserify": "^3.12.0",

package/src/client.ts

@@ -1,6 +1,5 @@
 // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
 
-import { LightsparkSigningException, Query } from "@lightsparkdev/core";
 import autoBind from "auto-bind";
 import Observable from "zen-observable";
 
@@ -9,10 +8,14 @@ import {
   b64encode,
   CryptoInterface,
   DefaultCrypto,
+  KeyOrAlias,
+  KeyOrAliasType,
   LightsparkAuthException,
   LightsparkException,
+  LightsparkSigningException,
   Maybe,
   NodeKeyCache,
+  Query,
   Requester,
   StubAuthProvider,
 } from "@lightsparkdev/core";
@@ -20,6 +23,8 @@ import { BitcoinFeeEstimate as BitcoinFeeEstimateQuery } from "./graphql/Bitcoin
 import { CreateApiToken } from "./graphql/CreateApiToken.js";
 import { CreateInvoice } from "./graphql/CreateInvoice.js";
 import { CreateNodeWalletAddress } from "./graphql/CreateNodeWalletAddress.js";
+import { CreateTestModeInvoice } from "./graphql/CreateTestModeInvoice.js";
+import { CreateTestModePayment } from "./graphql/CreateTestModePayment.js";
 import { DecodeInvoice } from "./graphql/DecodeInvoice.js";
 import { DeleteApiToken } from "./graphql/DeleteApiToken.js";
 import { FundNode } from "./graphql/FundNode.js";
@@ -77,7 +82,7 @@ import WithdrawalRequest, {
  * const invoiceDetails = await lightsparkClient.decodeInvoice(encodedInvoice);
  * console.log(invoiceDetails);
  *
- * const payment = await lightsparkClient.payInvoice(PAYING_NODE_ID, encodedInvoice, 1000);
+ * const payment = await lightsparkClient.payInvoice(PAYING_NODE_ID, encodedInvoice, 100000);
  * console.log(payment);
  * ```
  *
@@ -93,8 +98,8 @@ class LightsparkClient {
    * @param authProvider The auth provider to use for authentication. Defaults to a stub auth provider. For server-side
    *     use, you should use the `AccountTokenAuthProvider`.
    * @param serverUrl The base URL of the server to connect to. Defaults to lightspark production.
-   * @param nodeKeyCache This is used to cache node keys for the duration of the session. Defaults to a new instance of
-   *     `NodeKeyCache`. You should not need to change this.
+   * @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`.
    */
   constructor(
     private authProvider: AuthProvider = new StubAuthProvider(),
@@ -375,6 +380,8 @@ class LightsparkClient {
   /**
    * Creates an invoice for the given node.
    *
+   * 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 memo A string memo to include in the invoice as a description.
@@ -518,7 +525,10 @@ class LightsparkClient {
       signingPrivateKeyPEM = dec.decode(signingPrivateKey);
     }
 
-    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyPEM);
+    await this.nodeKeyCache.loadKey(
+      nodeId,
+      KeyOrAlias.key(signingPrivateKeyPEM)
+    );
     return true;
   }
 
@@ -537,18 +547,24 @@ class LightsparkClient {
   }
 
   /**
-   * Directly unlocks a node with a signing private key.
+   * Directly unlocks a node with a signing private key or alias.
    *
    * @param nodeId The ID of the node to unlock.
    * @param signingPrivateKeyPEM The PEM-encoded signing private key.
    */
-  public async loadNodeKey(nodeId: string, signingPrivateKeyPEM: string) {
-    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyPEM);
+  public async loadNodeKey(
+    nodeId: string,
+    signingPrivateKeyOrAlias: KeyOrAliasType
+  ) {
+    await this.nodeKeyCache.loadKey(nodeId, signingPrivateKeyOrAlias);
   }
 
   /**
    * 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.
+   *
    * @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.
@@ -751,6 +767,72 @@ class LightsparkClient {
     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].
+   *
+   * @param localNodeId The ID of the node that will pay the invoice.
+   * @param amountMsats The amount to pay in milli-satoshis.
+   * @param memo An optional memo to attach to the invoice.
+   * @param invoiceType The type of invoice to create.
+   */
+  public async createTestModeInvoice(
+    localNodeId: string,
+    amountMsats: number,
+    memo: string | undefined = undefined,
+    invoiceType: InvoiceType = InvoiceType.STANDARD
+  ): Promise<string | null> {
+    return await this.executeRawQuery({
+      queryPayload: CreateTestModeInvoice,
+      variables: {
+        local_node_id: localNodeId,
+        amount_msats: amountMsats,
+        memo,
+        invoice_type: invoiceType,
+      },
+      constructObject: (responseJson: any) => {
+        const encodedPaymentRequest =
+          responseJson.create_test_mode_invoice?.encoded_payment_request;
+        if (!encodedPaymentRequest) {
+          throw new LightsparkException(
+            "CreateTestModeInvoiceError",
+            "Unable to create test mode invoice"
+          );
+        }
+        return encodedPaymentRequest as string;
+      },
+    });
+  }
+
+  /**
+   * 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.
+   * @param amountMsats The amount to pay in milli-satoshis for 0-amount invoices. This should be null for non-zero
+   *     amount invoices.
+   */
+  public async createTestModePayment(
+    localNodeId: string,
+    encodedInvoice: string,
+    amountMsats: number | undefined = undefined
+  ): Promise<OutgoingPayment | null> {
+    return await this.executeRawQuery({
+      queryPayload: CreateTestModePayment,
+      variables: {
+        local_node_id: localNodeId,
+        encoded_invoice: encodedInvoice,
+        amount_msats: amountMsats,
+      },
+      constructObject: (responseJson: any) => {
+        return OutgoingPaymentFromJson(
+          responseJson.create_test_mode_payment?.payment
+        );
+      },
+    });
+  }
+
   /**
    * Executes a raw `Query` against the Lightspark API.
    *

package/src/graphql/CreateTestModeInvoice.ts

@@ -0,0 +1,19 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+export const CreateTestModeInvoice = `
+mutation CreateTestModeInvoice(
+  $local_node_id: ID!
+  $amount_msats: Long!
+  $memo: String
+  $invoice_type: InvoiceType
+) {
+  create_test_mode_invoice(input: {
+      local_node_id: $local_node_id
+      amount_msats: $amount_msats
+      memo: $memo
+      invoice_type: $invoice_type
+  }) {
+      encoded_payment_request
+  }
+}
+`;

package/src/graphql/CreateTestModePayment.ts

@@ -0,0 +1,23 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+import { FRAGMENT as OutgoingPaymentFragment } from "../objects/OutgoingPayment.js";
+
+export const CreateTestModePayment = `
+mutation CreateTestModePayment(
+  $local_node_id: ID!
+  $encoded_invoice: String!
+  $amount_msats: Long
+) {
+  create_test_mode_payment(input: {
+      local_node_id: $local_node_id
+      encoded_invoice: $encoded_invoice
+      amount_msats: $amount_msats
+  }) {
+      payment {
+          ...OutgoingPaymentFragment
+      }
+  }
+}
+
+${OutgoingPaymentFragment}
+`;