About Ledger Nano S
Ledger Nano S and other Ledger hardware wallets are very secure blockchain storage and a transaction signing devices. The private keys are generated by the device itself. They never leave the device and thus are impossible to steal or abuse. To use CargoX Platform securely the basic and most affordable model Ledger Nano S is more than enough. CargoX works with all Ledger devices.
Please note that as of this writing, the Ledger wallet works with Chrome browser only.
Where to buy?
Ledger hardware wallets can be purchased from manufacturer's online shop and from many resellers worldwide. We recommend to check your local Electronic/Computer stores or your favorite online retailers, as they frequently also have device in stock. Device must come in originally sealed box - if the package is open, reject it!
Setting up Ledger Nano S for the first time
Before you can use Ledger device you have to initialize it. This only needs to be done once. Since Ledger's software is evolving and is being updated monthly, follow Ledger's official instructions as they are guaranteed to be always up to date and valid.
The rough steps which you should do are:
- First thing you should do is install the latest version of the Ledger Live app, which is necessary in order for the device to work properly on your machine. Note that administrator access is required to install the app. If you cannot install the software, please get in touch with your system administrator.
- Once installed, connect the Ledger device to your computer via USB cable.
- Open Ledger Live app.
- Follow the in app wizard and follow instructions. Among other things be sure to: 4.1. Set up a security PIN for your Ledger.
4.2. Create a backup of your Ledger (write down 12 or 24 words on the paper card).
4.3. Store this paper card in a safe place (like a safe deposit box).
Anyone who can view these words, can "steal" your private key, so handle this card with extreme care as per your company's security policy. This card enables you to restore your blockchain ID in case you forget a PIN or lose your Ledger device. Don't skip this step!
- Complete the Ledger's initialization process.
- Prepare your Ledger to work with CargoX Platform, by configuring the Ethereum app on it. Once Ethereum app is open (if you do not have it, install it), go to Settings and verify that Contract data is set to Allowed (you can leave Debug data at NOT Displayed).
After completing all the steps described above and - in detail on Ledger's Live app/webpage/users manual - you should have a properly configured Ledger device, protected by a PIN code and also a backup 12- or 24-words written on the paper and stored in a safe place. Once this is done, you are ready to proceed with the registration of your CargoX account.
THE MOST IMPORTANT STEP WITH INITIALIZATION OF LEDGER IS CREATING A BACKUP! IF YOU SKIPPED THIS STEP, DO IT NOW.
Using Ledger with CargoX
After you have a configured your Ledger it is time to link it with your CargoX Platform account. If you haven't completed your account registration do so by visiting https://cargox.digital.
NOTE: If you have problem logging in with Ledger, please make sure your device is updated to the latest firmware.
Step 1: Plug in your hardware wallet
Make sure your Ledger is connected via USB.
Step 2: Enter PIN
Use buttons on your Ledger to enter the PIN you have set up previously.
Step 3: Open Ethereum app
Use your Ledger buttons to select and the Ethereum application, open it by pressing both buttons at once. Once in the app, you should see the Application ready prompt.
Step 4: Select "Ledger Hardware Wallet"
Step 4.1: To link your Ledger with your CargoX account, login to your CargoX account with username/password or any other blockchain key, then go to Account | My profile | Privacy & Security, and click Add new blockchain key. Select Ledger Hardware Wallet from the list and click Next.
Step 4.2: To login or to CargoX Platform with your Ledger, go to login CargoX Platform page, select I want to login with my blockchain key, then select More options and finally select Ledger Hardware Wallet from the list and click Next.
Step 4.3: To unlock your Ledger for signing the blockchain transaction, just follow instructions for login with your Ledger from step 5 onwards.
CargoX advanced sign in windows will open, and display instructions.
NOTE: On Windows 10, you might see Windows security popup flashing 5 times. It might tell you that there is a problem, or it might instruct you to sign in. This is normal, just ignore it and do not click the Cancel button.
Step 5: Select Ethereum address
Ledger supports multiple Ethereum addresses on one device. On the next screen you will be presented with a list of addresses configured on your Ledger wallet.
It is important that you choose one address and always use this address to log into the application.
When linking your Ledger to your CargoX account, select the address and click Next. On the next screen confirm your email by typing in the verification number sent to your email. With that your blockchain adding process will end, as you don't have to do any action on the Ledger device itself.
When logging in with your Ledger, on unlocking, or confirming transaction you will see a bit different window, but displaying the same 5 addresses as on the login. Choose yours, and click Next.
Step 6: Sign the message on your Ledger
To complete the log in / unlock / sign the transfer, you must sign a message. CargoX will show you this window:
NOTE: On Windows 10, you might again see the Windows security popup flashing a number of times.
Be mindful of your Ledger device and when its screen changes to Sign message:
Click the right button once, which will display a transaction message similar to this:
Then click the right button again, and display will change to ✓ Sign message:
Now press both buttons simultaneously to confirm signing.
Step 7: Your login / unlock / confirming transaction is complete
Similar action (sign the message) will be required every time you want to perform an blockchain related action on the CargoX platform (like when transferring the document, releasing cargo or similar).