@feelyourprotocol/common 8141.0.0

package/dist/cjs/enums.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsensusAlgorithm = exports.ConsensusType = exports.Hardfork = exports.ChainGenesis = exports.ChainNameFromNumber = exports.Chain = void 0;
+const util_1 = require("@feelyourprotocol/util");
+exports.Chain = {
+    Mainnet: 1,
+    Sepolia: 11155111,
+    Holesky: 17000,
+    Hoodi: 560048,
+};
+// Reverse mapping: from numeric value back to the key name
+exports.ChainNameFromNumber = Object.entries(exports.Chain).reduce((acc, [key, value]) => {
+    acc[value] = key;
+    return acc;
+}, {});
+// Having this info as record will force typescript to make sure no chain is missed
+/**
+ * GenesisState info about well known ethereum chains
+ */
+exports.ChainGenesis = {
+    [exports.Chain.Mainnet]: {
+        name: 'mainnet',
+        blockNumber: util_1.BIGINT_0,
+        stateRoot: (0, util_1.hexToBytes)('0xd7f8974fb5ac78d9ac099b9ad5018bedc2ce0a72dad1827a1709da30580f0544'),
+    },
+    [exports.Chain.Sepolia]: {
+        name: 'sepolia',
+        blockNumber: util_1.BIGINT_0,
+        stateRoot: (0, util_1.hexToBytes)('0x5eb6e371a698b8d68f665192350ffcecbbbf322916f4b51bd79bb6887da3f494'),
+    },
+    [exports.Chain.Holesky]: {
+        name: 'holesky',
+        blockNumber: util_1.BIGINT_0,
+        stateRoot: (0, util_1.hexToBytes)('0x69d8c9d72f6fa4ad42d4702b433707212f90db395eb54dc20bc85de253788783'),
+    },
+    [exports.Chain.Hoodi]: {
+        name: 'hoodi',
+        blockNumber: util_1.BIGINT_0,
+        stateRoot: (0, util_1.hexToBytes)('0xda87d7f5f91c51508791bbcbd4aa5baf04917830b86985eeb9ad3d5bfb657576'),
+    },
+};
+exports.Hardfork = {
+    Chainstart: 'chainstart',
+    Homestead: 'homestead',
+    Dao: 'dao',
+    TangerineWhistle: 'tangerineWhistle',
+    SpuriousDragon: 'spuriousDragon',
+    Byzantium: 'byzantium',
+    Constantinople: 'constantinople',
+    Petersburg: 'petersburg',
+    Istanbul: 'istanbul',
+    MuirGlacier: 'muirGlacier',
+    Berlin: 'berlin',
+    London: 'london',
+    ArrowGlacier: 'arrowGlacier',
+    GrayGlacier: 'grayGlacier',
+    MergeNetsplitBlock: 'mergeNetsplitBlock',
+    Paris: 'paris',
+    Shanghai: 'shanghai',
+    Cancun: 'cancun',
+    Prague: 'prague',
+    Osaka: 'osaka',
+    Bpo1: 'bpo1',
+    Bpo2: 'bpo2',
+    Bpo3: 'bpo3',
+    Bpo4: 'bpo4',
+    Bpo5: 'bpo5',
+    Amsterdam: 'amsterdam',
+};
+exports.ConsensusType = {
+    ProofOfStake: 'pos',
+    ProofOfWork: 'pow',
+    ProofOfAuthority: 'poa',
+};
+exports.ConsensusAlgorithm = {
+    Ethash: 'ethash',
+    Clique: 'clique',
+    Casper: 'casper',
+};
+//# sourceMappingURL=enums.js.map

