eteres 0.0.1-security → 6.7.1

package/lib.commonjs/providers/format.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTransactionResponse = exports.formatTransactionReceipt = exports.formatReceiptLog = exports.formatBlock = exports.formatLog = exports.formatUint256 = exports.formatHash = exports.formatData = exports.formatBoolean = exports.object = exports.arrayOf = exports.allowNull = void 0;
+/**
+ *  @_ignore
+ */
+const index_js_1 = require("../address/index.js");
+const index_js_2 = require("../crypto/index.js");
+const index_js_3 = require("../transaction/index.js");
+const index_js_4 = require("../utils/index.js");
+const BN_0 = BigInt(0);
+function allowNull(format, nullValue) {
+    return (function (value) {
+        if (value == null) {
+            return nullValue;
+        }
+        return format(value);
+    });
+}
+exports.allowNull = allowNull;
+function arrayOf(format) {
+    return ((array) => {
+        if (!Array.isArray(array)) {
+            throw new Error("not an array");
+        }
+        return array.map((i) => format(i));
+    });
+}
+exports.arrayOf = arrayOf;
+// Requires an object which matches a fleet of other formatters
+// Any FormatFunc may return `undefined` to have the value omitted
+// from the result object. Calls preserve `this`.
+function object(format, altNames) {
+    return ((value) => {
+        const result = {};
+        for (const key in format) {
+            let srcKey = key;
+            if (altNames && key in altNames && !(srcKey in value)) {
+                for (const altKey of altNames[key]) {
+                    if (altKey in value) {
+                        srcKey = altKey;
+                        break;
+                    }
+                }
+            }
+            try {
+                const nv = format[key](value[srcKey]);
+                if (nv !== undefined) {
+                    result[key] = nv;
+                }
+            }
+            catch (error) {
+                const message = (error instanceof Error) ? error.message : "not-an-error";
+                (0, index_js_4.assert)(false, `invalid value for value.${key} (${message})`, "BAD_DATA", { value });
+            }
+        }
+        return result;
+    });
+}
+exports.object = object;
+function formatBoolean(value) {
+    switch (value) {
+        case true:
+        case "true":
+            return true;
+        case false:
+        case "false":
+            return false;
+    }
+    (0, index_js_4.assertArgument)(false, `invalid boolean; ${JSON.stringify(value)}`, "value", value);
+}
+exports.formatBoolean = formatBoolean;
+function formatData(value) {
+    (0, index_js_4.assertArgument)((0, index_js_4.isHexString)(value, true), "invalid data", "value", value);
+    return value;
+}
+exports.formatData = formatData;
+function formatHash(value) {
+    (0, index_js_4.assertArgument)((0, index_js_4.isHexString)(value, 32), "invalid hash", "value", value);
+    return value;
+}
+exports.formatHash = formatHash;
+function formatUint256(value) {
+    if (!(0, index_js_4.isHexString)(value)) {
+        throw new Error("invalid uint256");
+    }
+    return (0, index_js_4.zeroPadValue)(value, 32);
+}
+exports.formatUint256 = formatUint256;
+const _formatLog = object({
+    address: index_js_1.getAddress,
+    blockHash: formatHash,
+    blockNumber: index_js_4.getNumber,
+    data: formatData,
+    index: index_js_4.getNumber,
+    removed: allowNull(formatBoolean, false),
+    topics: arrayOf(formatHash),
+    transactionHash: formatHash,
+    transactionIndex: index_js_4.getNumber,
+}, {
+    index: ["logIndex"]
+});
+function formatLog(value) {
+    return _formatLog(value);
+}
+exports.formatLog = formatLog;
+const _formatBlock = object({
+    hash: allowNull(formatHash),
+    parentHash: formatHash,
+    number: index_js_4.getNumber,
+    timestamp: index_js_4.getNumber,
+    nonce: allowNull(formatData),
+    difficulty: index_js_4.getBigInt,
+    gasLimit: index_js_4.getBigInt,
+    gasUsed: index_js_4.getBigInt,
+    miner: allowNull(index_js_1.getAddress),
+    extraData: formatData,
+    baseFeePerGas: allowNull(index_js_4.getBigInt)
+});
+function formatBlock(value) {
+    const result = _formatBlock(value);
+    result.transactions = value.transactions.map((tx) => {
+        if (typeof (tx) === "string") {
+            return tx;
+        }
+        return formatTransactionResponse(tx);
+    });
+    return result;
+}
+exports.formatBlock = formatBlock;
+const _formatReceiptLog = object({
+    transactionIndex: index_js_4.getNumber,
+    blockNumber: index_js_4.getNumber,
+    transactionHash: formatHash,
+    address: index_js_1.getAddress,
+    topics: arrayOf(formatHash),
+    data: formatData,
+    index: index_js_4.getNumber,
+    blockHash: formatHash,
+}, {
+    index: ["logIndex"]
+});
+function formatReceiptLog(value) {
+    return _formatReceiptLog(value);
+}
+exports.formatReceiptLog = formatReceiptLog;
+const _formatTransactionReceipt = object({
+    to: allowNull(index_js_1.getAddress, null),
+    from: allowNull(index_js_1.getAddress, null),
+    contractAddress: allowNull(index_js_1.getAddress, null),
+    // should be allowNull(hash), but broken-EIP-658 support is handled in receipt
+    index: index_js_4.getNumber,
+    root: allowNull(index_js_4.hexlify),
+    gasUsed: index_js_4.getBigInt,
+    logsBloom: allowNull(formatData),
+    blockHash: formatHash,
+    hash: formatHash,
+    logs: arrayOf(formatReceiptLog),
+    blockNumber: index_js_4.getNumber,
+    //confirmations: allowNull(getNumber, null),
+    cumulativeGasUsed: index_js_4.getBigInt,
+    effectiveGasPrice: allowNull(index_js_4.getBigInt),
+    status: allowNull(index_js_4.getNumber),
+    type: allowNull(index_js_4.getNumber, 0)
+}, {
+    effectiveGasPrice: ["gasPrice"],
+    hash: ["transactionHash"],
+    index: ["transactionIndex"],
+});
+function formatTransactionReceipt(value) {
+    return _formatTransactionReceipt(value);
+}
+exports.formatTransactionReceipt = formatTransactionReceipt;
+function formatTransactionResponse(value) {
+    // Some clients (TestRPC) do strange things like return 0x0 for the
+    // 0 address; correct this to be a real address
+    if (value.to && (0, index_js_4.getBigInt)(value.to) === BN_0) {
+        value.to = "0x0000000000000000000000000000000000000000";
+    }
+    const result = object({
+        hash: formatHash,
+        type: (value) => {
+            if (value === "0x" || value == null) {
+                return 0;
+            }
+            return (0, index_js_4.getNumber)(value);
+        },
+        accessList: allowNull(index_js_3.accessListify, null),
+        blockHash: allowNull(formatHash, null),
+        blockNumber: allowNull(index_js_4.getNumber, null),
+        transactionIndex: allowNull(index_js_4.getNumber, null),
+        //confirmations: allowNull(getNumber, null),
+        from: index_js_1.getAddress,
+        // either (gasPrice) or (maxPriorityFeePerGas + maxFeePerGas) must be set
+        gasPrice: allowNull(index_js_4.getBigInt),
+        maxPriorityFeePerGas: allowNull(index_js_4.getBigInt),
+        maxFeePerGas: allowNull(index_js_4.getBigInt),
+        gasLimit: index_js_4.getBigInt,
+        to: allowNull(index_js_1.getAddress, null),
+        value: index_js_4.getBigInt,
+        nonce: index_js_4.getNumber,
+        data: formatData,
+        creates: allowNull(index_js_1.getAddress, null),
+        chainId: allowNull(index_js_4.getBigInt, null)
+    }, {
+        data: ["input"],
+        gasLimit: ["gas"]
+    })(value);
+    // If to and creates are empty, populate the creates from the value
+    if (result.to == null && result.creates == null) {
+        result.creates = (0, index_js_1.getCreateAddress)(result);
+    }
+    // @TODO: Check fee data
+    // Add an access list to supported transaction types
+    if ((value.type === 1 || value.type === 2) && value.accessList == null) {
+        result.accessList = [];
+    }
+    // Compute the signature
+    if (value.signature) {
+        result.signature = index_js_2.Signature.from(value.signature);
+    }
+    else {
+        result.signature = index_js_2.Signature.from(value);
+    }
+    // Some backends omit ChainId on legacy transactions, but we can compute it
+    if (result.chainId == null) {
+        const chainId = result.signature.legacyChainId;
+        if (chainId != null) {
+            result.chainId = chainId;
+        }
+    }
+    // @TODO: check chainID
+    /*
+    if (value.chainId != null) {
+        let chainId = value.chainId;
+
+        if (isHexString(chainId)) {
+            chainId = BigNumber.from(chainId).toNumber();
+        }
+
+        result.chainId = chainId;
+
+    } else {
+        let chainId = value.networkId;
+
+        // geth-etc returns chainId
+        if (chainId == null && result.v == null) {
+            chainId = value.chainId;
+        }
+
+        if (isHexString(chainId)) {
+            chainId = BigNumber.from(chainId).toNumber();
+        }
+
+        if (typeof(chainId) !== "number" && result.v != null) {
+            chainId = (result.v - 35) / 2;
+            if (chainId < 0) { chainId = 0; }
+            chainId = parseInt(chainId);
+        }
+
+        if (typeof(chainId) !== "number") { chainId = 0; }
+
+        result.chainId = chainId;
+    }
+    */
+    // 0x0000... should actually be null
+    if (result.blockHash && (0, index_js_4.getBigInt)(result.blockHash) === BN_0) {
+        result.blockHash = null;
+    }
+    return result;
+}
+exports.formatTransactionResponse = formatTransactionResponse;
+//# sourceMappingURL=format.js.map

