Skip to main content

Fund Your Node

In order to start your Bee node on the mainnet, its Ethereum wallet must be funded with:

Take note that xBZZ is the bridged version of BZZ from Ethereum to the Gnosis Chain.

A node's wallet

When your Bee node is installed, an Ethereum wallet is also created. This wallet is used by Bee to interact with the blockchain (e.g. for sending and receiving cheques, or for making purchases of postage stamps, etc.).

Chequebook

When your node has downloaded enough content to exceed the free tier threshold, then cheques are sent to peers to provide payment in return for their services.

In order to send these cheques, a chequebook must be deployed on the blockchain for your node, and for full speed operation it can be funded with BZZ. This deployment happens when a node initialises for the first time. Your Bee node will warn you in its log if there aren't enough funds in its wallet for deploying the chequebook.

You can configure the amount of xBZZ to be sent from the node's wallet. It is 1 xBZZ by default, but it can be set to zero.

Joining the swarm (mainnet)

Basic deployment

If you want to get your Bee node up and running as easily as possible, then you can set its --swap-initial-deposit value to zero. This means that your node's chequebook will not get funded with xBZZ, meaning that other nodes will only serve it within the free tier bandwidth threshold.

Since gas fees on the Gnosis Chain are very low, you won't need much xDAI either to get started. You may acquire a small amount for free by using the official Gnosis Chain xDAI faucet xDAI Faucet. The required amount is a function of the current transaction fee on chain, but 0.01 xDAI should be more than enough to start up your node.

You can use the Blockscout block explorer to inspect what's going on with your wallet by searching for its Ethereum address.

Full performance node

If you want to run a full node, or upload a lot of content, then you may need more xDAI for gas. To acquire this, you may convert DAI on the main Ethereum network to xDAI using the xDAI bridge, or buy xDAI directly using fiat.

You will also need to fund your node with more xBZZ for full speed access, or to purchase postage stamps to upload content. To bridge BZZ from the Ethereum mainet to the Gnosis Chain, you may use OmniBridge.

To find out what your node's Ethereum address is, please consult your relevant installation guide or check your logs!

Configure Your Wallet App

To interact with the BZZ ecosystem, you will need to make a couple of small configuration additions to your wallet software. In the case of e.g. MetaMask, you'll need to add the Gnosis Chain network, and then add a custom token.

The canonical addresses for the BZZ token on the various blockchains are as follows:

BlockchainContract address
Ethereum, BZZ0x19062190b1925b5b6689d7073fdfc8c2976ef8cb
Gnosis Chain, xBZZ0xdBF3Ea6F5beE45c02255B2c26a16F300502F68da
Goerli (testnet), gBZZ0x2ac3c1d3e24b45c6c310534bc2dd84b5ed576335

Accessing Your Node's Wallet

If you wish to interact with the node's wallet directly then you can import it into a wallet app like MetaMask. To do that you will need the wallet file and its password. A Bee node's wallet key is stored within the keys/ folder in its datadir, in JSON format, and its password should be in a file nearby it.

For example on Debian or Ubuntu:

sudo cat /var/lib/bee/keys/swarm.key
sudo cat /var/lib/bee/password

Testnet

A Bee node needs gETH and gBZZ in its wallet to be able to properly interact with the test network. One way to acquire these funds is to sign into our Discord and request gETH and gBZZ test tokens from the faucet bot to your node's Ethereum address.

To find out what your node's Ethereum address is, please consult the installation guide or check the logs!

Once you have the address:

  1. join our Discord server
  2. navigate to the #faucet channel
  3. verify your username
  4. request test tokens from the faucet bot

To request the tokens you must type (not copy paste) the following, replacing the address with your own:

/faucet sprinkle 0xabeeecdef123452a40f6ea9f598596ca8556bd57

If you have problems, please let us know by making a post in the #faucet channel, we will do our best to provide tokens to everyone.

Note that you should use a Chromium-based client (e.g., Chrome, native Discord client) to type the faucet command, as support for other browsers is spotty. It's reported to not work on Firefox, for example.

Transactions may take a while to complete, please be patient. We're also keen for you to join us in the swarm, and indeed you soon will! 🐝   🐝   🐝