Files
hub-monorepo/protobufs
Cassandra Heart 2391c3a5e3 feat: storage registry support (#1052)
This PR adds support for storage events and includes the following changes:

Adds support for storage events in the protobufs
Updates the server to handle rent registry events
Updates the logger to include rent registry and storage admin registry events
Adds CLI option for L2 RPC URL
Adds methods to submit rent registry and storage admin registry events in the mock hub
Updates the sync engine to use L2 events provider
2023-07-12 18:43:41 -05:00
..

@farcaster/protobufs

Specifications for API's and data formats used in Hubble, including both Farcaster protocol types and Hubble specific types.

Schema Type Description Docs
Message Types for Farcaster deltas docs
RPC Types for gRPC APIs exposed by Hubs docs
Gossip Types for gossiping data between Hubs
IdRegistryEvent Types for representing on-chain activity
NameRegistryEvent Types for representing on-chain activity
HubState Types for for maintaining internal state

Getting Started

Generate Bindings

Coming soon

Generate Docs

Documentation of gRPC endpoints is done manually, but protoc can be used to generate Message docs:

  1. Install protoc
  2. Download latest protoc-gen-doc binary from the repo and place in this folder
  3. On OS X, you may need to remove the binary from quaratine with xattr -d com.apple.quarantine protoc-gen-doc
  4. Run protoc --plugin=protoc-gen-doc=./protoc-gen-doc --doc_out=. --doc_opt=markdown,message.md schemas/message.proto

The output should be merged with the existing documentation by hand because it makes some errors like not correctly documenting oneOf. It also organizes items alphabetically which makes it harder to parse.