package/lib.commonjs/providers/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src.ts/providers/format.ts"],"names":[],"mappings":"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"}

package/lib.commonjs/providers/formatting.d.ts

@@ -0,0 +1,268 @@
+/**
+ *  About provider formatting?
+ *
+ *  @_section: api/providers/formatting:Formatting  [provider-formatting]
+ */
+import type { Signature } from "../crypto/index.js";
+import type { AccessList } from "../transaction/index.js";
+/**
+ *  a **BlockParams** encodes the minimal required properties for a
+ *  formatted block.
+ */
+export interface BlockParams {
+    /**
+     *  The block hash.
+     */
+    hash?: null | string;
+    /**
+     *  The block number.
+     */
+    number: number;
+    /**
+     *  The timestamp for this block, which is the number of seconds
+     *  since epoch that this block was included.
+     */
+    timestamp: number;
+    /**
+     *  The hash of the previous block in the blockchain. The genesis block
+     *  has the parentHash of the [[ZeroHash]].
+     */
+    parentHash: string;
+    /**
+     *  A random sequence provided during the mining process for
+     *  proof-of-work networks.
+     */
+    nonce: string;
+    /**
+     *  For proof-of-work networks, the difficulty target is used to
+     *  adjust the difficulty in mining to ensure a expected block rate.
+     */
+    difficulty: bigint;
+    /**
+     *  The maximum amount of gas a block can consume.
+     */
+    gasLimit: bigint;
+    /**
+     *  The amount of gas a block consumed.
+     */
+    gasUsed: bigint;
+    /**
+     *  The miner (or author) of a block.
+     */
+    miner: string;
+    /**
+     *  Additional data the miner choose to include.
+     */
+    extraData: string;
+    /**
+     *  The protocol-defined base fee per gas in an [[link-eip-1559]]
+     *  block.
+     */
+    baseFeePerGas: null | bigint;
+    /**
+     *  The list of transactions in the block.
+     */
+    transactions: ReadonlyArray<string | TransactionResponseParams>;
+}
+/**
+ *  a **LogParams** encodes the minimal required properties for a
+ *  formatted log.
+ */
+export interface LogParams {
+    /**
+     *  The transaction hash for the transaxction the log occurred in.
+     */
+    transactionHash: string;
+    /**
+     *  The block hash of the block that included the transaction for this
+     *  log.
+     */
+    blockHash: string;
+    /**
+     *  The block number of the block that included the transaction for this
+     *  log.
+     */
+    blockNumber: number;
+    /**
+     *  Whether this log was removed due to the transaction it was included
+     *  in being removed dur to an orphaned block.
+     */
+    removed: boolean;
+    /**
+     *  The address of the contract that emitted this log.
+     */
+    address: string;
+    /**
+     *  The data emitted with this log.
+     */
+    data: string;
+    /**
+     *  The topics emitted with this log.
+     */
+    topics: ReadonlyArray<string>;
+    /**
+     *  The index of this log.
+     */
+    index: number;
+    /**
+     *  The transaction index of this log.
+     */
+    transactionIndex: number;
+}
+/**
+ *  a **TransactionReceiptParams** encodes the minimal required properties
+ *  for a formatted transaction receipt.
+ */
+export interface TransactionReceiptParams {
+    /**
+     *  The target of the transaction. If null, the transaction was trying
+     *  to deploy a transaction with the ``data`` as the initi=code.
+     */
+    to: null | string;
+    /**
+     *  The sender of the transaction.
+     */
+    from: string;
+    /**
+     *  If the transaction was directly deploying a contract, the [[to]]
+     *  will be null, the ``data`` will be initcode and if successful, this
+     *  will be the address of the contract deployed.
+     */
+    contractAddress: null | string;
+    /**
+     *  The transaction hash.
+     */
+    hash: string;
+    /**
+     *  The transaction index.
+     */
+    index: number;
+    /**
+     *  The block hash of the block that included this transaction.
+     */
+    blockHash: string;
+    /**
+     *  The block number of the block that included this transaction.
+     */
+    blockNumber: number;
+    /**
+     *  The bloom filter for the logs emitted during execution of this
+     *  transaction.
+     */
+    logsBloom: string;
+    /**
+     *  The logs emitted during the execution of this transaction.
+     */
+    logs: ReadonlyArray<LogParams>;
+    /**
+     *  The amount of gas consumed executing this transaciton.
+     */
+    gasUsed: bigint;
+    /**
+     *  The total amount of gas consumed during the entire block up to
+     *  and including this transaction.
+     */
+    cumulativeGasUsed: bigint;
+    /**
+     *  The actual gas price per gas charged for this transaction.
+     */
+    gasPrice?: null | bigint;
+    /**
+     *  The actual gas price per gas charged for this transaction.
+     */
+    effectiveGasPrice?: null | bigint;
+    /**
+     *  The [[link-eip-2718]] envelope type.
+     */
+    type: number;
+    /**
+     *  The status of the transaction execution. If ``1`` then the
+     *  the transaction returned success, if ``0`` then the transaction
+     *  was reverted. For pre-byzantium blocks, this is usually null, but
+     *  some nodes may have backfilled this data.
+     */
+    status: null | number;
+    /**
+     *  The root of this transaction in a pre-bazatium block. In
+     *  post-byzantium blocks this is null.
+     */
+    root: null | string;
+}
+/**
+ *  a **TransactionResponseParams** encodes the minimal required properties
+ *  for a formatted transaction response.
+ */
+export interface TransactionResponseParams {
+    /**
+     *  The block number of the block that included this transaction.
+     */
+    blockNumber: null | number;
+    /**
+     *  The block hash of the block that included this transaction.
+     */
+    blockHash: null | string;
+    /**
+     *  The transaction hash.
+     */
+    hash: string;
+    /**
+     *  The transaction index.
+     */
+    index: number;
+    /**
+     *  The [[link-eip-2718]] transaction type.
+     */
+    type: number;
+    /**
+     *  The target of the transaction. If ``null``, the ``data`` is initcode
+     *  and this transaction is a deployment transaction.
+     */
+    to: null | string;
+    /**
+     *  The sender of the transaction.
+     */
+    from: string;
+    /**
+     *  The nonce of the transaction, used for replay protection.
+     */
+    nonce: number;
+    /**
+     *  The maximum amount of gas this transaction is authorized to consume.
+     */
+    gasLimit: bigint;
+    /**
+     *  For legacy transactions, this is the gas price per gas to pay.
+     */
+    gasPrice: bigint;
+    /**
+     *  For [[link-eip-1559]] transactions, this is the maximum priority
+     *  fee to allow a producer to claim.
+     */
+    maxPriorityFeePerGas: null | bigint;
+    /**
+     *  For [[link-eip-1559]] transactions, this is the maximum fee that
+     *  will be paid.
+     */
+    maxFeePerGas: null | bigint;
+    /**
+     *  The transaction data.
+     */
+    data: string;
+    /**
+     *  The transaction value (in wei).
+     */
+    value: bigint;
+    /**
+     *  The chain ID this transaction is valid on.
+     */
+    chainId: bigint;
+    /**
+     *  The signature of the transaction.
+     */
+    signature: Signature;
+    /**
+     *  The transaction access list.
+     */
+    accessList: null | AccessList;
+}
+//# sourceMappingURL=formatting.d.ts.map

