Skip to main content
Hardware wallets are one of the most secure ways to manage your account. While you do not need a hardware wallet to use Trezu, it is highly recommended to use one — especially for your most critical operational roles, such as Finance and Governance.
Learn more on how to keep your treasury safe using a Ledger device in our blog post.

Setting Up Ledger with NEAR

  1. Download and install Ledger Live
  2. Connect your Ledger via USB or Bluetooth
  3. Open the Ledger Live application and ensure your device firmware is up to date
  4. In Ledger Live, install the NEAR app from the App Catalog
  5. Open the NEAR app on your Ledger device (the screen should display Application is ready)
NEAR app installed in Ledger Live

NEAR app (v2.4.3) installed in Ledger Live

Your Ledger is now set up, so you can readily use it to join a treasury in Trezu or create a new one.

1. Log in to Trezu

Go to trezu.app and click Login
  1. Select the Ledger option
  2. Choose between USB or Bluetooth connection depending on your device
  3. Your device will prompt you to confirm the connection — approve it on the device

2. Select a Derivation Path

At this point, you will be prompted to select a Derivation Path, which determines which private key you want the Ledger to use when signing transactions in Trezu. Derivation path selection
If you are unsure which one to select, do not worry—simply select the first one (Account 1).
Approve the selection on your Ledger device before proceeding to the next step.

3. Select an Account

Now that you have selected which private key you want to use, it is time to manually enter the account you want to log in with: AccountID Selection You can either use the implicit account derived directly from the selected derivation path, or input any other accountId of your choice. After confirming, you will see one of the following outcomes:
  1. Logged in successfully — the account exists and matches the selected Ledger private key
  2. Create account option — the account does not exist yet, so you can create it immediately
  3. Error message — the account exists, but it is linked to a different Ledger private key
To avoid key mismatch errors, use the same derivation path that was originally used with that accountId.
AdvancedIn NEAR, it is possible to add your Ledger public key to accounts that already exist; however, to do this you will need to use an external tool, such as the NEAR CLI.

4. You are in!

That’s it! You are now logged in to Trezu using your Ledger hardware wallet. Do not worry if you do not have funds in the account yet — Trezu sponsors creating the treasury, as well as interacting with proposals. You can simply use Trezu as you normally would, but now with the added security that all your actions will require physical confirmation on your Ledger device. Go ahead and create a new treasury, or ask your team to add you as a member to an existing one!