145 lines
5.3 KiB
JavaScript
145 lines
5.3 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.BlockscoutProvider = void 0;
|
|
/**
|
|
* [[link-blockscout]] provides a third-party service for connecting to
|
|
* various blockchains over JSON-RPC.
|
|
*
|
|
* **Supported Networks**
|
|
*
|
|
* - Ethereum Mainnet (``mainnet``)
|
|
* - Sepolia Testnet (``sepolia``)
|
|
* - Holesky Testnet (``holesky``)
|
|
* - Ethereum Classic (``classic``)
|
|
* - Arbitrum (``arbitrum``)
|
|
* - Base (``base``)
|
|
* - Base Sepolia Testnet (``base-sepolia``)
|
|
* - Gnosis (``xdai``)
|
|
* - Optimism (``optimism``)
|
|
* - Optimism Sepolia Testnet (``optimism-sepolia``)
|
|
* - Polygon (``matic``)
|
|
*
|
|
* @_subsection: api/providers/thirdparty:Blockscout [providers-blockscout]
|
|
*/
|
|
const index_js_1 = require("../utils/index.js");
|
|
const network_js_1 = require("./network.js");
|
|
const provider_jsonrpc_js_1 = require("./provider-jsonrpc.js");
|
|
function getUrl(name) {
|
|
switch (name) {
|
|
case "mainnet":
|
|
return "https:/\/eth.blockscout.com/api/eth-rpc";
|
|
case "sepolia":
|
|
return "https:/\/eth-sepolia.blockscout.com/api/eth-rpc";
|
|
case "holesky":
|
|
return "https:/\/eth-holesky.blockscout.com/api/eth-rpc";
|
|
case "classic":
|
|
return "https:/\/etc.blockscout.com/api/eth-rpc";
|
|
case "arbitrum":
|
|
return "https:/\/arbitrum.blockscout.com/api/eth-rpc";
|
|
case "base":
|
|
return "https:/\/base.blockscout.com/api/eth-rpc";
|
|
case "base-sepolia":
|
|
return "https:/\/base-sepolia.blockscout.com/api/eth-rpc";
|
|
case "matic":
|
|
return "https:/\/polygon.blockscout.com/api/eth-rpc";
|
|
case "optimism":
|
|
return "https:/\/optimism.blockscout.com/api/eth-rpc";
|
|
case "optimism-sepolia":
|
|
return "https:/\/optimism-sepolia.blockscout.com/api/eth-rpc";
|
|
case "xdai":
|
|
return "https:/\/gnosis.blockscout.com/api/eth-rpc";
|
|
}
|
|
(0, index_js_1.assertArgument)(false, "unsupported network", "network", name);
|
|
}
|
|
/**
|
|
* The **BlockscoutProvider** connects to the [[link-blockscout]]
|
|
* JSON-RPC end-points.
|
|
*
|
|
* By default, a highly-throttled API key is used, which is
|
|
* appropriate for quick prototypes and simple scripts. To
|
|
* gain access to an increased rate-limit, it is highly
|
|
* recommended to [sign up here](link-blockscout).
|
|
*/
|
|
class BlockscoutProvider extends provider_jsonrpc_js_1.JsonRpcProvider {
|
|
/**
|
|
* The API key.
|
|
*/
|
|
apiKey;
|
|
/**
|
|
* Creates a new **BlockscoutProvider**.
|
|
*/
|
|
constructor(_network, apiKey) {
|
|
if (_network == null) {
|
|
_network = "mainnet";
|
|
}
|
|
const network = network_js_1.Network.from(_network);
|
|
if (apiKey == null) {
|
|
apiKey = null;
|
|
}
|
|
const request = BlockscoutProvider.getRequest(network);
|
|
super(request, network, { staticNetwork: network });
|
|
(0, index_js_1.defineProperties)(this, { apiKey });
|
|
}
|
|
_getProvider(chainId) {
|
|
try {
|
|
return new BlockscoutProvider(chainId, this.apiKey);
|
|
}
|
|
catch (error) { }
|
|
return super._getProvider(chainId);
|
|
}
|
|
isCommunityResource() {
|
|
return (this.apiKey === null);
|
|
}
|
|
getRpcRequest(req) {
|
|
// Blockscout enforces the TAG argument for estimateGas
|
|
const resp = super.getRpcRequest(req);
|
|
if (resp && resp.method === "eth_estimateGas" && resp.args.length == 1) {
|
|
resp.args = resp.args.slice();
|
|
resp.args.push("latest");
|
|
}
|
|
return resp;
|
|
}
|
|
getRpcError(payload, _error) {
|
|
const error = _error ? _error.error : null;
|
|
// Blockscout currently drops the VM result and replaces it with a
|
|
// human-readable string, so we need to make it machine-readable.
|
|
if (error && error.code === -32015 && !(0, index_js_1.isHexString)(error.data || "", true)) {
|
|
const panicCodes = {
|
|
"assert(false)": "01",
|
|
"arithmetic underflow or overflow": "11",
|
|
"division or modulo by zero": "12",
|
|
"out-of-bounds array access; popping on an empty array": "31",
|
|
"out-of-bounds access of an array or bytesN": "32"
|
|
};
|
|
let panicCode = "";
|
|
if (error.message === "VM execution error.") {
|
|
// eth_call passes this message
|
|
panicCode = panicCodes[error.data] || "";
|
|
}
|
|
else if (panicCodes[error.message || ""]) {
|
|
panicCode = panicCodes[error.message || ""];
|
|
}
|
|
if (panicCode) {
|
|
error.message += ` (reverted: ${error.data})`;
|
|
error.data = "0x4e487b7100000000000000000000000000000000000000000000000000000000000000" + panicCode;
|
|
}
|
|
}
|
|
else if (error && error.code === -32000) {
|
|
if (error.message === "wrong transaction nonce") {
|
|
error.message += " (nonce too low)";
|
|
}
|
|
}
|
|
return super.getRpcError(payload, _error);
|
|
}
|
|
/**
|
|
* Returns a prepared request for connecting to %%network%%
|
|
* with %%apiKey%%.
|
|
*/
|
|
static getRequest(network) {
|
|
const request = new index_js_1.FetchRequest(getUrl(network.name));
|
|
request.allowGzip = true;
|
|
return request;
|
|
}
|
|
}
|
|
exports.BlockscoutProvider = BlockscoutProvider;
|
|
//# sourceMappingURL=provider-blockscout.js.map
|