The Hedera Hashgraph API is implemented with protocol buffers, Google's language-neutral, platform-neutral, extensible mechanism for serializing structured data. This repository contains the current version of the files used to define the API.
The protobuf files themselves contain detailed comments which help understand not only the message itself but also some of the features and capabilities of the Hedera Hashgraph network.
The /docs folder of this project contains automatically generated documents in html and markdown format to help navigate through the message definitions.
NestedDoc.html - nested HTML document to help navigate messages that contain other message definitions (large document that takes a while to open) NotNestedDoc.html - flat HTML document NotNestedDoc.md - flat markdown document
Note: the HAPI.html document is a large document and may take a few seconds to load in a browser.
If you are unfamiliar with protocol buffers (or need a refresher), you may consult the following web resources:
- Protocol Buffers : https://developers.google.com/protocol-buffers/
- gRPC : https://grpc.io
You will need the appropriate credentials to do so
- Update the version number in the
pom.xml(ensure pom.xml has x.x.x-SNAPSHOT for version) - Build the project with
mvn clean install - Re-generate the documentation
cd docgenerator
java -jar proto2html.jar "HAPI Documentation" ../src/main/proto/ ../docsCommit all changes to github
mvn release:clean release:prepare (you will be prompted to confirm version numbers, etc...)
mvn release:perform
navigate to Nexus Repository Manager https://oss.sonatype.org/index.html#stagingRepositories and release the newly created repository.