@xchainjs/xchain-utxo-providers 2.0.17 → 2.1.0

package/lib/index.js

@@ -62,7 +62,7 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTx$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, hash }) {
+const getTx$4 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, hash }) {
     const url = `${sochainUrl}/transaction/${network}/${hash}`;
     const response = yield axios__default.default.get(url, { headers: { 'API-KEY': apiKey } });
     const tx = response.data;
@@ -78,7 +78,7 @@ const getTx$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, soc
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTxs$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, sochainUrl, network, page, }) {
+const getTxs$4 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, sochainUrl, network, page, }) {
     const url = `${sochainUrl}/transactions/${network}/${address}/${page}`; //TODO support paging
     const response = yield axios__default.default.get(url, { headers: { 'API-KEY': apiKey } });
     const txs = response.data;
@@ -95,7 +95,7 @@ const getTxs$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, ad
  * @param {boolean} confirmedOnly Flag whether to get balances of confirmed txs only or for all
  * @returns {number}
  */
-const getBalance$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, address, confirmedOnly, assetDecimals, }) {
+const getBalance$4 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, address, confirmedOnly, assetDecimals, }) {
     const url = `${sochainUrl}/balance/${network}/${address}`;
     const response = yield axios__default.default.get(url, { headers: { 'API-KEY': apiKey } });
     const balanceResponse = response.data;
@@ -146,7 +146,7 @@ const getUnspentTxs$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ api
  * @param {boolean} confirmedOnly Flag whether to get balances of confirmed txs only or for all
  * @returns {number}
  */
-const broadcastTx$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, txHex, }) {
+const broadcastTx$4 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, sochainUrl, network, txHex, }) {
     const url = `${sochainUrl}/broadcast_transaction/${network}`;
     const response = yield axios__default.default.post(url, { tx_hex: txHex }, { headers: { 'API-KEY': apiKey } });
     const broadcastResponse = response.data;
@@ -170,7 +170,7 @@ class SochainProvider {
     }
     broadcastTx(txHex) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield broadcastTx$3({
+            return yield broadcastTx$4({
                 apiKey: this._apiKey,
                 sochainUrl: this.baseUrl,
                 network: this.sochainNetwork,
@@ -206,7 +206,7 @@ class SochainProvider {
     getBalance(address, confirmedOnly) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const amount = yield getBalance$3({
+                const amount = yield getBalance$4({
                     apiKey: this._apiKey,
                     sochainUrl: this.baseUrl,
                     network: this.sochainNetwork,
@@ -242,7 +242,7 @@ class SochainProvider {
             let page = firstPage;
             try {
                 while (page <= lastPage) {
-                    const response = yield getTxs$3({
+                    const response = yield getTxs$4({
                         apiKey: this._apiKey,
                         sochainUrl: this.baseUrl,
                         network: this.sochainNetwork,
@@ -284,7 +284,7 @@ class SochainProvider {
     getTransactionData(txId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const rawTx = yield getTx$3({
+                const rawTx = yield getTx$4({
                     apiKey: this._apiKey,
                     sochainUrl: this.baseUrl,
                     network: this.sochainNetwork,
@@ -411,7 +411,7 @@ const getAddress = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinU
  *
  * @throws {"failed to query transaction by a given hash"} thrown if failed to query transaction by a given hash
  */
-const getTx$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinUrl, txId, network }) {
+const getTx$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinUrl, txId, network }) {
     const result = (yield axios__default.default.get(`${haskoinUrl}/${network}/transaction/${txId}`)).data;
     if (!result || isErrorResponse(result))
         throw new Error(`failed to query transaction by a given hash ${txId}`);
@@ -443,7 +443,7 @@ const getRawTransaction = (_a) => __awaiter(void 0, [_a], void 0, function* ({ h
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTxs$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ address, haskoinUrl, network, limit, offset, }) {
+const getTxs$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ address, haskoinUrl, network, limit, offset, }) {
     const params = { limit: `${limit}`, offset: `${offset}` };
     const url = `${haskoinUrl}/${network}/address/${address}/transactions/full`;
     const result = (yield axios__default.default.get(url, { params })).data;
@@ -456,7 +456,7 @@ const getTxs$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ address, h
  * @param param
  * @returns Returns BaseAmount
  */
-const getBalance$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinUrl, haskoinNetwork, address, confirmedOnly, assetDecimals, }) {
+const getBalance$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinUrl, haskoinNetwork, address, confirmedOnly, assetDecimals, }) {
     const { data: { confirmed, unconfirmed }, } = yield axios__default.default.get(`${haskoinUrl}/${haskoinNetwork}/address/${address}/balance`);
     const confirmedAmount = xchainUtil.baseAmount(confirmed, assetDecimals);
     const unconfirmedAmount = xchainUtil.baseAmount(unconfirmed, assetDecimals);
@@ -489,7 +489,7 @@ const getUnspentTxs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ hasko
  * @returns {TxConfirmedStatus}
  */
 const getIsTxConfirmed = (_a) => __awaiter(void 0, [_a], void 0, function* ({ haskoinUrl, network, txId }) {
-    const tx = yield getTx$2({ haskoinUrl, network, txId });
+    const tx = yield getTx$3({ haskoinUrl, network, txId });
     return {
         network: network,
         txid: txId,
@@ -599,7 +599,7 @@ const getUnspentTransactions = (_a) => __awaiter(void 0, [_a], void 0, function*
  * @param {BroadcastTxParams} params
  * @returns {TxHash} Transaction hash.
  */
-const broadcastTx$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ txHex, haskoinUrl, haskoinNetwork, }) {
+const broadcastTx$3 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ txHex, haskoinUrl, haskoinNetwork, }) {
     var _b;
     const MAX_RETRIES = 5;
     let retries = 0;
@@ -635,7 +635,7 @@ class HaskoinProvider {
     }
     broadcastTx(txHex) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield broadcastTx$2({
+            return yield broadcastTx$3({
                 haskoinUrl: this.baseUrl,
                 haskoinNetwork: this.haskoinNetwork,
                 txHex,
@@ -665,7 +665,7 @@ class HaskoinProvider {
     }
     getBalance(address, confirmedOnly) {
         return __awaiter(this, void 0, void 0, function* () {
-            const amount = yield getBalance$2({
+            const amount = yield getBalance$3({
                 haskoinUrl: this.baseUrl,
                 haskoinNetwork: this.haskoinNetwork,
                 address,
@@ -691,7 +691,7 @@ class HaskoinProvider {
                 throw Error('cannot fetch more than last 2000 txs');
             if (offset < 0 || limit < 0)
                 throw Error('ofset and limit must be equal or greater than 0');
-            const response = yield getTxs$2({
+            const response = yield getTxs$3({
                 address: `${params === null || params === void 0 ? void 0 : params.address}`,
                 haskoinUrl: this.baseUrl,
                 network: this.haskoinNetwork,
@@ -730,7 +730,7 @@ class HaskoinProvider {
     getTransactionData(txId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const rawTx = yield getTx$2({
+                const rawTx = yield getTx$3({
                     haskoinUrl: this.baseUrl,
                     network: this.haskoinNetwork,
                     txId: txId,
@@ -781,7 +781,7 @@ class HaskoinProvider {
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTx$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, hash, limit = 20 }) {
+const getTx$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, hash, limit = 20 }) {
     const params = { includeHex: 'true', limit: limit.toString() };
     if (apiKey)
         params['token'] = apiKey;
@@ -799,7 +799,7 @@ const getTx$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, bas
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTxs$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, network, beforeBlock, limit, unspentOnly, }) {
+const getTxs$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, network, beforeBlock, limit, unspentOnly, }) {
     const params = { limit: `${limit}`, unspentOnly: `${unspentOnly}` };
     const url = `${baseUrl}/${network}/addrs/${address}`;
     if (apiKey)
@@ -820,7 +820,7 @@ const getTxs$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, ad
  * @param {boolean} confirmedOnly Flag whether to get balances of confirmed txs only or for all
  * @returns {number}
  */
-const getBalance$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, address, confirmedOnly, assetDecimals, }) {
+const getBalance$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, address, confirmedOnly, assetDecimals, }) {
     const params = {};
     const url = `${baseUrl}/${network}/addrs/${address}/balance`;
     if (apiKey)
@@ -831,7 +831,7 @@ const getBalance$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey
     const finalBalance = xchainUtil.baseAmount(balanceResponse.final_balance, assetDecimals);
     return confirmedOnly ? confirmedAmount : finalBalance;
 });
-const broadcastTx$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, txHex, }) {
+const broadcastTx$2 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, network, txHex, }) {
     const params = {};
     const url = `${baseUrl}/${network}/txs/push`;
     if (apiKey)
@@ -871,7 +871,7 @@ class BlockcypherProvider {
     }
     broadcastTx(txHex) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield broadcastTx$1({
+            return yield broadcastTx$2({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 network: this.blockcypherNetwork,
@@ -893,7 +893,7 @@ class BlockcypherProvider {
     }
     getBalance(address, confirmedOnly) {
         return __awaiter(this, void 0, void 0, function* () {
-            const amount = yield getBalance$1({
+            const amount = yield getBalance$2({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 network: this.blockcypherNetwork,
@@ -931,7 +931,7 @@ class BlockcypherProvider {
     getTransactionData(txId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const rawTx = yield getTx$1({
+                const rawTx = yield getTx$2({
                     apiKey: this._apiKey,
                     baseUrl: this.baseUrl,
                     network: this.blockcypherNetwork,
@@ -1036,7 +1036,7 @@ class BlockcypherProvider {
                 throw Error('ofset and limit must be equal or greater than 0');
             const txHashesToFetch = [];
             try {
-                const response = yield getTxs$1({
+                const response = yield getTxs$2({
                     apiKey: this._apiKey,
                     baseUrl: this.baseUrl,
                     network: this.blockcypherNetwork,
@@ -1069,7 +1069,7 @@ class BlockcypherProvider {
                 .useCorrespondingResults()
                 .process((hash) => __awaiter(this, void 0, void 0, function* () {
                 yield this.delay(1000);
-                const rawTx = yield getTx$1({
+                const rawTx = yield getTx$2({
                     apiKey: this._apiKey,
                     baseUrl: this.baseUrl,
                     network: this.blockcypherNetwork,
@@ -1098,7 +1098,7 @@ exports.BlockcypherNetwork = void 0;
  * @param {GetFeeEstimateRequest} request Get fee estimate params
  * @returns {GetFeeEstimateResponse} Get fee estimate response
  */
-const getFeeEstimate = (baseUrl, request) => __awaiter(void 0, void 0, void 0, function* () {
+const getFeeEstimate$1 = (baseUrl, request) => __awaiter(void 0, void 0, void 0, function* () {
     const response = yield axios__default.default.get(`${baseUrl}/tx/fee`, { params: request });
     return response.data;
 });
@@ -1115,7 +1115,7 @@ class BitgoProvider {
     getFeeRates() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
-            const gasFeeEstimateResponse = yield getFeeEstimate(`${this.baseUrl}/api/v2/${this.blockchainId}`, {
+            const gasFeeEstimateResponse = yield getFeeEstimate$1(`${this.baseUrl}/api/v2/${this.blockchainId}`, {
                 numBlocks: 2,
             });
             const fastestRate = gasFeeEstimateResponse.feePerKb / 1000;
@@ -1176,7 +1176,7 @@ class BitgoProvider {
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, hash }) {
+const getTx$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, hash }) {
     const url = `${baseUrl}/tx/${hash}`;
     const response = yield axios__default.default.get(url, {
         headers: {
@@ -1194,7 +1194,7 @@ const getTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseU
  * @param {string} hash The transaction hash.
  * @returns {Transactions}
  */
-const getTxs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, limit, }) {
+const getTxs$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, limit, }) {
     const url = `${baseUrl}/address/${address}`;
     const response = yield axios__default.default.get(url, {
         params: {
@@ -1215,7 +1215,7 @@ const getTxs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, addr
  * @param {string} address address.
  * @returns {Transactions}
  */
-const getUTXOs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, isConfirmed = true, }) {
+const getUTXOs$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, isConfirmed = true, }) {
     const url = `${baseUrl}/utxo/${address}`;
     const response = yield axios__default.default.get(url, {
         params: {
@@ -1237,7 +1237,7 @@ const getUTXOs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, ad
  * @param {boolean} confirmedOnly Flag whether to get balances of confirmed txs only or for all
  * @returns {number}
  */
-const getBalance = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, address, confirmedOnly = true, assetDecimals, }) {
+const getBalance$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, address, confirmedOnly = true, assetDecimals, }) {
     const url = `${baseUrl}/address/${address}`;
     const response = yield axios__default.default.get(url, {
         headers: {
@@ -1275,7 +1275,7 @@ const getConsensusBranchId = (_a) => __awaiter(void 0, [_a], void 0, function* (
         return undefined;
     return parseInt(nextblock, 16);
 });
-const broadcastTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, txHex, }) {
+const broadcastTx$1 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, txHex, }) {
     const url = `${baseUrl}/sendtx/${txHex}`;
     const response = yield axios__default.default.get(url, {
         headers: {
@@ -1303,7 +1303,7 @@ class NownodesProvider {
     }
     broadcastTx(txHex) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield broadcastTx({
+            return yield broadcastTx$1({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 txHex,
@@ -1312,7 +1312,7 @@ class NownodesProvider {
     }
     getConfirmedUnspentTxs(address) {
         return __awaiter(this, void 0, void 0, function* () {
-            const allUnspent = yield getUTXOs({
+            const allUnspent = yield getUTXOs$1({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 address: address,
@@ -1323,7 +1323,7 @@ class NownodesProvider {
     }
     getUnspentTxs(address) {
         return __awaiter(this, void 0, void 0, function* () {
-            const allUnspent = yield getUTXOs({
+            const allUnspent = yield getUTXOs$1({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 address: address,
@@ -1334,7 +1334,7 @@ class NownodesProvider {
     }
     getBalance(address, confirmedOnly) {
         return __awaiter(this, void 0, void 0, function* () {
-            const amount = yield getBalance({
+            const amount = yield getBalance$1({
                 apiKey: this._apiKey,
                 baseUrl: this.baseUrl,
                 address,
@@ -1358,7 +1358,7 @@ class NownodesProvider {
     getTransactionData(txId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const rawTx = yield getTx({
+                const rawTx = yield getTx$1({
                     apiKey: this._apiKey,
                     baseUrl: this.baseUrl,
                     hash: txId,
@@ -1430,7 +1430,7 @@ class NownodesProvider {
             if (offset < 0 || limit < 0)
                 throw Error('ofset and limit must be equal or greater than 0');
             try {
-                const transactions = yield getTxs({
+                const transactions = yield getTxs$1({
                     apiKey: this._apiKey,
                     baseUrl: this.baseUrl,
                     address: `${params === null || params === void 0 ? void 0 : params.address}`,
@@ -1445,18 +1445,267 @@ class NownodesProvider {
     }
 }
 
+const makeHeaders = (apiKey) => (apiKey ? { 'api-key': apiKey } : {});
+const encodeAddressPathSegment = (address) => encodeURIComponent(address);
+const getTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, hash }) {
+    const url = `${baseUrl}/tx/${hash}`;
+    const response = yield axios__default.default.get(url, { headers: makeHeaders(apiKey) });
+    return response.data;
+});
+const getTxs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, limit, }) {
+    var _b;
+    const url = `${baseUrl}/address/${encodeAddressPathSegment(address)}`;
+    const response = yield axios__default.default.get(url, {
+        params: { details: 'txs', pageSize: limit },
+        headers: makeHeaders(apiKey),
+    });
+    const info = response.data;
+    return { transactions: (_b = info.transactions) !== null && _b !== void 0 ? _b : [], total: info.txs };
+});
+const getUTXOs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, address, baseUrl, isConfirmed = true, }) {
+    const url = `${baseUrl}/utxo/${encodeAddressPathSegment(address)}`;
+    const response = yield axios__default.default.get(url, {
+        params: { confirmed: isConfirmed },
+        headers: makeHeaders(apiKey),
+    });
+    return response.data;
+});
+const getBalance = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, address, confirmedOnly = true, assetDecimals, }) {
+    const url = `${baseUrl}/address/${encodeAddressPathSegment(address)}`;
+    const response = yield axios__default.default.get(url, { params: { details: 'tokenBalances' }, headers: makeHeaders(apiKey) });
+    const info = response.data;
+    return confirmedOnly
+        ? xchainUtil.baseAmount(info.balance, assetDecimals)
+        : xchainUtil.baseAmount(info.balance, assetDecimals).plus(xchainUtil.baseAmount(info.unconfirmedBalance, assetDecimals));
+});
+const broadcastTx = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, txHex, }) {
+    const url = `${baseUrl}/sendtx/`;
+    const response = yield axios__default.default.post(url, txHex, {
+        headers: Object.assign(Object.assign({}, makeHeaders(apiKey)), { 'Content-Type': 'text/plain' }),
+    });
+    return response.data.result;
+});
+/**
+ * Fetches fee estimate using Blockbook's V2 REST endpoint.
+ *
+ * Docs: https://github.com/trezor/blockbook/blob/master/docs/api.md
+ *
+ * @param numberOfBlocks Target block confirmation count
+ * @returns Estimated fee rate in sat/byte
+ */
+const getFeeEstimate = (_a) => __awaiter(void 0, [_a], void 0, function* ({ apiKey, baseUrl, numberOfBlocks, }) {
+    const url = `${baseUrl}/estimatefee/${numberOfBlocks}`;
+    const response = yield axios__default.default.get(url, { headers: makeHeaders(apiKey) });
+    const dto = response.data;
+    // result is in BTC/kB; convert to sat/byte
+    const btcPerKb = parseFloat(dto.result);
+    if (isNaN(btcPerKb) || btcPerKb <= 0) {
+        throw new Error(`BlockbookProvider: invalid fee estimate: ${dto.result}`);
+    }
+    return (btcPerKb * 1e8) / 1000;
+});
+
+class BlockbookProvider {
+    constructor(baseUrl, asset, assetDecimals, options) {
+        this.baseUrl = baseUrl;
+        this._apiKey = options === null || options === void 0 ? void 0 : options.apiKey;
+        this.asset = asset;
+        this.assetDecimals = assetDecimals;
+        this.normalizeAddressForApi = options === null || options === void 0 ? void 0 : options.normalizeAddressForApi;
+    }
+    toApiAddress(address) {
+        return this.normalizeAddressForApi ? this.normalizeAddressForApi(address) : address;
+    }
+    get apiKey() {
+        return this._apiKey;
+    }
+    set apiKey(value) {
+        this._apiKey = value;
+    }
+    broadcastTx(txHex) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield broadcastTx({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                txHex,
+            });
+        });
+    }
+    getConfirmedUnspentTxs(address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const addr = this.toApiAddress(address);
+            const utxos = yield getUTXOs({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                address: addr,
+                isConfirmed: true,
+            });
+            return yield this.mapUTXOs(utxos);
+        });
+    }
+    getUnspentTxs(address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const addr = this.toApiAddress(address);
+            const utxos = yield getUTXOs({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                address: addr,
+                isConfirmed: false,
+            });
+            return yield this.mapUTXOs(utxos);
+        });
+    }
+    getBalance(address, confirmedOnly) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const addr = this.toApiAddress(address);
+            const amount = yield getBalance({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                address: addr,
+                confirmedOnly: confirmedOnly !== undefined ? confirmedOnly : true,
+                assetDecimals: this.assetDecimals,
+            });
+            return [{ amount, asset: this.asset }];
+        });
+    }
+    getTransactions(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { transactions: rawTxs, total } = yield this.getRawTransactions(params);
+            const txs = rawTxs.map((tx) => this.mapTransactionToTx(tx));
+            return { total, txs };
+        });
+    }
+    getTransactionData(txId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const rawTx = yield getTx({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                hash: txId,
+            });
+            return this.mapTransactionToTx(rawTx);
+        });
+    }
+    getFeeRate(feeOption) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return getFeeEstimate({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                numberOfBlocks: BlockbookProvider.BLOCK_TARGETS[feeOption],
+            });
+        });
+    }
+    getFeeRates() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const [average, fast, fastest] = yield Promise.all([
+                this.getFeeRate(xchainClient.FeeOption.Average),
+                this.getFeeRate(xchainClient.FeeOption.Fast),
+                this.getFeeRate(xchainClient.FeeOption.Fastest),
+            ]);
+            return {
+                [xchainClient.FeeOption.Average]: average,
+                [xchainClient.FeeOption.Fast]: fast,
+                [xchainClient.FeeOption.Fastest]: fastest,
+            };
+        });
+    }
+    mapTransactionToTx(rawTx) {
+        return {
+            asset: this.asset,
+            from: rawTx.vin
+                .filter((i) => { var _a; return i.isAddress && ((_a = i.addresses) === null || _a === void 0 ? void 0 : _a.length) > 0; })
+                .map((i) => ({
+                from: i.addresses[0],
+                amount: xchainUtil.baseAmount(i.value, this.assetDecimals),
+            })),
+            to: rawTx.vout
+                .filter((i) => { var _a; return i.isAddress && ((_a = i.addresses) === null || _a === void 0 ? void 0 : _a.length) > 0; })
+                .map((i) => ({ to: i.addresses[0], amount: xchainUtil.baseAmount(i.value, this.assetDecimals) })),
+            date: rawTx.blockTime ? new Date(rawTx.blockTime * 1000) : new Date(0),
+            type: xchainClient.TxType.Transfer,
+            hash: rawTx.txid,
+        };
+    }
+    mapUTXOs(utxos) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = [];
+            const txCache = new Map();
+            for (const utxo of utxos) {
+                let tx = txCache.get(utxo.txid);
+                if (!tx) {
+                    // Rate-limit: pause between consecutive fetches to avoid overwhelming the node
+                    if (txCache.size > 0)
+                        yield new Promise((resolve) => setTimeout(resolve, 50));
+                    tx = yield getTx({
+                        apiKey: this._apiKey,
+                        baseUrl: this.baseUrl,
+                        hash: utxo.txid,
+                    });
+                    txCache.set(utxo.txid, tx);
+                }
+                const output = tx.vout.find((vout) => vout.n === utxo.vout);
+                if (!(output === null || output === void 0 ? void 0 : output.hex)) {
+                    throw Error(`BlockbookProvider: could not resolve scriptPubKey for UTXO ${utxo.txid}:${utxo.vout}`);
+                }
+                const value = Number(utxo.value);
+                result.push({
+                    hash: utxo.txid,
+                    index: utxo.vout,
+                    value,
+                    witnessUtxo: {
+                        value,
+                        script: Buffer.from(output.hex, 'hex'),
+                    },
+                    txHex: tx.hex,
+                });
+            }
+            return result;
+        });
+    }
+    getRawTransactions(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (params === null || params === void 0 ? void 0 : params.startTime) {
+                throw Error('BlockbookProvider: startTime is not supported');
+            }
+            const offset = (_a = params === null || params === void 0 ? void 0 : params.offset) !== null && _a !== void 0 ? _a : 0;
+            const limit = (params === null || params === void 0 ? void 0 : params.limit) || 10;
+            if (offset + limit > 1000)
+                throw Error('BlockbookProvider: cannot fetch more than the last 1000 txs');
+            if (offset < 0 || limit < 0)
+                throw Error('BlockbookProvider: offset and limit must be >= 0');
+            const address = params === null || params === void 0 ? void 0 : params.address;
+            if (!address)
+                throw Error('BlockbookProvider: address is required');
+            const addr = this.toApiAddress(address);
+            const { transactions, total } = yield getTxs({
+                apiKey: this._apiKey,
+                baseUrl: this.baseUrl,
+                address: addr,
+                limit: offset + limit,
+            });
+            return { transactions: transactions.slice(offset, offset + limit), total };
+        });
+    }
+}
+BlockbookProvider.BLOCK_TARGETS = {
+    [xchainClient.FeeOption.Average]: 5,
+    [xchainClient.FeeOption.Fast]: 3,
+    [xchainClient.FeeOption.Fastest]: 1,
+};
+
 exports.BitgoProvider = BitgoProvider;
+exports.BlockbookProvider = BlockbookProvider;
 exports.BlockcypherProvider = BlockcypherProvider;
 exports.HaskoinProvider = HaskoinProvider;
 exports.NownodesProvider = NownodesProvider;
 exports.SochainProvider = SochainProvider;
-exports.broadcastTx = broadcastTx$2;
+exports.broadcastTx = broadcastTx$3;
 exports.getAccount = getAccount;
 exports.getAddress = getAddress;
-exports.getBalance = getBalance$2;
+exports.getBalance = getBalance$3;
 exports.getConfirmedTxStatus = getConfirmedTxStatus;
 exports.getConfirmedUnspentTxs = getConfirmedUnspentTxs;
 exports.getIsTxConfirmed = getIsTxConfirmed;
-exports.getTx = getTx$2;
-exports.getTxs = getTxs$2;
+exports.getTx = getTx$3;
+exports.getTxs = getTxs$3;
 exports.getUnspentTxs = getUnspentTxs;

package/lib/providers/blockbook/blockbook-api-types.d.ts

@@ -0,0 +1,73 @@
+import { TxHash } from '@xchainjs/xchain-client';
+export type BalanceParams = {
+    apiKey?: string;
+    baseUrl: string;
+    address: string;
+    confirmedOnly: boolean;
+    assetDecimals: number;
+};
+export type TxHashParams = {
+    apiKey?: string;
+    baseUrl: string;
+    hash: TxHash;
+};
+export interface TxInput {
+    txid: string;
+    vout?: number;
+    n: number;
+    sequence: number;
+    addresses: string[];
+    isAddress: boolean;
+    value: string;
+    hex: string;
+}
+export interface TxOutput {
+    value: string;
+    n: number;
+    spent?: boolean;
+    hex: string;
+    addresses: string[];
+    isAddress: boolean;
+}
+export interface Transaction {
+    txid: string;
+    version: number;
+    vin: TxInput[];
+    vout: TxOutput[];
+    blockHash: string;
+    blockHeight: number;
+    confirmations: number;
+    blockTime: number;
+    size: number;
+    value: string;
+    valueIn: string;
+    fees: string;
+    hex: string;
+}
+export type AddressUTXO = {
+    txid: string;
+    vout: number;
+    value: string;
+    height: number;
+    confirmations: number;
+};
+export type GetAddressInfo = {
+    page: number;
+    totalPages: number;
+    itemsOnPage: number;
+    address: string;
+    balance: string;
+    totalReceived: string;
+    totalSent: string;
+    unconfirmedBalance: string;
+    unconfirmedTxs: number;
+    txs: number;
+    txids?: string[];
+    transactions?: Transaction[];
+};
+export type BroadcastDTO = {
+    result: string;
+};
+export type FeeEstimateDTO = {
+    result: string;
+};