@meshsdk/bitcoin 1.9.0-beta.78 → 1.9.0-beta.79

package/dist/index.cjs

@@ -518,6 +518,9 @@ __export(index_exports, {
     EmbeddedWallet: function() {
         return EmbeddedWallet;
     },
+    MaestroProvider: function() {
+        return MaestroProvider;
+    },
     bip32: function() {
         return bip32;
     },
@@ -4002,6 +4005,589 @@ var BlockstreamProvider = /*#__PURE__*/ function() {
     ]);
     return BlockstreamProvider;
 }();
+// src/providers/maestro.ts
+var MaestroProvider = /*#__PURE__*/ function() {
+    function MaestroProvider(param) {
+        var network = param.network, apiKey = param.apiKey;
+        _class_call_check(this, MaestroProvider);
+        this._axiosInstance = axios_default.create({
+            baseURL: "https://xbt-".concat(network, ".gomaestro-api.org/v0"),
+            headers: {
+                "api-key": apiKey
+            }
+        });
+        this._network = network;
+    }
+    _create_class(MaestroProvider, [
+        {
+            key: "fetchScript",
+            value: /**
+   * Get information about a script hash.
+   * @param hash - The script hash.
+   * @returns ScriptInfo
+   * @note Maestro does not have any endpoint available for this yet
+   */ function fetchScript(hash) {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        throw new Error("fetchScript is not implemented - Maestro does not have any endpoint available for this yet");
+                    });
+                })();
+            }
+        },
+        {
+            key: "fetchScriptTransactions",
+            value: /**
+   * Get transaction history for the specified script hash, sorted with newest first.
+   * @param hash - The script hash.
+   * @param last_seen_txid - The last seen transaction ID (optional).
+   * @returns TransactionsInfo[]
+   * @note Maestro does not have any endpoint available for this yet
+   */ function fetchScriptTransactions(hash, last_seen_txid) {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        throw new Error("fetchScriptTransactions is not implemented - Maestro does not have any endpoint available for this yet");
+                    });
+                })();
+            }
+        },
+        {
+            key: "fetchScriptUTxOs",
+            value: /**
+   * Get the list of unspent transaction outputs associated with the script hash.
+   * @param hash - The script hash.
+   * @returns UTxO[]
+   * @note Maestro does not have any endpoint available for this yet
+   */ function fetchScriptUTxOs(hash) {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        throw new Error("fetchScriptUTxOs is not implemented - Maestro does not have any endpoint available for this yet");
+                    });
+                })();
+            }
+        },
+        {
+            key: "fetchAddress",
+            value: /**
+   * Get information about an address.
+   * @param address - The address.
+   * @returns AddressInfo
+   */ function fetchAddress(address) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/esplora/address/".concat(address))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchAddressTransactions",
+            value: /**
+   * Get transaction history for the specified address, sorted with newest first.
+   * Returns up to 50 mempool transactions plus the first 25 confirmed transactions. You can request more confirmed transactions using `last_seen_txid`.
+   * @param address - The address.
+   * @param last_seen_txid - The last seen transaction ID (optional).
+   * @returns TransactionsInfo[]
+   */ function fetchAddressTransactions(address, last_seen_txid) {
+                return _async_to_generator(function() {
+                    var url, _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                url = last_seen_txid ? "/esplora/address/".concat(address, "/txs/chain/").concat(last_seen_txid) : "/esplora/address/".concat(address, "/txs");
+                                return [
+                                    4,
+                                    this._axiosInstance.get(url)
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchAddressUTxOs",
+            value: /**
+   * Get the list of unspent transaction outputs associated with the address.
+   * @param address - The address.
+   * @returns UTxO[]
+   */ function fetchAddressUTxOs(address) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/esplora/address/".concat(address, "/utxo"))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchTransactionStatus",
+            value: /**
+   * Get the spending status of a transaction output.
+   * @param txid - The transaction ID.
+   * @returns TransactionsStatus
+   */ function fetchTransactionStatus(txid) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/esplora/tx/".concat(txid, "/status"))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "submitTx",
+            value: /**
+   * Broadcast a raw transaction to the network.
+   * @param txHex - The raw transaction in hexadecimal format.
+   * @returns The transaction ID.
+   */ function submitTx(txHex) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.post("/esplora/tx", txHex, {
+                                        headers: {
+                                            "Content-Type": "application/json"
+                                        }
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data.txid || data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchFeeEstimates",
+            value: // Additional Bitcoin-specific methods (beyond IBitcoinProvider)
+            /**
+   * Get fee estimates for Bitcoin transactions.
+   * @param blocks - The number of blocks to estimate fees for (default: 6).
+   * @returns FeeEstimateResponse containing the estimated fee rate.
+   */ function fetchFeeEstimates() {
+                var blocks = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : 6;
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/rpc/transaction/estimatefee/".concat(blocks))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchSatoshiActivity",
+            value: /**
+   * Fetch satoshi activity for a Bitcoin address (transaction history).
+   * @param address - The Bitcoin address.
+   * @param options - Optional parameters for filtering and pagination.
+   * @param options.order - Sort order ('asc' or 'desc').
+   * @param options.count - Maximum number of results to return.
+   * @param options.from - Start block height.
+   * @param options.to - End block height.
+   * @param options.cursor - Pagination cursor.
+   * @returns SatoshiActivityResponse containing transaction activity data.
+   */ function fetchSatoshiActivity(_0) {
+                return _async_to_generator(function(address) {
+                    var options, params, queryString, url, _ref, data, status, error;
+                    var _arguments = arguments;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                options = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : {};
+                                params = new URLSearchParams();
+                                Object.entries(options).forEach(function(param) {
+                                    var _param = _sliced_to_array(param, 2), key = _param[0], value = _param[1];
+                                    if (value !== void 0 && value !== null) {
+                                        params.append(key, value.toString());
+                                    }
+                                });
+                                queryString = params.toString();
+                                url = "/addresses/".concat(address, "/activity").concat(queryString ? "?".concat(queryString) : "");
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get(url)
+                                ];
+                            case 2:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 3:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).apply(this, arguments);
+            }
+        },
+        {
+            key: "fetchTxInfo",
+            value: /**
+   * Get transaction details by hash.
+   * @param hash - The transaction hash.
+   * @returns TransactionsInfo containing transaction details.
+   */ function fetchTxInfo(hash) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/esplora/tx/".concat(hash))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetchAddressBalance",
+            value: /**
+   * Get address balance (raw response).
+   * @param address - The Bitcoin address.
+   * @returns BalanceResponse containing the raw balance data.
+   */ function fetchAddressBalance(address) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get("/addresses/".concat(address, "/balance"))
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "getBalance",
+            value: /**
+   * Get balance for a Bitcoin address (convenience method).
+   * @param address - The Bitcoin address.
+   * @returns The balance as a bigint in satoshis.
+   */ function getBalance(address) {
+                return _async_to_generator(function() {
+                    var balanceResponse;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    this.fetchAddressBalance(address)
+                                ];
+                            case 1:
+                                balanceResponse = _state.sent();
+                                return [
+                                    2,
+                                    BigInt(balanceResponse.data)
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "get",
+            value: /**
+   * Generic GET request for Bitcoin API endpoints.
+   * @param url - The API endpoint URL.
+   * @returns The response data.
+   */ function get(url) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.get(url)
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "post",
+            value: /**
+   * Generic POST request for Bitcoin API endpoints.
+   * @param url - The API endpoint URL.
+   * @param body - The request body data.
+   * @returns The response data.
+   */ function post(url, body) {
+                return _async_to_generator(function() {
+                    var _ref, data, status, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _state.trys.push([
+                                    0,
+                                    2,
+                                    ,
+                                    3
+                                ]);
+                                return [
+                                    4,
+                                    this._axiosInstance.post(url, body, {
+                                        headers: {
+                                            "Content-Type": "application/json"
+                                        }
+                                    })
+                                ];
+                            case 1:
+                                _ref = _state.sent(), data = _ref.data, status = _ref.status;
+                                if (status === 200) return [
+                                    2,
+                                    data
+                                ];
+                                throw parseHttpError(data);
+                            case 2:
+                                error = _state.sent();
+                                throw parseHttpError(error);
+                            case 3:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            /**
+   * Get the network this provider is configured for.
+   * @returns The network configuration (mainnet or testnet).
+   */ key: "getNetwork",
+            value: function getNetwork() {
+                return this._network;
+            }
+        }
+    ]);
+    return MaestroProvider;
+}();
 // src/utils/address.ts
 function resolveAddress(publicKey, network) {
     var p2wpkh = bitcoin.payments.p2wpkh({