package/dist/cjs/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":";;;AAAA,2CAAuD;AAI1C,QAAA,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,MAAM;CACL,CAAA;AAEV,2DAA2D;AAC9C,QAAA,mBAAmB,GAA+B,MAAM,CAAC,OAAO,CAAC,aAAK,CAAC,CAAC,MAAM,CACzF,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IACpB,GAAG,CAAC,KAAc,CAAC,GAAG,GAAG,CAAA;IACzB,OAAO,GAAG,CAAA;AACZ,CAAC,EACD,EAAgC,CACjC,CAAA;AAaD,mFAAmF;AACnF;;GAEG;AACU,QAAA,YAAY,GAAgC;IACvD,CAAC,aAAK,CAAC,OAAO,CAAC,EAAE;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAQ;QACrB,SAAS,EAAE,IAAA,iBAAU,EAAC,oEAAoE,CAAC;KAC5F;IACD,CAAC,aAAK,CAAC,OAAO,CAAC,EAAE;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAQ;QACrB,SAAS,EAAE,IAAA,iBAAU,EAAC,oEAAoE,CAAC;KAC5F;IACD,CAAC,aAAK,CAAC,OAAO,CAAC,EAAE;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAQ;QACrB,SAAS,EAAE,IAAA,iBAAU,EAAC,oEAAoE,CAAC;KAC5F;IACD,CAAC,aAAK,CAAC,KAAK,CAAC,EAAE;QACb,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,eAAQ;QACrB,SAAS,EAAE,IAAA,iBAAU,EAAC,oEAAoE,CAAC;KAC5F;CACF,CAAA;AAIY,QAAA,QAAQ,GAAG;IACtB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,KAAK;IACV,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,kBAAkB,EAAE,oBAAoB;IACxC,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACd,CAAA;AAIG,QAAA,aAAa,GAAG;IAC3B,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,gBAAgB,EAAE,KAAK;CACf,CAAA;AAIG,QAAA,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAA"}

package/dist/cjs/gethGenesis.d.ts

@@ -0,0 +1,145 @@
+import { type PrefixedHexString } from '@feelyourprotocol/util';
+/**
+ * Interface for Geth Genesis Config
+ */
+export interface GethGenesisConfig {
+    chainId: number;
+    depositContractAddress?: string;
+    homesteadBlock?: number;
+    daoForkBlock?: number;
+    daoForkSupport?: boolean;
+    eip150Block?: number;
+    eip150Hash?: string;
+    eip155Block?: number;
+    eip158Block?: number;
+    byzantiumBlock?: number;
+    constantinopleBlock?: number;
+    petersburgBlock?: number;
+    istanbulBlock?: number;
+    muirGlacierBlock?: number;
+    berlinBlock?: number;
+    londonBlock?: number;
+    mergeForkBlock?: number;
+    cancunBlock?: number;
+    arrowGlacierBlock?: number;
+    grayGlacierBlock?: number;
+    mergeNetsplitBlock?: number;
+    shanghaiTime?: number;
+    cancunTime?: number;
+    pragueTime?: number;
+    terminalTotalDifficulty?: number;
+    terminalTotalDifficultyPassed?: boolean;
+    ethash?: {};
+    clique?: {
+        period?: number;
+        epoch?: number;
+        blockperiodseconds?: number;
+        epochlength?: number;
+    };
+    trustedCheckpoint?: {
+        sectionIndex: number;
+        sectionHead: string;
+        chtRoot: string;
+        bloomRoot: string;
+    };
+    trustedCheckpointOracle?: {
+        address: string;
+        signers: string[];
+        threshold: number;
+    };
+    blobSchedule?: GethGenesisBlobSchedule;
+    proofInBlocks?: boolean;
+}
+/**
+ * Interface for account allocation in Geth Genesis
+ */
+export interface GethGenesisAlloc {
+    [address: string]: {
+        balance: string;
+        code?: string;
+        storage?: {
+            [key: string]: string;
+        };
+        nonce?: string;
+    };
+}
+/**
+ * Interface for blob schedule in Geth Genesis (EIP-7840)
+ */
+export interface GethGenesisBlobSchedule {
+    [fork: string]: {
+        target?: number;
+        max?: number;
+        baseFeeUpdateFraction?: number;
+    };
+}
+/**
+ * Interface for Geth Genesis object
+ */
+export interface GethGenesis {
+    config: GethGenesisConfig;
+    name?: string;
+    excessBlobGas?: string;
+    requestsHash?: string;
+    nonce: string;
+    timestamp: string;
+    extraData?: string;
+    gasLimit: PrefixedHexString;
+    difficulty?: PrefixedHexString;
+    mixHash?: PrefixedHexString;
+    coinbase?: PrefixedHexString;
+    alloc: GethGenesisAlloc;
+    number?: PrefixedHexString;
+    gasUsed?: PrefixedHexString;
+    parentHash?: PrefixedHexString;
+    baseFeePerGas?: PrefixedHexString | number | null;
+}
+/**
+ * Type for the options passed to createCommonFromGethGenesis
+ */
+export interface CreateCommonFromGethGenesisOpts {
+    chain?: string;
+    genesisHash?: string;
+    mergeForkIdPostMerge?: boolean;
+}
+export type StoragePair = [key: PrefixedHexString, value: PrefixedHexString];
+export type AccountState = [
+    balance: PrefixedHexString,
+    code?: PrefixedHexString,
+    storage?: Array<StoragePair>,
+    nonce?: PrefixedHexString
+];
+/**
+ * If you are using a custom chain {@link Common}, pass the genesis state.
+ *
+ * Pattern 1 (with genesis state see {@link GenesisState} for format):
+ *
+ * ```javascript
+ * {
+ *   '0x0...01': '0x100', // For EoA
+ * }
+ * ```
+ *
+ * Pattern 2 (with complex genesis state, containing contract accounts and storage).
+ * Note that in {@link AccountState} there are two
+ * accepted types. This allows to easily insert accounts in the genesis state:
+ *
+ * A complex genesis state with Contract and EoA states would have the following format:
+ *
+ * ```javascript
+ * {
+ *   '0x0...01': '0x100', // For EoA
+ *   '0x0...02': ['0x1', '0xRUNTIME_BYTECODE', [[storageKey1, storageValue1], [storageKey2, storageValue2]]] // For contracts
+ * }
+ * ```
+ */
+export interface GenesisState {
+    [key: PrefixedHexString]: PrefixedHexString | AccountState;
+}
+/**
+ * Parses the geth genesis state into Blockchain {@link GenesisState}
+ * @param gethGenesis GethGenesis object
+ * @returns Parsed {@link GenesisState}
+ */
+export declare function parseGethGenesisState(gethGenesis: GethGenesis): GenesisState;
+//# sourceMappingURL=gethGenesis.d.ts.map

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

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

