ethers.js/lib.commonjs/providers/provider.js

1207 lines
39 KiB
JavaScript
Raw Normal View History

2022-09-05 23:57:11 +03:00
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
2022-09-27 10:45:27 +03:00
exports.TransactionResponse = exports.TransactionReceipt = exports.Log = exports.Block = exports.copyRequest = exports.FeeData = void 0;
2022-09-05 23:57:11 +03:00
//import { resolveAddress } from "@ethersproject/address";
2022-09-16 05:58:45 +03:00
const index_js_1 = require("../utils/index.js");
const index_js_2 = require("../transaction/index.js");
2022-09-27 10:45:27 +03:00
const BN_0 = BigInt(0);
2022-09-05 23:57:11 +03:00
// -----------------------
function getValue(value) {
if (value == null) {
return null;
}
return value;
}
function toJson(value) {
if (value == null) {
return null;
}
return value.toString();
}
// @TODO? <T extends FeeData = { }> implements Required<T>
2022-11-30 23:44:23 +03:00
/**
* A **FeeData** wraps all the fee-related values associated with
* the network.
*/
2022-09-05 23:57:11 +03:00
class FeeData {
2022-11-30 23:44:23 +03:00
/**
* The gas price for legacy networks.
*/
2022-09-05 23:57:11 +03:00
gasPrice;
2022-11-30 23:44:23 +03:00
/**
* The maximum fee to pay per gas.
*
* The base fee per gas is defined by the network and based on
* congestion, increasing the cost during times of heavy load
* and lowering when less busy.
*
* The actual fee per gas will be the base fee for the block
* and the priority fee, up to the max fee per gas.
*
* This will be ``null`` on legacy networks (i.e. [pre-EIP-1559](link-eip-1559))
*/
2022-09-05 23:57:11 +03:00
maxFeePerGas;
2022-11-30 23:44:23 +03:00
/**
* The additional amout to pay per gas to encourage a validator
* to include the transaction.
*
* The purpose of this is to compensate the validator for the
* adjusted risk for including a given transaction.
*
* This will be ``null`` on legacy networks (i.e. [pre-EIP-1559](link-eip-1559))
*/
2022-09-05 23:57:11 +03:00
maxPriorityFeePerGas;
2022-11-30 23:44:23 +03:00
/**
* Creates a new FeeData for %%gasPrice%%, %%maxFeePerGas%% and
* %%maxPriorityFeePerGas%%.
*/
2022-09-05 23:57:11 +03:00
constructor(gasPrice, maxFeePerGas, maxPriorityFeePerGas) {
2022-09-16 05:58:45 +03:00
(0, index_js_1.defineProperties)(this, {
2022-09-05 23:57:11 +03:00
gasPrice: getValue(gasPrice),
maxFeePerGas: getValue(maxFeePerGas),
maxPriorityFeePerGas: getValue(maxPriorityFeePerGas)
});
}
2022-11-30 23:44:23 +03:00
/**
* Returns a JSON-friendly value.
*/
2022-09-05 23:57:11 +03:00
toJSON() {
const { gasPrice, maxFeePerGas, maxPriorityFeePerGas } = this;
return {
_type: "FeeData",
gasPrice: toJson(gasPrice),
maxFeePerGas: toJson(maxFeePerGas),
maxPriorityFeePerGas: toJson(maxPriorityFeePerGas),
};
}
}
exports.FeeData = FeeData;
;
2023-06-02 00:52:58 +03:00
/**
* Returns a copy of %%req%% with all properties coerced to their strict
* types.
*/
2022-09-05 23:57:11 +03:00
function copyRequest(req) {
const result = {};
// These could be addresses, ENS names or Addressables
if (req.to) {
result.to = req.to;
}
if (req.from) {
result.from = req.from;
}
if (req.data) {
2022-09-16 05:58:45 +03:00
result.data = (0, index_js_1.hexlify)(req.data);
2022-09-05 23:57:11 +03:00
}
2023-02-19 06:18:42 +03:00
const bigIntKeys = "chainId,gasLimit,gasPrice,maxFeePerGas,maxPriorityFeePerGas,value".split(/,/);
2022-10-20 12:03:32 +03:00
for (const key of bigIntKeys) {
2022-09-05 23:57:11 +03:00
if (!(key in req) || req[key] == null) {
continue;
}
2022-09-16 05:58:45 +03:00
result[key] = (0, index_js_1.getBigInt)(req[key], `request.${key}`);
2022-09-05 23:57:11 +03:00
}
const numberKeys = "type,nonce".split(/,/);
2022-10-20 12:03:32 +03:00
for (const key of numberKeys) {
2022-09-05 23:57:11 +03:00
if (!(key in req) || req[key] == null) {
continue;
}
2022-09-16 05:58:45 +03:00
result[key] = (0, index_js_1.getNumber)(req[key], `request.${key}`);
2022-09-05 23:57:11 +03:00
}
if (req.accessList) {
2022-09-16 05:58:45 +03:00
result.accessList = (0, index_js_2.accessListify)(req.accessList);
2022-09-05 23:57:11 +03:00
}
if ("blockTag" in req) {
result.blockTag = req.blockTag;
}
if ("enableCcipRead" in req) {
2023-06-23 07:07:06 +03:00
result.enableCcipRead = !!req.enableCcipRead;
2022-09-05 23:57:11 +03:00
}
if ("customData" in req) {
result.customData = req.customData;
}
return result;
}
exports.copyRequest = copyRequest;
2022-11-30 23:44:23 +03:00
/**
* A **Block** represents the data associated with a full block on
* Ethereum.
*/
2022-09-05 23:57:11 +03:00
class Block {
2022-11-30 23:44:23 +03:00
/**
* The provider connected to the block used to fetch additional details
* if necessary.
*/
2022-09-05 23:57:11 +03:00
provider;
2022-11-30 23:44:23 +03:00
/**
* The block number, sometimes called the block height. This is a
* sequential number that is one higher than the parent block.
*/
2022-09-05 23:57:11 +03:00
number;
2022-11-30 23:44:23 +03:00
/**
* The block hash.
2023-06-02 00:52:58 +03:00
*
* This hash includes all properties, so can be safely used to identify
* an exact set of block properties.
2022-11-30 23:44:23 +03:00
*/
2022-09-05 23:57:11 +03:00
hash;
2022-11-30 23:44:23 +03:00
/**
* The timestamp for this block, which is the number of seconds since
* epoch that this block was included.
*/
2022-09-05 23:57:11 +03:00
timestamp;
2022-11-30 23:44:23 +03:00
/**
* The block hash of the parent block.
*/
2022-09-05 23:57:11 +03:00
parentHash;
2022-11-30 23:44:23 +03:00
/**
* The nonce.
*
* On legacy networks, this is the random number inserted which
* permitted the difficulty target to be reached.
*/
2022-09-05 23:57:11 +03:00
nonce;
2022-11-30 23:44:23 +03:00
/**
* The difficulty target.
*
* On legacy networks, this is the proof-of-work target required
* for a block to meet the protocol rules to be included.
*
* On modern networks, this is a random number arrived at using
* randao. @TODO: Find links?
*/
2022-09-05 23:57:11 +03:00
difficulty;
2022-11-30 23:44:23 +03:00
/**
* The total gas limit for this block.
*/
2022-09-05 23:57:11 +03:00
gasLimit;
2022-11-30 23:44:23 +03:00
/**
* The total gas used in this block.
*/
2022-09-05 23:57:11 +03:00
gasUsed;
2022-11-30 23:44:23 +03:00
/**
* The miner coinbase address, wihch receives any subsidies for
* including this block.
*/
2022-09-05 23:57:11 +03:00
miner;
2022-11-30 23:44:23 +03:00
/**
* Any extra data the validator wished to include.
*/
2022-09-05 23:57:11 +03:00
extraData;
2022-11-30 23:44:23 +03:00
/**
* The base fee per gas that all transactions in this block were
* charged.
*
* This adjusts after each block, depending on how congested the network
* is.
*/
2022-09-05 23:57:11 +03:00
baseFeePerGas;
#transactions;
2022-11-30 23:44:23 +03:00
/**
* Create a new **Block** object.
*
* This should generally not be necessary as the unless implementing a
* low-level library.
*/
2022-09-05 23:57:11 +03:00
constructor(block, provider) {
2022-11-30 23:44:23 +03:00
this.#transactions = block.transactions.map((tx) => {
if (typeof (tx) !== "string") {
return new TransactionResponse(tx, provider);
2022-09-05 23:57:11 +03:00
}
return tx;
2022-11-30 23:44:23 +03:00
});
2022-09-16 05:58:45 +03:00
(0, index_js_1.defineProperties)(this, {
2022-09-05 23:57:11 +03:00
provider,
hash: getValue(block.hash),
number: block.number,
timestamp: block.timestamp,
parentHash: block.parentHash,
nonce: block.nonce,
difficulty: block.difficulty,
gasLimit: block.gasLimit,
gasUsed: block.gasUsed,
miner: block.miner,
extraData: block.extraData,
baseFeePerGas: getValue(block.baseFeePerGas)
});
}
2022-11-30 23:44:23 +03:00
/**
* Returns the list of transaction hashes.
*/
get transactions() {
return this.#transactions.map((tx) => {
if (typeof (tx) === "string") {
return tx;
}
return tx.hash;
});
}
2023-01-27 07:36:26 +03:00
/**
* Returns the complete transactions for blocks which
* prefetched them, by passing ``true`` to %%prefetchTxs%%
2023-06-02 00:52:58 +03:00
* into [[Provider-getBlock]].
2023-01-27 07:36:26 +03:00
*/
2023-02-03 06:21:31 +03:00
get prefetchedTransactions() {
2023-01-27 07:36:26 +03:00
const txs = this.#transactions.slice();
// Doesn't matter...
if (txs.length === 0) {
return [];
}
// Make sure we prefetched the transactions
(0, index_js_1.assert)(typeof (txs[0]) === "object", "transactions were not prefetched with block request", "UNSUPPORTED_OPERATION", {
operation: "transactionResponses()"
});
return txs;
}
2022-11-30 23:44:23 +03:00
/**
* Returns a JSON-friendly value.
*/
2022-09-05 23:57:11 +03:00
toJSON() {
const { baseFeePerGas, difficulty, extraData, gasLimit, gasUsed, hash, miner, nonce, number, parentHash, timestamp, transactions } = this;
return {
_type: "Block",
baseFeePerGas: toJson(baseFeePerGas),
difficulty: toJson(difficulty),
extraData,
gasLimit: toJson(gasLimit),
gasUsed: toJson(gasUsed),
hash, miner, nonce, number, parentHash, timestamp,
transactions,
};
}
[Symbol.iterator]() {
let index = 0;
2022-11-30 23:44:23 +03:00
const txs = this.transactions;
2022-09-05 23:57:11 +03:00
return {
next: () => {
if (index < this.length) {
return {
2022-11-30 23:44:23 +03:00
value: txs[index++], done: false
2022-09-05 23:57:11 +03:00
};
}
return { value: undefined, done: true };
}
};
}
2022-11-30 23:44:23 +03:00
/**
* The number of transactions in this block.
*/
get length() { return this.#transactions.length; }
/**
2022-12-03 05:27:06 +03:00
* The [[link-js-date]] this block was included at.
2022-11-30 23:44:23 +03:00
*/
2022-09-05 23:57:11 +03:00
get date() {
if (this.timestamp == null) {
return null;
}
return new Date(this.timestamp * 1000);
}
2022-11-30 23:44:23 +03:00
/**
* Get the transaction at %%indexe%% within this block.
*/
async getTransaction(indexOrHash) {
// Find the internal value by its index or hash
let tx = undefined;
if (typeof (indexOrHash) === "number") {
tx = this.#transactions[indexOrHash];
}
else {
const hash = indexOrHash.toLowerCase();
for (const v of this.#transactions) {
if (typeof (v) === "string") {
if (v !== hash) {
continue;
}
tx = v;
break;
}
else {
if (v.hash === hash) {
continue;
}
tx = v;
break;
}
}
}
2022-09-05 23:57:11 +03:00
if (tx == null) {
throw new Error("no such tx");
}
if (typeof (tx) === "string") {
return (await this.provider.getTransaction(tx));
}
else {
return tx;
}
}
2023-06-02 00:52:58 +03:00
/**
* If a **Block** was fetched with a request to include the transactions
* this will allow synchronous access to those transactions.
*
* If the transactions were not prefetched, this will throw.
*/
2023-02-03 06:21:31 +03:00
getPrefetchedTransaction(indexOrHash) {
const txs = this.prefetchedTransactions;
2023-01-27 07:36:26 +03:00
if (typeof (indexOrHash) === "number") {
return txs[indexOrHash];
}
indexOrHash = indexOrHash.toLowerCase();
for (const tx of txs) {
if (tx.hash === indexOrHash) {
return tx;
}
}
2023-02-03 06:21:31 +03:00
(0, index_js_1.assertArgument)(false, "no matching transaction", "indexOrHash", indexOrHash);
2023-01-27 07:36:26 +03:00
}
2022-11-30 23:44:23 +03:00
/**
2023-06-02 00:52:58 +03:00
* Returns true if this block been mined. This provides a type guard
* for all properties on a [[MinedBlock]].
2022-11-30 23:44:23 +03:00
*/
2022-09-05 23:57:11 +03:00
isMined() { return !!this.hash; }
2022-11-30 23:44:23 +03:00
/**
2023-06-02 00:52:58 +03:00
* Returns true if this block is an [[link-eip-2930]] block.
2022-11-30 23:44:23 +03:00
*/
2022-09-16 05:58:45 +03:00
isLondon() {
return !!this.baseFeePerGas;
}
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
orphanedEvent() {
if (!this.isMined()) {
throw new Error("");
}
return createOrphanedBlockFilter(this);
}
}
exports.Block = Block;
2022-11-30 23:44:23 +03:00
//////////////////////
// Log
2023-06-02 00:52:58 +03:00
/**
* A **Log** in Ethereum represents an event that has been included in a
* transaction using the ``LOG*`` opcodes, which are most commonly used by
* Solidity's emit for announcing events.
*/
2022-09-05 23:57:11 +03:00
class Log {
2023-06-02 00:52:58 +03:00
/**
* The provider connected to the log used to fetch additional details
* if necessary.
*/
2022-09-05 23:57:11 +03:00
provider;
2023-06-02 00:52:58 +03:00
/**
* The transaction hash of the transaction this log occurred in. Use the
* [[Log-getTransaction]] to get the [[TransactionResponse]].
*/
2022-09-05 23:57:11 +03:00
transactionHash;
2023-06-02 00:52:58 +03:00
/**
* The block hash of the block this log occurred in. Use the
* [[Log-getBlock]] to get the [[Block]].
*/
2022-09-05 23:57:11 +03:00
blockHash;
2023-06-02 00:52:58 +03:00
/**
* The block number of the block this log occurred in. It is preferred
* to use the [[Block-hash]] when fetching the related [[Block]],
* since in the case of an orphaned block, the block at that height may
* have changed.
*/
2022-09-05 23:57:11 +03:00
blockNumber;
2023-06-02 00:52:58 +03:00
/**
* If the **Log** represents a block that was removed due to an orphaned
* block, this will be true.
*
* This can only happen within an orphan event listener.
*/
2022-09-05 23:57:11 +03:00
removed;
2023-06-02 00:52:58 +03:00
/**
* The address of the contract that emitted this log.
*/
2022-09-05 23:57:11 +03:00
address;
2023-06-02 00:52:58 +03:00
/**
* The data included in this log when it was emitted.
*/
2022-09-05 23:57:11 +03:00
data;
2023-06-02 00:52:58 +03:00
/**
* The indexed topics included in this log when it was emitted.
*
* All topics are included in the bloom filters, so they can be
* efficiently filtered using the [[Provider-getLogs]] method.
*/
2022-09-05 23:57:11 +03:00
topics;
2023-06-02 00:52:58 +03:00
/**
* The index within the block this log occurred at. This is generally
* not useful to developers, but can be used with the various roots
* to proof inclusion within a block.
*/
2022-09-05 23:57:11 +03:00
index;
2023-06-02 00:52:58 +03:00
/**
* The index within the transaction of this log.
*/
2022-09-05 23:57:11 +03:00
transactionIndex;
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
constructor(log, provider) {
this.provider = provider;
const topics = Object.freeze(log.topics.slice());
2022-09-16 05:58:45 +03:00
(0, index_js_1.defineProperties)(this, {
2022-09-05 23:57:11 +03:00
transactionHash: log.transactionHash,
blockHash: log.blockHash,
blockNumber: log.blockNumber,
removed: log.removed,
address: log.address,
data: log.data,
topics,
index: log.index,
transactionIndex: log.transactionIndex,
});
}
2023-06-02 00:52:58 +03:00
/**
* Returns a JSON-compatible object.
*/
2022-09-05 23:57:11 +03:00
toJSON() {
const { address, blockHash, blockNumber, data, index, removed, topics, transactionHash, transactionIndex } = this;
return {
_type: "log",
address, blockHash, blockNumber, data, index,
removed, topics, transactionHash, transactionIndex
};
}
2023-06-02 00:52:58 +03:00
/**
* Returns the block that this log occurred in.
*/
2022-09-05 23:57:11 +03:00
async getBlock() {
2022-11-30 23:44:23 +03:00
const block = await this.provider.getBlock(this.blockHash);
(0, index_js_1.assert)(!!block, "failed to find transaction", "UNKNOWN_ERROR", {});
return block;
2022-09-05 23:57:11 +03:00
}
2023-06-02 00:52:58 +03:00
/**
* Returns the transaction that this log occurred in.
*/
2022-09-05 23:57:11 +03:00
async getTransaction() {
2022-11-30 23:44:23 +03:00
const tx = await this.provider.getTransaction(this.transactionHash);
(0, index_js_1.assert)(!!tx, "failed to find transaction", "UNKNOWN_ERROR", {});
return tx;
2022-09-05 23:57:11 +03:00
}
2023-06-02 00:52:58 +03:00
/**
* Returns the transaction receipt fot the transaction that this
* log occurred in.
*/
2022-09-05 23:57:11 +03:00
async getTransactionReceipt() {
2022-11-30 23:44:23 +03:00
const receipt = await this.provider.getTransactionReceipt(this.transactionHash);
(0, index_js_1.assert)(!!receipt, "failed to find transaction receipt", "UNKNOWN_ERROR", {});
return receipt;
2022-09-05 23:57:11 +03:00
}
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
removedEvent() {
return createRemovedLogFilter(this);
}
}
exports.Log = Log;
2022-11-30 23:44:23 +03:00
//////////////////////
// Transaction Receipt
/*
2022-09-16 05:58:45 +03:00
export interface LegacyTransactionReceipt {
byzantium: false;
status: null;
root: string;
}
export interface ByzantiumTransactionReceipt {
byzantium: true;
status: number;
root: null;
}
*/
2023-06-02 00:52:58 +03:00
/**
* A **TransactionReceipt** includes additional information about a
* transaction that is only available after it has been mined.
*/
2022-09-05 23:57:11 +03:00
class TransactionReceipt {
2023-06-02 00:52:58 +03:00
/**
* The provider connected to the log used to fetch additional details
* if necessary.
*/
2022-09-05 23:57:11 +03:00
provider;
2023-06-02 00:52:58 +03:00
/**
* The address the transaction was send to.
*/
2022-09-05 23:57:11 +03:00
to;
2023-06-02 00:52:58 +03:00
/**
* The sender of the transaction.
*/
2022-09-05 23:57:11 +03:00
from;
2023-06-02 00:52:58 +03:00
/**
* The address of the contract if the transaction was directly
* responsible for deploying one.
*
* This is non-null **only** if the ``to`` is empty and the ``data``
* was successfully executed as initcode.
*/
2022-09-05 23:57:11 +03:00
contractAddress;
2023-06-02 00:52:58 +03:00
/**
* The transaction hash.
*/
2022-09-05 23:57:11 +03:00
hash;
2023-06-02 00:52:58 +03:00
/**
* The index of this transaction within the block transactions.
*/
2022-09-05 23:57:11 +03:00
index;
2023-06-02 00:52:58 +03:00
/**
* The block hash of the [[Block]] this transaction was included in.
*/
2022-09-05 23:57:11 +03:00
blockHash;
2023-06-02 00:52:58 +03:00
/**
* The block number of the [[Block]] this transaction was included in.
*/
2022-09-05 23:57:11 +03:00
blockNumber;
2023-06-02 00:52:58 +03:00
/**
* The bloom filter bytes that represent all logs that occurred within
* this transaction. This is generally not useful for most developers,
* but can be used to validate the included logs.
*/
2022-09-05 23:57:11 +03:00
logsBloom;
2023-06-02 00:52:58 +03:00
/**
* The actual amount of gas used by this transaction.
*
* When creating a transaction, the amount of gas that will be used can
* only be approximated, but the sender must pay the gas fee for the
* entire gas limit. After the transaction, the difference is refunded.
*/
2022-09-05 23:57:11 +03:00
gasUsed;
2023-06-02 00:52:58 +03:00
/**
* The amount of gas used by all transactions within the block for this
* and all transactions with a lower ``index``.
*
* This is generally not useful for developers but can be used to
* validate certain aspects of execution.
*/
2022-09-05 23:57:11 +03:00
cumulativeGasUsed;
2023-06-02 00:52:58 +03:00
/**
* The actual gas price used during execution.
*
* Due to the complexity of [[link-eip-1559]] this value can only
* be caluclated after the transaction has been mined, snce the base
* fee is protocol-enforced.
*/
2022-09-05 23:57:11 +03:00
gasPrice;
2023-06-02 00:52:58 +03:00
/**
* The [[link-eip-2718]] transaction type.
*/
2022-09-30 05:57:27 +03:00
type;
//readonly byzantium!: boolean;
2023-06-02 00:52:58 +03:00
/**
* The status of this transaction, indicating success (i.e. ``1``) or
* a revert (i.e. ``0``).
*
* This is available in post-byzantium blocks, but some backends may
* backfill this value.
*/
2022-09-05 23:57:11 +03:00
status;
2023-06-02 00:52:58 +03:00
/**
* The root hash of this transaction.
*
* This is no present and was only included in pre-byzantium blocks, but
* could be used to validate certain parts of the receipt.
*/
2022-09-05 23:57:11 +03:00
root;
#logs;
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
constructor(tx, provider) {
this.#logs = Object.freeze(tx.logs.map((log) => {
2022-09-30 05:57:27 +03:00
return new Log(log, provider);
2022-09-05 23:57:11 +03:00
}));
2023-05-06 09:16:41 +03:00
let gasPrice = BN_0;
if (tx.effectiveGasPrice != null) {
gasPrice = tx.effectiveGasPrice;
}
else if (tx.gasPrice != null) {
gasPrice = tx.gasPrice;
}
2022-09-16 05:58:45 +03:00
(0, index_js_1.defineProperties)(this, {
2022-09-05 23:57:11 +03:00
provider,
to: tx.to,
from: tx.from,
contractAddress: tx.contractAddress,
hash: tx.hash,
index: tx.index,
blockHash: tx.blockHash,
blockNumber: tx.blockNumber,
logsBloom: tx.logsBloom,
gasUsed: tx.gasUsed,
cumulativeGasUsed: tx.cumulativeGasUsed,
2023-05-06 09:16:41 +03:00
gasPrice,
2022-09-30 05:57:27 +03:00
type: tx.type,
//byzantium: tx.byzantium,
2022-09-05 23:57:11 +03:00
status: tx.status,
root: tx.root
});
}
2023-06-02 00:52:58 +03:00
/**
* The logs for this transaction.
*/
2022-09-05 23:57:11 +03:00
get logs() { return this.#logs; }
2023-06-02 00:52:58 +03:00
/**
* Returns a JSON-compatible representation.
*/
2022-09-05 23:57:11 +03:00
toJSON() {
2022-09-30 05:57:27 +03:00
const { to, from, contractAddress, hash, index, blockHash, blockNumber, logsBloom, logs, //byzantium,
status, root } = this;
2022-09-05 23:57:11 +03:00
return {
_type: "TransactionReceipt",
2022-09-30 05:57:27 +03:00
blockHash, blockNumber,
//byzantium,
contractAddress,
2022-09-05 23:57:11 +03:00
cumulativeGasUsed: toJson(this.cumulativeGasUsed),
from,
gasPrice: toJson(this.gasPrice),
gasUsed: toJson(this.gasUsed),
hash, index, logs, logsBloom, root, status, to
};
}
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
get length() { return this.logs.length; }
[Symbol.iterator]() {
let index = 0;
return {
next: () => {
if (index < this.length) {
return { value: this.logs[index++], done: false };
}
return { value: undefined, done: true };
}
};
}
2023-06-02 00:52:58 +03:00
/**
* The total fee for this transaction, in wei.
*/
2022-09-05 23:57:11 +03:00
get fee() {
return this.gasUsed * this.gasPrice;
}
2023-06-02 00:52:58 +03:00
/**
* Resolves to the block this transaction occurred in.
*/
2022-09-05 23:57:11 +03:00
async getBlock() {
const block = await this.provider.getBlock(this.blockHash);
if (block == null) {
throw new Error("TODO");
}
return block;
}
2023-06-02 00:52:58 +03:00
/**
* Resolves to the transaction this transaction occurred in.
*/
2022-09-05 23:57:11 +03:00
async getTransaction() {
const tx = await this.provider.getTransaction(this.hash);
if (tx == null) {
throw new Error("TODO");
}
return tx;
}
2023-06-02 00:52:58 +03:00
/**
* Resolves to the return value of the execution of this transaction.
*
* Support for this feature is limited, as it requires an archive node
* with the ``debug_`` or ``trace_`` API enabled.
*/
2022-09-16 05:58:45 +03:00
async getResult() {
return (await this.provider.getTransactionResult(this.hash));
}
2023-06-02 00:52:58 +03:00
/**
* Resolves to the number of confirmations this transaction has.
*/
2022-09-05 23:57:11 +03:00
async confirmations() {
return (await this.provider.getBlockNumber()) - this.blockNumber + 1;
}
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
removedEvent() {
return createRemovedTransactionFilter(this);
}
2023-06-02 00:52:58 +03:00
/**
* @_ignore:
*/
2022-09-05 23:57:11 +03:00
reorderedEvent(other) {
2022-11-09 10:57:02 +03:00
(0, index_js_1.assert)(!other || other.isMined(), "unmined 'other' transction cannot be orphaned", "UNSUPPORTED_OPERATION", { operation: "reorderedEvent(other)" });
2022-09-05 23:57:11 +03:00
return createReorderedTransactionFilter(this, other);
}
}
exports.TransactionReceipt = TransactionReceipt;
2023-06-02 00:52:58 +03:00
/**
* A **TransactionResponse** includes all properties about a transaction
* that was sent to the network, which may or may not be included in a
* block.
*
* The [[TransactionResponse-isMined]] can be used to check if the
* transaction has been mined as well as type guard that the otherwise
* possibly ``null`` properties are defined.
*/
2022-09-05 23:57:11 +03:00
class TransactionResponse {
2023-03-20 19:53:37 +03:00
/**
* The provider this is connected to, which will influence how its
* methods will resolve its async inspection methods.
*/
2022-09-05 23:57:11 +03:00
provider;
2023-03-20 19:53:37 +03:00
/**
* The block number of the block that this transaction was included in.
*
* This is ``null`` for pending transactions.
*/
2022-09-05 23:57:11 +03:00
blockNumber;
2023-03-20 19:53:37 +03:00
/**
* The blockHash of the block that this transaction was included in.
*
* This is ``null`` for pending transactions.
*/
2022-09-05 23:57:11 +03:00
blockHash;
2023-03-20 19:53:37 +03:00
/**
* The index within the block that this transaction resides at.
*/
2022-09-05 23:57:11 +03:00
index;
2023-03-20 19:53:37 +03:00
/**
* The transaction hash.
*/
2022-09-05 23:57:11 +03:00
hash;
2023-03-20 19:53:37 +03:00
/**
* The [[link-eip-2718]] transaction envelope type. This is
* ``0`` for legacy transactions types.
*/
2022-09-05 23:57:11 +03:00
type;
2023-03-20 19:53:37 +03:00
/**
* The receiver of this transaction.
*
* If ``null``, then the transaction is an initcode transaction.
* This means the result of executing the [[data]] will be deployed
* as a new contract on chain (assuming it does not revert) and the
* address may be computed using [[getCreateAddress]].
*/
2022-09-05 23:57:11 +03:00
to;
2023-03-20 19:53:37 +03:00
/**
* The sender of this transaction. It is implicitly computed
* from the transaction pre-image hash (as the digest) and the
* [[signature]] using ecrecover.
*/
2022-09-05 23:57:11 +03:00
from;
2023-03-20 19:53:37 +03:00
/**
* The nonce, which is used to prevent replay attacks and offer
* a method to ensure transactions from a given sender are explicitly
* ordered.
*
* When sending a transaction, this must be equal to the number of
* transactions ever sent by [[from]].
*/
2022-09-05 23:57:11 +03:00
nonce;
2023-03-20 19:53:37 +03:00
/**
* The maximum units of gas this transaction can consume. If execution
* exceeds this, the entries transaction is reverted and the sender
* is charged for the full amount, despite not state changes being made.
*/
2022-09-05 23:57:11 +03:00
gasLimit;
2023-03-20 19:53:37 +03:00
/**
* The gas price can have various values, depending on the network.
*
* In modern networks, for transactions that are included this is
* the //effective gas price// (the fee per gas that was actually
* charged), while for transactions that have not been included yet
* is the [[maxFeePerGas]].
*
* For legacy transactions, or transactions on legacy networks, this
* is the fee that will be charged per unit of gas the transaction
* consumes.
*/
2022-09-05 23:57:11 +03:00
gasPrice;
2023-03-20 19:53:37 +03:00
/**
* The maximum priority fee (per unit of gas) to allow a
* validator to charge the sender. This is inclusive of the
* [[maxFeeFeePerGas]].
*/
2022-09-05 23:57:11 +03:00
maxPriorityFeePerGas;
2023-03-20 19:53:37 +03:00
/**
* The maximum fee (per unit of gas) to allow this transaction
* to charge the sender.
*/
2022-09-05 23:57:11 +03:00
maxFeePerGas;
2023-03-20 19:53:37 +03:00
/**
* The data.
*/
2022-09-05 23:57:11 +03:00
data;
2023-03-20 19:53:37 +03:00
/**
* The value, in wei. Use [[formatEther]] to format this value
* as ether.
*/
2022-09-05 23:57:11 +03:00
value;
2023-03-20 19:53:37 +03:00
/**
* The chain ID.
*/
2022-09-05 23:57:11 +03:00
chainId;
2023-03-20 19:53:37 +03:00
/**
* The signature.
*/
2022-09-05 23:57:11 +03:00
signature;
2023-03-20 19:53:37 +03:00
/**
* The [[link-eip-2930]] access list for transaction types that
* support it, otherwise ``null``.
*/
2022-09-05 23:57:11 +03:00
accessList;
2022-09-27 10:45:27 +03:00
#startBlock;
2023-03-20 19:53:37 +03:00
/**
2023-06-02 00:52:58 +03:00
* @_ignore:
2023-03-20 19:53:37 +03:00
*/
2022-09-05 23:57:11 +03:00
constructor(tx, provider) {
this.provider = provider;
this.blockNumber = (tx.blockNumber != null) ? tx.blockNumber : null;
this.blockHash = (tx.blockHash != null) ? tx.blockHash : null;
this.hash = tx.hash;
this.index = tx.index;
this.type = tx.type;
this.from = tx.from;
this.to = tx.to || null;
this.gasLimit = tx.gasLimit;
this.nonce = tx.nonce;
this.data = tx.data;
this.value = tx.value;
this.gasPrice = tx.gasPrice;
this.maxPriorityFeePerGas = (tx.maxPriorityFeePerGas != null) ? tx.maxPriorityFeePerGas : null;
this.maxFeePerGas = (tx.maxFeePerGas != null) ? tx.maxFeePerGas : null;
this.chainId = tx.chainId;
this.signature = tx.signature;
this.accessList = (tx.accessList != null) ? tx.accessList : null;
2022-09-27 10:45:27 +03:00
this.#startBlock = -1;
2022-09-05 23:57:11 +03:00
}
2023-03-20 19:53:37 +03:00
/**
2023-06-02 00:52:58 +03:00
* Returns a JSON-compatible representation of this transaction.
2023-03-20 19:53:37 +03:00
*/
2022-09-05 23:57:11 +03:00
toJSON() {
const { blockNumber, blockHash, index, hash, type, to, from, nonce, data, signature, accessList } = this;
return {
_type: "TransactionReceipt",
accessList, blockNumber, blockHash,
chainId: toJson(this.chainId),
data, from,
gasLimit: toJson(this.gasLimit),
gasPrice: toJson(this.gasPrice),
hash,
maxFeePerGas: toJson(this.maxFeePerGas),
maxPriorityFeePerGas: toJson(this.maxPriorityFeePerGas),
nonce, signature, to, index, type,
value: toJson(this.value),
};
}
2023-03-20 19:53:37 +03:00
/**
* Resolves to the Block that this transaction was included in.
*
* This will return null if the transaction has not been included yet.
*/
2022-09-05 23:57:11 +03:00
async getBlock() {
let blockNumber = this.blockNumber;
if (blockNumber == null) {
const tx = await this.getTransaction();
if (tx) {
blockNumber = tx.blockNumber;
}
}
if (blockNumber == null) {
return null;
}
const block = this.provider.getBlock(blockNumber);
if (block == null) {
throw new Error("TODO");
}
return block;
}
2023-03-20 19:53:37 +03:00
/**
* Resolves to this transaction being re-requested from the
* provider. This can be used if you have an unmined transaction
* and wish to get an up-to-date populated instance.
*/
2022-09-05 23:57:11 +03:00
async getTransaction() {
return this.provider.getTransaction(this.hash);
}
2023-06-07 05:42:28 +03:00
/**
* Resolve to the number of confirmations this transaction has.
*/
async confirmations() {
if (this.blockNumber == null) {
const { tx, blockNumber } = await (0, index_js_1.resolveProperties)({
tx: this.getTransaction(),
blockNumber: this.provider.getBlockNumber()
});
// Not mined yet...
if (tx == null || tx.blockNumber == null) {
return 0;
}
return blockNumber - tx.blockNumber + 1;
}
const blockNumber = await this.provider.getBlockNumber();
return blockNumber - this.blockNumber + 1;
}
2023-03-20 19:53:37 +03:00
/**
* Resolves once this transaction has been mined and has
* %%confirms%% blocks including it (default: ``1``) with an
* optional %%timeout%%.
*
* This can resolve to ``null`` only if %%confirms%% is ``0``
* and the transaction has not been mined, otherwise this will
* wait until enough confirmations have completed.
*/
2022-09-27 10:45:27 +03:00
async wait(_confirms, _timeout) {
const confirms = (_confirms == null) ? 1 : _confirms;
const timeout = (_timeout == null) ? 0 : _timeout;
let startBlock = this.#startBlock;
let nextScan = -1;
let stopScanning = (startBlock === -1) ? true : false;
const checkReplacement = async () => {
// Get the current transaction count for this sender
if (stopScanning) {
return null;
}
const { blockNumber, nonce } = await (0, index_js_1.resolveProperties)({
blockNumber: this.provider.getBlockNumber(),
nonce: this.provider.getTransactionCount(this.from)
});
2022-12-31 00:35:04 +03:00
// No transaction or our nonce has not been mined yet; but we
// can start scanning later when we do start
2022-09-27 10:45:27 +03:00
if (nonce < this.nonce) {
startBlock = blockNumber;
return;
}
// We were mined; no replacement
if (stopScanning) {
return null;
}
const mined = await this.getTransaction();
if (mined && mined.blockNumber != null) {
return;
}
// We were replaced; start scanning for that transaction
// Starting to scan; look back a few extra blocks for safety
if (nextScan === -1) {
nextScan = startBlock - 3;
if (nextScan < this.#startBlock) {
nextScan = this.#startBlock;
}
}
while (nextScan <= blockNumber) {
// Get the next block to scan
if (stopScanning) {
return null;
}
2022-11-30 23:44:23 +03:00
const block = await this.provider.getBlock(nextScan, true);
2022-09-27 10:45:27 +03:00
// This should not happen; but we'll try again shortly
if (block == null) {
return;
}
2022-11-30 23:44:23 +03:00
// We were mined; no replacement
for (const hash of block) {
if (hash === this.hash) {
2022-09-27 10:45:27 +03:00
return;
}
2022-11-30 23:44:23 +03:00
}
// Search for the transaction that replaced us
for (let i = 0; i < block.length; i++) {
const tx = await block.getTransaction(i);
2022-09-27 10:45:27 +03:00
if (tx.from === this.from && tx.nonce === this.nonce) {
// Get the receipt
if (stopScanning) {
return null;
}
const receipt = await this.provider.getTransactionReceipt(tx.hash);
// This should not happen; but we'll try again shortly
if (receipt == null) {
return;
}
// We will retry this on the next block (this case could be optimized)
if ((blockNumber - receipt.blockNumber + 1) < confirms) {
return;
}
// The reason we were replaced
let reason = "replaced";
if (tx.data === this.data && tx.to === this.to && tx.value === this.value) {
reason = "repriced";
}
else if (tx.data === "0x" && tx.from === tx.to && tx.value === BN_0) {
reason = "cancelled";
}
2022-11-09 10:57:02 +03:00
(0, index_js_1.assert)(false, "transaction was replaced", "TRANSACTION_REPLACED", {
2022-09-27 10:45:27 +03:00
cancelled: (reason === "replaced" || reason === "cancelled"),
reason,
replacement: tx.replaceableTransaction(startBlock),
hash: tx.hash,
receipt
});
}
}
nextScan++;
}
return;
};
const receipt = await this.provider.getTransactionReceipt(this.hash);
2023-07-16 00:55:24 +03:00
if (confirms === 0) {
return receipt;
}
2022-09-27 10:45:27 +03:00
if (receipt) {
if ((await receipt.confirmations()) >= confirms) {
return receipt;
}
}
else {
// Check for a replacement; throws if a replacement was found
await checkReplacement();
// Allow null only when the confirms is 0
if (confirms === 0) {
return null;
}
}
const waiter = new Promise((resolve, reject) => {
// List of things to cancel when we have a result (one way or the other)
const cancellers = [];
const cancel = () => { cancellers.forEach((c) => c()); };
// On cancel, stop scanning for replacements
cancellers.push(() => { stopScanning = true; });
// Set up any timeout requested
if (timeout > 0) {
const timer = setTimeout(() => {
cancel();
reject((0, index_js_1.makeError)("wait for transaction timeout", "TIMEOUT"));
}, timeout);
cancellers.push(() => { clearTimeout(timer); });
}
const txListener = async (receipt) => {
// Done; return it!
if ((await receipt.confirmations()) >= confirms) {
cancel();
resolve(receipt);
}
};
cancellers.push(() => { this.provider.off(this.hash, txListener); });
this.provider.on(this.hash, txListener);
// We support replacement detection; start checking
if (startBlock >= 0) {
const replaceListener = async () => {
try {
// Check for a replacement; this throws only if one is found
await checkReplacement();
}
catch (error) {
// We were replaced (with enough confirms); re-throw the error
if ((0, index_js_1.isError)(error, "TRANSACTION_REPLACED")) {
cancel();
reject(error);
return;
}
}
// Rescheudle a check on the next block
2022-12-31 00:35:04 +03:00
if (!stopScanning) {
this.provider.once("block", replaceListener);
}
2022-09-27 10:45:27 +03:00
};
cancellers.push(() => { this.provider.off("block", replaceListener); });
this.provider.once("block", replaceListener);
}
});
return await waiter;
2022-09-05 23:57:11 +03:00
}
2023-03-20 19:53:37 +03:00
/**
* Returns ``true`` if this transaction has been included.
*
* This is effective only as of the time the TransactionResponse
* was instantiated. To get up-to-date information, use
* [[getTransaction]].
*
* This provides a Type Guard that this transaction will have
* non-null property values for properties that are null for
* unmined transactions.
*/
2022-09-05 23:57:11 +03:00
isMined() {
return (this.blockHash != null);
}
2023-03-20 19:53:37 +03:00
/**
* Returns true if the transaction is a legacy (i.e. ``type == 0``)
* transaction.
*
* This provides a Type Guard that this transaction will have
* the ``null``-ness for hardfork-specific properties set correctly.
*/
2022-09-05 23:57:11 +03:00
isLegacy() {
return (this.type === 0);
}
2023-03-20 19:53:37 +03:00
/**
* Returns true if the transaction is a Berlin (i.e. ``type == 1``)
* transaction. See [[link-eip-2070]].
*
* This provides a Type Guard that this transaction will have
* the ``null``-ness for hardfork-specific properties set correctly.
*/
2022-09-05 23:57:11 +03:00
isBerlin() {
return (this.type === 1);
}
2023-03-20 19:53:37 +03:00
/**
* Returns true if the transaction is a London (i.e. ``type == 2``)
* transaction. See [[link-eip-1559]].
*
* This provides a Type Guard that this transaction will have
* the ``null``-ness for hardfork-specific properties set correctly.
*/
2022-09-05 23:57:11 +03:00
isLondon() {
return (this.type === 2);
}
2023-03-20 19:53:37 +03:00
/**
* Returns a filter which can be used to listen for orphan events
* that evict this transaction.
*/
2022-09-05 23:57:11 +03:00
removedEvent() {
2022-11-09 10:57:02 +03:00
(0, index_js_1.assert)(this.isMined(), "unmined transaction canot be orphaned", "UNSUPPORTED_OPERATION", { operation: "removeEvent()" });
2022-09-05 23:57:11 +03:00
return createRemovedTransactionFilter(this);
}
2023-03-20 19:53:37 +03:00
/**
* Returns a filter which can be used to listen for orphan events
* that re-order this event against %%other%%.
*/
2022-09-05 23:57:11 +03:00
reorderedEvent(other) {
2022-11-09 10:57:02 +03:00
(0, index_js_1.assert)(this.isMined(), "unmined transaction canot be orphaned", "UNSUPPORTED_OPERATION", { operation: "removeEvent()" });
(0, index_js_1.assert)(!other || other.isMined(), "unmined 'other' transaction canot be orphaned", "UNSUPPORTED_OPERATION", { operation: "removeEvent()" });
2022-09-05 23:57:11 +03:00
return createReorderedTransactionFilter(this, other);
}
2022-09-27 10:45:27 +03:00
/**
* Returns a new TransactionResponse instance which has the ability to
* detect (and throw an error) if the transaction is replaced, which
* will begin scanning at %%startBlock%%.
*
* This should generally not be used by developers and is intended
* primarily for internal use. Setting an incorrect %%startBlock%% can
* have devastating performance consequences if used incorrectly.
*/
replaceableTransaction(startBlock) {
(0, index_js_1.assertArgument)(Number.isInteger(startBlock) && startBlock >= 0, "invalid startBlock", "startBlock", startBlock);
const tx = new TransactionResponse(this, this.provider);
tx.#startBlock = startBlock;
return tx;
}
2022-09-05 23:57:11 +03:00
}
exports.TransactionResponse = TransactionResponse;
function createOrphanedBlockFilter(block) {
return { orphan: "drop-block", hash: block.hash, number: block.number };
}
function createReorderedTransactionFilter(tx, other) {
return { orphan: "reorder-transaction", tx, other };
}
function createRemovedTransactionFilter(tx) {
return { orphan: "drop-transaction", tx };
}
function createRemovedLogFilter(log) {
return { orphan: "drop-log", log: {
transactionHash: log.transactionHash,
blockHash: log.blockHash,
blockNumber: log.blockNumber,
address: log.address,
data: log.data,
topics: Object.freeze(log.topics.slice()),
index: log.index
} };
}
//# sourceMappingURL=provider.js.map