LogoLogo
DownloadsBlock ExplorerSupport
  • πŸ’‘Introduction to Oxen
  • πŸ“Downloads
  • πŸ†˜Support
  • About the Oxen blockchain
    • πŸ—ΊοΈOverview
    • πŸ“ŠToken economics
      • πŸ”₯Token burning
    • πŸ–₯️Oxen Service Nodes
    • πŸ’“Pulse: PoS on Oxen
      • 🀿Pulse: Deep dive
    • πŸ‘οΈBlink: Instant transactions
  • Using the Oxen Blockchain
    • πŸ“Overview
    • πŸ’°Oxen Wallet & Guides
      • Preparing for GUI Wallet setup (Windows)
      • GUI Wallet setup
      • GUI Wallet Quickstart
      • GUI Wallet Staking
      • Oxen Mobile Wallet Quickstart
      • Mobile Wallet Staking Guide
      • Exporting a CSV of your wallet transaction history
      • CLI Wallet setup (macOS)
      • Oxen Ledger Wallet setup: GUI Wallet
      • Oxen Ledger Wallet setup: CLI Wallet
      • CLI Wallet commands
      • Restoring an Oxen CLI Wallet from seed
      • Restoring an Oxen CLI Wallet from keys
    • πŸ–₯️Service Node guides
      • 🏎️Express service node setup guide
      • 🍺Full service node setup guide
      • πŸ’ΈStaking to a shared Oxen Service Node
      • πŸ›‘Service Node deregistration
      • πŸ› οΈService node tools and upkeep
    • ⛴️Migrating to the new Session Network
      • βœ…Migration Checklist
      • ❓Migration FAQ
      • πŸ”—Connecting to an Arbitrum One RPC Endpoint
      • πŸ”€How to set up an oxend L2 proxy
    • πŸ”‘Using Oxen Name System (ONS)
    • πŸ€“Advanced
      • Service node πŸ“ž RPC calls
      • Daemon πŸ“ž RPC calls
      • Wallet πŸ“ž RPC calls
  • Products built on Oxen
    • πŸ”’Session
      • πŸ“šGuides
        • 🐧Installing on Linux (Debian based distros)
        • πŸ—£οΈSession Open Group Server Setup
          • πŸ“—Read Only Room Setup
      • πŸ”€Oxen Name Service for Session
      • πŸ—οΈNetwork infrastructure
      • πŸ“¨Message routing
      • πŸ“ŽAttachments
    • 🌐Lokinet
      • πŸ“šGuides
        • 🐧Installing on Linux (CLI)
        • 🐧Installing on Linux (GUI)
        • 🐧Linux troubleshooting
        • 🍎Installing on macOS
        • πŸͺŸInstalling on Windows
        • 🍎macOS troubleshooting
        • πŸ“žRun a secure Mumble server over Lokinet
      • πŸ‘‹Exit nodes
      • πŸ§‘β€πŸ’»πŸ§‘πŸ’» SNApps
        • πŸš€Accessing SNApps
        • πŸ–₯️Hosting SNApps
        • πŸ—ΊοΈDomain Names For Lokinet (ONS)
        • ⏺️Configuring SRV Records
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
Export as PDF
  1. Using the Oxen Blockchain
  2. Oxen Wallet & Guides

Oxen Ledger Wallet setup: GUI Wallet

PreviousCLI Wallet setup (macOS)NextOxen Ledger Wallet setup: CLI Wallet

Last updated 2 years ago

Was this helpful?

Using the Ledger hardware wallet with the Oxen GUI wallet is almost identical to the process with keys stored on your desktop. The two differences are:

  1. There is a special process to create the wallet file.

  2. When sending transactions the ledger device will prompt you to confirm the transaction.

Connect the hardware wallet to the PC and navigate to the oxen app.

The wallet needs to communicate with the Ledger and it must be on the Oxen dashboard page. This guide will demonstrate the process on a Ledger Nano S Plus. But both the Ledger Nano X and the Ledger Nano S will follow the same process.

