@lightsparkdev/lightspark-sdk 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @lightsparkdev/lightspark-sdk
 
+## 1.0.1
+
+### Patch Changes
+
+- 808c77a: Consolidate some imports to lightspark-sdk and core
+- Updated dependencies [808c77a]
+  - @lightsparkdev/core@1.0.1
+
 ## 1.0.0
 
 ### Major Changes

package/dist/BitcoinNetwork-a816c0be.d.ts

@@ -0,0 +1,18 @@
+/** This is an enum identifying a particular Bitcoin Network. **/
+declare enum BitcoinNetwork {
+    /**
+     * 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 production version of the Bitcoin Blockchain. **/
+    MAINNET = "MAINNET",
+    /** A test version of the Bitcoin Blockchain, maintained by Lightspark. **/
+    REGTEST = "REGTEST",
+    /** A test version of the Bitcoin Blockchain, maintained by a centralized organization. Not in use at Lightspark. **/
+    SIGNET = "SIGNET",
+    /** A test version of the Bitcoin Blockchain, publicly available. **/
+    TESTNET = "TESTNET"
+}
+
+export { BitcoinNetwork as B };

package/dist/chunk-5RDIWPBE.js

@@ -0,0 +1,27 @@
+// src/helpers.ts
+var BITCOIN_NETWORKS = [
+  "MAINNET" /* MAINNET */,
+  "TESTNET" /* TESTNET */,
+  "SIGNET" /* SIGNET */,
+  "REGTEST" /* REGTEST */
+];
+var isBitcoinNetwork = (bitcoinNetwork) => {
+  return BITCOIN_NETWORKS.includes(bitcoinNetwork);
+};
+var assertValidBitcoinNetwork = (bitcoinNetwork) => {
+  if (!isBitcoinNetwork(bitcoinNetwork)) {
+    throw new Error(
+      `Invalid bitcoin network ${bitcoinNetwork}. Valid networks: ${BITCOIN_NETWORKS}`
+    );
+  }
+};
+var getBitcoinNetworkOrThrow = (bitcoinNetwork) => {
+  assertValidBitcoinNetwork(bitcoinNetwork.toUpperCase());
+  return bitcoinNetwork;
+};
+
+export {
+  isBitcoinNetwork,
+  assertValidBitcoinNetwork,
+  getBitcoinNetworkOrThrow
+};

package/dist/{chunk-LZC5C5NI.js → chunk-K2ZU5YQL.js}

@@ -1,3 +1,7 @@
+import {
+  BitcoinNetwork_default
+} from "./chunk-K6SAUSAX.js";
+
 // src/objects/Account.ts
 import autoBind12 from "auto-bind";
 
@@ -420,17 +424,6 @@ var AccountToChannelsConnection_default = AccountToChannelsConnection;
 import { LightsparkException } from "@lightsparkdev/core";
 import autoBind5 from "auto-bind";
 
