feat(interfaces): better doc for BlockValidationError and BlockExecutionError

[tcoratger]

This PR contains a better code documentation for BlockValidationError and BlockExecutionError enums inside the interfaces crate.

[mattsse]

lgtm

[codecov]

Codecov Report

Merging #4708 (0219e1d) into main (5be8ae4) will increase coverage by 0.01%.
Report is 1 commits behind head on main.
The diff coverage is n/a.

Files Changed	Coverage Δ
crates/interfaces/src/executor.rs	40.00% <ø> (ø)

... and 9 files with indirect coverage changes

Flag	Coverage Δ
integration-tests	16.74% <ø> (-0.01%)	⬇️
unit-tests	63.33% <ø> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Components	Coverage Δ
reth binary	32.17% <ø> (ø)
blockchain tree	83.75% <ø> (ø)
pipeline	88.53% <ø> (ø)
storage (db)	72.52% <ø> (ø)
trie	94.77% <ø> (+0.03%)	⬆️
txpool	50.28% <ø> (+0.46%)	⬆️
networking	77.12% <ø> (-0.03%)	⬇️
rpc	57.84% <ø> (ø)
consensus	62.97% <ø> (-0.13%)	⬇️
revm	28.38% <ø> (ø)
payload builder	8.35% <ø> (ø)
primitives	86.53% <ø> (-0.02%)	⬇️