ethers.js/packages/providers/lib.esm/base-provider.js

2007 lines
86 KiB
JavaScript
Raw Permalink Normal View History

"use strict";
2019-11-20 18:57:38 +09:00
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
return new (P || (P = Promise))(function (resolve, reject) {
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
step((generator = generator.apply(thisArg, _arguments || [])).next());
});
};
import { ForkEvent, Provider } from "@ethersproject/abstract-provider";
2022-05-20 19:13:03 -04:00
import { encode as base64Encode } from "@ethersproject/base64";
2020-09-04 01:37:14 -04:00
import { Base58 } from "@ethersproject/basex";
import { BigNumber } from "@ethersproject/bignumber";
2020-09-04 01:37:14 -04:00
import { arrayify, concat, hexConcat, hexDataLength, hexDataSlice, hexlify, hexValue, hexZeroPad, isHexString } from "@ethersproject/bytes";
import { HashZero } from "@ethersproject/constants";
2022-03-09 02:56:08 -05:00
import { dnsEncode, namehash } from "@ethersproject/hash";
import { getNetwork } from "@ethersproject/networks";
import { defineReadOnly, getStatic, resolveProperties } from "@ethersproject/properties";
2020-09-04 01:37:14 -04:00
import { sha256 } from "@ethersproject/sha2";
import { toUtf8Bytes, toUtf8String } from "@ethersproject/strings";
2021-10-19 00:01:37 -04:00
import { fetchJson, poll } from "@ethersproject/web";
2020-11-16 23:07:24 -05:00
import bech32 from "bech32";
import { Logger } from "@ethersproject/logger";
import { version } from "./_version";
const logger = new Logger(version);
import { Formatter } from "./formatter";
2022-03-09 02:56:08 -05:00
const MAX_CCIP_REDIRECTS = 10;
//////////////////////////////
// Event Serializeing
function checkTopic(topic) {
if (topic == null) {
return "null";
}
if (hexDataLength(topic) !== 32) {
logger.throwArgumentError("invalid topic", "topic", topic);
}
return topic.toLowerCase();
}
function serializeTopics(topics) {
// Remove trailing null AND-topics; they are redundant
topics = topics.slice();
2020-04-16 21:59:53 -04:00
while (topics.length > 0 && topics[topics.length - 1] == null) {
topics.pop();
}
return topics.map((topic) => {
if (Array.isArray(topic)) {
// Only track unique OR-topics
2019-11-20 18:57:38 +09:00
const unique = {};
topic.forEach((topic) => {
unique[checkTopic(topic)] = true;
});
// The order of OR-topics does not matter
2019-11-20 18:57:38 +09:00
const sorted = Object.keys(unique);
sorted.sort();
return sorted.join("|");
}
else {
return checkTopic(topic);
}
}).join("&");
}
function deserializeTopics(data) {
2020-04-16 21:59:53 -04:00
if (data === "") {
return [];
}
return data.split(/&/g).map((topic) => {
2020-04-28 05:03:49 -04:00
if (topic === "") {
return [];
}
const comps = topic.split("|").map((topic) => {
return ((topic === "null") ? null : topic);
});
2020-04-28 05:03:49 -04:00
return ((comps.length === 1) ? comps[0] : comps);
});
}
function getEventTag(eventName) {
if (typeof (eventName) === "string") {
eventName = eventName.toLowerCase();
if (hexDataLength(eventName) === 32) {
return "tx:" + eventName;
}
if (eventName.indexOf(":") === -1) {
return eventName;
}
}
else if (Array.isArray(eventName)) {
return "filter:*:" + serializeTopics(eventName);
}
else if (ForkEvent.isForkEvent(eventName)) {
logger.warn("not implemented");
throw new Error("not implemented");
}
else if (eventName && typeof (eventName) === "object") {
return "filter:" + (eventName.address || "*") + ":" + serializeTopics(eventName.topics || []);
}
throw new Error("invalid event - " + eventName);
}
//////////////////////////////
// Helper Object
function getTime() {
return (new Date()).getTime();
}
2020-06-03 03:47:17 -04:00
function stall(duration) {
return new Promise((resolve) => {
setTimeout(resolve, duration);
});
}
//////////////////////////////
// Provider Object
/**
* EventType
* - "block"
2020-05-04 23:01:04 -04:00
* - "poll"
2020-06-03 03:47:17 -04:00
* - "didPoll"
* - "pending"
* - "error"
2020-06-03 03:47:17 -04:00
* - "network"
* - filter
* - topics array
* - transaction hash
*/
2020-06-03 03:47:17 -04:00
const PollableEvents = ["block", "network", "pending", "poll"];
2020-03-12 19:14:50 +01:00
export class Event {
constructor(tag, listener, once) {
defineReadOnly(this, "tag", tag);
defineReadOnly(this, "listener", listener);
defineReadOnly(this, "once", once);
2022-03-09 14:58:07 -05:00
this._lastBlockNumber = -2;
this._inflight = false;
}
2020-04-15 18:28:04 -04:00
get event() {
switch (this.type) {
case "tx":
return this.hash;
case "filter":
return this.filter;
}
return this.tag;
}
2020-03-12 19:14:50 +01:00
get type() {
return this.tag.split(":")[0];
}
get hash() {
const comps = this.tag.split(":");
if (comps[0] !== "tx") {
return null;
}
return comps[1];
}
get filter() {
const comps = this.tag.split(":");
if (comps[0] !== "filter") {
return null;
}
2020-04-16 21:59:53 -04:00
const address = comps[1];
const topics = deserializeTopics(comps[2]);
const filter = {};
if (topics.length > 0) {
filter.topics = topics;
}
if (address && address !== "*") {
filter.address = address;
2020-03-12 19:14:50 +01:00
}
return filter;
}
pollable() {
2020-06-03 03:47:17 -04:00
return (this.tag.indexOf(":") >= 0 || PollableEvents.indexOf(this.tag) >= 0);
}
}
2020-09-04 01:37:14 -04:00
;
// https://github.com/satoshilabs/slips/blob/master/slip-0044.md
const coinInfos = {
"0": { symbol: "btc", p2pkh: 0x00, p2sh: 0x05, prefix: "bc" },
"2": { symbol: "ltc", p2pkh: 0x30, p2sh: 0x32, prefix: "ltc" },
"3": { symbol: "doge", p2pkh: 0x1e, p2sh: 0x16 },
"60": { symbol: "eth", ilk: "eth" },
"61": { symbol: "etc", ilk: "eth" },
"700": { symbol: "xdai", ilk: "eth" },
};
function bytes32ify(value) {
return hexZeroPad(BigNumber.from(value).toHexString(), 32);
}
// Compute the Base58Check encoded data (checksum is first 4 bytes of sha256d)
function base58Encode(data) {
return Base58.encode(concat([data, hexDataSlice(sha256(sha256(data)), 0, 4)]));
}
2021-12-24 03:09:45 -05:00
const matcherIpfs = new RegExp("^(ipfs):/\/(.*)$", "i");
2021-10-19 00:01:37 -04:00
const matchers = [
new RegExp("^(https):/\/(.*)$", "i"),
new RegExp("^(data):(.*)$", "i"),
2021-12-24 03:09:45 -05:00
matcherIpfs,
2021-10-19 00:01:37 -04:00
new RegExp("^eip155:[0-9]+/(erc[0-9]+):(.*)$", "i"),
];
2022-03-09 02:56:08 -05:00
function _parseString(result, start) {
2021-10-19 00:01:37 -04:00
try {
2022-03-09 02:56:08 -05:00
return toUtf8String(_parseBytes(result, start));
2021-10-19 00:01:37 -04:00
}
catch (error) { }
return null;
}
2022-03-09 02:56:08 -05:00
function _parseBytes(result, start) {
2021-10-19 00:01:37 -04:00
if (result === "0x") {
return null;
}
2022-03-09 02:56:08 -05:00
const offset = BigNumber.from(hexDataSlice(result, start, start + 32)).toNumber();
2021-10-19 00:01:37 -04:00
const length = BigNumber.from(hexDataSlice(result, offset, offset + 32)).toNumber();
return hexDataSlice(result, offset + 32, offset + 32 + length);
}
2021-12-24 03:09:45 -05:00
// Trim off the ipfs:// prefix and return the default gateway URL
function getIpfsLink(link) {
2022-01-24 21:33:40 -05:00
if (link.match(/^ipfs:\/\/ipfs\//i)) {
link = link.substring(12);
}
else if (link.match(/^ipfs:\/\//i)) {
link = link.substring(7);
}
else {
logger.throwArgumentError("unsupported IPFS format", "link", link);
}
return `https:/\/gateway.ipfs.io/ipfs/${link}`;
2021-12-24 03:09:45 -05:00
}
2022-03-09 02:56:08 -05:00
function numPad(value) {
const result = arrayify(value);
if (result.length > 32) {
throw new Error("internal; should not happen");
}
const padded = new Uint8Array(32);
padded.set(result, 32 - result.length);
return padded;
}
function bytesPad(value) {
if ((value.length % 32) === 0) {
return value;
}
const result = new Uint8Array(Math.ceil(value.length / 32) * 32);
result.set(value);
return result;
}
// ABI Encodes a series of (bytes, bytes, ...)
function encodeBytes(datas) {
const result = [];
let byteCount = 0;
// Add place-holders for pointers as we add items
for (let i = 0; i < datas.length; i++) {
result.push(null);
byteCount += 32;
}
for (let i = 0; i < datas.length; i++) {
const data = arrayify(datas[i]);
// Update the bytes offset
result[i] = numPad(byteCount);
// The length and padded value of data
result.push(numPad(data.length));
result.push(bytesPad(data));
byteCount += 32 + Math.ceil(data.length / 32) * 32;
}
return hexConcat(result);
}
2020-09-04 01:37:14 -04:00
export class Resolver {
2021-10-19 00:01:37 -04:00
// The resolvedAddress is only for creating a ReverseLookup resolver
constructor(provider, address, name, resolvedAddress) {
2020-09-04 01:37:14 -04:00
defineReadOnly(this, "provider", provider);
defineReadOnly(this, "name", name);
defineReadOnly(this, "address", provider.formatter.address(address));
2021-10-19 00:01:37 -04:00
defineReadOnly(this, "_resolvedAddress", resolvedAddress);
2020-09-04 01:37:14 -04:00
}
2022-03-09 02:56:08 -05:00
supportsWildcard() {
if (!this._supportsEip2544) {
// supportsInterface(bytes4 = selector("resolve(bytes,bytes)"))
this._supportsEip2544 = this.provider.call({
to: this.address,
data: "0x01ffc9a79061b92300000000000000000000000000000000000000000000000000000000"
}).then((result) => {
return BigNumber.from(result).eq(1);
}).catch((error) => {
if (error.code === Logger.errors.CALL_EXCEPTION) {
return false;
}
// Rethrow the error: link is down, etc. Let future attempts retry.
this._supportsEip2544 = null;
throw error;
});
}
return this._supportsEip2544;
}
_fetch(selector, parameters) {
2020-09-04 01:37:14 -04:00
return __awaiter(this, void 0, void 0, function* () {
2021-10-19 00:01:37 -04:00
// e.g. keccak256("addr(bytes32,uint256)")
const tx = {
2020-09-04 01:37:14 -04:00
to: this.address,
2022-03-09 14:58:07 -05:00
ccipReadEnabled: true,
2020-09-04 01:37:14 -04:00
data: hexConcat([selector, namehash(this.name), (parameters || "0x")])
};
2022-03-09 02:56:08 -05:00
// Wildcard support; use EIP-2544 to resolve the request
let parseBytes = false;
if (yield this.supportsWildcard()) {
parseBytes = true;
// selector("resolve(bytes,bytes)")
tx.data = hexConcat(["0x9061b923", encodeBytes([dnsEncode(this.name), tx.data])]);
}
2021-06-24 02:13:06 -04:00
try {
2022-03-09 02:56:08 -05:00
let result = yield this.provider.call(tx);
2022-03-09 14:58:07 -05:00
if ((arrayify(result).length % 32) === 4) {
logger.throwError("resolver threw error", Logger.errors.CALL_EXCEPTION, {
transaction: tx, data: result
});
}
2022-03-09 02:56:08 -05:00
if (parseBytes) {
result = _parseBytes(result, 0);
}
return result;
2021-06-24 02:13:06 -04:00
}
catch (error) {
if (error.code === Logger.errors.CALL_EXCEPTION) {
return null;
}
2022-03-09 14:58:07 -05:00
throw error;
2020-09-04 01:37:14 -04:00
}
});
}
2022-03-09 02:56:08 -05:00
_fetchBytes(selector, parameters) {
return __awaiter(this, void 0, void 0, function* () {
const result = yield this._fetch(selector, parameters);
if (result != null) {
return _parseBytes(result, 0);
}
return null;
});
}
2020-09-04 01:37:14 -04:00
_getAddress(coinType, hexBytes) {
const coinInfo = coinInfos[String(coinType)];
if (coinInfo == null) {
logger.throwError(`unsupported coin type: ${coinType}`, Logger.errors.UNSUPPORTED_OPERATION, {
operation: `getAddress(${coinType})`
});
}
if (coinInfo.ilk === "eth") {
return this.provider.formatter.address(hexBytes);
}
const bytes = arrayify(hexBytes);
// P2PKH: OP_DUP OP_HASH160 <pubKeyHash> OP_EQUALVERIFY OP_CHECKSIG
if (coinInfo.p2pkh != null) {
const p2pkh = hexBytes.match(/^0x76a9([0-9a-f][0-9a-f])([0-9a-f]*)88ac$/);
if (p2pkh) {
const length = parseInt(p2pkh[1], 16);
if (p2pkh[2].length === length * 2 && length >= 1 && length <= 75) {
return base58Encode(concat([[coinInfo.p2pkh], ("0x" + p2pkh[2])]));
}
}
}
// P2SH: OP_HASH160 <scriptHash> OP_EQUAL
if (coinInfo.p2sh != null) {
const p2sh = hexBytes.match(/^0xa9([0-9a-f][0-9a-f])([0-9a-f]*)87$/);
if (p2sh) {
const length = parseInt(p2sh[1], 16);
if (p2sh[2].length === length * 2 && length >= 1 && length <= 75) {
return base58Encode(concat([[coinInfo.p2sh], ("0x" + p2sh[2])]));
}
}
}
// Bech32
if (coinInfo.prefix != null) {
const length = bytes[1];
// https://github.com/bitcoin/bips/blob/master/bip-0141.mediawiki#witness-program
let version = bytes[0];
if (version === 0x00) {
if (length !== 20 && length !== 32) {
version = -1;
}
}
else {
version = -1;
}
if (version >= 0 && bytes.length === 2 + length && length >= 1 && length <= 75) {
2020-11-16 23:07:24 -05:00
const words = bech32.toWords(bytes.slice(2));
2020-09-04 01:37:14 -04:00
words.unshift(version);
2020-11-16 23:07:24 -05:00
return bech32.encode(coinInfo.prefix, words);
2020-09-04 01:37:14 -04:00
}
}
return null;
}
getAddress(coinType) {
return __awaiter(this, void 0, void 0, function* () {
if (coinType == null) {
coinType = 60;
}
// If Ethereum, use the standard `addr(bytes32)`
if (coinType === 60) {
2021-06-24 02:13:06 -04:00
try {
// keccak256("addr(bytes32)")
2022-03-09 02:56:08 -05:00
const result = yield this._fetch("0x3b3b57de");
2021-06-24 02:13:06 -04:00
// No address
2022-03-09 02:56:08 -05:00
if (result === "0x" || result === HashZero) {
2021-06-24 02:13:06 -04:00
return null;
}
2022-03-09 02:56:08 -05:00
return this.provider.formatter.callAddress(result);
2021-06-24 02:13:06 -04:00
}
catch (error) {
if (error.code === Logger.errors.CALL_EXCEPTION) {
return null;
}
throw error;
2020-09-04 01:37:14 -04:00
}
}
// keccak256("addr(bytes32,uint256")
const hexBytes = yield this._fetchBytes("0xf1cb7e06", bytes32ify(coinType));
// No address
if (hexBytes == null || hexBytes === "0x") {
return null;
}
// Compute the address
const address = this._getAddress(coinType, hexBytes);
if (address == null) {
logger.throwError(`invalid or unsupported coin data`, Logger.errors.UNSUPPORTED_OPERATION, {
operation: `getAddress(${coinType})`,
coinType: coinType,
data: hexBytes
});
}
return address;
});
}
2021-10-19 00:01:37 -04:00
getAvatar() {
return __awaiter(this, void 0, void 0, function* () {
2021-12-24 03:09:45 -05:00
const linkage = [{ type: "name", content: this.name }];
2021-10-19 00:01:37 -04:00
try {
2021-11-30 11:19:37 -05:00
// test data for ricmoo.eth
//const avatar = "eip155:1/erc721:0x265385c7f4132228A0d54EB1A9e7460b91c0cC68/29233";
2021-10-19 00:01:37 -04:00
const avatar = yield this.getText("avatar");
if (avatar == null) {
return null;
}
for (let i = 0; i < matchers.length; i++) {
const match = avatar.match(matchers[i]);
if (match == null) {
continue;
}
2022-01-06 03:53:52 -05:00
const scheme = match[1].toLowerCase();
switch (scheme) {
2021-10-19 00:01:37 -04:00
case "https":
linkage.push({ type: "url", content: avatar });
return { linkage, url: avatar };
case "data":
linkage.push({ type: "data", content: avatar });
return { linkage, url: avatar };
case "ipfs":
linkage.push({ type: "ipfs", content: avatar });
2021-12-24 03:09:45 -05:00
return { linkage, url: getIpfsLink(avatar) };
2021-10-19 00:01:37 -04:00
case "erc721":
case "erc1155": {
// Depending on the ERC type, use tokenURI(uint256) or url(uint256)
2022-01-06 03:53:52 -05:00
const selector = (scheme === "erc721") ? "0xc87b56dd" : "0x0e89341c";
linkage.push({ type: scheme, content: avatar });
2021-10-19 00:01:37 -04:00
// The owner of this name
const owner = (this._resolvedAddress || (yield this.getAddress()));
const comps = (match[2] || "").split("/");
if (comps.length !== 2) {
return null;
}
const addr = yield this.provider.formatter.address(comps[0]);
const tokenId = hexZeroPad(BigNumber.from(comps[1]).toHexString(), 32);
// Check that this account owns the token
2022-01-06 03:53:52 -05:00
if (scheme === "erc721") {
2021-10-19 00:01:37 -04:00
// ownerOf(uint256 tokenId)
const tokenOwner = this.provider.formatter.callAddress(yield this.provider.call({
to: addr, data: hexConcat(["0x6352211e", tokenId])
}));
if (owner !== tokenOwner) {
return null;
}
linkage.push({ type: "owner", content: tokenOwner });
}
2022-01-06 03:53:52 -05:00
else if (scheme === "erc1155") {
2021-10-19 00:01:37 -04:00
// balanceOf(address owner, uint256 tokenId)
const balance = BigNumber.from(yield this.provider.call({
to: addr, data: hexConcat(["0x00fdd58e", hexZeroPad(owner, 32), tokenId])
}));
if (balance.isZero()) {
return null;
}
linkage.push({ type: "balance", content: balance.toString() });
}
// Call the token contract for the metadata URL
const tx = {
to: this.provider.formatter.address(comps[0]),
data: hexConcat([selector, tokenId])
};
2022-03-09 02:56:08 -05:00
let metadataUrl = _parseString(yield this.provider.call(tx), 0);
2021-10-19 00:01:37 -04:00
if (metadataUrl == null) {
return null;
}
2022-01-24 21:33:40 -05:00
linkage.push({ type: "metadata-url-base", content: metadataUrl });
2021-10-19 00:01:37 -04:00
// ERC-1155 allows a generic {id} in the URL
2022-01-06 03:53:52 -05:00
if (scheme === "erc1155") {
2021-10-19 00:01:37 -04:00
metadataUrl = metadataUrl.replace("{id}", tokenId.substring(2));
2021-12-24 03:09:45 -05:00
linkage.push({ type: "metadata-url-expanded", content: metadataUrl });
2021-10-19 00:01:37 -04:00
}
2022-01-24 21:33:40 -05:00
// Transform IPFS metadata links
if (metadataUrl.match(/^ipfs:/i)) {
metadataUrl = getIpfsLink(metadataUrl);
}
linkage.push({ type: "metadata-url", content: metadataUrl });
2021-10-19 00:01:37 -04:00
// Get the token metadata
const metadata = yield fetchJson(metadataUrl);
2021-12-24 03:09:45 -05:00
if (!metadata) {
2021-10-19 00:01:37 -04:00
return null;
}
linkage.push({ type: "metadata", content: JSON.stringify(metadata) });
2021-12-24 03:09:45 -05:00
// Pull the image URL out
let imageUrl = metadata.image;
if (typeof (imageUrl) !== "string") {
return null;
}
if (imageUrl.match(/^(https:\/\/|data:)/i)) {
// Allow
}
else {
// Transform IPFS link to gateway
const ipfs = imageUrl.match(matcherIpfs);
if (ipfs == null) {
return null;
}
linkage.push({ type: "url-ipfs", content: imageUrl });
imageUrl = getIpfsLink(imageUrl);
}
linkage.push({ type: "url", content: imageUrl });
return { linkage, url: imageUrl };
2021-10-19 00:01:37 -04:00
}
}
}
}
catch (error) { }
return null;
});
}
2020-09-04 01:37:14 -04:00
getContentHash() {
return __awaiter(this, void 0, void 0, function* () {
// keccak256("contenthash()")
const hexBytes = yield this._fetchBytes("0xbc1c58d1");
// No contenthash
if (hexBytes == null || hexBytes === "0x") {
return null;
}
// IPFS (CID: 1, Type: DAG-PB)
const ipfs = hexBytes.match(/^0xe3010170(([0-9a-f][0-9a-f])([0-9a-f][0-9a-f])([0-9a-f]*))$/);
if (ipfs) {
const length = parseInt(ipfs[3], 16);
if (ipfs[4].length === length * 2) {
return "ipfs:/\/" + Base58.encode("0x" + ipfs[1]);
}
}
2022-03-25 04:32:41 -04:00
// IPNS (CID: 1, Type: libp2p-key)
const ipns = hexBytes.match(/^0xe5010172(([0-9a-f][0-9a-f])([0-9a-f][0-9a-f])([0-9a-f]*))$/);
if (ipns) {
const length = parseInt(ipns[3], 16);
if (ipns[4].length === length * 2) {
return "ipns:/\/" + Base58.encode("0x" + ipns[1]);
}
}
2020-09-04 01:37:14 -04:00
// Swarm (CID: 1, Type: swarm-manifest; hash/length hard-coded to keccak256/32)
const swarm = hexBytes.match(/^0xe40101fa011b20([0-9a-f]*)$/);
if (swarm) {
if (swarm[1].length === (32 * 2)) {
return "bzz:/\/" + swarm[1];
}
}
2022-05-20 19:13:03 -04:00
const skynet = hexBytes.match(/^0x90b2c605([0-9a-f]*)$/);
if (skynet) {
if (skynet[1].length === (34 * 2)) {
// URL Safe base64; https://datatracker.ietf.org/doc/html/rfc4648#section-5
const urlSafe = { "=": "", "+": "-", "/": "_" };
const hash = base64Encode("0x" + skynet[1]).replace(/[=+\/]/g, (a) => (urlSafe[a]));
return "sia:/\/" + hash;
}
}
2020-09-04 01:37:14 -04:00
return logger.throwError(`invalid or unsupported content hash data`, Logger.errors.UNSUPPORTED_OPERATION, {
operation: "getContentHash()",
data: hexBytes
});
});
}
getText(key) {
return __awaiter(this, void 0, void 0, function* () {
// The key encoded as parameter to fetchBytes
let keyBytes = toUtf8Bytes(key);
// The nodehash consumes the first slot, so the string pointer targets
// offset 64, with the length at offset 64 and data starting at offset 96
keyBytes = concat([bytes32ify(64), bytes32ify(keyBytes.length), keyBytes]);
// Pad to word-size (32 bytes)
if ((keyBytes.length % 32) !== 0) {
keyBytes = concat([keyBytes, hexZeroPad("0x", 32 - (key.length % 32))]);
}
const hexBytes = yield this._fetchBytes("0x59d1d43c", hexlify(keyBytes));
if (hexBytes == null || hexBytes === "0x") {
return null;
}
return toUtf8String(hexBytes);
});
}
}
let defaultFormatter = null;
let nextPollId = 1;
export class BaseProvider extends Provider {
2020-05-03 17:53:58 -04:00
/**
* ready
*
* A Promise<Network> that resolves only once the provider is ready.
*
* Sub-classes that call the super with a network without a chainId
* MUST set this. Standard named networks have a known chainId.
*
*/
constructor(network) {
super();
2020-06-03 03:47:17 -04:00
// Events being listened to
this._events = [];
this._emitted = { block: -2 };
2022-03-09 02:56:08 -05:00
this.disableCcipRead = false;
this.formatter = new.target.getFormatter();
2020-06-03 03:47:17 -04:00
// If network is any, this Provider allows the underlying
// network to change dynamically, and we auto-detect the
// current network
defineReadOnly(this, "anyNetwork", (network === "any"));
if (this.anyNetwork) {
network = this.detectNetwork();
}
if (network instanceof Promise) {
2020-05-03 17:53:58 -04:00
this._networkPromise = network;
// Squash any "unhandled promise" errors; that do not need to be handled
2020-05-03 17:53:58 -04:00
network.catch((error) => { });
2020-06-03 03:47:17 -04:00
// Trigger initial network setting (async)
2020-06-13 21:39:36 -04:00
this._ready().catch((error) => { });
}
else {
2021-10-16 02:29:27 -04:00
const knownNetwork = getStatic(new.target, "getNetwork")(network);
if (knownNetwork) {
defineReadOnly(this, "_network", knownNetwork);
2020-06-03 03:47:17 -04:00
this.emit("network", knownNetwork, null);
}
else {
logger.throwArgumentError("invalid network", "network", network);
}
}
2019-11-20 18:57:38 +09:00
this._maxInternalBlockNumber = -1024;
this._lastBlockNumber = -2;
2022-03-09 02:56:08 -05:00
this._maxFilterBlockRange = 10;
this._pollingInterval = 4000;
this._fastQueryDate = 0;
}
2020-05-03 17:53:58 -04:00
_ready() {
return __awaiter(this, void 0, void 0, function* () {
if (this._network == null) {
let network = null;
if (this._networkPromise) {
try {
network = yield this._networkPromise;
}
catch (error) { }
}
// Try the Provider's network detection (this MUST throw if it cannot)
if (network == null) {
network = yield this.detectNetwork();
}
// This should never happen; every Provider sub-class should have
2020-05-29 21:27:59 -04:00
// suggested a network by here (or have thrown).
2020-05-03 17:53:58 -04:00
if (!network) {
logger.throwError("no network detected", Logger.errors.UNKNOWN_ERROR, {});
}
2020-05-29 21:27:59 -04:00
// Possible this call stacked so do not call defineReadOnly again
if (this._network == null) {
2020-06-03 03:47:17 -04:00
if (this.anyNetwork) {
this._network = network;
}
else {
defineReadOnly(this, "_network", network);
}
this.emit("network", network, null);
2020-05-29 21:27:59 -04:00
}
2020-05-03 17:53:58 -04:00
}
return this._network;
});
}
2020-06-03 03:47:17 -04:00
// This will always return the most recently established network.
// For "any", this can change (a "network" event is emitted before
2021-10-16 02:29:27 -04:00
// any change is reflected); otherwise this cannot change
2020-05-03 17:53:58 -04:00
get ready() {
2020-06-13 21:39:36 -04:00
return poll(() => {
return this._ready().then((network) => {
return network;
}, (error) => {
// If the network isn't running yet, we will wait
if (error.code === Logger.errors.NETWORK_ERROR && error.event === "noNetwork") {
return undefined;
}
throw error;
});
});
2020-05-03 17:53:58 -04:00
}
2020-06-03 03:47:17 -04:00
// @TODO: Remove this and just create a singleton formatter
static getFormatter() {
if (defaultFormatter == null) {
defaultFormatter = new Formatter();
}
return defaultFormatter;
}
2020-06-03 03:47:17 -04:00
// @TODO: Remove this and just use getNetwork
static getNetwork(network) {
return getNetwork((network == null) ? "homestead" : network);
}
2022-03-09 02:56:08 -05:00
ccipReadFetch(tx, calldata, urls) {
return __awaiter(this, void 0, void 0, function* () {
if (this.disableCcipRead || urls.length === 0) {
return null;
}
2022-03-15 22:04:05 -04:00
const sender = tx.to.toLowerCase();
2022-03-09 02:56:08 -05:00
const data = calldata.toLowerCase();
const errorMessages = [];
for (let i = 0; i < urls.length; i++) {
const url = urls[i];
// URL expansion
const href = url.replace("{sender}", sender).replace("{data}", data);
// If no {data} is present, use POST; otherwise GET
const json = (url.indexOf("{data}") >= 0) ? null : JSON.stringify({ data, sender });
const result = yield fetchJson({ url: href, errorPassThrough: true }, json, (value, response) => {
value.status = response.statusCode;
return value;
});
if (result.data) {
return result.data;
}
const errorMessage = (result.message || "unknown error");
// 4xx indicates the result is not present; stop
if (result.status >= 400 && result.status < 500) {
return logger.throwError(`response not found during CCIP fetch: ${errorMessage}`, Logger.errors.SERVER_ERROR, { url, errorMessage });
}
// 5xx indicates server issue; try the next url
errorMessages.push(errorMessage);
}
return logger.throwError(`error encountered during CCIP fetch: ${errorMessages.map((m) => JSON.stringify(m)).join(", ")}`, Logger.errors.SERVER_ERROR, {
urls, errorMessages
});
});
}
2020-06-03 03:47:17 -04:00
// Fetches the blockNumber, but will reuse any result that is less
// than maxAge old or has been requested since the last request
2019-11-20 18:57:38 +09:00
_getInternalBlockNumber(maxAge) {
return __awaiter(this, void 0, void 0, function* () {
2020-06-13 21:39:36 -04:00
yield this._ready();
2021-01-13 14:49:25 -05:00
// Allowing stale data up to maxAge old
if (maxAge > 0) {
// While there are pending internal block requests...
while (this._internalBlockNumber) {
// ..."remember" which fetch we started with
const internalBlockNumber = this._internalBlockNumber;
try {
// Check the result is not too stale
const result = yield internalBlockNumber;
if ((getTime() - result.respTime) <= maxAge) {
return result.blockNumber;
}
// Too old; fetch a new value
break;
2021-01-13 03:41:29 -05:00
}
2021-01-13 14:49:25 -05:00
catch (error) {
// The fetch rejected; if we are the first to get the
// rejection, drop through so we replace it with a new
// fetch; all others blocked will then get that fetch
// which won't match the one they "remembered" and loop
if (this._internalBlockNumber === internalBlockNumber) {
break;
}
2021-01-13 03:41:29 -05:00
}
2019-11-20 18:57:38 +09:00
}
}
const reqTime = getTime();
2020-06-03 03:47:17 -04:00
const checkInternalBlockNumber = resolveProperties({
blockNumber: this.perform("getBlockNumber", {}),
networkError: this.getNetwork().then((network) => (null), (error) => (error))
}).then(({ blockNumber, networkError }) => {
if (networkError) {
// Unremember this bad internal block number
if (this._internalBlockNumber === checkInternalBlockNumber) {
this._internalBlockNumber = null;
}
throw networkError;
}
2019-11-20 18:57:38 +09:00
const respTime = getTime();
blockNumber = BigNumber.from(blockNumber).toNumber();
if (blockNumber < this._maxInternalBlockNumber) {
blockNumber = this._maxInternalBlockNumber;
}
this._maxInternalBlockNumber = blockNumber;
this._setFastBlockNumber(blockNumber); // @TODO: Still need this?
return { blockNumber, reqTime, respTime };
});
2020-06-03 03:47:17 -04:00
this._internalBlockNumber = checkInternalBlockNumber;
2021-01-13 03:41:29 -05:00
// Swallow unhandled exceptions; if needed they are handled else where
checkInternalBlockNumber.catch((error) => {
// Don't null the dead (rejected) fetch, if it has already been updated
if (this._internalBlockNumber === checkInternalBlockNumber) {
this._internalBlockNumber = null;
}
});
2020-06-03 03:47:17 -04:00
return (yield checkInternalBlockNumber).blockNumber;
2019-11-20 18:57:38 +09:00
});
}
poll() {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
const pollId = nextPollId++;
// Track all running promises, so we can trigger a post-poll once they are complete
const runners = [];
2021-01-13 03:41:29 -05:00
let blockNumber = null;
try {
blockNumber = yield this._getInternalBlockNumber(100 + this.pollingInterval / 2);
}
catch (error) {
this.emit("error", error);
return;
}
this._setFastBlockNumber(blockNumber);
2020-05-04 23:01:04 -04:00
// Emit a poll event after we have the latest (fast) block number
this.emit("poll", pollId, blockNumber);
// If the block has not changed, meh.
if (blockNumber === this._lastBlockNumber) {
2020-05-04 23:01:04 -04:00
this.emit("didPoll", pollId);
return;
}
// First polling cycle, trigger a "block" events
if (this._emitted.block === -2) {
this._emitted.block = blockNumber - 1;
}
2020-06-03 03:47:17 -04:00
if (Math.abs((this._emitted.block) - blockNumber) > 1000) {
2021-05-18 16:02:27 -04:00
logger.warn(`network block skew detected; skipping block events (emitted=${this._emitted.block} blockNumber${blockNumber})`);
2020-06-03 03:47:17 -04:00
this.emit("error", logger.makeError("network block skew detected", Logger.errors.NETWORK_ERROR, {
blockNumber: blockNumber,
2020-06-13 21:39:36 -04:00
event: "blockSkew",
2020-06-03 03:47:17 -04:00
previousBlockNumber: this._emitted.block
}));
this.emit("block", blockNumber);
}
else {
// Notify all listener for each block that has passed
for (let i = this._emitted.block + 1; i <= blockNumber; i++) {
this.emit("block", i);
}
}
// The emitted block was updated, check for obsolete events
if (this._emitted.block !== blockNumber) {
this._emitted.block = blockNumber;
Object.keys(this._emitted).forEach((key) => {
// The block event does not expire
if (key === "block") {
return;
}
// The block we were at when we emitted this event
2019-11-20 18:57:38 +09:00
const eventBlockNumber = this._emitted[key];
// We cannot garbage collect pending transactions or blocks here
// They should be garbage collected by the Provider when setting
// "pending" events
if (eventBlockNumber === "pending") {
return;
}
// Evict any transaction hashes or block hashes over 12 blocks
// old, since they should not return null anyways
if (blockNumber - eventBlockNumber > 12) {
delete this._emitted[key];
}
});
}
// First polling cycle
if (this._lastBlockNumber === -2) {
this._lastBlockNumber = blockNumber - 1;
}
// Find all transaction hashes we are waiting on
this._events.forEach((event) => {
2020-03-12 19:14:50 +01:00
switch (event.type) {
case "tx": {
2020-03-12 19:14:50 +01:00
const hash = event.hash;
let runner = this.getTransactionReceipt(hash).then((receipt) => {
if (!receipt || receipt.blockNumber == null) {
return null;
}
this._emitted["t:" + hash] = receipt.blockNumber;
this.emit(hash, receipt);
return null;
}).catch((error) => { this.emit("error", error); });
runners.push(runner);
break;
}
case "filter": {
2022-03-09 02:56:08 -05:00
// We only allow a single getLogs to be in-flight at a time
2022-03-09 14:58:07 -05:00
if (!event._inflight) {
event._inflight = true;
2022-08-18 14:48:39 -04:00
// This is the first filter for this event, so we want to
// restrict events to events that happened no earlier than now
if (event._lastBlockNumber === -2) {
event._lastBlockNumber = blockNumber - 1;
}
// Filter from the last *known* event; due to load-balancing
2022-03-09 02:56:08 -05:00
// and some nodes returning updated block numbers before
// indexing events, a logs result with 0 entries cannot be
// trusted and we must retry a range which includes it again
const filter = event.filter;
2022-03-09 14:58:07 -05:00
filter.fromBlock = event._lastBlockNumber + 1;
2022-03-09 02:56:08 -05:00
filter.toBlock = blockNumber;
2022-08-18 14:48:39 -04:00
// Prevent fitler ranges from growing too wild, since it is quite
// likely there just haven't been any events to move the lastBlockNumber.
const minFromBlock = filter.toBlock - this._maxFilterBlockRange;
if (minFromBlock > filter.fromBlock) {
filter.fromBlock = minFromBlock;
}
if (filter.fromBlock < 0) {
filter.fromBlock = 0;
}
2022-03-09 02:56:08 -05:00
const runner = this.getLogs(filter).then((logs) => {
// Allow the next getLogs
2022-03-09 14:58:07 -05:00
event._inflight = false;
2022-03-09 02:56:08 -05:00
if (logs.length === 0) {
return;
}
logs.forEach((log) => {
// Only when we get an event for a given block number
// can we trust the events are indexed
2022-03-09 14:58:07 -05:00
if (log.blockNumber > event._lastBlockNumber) {
event._lastBlockNumber = log.blockNumber;
2022-03-09 02:56:08 -05:00
}
// Make sure we stall requests to fetch blocks and txs
this._emitted["b:" + log.blockHash] = log.blockNumber;
this._emitted["t:" + log.transactionHash] = log.blockNumber;
this.emit(filter, log);
});
}).catch((error) => {
this.emit("error", error);
// Allow another getLogs (the range was not updated)
2022-03-09 14:58:07 -05:00
event._inflight = false;
});
2022-03-09 02:56:08 -05:00
runners.push(runner);
}
break;
}
}
});
this._lastBlockNumber = blockNumber;
2020-06-03 03:47:17 -04:00
// Once all events for this loop have been processed, emit "didPoll"
2019-11-20 18:57:38 +09:00
Promise.all(runners).then(() => {
this.emit("didPoll", pollId);
2021-01-13 03:41:29 -05:00
}).catch((error) => { this.emit("error", error); });
return;
});
}
2020-06-03 03:47:17 -04:00
// Deprecated; do not use this
resetEventsBlock(blockNumber) {
this._lastBlockNumber = blockNumber - 1;
if (this.polling) {
this.poll();
}
}
get network() {
return this._network;
}
2020-06-03 03:47:17 -04:00
// This method should query the network if the underlying network
// can change, such as when connected to a JSON-RPC backend
detectNetwork() {
return __awaiter(this, void 0, void 0, function* () {
return logger.throwError("provider does not support network detection", Logger.errors.UNSUPPORTED_OPERATION, {
operation: "provider.detectNetwork"
});
});
}
getNetwork() {
2020-06-03 03:47:17 -04:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-13 21:39:36 -04:00
const network = yield this._ready();
2020-06-03 03:47:17 -04:00
// Make sure we are still connected to the same network; this is
// only an external call for backends which can have the underlying
// network change spontaneously
const currentNetwork = yield this.detectNetwork();
if (network.chainId !== currentNetwork.chainId) {
// We are allowing network changes, things can get complex fast;
// make sure you know what you are doing if you use "any"
if (this.anyNetwork) {
this._network = currentNetwork;
// Reset all internal block number guards and caches
this._lastBlockNumber = -2;
this._fastBlockNumber = null;
this._fastBlockNumberPromise = null;
this._fastQueryDate = 0;
this._emitted.block = -2;
this._maxInternalBlockNumber = -1024;
this._internalBlockNumber = null;
// The "network" event MUST happen before this method resolves
// so any events have a chance to unregister, so we stall an
// additional event loop before returning from /this/ call
this.emit("network", currentNetwork, network);
yield stall(0);
return this._network;
}
const error = logger.makeError("underlying network changed", Logger.errors.NETWORK_ERROR, {
event: "changed",
network: network,
detectedNetwork: currentNetwork
});
this.emit("error", error);
throw error;
}
return network;
});
}
get blockNumber() {
2020-05-04 23:01:04 -04:00
this._getInternalBlockNumber(100 + this.pollingInterval / 2).then((blockNumber) => {
this._setFastBlockNumber(blockNumber);
2021-01-13 03:41:29 -05:00
}, (error) => { });
2020-05-04 23:01:04 -04:00
return (this._fastBlockNumber != null) ? this._fastBlockNumber : -1;
}
get polling() {
return (this._poller != null);
}
set polling(value) {
2020-05-04 23:01:04 -04:00
if (value && !this._poller) {
2021-01-13 03:41:29 -05:00
this._poller = setInterval(() => { this.poll(); }, this.pollingInterval);
2020-05-04 23:01:04 -04:00
if (!this._bootstrapPoll) {
this._bootstrapPoll = setTimeout(() => {
this.poll();
// We block additional polls until the polling interval
// is done, to prevent overwhelming the poll function
this._bootstrapPoll = setTimeout(() => {
// If polling was disabled, something may require a poke
// since starting the bootstrap poll and it was disabled
if (!this._poller) {
this.poll();
}
// Clear out the bootstrap so we can do another
this._bootstrapPoll = null;
}, this.pollingInterval);
}, 0);
}
2020-05-04 23:01:04 -04:00
}
else if (!value && this._poller) {
clearInterval(this._poller);
this._poller = null;
}
}
get pollingInterval() {
return this._pollingInterval;
}
set pollingInterval(value) {
if (typeof (value) !== "number" || value <= 0 || parseInt(String(value)) != value) {
throw new Error("invalid polling interval");
}
this._pollingInterval = value;
if (this._poller) {
clearInterval(this._poller);
this._poller = setInterval(() => { this.poll(); }, this._pollingInterval);
}
}
_getFastBlockNumber() {
2019-11-20 18:57:38 +09:00
const now = getTime();
// Stale block number, request a newer value
if ((now - this._fastQueryDate) > 2 * this._pollingInterval) {
this._fastQueryDate = now;
this._fastBlockNumberPromise = this.getBlockNumber().then((blockNumber) => {
if (this._fastBlockNumber == null || blockNumber > this._fastBlockNumber) {
this._fastBlockNumber = blockNumber;
}
return this._fastBlockNumber;
});
}
return this._fastBlockNumberPromise;
}
_setFastBlockNumber(blockNumber) {
// Older block, maybe a stale request
if (this._fastBlockNumber != null && blockNumber < this._fastBlockNumber) {
return;
}
// Update the time we updated the blocknumber
this._fastQueryDate = getTime();
// Newer block number, use it
if (this._fastBlockNumber == null || blockNumber > this._fastBlockNumber) {
this._fastBlockNumber = blockNumber;
this._fastBlockNumberPromise = Promise.resolve(blockNumber);
}
}
2020-02-04 01:06:47 -05:00
waitForTransaction(transactionHash, confirmations, timeout) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2021-05-17 16:19:36 -04:00
return this._waitForTransaction(transactionHash, (confirmations == null) ? 1 : confirmations, timeout || 0, null);
});
}
_waitForTransaction(transactionHash, confirmations, timeout, replaceable) {
return __awaiter(this, void 0, void 0, function* () {
2019-11-20 18:57:38 +09:00
const receipt = yield this.getTransactionReceipt(transactionHash);
// Receipt is already good
2020-02-04 01:06:47 -05:00
if ((receipt ? receipt.confirmations : 0) >= confirmations) {
2019-11-20 18:57:38 +09:00
return receipt;
}
// Poll until the receipt is good...
2020-02-04 01:06:47 -05:00
return new Promise((resolve, reject) => {
2021-05-17 16:19:36 -04:00
const cancelFuncs = [];
2020-02-04 01:06:47 -05:00
let done = false;
2021-05-17 16:19:36 -04:00
const alreadyDone = function () {
if (done) {
return true;
}
done = true;
cancelFuncs.forEach((func) => { func(); });
return false;
};
const minedHandler = (receipt) => {
2019-11-20 18:57:38 +09:00
if (receipt.confirmations < confirmations) {
return;
}
2021-05-17 16:19:36 -04:00
if (alreadyDone()) {
2020-02-04 01:06:47 -05:00
return;
}
2019-11-20 18:57:38 +09:00
resolve(receipt);
};
2021-05-17 16:19:36 -04:00
this.on(transactionHash, minedHandler);
cancelFuncs.push(() => { this.removeListener(transactionHash, minedHandler); });
if (replaceable) {
let lastBlockNumber = replaceable.startBlock;
let scannedBlock = null;
const replaceHandler = (blockNumber) => __awaiter(this, void 0, void 0, function* () {
2020-02-04 01:06:47 -05:00
if (done) {
return;
}
2021-05-17 16:19:36 -04:00
// Wait 1 second; this is only used in the case of a fault, so
// we will trade off a little bit of latency for more consistent
// results and fewer JSON-RPC calls
yield stall(1000);
this.getTransactionCount(replaceable.from).then((nonce) => __awaiter(this, void 0, void 0, function* () {
if (done) {
return;
}
if (nonce <= replaceable.nonce) {
lastBlockNumber = blockNumber;
}
else {
// First check if the transaction was mined
{
const mined = yield this.getTransaction(transactionHash);
if (mined && mined.blockNumber != null) {
return;
}
}
// First time scanning. We start a little earlier for some
// wiggle room here to handle the eventually consistent nature
// of blockchain (e.g. the getTransactionCount was for a
// different block)
if (scannedBlock == null) {
scannedBlock = lastBlockNumber - 3;
if (scannedBlock < replaceable.startBlock) {
scannedBlock = replaceable.startBlock;
}
}
while (scannedBlock <= blockNumber) {
if (done) {
return;
}
const block = yield this.getBlockWithTransactions(scannedBlock);
for (let ti = 0; ti < block.transactions.length; ti++) {
const tx = block.transactions[ti];
// Successfully mined!
if (tx.hash === transactionHash) {
return;
}
// Matches our transaction from and nonce; its a replacement
if (tx.from === replaceable.from && tx.nonce === replaceable.nonce) {
if (done) {
return;
}
// Get the receipt of the replacement
const receipt = yield this.waitForTransaction(tx.hash, confirmations);
// Already resolved or rejected (prolly a timeout)
if (alreadyDone()) {
return;
}
// The reason we were replaced
let reason = "replaced";
if (tx.data === replaceable.data && tx.to === replaceable.to && tx.value.eq(replaceable.value)) {
reason = "repriced";
}
else if (tx.data === "0x" && tx.from === tx.to && tx.value.isZero()) {
reason = "cancelled";
}
// Explain why we were replaced
reject(logger.makeError("transaction was replaced", Logger.errors.TRANSACTION_REPLACED, {
cancelled: (reason === "replaced" || reason === "cancelled"),
reason,
replacement: this._wrapTransaction(tx),
hash: transactionHash,
receipt
}));
return;
}
}
scannedBlock++;
}
}
if (done) {
return;
}
this.once("block", replaceHandler);
}), (error) => {
if (done) {
return;
}
this.once("block", replaceHandler);
});
});
if (done) {
return;
}
this.once("block", replaceHandler);
cancelFuncs.push(() => {
this.removeListener("block", replaceHandler);
});
}
if (typeof (timeout) === "number" && timeout > 0) {
const timer = setTimeout(() => {
if (alreadyDone()) {
return;
}
2020-02-04 01:06:47 -05:00
reject(logger.makeError("timeout exceeded", Logger.errors.TIMEOUT, { timeout: timeout }));
}, timeout);
if (timer.unref) {
timer.unref();
}
2021-05-17 16:19:36 -04:00
cancelFuncs.push(() => { clearTimeout(timer); });
2020-02-04 01:06:47 -05:00
}
});
});
}
getBlockNumber() {
2020-06-03 03:47:17 -04:00
return __awaiter(this, void 0, void 0, function* () {
return this._getInternalBlockNumber(0);
});
}
getGasPrice() {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2021-02-12 19:06:01 -05:00
const result = yield this.perform("getGasPrice", {});
try {
return BigNumber.from(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "getGasPrice",
result, error
});
}
});
}
getBalance(addressOrName, blockTag) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({
address: this._getAddress(addressOrName),
blockTag: this._getBlockTag(blockTag)
});
2021-02-12 19:06:01 -05:00
const result = yield this.perform("getBalance", params);
try {
return BigNumber.from(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "getBalance",
params, result, error
});
}
});
}
getTransactionCount(addressOrName, blockTag) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({
address: this._getAddress(addressOrName),
blockTag: this._getBlockTag(blockTag)
});
2021-02-12 19:06:01 -05:00
const result = yield this.perform("getTransactionCount", params);
try {
return BigNumber.from(result).toNumber();
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "getTransactionCount",
params, result, error
});
}
});
}
getCode(addressOrName, blockTag) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({
address: this._getAddress(addressOrName),
blockTag: this._getBlockTag(blockTag)
});
2021-02-12 19:06:01 -05:00
const result = yield this.perform("getCode", params);
try {
return hexlify(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "getCode",
params, result, error
});
}
});
}
getStorageAt(addressOrName, position, blockTag) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({
address: this._getAddress(addressOrName),
blockTag: this._getBlockTag(blockTag),
position: Promise.resolve(position).then((p) => hexValue(p))
});
2021-02-12 19:06:01 -05:00
const result = yield this.perform("getStorageAt", params);
try {
return hexlify(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "getStorageAt",
params, result, error
});
}
});
}
// This should be called by any subclass wrapping a TransactionResponse
2021-05-17 16:19:36 -04:00
_wrapTransaction(tx, hash, startBlock) {
if (hash != null && hexDataLength(hash) !== 32) {
throw new Error("invalid response - sendTransaction");
}
2019-11-20 18:57:38 +09:00
const result = tx;
// Check the hash we expect is the same as the hash the server reported
if (hash != null && tx.hash !== hash) {
logger.throwError("Transaction hash mismatch from Provider.sendTransaction.", Logger.errors.UNKNOWN_ERROR, { expectedHash: tx.hash, returnedHash: hash });
}
2021-05-17 16:19:36 -04:00
result.wait = (confirms, timeout) => __awaiter(this, void 0, void 0, function* () {
if (confirms == null) {
confirms = 1;
}
if (timeout == null) {
timeout = 0;
}
// Get the details to detect replacement
let replacement = undefined;
if (confirms !== 0 && startBlock != null) {
replacement = {
data: tx.data,
from: tx.from,
nonce: tx.nonce,
to: tx.to,
value: tx.value,
startBlock
};
}
const receipt = yield this._waitForTransaction(tx.hash, confirms, timeout, replacement);
if (receipt == null && confirms === 0) {
2019-11-20 18:57:38 +09:00
return null;
}
// No longer pending, allow the polling loop to garbage collect this
this._emitted["t:" + tx.hash] = receipt.blockNumber;
if (receipt.status === 0) {
logger.throwError("transaction failed", Logger.errors.CALL_EXCEPTION, {
transactionHash: tx.hash,
transaction: tx,
receipt: receipt
});
}
return receipt;
});
return result;
}
sendTransaction(signedTransaction) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const hexTx = yield Promise.resolve(signedTransaction).then(t => hexlify(t));
const tx = this.formatter.transaction(signedTransaction);
2021-07-23 02:21:24 -04:00
if (tx.confirmations == null) {
tx.confirmations = 0;
}
2021-05-17 16:19:36 -04:00
const blockNumber = yield this._getInternalBlockNumber(100 + 2 * this.pollingInterval);
2019-11-20 18:57:38 +09:00
try {
const hash = yield this.perform("sendTransaction", { signedTransaction: hexTx });
2021-05-17 16:19:36 -04:00
return this._wrapTransaction(tx, hash, blockNumber);
2019-11-20 18:57:38 +09:00
}
catch (error) {
error.transaction = tx;
error.transactionHash = tx.hash;
throw error;
}
});
}
_getTransactionRequest(transaction) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
const values = yield transaction;
const tx = {};
["from", "to"].forEach((key) => {
2019-11-20 18:57:38 +09:00
if (values[key] == null) {
return;
}
tx[key] = Promise.resolve(values[key]).then((v) => (v ? this._getAddress(v) : null));
});
2021-07-29 23:30:17 -04:00
["gasLimit", "gasPrice", "maxFeePerGas", "maxPriorityFeePerGas", "value"].forEach((key) => {
2019-11-20 18:57:38 +09:00
if (values[key] == null) {
return;
}
2019-11-20 18:57:38 +09:00
tx[key] = Promise.resolve(values[key]).then((v) => (v ? BigNumber.from(v) : null));
});
2021-03-30 15:22:45 -04:00
["type"].forEach((key) => {
if (values[key] == null) {
return;
}
tx[key] = Promise.resolve(values[key]).then((v) => ((v != null) ? v : null));
});
if (values.accessList) {
tx.accessList = this.formatter.accessList(values.accessList);
}
2019-11-20 18:57:38 +09:00
["data"].forEach((key) => {
if (values[key] == null) {
return;
}
2019-11-20 18:57:38 +09:00
tx[key] = Promise.resolve(values[key]).then((v) => (v ? hexlify(v) : null));
});
2019-11-20 18:57:38 +09:00
return this.formatter.transactionRequest(yield resolveProperties(tx));
});
}
_getFilter(filter) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
filter = yield filter;
2019-11-20 18:57:38 +09:00
const result = {};
if (filter.address != null) {
result.address = this._getAddress(filter.address);
}
2019-11-20 18:57:38 +09:00
["blockHash", "topics"].forEach((key) => {
if (filter[key] == null) {
return;
}
result[key] = filter[key];
});
["fromBlock", "toBlock"].forEach((key) => {
2019-11-20 18:57:38 +09:00
if (filter[key] == null) {
return;
}
2019-11-20 18:57:38 +09:00
result[key] = this._getBlockTag(filter[key]);
});
2020-04-23 23:35:39 -04:00
return this.formatter.filter(yield resolveProperties(result));
});
}
2022-03-09 02:56:08 -05:00
_call(transaction, blockTag, attempt) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2022-03-09 02:56:08 -05:00
if (attempt >= MAX_CCIP_REDIRECTS) {
logger.throwError("CCIP read exceeded maximum redirections", Logger.errors.SERVER_ERROR, {
redirects: attempt, transaction
});
}
const txSender = transaction.to;
const result = yield this.perform("call", { transaction, blockTag });
// CCIP Read request via OffchainLookup(address,string[],bytes,bytes4,bytes)
if (attempt >= 0 && blockTag === "latest" && txSender != null && result.substring(0, 10) === "0x556f1830" && (hexDataLength(result) % 32 === 4)) {
try {
const data = hexDataSlice(result, 4);
// Check the sender of the OffchainLookup matches the transaction
const sender = hexDataSlice(data, 0, 32);
if (!BigNumber.from(sender).eq(txSender)) {
logger.throwError("CCIP Read sender did not match", Logger.errors.CALL_EXCEPTION, {
name: "OffchainLookup",
signature: "OffchainLookup(address,string[],bytes,bytes4,bytes)",
transaction, data: result
});
}
// Read the URLs from the response
const urls = [];
const urlsOffset = BigNumber.from(hexDataSlice(data, 32, 64)).toNumber();
const urlsLength = BigNumber.from(hexDataSlice(data, urlsOffset, urlsOffset + 32)).toNumber();
const urlsData = hexDataSlice(data, urlsOffset + 32);
for (let u = 0; u < urlsLength; u++) {
const url = _parseString(urlsData, u * 32);
if (url == null) {
logger.throwError("CCIP Read contained corrupt URL string", Logger.errors.CALL_EXCEPTION, {
name: "OffchainLookup",
signature: "OffchainLookup(address,string[],bytes,bytes4,bytes)",
transaction, data: result
});
}
urls.push(url);
}
// Get the CCIP calldata to forward
const calldata = _parseBytes(data, 64);
// Get the callbackSelector (bytes4)
if (!BigNumber.from(hexDataSlice(data, 100, 128)).isZero()) {
logger.throwError("CCIP Read callback selector included junk", Logger.errors.CALL_EXCEPTION, {
name: "OffchainLookup",
signature: "OffchainLookup(address,string[],bytes,bytes4,bytes)",
transaction, data: result
});
}
const callbackSelector = hexDataSlice(data, 96, 100);
// Get the extra data to send back to the contract as context
const extraData = _parseBytes(data, 128);
const ccipResult = yield this.ccipReadFetch(transaction, calldata, urls);
if (ccipResult == null) {
logger.throwError("CCIP Read disabled or provided no URLs", Logger.errors.CALL_EXCEPTION, {
name: "OffchainLookup",
signature: "OffchainLookup(address,string[],bytes,bytes4,bytes)",
transaction, data: result
});
}
const tx = {
to: txSender,
data: hexConcat([callbackSelector, encodeBytes([ccipResult, extraData])])
};
return this._call(tx, blockTag, attempt + 1);
}
catch (error) {
if (error.code === Logger.errors.SERVER_ERROR) {
throw error;
}
}
}
2021-02-12 19:06:01 -05:00
try {
return hexlify(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "call",
2022-03-09 02:56:08 -05:00
params: { transaction, blockTag }, result, error
2021-02-12 19:06:01 -05:00
});
}
});
}
2022-03-09 02:56:08 -05:00
call(transaction, blockTag) {
return __awaiter(this, void 0, void 0, function* () {
yield this.getNetwork();
const resolved = yield resolveProperties({
transaction: this._getTransactionRequest(transaction),
blockTag: this._getBlockTag(blockTag),
ccipReadEnabled: Promise.resolve(transaction.ccipReadEnabled)
});
return this._call(resolved.transaction, resolved.blockTag, resolved.ccipReadEnabled ? 0 : -1);
});
}
estimateGas(transaction) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({
transaction: this._getTransactionRequest(transaction)
});
2021-02-12 19:06:01 -05:00
const result = yield this.perform("estimateGas", params);
try {
return BigNumber.from(result);
}
catch (error) {
return logger.throwError("bad result from backend", Logger.errors.SERVER_ERROR, {
method: "estimateGas",
params, result, error
});
}
});
}
_getAddress(addressOrName) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2021-10-16 02:29:27 -04:00
addressOrName = yield addressOrName;
if (typeof (addressOrName) !== "string") {
logger.throwArgumentError("invalid address or ENS name", "name", addressOrName);
}
2019-11-20 18:57:38 +09:00
const address = yield this.resolveName(addressOrName);
if (address == null) {
logger.throwError("ENS name not configured", Logger.errors.UNSUPPORTED_OPERATION, {
operation: `resolveName(${JSON.stringify(addressOrName)})`
});
}
return address;
});
}
_getBlock(blockHashOrBlockTag, includeTransactions) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
blockHashOrBlockTag = yield blockHashOrBlockTag;
2019-11-20 18:57:38 +09:00
// If blockTag is a number (not "latest", etc), this is the block number
let blockNumber = -128;
const params = {
includeTransactions: !!includeTransactions
};
2019-10-17 01:12:03 +09:00
if (isHexString(blockHashOrBlockTag, 32)) {
2019-11-20 18:57:38 +09:00
params.blockHash = blockHashOrBlockTag;
2019-10-17 01:12:03 +09:00
}
else {
2019-11-20 18:57:38 +09:00
try {
2021-10-16 02:29:27 -04:00
params.blockTag = yield this._getBlockTag(blockHashOrBlockTag);
2019-11-20 18:57:38 +09:00
if (isHexString(params.blockTag)) {
blockNumber = parseInt(params.blockTag.substring(2), 16);
}
}
catch (error) {
logger.throwArgumentError("invalid block hash or block tag", "blockHashOrBlockTag", blockHashOrBlockTag);
}
2019-11-20 18:57:38 +09:00
}
return poll(() => __awaiter(this, void 0, void 0, function* () {
const block = yield this.perform("getBlock", params);
// Block was not found
if (block == null) {
// For blockhashes, if we didn't say it existed, that blockhash may
// not exist. If we did see it though, perhaps from a log, we know
// it exists, and this node is just not caught up yet.
if (params.blockHash != null) {
if (this._emitted["b:" + params.blockHash] == null) {
return null;
}
}
2019-11-20 18:57:38 +09:00
// For block tags, if we are asking for a future block, we return null
if (params.blockTag != null) {
if (blockNumber > this._emitted.block) {
return null;
}
}
2019-11-20 18:57:38 +09:00
// Retry on the next block
return undefined;
}
2019-11-20 18:57:38 +09:00
// Add transactions
if (includeTransactions) {
2020-01-18 21:48:12 -05:00
let blockNumber = null;
for (let i = 0; i < block.transactions.length; i++) {
const tx = block.transactions[i];
if (tx.blockNumber == null) {
tx.confirmations = 0;
}
else if (tx.confirmations == null) {
if (blockNumber == null) {
blockNumber = yield this._getInternalBlockNumber(100 + 2 * this.pollingInterval);
}
// Add the confirmations using the fast block number (pessimistic)
let confirmations = (blockNumber - tx.blockNumber) + 1;
if (confirmations <= 0) {
confirmations = 1;
}
tx.confirmations = confirmations;
}
}
2021-07-23 02:21:24 -04:00
const blockWithTxs = this.formatter.blockWithTransactions(block);
2021-08-18 03:05:48 -03:00
blockWithTxs.transactions = blockWithTxs.transactions.map((tx) => this._wrapTransaction(tx));
2021-07-23 02:21:24 -04:00
return blockWithTxs;
2019-11-20 18:57:38 +09:00
}
return this.formatter.block(block);
2020-05-29 21:27:59 -04:00
}), { oncePoll: this });
});
}
getBlock(blockHashOrBlockTag) {
return (this._getBlock(blockHashOrBlockTag, false));
}
getBlockWithTransactions(blockHashOrBlockTag) {
return (this._getBlock(blockHashOrBlockTag, true));
}
getTransaction(transactionHash) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
transactionHash = yield transactionHash;
2019-11-20 18:57:38 +09:00
const params = { transactionHash: this.formatter.hash(transactionHash, true) };
return poll(() => __awaiter(this, void 0, void 0, function* () {
const result = yield this.perform("getTransaction", params);
if (result == null) {
if (this._emitted["t:" + transactionHash] == null) {
return null;
}
return undefined;
}
const tx = this.formatter.transactionResponse(result);
if (tx.blockNumber == null) {
tx.confirmations = 0;
}
else if (tx.confirmations == null) {
const blockNumber = yield this._getInternalBlockNumber(100 + 2 * this.pollingInterval);
// Add the confirmations using the fast block number (pessimistic)
let confirmations = (blockNumber - tx.blockNumber) + 1;
if (confirmations <= 0) {
confirmations = 1;
}
tx.confirmations = confirmations;
}
return this._wrapTransaction(tx);
2020-05-29 21:27:59 -04:00
}), { oncePoll: this });
});
}
getTransactionReceipt(transactionHash) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
transactionHash = yield transactionHash;
2019-11-20 18:57:38 +09:00
const params = { transactionHash: this.formatter.hash(transactionHash, true) };
return poll(() => __awaiter(this, void 0, void 0, function* () {
const result = yield this.perform("getTransactionReceipt", params);
if (result == null) {
if (this._emitted["t:" + transactionHash] == null) {
return null;
}
return undefined;
}
// "geth-etc" returns receipts before they are ready
if (result.blockHash == null) {
return undefined;
}
const receipt = this.formatter.receipt(result);
if (receipt.blockNumber == null) {
receipt.confirmations = 0;
}
else if (receipt.confirmations == null) {
const blockNumber = yield this._getInternalBlockNumber(100 + 2 * this.pollingInterval);
// Add the confirmations using the fast block number (pessimistic)
let confirmations = (blockNumber - receipt.blockNumber) + 1;
if (confirmations <= 0) {
confirmations = 1;
}
receipt.confirmations = confirmations;
}
return receipt;
2020-05-29 21:27:59 -04:00
}), { oncePoll: this });
});
}
getLogs(filter) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
const params = yield resolveProperties({ filter: this._getFilter(filter) });
const logs = yield this.perform("getLogs", params);
2020-01-18 21:48:12 -05:00
logs.forEach((log) => {
if (log.removed == null) {
log.removed = false;
}
});
2019-11-20 18:57:38 +09:00
return Formatter.arrayOf(this.formatter.filterLog.bind(this.formatter))(logs);
});
}
getEtherPrice() {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
yield this.getNetwork();
2019-11-20 18:57:38 +09:00
return this.perform("getEtherPrice", {});
});
}
_getBlockTag(blockTag) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
blockTag = yield blockTag;
2019-11-20 18:57:38 +09:00
if (typeof (blockTag) === "number" && blockTag < 0) {
if (blockTag % 1) {
logger.throwArgumentError("invalid BlockTag", "blockTag", blockTag);
}
2019-11-20 18:57:38 +09:00
let blockNumber = yield this._getInternalBlockNumber(100 + 2 * this.pollingInterval);
blockNumber += blockTag;
if (blockNumber < 0) {
blockNumber = 0;
}
return this.formatter.blockTag(blockNumber);
}
return this.formatter.blockTag(blockTag);
});
}
2020-09-04 01:37:14 -04:00
getResolver(name) {
return __awaiter(this, void 0, void 0, function* () {
2022-03-09 02:56:08 -05:00
let currentName = name;
while (true) {
if (currentName === "" || currentName === ".") {
2021-06-24 02:13:06 -04:00
return null;
}
2022-03-09 02:56:08 -05:00
// Optimization since the eth node cannot change and does
2022-05-01 02:11:22 -04:00
// not have a wildcard resolver
2022-03-09 02:56:08 -05:00
if (name !== "eth" && currentName === "eth") {
2021-06-24 02:13:06 -04:00
return null;
}
2022-03-09 02:56:08 -05:00
// Check the current node for a resolver
const addr = yield this._getResolver(currentName, "getResolver");
// Found a resolver!
if (addr != null) {
const resolver = new Resolver(this, addr, name);
// Legacy resolver found, using EIP-2544 so it isn't safe to use
if (currentName !== name && !(yield resolver.supportsWildcard())) {
return null;
}
return resolver;
}
// Get the parent node
currentName = currentName.split(".").slice(1).join(".");
2020-09-04 01:37:14 -04:00
}
});
}
2022-03-09 02:56:08 -05:00
_getResolver(name, operation) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2022-03-09 02:56:08 -05:00
if (operation == null) {
operation = "ENS";
}
2019-11-20 18:57:38 +09:00
const network = yield this.getNetwork();
// No ENS...
if (!network.ensAddress) {
2022-03-09 02:56:08 -05:00
logger.throwError("network does not support ENS", Logger.errors.UNSUPPORTED_OPERATION, { operation, network: network.name });
}
2021-06-24 02:13:06 -04:00
try {
2022-03-09 02:56:08 -05:00
// keccak256("resolver(bytes32)")
const addrData = yield this.call({
to: network.ensAddress,
data: ("0x0178b8bf" + namehash(name).substring(2))
});
return this.formatter.callAddress(addrData);
2021-06-24 02:13:06 -04:00
}
catch (error) {
2022-03-09 02:56:08 -05:00
// ENS registry cannot throw errors on resolver(bytes32)
2021-06-24 02:13:06 -04:00
}
2022-03-09 02:56:08 -05:00
return null;
});
}
resolveName(name) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
name = yield name;
2019-11-20 18:57:38 +09:00
// If it is already an address, nothing to resolve
try {
return Promise.resolve(this.formatter.address(name));
}
2020-01-07 19:58:04 -05:00
catch (error) {
// If is is a hexstring, the address is bad (See #694)
if (isHexString(name)) {
throw error;
}
}
2020-04-03 22:13:06 -04:00
if (typeof (name) !== "string") {
logger.throwArgumentError("invalid ENS name", "name", name);
}
2022-05-01 02:11:22 -04:00
// Get the addr from the resolver
2020-09-04 01:37:14 -04:00
const resolver = yield this.getResolver(name);
if (!resolver) {
return null;
}
2020-09-04 01:37:14 -04:00
return yield resolver.getAddress();
});
}
lookupAddress(address) {
2019-11-20 18:57:38 +09:00
return __awaiter(this, void 0, void 0, function* () {
2020-06-03 03:47:17 -04:00
address = yield address;
2019-11-20 18:57:38 +09:00
address = this.formatter.address(address);
2022-03-09 02:56:08 -05:00
const node = address.substring(2).toLowerCase() + ".addr.reverse";
const resolverAddr = yield this._getResolver(node, "lookupAddress");
if (resolverAddr == null) {
return null;
}
// keccak("name(bytes32)")
2022-03-09 02:56:08 -05:00
const name = _parseString(yield this.call({
to: resolverAddr,
data: ("0x691f3431" + namehash(node).substring(2))
}), 0);
2019-11-20 18:57:38 +09:00
const addr = yield this.resolveName(name);
if (addr != address) {
return null;
}
return name;
});
}
2021-10-19 00:01:37 -04:00
getAvatar(nameOrAddress) {
return __awaiter(this, void 0, void 0, function* () {
let resolver = null;
if (isHexString(nameOrAddress)) {
// Address; reverse lookup
const address = this.formatter.address(nameOrAddress);
2022-03-09 02:56:08 -05:00
const node = address.substring(2).toLowerCase() + ".addr.reverse";
const resolverAddress = yield this._getResolver(node, "getAvatar");
2021-10-19 00:01:37 -04:00
if (!resolverAddress) {
return null;
}
2022-03-09 02:56:08 -05:00
// Try resolving the avatar against the addr.reverse resolver
resolver = new Resolver(this, resolverAddress, node);
try {
const avatar = yield resolver.getAvatar();
if (avatar) {
return avatar.url;
}
}
catch (error) {
if (error.code !== Logger.errors.CALL_EXCEPTION) {
throw error;
}
}
// Try getting the name and performing forward lookup; allowing wildcards
try {
// keccak("name(bytes32)")
const name = _parseString(yield this.call({
to: resolverAddress,
data: ("0x691f3431" + namehash(node).substring(2))
}), 0);
resolver = yield this.getResolver(name);
}
catch (error) {
if (error.code !== Logger.errors.CALL_EXCEPTION) {
throw error;
}
return null;
}
2021-10-19 00:01:37 -04:00
}
else {
2022-03-09 02:56:08 -05:00
// ENS name; forward lookup with wildcard
2021-10-19 00:01:37 -04:00
resolver = yield this.getResolver(nameOrAddress);
2021-11-30 11:19:37 -05:00
if (!resolver) {
return null;
}
2021-10-19 00:01:37 -04:00
}
const avatar = yield resolver.getAvatar();
if (avatar == null) {
return null;
}
return avatar.url;
});
}
perform(method, params) {
return logger.throwError(method + " not implemented", Logger.errors.NOT_IMPLEMENTED, { operation: method });
}
2020-03-12 19:14:50 +01:00
_startEvent(event) {
this.polling = (this._events.filter((e) => e.pollable()).length > 0);
}
2020-03-12 19:14:50 +01:00
_stopEvent(event) {
this.polling = (this._events.filter((e) => e.pollable()).length > 0);
}
_addEventListener(eventName, listener, once) {
2020-03-12 19:14:50 +01:00
const event = new Event(getEventTag(eventName), listener, once);
this._events.push(event);
this._startEvent(event);
return this;
}
on(eventName, listener) {
return this._addEventListener(eventName, listener, false);
}
once(eventName, listener) {
return this._addEventListener(eventName, listener, true);
}
emit(eventName, ...args) {
let result = false;
2020-03-12 19:14:50 +01:00
let stopped = [];
let eventTag = getEventTag(eventName);
this._events = this._events.filter((event) => {
if (event.tag !== eventTag) {
return true;
}
setTimeout(() => {
event.listener.apply(this, args);
}, 0);
result = true;
2020-03-12 19:14:50 +01:00
if (event.once) {
stopped.push(event);
return false;
}
return true;
});
2020-03-12 19:14:50 +01:00
stopped.forEach((event) => { this._stopEvent(event); });
return result;
}
listenerCount(eventName) {
if (!eventName) {
return this._events.length;
}
let eventTag = getEventTag(eventName);
return this._events.filter((event) => {
return (event.tag === eventTag);
}).length;
}
listeners(eventName) {
if (eventName == null) {
return this._events.map((event) => event.listener);
}
let eventTag = getEventTag(eventName);
return this._events
.filter((event) => (event.tag === eventTag))
.map((event) => event.listener);
}
off(eventName, listener) {
if (listener == null) {
return this.removeAllListeners(eventName);
}
2020-03-12 19:14:50 +01:00
const stopped = [];
let found = false;
let eventTag = getEventTag(eventName);
this._events = this._events.filter((event) => {
if (event.tag !== eventTag || event.listener != listener) {
return true;
}
if (found) {
return true;
}
found = true;
2020-03-12 19:14:50 +01:00
stopped.push(event);
return false;
});
2020-03-12 19:14:50 +01:00
stopped.forEach((event) => { this._stopEvent(event); });
return this;
}
removeAllListeners(eventName) {
2020-03-12 19:14:50 +01:00
let stopped = [];
if (eventName == null) {
2020-03-12 19:14:50 +01:00
stopped = this._events;
this._events = [];
}
else {
2020-03-12 19:14:50 +01:00
const eventTag = getEventTag(eventName);
this._events = this._events.filter((event) => {
2020-03-12 19:14:50 +01:00
if (event.tag !== eventTag) {
return true;
}
stopped.push(event);
return false;
});
}
2020-03-12 19:14:50 +01:00
stopped.forEach((event) => { this._stopEvent(event); });
return this;
}
}
2020-07-13 08:03:56 -04:00
//# sourceMappingURL=base-provider.js.map