The Casa app supports Ledger Nano S/S+ and Nano X devices.
Whether you are adding the Ledger, doing a health check, or sending funds from your Casa vault, we send you an email with a link you click, which brings you to the Ledger API, a web interface that allows you to add a signature from your keyset easily. Depending on your browser or other device settings, the web interface may have trouble recognizing the Ledger and will give an error message. The following error is a common issue with the Ledger:
Error. TypeError: undefined is not an object (evaluating 'transport.decorateAppAPIMethods')
If you get this error or another error, don't fret! There are a few troubleshooting steps you can try that may help you with this issue.
Checking the firmware
First, please check that you're running the latest firmware on your Ledger device by connecting it to the Ledger Live app:
For detailed instructions on updating the firmware on the Ledger, please see Ledger's support article on updating the device firmware.
Once you've updated the firmware, navigate back to Casa app send a new fresh email, and try the signing process again.
Using BTC Legacy app
Normally, you open the BTC app on your Ledger device to complete health checks or sign transactions with Casa.
If you are upgraded to the latest firmware on your Ledger, but your transaction fails to sign, you may attempt to use the "BTC Legacy" app within your Ledger device instead.
You can download the BTC Legacy app onto your Ledger by connecting your Ledger to Ledger Live. When prompted to connect, unlock, and open the BTC app on the Ledger, open the "BTC Legacy" app on the Ledger instead. This is a troubleshooting step only - the BTC Legacy app should not normally be needed to sign transactions.
Error code: “Access denied to use Ledger device”
Try selecting the device
Make sure to highlight or click on your device when the popup comes up before clicking Connect. If you do not see this window, try clicking the lock icon, but if you still cannot see it, you will need to use a different browser.
Trying a different browser
If you still have issues after updating the firmware, it's possible that some of your web browser's settings are preventing the Ledger from being recognized.
Chromium-based browsers like Chrome and Brave tend to work the best with our system. If you're using Chrome, for example, try Brave. Please note: Firefox is NOT supported for Ledger devices.
Other troubleshooting steps
If you've tried multiple browsers, it could be a different issue. Please try the following troubleshooting steps to get the Ledger to be recognized:
- Close out any other apps that might be using the Ledger (e.g., Ledger Live).
- Reboot the computer you're using to connect.
- Make sure no other USB devices are plugged in when performing a health check.
- Open the link into "incognito mode" or equivalent.
- Close the browser, unplug the Ledger, start the browser back up again, and then plug the Ledger back in.
- If your computer is running Windows 8, please upgrade your operating system.
- If your computer is running Windows 10, you may need to update a default settings flag in Chrome, by following these steps:
- Type in chrome://flags/#new-usb-backend into Chrome
- Disable new USB backend
- Sign again
Another thing to consider is your USB cable connecting the Ledger. Not all USB cables are rated for data transfer, so make sure that the USB cable you're connecting is the one that came with the Ledger, or is otherwise rated for data transfer (not just a charging cable).
Common errors:
0x6f00 error
REGISTERING WALLET Troubleshooting
“Access denied to use Ledger device”
Ledger device: UNKNOWN_ERROR (0x6511)
Ledger device: Internal error, please report (0x6f01)
"Ledger device: UNKOWN_ERROR” or “Ledger device: UNKNOWN_ERROR (0x6d02)”
“TypeError: Cannot read property ‘decorateAppAPIMethods’ of undefined”
“Cannot read property 'txData' of undefined”
“Ledger device: INS_NOT_SUPPORTED (0x6d00)”
“Transport status error, security not satisfied”
“Failed to sign with Ledger device: U2F OTHER_ERROR”
0x6f00 error
If the previous steps have not resolved this specific error for you, it could be that you are trying to send to a Taproot address. These are very long and begin with "bc1" and they are not currently supported in the Casa app for signing with Ledgers.
As a workaround, you could send the transaction first to your Pay wallet, then on to the Taproot address. Otherwise you will need to send to a different address format to complete the transaction.
@1 address error for ETH
If you scan the QR code for the ETH address in Casa app using a webcam or other device, it may come up as an address with a "@1" on the end. This is a feature of the network that allows differentiation between network layer levels. A workaround to this is to copy and paste the plain text of the ETH address rather than scanning the QR code.
If you've tried the above steps and are still having issues, please reach out to our support team, and we'll be happy to assist.
REGISTERING WALLET Troubleshooting
- Your first step should be updating the BTC app to version 2.1.1 or higher and attempting the flow again
- If browser UI times out while registering wallet, then just start the flow over completely by closing tab and opening the link from the email
- If you have two ledgers plugged into your computer, you may see “expected wallet HMAC” error; unplug one and restart flow, and this will be resolved
- Check out this article about the new Ledger wallet registration
“Expect wallet HMAC”
will be shown if the user hits continue on the below page and DOES NOT have the Bitcoin App OPEN on their ledger and has never registered the wallet before
“Access denied to use Ledger device”
Click the ‘Nano S’ or ‘Nano X’ text in the popup next to the left side of the URL to get the ‘connect’ button to become clickable.
Ledger device: UNKNOWN_ERROR (0x6511)
You need to open the BTC app on the Ledger. When you see the BTC logo in the middle of your screen, press both buttons simultaneously to open the BTC app.
Ledger device: Internal error, please report (0x6f01)
Update Ledger firmware using Ledger Live
Tips if you run into issues updating your ledger firmware:
- Ensure the Ledger Live desktop app is updated
- If the device gets stuck in the update process you have to disconnect it and hold the left button as you reconnect it to enter the bootloader mode
- Restarting your computer entirely may also resolve any firmware update issues
“Ledger device: UNKOWN_ERROR” or “Ledger device: UNKNOWN_ERROR (0x6d02)”
This message will display if you have entered your Ledger PIN but HAVE NOT launched the Bitcoin app. Please make sure that you’ve launched the Bitcoin App on your Ledger.
“TypeError: Cannot read property ‘decorateAppAPIMethods’ of undefined”
This happens when trying to add Nano X to a new keyset. Upgrade firmware to latest version.
“Cannot read property 'txData' of undefined”
This happens when trying to sign for a testnet transaction but you haven’t downloaded the testnet app. Solution: go into Ledger Live and download BTC testnet app.
“Unable to reset device”
New Chrome update seems to be clashing with Ledger.
"If you are affected, would suggest going to chrome://flags#new-usb-backend and disabling it and seeing if it improves.” (via https://github.com/polkadot-js/apps/issues/4049)
“Ledger device: INS_NOT_SUPPORTED (0x6d00)”
Make sure the Bitcoin app is running on the Ledger.
“Transport status error, security not satisfied”
Try a different dongle
“Invalid Channel”
Open Ledger Live and make sure that you can connect to MyLedger. Restart computer and try the email link again.
*You can also see this error when hitting “reject” on the Ledger when signing a BTC transaction.
TransportStatusError: Ledger device: Security not satisfied (dongle locked or have invalid access rights) (0x6982)
Open Ledger Live and make sure you can connect to MyLedger. Restart computer and try the email link again. Try a different dongle / USB cable. Not all are rated / capable for data transfer. Best advice is to use the cable that came with the device.
Tip: use same cable to connect to Ledger Live. If Ledger does not connect to Ledger Live, it’s likely a cable issue.
“Failed to sign with Ledger device: U2F OTHER_ERROR”
You were probably attempting to sign with Firefox. Try to use Chrome.
“The device is already open”
Simply exit the browser and restart the flow (ensuring the PIN and BTC app are launched) and you will fix this.
Windows, Chrome, and Ledger
- If you are running the most recent version of Chrome and can't get it to work with your Ledger: Type the following into a new tab in your browser: chrome://flags/#new-usb-backend
- Disable "new USB backend.'
Ledger Nano X: Casa supports Ledger X, but note that you must use it via USB (not Bluetooth), similar to the Nano S/S+.