@arkade-os/sdk 0.3.5 → 0.3.6
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.
- package/README.md +4 -4
- package/dist/cjs/index.js +3 -2
- package/dist/cjs/wallet/vtxo-manager.js +19 -24
- package/dist/esm/index.js +2 -2
- package/dist/esm/wallet/vtxo-manager.js +18 -23
- package/dist/types/index.d.ts +2 -2
- package/dist/types/wallet/vtxo-manager.d.ts +11 -10
- package/dist/types/wallet/wallet.d.ts +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -120,8 +120,8 @@ import { VtxoManager } from '@arkade-os/sdk'
|
|
|
120
120
|
|
|
121
121
|
// Create manager with optional renewal configuration
|
|
122
122
|
const manager = new VtxoManager(wallet, {
|
|
123
|
-
enabled: true,
|
|
124
|
-
|
|
123
|
+
enabled: true, // Enable expiration monitoring
|
|
124
|
+
thresholdMs: 24 * 60 * 60 * 1000 // Alert when 24h hours % of lifetime remains (default)
|
|
125
125
|
})
|
|
126
126
|
```
|
|
127
127
|
|
|
@@ -137,8 +137,8 @@ console.log('Renewed:', txid)
|
|
|
137
137
|
|
|
138
138
|
// Check which VTXOs are expiring soon
|
|
139
139
|
const expiringVtxos = await manager.getExpiringVtxos()
|
|
140
|
-
// Override
|
|
141
|
-
const urgentlyExpiring = await manager.getExpiringVtxos(
|
|
140
|
+
// Override thresholdMs (e.g., renew when 5 seconds of time remains)
|
|
141
|
+
const urgentlyExpiring = await manager.getExpiringVtxos(5_000)
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
|
package/dist/cjs/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
4
|
-
exports.maybeArkError = exports.ArkError = exports.Transaction = void 0;
|
|
3
|
+
exports.P2A = exports.TxTree = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.networks = exports.ArkNote = exports.isVtxoExpiringSoon = exports.combineTapscriptSigs = exports.hasBoardingTxExpired = exports.waitForIncomingFunds = exports.verifyTapscriptSignatures = exports.buildOffchainTx = exports.ConditionWitness = exports.VtxoTaprootTree = exports.VtxoTreeExpiry = exports.CosignerPublicKey = exports.getArkPsbtFields = exports.setArkPsbtField = exports.ArkPsbtFieldKeyType = exports.ArkPsbtFieldKey = exports.TapTreeCoder = exports.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.Response = exports.Request = exports.ServiceWorkerWallet = exports.Worker = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.SingleKey = exports.Wallet = void 0;
|
|
4
|
+
exports.maybeArkError = exports.ArkError = exports.Transaction = exports.Unroll = void 0;
|
|
5
5
|
const transaction_1 = require("./utils/transaction");
|
|
6
6
|
Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_1.Transaction; } });
|
|
7
7
|
const singleKey_1 = require("./identity/singleKey");
|
|
@@ -25,6 +25,7 @@ Object.defineProperty(exports, "TxTree", { enumerable: true, get: function () {
|
|
|
25
25
|
const ramps_1 = require("./wallet/ramps");
|
|
26
26
|
Object.defineProperty(exports, "Ramps", { enumerable: true, get: function () { return ramps_1.Ramps; } });
|
|
27
27
|
const vtxo_manager_1 = require("./wallet/vtxo-manager");
|
|
28
|
+
Object.defineProperty(exports, "isVtxoExpiringSoon", { enumerable: true, get: function () { return vtxo_manager_1.isVtxoExpiringSoon; } });
|
|
28
29
|
Object.defineProperty(exports, "VtxoManager", { enumerable: true, get: function () { return vtxo_manager_1.VtxoManager; } });
|
|
29
30
|
const wallet_3 = require("./wallet/serviceWorker/wallet");
|
|
30
31
|
Object.defineProperty(exports, "ServiceWorkerWallet", { enumerable: true, get: function () { return wallet_3.ServiceWorkerWallet; } });
|
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.VtxoManager = exports.DEFAULT_RENEWAL_CONFIG = void 0;
|
|
3
|
+
exports.VtxoManager = exports.DEFAULT_RENEWAL_CONFIG = exports.DEFAULT_THRESHOLD_MS = void 0;
|
|
4
4
|
exports.isVtxoExpiringSoon = isVtxoExpiringSoon;
|
|
5
5
|
exports.getExpiringAndRecoverableVtxos = getExpiringAndRecoverableVtxos;
|
|
6
6
|
const _1 = require(".");
|
|
7
|
+
exports.DEFAULT_THRESHOLD_MS = 3 * 24 * 60 * 60 * 1000; // 3 days
|
|
7
8
|
/**
|
|
8
9
|
* Default renewal configuration values
|
|
9
10
|
*/
|
|
10
11
|
exports.DEFAULT_RENEWAL_CONFIG = {
|
|
11
|
-
|
|
12
|
+
thresholdMs: exports.DEFAULT_THRESHOLD_MS, // 3 days
|
|
12
13
|
};
|
|
13
14
|
function getDustAmount(wallet) {
|
|
14
15
|
return "dustAmount" in wallet ? wallet.dustAmount : 330n;
|
|
@@ -82,22 +83,16 @@ function getRecoverableWithSubdust(vtxos, dustAmount) {
|
|
|
82
83
|
* @param thresholdMs - Threshold in milliseconds from now
|
|
83
84
|
* @returns true if VTXO expires within threshold, false otherwise
|
|
84
85
|
*/
|
|
85
|
-
function isVtxoExpiringSoon(vtxo,
|
|
86
|
+
function isVtxoExpiringSoon(vtxo, thresholdMs // in milliseconds
|
|
87
|
+
) {
|
|
88
|
+
const realThresholdMs = thresholdMs <= 100 ? exports.DEFAULT_THRESHOLD_MS : thresholdMs;
|
|
86
89
|
const { batchExpiry } = vtxo.virtualStatus;
|
|
87
|
-
if (!batchExpiry)
|
|
90
|
+
if (!batchExpiry)
|
|
88
91
|
return false; // it doesn't expire
|
|
89
|
-
}
|
|
90
92
|
const now = Date.now();
|
|
91
|
-
if (batchExpiry <= now)
|
|
93
|
+
if (batchExpiry <= now)
|
|
92
94
|
return false; // already expired
|
|
93
|
-
|
|
94
|
-
// It shouldn't happen, but let's be safe
|
|
95
|
-
if (!vtxo.createdAt) {
|
|
96
|
-
return false;
|
|
97
|
-
}
|
|
98
|
-
const duration = batchExpiry - vtxo.createdAt.getTime();
|
|
99
|
-
const softExpiry = batchExpiry - (duration * percentage) / 100;
|
|
100
|
-
return softExpiry > 0 && softExpiry <= now;
|
|
95
|
+
return batchExpiry - now <= realThresholdMs;
|
|
101
96
|
}
|
|
102
97
|
/**
|
|
103
98
|
* Filter VTXOs that are expiring soon or are recoverable/subdust
|
|
@@ -107,8 +102,8 @@ function isVtxoExpiringSoon(vtxo, percentage) {
|
|
|
107
102
|
* @param dustAmount - Dust threshold amount in satoshis
|
|
108
103
|
* @returns Array of VTXOs expiring within threshold
|
|
109
104
|
*/
|
|
110
|
-
function getExpiringAndRecoverableVtxos(vtxos,
|
|
111
|
-
return vtxos.filter((vtxo) => isVtxoExpiringSoon(vtxo,
|
|
105
|
+
function getExpiringAndRecoverableVtxos(vtxos, thresholdMs, dustAmount) {
|
|
106
|
+
return vtxos.filter((vtxo) => isVtxoExpiringSoon(vtxo, thresholdMs) ||
|
|
112
107
|
(0, _1.isRecoverable)(vtxo) ||
|
|
113
108
|
(0, _1.isSubdust)(vtxo, dustAmount));
|
|
114
109
|
}
|
|
@@ -131,7 +126,7 @@ function getExpiringAndRecoverableVtxos(vtxos, percentage, dustAmount) {
|
|
|
131
126
|
* // Initialize with renewal config
|
|
132
127
|
* const manager = new VtxoManager(wallet, {
|
|
133
128
|
* enabled: true,
|
|
134
|
-
*
|
|
129
|
+
* thresholdMs: 86400000
|
|
135
130
|
* });
|
|
136
131
|
*
|
|
137
132
|
* // Check recoverable balance
|
|
@@ -251,24 +246,24 @@ class VtxoManager {
|
|
|
251
246
|
/**
|
|
252
247
|
* Get VTXOs that are expiring soon based on renewal configuration
|
|
253
248
|
*
|
|
254
|
-
* @param
|
|
249
|
+
* @param thresholdMs - Optional override for threshold in milliseconds
|
|
255
250
|
* @returns Array of expiring VTXOs, empty array if renewal is disabled or no VTXOs expiring
|
|
256
251
|
*
|
|
257
252
|
* @example
|
|
258
253
|
* ```typescript
|
|
259
|
-
* const manager = new VtxoManager(wallet, { enabled: true,
|
|
254
|
+
* const manager = new VtxoManager(wallet, { enabled: true, thresholdMs: 86400000 });
|
|
260
255
|
* const expiringVtxos = await manager.getExpiringVtxos();
|
|
261
256
|
* if (expiringVtxos.length > 0) {
|
|
262
257
|
* console.log(`${expiringVtxos.length} VTXOs expiring soon`);
|
|
263
258
|
* }
|
|
264
259
|
* ```
|
|
265
260
|
*/
|
|
266
|
-
async getExpiringVtxos(
|
|
261
|
+
async getExpiringVtxos(thresholdMs) {
|
|
267
262
|
const vtxos = await this.wallet.getVtxos({ withRecoverable: true });
|
|
268
|
-
const
|
|
269
|
-
this.renewalConfig?.
|
|
270
|
-
exports.DEFAULT_RENEWAL_CONFIG.
|
|
271
|
-
return getExpiringAndRecoverableVtxos(vtxos,
|
|
263
|
+
const threshold = thresholdMs ??
|
|
264
|
+
this.renewalConfig?.thresholdMs ??
|
|
265
|
+
exports.DEFAULT_RENEWAL_CONFIG.thresholdMs;
|
|
266
|
+
return getExpiringAndRecoverableVtxos(vtxos, threshold, getDustAmount(this.wallet));
|
|
272
267
|
}
|
|
273
268
|
/**
|
|
274
269
|
* Renew expiring VTXOs by settling them back to the wallet's address
|
package/dist/esm/index.js
CHANGED
|
@@ -8,7 +8,7 @@ import { TxType, } from './wallet/index.js';
|
|
|
8
8
|
import { Wallet, waitForIncomingFunds } from './wallet/wallet.js';
|
|
9
9
|
import { TxTree } from './tree/txTree.js';
|
|
10
10
|
import { Ramps } from './wallet/ramps.js';
|
|
11
|
-
import { VtxoManager } from './wallet/vtxo-manager.js';
|
|
11
|
+
import { isVtxoExpiringSoon, VtxoManager } from './wallet/vtxo-manager.js';
|
|
12
12
|
import { ServiceWorkerWallet } from './wallet/serviceWorker/wallet.js';
|
|
13
13
|
import { OnchainWallet } from './wallet/onchain.js';
|
|
14
14
|
import { setupServiceWorker } from './wallet/serviceWorker/utils.js';
|
|
@@ -45,7 +45,7 @@ decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTa
|
|
|
45
45
|
// Ark PSBT fields
|
|
46
46
|
ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness,
|
|
47
47
|
// Utils
|
|
48
|
-
buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs,
|
|
48
|
+
buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs, isVtxoExpiringSoon,
|
|
49
49
|
// Arknote
|
|
50
50
|
ArkNote,
|
|
51
51
|
// Network
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { isRecoverable, isSubdust } from './index.js';
|
|
2
|
+
export const DEFAULT_THRESHOLD_MS = 3 * 24 * 60 * 60 * 1000; // 3 days
|
|
2
3
|
/**
|
|
3
4
|
* Default renewal configuration values
|
|
4
5
|
*/
|
|
5
6
|
export const DEFAULT_RENEWAL_CONFIG = {
|
|
6
|
-
|
|
7
|
+
thresholdMs: DEFAULT_THRESHOLD_MS, // 3 days
|
|
7
8
|
};
|
|
8
9
|
function getDustAmount(wallet) {
|
|
9
10
|
return "dustAmount" in wallet ? wallet.dustAmount : 330n;
|
|
@@ -77,22 +78,16 @@ function getRecoverableWithSubdust(vtxos, dustAmount) {
|
|
|
77
78
|
* @param thresholdMs - Threshold in milliseconds from now
|
|
78
79
|
* @returns true if VTXO expires within threshold, false otherwise
|
|
79
80
|
*/
|
|
80
|
-
export function isVtxoExpiringSoon(vtxo,
|
|
81
|
+
export function isVtxoExpiringSoon(vtxo, thresholdMs // in milliseconds
|
|
82
|
+
) {
|
|
83
|
+
const realThresholdMs = thresholdMs <= 100 ? DEFAULT_THRESHOLD_MS : thresholdMs;
|
|
81
84
|
const { batchExpiry } = vtxo.virtualStatus;
|
|
82
|
-
if (!batchExpiry)
|
|
85
|
+
if (!batchExpiry)
|
|
83
86
|
return false; // it doesn't expire
|
|
84
|
-
}
|
|
85
87
|
const now = Date.now();
|
|
86
|
-
if (batchExpiry <= now)
|
|
88
|
+
if (batchExpiry <= now)
|
|
87
89
|
return false; // already expired
|
|
88
|
-
|
|
89
|
-
// It shouldn't happen, but let's be safe
|
|
90
|
-
if (!vtxo.createdAt) {
|
|
91
|
-
return false;
|
|
92
|
-
}
|
|
93
|
-
const duration = batchExpiry - vtxo.createdAt.getTime();
|
|
94
|
-
const softExpiry = batchExpiry - (duration * percentage) / 100;
|
|
95
|
-
return softExpiry > 0 && softExpiry <= now;
|
|
90
|
+
return batchExpiry - now <= realThresholdMs;
|
|
96
91
|
}
|
|
97
92
|
/**
|
|
98
93
|
* Filter VTXOs that are expiring soon or are recoverable/subdust
|
|
@@ -102,8 +97,8 @@ export function isVtxoExpiringSoon(vtxo, percentage) {
|
|
|
102
97
|
* @param dustAmount - Dust threshold amount in satoshis
|
|
103
98
|
* @returns Array of VTXOs expiring within threshold
|
|
104
99
|
*/
|
|
105
|
-
export function getExpiringAndRecoverableVtxos(vtxos,
|
|
106
|
-
return vtxos.filter((vtxo) => isVtxoExpiringSoon(vtxo,
|
|
100
|
+
export function getExpiringAndRecoverableVtxos(vtxos, thresholdMs, dustAmount) {
|
|
101
|
+
return vtxos.filter((vtxo) => isVtxoExpiringSoon(vtxo, thresholdMs) ||
|
|
107
102
|
isRecoverable(vtxo) ||
|
|
108
103
|
isSubdust(vtxo, dustAmount));
|
|
109
104
|
}
|
|
@@ -126,7 +121,7 @@ export function getExpiringAndRecoverableVtxos(vtxos, percentage, dustAmount) {
|
|
|
126
121
|
* // Initialize with renewal config
|
|
127
122
|
* const manager = new VtxoManager(wallet, {
|
|
128
123
|
* enabled: true,
|
|
129
|
-
*
|
|
124
|
+
* thresholdMs: 86400000
|
|
130
125
|
* });
|
|
131
126
|
*
|
|
132
127
|
* // Check recoverable balance
|
|
@@ -246,24 +241,24 @@ export class VtxoManager {
|
|
|
246
241
|
/**
|
|
247
242
|
* Get VTXOs that are expiring soon based on renewal configuration
|
|
248
243
|
*
|
|
249
|
-
* @param
|
|
244
|
+
* @param thresholdMs - Optional override for threshold in milliseconds
|
|
250
245
|
* @returns Array of expiring VTXOs, empty array if renewal is disabled or no VTXOs expiring
|
|
251
246
|
*
|
|
252
247
|
* @example
|
|
253
248
|
* ```typescript
|
|
254
|
-
* const manager = new VtxoManager(wallet, { enabled: true,
|
|
249
|
+
* const manager = new VtxoManager(wallet, { enabled: true, thresholdMs: 86400000 });
|
|
255
250
|
* const expiringVtxos = await manager.getExpiringVtxos();
|
|
256
251
|
* if (expiringVtxos.length > 0) {
|
|
257
252
|
* console.log(`${expiringVtxos.length} VTXOs expiring soon`);
|
|
258
253
|
* }
|
|
259
254
|
* ```
|
|
260
255
|
*/
|
|
261
|
-
async getExpiringVtxos(
|
|
256
|
+
async getExpiringVtxos(thresholdMs) {
|
|
262
257
|
const vtxos = await this.wallet.getVtxos({ withRecoverable: true });
|
|
263
|
-
const
|
|
264
|
-
this.renewalConfig?.
|
|
265
|
-
DEFAULT_RENEWAL_CONFIG.
|
|
266
|
-
return getExpiringAndRecoverableVtxos(vtxos,
|
|
258
|
+
const threshold = thresholdMs ??
|
|
259
|
+
this.renewalConfig?.thresholdMs ??
|
|
260
|
+
DEFAULT_RENEWAL_CONFIG.thresholdMs;
|
|
261
|
+
return getExpiringAndRecoverableVtxos(vtxos, threshold, getDustAmount(this.wallet));
|
|
267
262
|
}
|
|
268
263
|
/**
|
|
269
264
|
* Renew expiring VTXOs by settling them back to the wallet's address
|
package/dist/types/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ import { Wallet, waitForIncomingFunds, IncomingFunds } from "./wallet/wallet";
|
|
|
10
10
|
import { TxTree, TxTreeNode } from "./tree/txTree";
|
|
11
11
|
import { SignerSession, TreeNonces, TreePartialSigs } from "./tree/signingSession";
|
|
12
12
|
import { Ramps } from "./wallet/ramps";
|
|
13
|
-
import { VtxoManager } from "./wallet/vtxo-manager";
|
|
13
|
+
import { isVtxoExpiringSoon, VtxoManager } from "./wallet/vtxo-manager";
|
|
14
14
|
import { ServiceWorkerWallet } from "./wallet/serviceWorker/wallet";
|
|
15
15
|
import { OnchainWallet } from "./wallet/onchain";
|
|
16
16
|
import { setupServiceWorker } from "./wallet/serviceWorker/utils";
|
|
@@ -33,5 +33,5 @@ import { Unroll } from "./wallet/unroll";
|
|
|
33
33
|
import { WalletRepositoryImpl } from "./repositories/walletRepository";
|
|
34
34
|
import { ContractRepositoryImpl } from "./repositories/contractRepository";
|
|
35
35
|
import { ArkError, maybeArkError } from "./providers/errors";
|
|
36
|
-
export { Wallet, SingleKey, OnchainWallet, Ramps, VtxoManager, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs, ArkNote, networks, WalletRepositoryImpl, ContractRepositoryImpl, Intent, TxTree, P2A, Unroll, Transaction, ArkError, maybeArkError, };
|
|
36
|
+
export { Wallet, SingleKey, OnchainWallet, Ramps, VtxoManager, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs, isVtxoExpiringSoon, ArkNote, networks, WalletRepositoryImpl, ContractRepositoryImpl, Intent, TxTree, P2A, Unroll, Transaction, ArkError, maybeArkError, };
|
|
37
37
|
export type { Identity, IWallet, WalletConfig, ProviderClass, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, Recipient, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, IndexerProvider, PageResponse, Batch, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, FeeInfo, ArkInfo, SignedIntent, Output, TxNotification, ExplorerTransaction, BatchFinalizationEvent, BatchFinalizedEvent, BatchFailedEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchStartedEvent, TreeTxEvent, TreeSignatureEvent, ScheduledSession, PaginationOptions, SubscriptionResponse, SubscriptionHeartbeat, SubscriptionEvent, Network, NetworkName, ArkTapscript, RelativeTimelock, EncodedVtxoScript, TapLeafScript, SignerSession, TreeNonces, TreePartialSigs, GetVtxosFilter, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, };
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { ExtendedVirtualCoin, IWallet } from ".";
|
|
2
2
|
import { SettlementEvent } from "../providers/ark";
|
|
3
|
+
export declare const DEFAULT_THRESHOLD_MS: number;
|
|
3
4
|
/**
|
|
4
5
|
* Configuration options for automatic VTXO renewal
|
|
5
6
|
*/
|
|
@@ -10,11 +11,11 @@ export interface RenewalConfig {
|
|
|
10
11
|
*/
|
|
11
12
|
enabled?: boolean;
|
|
12
13
|
/**
|
|
13
|
-
*
|
|
14
|
-
* E.g.,
|
|
15
|
-
* @default
|
|
14
|
+
* Threshold in milliseconds to use as threshold for renewal
|
|
15
|
+
* E.g., 86400000 means renew when 24 hours until expiry remains
|
|
16
|
+
* @default 86400000 (24 hours)
|
|
16
17
|
*/
|
|
17
|
-
|
|
18
|
+
thresholdMs?: number;
|
|
18
19
|
}
|
|
19
20
|
/**
|
|
20
21
|
* Default renewal configuration values
|
|
@@ -27,7 +28,7 @@ export declare const DEFAULT_RENEWAL_CONFIG: Required<Omit<RenewalConfig, "enabl
|
|
|
27
28
|
* @param thresholdMs - Threshold in milliseconds from now
|
|
28
29
|
* @returns true if VTXO expires within threshold, false otherwise
|
|
29
30
|
*/
|
|
30
|
-
export declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin,
|
|
31
|
+
export declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, thresholdMs: number): boolean;
|
|
31
32
|
/**
|
|
32
33
|
* Filter VTXOs that are expiring soon or are recoverable/subdust
|
|
33
34
|
*
|
|
@@ -36,7 +37,7 @@ export declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, percentage
|
|
|
36
37
|
* @param dustAmount - Dust threshold amount in satoshis
|
|
37
38
|
* @returns Array of VTXOs expiring within threshold
|
|
38
39
|
*/
|
|
39
|
-
export declare function getExpiringAndRecoverableVtxos(vtxos: ExtendedVirtualCoin[],
|
|
40
|
+
export declare function getExpiringAndRecoverableVtxos(vtxos: ExtendedVirtualCoin[], thresholdMs: number, dustAmount: bigint): ExtendedVirtualCoin[];
|
|
40
41
|
/**
|
|
41
42
|
* VtxoManager is a unified class for managing VTXO lifecycle operations including
|
|
42
43
|
* recovery of swept/expired VTXOs and renewal to prevent expiration.
|
|
@@ -56,7 +57,7 @@ export declare function getExpiringAndRecoverableVtxos(vtxos: ExtendedVirtualCoi
|
|
|
56
57
|
* // Initialize with renewal config
|
|
57
58
|
* const manager = new VtxoManager(wallet, {
|
|
58
59
|
* enabled: true,
|
|
59
|
-
*
|
|
60
|
+
* thresholdMs: 86400000
|
|
60
61
|
* });
|
|
61
62
|
*
|
|
62
63
|
* // Check recoverable balance
|
|
@@ -137,19 +138,19 @@ export declare class VtxoManager {
|
|
|
137
138
|
/**
|
|
138
139
|
* Get VTXOs that are expiring soon based on renewal configuration
|
|
139
140
|
*
|
|
140
|
-
* @param
|
|
141
|
+
* @param thresholdMs - Optional override for threshold in milliseconds
|
|
141
142
|
* @returns Array of expiring VTXOs, empty array if renewal is disabled or no VTXOs expiring
|
|
142
143
|
*
|
|
143
144
|
* @example
|
|
144
145
|
* ```typescript
|
|
145
|
-
* const manager = new VtxoManager(wallet, { enabled: true,
|
|
146
|
+
* const manager = new VtxoManager(wallet, { enabled: true, thresholdMs: 86400000 });
|
|
146
147
|
* const expiringVtxos = await manager.getExpiringVtxos();
|
|
147
148
|
* if (expiringVtxos.length > 0) {
|
|
148
149
|
* console.log(`${expiringVtxos.length} VTXOs expiring soon`);
|
|
149
150
|
* }
|
|
150
151
|
* ```
|
|
151
152
|
*/
|
|
152
|
-
getExpiringVtxos(
|
|
153
|
+
getExpiringVtxos(thresholdMs?: number): Promise<ExtendedVirtualCoin[]>;
|
|
153
154
|
/**
|
|
154
155
|
* Renew expiring VTXOs by settling them back to the wallet's address
|
|
155
156
|
*
|
|
@@ -71,7 +71,7 @@ export declare class Wallet implements IWallet {
|
|
|
71
71
|
readonly contractRepository: ContractRepository;
|
|
72
72
|
readonly renewalConfig: Required<Omit<WalletConfig["renewalConfig"], "enabled">> & {
|
|
73
73
|
enabled: boolean;
|
|
74
|
-
|
|
74
|
+
thresholdMs: number;
|
|
75
75
|
};
|
|
76
76
|
private constructor();
|
|
77
77
|
static create(config: WalletConfig): Promise<Wallet>;
|