@lightsparkdev/lightspark-sdk 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/{BitcoinNetwork-a816c0be.d.ts → BitcoinNetwork-37e9f091.d.ts} +8 -3
  3. package/dist/env.d.cts +1 -1
  4. package/dist/env.d.ts +1 -1
  5. package/dist/{index-eb604025.d.ts → index-449c9f58.d.ts} +1461 -675
  6. package/dist/index.cjs +341 -307
  7. package/dist/index.d.cts +3 -3
  8. package/dist/index.d.ts +3 -3
  9. package/dist/index.js +323 -289
  10. package/dist/objects/index.d.cts +2 -2
  11. package/dist/objects/index.d.ts +2 -2
  12. package/dist/objects/index.js +1 -1
  13. package/package.json +4 -4
  14. package/src/NodeKeyLoaderCache.ts +4 -3
  15. package/src/SigningKeyLoader.ts +12 -7
  16. package/src/client.ts +99 -65
  17. package/src/env.ts +3 -1
  18. package/src/objects/Account.ts +7 -3
  19. package/src/objects/AccountToApiTokensConnection.ts +7 -3
  20. package/src/objects/AccountToChannelsConnection.ts +3 -2
  21. package/src/objects/AccountToNodesConnection.ts +7 -3
  22. package/src/objects/AccountToPaymentRequestsConnection.ts +7 -3
  23. package/src/objects/AccountToTransactionsConnection.ts +13 -9
  24. package/src/objects/AccountToWalletsConnection.ts +7 -3
  25. package/src/objects/ApiToken.ts +13 -7
  26. package/src/objects/Balances.ts +22 -12
  27. package/src/objects/BitcoinNetwork.ts +8 -3
  28. package/src/objects/BlockchainBalance.ts +4 -1
  29. package/src/objects/Channel.ts +37 -14
  30. package/src/objects/ChannelClosingTransaction.ts +22 -11
  31. package/src/objects/ChannelFees.ts +4 -1
  32. package/src/objects/ChannelOpeningTransaction.ts +22 -11
  33. package/src/objects/ChannelStatus.ts +33 -8
  34. package/src/objects/ChannelToTransactionsConnection.ts +9 -8
  35. package/src/objects/ComplianceProvider.ts +3 -2
  36. package/src/objects/Connection.ts +7 -3
  37. package/src/objects/CreateApiTokenInput.ts +4 -1
  38. package/src/objects/CreateApiTokenOutput.ts +3 -3
  39. package/src/objects/CreateLnurlInvoiceInput.ts +3 -2
  40. package/src/objects/CreateTestModePaymentInput.ts +2 -2
  41. package/src/objects/CreateTestModePaymentoutput.ts +5 -1
  42. package/src/objects/CurrencyAmount.ts +6 -4
  43. package/src/objects/CurrencyUnit.ts +36 -9
  44. package/src/objects/Deposit.ts +22 -11
  45. package/src/objects/Entity.ts +8 -3
  46. package/src/objects/FeeEstimate.ts +5 -1
  47. package/src/objects/GraphNode.ts +30 -14
  48. package/src/objects/Hop.ts +12 -4
  49. package/src/objects/HtlcAttemptFailureCode.ts +7 -3
  50. package/src/objects/IncentivesIneligibilityReason.ts +33 -9
  51. package/src/objects/IncentivesStatus.ts +14 -4
  52. package/src/objects/IncomingPayment.ts +18 -7
  53. package/src/objects/IncomingPaymentAttempt.ts +8 -3
  54. package/src/objects/IncomingPaymentAttemptStatus.ts +7 -3
  55. package/src/objects/IncomingPaymentToAttemptsConnection.ts +7 -3
  56. package/src/objects/Invoice.ts +2 -2
  57. package/src/objects/InvoiceData.ts +7 -3
  58. package/src/objects/InvoiceType.ts +3 -2
  59. package/src/objects/LightningFeeEstimateForInvoiceInput.ts +2 -2
  60. package/src/objects/LightningTransaction.ts +12 -4
  61. package/src/objects/LightsparkNode.ts +33 -18
  62. package/src/objects/LightsparkNodeOwner.ts +2 -2
  63. package/src/objects/LightsparkNodeStatus.ts +3 -2
  64. package/src/objects/LightsparkNodeToChannelsConnection.ts +7 -3
  65. package/src/objects/LightsparkNodeWithOSK.ts +35 -19
  66. package/src/objects/LightsparkNodeWithRemoteSigning.ts +31 -18
  67. package/src/objects/Node.ts +28 -14
  68. package/src/objects/NodeAddressType.ts +7 -3
  69. package/src/objects/NodeToAddressesConnection.ts +7 -3
  70. package/src/objects/OnChainTransaction.ts +23 -11
  71. package/src/objects/OutgoingPayment.ts +24 -7
  72. package/src/objects/OutgoingPaymentAttempt.ts +28 -13
  73. package/src/objects/OutgoingPaymentAttemptStatus.ts +7 -3
  74. package/src/objects/OutgoingPaymentAttemptToHopsConnection.ts +12 -4
  75. package/src/objects/OutgoingPaymentToAttemptsConnection.ts +7 -3
  76. package/src/objects/PageInfo.ts +6 -1
  77. package/src/objects/PayInvoiceInput.ts +6 -3
  78. package/src/objects/PaymentDirection.ts +3 -2
  79. package/src/objects/PaymentFailureReason.ts +7 -3
  80. package/src/objects/PaymentRequest.ts +8 -3
  81. package/src/objects/PaymentRequestData.ts +5 -1
  82. package/src/objects/PaymentRequestStatus.ts +7 -3
  83. package/src/objects/Permission.ts +7 -3
  84. package/src/objects/PostTransactionData.ts +6 -3
  85. package/src/objects/RegionCode.ts +43 -12
  86. package/src/objects/RegisterPaymentInput.ts +12 -7
  87. package/src/objects/RemoteSigningSubEventType.ts +7 -3
  88. package/src/objects/RequestWithdrawalInput.ts +2 -2
  89. package/src/objects/RiskRating.ts +8 -3
  90. package/src/objects/RoutingTransaction.ts +20 -7
  91. package/src/objects/RoutingTransactionFailureReason.ts +8 -3
  92. package/src/objects/ScreenNodeInput.ts +3 -2
  93. package/src/objects/SendPaymentInput.ts +4 -1
  94. package/src/objects/SetInvoicePaymentHashInput.ts +3 -2
  95. package/src/objects/Signable.ts +2 -2
  96. package/src/objects/SignablePayload.ts +6 -3
  97. package/src/objects/SignablePayloadStatus.ts +3 -2
  98. package/src/objects/Transaction.ts +14 -4
  99. package/src/objects/TransactionFailures.ts +4 -1
  100. package/src/objects/TransactionStatus.ts +16 -5
  101. package/src/objects/TransactionType.ts +30 -8
  102. package/src/objects/TransactionUpdate.ts +6 -3
  103. package/src/objects/UmaInvitation.ts +10 -4
  104. package/src/objects/Wallet.ts +13 -4
  105. package/src/objects/WalletStatus.ts +36 -9
  106. package/src/objects/WalletToPaymentRequestsConnection.ts +7 -3
  107. package/src/objects/WalletToTransactionsConnection.ts +7 -3
  108. package/src/objects/WebhookEventType.ts +7 -3
  109. package/src/objects/Withdrawal.ts +22 -11
  110. package/src/objects/WithdrawalMode.ts +7 -3
  111. package/src/objects/WithdrawalRequest.ts +15 -6
  112. package/src/objects/WithdrawalRequestStatus.ts +3 -2
  113. package/src/objects/WithdrawalRequestToChannelClosingTransactionsConnection.ts +11 -4
  114. package/src/objects/WithdrawalRequestToChannelOpeningTransactionsConnection.ts +11 -4
  115. package/src/objects/index.ts +6 -6
  116. package/src/tests/integration/general-regtest.test.ts +1 -1
  117. /package/dist/{chunk-GLL4KTUT.js → chunk-NCPWHRFO.js} +0 -0
