mirror of
https://github.com/farcasterxyz/hub-monorepo.git
synced 2026-04-18 03:00:22 -04:00
1b5f6b2c1f
* docs(hub-nodejs): fix incorrect submitMessage signature * docs: fix broken links in examples * docs: fix relative links not working on npm * docs: fix stackblitz link for chron-feed * chore: add changeset
Documentation
@farcaster/hub-nodejs has five major components:
- A Client, which can send and receive messages from a Farcaster Hub.
- Messages, which are the atomic units of change on the Farcaster network.
- Builders, which can be used to construct new messages.
- Signers, which are required by Builders to sign messages.
- Utils, which are helpers to deal with Farcaster idiosyncrasies.
Idiosyncrasies
- Timestamps are calculated from the Farcaster epoch, not the Unix epoch.
- Errors are handled with a monadic pattern, instead of try-catch.
- Ethers and noble are required to create new messages.
- Only Nodejs is supported, and browser support is a work in progress.
- Fixed length data is encoded in byte formats, instead of strings.
There are also a few Farcaster-specific terms that are very commonly used in this package:
| Term | Description |
|---|---|
| Cast | A public message posted by a user |
| Fid | A Farcaster id, issued by the Id Registry on Ethereum |
| Fname | A Farcaster username, issued by the Name Registry on Ethereum. |
| Hub | A node in the Farcaster network which stores Farcaster Messages |
| Reaction | A public action between a user and a piece of content (e.g. like, recast) |