In order to start your Bee node on the mainnet, its Ethereum wallet must be funded with:
The reason BZZ must be bridged to the Gnosis Chain is that the transaction fees are currently too high on the Ethereum mainnet for Swarm's purposes.
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.).
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 BZZ to be sent from the node's wallet. It is 1 BZZ by default, but it can be set to zero.
If you want to get your Bee node up and running as easily as possible, then you
can set its
value to zero. This means that your node's chequebook will not get funded with
BZZ, meaning that other nodes will only serve it within the free tier bandwidth
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 of it for free by using the BAO Community xDAI Faucet. The required amount is a function of the current transaction fee on the 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.
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 BZZ 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!
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 canoncial addresses for the BZZ token on the various blockchains are as follows:
|Gnosis Chain, xBZZ|
|Goerli (testnet), gBZZ|
When your Bee node is installed, an Ethereum wallet is 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.).
If you wish to interact with the node's wallet directly (e.g. by importing it into a wallet app like MetaMask), then you can access the wallet file as follows.
Your encrypted wallet file can be found as in this example:
And decrypted using the automatically generated password found at:
Your key can be found within the
keys/ folder of your datadir. For instance,
on a normal Ubuntu/Debian install you will find it at:
Once you have acquired your wallet file and its password, you may use any Ethereum wallet software such as MetaMask to interact with your wallet.
Your Bee node needs gETH and gBZZ to be able to properly interact with the test network. In order to receive these, you will need to sign into our Discord and request your gETH and gBZZ test tokens from the #faucet channel, using your node's Ethereum address.
To work out what your node's Ethereum address is, please consult your relevant installation guide or check your logs!
Once you have determined your Ethereum address, join our Discord server and navigate to the #faucet channel. After you have verified your username (and say hi! 👋), use our Faucet Bot to get your test tokens.
Here you must type (not copy paste) the following, replacing the address with your own:
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! 🐝 🐝 🐝