@@ -19,12 +19,19 @@ import OutgoingPaymentAttemptStatus from "./OutgoingPaymentAttemptStatus.js";
19
19
  import type OutgoingPaymentAttemptToHopsConnection from "./OutgoingPaymentAttemptToHopsConnection.js";
20
20
  import { OutgoingPaymentAttemptToHopsConnectionFromJson } from "./OutgoingPaymentAttemptToHopsConnection.js";
21
21
 
22
- /** This object represents an attempted Lightning Network payment sent from a Lightspark Node. You can retrieve this object to receive payment related information about any payment attempt sent from your Lightspark Node on the Lightning Network, including any potential reasons the payment may have failed. **/
22
+ /**
23
+ * This object represents an attempted Lightning Network payment sent from a
24
+ * Lightspark Node. You can retrieve this object to receive payment related
25
+ * information about any payment attempt sent from your Lightspark Node on the
26
+ * Lightning Network,
27
+ * including any potential reasons the payment may have failed.
28
+ * *
29
+ */
23
30
  class OutgoingPaymentAttempt implements Entity {
24
31
  constructor(
25
32
  /**
26
- * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
27
- * string.
33
+ * The unique identifier of this entity across all Lightspark systems.
34
+ * Should be treated as an opaque string.
28
35
  **/
29
36
  public readonly id: string,
30
37
  /** The date and time when the entity was first created. **/
@@ -39,28 +46,36 @@ class OutgoingPaymentAttempt implements Entity {
39
46
  public readonly outgoingPaymentId: string,
40
47
  /** The typename of the object **/
41
48
  public readonly typename: string,
42
- /** If the payment attempt failed, then this contains the Bolt #4 failure code. **/
49
+ /**
50
+ * If the payment attempt failed, then this contains the Bolt #4 failure
51
+ * code. *
52
+ */
43
53
  public readonly failureCode?: HtlcAttemptFailureCode | undefined,
44
54
  /**
45
- * If the payment attempt failed, then this contains the index of the hop at which the problem
46
- * occurred.
55
+ * If the payment attempt failed, then this contains the index of the hop
56
+ * at which the problem occurred.
47
57
  **/
48
58
  public readonly failureSourceIndex?: number | undefined,
49
59
  /** The time the outgoing payment attempt failed or succeeded. **/
50
60
  public readonly resolvedAt?: string | undefined,
51
61
  /**
52
- * The total amount of funds required to complete a payment over this route. This value includes the
53
- * cumulative fees for each hop. As a result, the attempt extended to the first-hop in the route will
54
- * need to have at least this much value, otherwise the route will fail at an intermediate node due to
55
- * an insufficient amount.
62
+ * The total amount of funds required to complete a payment over this route.
63
+ * This value includes the cumulative fees for each hop. As a result,
64
+ * the attempt extended to the first-hop in the route will need to have at
65
+ * least this much value, otherwise the route will fail at an intermediate
66
+ * node due to an insufficient amount.
56
67
  **/
57
68
  public readonly amount?: CurrencyAmount | undefined,
58
69
  /**
59
- * The sum of the fees paid at each hop within the route of this attempt. In the case of a one-hop
60
- * payment, this value will be zero as we don't need to pay a fee to ourselves.
70
+ * The sum of the fees paid at each hop within the route of this attempt.
71
+ * In the case of a one-hop payment,
72
+ * this value will be zero as we don't need to pay a fee to ourselves.
61
73
  **/
62
74
  public readonly fees?: CurrencyAmount | undefined,
63
- /** The channel snapshot at the time the outgoing payment attempt was made. **/
75
+ /**
76
+ * The channel snapshot at the time the outgoing payment attempt was made.
77
+ * *
78
+ */
64
79
  public readonly channelSnapshot?: ChannelSnapshot | undefined,
65
80
  ) {
66
81
  autoBind(this);
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of all potential statuses of a payment attempt made from a Lightspark Node. **/
3
+ /**
4
+ * This is an enum of all potential statuses of a payment attempt made from a
5
+ * Lightspark Node. *
6
+ */
4
7
  export enum OutgoingPaymentAttemptStatus {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
 
@@ -5,15 +5,23 @@ import { HopFromJson, HopToJson } from "./Hop.js";
5
5
  import type PageInfo from "./PageInfo.js";
6
6
  import { PageInfoFromJson, PageInfoToJson } from "./PageInfo.js";
7
7
 
8
- /** The connection from an outgoing payment attempt to the list of sequential hops that define the path from sender node to recipient node. **/
8
+ /**
9
+ * The connection from an outgoing payment attempt to the list of sequential
10
+ * hops that define the path from sender node to recipient node.
11
+ * *
12
+ */
9
13
  interface OutgoingPaymentAttemptToHopsConnection {
10
14
  /**
11
- * The total count of objects in this connection, using the current filters. It is different from the
12
- * number of objects returned in the current page (in the `entities` field).
15
+ * The total count of objects in this connection, using the current filters.
16
+ * It is different from the number of objects returned in the current page
17
+ * (in the `entities` field).
13
18
  **/
14
19
  count: number;
15
20
 
16
- /** An object that holds pagination information about the objects in this connection. **/
21
+ /**
22
+ * An object that holds pagination information about the objects in this
23
+ * connection. *
24
+ */
17
25
  pageInfo: PageInfo;
18
26
 
19
27
  /** The hops for the current page of this connection. **/
@@ -8,12 +8,16 @@ import { PageInfoFromJson, PageInfoToJson } from "./PageInfo.js";
8
8
  /** The connection from outgoing payment to all attempts. **/
9
9
  interface OutgoingPaymentToAttemptsConnection {
10
10
  /**
11
- * The total count of objects in this connection, using the current filters. It is different from the
12
- * number of objects returned in the current page (in the `entities` field).
11
+ * The total count of objects in this connection, using the current filters.
12
+ * It is different from the number of objects returned in the current page
13
+ * (in the `entities` field).
13
14
  **/
14
15
  count: number;
15
16
 
16
- /** An object that holds pagination information about the objects in this connection. **/
17
+ /**
18
+ * An object that holds pagination information about the objects in this
19
+ * connection. *
20
+ */
17
21
  pageInfo: PageInfo;
18
22
 
19
23
  /** The attempts for the current page of this connection. **/
@@ -1,6 +1,11 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an object representing information about a page returned by the Lightspark API. For more information, please see the “Pagination” section of our API docs for more information about its usage. **/
3
+ /**
4
+ * This is an object representing information about a page returned by the
5
+ * Lightspark API. For more information,
6
+ * please see the “Pagination” section of our API docs for more information
7
+ * about its usage. *
8
+ */
4
9
  interface PageInfo {
5
10
  hasNextPage?: boolean | undefined;
6
11
 
@@ -10,12 +10,15 @@ interface PayInvoiceInput {
10
10
  /** The timeout in seconds that we will try to make the payment. **/
11
11
  timeoutSecs: number;
12
12
 
13
- /** The maximum amount of fees that you want to pay for this payment to be sent, expressed in msats. **/
13
+ /**
14
+ * The maximum amount of fees that you want to pay for this payment to be
15
+ * sent, expressed in msats. *
16
+ */
14
17
  maximumFeesMsats: number;
15
18
 
16
19
  /**
17
- * The amount you will pay for this invoice, expressed in msats. It should ONLY be set when the
18
- * invoice amount is zero.
20
+ * The amount you will pay for this invoice, expressed in msats.
21
+ * It should ONLY be set when the invoice amount is zero.
19
22
  **/
20
23
  amountMsats?: number | undefined;
21
24
  }
@@ -3,8 +3,9 @@
3
3
  /** This is an enum indicating the direction of the payment. **/
4
4
  export enum PaymentDirection {
5
5
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
6
+ * This is an enum value that represents values that could be added in the
7
+ * future. Clients should support unknown values as more of them could be
8
+ * added without notice.
8
9
  */
9
10
  FUTURE_VALUE = "FUTURE_VALUE",
10
11
 
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential reasons why an OutgoingPayment sent from a Lightspark Node may have failed. **/
3
+ /**
4
+ * This is an enum of the potential reasons why an OutgoingPayment sent from a
5
+ * Lightspark Node may have failed. *
6
+ */
4
7
  export enum PaymentFailureReason {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
 
@@ -10,11 +10,16 @@ import { InvoiceDataFromJson, InvoiceDataToJson } from "./InvoiceData.js";
10
10
  import type PaymentRequestData from "./PaymentRequestData.js";
11
11
  import PaymentRequestStatus from "./PaymentRequestStatus.js";
12
12
 
13
- /** This object contains information related to a payment request generated or received by a LightsparkNode. You can retrieve this object to receive payment information about a specific invoice. **/
13
+ /**
14
+ * This object contains information related to a payment request generated or
15
+ * received by a LightsparkNode. You can retrieve this object to receive
16
+ * payment information about a specific invoice.
17
+ * *
18
+ */
14
19
  interface PaymentRequest {
15
20
  /**
16
- * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
17
- * string.
21
+ * The unique identifier of this entity across all Lightspark systems.
22
+ * Should be treated as an opaque string.
18
23
  **/
19
24
  id: string;
20
25
 
@@ -9,7 +9,11 @@ import {
9
9
  import type InvoiceData from "./InvoiceData.js";
10
10
  import { NodeFromJson, NodeToJson } from "./Node.js";
11
11
 
12
- /** This object is an interface of a payment request on the Lightning Network (i.e., a Lightning Invoice). It contains data related to parsing the payment details of a Lightning Invoice. **/
12
+ /**
13
+ * This object is an interface of a payment request on the Lightning Network
14
+ * (i.e., a Lightning Invoice). It contains data related to parsing the payment
15
+ * details of a Lightning Invoice. *
16
+ */
13
17
  interface PaymentRequestData {
14
18
  encodedPaymentRequest: string;
15
19
 
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential states that a payment request on the Lightning Network can take. **/
3
+ /**
4
+ * This is an enum of the potential states that a payment request on the
5
+ * Lightning Network can take. *
6
+ */
4
7
  export enum PaymentRequestStatus {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
 
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential permissions that a Lightspark user can have in regards to account management. **/
3
+ /**
4
+ * This is an enum of the potential permissions that a Lightspark user can have
5
+ * in regards to account management. *
6
+ */
4
7
  export enum Permission {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
 
@@ -6,11 +6,14 @@ import {
6
6
  CurrencyAmountToJson,
7
7
  } from "./CurrencyAmount.js";
8
8
 
9
- /** This object represents post-transaction data that could be used to register payment for KYT. **/
9
+ /**
10
+ * This object represents post-transaction data that could be used to register
11
+ * payment for KYT. *
12
+ */
10
13
  interface PostTransactionData {
11
14
  /**
12
- * The utxo of the channel over which the payment went through in the format of
13
- * <transaction_hash>:<output_index>.
15
+ * The utxo of the channel over which the payment went through in the format
16
+ * of <transaction_hash>:<output_index>.
14
17
  **/
15
18
  utxo: string;
16
19
 
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** The alpha-2 representation of a country, as defined by the ISO 3166-1 standard. **/
3
+ /**
4
+ * The alpha-2 representation of a country, as defined by the ISO 3166-1
5
+ * standard. *
6
+ */
4
7
  export enum RegionCode {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
  /** The code representing the country of Afghanistan. **/
@@ -59,9 +63,15 @@ export enum RegionCode {
59
63
  BM = "BM",
60
64
  /** The code representing the country of Bhutan. **/
61
65
  BT = "BT",
62
- /** The code representing the country of The Plurinational State of Bolivia. **/
66
+ /**
67
+ * The code representing the country of The Plurinational State of Bolivia.
68
+ * *
69
+ */
63
70
  BO = "BO",
64
- /** The code representing the country of Bonaire, Sint Eustatius, and Saba. **/
71
+ /**
72
+ * The code representing the country of Bonaire, Sint Eustatius, and Saba.
73
+ * *
74
+ */
65
75
  BQ = "BQ",
66
76
  /** The code representing the country of Bosnia and Herzegovina. **/
67
77
  BA = "BA",
@@ -109,7 +119,10 @@ export enum RegionCode {
109
119
  KM = "KM",
110
120
  /** The code representing the country of Congo. **/
111
121
  CG = "CG",
112
- /** The code representing the country of The Democratic Republic of the Congo. **/
122
+ /**
123
+ * The code representing the country of The Democratic Republic of the Congo.
124
+ * *
125
+ */
113
126
  CD = "CD",
114
127
  /** The code representing the country of Cook Islands. **/
115
128
  CK = "CK",
@@ -199,7 +212,10 @@ export enum RegionCode {
199
212
  GY = "GY",
200
213
  /** The code representing the country of Haiti. **/
201
214
  HT = "HT",
202
- /** The code representing the country of Heard Island and McDonald Islands. **/
215
+ /**
216
+ * The code representing the country of Heard Island and McDonald Islands.
217
+ * *
218
+ */
203
219
  HM = "HM",
204
220
  /** The code representing the country of Holy See (Vatican City State). **/
205
221
  VA = "VA",
@@ -241,7 +257,10 @@ export enum RegionCode {
241
257
  KE = "KE",
242
258
  /** The code representing the country of Kiribati. **/
243
259
  KI = "KI",
244
- /** The code representing the country of Democratic People's Republic ofKorea. **/
260
+ /**
261
+ * The code representing the country of Democratic People's Republic ofKorea.
262
+ * *
263
+ */
245
264
  KP = "KP",
246
265
  /** The code representing the country of Republic of Korea. **/
247
266
  KR = "KR",
@@ -269,7 +288,10 @@ export enum RegionCode {
269
288
  LU = "LU",
270
289
  /** The code representing the country of Macao. **/
271
290
  MO = "MO",
272
- /** The code representing the country of The Former Yugoslav Republic of Macedonia. **/
291
+ /**
292
+ * The code representing the country of The Former Yugoslav Republic of
293
+ * Macedonia. *
294
+ */
273
295
  MK = "MK",
274
296
  /** The code representing the country of Madagascar. **/
275
297
  MG = "MG",
@@ -377,7 +399,10 @@ export enum RegionCode {
377
399
  RW = "RW",
378
400
  /** The code representing the country of Saint Barthélemy. **/
379
401
  BL = "BL",
380
- /** The code representing the country of Saint Helena Ascension and Tristan da Cunha. **/
402
+ /**
403
+ * The code representing the country of Saint Helena Ascension and Tristan
404
+ * da Cunha. *
405
+ */
381
406
  SH = "SH",
382
407
  /** The code representing the country of Saint Kitts and Nevis. **/
383
408
  KN = "KN",
@@ -419,7 +444,10 @@ export enum RegionCode {
419
444
  SO = "SO",
420
445
  /** The code representing the country of South Africa. **/
421
446
  ZA = "ZA",
422
- /** The code representing the country of South Georgia and the South Sandwich Islands. **/
447
+ /**
448
+ * The code representing the country of South Georgia and the South Sandwich
449
+ * Islands. *
450
+ */
423
451
  GS = "GS",
424
452
  /** The code representing the country of South Sudan. **/
425
453
  SS = "SS",
@@ -479,7 +507,10 @@ export enum RegionCode {
479
507
  GB = "GB",
480
508
  /** The code representing the country of United States. **/
481
509
  US = "US",
482
- /** The code representing the country of United States Minor Outlying Islands. **/
510
+ /**
511
+ * The code representing the country of United States Minor Outlying Islands.
512
+ * *
513
+ */
483
514
  UM = "UM",
484
515
  /** The code representing the country of Uruguay. **/
485
516
  UY = "UY",
@@ -5,25 +5,30 @@ import PaymentDirection from "./PaymentDirection.js";
5
5
 
6
6
  interface RegisterPaymentInput {
7
7
  /**
8
- * The compliance provider that is going to screen the node. You need to be a customer of the selected
9
- * provider and store the API key on the Lightspark account setting page.
8
+ * The compliance provider that is going to screen the node.
9
+ * You need to be a customer of the selected provider and store the API key
10
+ * on the Lightspark account setting page.
10
11
  **/
11
12
  provider: ComplianceProvider;
12
13
 
13
14
  /**
14
- * The Lightspark ID of the lightning payment you want to register. It can be the id of either an
15
- * OutgoingPayment or an IncomingPayment.
15
+ * The Lightspark ID of the lightning payment you want to register.
16
+ * It can be the id of either an OutgoingPayment or an IncomingPayment.
16
17
  **/
17
18
  paymentId: string;
18
19
 
19
20
  /**
20
- * The public key of the counterparty lightning node, which would be the public key of the recipient
21
- * node if it is to register an outgoing payment, or the public key of the sender node if it is to
21
+ * The public key of the counterparty lightning node,
22
+ * which would be the public key of the recipient node if it is to register
23
+ * an outgoing payment, or the public key of the sender node if it is to
22
24
  * register an incoming payment.
23
25
  **/
24
26
  nodePubkey: string;
25
27
 
26
- /** Indicates whether this payment is an OutgoingPayment or an IncomingPayment. **/
28
+ /**
29
+ * Indicates whether this payment is an OutgoingPayment or an
30
+ * IncomingPayment. *
31
+ */
27
32
  direction: PaymentDirection;
28
33
  }
29
34
 
@@ -1,10 +1,14 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential sub-event types for Remote Signing webook events. **/
3
+ /**
4
+ * This is an enum of the potential sub-event types for Remote Signing webook
5
+ * events. *
6
+ */
4
7
  export enum RemoteSigningSubEventType {
5
8
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
9
+ * This is an enum value that represents values that could be added in the
10
+ * future. Clients should support unknown values as more of them could be
11
+ * added without notice.
8
12
  */
9
13
  FUTURE_VALUE = "FUTURE_VALUE",
10
14
 
@@ -10,8 +10,8 @@ interface RequestWithdrawalInput {
10
10
  bitcoinAddress: string;
11
11
 
12
12
  /**
13
- * The amount you want to withdraw from this node in Satoshis. Use the special value -1 to withdrawal
14
- * all funds from this node.
13
+ * The amount you want to withdraw from this node in Satoshis.
14
+ * Use the special value -1 to withdrawal all funds from this node.
15
15
  **/
16
16
  amountSats: number;
17
17
 
@@ -1,10 +1,15 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential risk ratings related to a transaction made over the Lightning Network. These risk ratings are returned from the CryptoSanctionScreeningProvider. **/
3
+ /**
4
+ * This is an enum of the potential risk ratings related to a transaction made
5
+ * over the Lightning Network. These risk ratings are returned from the
6
+ * CryptoSanctionScreeningProvider. *
7
+ */
4
8
  export enum RiskRating {
5
9
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
10
+ * This is an enum value that represents values that could be added in the
11
+ * future. Clients should support unknown values as more of them could be
12
+ * added without notice.
8
13
  */
9
14
  FUTURE_VALUE = "FUTURE_VALUE",
10
15
 
@@ -11,11 +11,17 @@ import { RichTextFromJson, RichTextToJson } from "./RichText.js";
11
11
  import RoutingTransactionFailureReason from "./RoutingTransactionFailureReason.js";
12
12
  import TransactionStatus from "./TransactionStatus.js";
13
13
 
14
- /** This object represents a transaction that was forwarded through a Lightspark node on the Lightning Network, i.e., a routed transaction. You can retrieve this object to receive information about any transaction routed through your Lightspark Node. **/
14
+ /**
15
+ * This object represents a transaction that was forwarded through a Lightspark
16
+ * node on the Lightning Network, i.e., a routed transaction.
17
+ * You can retrieve this object to receive information about any transaction
18
+ * routed through your Lightspark Node.
19
+ * *
20
+ */
15
21
  interface RoutingTransaction {
16
22
  /**
17
- * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
18
- * string.
23
+ * The unique identifier of this entity across all Lightspark systems.
24
+ * Should be treated as an opaque string.
19
25
  **/
20
26
  id: string;
21
27
 
@@ -37,7 +43,10 @@ interface RoutingTransaction {
37
43
  /** The date and time when this transaction was completed or failed. **/
38
44
  resolvedAt?: string | undefined;
39
45
 
40
- /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
46
+ /**
47
+ * The hash of this transaction, so it can be uniquely identified on the
48
+ * Lightning Network. *
49
+ */
41
50
  transactionHash?: string | undefined;
42
51
 
43
52
  /** If known, the channel this transaction was received from. **/
@@ -47,12 +56,16 @@ interface RoutingTransaction {
47
56
  outgoingChannelId?: string | undefined;
48
57
 
49
58
  /**
50
- * The fees collected by the node when routing this transaction. We subtract the outgoing amount to
51
- * the incoming amount to determine how much fees were collected.
59
+ * The fees collected by the node when routing this transaction.
60
+ * We subtract the outgoing amount to the incoming amount to determine how
61
+ * much fees were collected.
52
62
  **/
53
63
  fees?: CurrencyAmount | undefined;
54
64
 
55
- /** If applicable, user-facing error message describing why the routing failed. **/
65
+ /**
66
+ * If applicable, user-facing error message describing why the routing
67
+ * failed. *
68
+ */
56
69
  failureMessage?: RichText | undefined;
57
70
 
58
71
  /** If applicable, the reason why the routing failed. **/
@@ -1,10 +1,15 @@
1
1
  // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
2
2
 
3
- /** This is an enum of the potential reasons that an attempted routed transaction through a Lightspark node may have failed. **/
3
+ /**
4
+ * This is an enum of the potential reasons that an attempted routed
5
+ * transaction through a Lightspark node may have failed.
6
+ * *
7
+ */
4
8
  export enum RoutingTransactionFailureReason {
5
9
  /**
6
- * This is an enum value that represents values that could be added in the future.
7
- * Clients should support unknown values as more of them could be added without notice.
10
+ * This is an enum value that represents values that could be added in the
11
+ * future. Clients should support unknown values as more of them could be
12
+ * added without notice.
8
13
  */
9
14
  FUTURE_VALUE = "FUTURE_VALUE",
10
15
 
@@ -4,8 +4,9 @@ import ComplianceProvider from "./ComplianceProvider.js";
4
4
 
5
5
  interface ScreenNodeInput {
6
6
  /**
7
- * The compliance provider that is going to screen the node. You need to be a customer of the selected
8
- * provider and store the API key on the Lightspark account setting page.
7
+ * The compliance provider that is going to screen the node.
8
+ * You need to be a customer of the selected provider and store the API key
9
+ * on the Lightspark account setting page.
9
10
  **/
10
11
  provider: ComplianceProvider;
11
12
 
@@ -13,7 +13,10 @@ interface SendPaymentInput {
13
13
  /** The amount you will send to the destination node, expressed in msats. **/
14
14
  amountMsats: number;
15
15
 
16
- /** The maximum amount of fees that you want to pay for this payment to be sent, expressed in msats. **/
16
+ /**
17
+ * The maximum amount of fees that you want to pay for this payment to be
18
+ * sent, expressed in msats. *
19
+ */
17
20
  maximumFeesMsats: number;
18
21
  }
19
22
 
@@ -8,8 +8,9 @@ interface SetInvoicePaymentHashInput {
8
8
  paymentHash: string;
9
9
 
10
10
  /**
11
- * The 32-byte nonce used to generate the invoice preimage if applicable. It will later be included in
12
- * RELEASE_PAYMENT_PREIMAGE webhook to help recover the raw preimage.
11
+ * The 32-byte nonce used to generate the invoice preimage if applicable.
12
+ * It will later be included in RELEASE_PAYMENT_PREIMAGE webhook to help
13
+ * recover the raw preimage.
13
14
  **/
14
15
  preimageNonce?: string | undefined;
15
16
  }
@@ -4,8 +4,8 @@ import { type Query } from "@lightsparkdev/core";
4
4
 
5
5
  interface Signable {
6
6
  /**
7
- * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
8
- * string.
7
+ * The unique identifier of this entity across all Lightspark systems.
8
+ * Should be treated as an opaque string.
9
9
  **/
10
10
  id: string;
11
11
 
@@ -5,8 +5,8 @@ import SignablePayloadStatus from "./SignablePayloadStatus.js";
5
5
 
6
6
  interface SignablePayload {
7
7
  /**
8
- * The unique identifier of this entity across all Lightspark systems. Should be treated as an opaque
9
- * string.
8
+ * The unique identifier of this entity across all Lightspark systems.
9
+ * Should be treated as an opaque string.
10
10
  **/
11
11
  id: string;
12
12
 
@@ -19,7 +19,10 @@ interface SignablePayload {
19
19
  /** The payload that needs to be signed. **/
20
20
  payload: string;
21
21
 
22
- /** The consistent method for generating the same set of accounts and wallets for a given private key **/
22
+ /**
23
+ * The consistent method for generating the same set of accounts and wallets
24
+ * for a given private key *
25
+ */
23
26
  derivationPath: string;
24
27
 
25
28
  /** The status of the payload. **/