@feelyourprotocol/blockchain 8141.0.0

package/dist/esm/constructors.d.ts

@@ -0,0 +1,13 @@
+import { Blockchain } from './index.ts';
+import type { BlockData } from '@feelyourprotocol/block';
+import type { BlockchainOptions } from './index.ts';
+export declare function createBlockchain(opts?: BlockchainOptions): Promise<Blockchain>;
+/**
+ * Creates a blockchain from a list of block objects,
+ * objects must be readable by {@link createBlock}
+ *
+ * @param blockData List of block objects
+ * @param opts Constructor options, see {@link BlockchainOptions}
+ */
+export declare function createBlockchainFromBlocksData(blocksData: BlockData[], opts?: BlockchainOptions): Promise<Blockchain>;
+//# sourceMappingURL=constructors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../../src/constructors.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,UAAU,EAMX,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAQ,MAAM,YAAY,CAAA;AAKzD,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,uBAsElE;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,SAAS,EAAE,EACvB,IAAI,GAAE,iBAAsB,uBAW7B"}

package/dist/esm/constructors.js

@@ -0,0 +1,76 @@
+import { createBlock } from '@feelyourprotocol/block';
+import { BIGINT_0, EthereumJSErrorWithoutCode, bytesToHex, equalsBytes, isDebugEnabled, } from '@feelyourprotocol/util';
+import debugDefault from 'debug';
+import { Blockchain, DBSaveLookups, DBSetBlockOrHeader, DBSetTD, genGenesisStateRoot, getGenesisStateRoot, } from "./index.js";
+const DEBUG = isDebugEnabled('ethjs');
+const debug = debugDefault('blockchain:#');
+export async function createBlockchain(opts = {}) {
+    const blockchain = new Blockchain(opts);
+    await blockchain.consensus?.setup({ blockchain });
+    let stateRoot = opts.genesisBlock?.header.stateRoot ?? opts.genesisStateRoot;
+    if (stateRoot === undefined) {
+        if (blockchain['_customGenesisState'] !== undefined) {
+            stateRoot = await genGenesisStateRoot(blockchain['_customGenesisState'], blockchain.common);
+        }
+        else {
+            stateRoot = await getGenesisStateRoot(Number(blockchain.common.chainId()), blockchain.common);
+        }
+    }
+    const genesisBlock = opts.genesisBlock ?? blockchain.createGenesisBlock(stateRoot);
+    let genesisHash = await blockchain.dbManager.numberToHash(BIGINT_0);
+    const dbGenesisBlock = genesisHash !== undefined ? await blockchain.dbManager.getBlock(genesisHash) : undefined;
+    // If the DB has a genesis block, then verify that the genesis block in the
+    // DB is indeed the Genesis block generated or assigned.
+    if (dbGenesisBlock !== undefined && !equalsBytes(genesisBlock.hash(), dbGenesisBlock.hash())) {
+        throw EthereumJSErrorWithoutCode('The genesis block in the DB has a different hash than the provided genesis block.');
+    }
+    genesisHash = genesisBlock.hash();
+    if (!dbGenesisBlock) {
+        // If there is no genesis block put the genesis block in the DB.
+        // For that TD, the BlockOrHeader, and the Lookups have to be saved.
+        const dbOps = [];
+        dbOps.push(DBSetTD(genesisBlock.header.difficulty, BIGINT_0, genesisHash));
+        DBSetBlockOrHeader(genesisBlock).map((op) => dbOps.push(op));
+        DBSaveLookups(genesisHash, BIGINT_0).map((op) => dbOps.push(op));
+        await blockchain.dbManager.batch(dbOps);
+        await blockchain.consensus?.genesisInit(genesisBlock);
+    }
+    // At this point, we can safely set the genesis:
+    // it is either the one we put in the DB, or it is equal to the one
+    // which we read from the DB.
+    blockchain['_genesisBlock'] = genesisBlock;
+    // load verified iterator heads
+    const heads = await blockchain.dbManager.getHeads();
+    blockchain['_heads'] = heads ?? {};
+    // load headerchain head
+    let hash = await blockchain.dbManager.getHeadHeader();
+    blockchain['_headHeaderHash'] = hash ?? genesisHash;
+    // load blockchain head
+    hash = await blockchain.dbManager.getHeadBlock();
+    blockchain['_headBlockHash'] = hash ?? genesisHash;
+    if (blockchain['_hardforkByHeadBlockNumber']) {
+        const latestHeader = await blockchain['_getHeader'](blockchain['_headHeaderHash']);
+        await blockchain.checkAndTransitionHardForkByNumber(latestHeader.number, latestHeader.timestamp);
+    }
+    DEBUG && debug(`genesis block initialized with hash ${bytesToHex(genesisHash)}`);
+    return blockchain;
+}
+/**
+ * Creates a blockchain from a list of block objects,
+ * objects must be readable by {@link createBlock}
+ *
+ * @param blockData List of block objects
+ * @param opts Constructor options, see {@link BlockchainOptions}
+ */
+export async function createBlockchainFromBlocksData(blocksData, opts = {}) {
+    const blockchain = await createBlockchain(opts);
+    for (const blockData of blocksData) {
+        const block = createBlock(blockData, {
+            common: blockchain.common,
+            setHardfork: true,
+        });
+        await blockchain.putBlock(block);
+    }
+    return blockchain;
+}
+//# sourceMappingURL=constructors.js.map