-// src/objects/BitcoinNetwork.ts
-var BitcoinNetwork = /* @__PURE__ */ ((BitcoinNetwork2) => {
-  BitcoinNetwork2["FUTURE_VALUE"] = "FUTURE_VALUE";
-  BitcoinNetwork2["MAINNET"] = "MAINNET";
-  BitcoinNetwork2["REGTEST"] = "REGTEST";
-  BitcoinNetwork2["SIGNET"] = "SIGNET";
-  BitcoinNetwork2["TESTNET"] = "TESTNET";
-  return BitcoinNetwork2;
-})(BitcoinNetwork || {});
-var BitcoinNetwork_default = BitcoinNetwork;
-
 // src/objects/BlockchainBalance.ts
 var BlockchainBalanceFromJson = (obj) => {
   return {
@@ -8816,7 +8809,6 @@ export {
   ApiTokenFromJson,
   FRAGMENT as FRAGMENT3,
   getApiTokenQuery,
-  BitcoinNetwork_default,
   NodeAddressType_default,
   GraphNode_default,
   LightsparkNodeStatus_default,

package/dist/chunk-K6SAUSAX.js

@@ -0,0 +1,14 @@
+// src/objects/BitcoinNetwork.ts
+var BitcoinNetwork = /* @__PURE__ */ ((BitcoinNetwork2) => {
+  BitcoinNetwork2["FUTURE_VALUE"] = "FUTURE_VALUE";
+  BitcoinNetwork2["MAINNET"] = "MAINNET";
+  BitcoinNetwork2["REGTEST"] = "REGTEST";
+  BitcoinNetwork2["SIGNET"] = "SIGNET";
+  BitcoinNetwork2["TESTNET"] = "TESTNET";
+  return BitcoinNetwork2;
+})(BitcoinNetwork || {});
+var BitcoinNetwork_default = BitcoinNetwork;
+
+export {
+  BitcoinNetwork_default
+};

package/dist/env.cjs

@@ -0,0 +1,101 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/env.ts
+var env_exports = {};
+__export(env_exports, {
+  RequiredCredentials: () => RequiredCredentials,
+  getCredentialsFromEnvOrThrow: () => getCredentialsFromEnvOrThrow
+});
+module.exports = __toCommonJS(env_exports);
+var import_dotenv = __toESM(require("dotenv"), 1);
+
+// src/helpers.ts
+var BITCOIN_NETWORKS = [
+  "MAINNET" /* MAINNET */,
+  "TESTNET" /* TESTNET */,
+  "SIGNET" /* SIGNET */,
+  "REGTEST" /* REGTEST */
+];
+var isBitcoinNetwork = (bitcoinNetwork) => {
+  return BITCOIN_NETWORKS.includes(bitcoinNetwork);
+};
+var assertValidBitcoinNetwork = (bitcoinNetwork) => {
+  if (!isBitcoinNetwork(bitcoinNetwork)) {
+    throw new Error(
+      `Invalid bitcoin network ${bitcoinNetwork}. Valid networks: ${BITCOIN_NETWORKS}`
+    );
+  }
+};
+var getBitcoinNetworkOrThrow = (bitcoinNetwork) => {
+  assertValidBitcoinNetwork(bitcoinNetwork.toUpperCase());
+  return bitcoinNetwork;
+};
+
+// src/env.ts
+var RequiredCredentials = /* @__PURE__ */ ((RequiredCredentials2) => {
+  RequiredCredentials2["ClientId"] = "LIGHTSPARK_API_TOKEN_CLIENT_ID";
+  RequiredCredentials2["ClientSecret"] = "LIGHTSPARK_API_TOKEN_CLIENT_SECRET";
+  RequiredCredentials2["BitcoinNetwork"] = "BITCOIN_NETWORK";
+  return RequiredCredentials2;
+})(RequiredCredentials || {});
+var getCredentialsFromEnvOrThrow = () => {
+  const env = import_dotenv.default.config({
+    path: process.env.HOME + "/.lightsparkapienv"
+  }).parsed || {};
+  const missingTestCredentials = Object.values(RequiredCredentials).filter(
+    (cred) => !env[cred]
+  );
+  if (missingTestCredentials.length) {
+    throw new Error(
+      `Missing test credentials. Please set ${missingTestCredentials.join(
+        ", "
+      )} environment variables.`
+    );
+  }
+  const apiTokenClientId = env["LIGHTSPARK_API_TOKEN_CLIENT_ID" /* ClientId */];
+  const apiTokenClientSecret = env["LIGHTSPARK_API_TOKEN_CLIENT_SECRET" /* ClientSecret */];
+  const bitcoinNetwork = getBitcoinNetworkOrThrow(
+    env["BITCOIN_NETWORK" /* BitcoinNetwork */]
+  );
+  const testNodePassword = "1234!@#$";
+  const baseUrl = env["LIGHTSPARK_BASE_URL"] || "api.lightspark.com";
+  return {
+    apiTokenClientId,
+    apiTokenClientSecret,
+    bitcoinNetwork,
+    testNodePassword,
+    baseUrl
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RequiredCredentials,
+  getCredentialsFromEnvOrThrow
+});

package/dist/env.d.ts

@@ -0,0 +1,17 @@
+import { B as BitcoinNetwork } from './BitcoinNetwork-a816c0be.js';
+
+type EnvCredentials = {
+    apiTokenClientId: string;
+    apiTokenClientSecret: string;
+    bitcoinNetwork: BitcoinNetwork;
+    testNodePassword: string;
+    baseUrl: string;
+};
+declare enum RequiredCredentials {
+    ClientId = "LIGHTSPARK_API_TOKEN_CLIENT_ID",
+    ClientSecret = "LIGHTSPARK_API_TOKEN_CLIENT_SECRET",
+    BitcoinNetwork = "BITCOIN_NETWORK"
+}
+declare const getCredentialsFromEnvOrThrow: () => EnvCredentials;
+
+export { EnvCredentials, RequiredCredentials, getCredentialsFromEnvOrThrow };

package/dist/env.js

@@ -0,0 +1,47 @@
+import {
+  getBitcoinNetworkOrThrow
+} from "./chunk-5RDIWPBE.js";
+import "./chunk-K6SAUSAX.js";
+import "./chunk-NIMBE7W3.js";
+
+// src/env.ts
+import dotenv from "dotenv";
+var RequiredCredentials = /* @__PURE__ */ ((RequiredCredentials2) => {
+  RequiredCredentials2["ClientId"] = "LIGHTSPARK_API_TOKEN_CLIENT_ID";
+  RequiredCredentials2["ClientSecret"] = "LIGHTSPARK_API_TOKEN_CLIENT_SECRET";
+  RequiredCredentials2["BitcoinNetwork"] = "BITCOIN_NETWORK";
+  return RequiredCredentials2;
+})(RequiredCredentials || {});
+var getCredentialsFromEnvOrThrow = () => {
+  const env = dotenv.config({
+    path: process.env.HOME + "/.lightsparkapienv"
+  }).parsed || {};
+  const missingTestCredentials = Object.values(RequiredCredentials).filter(
+    (cred) => !env[cred]
+  );
+  if (missingTestCredentials.length) {
+    throw new Error(
+      `Missing test credentials. Please set ${missingTestCredentials.join(
+        ", "
+      )} environment variables.`
+    );
+  }
+  const apiTokenClientId = env["LIGHTSPARK_API_TOKEN_CLIENT_ID" /* ClientId */];
+  const apiTokenClientSecret = env["LIGHTSPARK_API_TOKEN_CLIENT_SECRET" /* ClientSecret */];
+  const bitcoinNetwork = getBitcoinNetworkOrThrow(
+    env["BITCOIN_NETWORK" /* BitcoinNetwork */]
+  );
+  const testNodePassword = "1234!@#$";
+  const baseUrl = env["LIGHTSPARK_BASE_URL"] || "api.lightspark.com";
+  return {
+    apiTokenClientId,
+    apiTokenClientSecret,
+    bitcoinNetwork,
+    testNodePassword,
+    baseUrl
+  };
+};
+export {
+  RequiredCredentials,
+  getCredentialsFromEnvOrThrow
+};

package/dist/{index-09d4ac20.d.ts → index-dbf06298.d.ts}

@@ -1,5 +1,6 @@
 import { Maybe, Query, AuthProvider, CryptoInterface, SigningKey, KeyOrAliasType } from '@lightsparkdev/core';
 import Observable from 'zen-observable';
+import { B as BitcoinNetwork } from './BitcoinNetwork-a816c0be.js';
 
 /** This enum identifies the unit of currency associated with a CurrencyAmount. **/
 declare enum CurrencyUnit {
@@ -321,23 +322,6 @@ declare class AccountToChannelsConnection {
     constructor(count: number, entities: Channel[]);
 }
 
-/** This is an enum identifying a particular Bitcoin Network. **/
-declare enum BitcoinNetwork {
-    /**
-     * 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 production version of the Bitcoin Blockchain. **/
-    MAINNET = "MAINNET",
-    /** A test version of the Bitcoin Blockchain, maintained by Lightspark. **/
-    REGTEST = "REGTEST",
-    /** A test version of the Bitcoin Blockchain, maintained by a centralized organization. Not in use at Lightspark. **/
-    SIGNET = "SIGNET",
-    /** A test version of the Bitcoin Blockchain, publicly available. **/
-    TESTNET = "TESTNET"
-}
-
 /** This is an object representing a detailed breakdown of the balance for a Lightspark Node. **/
 type BlockchainBalance = {
     /** The total wallet balance, including unconfirmed UTXOs. **/
@@ -2309,4 +2293,4 @@ type Withdrawal = OnChainTransaction & Transaction & Entity & {
 };
 declare const getWithdrawalQuery: (id: string) => Query<Withdrawal>;
 
-export { IncomingPayment as $, Account as A, Balances as B, Channel as C, CreateTestModeInvoiceInput as D, CreateTestModeInvoiceOutput as E, CreateTestModePaymentInput as F, CreateTestModePaymentoutput as G, CreateUmaInvoiceInput as H, CurrencyAmount as I, CurrencyUnit as J, DeclineToSignMessagesInput as K, LightsparkClient as L, DeclineToSignMessagesOutput as M, DeleteApiTokenInput as N, DeleteApiTokenOutput as O, Deposit as P, getDepositQuery as Q, Entity as R, FeeEstimate as S, FundNodeInput as T, FundNodeOutput as U, GraphNode as V, WebhookEventType as W, Hop as X, getHopQuery as Y, HtlcAttemptFailureCode as Z, IdAndSignature as _, AccountToApiTokensConnection as a, SendPaymentOutput as a$, IncomingPaymentAttempt as a0, getIncomingPaymentAttemptQuery as a1, IncomingPaymentAttemptStatus as a2, IncomingPaymentToAttemptsConnection as a3, Invoice as a4, getInvoiceQuery as a5, InvoiceData as a6, InvoiceType as a7, LightningFeeEstimateForInvoiceInput as a8, LightningFeeEstimateForNodeInput as a9, PaymentDirection as aA, PaymentFailureReason as aB, PaymentRequest as aC, getPaymentRequestQuery as aD, PaymentRequestData as aE, PaymentRequestStatus as aF, PayUmaInvoiceInput as aG, Permission as aH, PostTransactionData as aI, RegisterPaymentInput as aJ, RegisterPaymentOutput as aK, ReleaseChannelPerCommitmentSecretInput as aL, ReleaseChannelPerCommitmentSecretOutput as aM, ReleasePaymentPreimageInput as aN, ReleasePaymentPreimageOutput as aO, RemoteSigningSubEventType as aP, RequestWithdrawalInput as aQ, RequestWithdrawalOutput as aR, RichText as aS, RiskRating as aT, RoutingTransaction as aU, getRoutingTransactionQuery as aV, RoutingTransactionFailureReason as aW, ScreenNodeInput as aX, ScreenNodeOutput as aY, Secret as aZ, SendPaymentInput as a_, LightningFeeEstimateOutput as aa, LightningTransaction as ab, getLightningTransactionQuery as ac, LightsparkNode as ad, LightsparkNodeOwner as ae, getLightsparkNodeOwnerQuery as af, LightsparkNodeStatus as ag, LightsparkNodeToChannelsConnection as ah, LightsparkNodeWithOSK as ai, LightsparkNodeWithRemoteSigning as aj, Node as ak, NodeAddress as al, NodeAddressType as am, NodeToAddressesConnection as an, OnChainTransaction as ao, getOnChainTransactionQuery as ap, OutgoingPayment as aq, OutgoingPaymentAttempt as ar, OutgoingPaymentAttemptStatus as as, OutgoingPaymentAttemptToHopsConnection as at, OutgoingPaymentsForInvoiceQueryInput as au, OutgoingPaymentsForInvoiceQueryOutput as av, OutgoingPaymentToAttemptsConnection as aw, PageInfo as ax, PayInvoiceInput as ay, PayInvoiceOutput as az, AccountToChannelsConnection as b, SetInvoicePaymentHashInput as b0, SetInvoicePaymentHashOutput as b1, Signable as b2, getSignableQuery as b3, SignablePayload as b4, getSignablePayloadQuery as b5, SignablePayloadStatus as b6, SignInvoiceInput as b7, SignInvoiceOutput as b8, SignMessagesInput as b9, SignMessagesOutput as ba, SingleNodeDashboard as bb, Transaction as bc, getTransactionQuery as bd, TransactionFailures as be, TransactionStatus as bf, TransactionType as bg, TransactionUpdate as bh, UpdateChannelPerCommitmentPointInput as bi, UpdateChannelPerCommitmentPointOutput as bj, UpdateNodeSharedSecretInput as bk, UpdateNodeSharedSecretOutput as bl, Wallet as bm, WalletStatus as bn, WalletToPaymentRequestsConnection as bo, WalletToTransactionsConnection as bp, Withdrawal as bq, getWithdrawalQuery as br, WithdrawalMode as bs, WithdrawalRequest as bt, WithdrawalRequestStatus as bu, WithdrawalRequestToChannelClosingTransactionsConnection as bv, WithdrawalRequestToChannelOpeningTransactionsConnection as bw, AccountToNodesConnection as c, AccountToPaymentRequestsConnection as d, AccountToTransactionsConnection as e, AccountToWalletsConnection as f, ApiToken as g, getApiTokenQuery as h, BitcoinNetwork as i, BlockchainBalance as j, ChannelClosingTransaction as k, getChannelClosingTransactionQuery as l, ChannelFees as m, ChannelOpeningTransaction as n, getChannelOpeningTransactionQuery as o, ChannelStatus as p, ChannelToTransactionsConnection as q, ComplianceProvider as r, Connection as s, CreateApiTokenInput as t, CreateApiTokenOutput as u, CreateInvoiceInput as v, CreateInvoiceOutput as w, CreateLnurlInvoiceInput as x, CreateNodeWalletAddressInput as y, CreateNodeWalletAddressOutput as z };
+export { IncomingPaymentAttempt as $, Account as A, Balances as B, Channel as C, CreateTestModeInvoiceOutput as D, CreateTestModePaymentInput as E, CreateTestModePaymentoutput as F, CreateUmaInvoiceInput as G, CurrencyAmount as H, CurrencyUnit as I, DeclineToSignMessagesInput as J, DeclineToSignMessagesOutput as K, LightsparkClient as L, DeleteApiTokenInput as M, DeleteApiTokenOutput as N, Deposit as O, getDepositQuery as P, Entity as Q, FeeEstimate as R, FundNodeInput as S, FundNodeOutput as T, GraphNode as U, Hop as V, WebhookEventType as W, getHopQuery as X, HtlcAttemptFailureCode as Y, IdAndSignature as Z, IncomingPayment as _, AccountToApiTokensConnection as a, SetInvoicePaymentHashInput as a$, getIncomingPaymentAttemptQuery as a0, IncomingPaymentAttemptStatus as a1, IncomingPaymentToAttemptsConnection as a2, Invoice as a3, getInvoiceQuery as a4, InvoiceData as a5, InvoiceType as a6, LightningFeeEstimateForInvoiceInput as a7, LightningFeeEstimateForNodeInput as a8, LightningFeeEstimateOutput as a9, PaymentFailureReason as aA, PaymentRequest as aB, getPaymentRequestQuery as aC, PaymentRequestData as aD, PaymentRequestStatus as aE, PayUmaInvoiceInput as aF, Permission as aG, PostTransactionData as aH, RegisterPaymentInput as aI, RegisterPaymentOutput as aJ, ReleaseChannelPerCommitmentSecretInput as aK, ReleaseChannelPerCommitmentSecretOutput as aL, ReleasePaymentPreimageInput as aM, ReleasePaymentPreimageOutput as aN, RemoteSigningSubEventType as aO, RequestWithdrawalInput as aP, RequestWithdrawalOutput as aQ, RichText as aR, RiskRating as aS, RoutingTransaction as aT, getRoutingTransactionQuery as aU, RoutingTransactionFailureReason as aV, ScreenNodeInput as aW, ScreenNodeOutput as aX, Secret as aY, SendPaymentInput as aZ, SendPaymentOutput as a_, LightningTransaction as aa, getLightningTransactionQuery as ab, LightsparkNode as ac, LightsparkNodeOwner as ad, getLightsparkNodeOwnerQuery as ae, LightsparkNodeStatus as af, LightsparkNodeToChannelsConnection as ag, LightsparkNodeWithOSK as ah, LightsparkNodeWithRemoteSigning as ai, Node as aj, NodeAddress as ak, NodeAddressType as al, NodeToAddressesConnection as am, OnChainTransaction as an, getOnChainTransactionQuery as ao, OutgoingPayment as ap, OutgoingPaymentAttempt as aq, OutgoingPaymentAttemptStatus as ar, OutgoingPaymentAttemptToHopsConnection as as, OutgoingPaymentsForInvoiceQueryInput as at, OutgoingPaymentsForInvoiceQueryOutput as au, OutgoingPaymentToAttemptsConnection as av, PageInfo as aw, PayInvoiceInput as ax, PayInvoiceOutput as ay, PaymentDirection as az, AccountToChannelsConnection as b, SetInvoicePaymentHashOutput as b0, Signable as b1, getSignableQuery as b2, SignablePayload as b3, getSignablePayloadQuery as b4, SignablePayloadStatus as b5, SignInvoiceInput as b6, SignInvoiceOutput as b7, SignMessagesInput as b8, SignMessagesOutput as b9, SingleNodeDashboard as ba, Transaction as bb, getTransactionQuery as bc, TransactionFailures as bd, TransactionStatus as be, TransactionType as bf, TransactionUpdate as bg, UpdateChannelPerCommitmentPointInput as bh, UpdateChannelPerCommitmentPointOutput as bi, UpdateNodeSharedSecretInput as bj, UpdateNodeSharedSecretOutput as bk, Wallet as bl, WalletStatus as bm, WalletToPaymentRequestsConnection as bn, WalletToTransactionsConnection as bo, Withdrawal as bp, getWithdrawalQuery as bq, WithdrawalMode as br, WithdrawalRequest as bs, WithdrawalRequestStatus as bt, WithdrawalRequestToChannelClosingTransactionsConnection as bu, WithdrawalRequestToChannelOpeningTransactionsConnection as bv, AccountToNodesConnection as c, AccountToPaymentRequestsConnection as d, AccountToTransactionsConnection as e, AccountToWalletsConnection as f, ApiToken as g, getApiTokenQuery as h, BlockchainBalance as i, ChannelClosingTransaction as j, getChannelClosingTransactionQuery as k, ChannelFees as l, ChannelOpeningTransaction as m, getChannelOpeningTransactionQuery as n, ChannelStatus as o, ChannelToTransactionsConnection as p, ComplianceProvider as q, Connection as r, CreateApiTokenInput as s, CreateApiTokenOutput as t, CreateInvoiceInput as u, CreateInvoiceOutput as v, CreateLnurlInvoiceInput as w, CreateNodeWalletAddressInput as x, CreateNodeWalletAddressOutput as y, CreateTestModeInvoiceInput as z };

package/dist/index.cjs

@@ -1877,7 +1877,9 @@ __export(src_exports, {
   WithdrawalMode: () => WithdrawalMode_default,
   WithdrawalRequest: () => WithdrawalRequest_default,
   WithdrawalRequestStatus: () => WithdrawalRequestStatus_default,
+  assertValidBitcoinNetwork: () => assertValidBitcoinNetwork,
   getApiTokenQuery: () => getApiTokenQuery,
+  getBitcoinNetworkOrThrow: () => getBitcoinNetworkOrThrow,
   getChannelClosingTransactionQuery: () => getChannelClosingTransactionQuery,
   getChannelOpeningTransactionQuery: () => getChannelOpeningTransactionQuery,
   getDepositQuery: () => getDepositQuery,
@@ -1893,6 +1895,7 @@ __export(src_exports, {
   getSignableQuery: () => getSignableQuery,
   getTransactionQuery: () => getTransactionQuery,
   getWithdrawalQuery: () => getWithdrawalQuery,
+  isBitcoinNetwork: () => isBitcoinNetwork,
   verifyAndParseWebhook: () => verifyAndParseWebhook
 });
 module.exports = __toCommonJS(src_exports);
@@ -1935,7 +1938,7 @@ var import_crypto = require("crypto");
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.0.0",
+  version: "1.0.1",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -1976,6 +1979,16 @@ var package_default = {
       module: "./dist/objects/index.js",
       require: "./dist/objects/index.cjs",
       default: "./dist/objects/index.cjs"
+    },
+    "./env": {
+      types: "./dist/env.d.ts",
+      import: {
+        types: "./dist/env.d.ts",
+        default: "./dist/env.js"
+      },
+      module: "./dist/env.js",
+      require: "./dist/env.cjs",
+      default: "./dist/env.cjs"
     }
   },
   type: "module",
@@ -1993,7 +2006,7 @@ var package_default = {
     "CHANGELOG.md"
   ],
   scripts: {
-    build: "tsup",
+    build: "yarn tsc && tsup",
     clean: "rm -rf .turbo && rm -rf dist",
     dev: "yarn build -- --watch",
     docs: "typedoc src",
@@ -2010,11 +2023,12 @@ var package_default = {
   },
   license: "Apache-2.0",
   dependencies: {
-    "@lightsparkdev/core": "1.0.0",
+    "@lightsparkdev/core": "1.0.1",
     "auto-bind": "^5.0.1",
     crypto: "^1.0.1",
     "crypto-browserify": "^3.12.0",
     dayjs: "^1.11.7",
+    dotenv: "^16.3.1",
     graphql: "^16.6.0",
     "graphql-ws": "^5.11.3",
     ws: "^8.12.1",
@@ -6959,7 +6973,7 @@ var MasterSeedSigningKeyLoader = class {
 
 // src/NodeKeyLoaderCache.ts
 var NodeKeyLoaderCache = class {
-  constructor(nodeKeyCache, cryptoImpl = DefaultCrypto) {
+  constructor(nodeKeyCache, cryptoImpl = import_core6.DefaultCrypto) {
     this.nodeKeyCache = nodeKeyCache;
     this.cryptoImpl = cryptoImpl;
     this.idToLoader = /* @__PURE__ */ new Map();
@@ -7008,11 +7022,12 @@ var NodeKeyLoaderCache = class {
     if (!loaderResult) {
       return;
     }
-    return this.nodeKeyCache.loadKey(
+    const key = await this.nodeKeyCache.loadKey(
       id,
       { key: loaderResult.key },
       loaderResult.type
     );
+    return key || void 0;
   }
 };
 
@@ -11150,6 +11165,28 @@ var LightsparkClient = class {
 };
 var client_default = LightsparkClient;
 
+// src/helpers.ts
+var BITCOIN_NETWORKS = [
+  "MAINNET" /* MAINNET */,
+  "TESTNET" /* TESTNET */,
+  "SIGNET" /* SIGNET */,
+  "REGTEST" /* REGTEST */
+];
+var isBitcoinNetwork = (bitcoinNetwork) => {
+  return BITCOIN_NETWORKS.includes(bitcoinNetwork);
+};
+var assertValidBitcoinNetwork = (bitcoinNetwork) => {
+  if (!isBitcoinNetwork(bitcoinNetwork)) {
+    throw new Error(
+      `Invalid bitcoin network ${bitcoinNetwork}. Valid networks: ${BITCOIN_NETWORKS}`
+    );
+  }
+};
+var getBitcoinNetworkOrThrow = (bitcoinNetwork) => {
+  assertValidBitcoinNetwork(bitcoinNetwork.toUpperCase());
+  return bitcoinNetwork;
+};
+
 // src/objects/ComplianceProvider.ts
 var ComplianceProvider = /* @__PURE__ */ ((ComplianceProvider2) => {
   ComplianceProvider2["FUTURE_VALUE"] = "FUTURE_VALUE";
@@ -12373,7 +12410,9 @@ var parseWebhook = async (data) => {
   WithdrawalMode,
   WithdrawalRequest,
   WithdrawalRequestStatus,
+  assertValidBitcoinNetwork,
   getApiTokenQuery,
+  getBitcoinNetworkOrThrow,
   getChannelClosingTransactionQuery,
   getChannelOpeningTransactionQuery,
   getDepositQuery,
@@ -12389,5 +12428,6 @@ var parseWebhook = async (data) => {
   getSignableQuery,
   getTransactionQuery,
   getWithdrawalQuery,
+  isBitcoinNetwork,
   verifyAndParseWebhook
 });

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,8 +1,12 @@
+import {
+  assertValidBitcoinNetwork,
+  getBitcoinNetworkOrThrow,
+  isBitcoinNetwork
+} from "./chunk-5RDIWPBE.js";
 import {
   AccountToChannelsConnection_default,
   Account_default,
   ApiTokenFromJson,
-  BitcoinNetwork_default,
   ChannelStatus_default,
   Channel_default,
   ComplianceProvider_default,
@@ -72,7 +76,10 @@ import {
   getSignableQuery,
   getTransactionQuery,
   getWithdrawalQuery
-} from "./chunk-LZC5C5NI.js";
+} from "./chunk-K2ZU5YQL.js";
+import {
+  BitcoinNetwork_default
+} from "./chunk-K6SAUSAX.js";
 import "./chunk-NIMBE7W3.js";
 
 // src/auth/AccountTokenAuthProvider.ts
@@ -122,7 +129,7 @@ import { createHash } from "crypto";
 // package.json
 var package_default = {
   name: "@lightsparkdev/lightspark-sdk",
-  version: "1.0.0",
+  version: "1.0.1",
   description: "Lightspark JS SDK",
   author: "Lightspark Inc.",
   keywords: [
@@ -163,6 +170,16 @@ var package_default = {
       module: "./dist/objects/index.js",
       require: "./dist/objects/index.cjs",
       default: "./dist/objects/index.cjs"
+    },
+    "./env": {
+      types: "./dist/env.d.ts",
+      import: {
+        types: "./dist/env.d.ts",
+        default: "./dist/env.js"
+      },
+      module: "./dist/env.js",
+      require: "./dist/env.cjs",
+      default: "./dist/env.cjs"
     }
   },
   type: "module",
@@ -180,7 +197,7 @@ var package_default = {
     "CHANGELOG.md"
   ],
   scripts: {
-    build: "tsup",
+    build: "yarn tsc && tsup",
     clean: "rm -rf .turbo && rm -rf dist",
     dev: "yarn build -- --watch",
     docs: "typedoc src",
@@ -197,11 +214,12 @@ var package_default = {
   },
   license: "Apache-2.0",
   dependencies: {
-    "@lightsparkdev/core": "1.0.0",
+    "@lightsparkdev/core": "1.0.1",
     "auto-bind": "^5.0.1",
     crypto: "^1.0.1",
     "crypto-browserify": "^3.12.0",
     dayjs: "^1.11.7",
+    dotenv: "^16.3.1",
     graphql: "^16.6.0",
     "graphql-ws": "^5.11.3",
     ws: "^8.12.1",
@@ -801,6 +819,7 @@ ${FRAGMENT10}
 
 // src/NodeKeyLoaderCache.ts
 import {
+  DefaultCrypto,
   LightsparkSigningException as LightsparkSigningException2
 } from "@lightsparkdev/core";
 
@@ -968,11 +987,12 @@ var NodeKeyLoaderCache = class {
     if (!loaderResult) {
       return;
     }
-    return this.nodeKeyCache.loadKey(
+    const key = await this.nodeKeyCache.loadKey(
       id,
       { key: loaderResult.key },
       loaderResult.type
     );
+    return key || void 0;
   }
 };
 
@@ -1764,7 +1784,9 @@ export {
   WithdrawalMode_default as WithdrawalMode,
   WithdrawalRequest_default as WithdrawalRequest,
   WithdrawalRequestStatus_default as WithdrawalRequestStatus,
+  assertValidBitcoinNetwork,
   getApiTokenQuery,
+  getBitcoinNetworkOrThrow,
   getChannelClosingTransactionQuery,
   getChannelOpeningTransactionQuery,
   getDepositQuery,
@@ -1780,5 +1802,6 @@ export {
   getSignableQuery,
   getTransactionQuery,
   getWithdrawalQuery,
+  isBitcoinNetwork,
   verifyAndParseWebhook
 };

package/dist/objects/index.d.ts

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

package/dist/objects/index.js

@@ -1,7 +1,6 @@
 import {
   AccountToChannelsConnection_default,
   Account_default,
-  BitcoinNetwork_default,
   ChannelStatus_default,
   Channel_default,
   ComplianceProvider_default,
@@ -52,7 +51,10 @@ import {
   getSignableQuery,
   getTransactionQuery,
   getWithdrawalQuery
-} from "../chunk-LZC5C5NI.js";
+} from "../chunk-K2ZU5YQL.js";
+import {
+  BitcoinNetwork_default
+} from "../chunk-K6SAUSAX.js";
 import "../chunk-NIMBE7W3.js";
 export {
   Account_default as Account,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [
@@ -41,6 +41,16 @@
       "module": "./dist/objects/index.js",
       "require": "./dist/objects/index.cjs",
       "default": "./dist/objects/index.cjs"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": {
+        "types": "./dist/env.d.ts",
+        "default": "./dist/env.js"
+      },
+      "module": "./dist/env.js",
+      "require": "./dist/env.cjs",
+      "default": "./dist/env.cjs"
     }
   },
   "type": "module",
@@ -58,7 +68,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "yarn tsc && tsup",
     "clean": "rm -rf .turbo && rm -rf dist",
     "dev": "yarn build -- --watch",
     "docs": "typedoc src",
@@ -75,11 +85,12 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@lightsparkdev/core": "1.0.0",
+    "@lightsparkdev/core": "1.0.1",
     "auto-bind": "^5.0.1",
     "crypto": "^1.0.1",
     "crypto-browserify": "^3.12.0",
     "dayjs": "^1.11.7",
+    "dotenv": "^16.3.1",
     "graphql": "^16.6.0",
     "graphql-ws": "^5.11.3",
     "ws": "^8.12.1",

package/src/NodeKeyLoaderCache.ts

@@ -1,4 +1,5 @@
 import {
+  DefaultCrypto,
   LightsparkSigningException,
   type CryptoInterface,
   type NodeKeyCache,
@@ -78,10 +79,11 @@ export default class NodeKeyLoaderCache {
       return;
     }
 
-    return this.nodeKeyCache.loadKey(
+    const key = await this.nodeKeyCache.loadKey(
       id,
       { key: loaderResult.key },
       loaderResult.type,
     );
+    return key || undefined;
   }
 }

package/src/env.ts

@@ -0,0 +1,54 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+/* These utils are only needed in NodeJS contexts and so the file is exported separately
+   in the package to avoid eg unnecessary browser bundling */
+import dotenv from "dotenv";
+import { getBitcoinNetworkOrThrow } from "./helpers.js";
+import { type BitcoinNetwork } from "./objects/BitcoinNetwork.js";
+
+export type EnvCredentials = {
+  apiTokenClientId: string;
+  apiTokenClientSecret: string;
+  bitcoinNetwork: BitcoinNetwork;
+  testNodePassword: string;
+  baseUrl: string;
+};
+
+export enum RequiredCredentials {
+  ClientId = "LIGHTSPARK_API_TOKEN_CLIENT_ID",
+  ClientSecret = "LIGHTSPARK_API_TOKEN_CLIENT_SECRET",
+  BitcoinNetwork = "BITCOIN_NETWORK",
+}
+
+export const getCredentialsFromEnvOrThrow = (): EnvCredentials => {
+  const env =
+    dotenv.config({
+      path: process.env.HOME + "/.lightsparkapienv",
+    }).parsed || {};
+
+  const missingTestCredentials = Object.values(RequiredCredentials).filter(
+    (cred) => !env[cred],
+  );
+  if (missingTestCredentials.length) {
+    throw new Error(
+      `Missing test credentials. Please set ${missingTestCredentials.join(
+        ", ",
+      )} environment variables.`,
+    );
+  }
+
+  const apiTokenClientId = env[RequiredCredentials.ClientId]!;
+  const apiTokenClientSecret = env[RequiredCredentials.ClientSecret]!;
+  const bitcoinNetwork = getBitcoinNetworkOrThrow(
+    env[RequiredCredentials.BitcoinNetwork]! as BitcoinNetwork,
+  );
+  const testNodePassword = "1234!@#$";
+  const baseUrl = env["LIGHTSPARK_BASE_URL"] || "api.lightspark.com";
+  return {
+    apiTokenClientId,
+    apiTokenClientSecret,
+    bitcoinNetwork,
+    testNodePassword,
+    baseUrl,
+  };
+};

package/src/helpers.ts

@@ -0,0 +1,31 @@
+// Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
+
+import { BitcoinNetwork } from "./objects/BitcoinNetwork.js";
+
+const BITCOIN_NETWORKS = [
+  BitcoinNetwork.MAINNET,
+  BitcoinNetwork.TESTNET,
+  BitcoinNetwork.SIGNET,
+  BitcoinNetwork.REGTEST,
+];
+
+export const isBitcoinNetwork = (bitcoinNetwork: BitcoinNetwork) => {
+  return BITCOIN_NETWORKS.includes(bitcoinNetwork);
+};
+
+export const assertValidBitcoinNetwork = (
+  bitcoinNetwork: BitcoinNetwork,
+): void => {
+  if (!isBitcoinNetwork(bitcoinNetwork)) {
+    throw new Error(
+      `Invalid bitcoin network ${bitcoinNetwork}. Valid networks: ${BITCOIN_NETWORKS}`,
+    );
+  }
+};
+
+export const getBitcoinNetworkOrThrow = (
+  bitcoinNetwork: BitcoinNetwork,
+): BitcoinNetwork => {
+  assertValidBitcoinNetwork(bitcoinNetwork.toUpperCase() as BitcoinNetwork);
+  return bitcoinNetwork;
+};

package/src/index.ts

@@ -2,5 +2,6 @@
 
 export * from "./auth/index.js";
 export { default as LightsparkClient } from "./client.js";
+export * from "./helpers.js";
 export * from "./objects/index.js";
 export * from "./webhooks.js";