@feelyourprotocol/blockchain 8141.0.0

package/dist/cjs/consensus/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthashConsensus = exports.CliqueConsensus = exports.CasperConsensus = void 0;
+const casper_ts_1 = require("./casper.js");
+Object.defineProperty(exports, "CasperConsensus", { enumerable: true, get: function () { return casper_ts_1.CasperConsensus; } });
+const clique_ts_1 = require("./clique.js");
+Object.defineProperty(exports, "CliqueConsensus", { enumerable: true, get: function () { return clique_ts_1.CliqueConsensus; } });
+const ethash_ts_1 = require("./ethash.js");
+Object.defineProperty(exports, "EthashConsensus", { enumerable: true, get: function () { return ethash_ts_1.EthashConsensus; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/consensus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/consensus/index.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAIpC,gGAJA,2BAAe,OAIA;AAHxB,2CAA6C;AAGnB,gGAHjB,2BAAe,OAGiB;AAFzC,2CAA6C;AAEF,gGAFlC,2BAAe,OAEkC"}

package/dist/cjs/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/cjs/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/cjs/constructors.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBlockchain = createBlockchain;
+exports.createBlockchainFromBlocksData = createBlockchainFromBlocksData;
+const block_1 = require("@feelyourprotocol/block");
+const util_1 = require("@feelyourprotocol/util");
+const debug_1 = require("debug");
+const index_ts_1 = require("./index.js");
+const DEBUG = (0, util_1.isDebugEnabled)('ethjs');
+const debug = (0, debug_1.default)('blockchain:#');
+async function createBlockchain(opts = {}) {
+    const blockchain = new index_ts_1.Blockchain(opts);
+    await blockchain.consensus?.setup({ blockchain });
+    let stateRoot = opts.genesisBlock?.header.stateRoot ?? opts.genesisStateRoot;
+    if (stateRoot === undefined) {
+        if (blockchain['_customGenesisState'] !== undefined) {
+            stateRoot = await (0, index_ts_1.genGenesisStateRoot)(blockchain['_customGenesisState'], blockchain.common);
+        }
+        else {
+            stateRoot = await (0, index_ts_1.getGenesisStateRoot)(Number(blockchain.common.chainId()), blockchain.common);
+        }
+    }
+    const genesisBlock = opts.genesisBlock ?? blockchain.createGenesisBlock(stateRoot);
+    let genesisHash = await blockchain.dbManager.numberToHash(util_1.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 && !(0, util_1.equalsBytes)(genesisBlock.hash(), dbGenesisBlock.hash())) {
+        throw (0, util_1.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((0, index_ts_1.DBSetTD)(genesisBlock.header.difficulty, util_1.BIGINT_0, genesisHash));
+        (0, index_ts_1.DBSetBlockOrHeader)(genesisBlock).map((op) => dbOps.push(op));
+        (0, index_ts_1.DBSaveLookups)(genesisHash, util_1.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 ${(0, util_1.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}
+ */
+async function createBlockchainFromBlocksData(blocksData, opts = {}) {
+    const blockchain = await createBlockchain(opts);
+    for (const blockData of blocksData) {
+        const block = (0, block_1.createBlock)(blockData, {
+            common: blockchain.common,
+            setHardfork: true,
+        });
+        await blockchain.putBlock(block);
+    }
+    return blockchain;
+}
+//# sourceMappingURL=constructors.js.map

package/dist/cjs/constructors.js.map

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

package/dist/cjs/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/cjs/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/cjs/db/cache.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = void 0;
+const util_1 = require("@feelyourprotocol/util");
+const lru_cache_1 = require("lru-cache");
+/**
+ * Simple LRU Cache that allows for keys of type Uint8Array
+ * @hidden
+ */
+class Cache {
+    constructor(opts) {
+        this._cache = new lru_cache_1.LRUCache(opts);
+    }
+    set(key, value) {
+        if (key instanceof Uint8Array) {
+            // Using deprecated bytesToUnprefixedHex for performance: used as LRU cache keys (string encoding).
+            key = (0, util_1.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 = (0, util_1.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 = (0, util_1.bytesToUnprefixedHex)(key);
+        }
+        this._cache.delete(key);
+    }
+}
+exports.Cache = Cache;
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/db/cache.ts"],"names":[],"mappings":";;;AAAA,2CAAuD;AACvD,yCAAoC;AAEpC;;;GAGG;AACH,MAAa,KAAK;IAGhB,YAAY,IAAkD;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAQ,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,GAAG,CAAC,GAAwB,EAAE,KAAQ;QACpC,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,mGAAmG;YACnG,GAAG,GAAG,IAAA,2BAAoB,EAAC,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,IAAA,2BAAoB,EAAC,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,IAAA,2BAAoB,EAAC,GAAG,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;CACF;AA/BD,sBA+BC"}

package/dist/cjs/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/cjs/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/cjs/db/constants.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/db/constants.ts"],"names":[],"mappings":";;;AAAA,2CAA0E;AAE1E,0BAA0B;AAE1B,MAAM,SAAS,GAAG,OAAO,CAAA;AAiEvB,8BAAS;AA/DX;;GAEG;AACH,MAAM,eAAe,GAAG,YAAY,CAAA;AA0DlC,0CAAe;AAxDjB;;GAEG;AACH,MAAM,cAAc,GAAG,WAAW,CAAA;AAoDhC,wCAAc;AAlDhB;;GAEG;AACH,MAAM,aAAa,GAAG,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAA;AAEtC;;GAEG;AACH,MAAM,SAAS,GAAG,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAA;AAElC;;GAEG;AACH,MAAM,UAAU,GAAG,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAA;AAEnC;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,GAAG,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAA;AAEpC,oBAAoB;AAEpB;;GAEG;AACH,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAA,oBAAa,EAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AAkBlE,4BAAQ;AAhBV,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAC5C,IAAA,kBAAW,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;AAsBxD,sBAAK;AApBP,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAAC,IAAA,kBAAW,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAiB9F,8BAAS;AAfX,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAgB,EAAE,EAAE,CAAC,IAAA,kBAAW,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAU1F,0BAAO;AART,MAAM,eAAe,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAA,kBAAW,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;AAexF,0CAAe;AAbjB,MAAM,eAAe,GAAG,CAAC,IAAgB,EAAE,EAAE,CAAC,IAAA,kBAAW,EAAC,iBAAiB,EAAE,IAAI,CAAC,CAAA;AAQhF,0CAAe"}

package/dist/cjs/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/cjs/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/cjs/db/helpers.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBOp = void 0;
+exports.DBSaveLookups = DBSaveLookups;
+exports.DBSetBlockOrHeader = DBSetBlockOrHeader;
+exports.DBSetHashToNumber = DBSetHashToNumber;
+exports.DBSetTD = DBSetTD;
+const block_1 = require("@feelyourprotocol/block");
+const rlp_1 = require("@feelyourprotocol/rlp");
+const util_1 = require("@feelyourprotocol/util");
+const constants_ts_1 = require("./constants.js");
+const operation_ts_1 = require("./operation.js");
+Object.defineProperty(exports, "DBOp", { enumerable: true, get: function () { return operation_ts_1.DBOp; } });
+/*
+ * 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 operation_ts_1.DBOp.set(operation_ts_1.DBTarget.TotalDifficulty, rlp_1.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_1.Block ? blockBody.header : blockBody;
+    const dbOps = [];
+    const blockNumber = header.number;
+    const blockHash = header.hash();
+    const headerValue = header.serialize();
+    dbOps.push(operation_ts_1.DBOp.set(operation_ts_1.DBTarget.Header, headerValue, {
+        blockNumber,
+        blockHash,
+    }));
+    const isGenesis = header.number === util_1.BIGINT_0;
+    if (isGenesis || blockBody instanceof block_1.Block) {
+        const bodyValue = rlp_1.RLP.encode(blockBody.raw().slice(1));
+        dbOps.push(operation_ts_1.DBOp.set(operation_ts_1.DBTarget.Body, bodyValue, {
+            blockNumber,
+            blockHash,
+        }));
+    }
+    return dbOps;
+}
+function DBSetHashToNumber(blockHash, blockNumber) {
+    const blockNumber8Byte = (0, constants_ts_1.bytesBE8)(blockNumber);
+    return operation_ts_1.DBOp.set(operation_ts_1.DBTarget.HashToNumber, blockNumber8Byte, {
+        blockHash,
+    });
+}
+function DBSaveLookups(blockHash, blockNumber, skipNumIndex) {
+    const ops = [];
+    if (skipNumIndex !== true) {
+        ops.push(operation_ts_1.DBOp.set(operation_ts_1.DBTarget.NumberToHash, blockHash, { blockNumber }));
+    }
+    const blockNumber8Bytes = (0, constants_ts_1.bytesBE8)(blockNumber);
+    ops.push(operation_ts_1.DBOp.set(operation_ts_1.DBTarget.HashToNumber, blockNumber8Bytes, {
+        blockHash,
+    }));
+    return ops;
+}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/db/helpers.ts"],"names":[],"mappings":";;;AAgFe,sCAAa;AAAE,gDAAkB;AAAE,8CAAiB;AAAE,0BAAO;AAhF5E,6CAAyC;AACzC,yCAAqC;AACrC,2CAA2C;AAE3C,iDAAyC;AACzC,iDAA+C;AA2EtC,qFA3EA,mBAAI,OA2EA;AAvEb;;;GAGG;AAEH,SAAS,OAAO,CAAC,EAAU,EAAE,WAAmB,EAAE,SAAqB;IACrE,OAAO,mBAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,eAAe,EAAE,SAAG,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,aAAK,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,mBAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;QACrC,WAAW;QACX,SAAS;KACV,CAAC,CACH,CAAA;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,eAAQ,CAAA;IAE5C,IAAI,SAAS,IAAI,SAAS,YAAY,aAAK,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,SAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,KAAK,CAAC,IAAI,CACR,mBAAI,CAAC,GAAG,CAAC,uBAAQ,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,IAAA,uBAAQ,EAAC,WAAW,CAAC,CAAA;IAC9C,OAAO,mBAAI,CAAC,GAAG,CAAC,uBAAQ,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,mBAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAA,uBAAQ,EAAC,WAAW,CAAC,CAAA;IAC/C,GAAG,CAAC,IAAI,CACN,mBAAI,CAAC,GAAG,CAAC,uBAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE;QACjD,SAAS;KACV,CAAC,CACH,CAAA;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/cjs/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/cjs/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/cjs/db/manager.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBManager = void 0;
+const block_1 = require("@feelyourprotocol/block");
+const rlp_1 = require("@feelyourprotocol/rlp");
+const util_1 = require("@feelyourprotocol/util");
+const cache_ts_1 = require("./cache.js");
+const operation_ts_1 = require("./operation.js");
+/**
+ * Abstraction over a DB to facilitate storing/fetching blockchain-related
+ * data, such as blocks and headers, indices, and the head block.
+ * @hidden
+ */
+class DBManager {
+    constructor(db, common) {
+        this._db = db;
+        this.common = common;
+        this._cache = {
+            td: new cache_ts_1.Cache({ max: 1024 }),
+            header: new cache_ts_1.Cache({ max: 512 }),
+            body: new cache_ts_1.Cache({ max: 256 }),
+            numberToHash: new cache_ts_1.Cache({ max: 2048 }),
+            hashToNumber: new cache_ts_1.Cache({ max: 2048 }),
+        };
+    }
+    /**
+     * Fetches iterator heads from the db.
+     */
+    async getHeads() {
+        const heads = (await this.get(operation_ts_1.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] = (0, util_1.unprefixedHexToBytes)(heads[key]);
+        }
+        return decodedHeads;
+    }
+    /**
+     * Fetches header of the head block.
+     */
+    async getHeadHeader() {
+        return this.get(operation_ts_1.DBTarget.HeadHeader);
+    }
+    /**
+     * Fetches head block.
+     */
+    async getHeadBlock() {
+        return this.get(operation_ts_1.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 (0, util_1.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 (!(0, util_1.equalsBytes)(header.transactionsTrie, util_1.KECCAK256_RLP)) {
+                throw (0, util_1.EthereumJSErrorWithoutCode)('transactionsTrie root should be equal to hash of null');
+            }
+            if (!(0, util_1.equalsBytes)(header.uncleHash, util_1.KECCAK256_RLP_ARRAY)) {
+                throw (0, util_1.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 (!(0, util_1.equalsBytes)(header.withdrawalsRoot, util_1.KECCAK256_RLP)) {
+                    throw (0, util_1.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 (0, block_1.createBlockFromBytesArray)(blockData, opts);
+    }
+    /**
+     * Fetches body of a block given its hash and number.
+     */
+    async getBody(blockHash, blockNumber) {
+        const body = await this.get(operation_ts_1.DBTarget.Body, { blockHash, blockNumber });
+        return body !== undefined ? rlp_1.RLP.decode(body) : undefined;
+    }
+    /**
+     * Fetches header of a block given its hash and number.
+     */
+    async getHeader(blockHash, blockNumber) {
+        const encodedHeader = await this.get(operation_ts_1.DBTarget.Header, { blockHash, blockNumber });
+        const headerValues = rlp_1.RLP.decode(encodedHeader);
+        const opts = { common: this.common, setHardfork: true };
+        return (0, block_1.createBlockHeaderFromBytesArray)(headerValues, opts);
+    }
+    /**
+     * Fetches total difficulty for a block given its hash and number.
+     */
+    async getTotalDifficulty(blockHash, blockNumber) {
+        const td = await this.get(operation_ts_1.DBTarget.TotalDifficulty, { blockHash, blockNumber });
+        return (0, util_1.bytesToBigInt)(rlp_1.RLP.decode(td));
+    }
+    /**
+     * Performs a block hash to block number lookup.
+     */
+    async hashToNumber(blockHash) {
+        const value = await this.get(operation_ts_1.DBTarget.HashToNumber, { blockHash });
+        if (value === undefined) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)(`value for ${(0, util_1.bytesToHex)(blockHash)} not found in DB`);
+        }
+        return value !== undefined ? (0, util_1.bytesToBigInt)(value) : undefined;
+    }
+    /**
+     * Performs a block number to block hash lookup.
+     */
+    async numberToHash(blockNumber) {
+        const value = await this.get(operation_ts_1.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 = operation_ts_1.DBOp.get(dbOperationTarget, key);
+        const cacheString = dbGetOperation.cacheString;
+        const dbKey = dbGetOperation.baseDBOp.key;
+        if (cacheString !== undefined) {
+            if (this._cache[cacheString] === undefined) {
+                throw (0, util_1.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);
+    }
+}
+exports.DBManager = DBManager;
+//# sourceMappingURL=manager.js.map