Skip to content

The Nimbus Fluffy Guide#

Fluffy is the Nimbus client implementation of the Portal network specifications.

The Portal Network aims to deliver a reliable, sync-free, and decentralized access to the Ethereum blockchain. The network can be used by a light client to get access to Ethereum data and as such become a drop-in replacement for full nodes by providing that data through the existing Ethereum JSON RPC Execution API.

This book describes how to build, run and monitor the Fluffy client, and how to use and test its currently implemented functionality.

To quickly get your Fluffy node up and running, follow the quickstart page:

Development status#

The Portal Network is a project still in research phase. This client is thus still experimental.

The development of this client is on par with the latest Portal specifications and will continue to evolve according to the Portal specifications.

The Portal history, beacon and state sub-networks are already operational on the public Portal mainnet.

Fluffy is default ran on the Portal mainnet but can also be run on a (local) testnet.

Supported sub-networks and content:#

  • History network: headers, blocks, and receipts.
    • Note: Canonical verification is currently only enabled for pre-merge blocks.
  • State network: accounts and contract storage.
    • Note: The Portal mainnet does not yet hold all states, nor the recent state.
  • Beacon network: consensus light client data and historical summaries.

Supported functionality:#

  • Portal JSON-RPC API
  • Consensus light client sync through content available on the Portal beacon network.
  • Partial support of Execution JSON-RPC API:
    • web3_clientVersion
    • eth_chainId
    • eth_getBalance
    • eth_getBlockByHash
    • eth_getBlockByNumber
    • eth_getBlockTransactionCountByHash
    • eth_getCode
    • eth_getLogs (partial support: queries by blockhash)
    • eth_getProof
    • eth_getStorageAt
    • eth_getTransactionCount

Get in touch#

Need help with anything? Join us on Status and Discord.

If you'd like to contribute to Nimbus development:

Disclaimer#

This documentation assumes Nimbus Fluffy is in its ideal state. The project is still under heavy development. Please submit a Github issue if you come across a problem.