From the Ledger app homepage (app selection) navigate to the Oxen app and press both buttons to select.

As the Oxen wallet app is currently being reviewed by the Ledger team you will first be prompted with a screen that reads β€œPending Ledger review”. This screen will display for a few seconds and then allow you to progress by pressing both buttons at the same time.

You should now arrive on the Oxen dashboard. The divide will display β€œOXEN wallet” and a truncated string of the Oxen address. On this Ledger you can see that the Oxen Address is β€œLCYwfQr..XHS”. This address should also match the address displayed on the GUI wallet.

The device will need to be on this screen to work with the Oxen GUI wallet. All communications to the device happen via this page on the Oxen wallet app. If you are on any other page on your Ledger device, the GUI wallet will display an error message.

Setting up a hardware wallet file:

When you open the GUI wallet you will see the regular wallet select screen. We will select β€œCreate New Wallet” from the dropdown menu which appears when clicking the + icon in the top right of the window.

The 1.8.0 version of the Oxen GUI wallet now has a checkbox on this page to confirm that the wallet will be a hardware wallet. Fill in the form with the new wallet name, password, check the hardware wallet box and click β€œCreate Wallet”

You will then receive a prompt from the Ledger to β€œExport View Key” in order to create the wallet file on your desktop. Navigate to the β€œAlways Export'' page by clicking the right button once, then click both buttons to accept.

Background on Exporting the View Key - Optional Technical Details on what just happened

One of the core functions of the wallet is to scan the blockchain which contains encrypted transactions. Each wallet has two keys that are used to:

1) Decrypt the encrypted transactions from the blockchain (View Key)

2) Craft transactions to spend funds in a transaction (Spend Key)

The wallet scans many transactions and processes a large amount of data to find the funds on the blockchain that belong to your wallet. This is an intensive computation that does take time on a regular computer. When using a hardware wallet the desktop does not have access to these keys, so we have two options to process the transaction:

  1. Do the heavy computation on the small ledger wallet chip

  2. Copy the View Key over to the desktop and let the bigger CPU handle this

There are drawbacks to both options. Doing the computation on the ledger is very slow. Exporting the view key is privacy reducing as it means if your desktop wallet is compromised it will be able to view your transactions (However it will not be able to make transactions).

Our recommendation is to export the view key and let the desktop process this calculation. The biggest benefit to having a hardware wallet is that a compromised computer will not be able to spend your funds so the tradeoff for processing the blockchain in a reasonable time is worth it in our opinion.

Continuing with the wallet creation

To access the hardware from now on, simply navigate through the wallet select page and you will see the new hardware wallet available under a heading called β€œHardware wallets”. Clicking into this wallet will require the ledger device to be opened to the Oxen App main screen.

Sending a transaction using the hardware wallet:

Navigate to the Send Transaction page on the wallet GUI

Create a transaction by filling in the address and amount fields of this page and then clicking β€œSend”

The hardware wallet will then begin processing the transaction. At first you will see the β€œProcesssing TX” screen. This page may take some time as the ledger has to do some heavy calculations.

After this point the Ledger will confirm the transaction fee. Click the right button once to navigate to the β€œAccept” page and click both buttons to progress.

Next the wallet will confirm the amount and the recipient. Navigate right with the right button and the recipient should match what was entered into the GUI software page. Keep navigating right until the ledger displays the β€œAccept” page and click both buttons to progress

After this point the GUI wallet will prompt you to confirm send. Click β€œSend” to broadcast the transaction to the network.

The ledger will do some final processing and you will be rewarded with a green β€œTransaction Sent” notification in the GUI wallet.

Once you have exported your view key (or not), the GUI wallet will display the β€œWallet Created Page” which shows the address of your newly created hardware wallet. This address should match what is on your ledger device. At this point the wallet has been successfully created. Click β€œopen wallet” and the GUI will navigate to the regular wallet dashboard page where you can spend/stake etc as usual.

πŸ’°