package/dist/esm/constructors.js.map

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

package/dist/esm/db/cache.d.ts

@@ -0,0 +1,17 @@
+import { LRUCache } from 'lru-cache';
+/**
+ * Simple LRU Cache that allows for keys of type Uint8Array
+ * @hidden
+ */
+export declare class Cache<V> {
+    _cache: LRUCache<string, {
+        value: V;
+    }, void>;
+    constructor(opts: LRUCache.Options<string, {
+        value: V;
+    }, void>);
+    set(key: string | Uint8Array, value: V): void;
+    get(key: string | Uint8Array): V | undefined;
+    del(key: string | Uint8Array): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/esm/db/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/db/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;;;GAGG;AACH,qBAAa,KAAK,CAAC,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,EAAE,IAAI,CAAC,CAAA;gBAEhC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,EAAE,IAAI,CAAC;IAI9D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQ7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,CAAC,GAAG,SAAS;IAS5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;CAOpC"}

package/dist/esm/db/cache.js

@@ -0,0 +1,34 @@
+import { bytesToUnprefixedHex } from '@feelyourprotocol/util';
+import { LRUCache } from 'lru-cache';
+/**
+ * Simple LRU Cache that allows for keys of type Uint8Array
+ * @hidden
+ */
+export class Cache {
+    constructor(opts) {
+        this._cache = new LRUCache(opts);
+    }
+    set(key, value) {
+        if (key instanceof Uint8Array) {
+            // Using deprecated bytesToUnprefixedHex for performance: used as LRU cache keys (string encoding).
+            key = bytesToUnprefixedHex(key);
+        }
+        this._cache.set(key, { value });
+    }
+    get(key) {
+        if (key instanceof Uint8Array) {
+            // Using deprecated bytesToUnprefixedHex for performance: used as LRU cache keys (string encoding).
+            key = bytesToUnprefixedHex(key);
+        }
+        const elem = this._cache.get(key);
+        return elem !== undefined ? elem.value : undefined;
+    }
+    del(key) {
+        if (key instanceof Uint8Array) {
+            // Using deprecated bytesToUnprefixedHex for performance: used as LRU cache keys (string encoding).
+            key = bytesToUnprefixedHex(key);
+        }
+        this._cache.delete(key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/esm/db/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/db/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;;;GAGG;AACH,MAAM,OAAO,KAAK;IAGhB,YAAY,IAAkD;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,GAAG,CAAC,GAAwB,EAAE,KAAQ;QACpC,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,mGAAmG;YACnG,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,GAAG,CAAC,GAAwB;QAC1B,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,mGAAmG;YACnG,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACjC,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACpD,CAAC;IAED,GAAG,CAAC,GAAwB;QAC1B,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,mGAAmG;YACnG,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/esm/db/constants.d.ts

@@ -0,0 +1,23 @@
+declare const HEADS_KEY = "heads";
+/**
+ * Current canonical head for light sync
+ */
+declare const HEAD_HEADER_KEY = "LastHeader";
+/**
+ * Current canonical head for full sync
+ */
+declare const HEAD_BLOCK_KEY = "LastBlock";
+/**
+ * Convert bigint to big endian Uint8Array
+ */
+declare const bytesBE8: (n: bigint) => Uint8Array<ArrayBufferLike>;
+declare const tdKey: (n: bigint, hash: Uint8Array) => Uint8Array<ArrayBuffer>;
+declare const headerKey: (n: bigint, hash: Uint8Array) => Uint8Array<ArrayBuffer>;
+declare const bodyKey: (n: bigint, hash: Uint8Array) => Uint8Array<ArrayBuffer>;
+declare const numberToHashKey: (n: bigint) => Uint8Array<ArrayBuffer>;
+declare const hashToNumberKey: (hash: Uint8Array) => Uint8Array<ArrayBuffer>;
+/**
+ * @hidden
+ */
+export { bodyKey, bytesBE8, hashToNumberKey, HEAD_BLOCK_KEY, HEAD_HEADER_KEY, headerKey, HEADS_KEY, numberToHashKey, tdKey, };
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/db/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/db/constants.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,SAAS,UAAU,CAAA;AAEzB;;GAEG;AACH,QAAA,MAAM,eAAe,eAAe,CAAA;AAEpC;;GAEG;AACH,QAAA,MAAM,cAAc,cAAc,CAAA;AA6BlC;;GAEG;AACH,QAAA,MAAM,QAAQ,GAAI,GAAG,MAAM,gCAAyC,CAAA;AAEpE,QAAA,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,MAAM,UAAU,4BACgB,CAAA;AAE1D,QAAA,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,MAAM,UAAU,4BAAkD,CAAA;AAEhG,QAAA,MAAM,OAAO,GAAI,GAAG,MAAM,EAAE,MAAM,UAAU,4BAAgD,CAAA;AAE5F,QAAA,MAAM,eAAe,GAAI,GAAG,MAAM,4BAAwD,CAAA;AAE1F,QAAA,MAAM,eAAe,GAAI,MAAM,UAAU,4BAAyC,CAAA;AAElF;;GAEG;AACH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,GACN,CAAA"}

package/dist/esm/db/constants.js

@@ -0,0 +1,46 @@
+import { bigIntToBytes, concatBytes, utf8ToBytes } from '@feelyourprotocol/util';
+// Geth compatible DB keys
+const HEADS_KEY = 'heads';
+/**
+ * Current canonical head for light sync
+ */
+const HEAD_HEADER_KEY = 'LastHeader';
+/**
+ * Current canonical head for full sync
+ */
+const HEAD_BLOCK_KEY = 'LastBlock';
+/**
+ * headerPrefix + number + hash -> header
+ */
+const HEADER_PREFIX = utf8ToBytes('h');
+/**
+ * headerPrefix + number + hash + tdSuffix -> td
+ */
+const TD_SUFFIX = utf8ToBytes('t');
+/**
+ * headerPrefix + number + numSuffix -> hash
+ */
+const NUM_SUFFIX = utf8ToBytes('n');
+/**
+ * blockHashPrefix + hash -> number
+ */
+const BLOCK_HASH_PREFIX = utf8ToBytes('H');
+/**
+ * bodyPrefix + number + hash -> block body
+ */
+const BODY_PREFIX = utf8ToBytes('b');
+// Utility functions
+/**
+ * Convert bigint to big endian Uint8Array
+ */
+const bytesBE8 = (n) => bigIntToBytes(BigInt.asUintN(64, n));
+const tdKey = (n, hash) => concatBytes(HEADER_PREFIX, bytesBE8(n), hash, TD_SUFFIX);
+const headerKey = (n, hash) => concatBytes(HEADER_PREFIX, bytesBE8(n), hash);
+const bodyKey = (n, hash) => concatBytes(BODY_PREFIX, bytesBE8(n), hash);
+const numberToHashKey = (n) => concatBytes(HEADER_PREFIX, bytesBE8(n), NUM_SUFFIX);
+const hashToNumberKey = (hash) => concatBytes(BLOCK_HASH_PREFIX, hash);
+/**
+ * @hidden
+ */
+export { bodyKey, bytesBE8, hashToNumberKey, HEAD_BLOCK_KEY, HEAD_HEADER_KEY, headerKey, HEADS_KEY, numberToHashKey, tdKey, };
+//# sourceMappingURL=constants.js.map

package/dist/esm/db/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/db/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE1E,0BAA0B;AAE1B,MAAM,SAAS,GAAG,OAAO,CAAA;AAEzB;;GAEG;AACH,MAAM,eAAe,GAAG,YAAY,CAAA;AAEpC;;GAEG;AACH,MAAM,cAAc,GAAG,WAAW,CAAA;AAElC;;GAEG;AACH,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAEtC;;GAEG;AACH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAElC;;GAEG;AACH,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAEnC;;GAEG;AACH,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAEpC,oBAAoB;AAEpB;;GAEG;AACH,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AAEpE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAC5C,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;AAE1D,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAEhG,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAE5F,MAAM,eAAe,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;AAE1F,MAAM,eAAe,GAAG,CAAC,IAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAA;AAElF;;GAEG;AACH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,GACN,CAAA"}

package/dist/esm/db/helpers.d.ts

@@ -0,0 +1,9 @@
+import { Block } from '@feelyourprotocol/block';
+import { DBOp } from './operation.ts';
+import type { BlockHeader } from '@feelyourprotocol/block';
+declare function DBSetTD(TD: bigint, blockNumber: bigint, blockHash: Uint8Array): DBOp;
+declare function DBSetBlockOrHeader(blockBody: Block | BlockHeader): DBOp[];
+declare function DBSetHashToNumber(blockHash: Uint8Array, blockNumber: bigint): DBOp;
+declare function DBSaveLookups(blockHash: Uint8Array, blockNumber: bigint, skipNumIndex?: boolean): DBOp[];
+export { DBOp, DBSaveLookups, DBSetBlockOrHeader, DBSetHashToNumber, DBSetTD };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/esm/db/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/db/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAKzC,OAAO,EAAE,IAAI,EAAY,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAOpD,iBAAS,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,CAK7E;AASD,iBAAS,kBAAkB,CAAC,SAAS,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,EAAE,CA4BlE;AAED,iBAAS,iBAAiB,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAK3E;AAED,iBAAS,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,CAajG;AAED,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAA"}

package/dist/esm/db/helpers.js

@@ -0,0 +1,61 @@
+import { Block } from '@feelyourprotocol/block';
+import { RLP } from '@feelyourprotocol/rlp';
+import { BIGINT_0 } from '@feelyourprotocol/util';
+import { bytesBE8 } from "./constants.js";
+import { DBOp, DBTarget } from "./operation.js";
+/*
+ * This extra helper file serves as an interface between the blockchain API functionality
+ * and the DB operations from `db/operation.ts` and also handles the right encoding of the keys
+ */
+function DBSetTD(TD, blockNumber, blockHash) {
+    return DBOp.set(DBTarget.TotalDifficulty, RLP.encode(TD), {
+        blockNumber,
+        blockHash,
+    });
+}
+/*
+ * This method accepts either a BlockHeader or a Block and returns a list of DatabaseOperation instances
+ *
+ * - A "Set Header Operation" is always added
+ * - A "Set Body Operation" is only added if the body is not empty (it has transactions/uncles) or if the block is the genesis block
+ * (if there is a header but no block saved the DB will implicitly assume the block to be empty)
+ */
+function DBSetBlockOrHeader(blockBody) {
+    const header = blockBody instanceof Block ? blockBody.header : blockBody;
+    const dbOps = [];
+    const blockNumber = header.number;
+    const blockHash = header.hash();
+    const headerValue = header.serialize();
+    dbOps.push(DBOp.set(DBTarget.Header, headerValue, {
+        blockNumber,
+        blockHash,
+    }));
+    const isGenesis = header.number === BIGINT_0;
+    if (isGenesis || blockBody instanceof Block) {
+        const bodyValue = RLP.encode(blockBody.raw().slice(1));
+        dbOps.push(DBOp.set(DBTarget.Body, bodyValue, {
+            blockNumber,
+            blockHash,
+        }));
+    }
+    return dbOps;
+}
+function DBSetHashToNumber(blockHash, blockNumber) {
+    const blockNumber8Byte = bytesBE8(blockNumber);
+    return DBOp.set(DBTarget.HashToNumber, blockNumber8Byte, {
+        blockHash,
+    });
+}
+function DBSaveLookups(blockHash, blockNumber, skipNumIndex) {
+    const ops = [];
+    if (skipNumIndex !== true) {
+        ops.push(DBOp.set(DBTarget.NumberToHash, blockHash, { blockNumber }));
+    }
+    const blockNumber8Bytes = bytesBE8(blockNumber);
+    ops.push(DBOp.set(DBTarget.HashToNumber, blockNumber8Bytes, {
+        blockHash,
+    }));
+    return ops;
+}
+export { DBOp, DBSaveLookups, DBSetBlockOrHeader, DBSetHashToNumber, DBSetTD };
+//# sourceMappingURL=helpers.js.map

package/dist/esm/db/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/db/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI/C;;;GAGG;AAEH,SAAS,OAAO,CAAC,EAAU,EAAE,WAAmB,EAAE,SAAqB;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QACxD,WAAW;QACX,SAAS;KACV,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,SAA8B;IACxD,MAAM,MAAM,GAAgB,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IACrF,MAAM,KAAK,GAAG,EAAE,CAAA;IAEhB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAA;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAE/B,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;IACtC,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;QACrC,WAAW;QACX,SAAS;KACV,CAAC,CACH,CAAA;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAA;IAE5C,IAAI,SAAS,IAAI,SAAS,YAAY,KAAK,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE;YACjC,WAAW;YACX,SAAS;SACV,CAAC,CACH,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAqB,EAAE,WAAmB;IACnE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,EAAE;QACvD,SAAS;KACV,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,SAAqB,EAAE,WAAmB,EAAE,YAAsB;IACvF,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;IAC/C,GAAG,CAAC,IAAI,CACN,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE;QACjD,SAAS;KACV,CAAC,CACH,CAAA;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAA"}

package/dist/esm/db/manager.d.ts

@@ -0,0 +1,78 @@
+import { Cache } from './cache.ts';
+import { DBOp, DBTarget } from './operation.ts';
+import type { Block, BlockBodyBytes } from '@feelyourprotocol/block';
+import type { Common } from '@feelyourprotocol/common';
+import type { DB, DBObject } from '@feelyourprotocol/util';
+import type { DatabaseKey } from './operation.ts';
+/**
+ * @hidden
+ */
+export interface GetOpts {
+    keyEncoding?: string;
+    valueEncoding?: string;
+    cache?: string;
+}
+export type CacheMap = {
+    [key: string]: Cache<Uint8Array>;
+};
+/**
+ * Abstraction over a DB to facilitate storing/fetching blockchain-related
+ * data, such as blocks and headers, indices, and the head block.
+ * @hidden
+ */
+export declare class DBManager {
+    private _cache;
+    readonly common: Common;
+    private _db;
+    constructor(db: DB<Uint8Array | string, Uint8Array | string | DBObject>, common: Common);
+    /**
+     * Fetches iterator heads from the db.
+     */
+    getHeads(): Promise<{
+        [key: string]: Uint8Array;
+    }>;
+    /**
+     * Fetches header of the head block.
+     */
+    getHeadHeader(): Promise<Uint8Array | undefined>;
+    /**
+     * Fetches head block.
+     */
+    getHeadBlock(): Promise<Uint8Array | undefined>;
+    /**
+     * Fetches a block (header and body) given a block id,
+     * which can be either its hash or its number.
+     */
+    getBlock(blockId: Uint8Array | bigint | number): Promise<Block | undefined>;
+    /**
+     * Fetches body of a block given its hash and number.
+     */
+    getBody(blockHash: Uint8Array, blockNumber: bigint): Promise<BlockBodyBytes | undefined>;
+    /**
+     * Fetches header of a block given its hash and number.
+     */
+    getHeader(blockHash: Uint8Array, blockNumber: bigint): Promise<import("@feelyourprotocol/block").BlockHeader>;
+    /**
+     * Fetches total difficulty for a block given its hash and number.
+     */
+    getTotalDifficulty(blockHash: Uint8Array, blockNumber: bigint): Promise<bigint>;
+    /**
+     * Performs a block hash to block number lookup.
+     */
+    hashToNumber(blockHash: Uint8Array): Promise<bigint | undefined>;
+    /**
+     * Performs a block number to block hash lookup.
+     */
+    numberToHash(blockNumber: bigint): Promise<Uint8Array | undefined>;
+    /**
+     * Fetches a key from the db. If `opts.cache` is specified
+     * it first tries to load from cache, and on cache miss will
+     * try to put the fetched item on cache afterwards.
+     */
+    get(dbOperationTarget: DBTarget, key?: DatabaseKey): Promise<any>;
+    /**
+     * Performs a batch operation on db.
+     */
+    batch(ops: DBOp[]): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/esm/db/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/db/manager.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAA4B,MAAM,mBAAmB,CAAA;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAa,EAAE,EAAE,QAAQ,EAAsB,MAAM,kBAAkB,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,CAAA;AAE3D;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAU;IACxB,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,OAAO,CAAC,GAAG,CAAyD;gBAExD,EAAE,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM;IAYvF;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IAaxD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAItD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrD;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAqDjF;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAK9F;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM;IAQ1D;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrF;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQtE;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAKxE;;;;OAIG;IACG,GAAG,CAAC,iBAAiB,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IA6BvE;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;CAmBxB"}

package/dist/esm/db/manager.js

@@ -0,0 +1,199 @@
+import { createBlockFromBytesArray, createBlockHeaderFromBytesArray } from '@feelyourprotocol/block';
+import { RLP } from '@feelyourprotocol/rlp';
+import { EthereumJSErrorWithoutCode, KECCAK256_RLP, KECCAK256_RLP_ARRAY, bytesToBigInt, bytesToHex, equalsBytes, unprefixedHexToBytes, } from '@feelyourprotocol/util';
+import { Cache } from "./cache.js";
+import { DBOp, DBTarget } from "./operation.js";
+/**
+ * Abstraction over a DB to facilitate storing/fetching blockchain-related
+ * data, such as blocks and headers, indices, and the head block.
+ * @hidden
+ */
+export class DBManager {
+    constructor(db, common) {
+        this._db = db;
+        this.common = common;
+        this._cache = {
+            td: new Cache({ max: 1024 }),
+            header: new Cache({ max: 512 }),
+            body: new Cache({ max: 256 }),
+            numberToHash: new Cache({ max: 2048 }),
+            hashToNumber: new Cache({ max: 2048 }),
+        };
+    }
+    /**
+     * Fetches iterator heads from the db.
+     */
+    async getHeads() {
+        const heads = (await this.get(DBTarget.Heads));
+        if (heads === undefined)
+            return heads;
+        const decodedHeads = {};
+        for (const key of Object.keys(heads)) {
+            // Heads are stored in DB as hex strings since Level converts Uint8Arrays
+            // to nested JSON objects when they are included in a value being stored
+            // in the DB
+            decodedHeads[key] = unprefixedHexToBytes(heads[key]);
+        }
+        return decodedHeads;
+    }
+    /**
+     * Fetches header of the head block.
+     */
+    async getHeadHeader() {
+        return this.get(DBTarget.HeadHeader);
+    }
+    /**
+     * Fetches head block.
+     */
+    async getHeadBlock() {
+        return this.get(DBTarget.HeadBlock);
+    }
+    /**
+     * Fetches a block (header and body) given a block id,
+     * which can be either its hash or its number.
+     */
+    async getBlock(blockId) {
+        if (typeof blockId === 'number' && Number.isInteger(blockId)) {
+            blockId = BigInt(blockId);
+        }
+        let number;
+        let hash;
+        if (blockId === undefined)
+            return undefined;
+        if (blockId instanceof Uint8Array) {
+            hash = blockId;
+            number = await this.hashToNumber(blockId);
+        }
+        else if (typeof blockId === 'bigint') {
+            number = blockId;
+            hash = await this.numberToHash(blockId);
+        }
+        else {
+            throw EthereumJSErrorWithoutCode('Unknown blockId type');
+        }
+        if (hash === undefined || number === undefined)
+            return undefined;
+        const header = await this.getHeader(hash, number);
+        let body = await this.getBody(hash, number);
+        // be backward compatible where we didn't use to store a body with no txs, uncles, withdrawals
+        // otherwise the body is never partially stored and if we have some body, its in entirety
+        if (body === undefined) {
+            body = [[], []];
+            // Do extra validations on the header since we are assuming empty transactions and uncles
+            if (!equalsBytes(header.transactionsTrie, KECCAK256_RLP)) {
+                throw EthereumJSErrorWithoutCode('transactionsTrie root should be equal to hash of null');
+            }
+            if (!equalsBytes(header.uncleHash, KECCAK256_RLP_ARRAY)) {
+                throw EthereumJSErrorWithoutCode('uncle hash should be equal to hash of empty array');
+            }
+            // If this block had empty withdrawals push an empty array in body
+            if (header.withdrawalsRoot !== undefined) {
+                // Do extra validations for withdrawal before assuming empty withdrawals
+                if (!equalsBytes(header.withdrawalsRoot, KECCAK256_RLP)) {
+                    throw EthereumJSErrorWithoutCode('withdrawals root shoot be equal to hash of null when no withdrawals');
+                }
+                else {
+                    body.push([]);
+                }
+            }
+        }
+        const blockData = [header.raw(), ...body];
+        const opts = { common: this.common, setHardfork: true };
+        return createBlockFromBytesArray(blockData, opts);
+    }
+    /**
+     * Fetches body of a block given its hash and number.
+     */
+    async getBody(blockHash, blockNumber) {
+        const body = await this.get(DBTarget.Body, { blockHash, blockNumber });
+        return body !== undefined ? RLP.decode(body) : undefined;
+    }
+    /**
+     * Fetches header of a block given its hash and number.
+     */
+    async getHeader(blockHash, blockNumber) {
+        const encodedHeader = await this.get(DBTarget.Header, { blockHash, blockNumber });
+        const headerValues = RLP.decode(encodedHeader);
+        const opts = { common: this.common, setHardfork: true };
+        return createBlockHeaderFromBytesArray(headerValues, opts);
+    }
+    /**
+     * Fetches total difficulty for a block given its hash and number.
+     */
+    async getTotalDifficulty(blockHash, blockNumber) {
+        const td = await this.get(DBTarget.TotalDifficulty, { blockHash, blockNumber });
+        return bytesToBigInt(RLP.decode(td));
+    }
+    /**
+     * Performs a block hash to block number lookup.
+     */
+    async hashToNumber(blockHash) {
+        const value = await this.get(DBTarget.HashToNumber, { blockHash });
+        if (value === undefined) {
+            throw EthereumJSErrorWithoutCode(`value for ${bytesToHex(blockHash)} not found in DB`);
+        }
+        return value !== undefined ? bytesToBigInt(value) : undefined;
+    }
+    /**
+     * Performs a block number to block hash lookup.
+     */
+    async numberToHash(blockNumber) {
+        const value = await this.get(DBTarget.NumberToHash, { blockNumber });
+        return value;
+    }
+    /**
+     * Fetches a key from the db. If `opts.cache` is specified
+     * it first tries to load from cache, and on cache miss will
+     * try to put the fetched item on cache afterwards.
+     */
+    async get(dbOperationTarget, key) {
+        const dbGetOperation = DBOp.get(dbOperationTarget, key);
+        const cacheString = dbGetOperation.cacheString;
+        const dbKey = dbGetOperation.baseDBOp.key;
+        if (cacheString !== undefined) {
+            if (this._cache[cacheString] === undefined) {
+                throw EthereumJSErrorWithoutCode(`Invalid cache: ${cacheString}`);
+            }
+            let value = this._cache[cacheString].get(dbKey);
+            if (value === undefined) {
+                value = (await this._db.get(dbKey, {
+                    keyEncoding: dbGetOperation.baseDBOp.keyEncoding,
+                    valueEncoding: dbGetOperation.baseDBOp.valueEncoding,
+                }));
+                if (value !== undefined) {
+                    this._cache[cacheString].set(dbKey, value);
+                }
+            }
+            return value;
+        }
+        return this._db.get(dbKey, {
+            keyEncoding: dbGetOperation.baseDBOp.keyEncoding,
+            valueEncoding: dbGetOperation.baseDBOp.valueEncoding,
+        });
+    }
+    /**
+     * Performs a batch operation on db.
+     */
+    async batch(ops) {
+        const convertedOps = ops.map((op) => {
+            const type = op.baseDBOp.type ?? (op.baseDBOp.value !== undefined ? 'put' : 'del');
+            const convertedOp = {
+                key: op.baseDBOp.key,
+                value: op.baseDBOp.value,
+                type,
+                opts: {
+                    keyEncoding: op.baseDBOp.keyEncoding,
+                    valueEncoding: op.baseDBOp.valueEncoding,
+                },
+            };
+            if (type === 'put')
+                return convertedOp;
+            else
+                return convertedOp;
+        });
+        // update the current cache for each operation
+        ops.map((op) => op.updateCache(this._cache));
+        return this._db.batch(convertedOps);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/esm/db/manager.js.map

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