package/dist/cjs/gethGenesis.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseGethGenesisState = parseGethGenesisState;
+const util_1 = require("@feelyourprotocol/util");
+/**
+ * Parses the geth genesis state into Blockchain {@link GenesisState}
+ * @param gethGenesis GethGenesis object
+ * @returns Parsed {@link GenesisState}
+ */
+function parseGethGenesisState(gethGenesis) {
+    const state = {};
+    for (const address of Object.keys(gethGenesis.alloc)) {
+        const { balance: rawBalance, code: rawCode, nonce: rawNonce, storage: rawStorage, } = gethGenesis.alloc[address];
+        // create a map with lowercase for easy lookups
+        const prefixedAddress = (0, util_1.addHexPrefix)(address.toLowerCase());
+        const balance = (0, util_1.isHexString)(rawBalance) ? rawBalance : (0, util_1.bigIntToHex)(BigInt(rawBalance));
+        const code = rawCode !== undefined ? (0, util_1.addHexPrefix)(rawCode) : undefined;
+        const storage = rawStorage !== undefined
+            ? Object.entries(rawStorage).map((storagePair) => storagePair.map(util_1.addHexPrefix))
+            : undefined;
+        const nonce = rawNonce !== undefined ? (0, util_1.addHexPrefix)(rawNonce) : undefined;
+        state[prefixedAddress] = [balance, code, storage, nonce];
+    }
+    return state;
+}
+//# sourceMappingURL=gethGenesis.js.map

package/dist/cjs/gethGenesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gethGenesis.js","sourceRoot":"","sources":["../../src/gethGenesis.ts"],"names":[],"mappings":";;AAsJA,sDAwBC;AA9KD,2CAAiG;AAiJjG;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,WAAwB;IAC5D,MAAM,KAAK,GAAiB,EAAE,CAAA;IAE9B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,EACJ,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,UAAU,GACpB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC9B,+CAA+C;QAC/C,MAAM,eAAe,GAAG,IAAA,mBAAY,EAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,IAAA,kBAAW,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAA,kBAAW,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;QACtF,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,mBAAY,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACtE,MAAM,OAAO,GACX,UAAU,KAAK,SAAS;YACtB,CAAC,CAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAC9C,WAAW,CAAC,GAAG,CAAC,mBAAY,CAAC,CACZ;YACrB,CAAC,CAAC,SAAS,CAAA;QACf,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,mBAAY,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACzE,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/cjs/hardforks.d.ts

@@ -0,0 +1,3 @@
+import type { HardforksDict } from './types.ts';
+export declare const hardforksDict: HardforksDict;
+//# sourceMappingURL=hardforks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hardforks.d.ts","sourceRoot":"","sources":["../../src/hardforks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,eAAO,MAAM,aAAa,EAAE,aA0M3B,CAAA"}

