@feelyourprotocol/block 8141.0.0

package/dist/cjs/types.d.ts

@@ -0,0 +1,228 @@
+import type { Common, ParamsDict } from '@feelyourprotocol/common';
+import type { JSONRPCTx, JSONTx, TransactionType, TxData } from '@feelyourprotocol/tx';
+import type { AddressLike, BigIntLike, BytesLike, JSONRPCWithdrawal, NumericString, PrefixedHexString, WithdrawalBytes, WithdrawalData } from '@feelyourprotocol/util';
+import type { BlockHeader } from './index.ts';
+/**
+ * An object to set to which blockchain the blocks and their headers belong. This could be specified
+ * using a {@link Common} object, or `chain` and `hardfork`. Defaults to mainnet without specifying a
+ * hardfork.
+ */
+export interface BlockOptions {
+    /**
+     * A {@link Common} object defining the chain and the hardfork a block/block header belongs to.
+     *
+     * Object will be internally copied so that tx behavior don't incidentally
+     * change on future HF changes.
+     *
+     * Default: {@link Common} object set to `mainnet` and the HF currently defined as the default
+     * hardfork in the {@link Common} class.
+     *
+     * Current default hardfork: `merge`
+     */
+    common?: Common;
+    /**
+     * Set the hardfork either by timestamp (for HFs from Shanghai onwards) or by block number
+     * for older Hfs.
+     *
+     * Default: `false` (HF is set to whatever default HF is set by the {@link Common} instance)
+     */
+    setHardfork?: boolean;
+    /**
+     * Block parameters sorted by EIP can be found in the exported `paramsBlock` dictionary,
+     * which is internally passed to the associated `@feelyourprotocol/common` instance which
+     * manages parameter selection based on the hardfork and EIP settings.
+     *
+     * This option allows providing a custom set of parameters. Note that parameters
+     * get fully overwritten, so you need to extend the default parameter dict
+     * to provide the full parameter set.
+     *
+     * It is recommended to deep-clone the params object for this to avoid side effects:
+     *
+     * ```ts
+     * const params = JSON.parse(JSON.stringify(paramsBlock))
+     * params['1']['minGasLimit'] = 3000 // 5000
+     * ```
+     */
+    params?: ParamsDict;
+    /**
+     * If a preceding {@link BlockHeader} (usually the parent header) is given the preceding
+     * header will be used to calculate the difficulty for this block and the calculated
+     * difficulty takes precedence over a provided static `difficulty` value.
+     *
+     * Note that this option has no effect on networks other than PoW/Ethash networks
+     * (respectively also deactivates on the Merge HF switching to PoS/Casper).
+     */
+    calcDifficultyFromHeader?: BlockHeader;
+    /**
+     * A block object by default gets frozen along initialization. This gives you
+     * strong additional security guarantees on the consistency of the block parameters.
+     * It also enables block hash caching when the `hash()` method is called multiple times.
+     *
+     * If you need to deactivate the block freeze - e.g. because you want to subclass block and
+     * add additional properties - it is strongly encouraged that you do the freeze yourself
+     * within your code instead.
+     *
+     * Default: true
+     */
+    freeze?: boolean;
+    /**
+     *  Skip consensus format validation checks on header if set. Defaults to false.
+     */
+    skipConsensusFormatValidation?: boolean;
+}
+/**
+ * A block header's data.
+ */
+export interface HeaderData {
+    parentHash?: BytesLike;
+    uncleHash?: BytesLike;
+    coinbase?: AddressLike;
+    stateRoot?: BytesLike;
+    transactionsTrie?: BytesLike;
+    receiptTrie?: BytesLike;
+    logsBloom?: BytesLike;
+    difficulty?: BigIntLike;
+    number?: BigIntLike;
+    gasLimit?: BigIntLike;
+    gasUsed?: BigIntLike;
+    timestamp?: BigIntLike;
+    extraData?: BytesLike;
+    mixHash?: BytesLike;
+    nonce?: BytesLike;
+    baseFeePerGas?: BigIntLike;
+    withdrawalsRoot?: BytesLike;
+    blobGasUsed?: BigIntLike;
+    excessBlobGas?: BigIntLike;
+    parentBeaconBlockRoot?: BytesLike;
+    requestsHash?: BytesLike;
+    /**
+     * 32 bytes hash of the block access list (EIP-7928)
+     */
+    blockAccessListHash?: BytesLike;
+    /**
+     * Slot number (EIP-7843)
+     */
+    slotNumber?: BigIntLike;
+}
+/**
+ * A block's data.
+ */
+export interface BlockData {
+    /**
+     * Header data for the block
+     */
+    header?: HeaderData;
+    transactions?: Array<TxData[TransactionType]>;
+    uncleHeaders?: Array<HeaderData>;
+    withdrawals?: Array<WithdrawalData>;
+}
+export type WithdrawalsBytes = WithdrawalBytes[];
+export type BlockBytes = [BlockHeaderBytes, TransactionsBytes, UncleHeadersBytes] | [BlockHeaderBytes, TransactionsBytes, UncleHeadersBytes, WithdrawalsBytes] | [BlockHeaderBytes, TransactionsBytes, UncleHeadersBytes, WithdrawalsBytes];
+export type BlockHeaderBytes = Uint8Array[];
+export type BlockBodyBytes = [TransactionsBytes, UncleHeadersBytes, WithdrawalsBytes?];
+/**
+ * TransactionsBytes can be an array of serialized txs for Typed Transactions or an array of Uint8Array Arrays for legacy transactions.
+ */
+export type TransactionsBytes = Uint8Array[][] | Uint8Array[];
+export type UncleHeadersBytes = Uint8Array[][];
+/**
+ * An object with the block's data represented as strings.
+ */
+export interface JSONBlock {
+    /**
+     * Header data for the block
+     */
+    header?: JSONHeader;
+    transactions?: JSONTx[];
+    uncleHeaders?: JSONHeader[];
+    withdrawals?: JSONRPCWithdrawal[];
+}
+/**
+ * An object with the block header's data represented as 0x-prefixed hex strings.
+ */
+export interface JSONHeader {
+    parentHash?: PrefixedHexString;
+    uncleHash?: PrefixedHexString;
+    coinbase?: PrefixedHexString;
+    stateRoot?: PrefixedHexString;
+    transactionsTrie?: PrefixedHexString;
+    receiptTrie?: PrefixedHexString;
+    logsBloom?: PrefixedHexString;
+    difficulty?: PrefixedHexString;
+    number?: PrefixedHexString;
+    gasLimit?: PrefixedHexString;
+    gasUsed?: PrefixedHexString;
+    timestamp?: PrefixedHexString;
+    extraData?: PrefixedHexString;
+    mixHash?: PrefixedHexString;
+    nonce?: PrefixedHexString;
+    baseFeePerGas?: PrefixedHexString;
+    withdrawalsRoot?: PrefixedHexString;
+    blobGasUsed?: PrefixedHexString;
+    excessBlobGas?: PrefixedHexString;
+    parentBeaconBlockRoot?: PrefixedHexString;
+    requestsHash?: PrefixedHexString;
+    blockAccessListHash?: PrefixedHexString;
+    slotNumber?: PrefixedHexString;
+}
+export interface JSONRPCBlock {
+    number: PrefixedHexString;
+    hash: PrefixedHexString;
+    parentHash: PrefixedHexString;
+    mixHash?: PrefixedHexString;
+    nonce: PrefixedHexString;
+    sha3Uncles: PrefixedHexString;
+    logsBloom: PrefixedHexString;
+    transactionsRoot: PrefixedHexString;
+    stateRoot: PrefixedHexString;
+    receiptsRoot: PrefixedHexString;
+    miner: PrefixedHexString;
+    difficulty: PrefixedHexString | NumericString;
+    totalDifficulty?: PrefixedHexString;
+    extraData: PrefixedHexString;
+    size: PrefixedHexString;
+    gasLimit: PrefixedHexString;
+    gasUsed: PrefixedHexString;
+    timestamp: PrefixedHexString;
+    transactions: Array<JSONRPCTx | PrefixedHexString>;
+    uncles: PrefixedHexString[];
+    baseFeePerGas?: PrefixedHexString;
+    withdrawals?: Array<JSONRPCWithdrawal>;
+    withdrawalsRoot?: PrefixedHexString;
+    blobGasUsed?: PrefixedHexString;
+    excessBlobGas?: PrefixedHexString;
+    parentBeaconBlockRoot?: PrefixedHexString;
+    requestsHash?: PrefixedHexString;
+    blockAccessListHash?: PrefixedHexString;
+    slotNumber?: PrefixedHexString;
+}
+export type WithdrawalV1 = {
+    index: PrefixedHexString;
+    validatorIndex: PrefixedHexString;
+    address: PrefixedHexString;
+    amount: PrefixedHexString;
+};
+export type ExecutionPayload = {
+    parentHash: PrefixedHexString;
+    feeRecipient: PrefixedHexString;
+    stateRoot: PrefixedHexString;
+    receiptsRoot: PrefixedHexString;
+    logsBloom: PrefixedHexString;
+    prevRandao: PrefixedHexString;
+    blockNumber: PrefixedHexString;
+    gasLimit: PrefixedHexString;
+    gasUsed: PrefixedHexString;
+    timestamp: PrefixedHexString;
+    extraData: PrefixedHexString;
+    baseFeePerGas: PrefixedHexString;
+    blockHash: PrefixedHexString;
+    transactions: PrefixedHexString[];
+    withdrawals?: WithdrawalV1[];
+    blobGasUsed?: PrefixedHexString;
+    excessBlobGas?: PrefixedHexString;
+    parentBeaconBlockRoot?: PrefixedHexString;
+    requestsHash?: PrefixedHexString;
+    blockAccessListHash?: PrefixedHexString;
+    slotNumber?: PrefixedHexString;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

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

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/block/block.d.ts

@@ -0,0 +1,147 @@
+import type { Common } from '@feelyourprotocol/common';
+import type { TypedTransaction } from '@feelyourprotocol/tx';
+import type { Withdrawal } from '@feelyourprotocol/util';
+import { BlockHeader } from '../index.ts';
+import type { BlockBytes, BlockOptions, ExecutionPayload, JSONBlock } from '../types.ts';
+/**
+ * Class representing a block in the Ethereum network. The {@link BlockHeader} has its own
+ * class and can be used independently, for a block it is included in the form of the
+ * {@link Block.header} property.
+ *
+ * A block object can be created with one of the following constructor methods
+ * (separate from the Block class to allow for tree shaking):
+ *
+ * - {@link createBlock }
+ * - {@link createBlockFromBytesArray }
+ * - {@link createBlockFromRLP }
+ * - {@link createBlockFromRPC }
+ * - {@link createBlockFromJSONRPCProvider }
+ * - {@link createBlockFromExecutionPayload }
+ * - {@link createBlockFromBeaconPayloadJSON }
+ */
+export declare class Block {
+    readonly header: BlockHeader;
+    readonly transactions: TypedTransaction[];
+    readonly uncleHeaders: BlockHeader[];
+    readonly withdrawals?: Withdrawal[];
+    readonly common: Common;
+    protected keccakFunction: (msg: Uint8Array) => Uint8Array;
+    protected sha256Function: (msg: Uint8Array) => Uint8Array;
+    protected cache: {
+        txTrieRoot?: Uint8Array;
+        withdrawalsTrieRoot?: Uint8Array;
+    };
+    /**
+     * This constructor takes the values, validates them, assigns them and freezes the object.
+     *
+     * @deprecated Use the static factory methods (see {@link Block} for an overview) to assist in creating
+     * a Block object from varying data types and options.
+     */
+    constructor(header?: BlockHeader, transactions?: TypedTransaction[], uncleHeaders?: BlockHeader[], withdrawals?: Withdrawal[], opts?: BlockOptions);
+    /**
+     * Returns an array of the raw byte arrays for this block, in order.
+     */
+    raw(): BlockBytes;
+    /**
+     * Returns the hash of the block.
+     */
+    hash(): Uint8Array;
+    /**
+     * Determines if this block is the genesis block.
+     */
+    isGenesis(): boolean;
+    /**
+     * Returns the rlp encoding of the block.
+     */
+    serialize(): Uint8Array;
+    /**
+     * Generates transaction trie for validation.
+     */
+    genTxTrie(): Promise<Uint8Array>;
+    /**
+     * Validates the transaction trie by generating a trie
+     * and do a check on the root hash.
+     * @returns True if the transaction trie is valid, false otherwise
+     */
+    transactionsTrieIsValid(): Promise<boolean>;
+    /**
+     * Validates transaction signatures and minimum gas requirements.
+     * @returns {string[]} an array of error strings
+     */
+    getTransactionsValidationErrors(): string[];
+    /**
+     * Validates transaction signatures and minimum gas requirements.
+     * @returns True if all transactions are valid, false otherwise
+     */
+    transactionsAreValid(): boolean;
+    /**
+     * Validates the block data, throwing if invalid.
+     * This can be checked on the Block itself without needing access to any parent block
+     * It checks:
+     * - All transactions are valid
+     * - The transactions trie is valid
+     * - The uncle hash is valid
+     * - Block size limit (EIP-7934)
+     * @param onlyHeader if only passed the header, skip validating txTrie and unclesHash (default: false)
+     * @param verifyTxs if set to `false`, will not check for transaction validation errors (default: true)
+     * @param validateBlockSize if set to `true`, will check for block size limit (EIP-7934) (default: false)
+     */
+    validateData(onlyHeader?: boolean, verifyTxs?: boolean, validateBlockSize?: boolean): Promise<void>;
+    /**
+     * Validates that blob gas fee for each transaction is greater than or equal to the
+     * blobGasPrice for the block and that total blob gas in block is less than maximum
+     * blob gas per block
+     * @param parentHeader header of parent block
+     */
+    validateBlobTransactions(parentHeader: BlockHeader): void;
+    /**
+     * Validates the uncle's hash.
+     * @returns true if the uncle's hash is valid, false otherwise.
+     */
+    uncleHashIsValid(): boolean;
+    /**
+     * Validates the withdrawal root
+     * @returns true if the withdrawals trie root is valid, false otherwise
+     */
+    withdrawalsTrieIsValid(): Promise<boolean>;
+    /**
+     * Consistency checks for uncles included in the block, if any.
+     *
+     * Throws if invalid.
+     *
+     * The rules for uncles checked are the following:
+     * Header has at most 2 uncles.
+     * Header does not count an uncle twice.
+     */
+    validateUncles(): void;
+    /**
+     * Validates if the block gasLimit remains in the boundaries set by the protocol.
+     * Throws if invalid
+     *
+     * @param parentBlock - the parent of this `Block`
+     */
+    validateGasLimit(parentBlock: Block): void;
+    /**
+     * Returns the block in JSON format.
+     */
+    toJSON(): JSONBlock;
+    /**
+     * Maps the block properties to the execution payload structure from the beacon chain,
+     * see https://github.com/ethereum/consensus-specs/blob/dev/specs/bellatrix/beacon-chain.md#ExecutionPayload
+     *
+     * @returns dict with the execution payload parameters with camel case naming
+     */
+    toExecutionPayload(): ExecutionPayload;
+    /**
+     * Return a compact error string representation of the object
+     */
+    errorStr(): string;
+    /**
+     * Internal helper function to create an annotated error message
+     *
+     * @param msg Base error message
+     * @hidden
+     */
+    protected _errorMsg(msg: string): string;
+}
+//# sourceMappingURL=block.d.ts.map

package/dist/esm/block/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/block/block.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAA6B,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAOlD,OAAO,EACL,WAAW,EAUZ,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAExF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IAChB,SAAgB,MAAM,EAAE,WAAW,CAAA;IACnC,SAAgB,YAAY,EAAE,gBAAgB,EAAE,CAAK;IACrD,SAAgB,YAAY,EAAE,WAAW,EAAE,CAAK;IAChD,SAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,CAAA;IACzD,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,CAAA;IAEzD,SAAS,CAAC,KAAK,EAAE;QACf,UAAU,CAAC,EAAE,UAAU,CAAA;QACvB,mBAAmB,CAAC,EAAE,UAAU,CAAA;KACjC,CAAK;IAEN;;;;;OAKG;gBAED,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,GAAE,gBAAgB,EAAO,EACrC,YAAY,GAAE,WAAW,EAAO,EAChC,WAAW,CAAC,EAAE,UAAU,EAAE,EAC1B,IAAI,GAAE,YAAiB;IAqCzB;;OAEG;IACH,GAAG,IAAI,UAAU;IAgBjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAIlB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,UAAU;IAIvB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAOtC;;;;OAIG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAcjD;;;OAGG;IACH,+BAA+B,IAAI,MAAM,EAAE;IA8C3C;;;OAGG;IACH,oBAAoB,IAAI,OAAO;IAM/B;;;;;;;;;;;OAWG;IACG,YAAY,CAChB,UAAU,GAAE,OAAe,EAC3B,SAAS,GAAE,OAAc,EACzB,iBAAiB,GAAE,OAAe,GACjC,OAAO,CAAC,IAAI,CAAC;IAoDhB;;;;;OAKG;IACH,wBAAwB,CAAC,YAAY,EAAE,WAAW;IA4ClD;;;OAGG;IACH,gBAAgB,IAAI,OAAO;IAS3B;;;OAGG;IACG,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBhD;;;;;;;;OAQG;IACH,cAAc;IAmBd;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,KAAK;IAInC;;OAEG;IACH,MAAM,IAAI,SAAS;IAcnB;;;;;OAKG;IACH,kBAAkB,IAAI,gBAAgB;IA+BtC;;OAEG;IACI,QAAQ;IAmBf;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM;CAGhC"}