@lodestar/fork-choice 1.37.0-dev.f0ce024c1a → 1.37.0

package/lib/forkChoice/safeBlocks.d.ts

@@ -0,0 +1,21 @@
+import { Root, RootHex } from "@lodestar/types";
+import { IForkChoice } from "./interface.js";
+/**
+ * Under honest majority and certain network synchronicity assumptions there exists a block
+ * that is safe from re-orgs. Normally this block is pretty close to the head of canonical
+ * chain which makes it valuable to expose a safe block to users.
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_beacon_block_root
+ */
+export declare function getSafeBeaconBlockRoot(fc: IForkChoice): Root;
+/**
+ * Get execution payload hash for the safe block
+ * This function assumes that safe block is post Bellatrix and function should not be called otherwise.
+ *
+ * As our existing usage is aligned with above condition so not adding fork-check inside this function
+ *
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_execution_block_hash
+ */
+export declare function getSafeExecutionBlockHash(forkChoice: IForkChoice): RootHex;
+//# sourceMappingURL=safeBlocks.d.ts.map

package/lib/forkChoice/safeBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeBlocks.d.ts","sourceRoot":"","sources":["../../src/forkChoice/safeBlocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,IAAI,EAAE,OAAO,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO,CAE1E"}

package/lib/forkChoice/safeBlocks.js

@@ -0,0 +1,24 @@
+import { ZERO_HASH_HEX } from "@lodestar/params";
+/**
+ * Under honest majority and certain network synchronicity assumptions there exists a block
+ * that is safe from re-orgs. Normally this block is pretty close to the head of canonical
+ * chain which makes it valuable to expose a safe block to users.
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_beacon_block_root
+ */
+export function getSafeBeaconBlockRoot(fc) {
+    return fc.getJustifiedCheckpoint().root;
+}
+/**
+ * Get execution payload hash for the safe block
+ * This function assumes that safe block is post Bellatrix and function should not be called otherwise.
+ *
+ * As our existing usage is aligned with above condition so not adding fork-check inside this function
+ *
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_execution_block_hash
+ */
+export function getSafeExecutionBlockHash(forkChoice) {
+    return forkChoice.getJustifiedBlock().executionPayloadBlockHash ?? ZERO_HASH_HEX;
+}
+//# sourceMappingURL=safeBlocks.js.map

package/lib/forkChoice/safeBlocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeBlocks.js","sourceRoot":"","sources":["../../src/forkChoice/safeBlocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAI/C;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAe;IACpD,OAAO,EAAE,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAuB;IAC/D,OAAO,UAAU,CAAC,iBAAiB,EAAE,CAAC,yBAAyB,IAAI,aAAa,CAAC;AACnF,CAAC"}

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export { ForkChoiceError, ForkChoiceErrorCode, type InvalidAttestation, InvalidAttestationCode, type InvalidBlock, InvalidBlockCode, } from "./forkChoice/errors.js";
 export { ForkChoice, type ForkChoiceOpts, UpdateHeadOpt, assertValidTerminalPowBlock } from "./forkChoice/forkChoice.js";
 export { type AncestorResult, AncestorStatus, EpochDifference, type IForkChoice, NotReorgedReason, type PowBlockHex, } from "./forkChoice/interface.js";
+export * from "./forkChoice/safeBlocks.js";
 export { type CheckpointWithHex, ForkChoiceStore, type IForkChoiceStore, type JustifiedBalancesGetter, } from "./forkChoice/store.js";
 export { type ForkChoiceMetrics, getForkChoiceMetrics } from "./metrics.js";
 export type { BlockExtraMeta, LVHInvalidResponse, LVHValidResponse, MaybeValidExecutionStatus, ProtoBlock, ProtoNode, } from "./protoArray/interface.js";

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,sBAAsB,EACtB,KAAK,YAAY,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,UAAU,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACvH,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,eAAe,EACf,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAC,KAAK,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,cAAc,CAAC;AAC1E,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,sBAAsB,EACtB,KAAK,YAAY,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,UAAU,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACvH,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,eAAe,EACf,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAC,KAAK,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,cAAc,CAAC;AAC1E,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC"}

package/lib/index.js

