Fund Your Node
In order to start your Bee node on the mainnet, its Ethereum wallet must be funded with:
1 xBZZ, for traffic accounting (this is optional, see below)
some xDAI, to pay the gas fees of a couple of transactions on the Gnosis Chain.
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 canoncial addresses for the BZZ token on the various blockchains are as follows:
| Blockchain | Contract address |
|---|---|
| Ethereum, BZZ | 0x19062190b1925b5b6689d7073fdfc8c2976ef8cb |
| Gnosis Chain, xBZZ | 0xdBF3Ea6F5beE45c02255B2c26a16F300502F68da |
| Goerli (testnet), gBZZ | 0x2ac3c1d3e24b45c6c310534bc2dd84b5ed576335 |
Accessing Your Node's Wallet
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.
Debian/Ubuntu Installation
With Bee Clef
Bee Clef is deprecated and is no longer under active development. It is not required for running a Bee node.
Your encrypted wallet file can be found as in this example:
sudo ls /var/lib/bee-clef/keystore
sudo cat /var/lib/bee-clef/keystore/UTC--2021-10-08T11-23-20.885085712Z--8789eb182fb94741ef65e29e0879d5a8bb721b9b
And decrypted using the automatically generated password found at:
sudo cat /var/lib/bee-clef/password
Without Bee Clef
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:
sudo cat /var/lib/bee/keys/libp2p.key
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.
Testnet
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:
/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! 🐝 🐝 🐝