/** * [[link-alchemy]] provides a third-party service for connecting to * various blockchains over JSON-RPC. * * **Supported Networks** * * - Ethereum Mainnet (``mainnet``) * - Goerli Testnet (``goerli``) * - Sepolia Testnet (``sepolia``) * - Arbitrum (``arbitrum``) * - Arbitrum Goerli Testnet (``arbitrum-goerli``) * - Arbitrum Sepolia Testnet (``arbitrum-sepolia``) * - Base (``base``) * - Base Goerlia Testnet (``base-goerli``) * - Base Sepolia Testnet (``base-sepolia``) * - Optimism (``optimism``) * - Optimism Goerli Testnet (``optimism-goerli``) * - Optimism Sepolia Testnet (``optimism-sepolia``) * - Polygon (``matic``) * - Polygon Mumbai Testnet (``matic-mumbai``) * * @_subsection: api/providers/thirdparty:Alchemy [providers-alchemy] */ import { defineProperties, resolveProperties, assert, assertArgument, FetchRequest } from "../utils/index.js"; import { showThrottleMessage } from "./community.js"; import { Network } from "./network.js"; import { JsonRpcProvider } from "./provider-jsonrpc.js"; const defaultApiKey = "_gg7wSSi0KMBsdKnGVfHDueq6xMB9EkC"; function getHost(name) { switch (name) { case "mainnet": return "eth-mainnet.alchemyapi.io"; case "goerli": return "eth-goerli.g.alchemy.com"; case "sepolia": return "eth-sepolia.g.alchemy.com"; case "arbitrum": return "arb-mainnet.g.alchemy.com"; case "arbitrum-goerli": return "arb-goerli.g.alchemy.com"; case "arbitrum-sepolia": return "arb-sepolia.g.alchemy.com"; case "base": return "base-mainnet.g.alchemy.com"; case "base-goerli": return "base-goerli.g.alchemy.com"; case "base-sepolia": return "base-sepolia.g.alchemy.com"; case "matic": return "polygon-mainnet.g.alchemy.com"; case "matic-mumbai": return "polygon-mumbai.g.alchemy.com"; case "optimism": return "opt-mainnet.g.alchemy.com"; case "optimism-goerli": return "opt-goerli.g.alchemy.com"; case "optimism-sepolia": return "opt-sepolia.g.alchemy.com"; } assertArgument(false, "unsupported network", "network", name); } /** * The **AlchemyProvider** connects to the [[link-alchemy]] * 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-alchemy-signup). * * @_docloc: api/providers/thirdparty */ export class AlchemyProvider extends JsonRpcProvider { apiKey; constructor(_network, apiKey) { if (_network == null) { _network = "mainnet"; } const network = Network.from(_network); if (apiKey == null) { apiKey = defaultApiKey; } const request = AlchemyProvider.getRequest(network, apiKey); super(request, network, { staticNetwork: network }); defineProperties(this, { apiKey }); } _getProvider(chainId) { try { return new AlchemyProvider(chainId, this.apiKey); } catch (error) { } return super._getProvider(chainId); } async _perform(req) { // https://docs.alchemy.com/reference/trace-transaction if (req.method === "getTransactionResult") { const { trace, tx } = await resolveProperties({ trace: this.send("trace_transaction", [req.hash]), tx: this.getTransaction(req.hash) }); if (trace == null || tx == null) { return null; } let data; let error = false; try { data = trace[0].result.output; error = (trace[0].error === "Reverted"); } catch (error) { } if (data) { assert(!error, "an error occurred during transaction executions", "CALL_EXCEPTION", { action: "getTransactionResult", data, reason: null, transaction: tx, invocation: null, revert: null // @TODO }); return data; } assert(false, "could not parse trace result", "BAD_DATA", { value: trace }); } return await super._perform(req); } isCommunityResource() { return (this.apiKey === defaultApiKey); } static getRequest(network, apiKey) { if (apiKey == null) { apiKey = defaultApiKey; } const request = new FetchRequest(`https:/\/${getHost(network.name)}/v2/${apiKey}`); request.allowGzip = true; if (apiKey === defaultApiKey) { request.retryFunc = async (request, response, attempt) => { showThrottleMessage("alchemy"); return true; }; } return request; } } //# sourceMappingURL=provider-alchemy.js.map