package/lib.commonjs/providers/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src.ts/providers/formatting.ts"],"names":[],"mappings":"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"}

package/lib.commonjs/providers/formatting.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ *  About provider formatting?
+ *
+ *  @_section: api/providers/formatting:Formatting  [provider-formatting]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+;
+;
+//# sourceMappingURL=formatting.js.map

package/lib.commonjs/providers/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../src.ts/providers/formatting.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA8EF,CAAC;AA+QD,CAAC"}

package/lib.commonjs/providers/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ *  A **Provider** provides a connection to the blockchain, whch can be
+ *  used to query its current state, simulate execution and send transactions
+ *  to update the state.
+ *
+ *  It is one of the most fundamental components of interacting with a
+ *  blockchain application, and there are many ways to connect, such as over
+ *  HTTP, WebSockets or injected providers such as [MetaMask](link-metamask).
+ *
+ *  @_section: api/providers:Providers  [about-providers]
+ */
+export { AbstractProvider, UnmanagedSubscriber } from "./abstract-provider.js";
+export { AbstractSigner, VoidSigner, } from "./abstract-signer.js";
+export { showThrottleMessage } from "./community.js";
+export { getDefaultProvider } from "./default-provider.js";
+export { EnsResolver, MulticoinProviderPlugin } from "./ens-resolver.js";
+export { Network } from "./network.js";
+export { NonceManager } from "./signer-noncemanager.js";
+export { NetworkPlugin, GasCostPlugin, EnsPlugin, FeeDataNetworkPlugin, FetchUrlFeeDataNetworkPlugin, } from "./plugins-network.js";
+export { Block, FeeData, Log, TransactionReceipt, TransactionResponse, copyRequest, } from "./provider.js";
+export { FallbackProvider } from "./provider-fallback.js";
+export { JsonRpcApiProvider, JsonRpcProvider, JsonRpcSigner } from "./provider-jsonrpc.js";
+export { BrowserProvider } from "./provider-browser.js";
+export { AlchemyProvider } from "./provider-alchemy.js";
+export { AnkrProvider } from "./provider-ankr.js";
+export { CloudflareProvider } from "./provider-cloudflare.js";
+export { EtherscanProvider, EtherscanPlugin } from "./provider-etherscan.js";
+export { InfuraProvider, InfuraWebSocketProvider } from "./provider-infura.js";
+export { PocketProvider } from "./provider-pocket.js";
+export { QuickNodeProvider } from "./provider-quicknode.js";
+import { IpcSocketProvider } from "./provider-ipcsocket.js";
+export { IpcSocketProvider };
+export { SocketProvider } from "./provider-socket.js";
+export { WebSocketProvider } from "./provider-websocket.js";
+export { SocketSubscriber, SocketBlockSubscriber, SocketPendingSubscriber, SocketEventSubscriber } from "./provider-socket.js";
+export type { AbstractProviderOptions, Subscription, Subscriber, AbstractProviderPlugin, PerformActionFilter, PerformActionTransaction, PerformActionRequest, } from "./abstract-provider.js";
+export type { ContractRunner } from "./contracts.js";
+export type { BlockParams, LogParams, TransactionReceiptParams, TransactionResponseParams, } from "./formatting.js";
+export type { Networkish } from "./network.js";
+export type { GasCostParameters } from "./plugins-network.js";
+export type { BlockTag, TransactionRequest, PreparedTransactionRequest, EventFilter, Filter, FilterByBlockHash, OrphanFilter, ProviderEvent, TopicFilter, Provider, MinedBlock, MinedTransactionResponse } from "./provider.js";
+export type { DebugEventBrowserProvider, Eip1193Provider } from "./provider-browser.js";
+export type { FallbackProviderOptions } from "./provider-fallback.js";
+export type { JsonRpcPayload, JsonRpcResult, JsonRpcError, JsonRpcApiProviderOptions, JsonRpcTransactionRequest, } from "./provider-jsonrpc.js";
+export type { WebSocketCreator, WebSocketLike } from "./provider-websocket.js";
+export type { Signer } from "./signer.js";
+//# sourceMappingURL=index.d.ts.map

package/lib.commonjs/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src.ts/providers/index.ts"],"names":[],"mappings":"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"}