123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200 |
- /**
- * [[link-infura]] 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``)
- * - BNB Smart Chain Mainnet (``bnb``)
- * - BNB Smart Chain Testnet (``bnbt``)
- * - Linea (``linea``)
- * - Linea Goerli Testnet (``linea-goerli``)
- * - Linea Sepolia Testnet (``linea-sepolia``)
- * - Optimism (``optimism``)
- * - Optimism Goerli Testnet (``optimism-goerli``)
- * - Optimism Sepolia Testnet (``optimism-sepolia``)
- * - Polygon (``matic``)
- * - Polygon Amoy Testnet (``matic-amoy``)
- * - Polygon Mumbai Testnet (``matic-mumbai``)
- *
- * @_subsection: api/providers/thirdparty:INFURA [providers-infura]
- */
- import { defineProperties, FetchRequest, assert, assertArgument } from "../utils/index.js";
- import { showThrottleMessage } from "./community.js";
- import { Network } from "./network.js";
- import { JsonRpcProvider } from "./provider-jsonrpc.js";
- import { WebSocketProvider } from "./provider-websocket.js";
- const defaultProjectId = "84842078b09946638c03157f83405213";
- function getHost(name) {
- switch (name) {
- case "mainnet":
- return "mainnet.infura.io";
- case "goerli":
- return "goerli.infura.io";
- case "sepolia":
- return "sepolia.infura.io";
- case "arbitrum":
- return "arbitrum-mainnet.infura.io";
- case "arbitrum-goerli":
- return "arbitrum-goerli.infura.io";
- case "arbitrum-sepolia":
- return "arbitrum-sepolia.infura.io";
- case "base":
- return "base-mainnet.infura.io";
- case "base-goerlia":
- return "base-goerli.infura.io";
- case "base-sepolia":
- return "base-sepolia.infura.io";
- case "bnb":
- return "bnbsmartchain-mainnet.infura.io";
- case "bnbt":
- return "bnbsmartchain-testnet.infura.io";
- case "linea":
- return "linea-mainnet.infura.io";
- case "linea-goerli":
- return "linea-goerli.infura.io";
- case "linea-sepolia":
- return "linea-sepolia.infura.io";
- case "matic":
- return "polygon-mainnet.infura.io";
- case "matic-amoy":
- return "polygon-amoy.infura.io";
- case "matic-mumbai":
- return "polygon-mumbai.infura.io";
- case "optimism":
- return "optimism-mainnet.infura.io";
- case "optimism-goerli":
- return "optimism-goerli.infura.io";
- case "optimism-sepolia":
- return "optimism-sepolia.infura.io";
- }
- assertArgument(false, "unsupported network", "network", name);
- }
- /**
- * The **InfuraWebSocketProvider** connects to the [[link-infura]]
- * WebSocket 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-infura-signup).
- */
- export class InfuraWebSocketProvider extends WebSocketProvider {
- /**
- * The Project ID for the INFURA connection.
- */
- projectId;
- /**
- * The Project Secret.
- *
- * If null, no authenticated requests are made. This should not
- * be used outside of private contexts.
- */
- projectSecret;
- /**
- * Creates a new **InfuraWebSocketProvider**.
- */
- constructor(network, projectId) {
- const provider = new InfuraProvider(network, projectId);
- const req = provider._getConnection();
- assert(!req.credentials, "INFURA WebSocket project secrets unsupported", "UNSUPPORTED_OPERATION", { operation: "InfuraProvider.getWebSocketProvider()" });
- const url = req.url.replace(/^http/i, "ws").replace("/v3/", "/ws/v3/");
- super(url, provider._network);
- defineProperties(this, {
- projectId: provider.projectId,
- projectSecret: provider.projectSecret
- });
- }
- isCommunityResource() {
- return (this.projectId === defaultProjectId);
- }
- }
- /**
- * The **InfuraProvider** connects to the [[link-infura]]
- * 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-infura-signup).
- */
- export class InfuraProvider extends JsonRpcProvider {
- /**
- * The Project ID for the INFURA connection.
- */
- projectId;
- /**
- * The Project Secret.
- *
- * If null, no authenticated requests are made. This should not
- * be used outside of private contexts.
- */
- projectSecret;
- /**
- * Creates a new **InfuraProvider**.
- */
- constructor(_network, projectId, projectSecret) {
- if (_network == null) {
- _network = "mainnet";
- }
- const network = Network.from(_network);
- if (projectId == null) {
- projectId = defaultProjectId;
- }
- if (projectSecret == null) {
- projectSecret = null;
- }
- const request = InfuraProvider.getRequest(network, projectId, projectSecret);
- super(request, network, { staticNetwork: network });
- defineProperties(this, { projectId, projectSecret });
- }
- _getProvider(chainId) {
- try {
- return new InfuraProvider(chainId, this.projectId, this.projectSecret);
- }
- catch (error) { }
- return super._getProvider(chainId);
- }
- isCommunityResource() {
- return (this.projectId === defaultProjectId);
- }
- /**
- * Creates a new **InfuraWebSocketProvider**.
- */
- static getWebSocketProvider(network, projectId) {
- return new InfuraWebSocketProvider(network, projectId);
- }
- /**
- * Returns a prepared request for connecting to %%network%%
- * with %%projectId%% and %%projectSecret%%.
- */
- static getRequest(network, projectId, projectSecret) {
- if (projectId == null) {
- projectId = defaultProjectId;
- }
- if (projectSecret == null) {
- projectSecret = null;
- }
- const request = new FetchRequest(`https:/\/${getHost(network.name)}/v3/${projectId}`);
- request.allowGzip = true;
- if (projectSecret) {
- request.setCredentials("", projectSecret);
- }
- if (projectId === defaultProjectId) {
- request.retryFunc = async (request, response, attempt) => {
- showThrottleMessage("InfuraProvider");
- return true;
- };
- }
- return request;
- }
- }
- //# sourceMappingURL=provider-infura.js.map
|