If you are a developer, check out the integration guide.
What is Reef Extension for?
Reef extension is a browser extension that allows one to safely interact with Reef chain ecosystem without exposing the private keys. It can:
- Create Reef chain accounts (wallets)
- Safely sign transactions in Reef and community apps
- Bind Ethereum addresses and interact with EVM smart contracts
Reef extension is supported in the following apps:
A Ledger device is a hardware wallet that is considered one of the most secure ways to store your digital assets. Ledger uses an offline, or cold storage, method of generating private keys, making it a preferred method for many crypto users. This guide will help you to connect your Ledger device to the Reef extension. Using an app listed above, such as Reef console you can then use Reef extension to safely send REEF, stake REEF and other various actions from your hardware wallet account.
- a Ledger Nano S or a Ledger Nano X
- set up your Ledger device
- install Ledger Live on your device
- install Reef extension on your Chrome-like browser (Google Chrome, Chromium, Brave). At least 0.41.3 version is required.
Install Reef app
- Open the Manager in Ledger Live.
- Connect and unlock your Ledger Device.
- If asked, follow the onscreen instructions and Allow Ledger Manager.
- Find Reef app in the app catalog.
- Click the Install button:
- Wait for the app to install and then close the Ledger Live.
Using the Developer Release
Instructions for downloading the pre-release binary from the GitHub releases are written in the README for the Reef Ledger application GitHub repository.
On the releases page you can download the shell script
install_app.sh and then make it executable in your shell by typing the command
chmod +x install_app.sh.
install_app.sh help command will show you the available options:
$ ./install_app.sh --help Zondax Installer [Reef-2.8.3] [Warning: use only for test/demo apps] load - Load Reef app delete - Delete Reef app version - Show Reef app version
Next, you must make sure your Ledger device is plugged in and unlocked and you’re using the latest firmware. If everything is prepared, then type
./install_app.sh load and accept the prompts on your Ledger device to install the application.
First it will prompt you to Allow an unsafe manager - confirm this by switching the screen to the allow screen and pressing the corresponding buttons.
After some processing time, the screen of your device will update to say Install app Reef. Navigate all the way to the right, verify the Identifier hash matches the one that is printed in your terminal. Click both buttons on Perform Installation to install the application. It will ask again for your PIN code.
At the end of the process you should have the newly installed Reef application on the device.
Using a Ledger device on Reef console
Loading Your Account
Reef console already has an integration with the Ledger application so that your device will work with the browser interface after installation. The functionality is currently gated behind a feature setting that you will need to turn on.
In order to turn on the interoperability with the Reef Ledger application, go to the Settings tab in Reef Console. Find the option for attaching Ledger devices and switch the option from the default Do not attach Ledger devices to Attach Ledger via WebHID. Be aware: if you are not seeing this it is because there is no Ledger support on Firefox.
Save to keep your settings. Refresh the Reef Console website.
Once you confirm your selection, depending on your browser and its security settings, you might need to confirm the USB connection through a popup when adding the Ledger device for the first time.
Now we can load our Ledger device account. Open Reef extension window and select Attach ledger account:
Select the network on which you want to use the ledger and enter a descriptive name. Make sure the Reef app is open and focused on the Ledger device (it should say Reef Ready). Select the Account type and Account index (select 0 for both if you are not sure).
Click Import account and the account should be imported, designated by the USB icon.
Refresh the Reef console website to reload the Reef extension accounts. The Ledger account should not be visible in the Reef Console:
You can now use this account to interact with Reef apps and it will prompt your ledger for confirmation when you initiate a transaction.
Checking the account balance
Sending a transfer
- Go to Reef console.
- Click Send next to the injected Ledger device account.
- Change send to address to the desired account and provide the REEF amount.
- Click Make Transfer.
- Click Sign and submit.
- A popup should appear. Make sure your Reef app is opened on the Ledger device (it should say Reef Ready).
- Click on Sign on Ledger.
- The transaction data should appear on the Ledger device. Review the data and then move to the right and confirm the transaction by clicking both Ledger device buttons.
- Wait for the transaction to be included. At this point the transaction was successful.
Receiving a Transfer
In order to receive a transfer on the accounts stored on your Ledger device, you will need to provide the sender (i.e. the payer) with your address.
The easiest way to get your address is to click on the account name in Reef Console which will open a sidebar. Your address will be shown in this sidebar, along with some other information. Another method is just clicking on your account’s avatar icon - this immediately copies your address to the clipboard. You can also copy it in the Reef extension by clicking Copy icon next to the address.
Since Ledger does not support batch transactions, you must do two separate transactions when you want to stake using an account stored on a Ledger device.
- Go to the Staking tab found under the Network dropdown in the top navigation menu.
- Click the Account Actions pane in the inner navigation.
- Click + Stash instead of + Nominator or + Validator (selecting the latter two will not work).
- Input the amount of tokens to bond and confirm the transaction.
- Confirm the transaction on the Ledger device.
- When the transaction is included you will see the newly bonded account in the Account Actions page.
- Select Start Nominating or Start Validating to start nominating or validating.
- Confirm the transaction on the Reef Console and on the Ledger device.
If you need support visit one of the channels here.