Support Protobuf and gRPC

[aoudiamoncef]

• document all added functions
• try in sandbox /simulation/labnet
• unit tests on the added/changed features
  • make tests compile
  • make tests pass
• add logs allowing easy debugging in case the changes caused problems
• if the API has changed, update the API specification

Tasks:

• Better error handling
• Create a readme for code generation
• Full configuration support Full configuration support from Massa config system in gRPC API #3600

List of included methods:

• send_blocks Implement send_blocks method in gRPC API #3420
• send_endorsments Implement send_endorsements method in gRPC API #3423
• send_operations Implement send_operations method in gRPC API #3652
• get_datastore_entries Implement get_datastore_entries in gRPC API #3621
• get_selector_draws Implement get_selector_draws method in gRPC API #3421
• get_next_block_best_parents Implement get_next_block_best_parents method in gRPC API #3419
• get_transactions_throughput Implement get_transactions_throughput method/subscription in gRPC API #3426
• get_blocks_by_slots Add "sha256" ABI #3491
• new_blocks
• new_blocks_headers
• new_endorsements
• new_operations Implement get_executed_operations method #3422
• get_version

closes #3406 #3448

[aoudiamoncef]

Hi @AurelienFT,

IMHO, It's better to validated the build + send_blocks before continuing the work on other methods.

[aoudiamoncef]

@AurelienFT we got this in the CI:

➜  massa git:(feature/testnet-19-grpc) ✗ cargo doc --no-deps --all-features --document-private-items
warning: /Users/aoudiamoncef/Workspace/massa/massa-node/Cargo.toml: unused manifest key: build
warning: external crate `criterion` unused in `massa_execution_worker`: remove the dependency or add `use criterion as _;`
  --> massa-execution-worker/src/lib.rs:3:1
   |
3  | //! # General description
   | ^
   |
note: the lint level is defined here
  --> massa-execution-worker/src/lib.rs:80:9
   |
80 | #![warn(unused_crate_dependencies)]
   |         ^^^^^^^^^^^^^^^^^^^^^^^^^

solution:

#[cfg(any(feature = "benchmarking"))]
use criterion as _;

Could I add the compiler suggestion ?

Update: I did it and all is green

[aoudiamoncef]

I did a complete fix for all lints detected by buf lint (locally)

In tesnet 22, we could add buf Github Action build to our CI to keep the doc sync ?

Doc preview: https://refined-github-html-preview.kidonng.workers.dev/massalabs/massa/raw/feature/testnet-19-grpc/massa-proto/doc/index.html

[AurelienFT]

I think this is ready for merge @aoudiamoncef and @modship. Nice work ! 🎉

[aoudiamoncef]

Hi 👋, I have to add some missing comments in the doc and we'll merge It

[aoudiamoncef]

Finally, we are done with this huge PR a big up to @modship for your help 🥇

A big thank for @AurelienFT && @Leo-Besancon for your code reviews 👍🏻

Let's see the feedbacks in testnet 21 🚀

[AurelienFT]

Nice work guys, this is a clean first version and a great startup point ! 🎉