Messages

Documentation for messages produced by Hubble.

1. Message

A Message is a delta operation on the Farcaster network. The message protobuf is an envelope that wraps a MessageData object and contains a hash and signature which can verify its authenticity.

Field	Type	Label	Description
data	MessageData		Contents of the message. Alternatively, you can use the data_bytes to serialize the MessageData
hash	bytes		Hash digest of data
hash_scheme	HashScheme		Hash scheme that produced the hash digest
signature	bytes		Signature of the hash digest
signature_scheme	SignatureScheme		Signature scheme that produced the signature
signer	bytes		Public key or address of the key pair that produced the signature
data_bytes	bytes		Alternate to the "data" field. If you are constructing the MessageData in a programing language other than Typescript, you can use this field to serialize the MessageData and calculate the hash and signature on these bytes. Optional.

1.1 MessageData

A MessageData object contains properties common to all MessagesTypes and wraps a body object which contains properties specific to the MessageType.

Field	Type	Label	Description
type	MessageType		Type of Message contained in the body
fid	uint64		Farcaster ID of the user producing the message
timestamp	uint32		Farcaster epoch timestamp in seconds
network	FarcasterNetwork		Farcaster network the message is intended for
body	CastAddBody, CastRemoveBody, ReactionBody, VerificationAddEthAddressBody, VerificationRemoveBody, UserDataBody, LinkBody, UserNameProof	oneOf	Properties specific to the MessageType

1.2 HashScheme

Type of hashing scheme used to produce a digest of MessageData

Name	Number	Description
HASH_SCHEME_NONE	0
HASH_SCHEME_BLAKE3	1	Default scheme for hashing MessageData

1.3 Signature Scheme

Type of signature scheme used to sign the Message hash

Name	Number	Description
SIGNATURE_SCHEME_NONE	0
SIGNATURE_SCHEME_ED25519	1	Ed25519 signature (default)
SIGNATURE_SCHEME_EIP712	2	ECDSA signature using EIP-712 scheme

1.4 Message Type

Type of the MessageBody

Name	Number	Description
MESSAGE_TYPE_NONE	0	Invalid default value
MESSAGE_TYPE_CAST_ADD	1	Add a new Cast
MESSAGE_TYPE_CAST_REMOVE	2	Remove an existing Cast
MESSAGE_TYPE_REACTION_ADD	3	Add a Reaction to a Cast
MESSAGE_TYPE_REACTION_REMOVE	4	Remove a Reaction from a Cast
MESSAGE_TYPE_LINK_ADD	5	Add a Link to a target
MESSAGE_TYPE_LINK_REMOVE	6	Remove a Link from a target
MESSAGE_TYPE_VERIFICATION_ADD_ETH_ADDRESS	7	Add a Verification of an Ethereum Address
MESSAGE_TYPE_VERIFICATION_REMOVE	8	Remove a Verification
MESSAGE_TYPE_USER_DATA_ADD	11	Add metadata about a user
MESSAGE_TYPE_USERNAME_PROOF	12	Add or replace a username proof

1.5 Farcaster Network

Farcaster network the message is intended for

Name	Number	Description
FARCASTER_NETWORK_NONE	0
FARCASTER_NETWORK_MAINNET	1	Public primary network
FARCASTER_NETWORK_TESTNET	2	Public test network
FARCASTER_NETWORK_DEVNET	3	Private test network

2. UserData

A UserData is a delta that contains metadata information about the user.

2.1 UserDataBody

Adds metadata about a user

Field	Type	Label	Description
type	UserDataType		Type of metadata
value	string		Value of the metadata

2.2 UserDataType

Type of UserData

Name	Number	Description
USER_DATA_TYPE_NONE	0	Invalid default value
USER_DATA_TYPE_PFP	1	Profile Picture for the user
USER_DATA_TYPE_DISPLAY	2	Display Name for the user
USER_DATA_TYPE_BIO	3	Bio for the user
USER_DATA_TYPE_URL	5	URL of the user
USER_DATA_TYPE_USERNAME	6	Preferred Farcaster Name for the user

3. Cast

A Cast is a delta that represents a new public update from a user. Casts can be added and removed at any time by the user.

3.1 CastAddBody

Adds a new Cast

Field	Type	Label	Description
embeds_deprecated	string	repeated	URLs to be embedded in the cast
mentions	uint64	repeated	Fids mentioned in the cast
parent_cast_id	CastId		Parent cast of the cast
parent_url	string		Parent URL of the cast
text	string		Text of the cast
mentions_positions	uint32	repeated	Positions of the mentions in the text
embeds	Embed	repeated	URLs or cast ids to be embedded in the cast

Embed

Field	Type	Label	Description
url	string
cast_id	CastId

3.2 CastRemoveBody

Removes an existing Cast

Field	Type	Label	Description
target_hash	bytes		Hash of the cast to remove

3.3 CastId

Identifier used to look up a Cast

Field	Type	Label	Description
fid	uint64		Fid of the user who created the cast
hash	bytes		Hash of the cast

4. Reaction

A Reaction is a delta that is applied by a user to a specific Cast.

4.1 ReactionBody

Adds or removes a Reaction from a Cast

Field	Type	Label	Description
type	ReactionType		Type of reaction
target_cast_id	CastId		CastId of the Cast to react to
target_url	string		URL to react to

4.2 ReactionType

Type of Reaction

Name	Number	Description
REACTION_TYPE_NONE	0	Invalid default value
REACTION_TYPE_LIKE	1	Like the target cast
REACTION_TYPE_RECAST	2	Share target cast to the user's audience

5. Link

5.1 LinkBody

Adds or removes a Link

Field	Type	Label	Description
type	string		Type of link, <= 8 characters
displayTimestamp	uint32	optional	User-defined timestamp that preserves original timestamp when message.data.timestamp needs to be updated for compaction
target_fid	uint64		The fid the link relates to

6. Verification

A Verification is a delta that contains a bi-directional signature proving that a fid has control over an Ethereum address.

6.1 VerificationAddEthAddressBody

Adds a Verification of ownership of an Ethereum Address

Field	Type	Label	Description
address	bytes		Ethereum address being verified
eth_signature	bytes		Signature produced by the user's Ethereum address
block_hash	bytes		Hash of the latest Ethereum block when the claim was produced

6.2 VerificationRemoveBody

Removes a Verification of any type

Field	Type	Label	Description
address	bytes		Address of the Verification to remove