package/dist/cjs/hardforks.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hardforksDict = void 0;
+exports.hardforksDict = {
+    /**
+     * Description: Start of the Ethereum main chain
+     * URL        : -
+     * Status     : Final
+     */
+    chainstart: {
+        eips: [1],
+    },
+    /**
+     * Description: Homestead hardfork with protocol and network changes
+     * URL        : https://eips.ethereum.org/EIPS/eip-606
+     * Status     : Final
+     */
+    homestead: {
+        eips: [606],
+    },
+    /**
+     * Description: DAO rescue hardfork
+     * URL        : https://eips.ethereum.org/EIPS/eip-779
+     * Status     : Final
+     */
+    dao: {
+        eips: [],
+    },
+    /**
+     * Description: Hardfork with gas cost changes for IO-heavy operations
+     * URL        : https://eips.ethereum.org/EIPS/eip-608
+     * Status     : Final
+     */
+    tangerineWhistle: {
+        eips: [608],
+    },
+    /**
+     * Description: HF with EIPs for simple replay attack protection, EXP cost increase, state trie clearing, contract code size limit
+     * URL        : https://eips.ethereum.org/EIPS/eip-607
+     * Status     : Final
+     */
+    spuriousDragon: {
+        eips: [607],
+    },
+    /**
+     * Description: Hardfork with new precompiles, instructions and other protocol changes
+     * URL        : https://eips.ethereum.org/EIPS/eip-609
+     * Status     : Final
+     */
+    byzantium: {
+        eips: [609],
+    },
+    /**
+     * Description: Postponed hardfork including EIP-1283 (SSTORE gas metering changes)
+     * URL        : https://eips.ethereum.org/EIPS/eip-1013
+     * Status     : Final
+     */
+    constantinople: {
+        eips: [1013],
+    },
+    /**
+     * Description: Aka constantinopleFix, removes EIP-1283, activate together with or after constantinople
+     * URL        : https://eips.ethereum.org/EIPS/eip-1716
+     * Status     : Final
+     */
+    petersburg: {
+        eips: [1716],
+    },
+    /**
+     * Description: HF targeted for December 2019 following the Constantinople/Petersburg HF
+     * URL        : https://eips.ethereum.org/EIPS/eip-1679
+     * Status     : Final
+     */
+    istanbul: {
+        eips: [1679],
+    },
+    /**
+     * Description: HF to delay the difficulty bomb
+     * URL        : https://eips.ethereum.org/EIPS/eip-2384
+     * Status     : Final
+     */
+    muirGlacier: {
+        eips: [2384],
+    },
+    /**
+     * Description: HF targeted for July 2020 following the Muir Glacier HF
+     * URL        : https://eips.ethereum.org/EIPS/eip-2070
+     * Status     : Final
+     */
+    berlin: {
+        eips: [2565, 2929, 2718, 2930],
+    },
+    /**
+     * Description: HF targeted for July 2021 following the Berlin fork
+     * URL        : https://github.com/ethereum/eth1.0-specs/blob/master/network-upgrades/mainnet-upgrades/london.md
+     * Status     : Final
+     */
+    london: {
+        eips: [1559, 3198, 3529, 3541],
+    },
+    /**
+     * Description: HF to delay the difficulty bomb
+     * URL        : https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/arrow-glacier.md
+     * Status     : Final
+     */
+    arrowGlacier: {
+        eips: [4345],
+    },
+    /**
+     * Description: Delaying the difficulty bomb to Mid September 2022
+     * URL        : https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/gray-glacier.md
+     * Status     : Final
+     */
+    grayGlacier: {
+        eips: [5133],
+    },
+    /**
+     * Description: Hardfork to upgrade the consensus mechanism to Proof-of-Stake
+     * URL        : https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/merge.md
+     * Status     : Final
+     */
+    paris: {
+        consensus: {
+            type: 'pos',
+            algorithm: 'casper',
+            casper: {},
+        },
+        eips: [3675, 4399],
+    },
+    /**
+     * Description: Pre-merge hardfork to fork off non-upgraded clients
+     * URL        : https://eips.ethereum.org/EIPS/eip-3675
+     * Status     : Final
+     */
+    mergeNetsplitBlock: {
+        eips: [],
+    },
+    /**
+     * Description: Next feature hardfork after the merge hardfork having withdrawals, warm coinbase, push0, limit/meter initcode
+     * URL        : https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/shanghai.md
+     * Status     : Final
+     */
+    shanghai: {
+        eips: [3651, 3855, 3860, 4895],
+    },
+    /**
+     * Description: Next feature hardfork after shanghai, includes proto-danksharding EIP 4844 blobs,
+     * transient storage opcodes, parent beacon block root availability in EVM, selfdestruct only in
+     * same transaction, and blob base fee opcode
+     * URL        : https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/cancun.md
+     * Status     : Final
+     */
+    cancun: {
+        eips: [1153, 4844, 4788, 5656, 6780, 7516],
+    },
+    /**
+     * Description: Next feature hardfork after cancun including EIP-7702 account abstraction + other EIPs
+     * URL        : https://eips.ethereum.org/EIPS/eip-7600
+     * Status     : Final
+     */
+    prague: {
+        eips: [2537, 2935, 6110, 7002, 7251, 7623, 7685, 7691, 7702],
+    },
+    /**
+     * Description: Next feature hardfork after prague (headliner: PeerDAS)
+     * URL        : https://eips.ethereum.org/EIPS/eip-7607
+     * Status     : Final
+     */
+    osaka: {
+        eips: [7594, 7823, 7825, 7883, 7892, 7939, 7951, 7918],
+    },
+    /**
+     * Description: HF to update the blob target, max and updateFraction (see also EIP-7892)
+     * URL        : TBD
+     * Status     : Final
+     */
+    bpo1: {
+        eips: [],
+        params: {
+            target: 10,
+            max: 15,
+            blobGasPriceUpdateFraction: 8346193,
+        },
+    },
+    /**
+     * Description: HF to update the blob target, max and updateFraction (see also EIP-7892)
+     * URL        : TBD
+     * Status     : Final
+     */
+    bpo2: {
+        eips: [],
+        params: {
+            target: 14,
+            max: 21,
+            blobGasPriceUpdateFraction: 11684671,
+        },
+    },
+    /**
+     * Description: Feature hardfork after osaka (headliner: EIP-7928 Block Level Access Lists (BAL))
+     * URL        : https://eips.ethereum.org/EIPS/eip-7773
+     * Status     : Draft (implementation incomplete + spec still moving!)
+     */
+    amsterdam: {
+        eips: [7708, 7843, 7778, 7928, 8024],
+    },
+};
+//# sourceMappingURL=hardforks.js.map

