Skip to content

feat: Expose set finalized/safe block in plugin api BlockchainService#7382

Merged
usmansaleem merged 20 commits intobesu-eth:mainfrom
usmansaleem:besu_plugin_blockchainservice_finalized_block
Jul 31, 2024
Merged

feat: Expose set finalized/safe block in plugin api BlockchainService#7382
usmansaleem merged 20 commits intobesu-eth:mainfrom
usmansaleem:besu_plugin_blockchainservice_finalized_block

Conversation

@usmansaleem
Copy link
Copy Markdown
Contributor

@usmansaleem usmansaleem commented Jul 26, 2024 •
edited
Loading

PR description

feat: Expose set finalized/safe block in plugin api BlockchainService. This method can be used by plugins to set finalized/safe block for a POA network (such as QBFT, IBFT and Clique).

Fixed Issue(s)

Thanks for sending a pull request! Have you done the following?

  • Checked out our contribution guidelines?
  • Considered documentation and added the doc-change-required label to this PR if updates are required.
  • Considered the changelog and included an update if required.
  • For database changes (e.g. KeyValueSegmentIdentifier) considered compatibility and performed forwards and backwards compatibility tests

Locally, you can run these tests to catch failures early:

  • unit tests: ./gradlew build
  • acceptance tests: ./gradlew acceptanceTest
  • integration tests: ./gradlew integrationTest
  • reference tests: ./gradlew ethereum:referenceTests:referenceTests

@usmansaleem
feat: Expose set finalized and safe block in plugin api BlockchainSer…
8868adb 
…vice

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
364f848 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
fab-10
fab-10 approved these changes Jul 26, 2024
View reviewed changes
Copy link
Copy Markdown
Contributor

@fab-10 fab-10 left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pretty straightforward, just thinking if we need to support some kind of checks, and allow to set these values only if we are not running a PoS network?

@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
97f2fe4 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
b8c01a2 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
check for poa network before setting finalized block
0178dcd 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem usmansaleem changed the title feat: Expose set finalized and safe block in plugin api BlockchainService feat: Expose set finalized block in plugin api BlockchainService Jul 30, 2024
@usmansaleem usmansaleem mentioned this pull request Jul 30, 2024
Closed
@usmansaleem
fix init call
c65f755 
Signed-off-by: Usman Saleem <usman@usmans.info>
jframe
jframe reviewed Jul 30, 2024
View reviewed changes
plugin-api/src/main/java/org/hyperledger/besu/plugin/services/BlockchainService.java Outdated
* @param blockHash Hash of the finalized block
* @throws UnsupportedOperationException if the network is not a POA network
*/
void setFinalizedBlock(Hash blockHash);
Copy link
Copy Markdown
Contributor

@jframe jframe Jul 30, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We also need the setSafeBlock method

Copy link
Copy Markdown
Contributor Author

@usmansaleem usmansaleem Jul 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done.

besu/src/main/java/org/hyperledger/besu/services/BlockchainServiceImpl.java Outdated

@Override
public void setFinalizedBlock(final Hash blockHash) {
if (genesisConfigOptionsSupplier != null) {
Copy link
Copy Markdown
Contributor

@jframe jframe Jul 30, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just checking the genesis isn't going to work for chains that transition to POS.

You could use the protocolSchedule to check the chain is POS for given blockHash by doing something like
protocolSchedule.getByBlockHeader(blockchain.getBlockHeader(blockHash).get()).isPoS()

Copy link
Copy Markdown
Contributor Author

@usmansaleem usmansaleem Jul 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done.

@usmansaleem
Check for PoS for finalized and safe block
c8f13b8 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
df461b2 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
revert the init method
a73a7bb 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
changelog
44c0735 
Signed-off-by: Usman Saleem <usman@usmans.info>
fab-10
fab-10 approved these changes Jul 30, 2024
View reviewed changes
Copy link
Copy Markdown
Contributor

@fab-10 fab-10 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM: consider adding few tests

@usmansaleem usmansaleem changed the title feat: Expose set finalized block in plugin api BlockchainService feat: Expose set finalized/safe block in plugin api BlockchainService Jul 31, 2024
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
a91166e 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Add BlockchainService set finalized acceptance test
3e89e43 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Add BlockchainService set finalized acceptance test
a52f185 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
fix doc sentence
77e6d87 
Signed-off-by: Usman Saleem <usman@usmans.info>
jframe
jframe reviewed Jul 31, 2024
View reviewed changes
...org/hyperledger/besu/tests/acceptance/plugins/BlockchainServiceFinalizedBlockPluginTest.java

@Test
@DisplayName("Calling updateFinalizedBlockV1 will set finalized block")
public void canUpdateFinalizedBlock() throws IOException {
Copy link
Copy Markdown
Contributor

@jframe jframe Jul 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should also test the updateSafeBlock method

Copy link
Copy Markdown
Contributor Author

@usmansaleem usmansaleem Jul 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done.

@usmansaleem
AT for set finalized and set safe
e3e4da0 
Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
04a09f5 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem
Merge remote-tracking branch 'upstream/main' into besu_plugin_blockch…
e05ccbc 
…ainservice_finalized_block

Signed-off-by: Usman Saleem <usman@usmans.info>
@usmansaleem usmansaleem enabled auto-merge (squash) July 31, 2024 08:00
@usmansaleem usmansaleem merged commit 9d92ae8 into besu-eth:main Jul 31, 2024
gconnect pushed a commit to gconnect/besu that referenced this pull request Aug 26, 2024
@usmansaleem @gconnect
feat: Expose set finalized/safe block in plugin-api BlockchainService (…
9e3e258 
…besu-eth#7382)

* feat: Expose set finalized and safe block in plugin-api BlockchainService
* check for poa network before setting finalized block
* changelog
* Add BlockchainService set finalized acceptance test

---------

Signed-off-by: Usman Saleem <usman@usmans.info>
Signed-off-by: gconnect <agatevureglory@gmail.com>
@usmansaleem usmansaleem deleted the besu_plugin_blockchainservice_finalized_block branch January 9, 2025 00:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jframe jframe jframe approved these changes

@fab-10 fab-10 fab-10 approved these changes

@garyschulte garyschulte Awaiting requested review from garyschulte

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@usmansaleem @jframe @fab-10
⚡