@@ -1,6 +1,7 @@
 export { ForkChoiceError, ForkChoiceErrorCode, InvalidAttestationCode, InvalidBlockCode, } from "./forkChoice/errors.js";
 export { ForkChoice, UpdateHeadOpt, assertValidTerminalPowBlock } from "./forkChoice/forkChoice.js";
 export { AncestorStatus, EpochDifference, NotReorgedReason, } from "./forkChoice/interface.js";
+export * from "./forkChoice/safeBlocks.js";
 export { ForkChoiceStore, } from "./forkChoice/store.js";
 export { getForkChoiceMetrics } from "./metrics.js";
 export { ExecutionStatus } from "./protoArray/interface.js";

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EAEnB,sBAAsB,EAEtB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,UAAU,EAAuB,aAAa,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACvH,OAAO,EAEL,cAAc,EACd,eAAe,EAEf,gBAAgB,GAEjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAyB,oBAAoB,EAAC,MAAM,cAAc,CAAC;AAS1E,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EAEnB,sBAAsB,EAEtB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,UAAU,EAAuB,aAAa,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACvH,OAAO,EAEL,cAAc,EACd,eAAe,EAEf,gBAAgB,GAEjB,MAAM,2BAA2B,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAEL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAyB,oBAAoB,EAAC,MAAM,cAAc,CAAC;AAS1E,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -11,7 +11,7 @@
   "bugs": {
     "url": "https://github.com/ChainSafe/lodestar/issues"
   },
-  "version": "1.37.0-dev.f0ce024c1a",
+  "version": "1.37.0",
   "type": "module",
   "exports": {
     ".": {
@@ -40,11 +40,11 @@
   },
   "dependencies": {
     "@chainsafe/ssz": "^1.2.2",
-    "@lodestar/config": "1.37.0-dev.f0ce024c1a",
-    "@lodestar/params": "1.37.0-dev.f0ce024c1a",
-    "@lodestar/state-transition": "1.37.0-dev.f0ce024c1a",
-    "@lodestar/types": "1.37.0-dev.f0ce024c1a",
-    "@lodestar/utils": "1.37.0-dev.f0ce024c1a"
+    "@lodestar/config": "^1.37.0",
+    "@lodestar/params": "^1.37.0",
+    "@lodestar/state-transition": "^1.37.0",
+    "@lodestar/types": "^1.37.0",
+    "@lodestar/utils": "^1.37.0"
   },
   "keywords": [
     "ethereum",
@@ -52,5 +52,5 @@
     "beacon",
     "blockchain"
   ],
-  "gitHead": "5c8ae73b8b627e0ecde4543e02d52e212bcb6b18"
+  "gitHead": "eaf5bc974a483104665b6ed57b1a15e2fd48f730"
 }

package/src/forkChoice/safeBlocks.ts

@@ -0,0 +1,27 @@
+import {ZERO_HASH_HEX} from "@lodestar/params";
+import {Root, RootHex} from "@lodestar/types";
+import {IForkChoice} from "./interface.js";
+
+/**
+ * Under honest majority and certain network synchronicity assumptions there exists a block
+ * that is safe from re-orgs. Normally this block is pretty close to the head of canonical
+ * chain which makes it valuable to expose a safe block to users.
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_beacon_block_root
+ */
+export function getSafeBeaconBlockRoot(fc: IForkChoice): Root {
+  return fc.getJustifiedCheckpoint().root;
+}
+
+/**
+ * Get execution payload hash for the safe block
+ * This function assumes that safe block is post Bellatrix and function should not be called otherwise.
+ *
+ * As our existing usage is aligned with above condition so not adding fork-check inside this function
+ *
+ *
+ * https://github.com/ethereum/consensus-specs/blob/v1.6.0/fork_choice/safe-block.md#get_safe_execution_block_hash
+ */
+export function getSafeExecutionBlockHash(forkChoice: IForkChoice): RootHex {
+  return forkChoice.getJustifiedBlock().executionPayloadBlockHash ?? ZERO_HASH_HEX;
+}

package/src/index.ts

@@ -15,6 +15,7 @@ export {
   NotReorgedReason,
   type PowBlockHex,
 } from "./forkChoice/interface.js";
+export * from "./forkChoice/safeBlocks.js";
 export {
   type CheckpointWithHex,
   ForkChoiceStore,