package/dist/cjs/hardforks.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,9 @@
+export * from './chains.ts';
+export * from './common.ts';
+export * from './constructors.ts';
+export * from './enums.ts';
+export * from './gethGenesis.ts';
+export * from './interfaces.ts';
+export * from './types.ts';
+export * from './utils.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./chains.js"), exports);
+__exportStar(require("./common.js"), exports);
+__exportStar(require("./constructors.js"), exports);
+__exportStar(require("./enums.js"), exports);
+__exportStar(require("./gethGenesis.js"), exports);
+__exportStar(require("./interfaces.js"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./utils.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,8CAA2B;AAC3B,oDAAiC;AACjC,6CAA0B;AAC1B,mDAAgC;AAChC,kDAA+B;AAC/B,6CAA0B;AAC1B,6CAA0B"}

package/dist/cjs/interfaces.d.ts

@@ -0,0 +1,132 @@
+/**
+ * External Interfaces for other EthereumJS libraries
+ */
+import type { Account, Address, BinaryTreeExecutionWitness, PrefixedHexString } from '@feelyourprotocol/util';
+export interface StorageDump {
+    [key: string]: string;
+}
+/**
+ * Object that can contain a set of storage keys associated with an account.
+ */
+export interface StorageRange {
+    /**
+     * A dictionary where the keys are hashed storage keys, and the values are
+     * objects containing the preimage of the hashed key (in `key`) and the
+     * storage key (in `value`). Currently, there is no way to retrieve preimages,
+     * so they are always `null`.
+     */
+    storage: {
+        [key: string]: {
+            key: string | null;
+            value: string;
+        };
+    };
+    /**
+     * The next (hashed) storage key after the greatest storage key
+     * contained in `storage`.
+     */
+    nextKey: string | null;
+}
+export type AccountFields = Partial<Pick<Account, 'nonce' | 'balance' | 'storageRoot' | 'codeHash' | 'codeSize'>>;
+export type StorageProof = {
+    key: PrefixedHexString;
+    proof: PrefixedHexString[];
+    value: PrefixedHexString;
+};
+export type Proof = {
+    address: PrefixedHexString;
+    balance: PrefixedHexString;
+    codeHash: PrefixedHexString;
+    nonce: PrefixedHexString;
+    storageHash: PrefixedHexString;
+    accountProof: PrefixedHexString[];
+    storageProof: StorageProof[];
+};
+/**
+ * Binary tree related
+ *
+ * Experimental (do not implement)
+ */
+export type AccessEventFlags = {
+    stemRead: boolean;
+    stemWrite: boolean;
+    chunkRead: boolean;
+    chunkWrite: boolean;
+    chunkFill: boolean;
+};
+export type BinaryTreeAccessedStateType = (typeof BinaryTreeAccessedStateType)[keyof typeof BinaryTreeAccessedStateType];
+export declare const BinaryTreeAccessedStateType: {
+    readonly BasicData: "basicData";
+    readonly CodeHash: "codeHash";
+    readonly Code: "code";
+    readonly Storage: "storage";
+};
+export type RawBinaryTreeAccessedState = {
+    address: Address;
+    treeIndex: number | bigint;
+    chunkIndex: number;
+    chunkKey: PrefixedHexString;
+};
+export type BinaryTreeAccessedState = {
+    type: Exclude<BinaryTreeAccessedStateType, typeof BinaryTreeAccessedStateType.Code | typeof BinaryTreeAccessedStateType.Storage>;
+} | {
+    type: typeof BinaryTreeAccessedStateType.Code;
+    codeOffset: number;
+} | {
+    type: typeof BinaryTreeAccessedStateType.Storage;
+    slot: bigint;
+};
+export type BinaryTreeAccessedStateWithAddress = BinaryTreeAccessedState & {
+    address: Address;
+    chunkKey: PrefixedHexString;
+};
+export interface BinaryTreeAccessWitnessInterface {
+    accesses(): Generator<BinaryTreeAccessedStateWithAddress>;
+    rawAccesses(): Generator<RawBinaryTreeAccessedState>;
+    debugWitnessCost(): void;
+    readAccountBasicData(address: Address): bigint;
+    writeAccountBasicData(address: Address): bigint;
+    readAccountCodeHash(address: Address): bigint;
+    writeAccountCodeHash(address: Address): bigint;
+    readAccountHeader(address: Address): bigint;
+    writeAccountHeader(address: Address): bigint;
+    readAccountCodeChunks(contract: Address, startPc: number, endPc: number): bigint;
+    writeAccountCodeChunks(contract: Address, startPc: number, endPc: number): bigint;
+    readAccountStorage(contract: Address, storageSlot: bigint): bigint;
+    writeAccountStorage(contract: Address, storageSlot: bigint): bigint;
+    merge(accessWitness: BinaryTreeAccessWitnessInterface): void;
+    commit(): void;
+    revert(): void;
+}
+export interface StateManagerInterface {
+    getAccount(address: Address): Promise<Account | undefined>;
+    putAccount(address: Address, account?: Account): Promise<void>;
+    deleteAccount(address: Address): Promise<void>;
+    modifyAccountFields(address: Address, accountFields: AccountFields): Promise<void>;
+    putCode(address: Address, value: Uint8Array): Promise<void>;
+    getCode(address: Address): Promise<Uint8Array>;
+    getCodeSize(address: Address): Promise<number>;
+    getStorage(address: Address, key: Uint8Array): Promise<Uint8Array>;
+    putStorage(address: Address, key: Uint8Array, value: Uint8Array): Promise<void>;
+    clearStorage(address: Address): Promise<void>;
+    checkpoint(): Promise<void>;
+    commit(): Promise<void>;
+    revert(): Promise<void>;
+    getStateRoot(): Promise<Uint8Array>;
+    setStateRoot(stateRoot: Uint8Array, clearCache?: boolean): Promise<void>;
+    hasStateRoot(root: Uint8Array): Promise<boolean>;
+    dumpStorage?(address: Address): Promise<StorageDump>;
+    dumpStorageRange?(address: Address, startKey: bigint, limit: number): Promise<StorageRange>;
+    originalStorageCache: {
+        get(address: Address, key: Uint8Array): Promise<Uint8Array>;
+        clear(): void;
+    };
+    generateCanonicalGenesis?(initState: any): Promise<void>;
+    initBinaryTreeExecutionWitness?(blockNum: bigint, executionWitness?: BinaryTreeExecutionWitness | null): void;
+    verifyBinaryTreePostState?(accessWitness: BinaryTreeAccessWitnessInterface): Promise<boolean>;
+    checkChunkWitnessPresent?(contract: Address, programCounter: number): Promise<boolean>;
+    getAppliedKey?(address: Uint8Array): Uint8Array;
+    clearCaches(): void;
+    shallowCopy(downlevelCaches?: boolean): StateManagerInterface;
+}
+//# sourceMappingURL=interfaces.d.ts.map