Stacks Wallet for Testnet

Introduction

The Stacks Wallet for Stacks 2.0 empowers users to send and receive Stacks (STX) tokens as well as participate in Stacking, a novel way to lock up STX locking in exchange for the opportunity to earn Bitcoin rewards.

The wallet supports the generation and entry of 24-word Secret Keys as well as access with a Ledger S or Ledger X device.

Important note: This page contains information only about a brand new version of the Stacks Wallet available for the Stacks 2.0 Testnet. It won't work for production-based transactions and Stacking until the Stacks blockchain reaches mainnet. It is compatible only with testnet – and made available exclusively for testing – until mainnet.

Bounties are available for any community members who uncover user-facing bugs. Please report any bugs you find at https://github.com/blockstack/stacks-wallet/issues.

If you are looking to send and receive production STX on Stacks 1.0, please visit wallet.blockstack.org where you can download production-ready software for that purpose.

Support

Support is available on Discord and Reddit as well as at support@blockstack.com.

Operating systems & requirements

Versions are available for MacOS, Windows and Linux. There's no other requirement for getting started with the Stacks Wallet.

Installation & setup

  1. Download for MacOS, Windows or Linux
  2. Double click the download and drag the "Stacks Wallet" icon into your "Applications" folder.
  3. Double click the "Stacks Wallet" application to open
  4. Select "Create a new wallet" if you haven't used the Stacks Wallet before.

    If you have a Ledger S or X, ensure that it's connected and unlocked with your PIN. Ensure that the "Stacks" application is installed on your Ledger device using the "Ledger Live" instructions below. Then proceed to select "Use a Ledger wallet".

    If you do not have a Ledger device, select "Create a software wallet".
  5. If you've selected "Create a software wallet", follow the instructions provided to generate and save a 24-word Secret Key.

Ledger Live instructions

The Stacks app is currently undergoing review by Ledger for listing in Ledger Live.

In the meantime, if you'd like to install and use the Stacks app on your Ledger device for testing purposes with the Stacks Wallet, follow instructions here for building and installing it from source.

Important notes:

  • Building from source works for Ledger S but not Ledger X
  • Do not install from source on any Ledger device that contains production assets
  • Install from source only on a specially marked Ledger device used exclusively for development or testing purposes

Once the app is approved and available in Ledger Live:

  1. Download the latest version of Ledger Live.
  2. Open Ledger Live and navigate to the "Manager" tab with your Ledger S or X device connected.
  3. Enter your PIN on the Ledger device and confirm "Allow Ledger manager"
  4. Search the app catalog for "Stacks (STX)" and select "Install"

Verify receive address on Ledger device

  1. Open the Stacks Wallet
  2. Select "I already have a wallet"
  3. Select "Continue with Ledger"
  4. Connect your Ledger and enter its PIN on the device
  5. Open the Stacks app on your Ledger device
  6. Select "Continue" to view the receive address on your Ledger device

View your balance with Ledger device

  1. Open the Stacks Wallet
  2. Select "I already have a wallet"
  3. Select "Continue with Ledger"
  4. Connect your Ledger and enter its PIN on the device
  5. Open the Stacks app on your Ledger device
  6. Select "Continue" to view the receive address on your Ledger device
  7. Select "Accept" on your Ledger device
  8. Your total balance is shown at the top of the window under "Total balance"

Receive STX with Ledger device

  1. Open the Stacks Wallet
  2. Select "I already have a wallet"
  3. Select "Continue with Ledger"
  4. Connect your Ledger and enter its PIN on the device
  5. Open the Stacks app on your Ledger device
  6. Select "Continue" to view the receive address on your Ledger device
  7. Select "Accept" on your Ledger device
  8. Select "Receive" at the top of the window under your total balance
  9. Copy the address shown or scan the displayed QR code to another wallet to receive STX from it

Send STX with Ledger device

  1. Open the Stacks Wallet
  2. Select "I already have a wallet"
  3. Select "Continue with Ledger"
  4. Connect your Ledger and enter its PIN on the device
  5. Open the Stacks app on your Ledger device
  6. Select "Continue" to view the receive address on your Ledger device
  7. Select "Accept" on your Ledger device
  8. Select "Send" at the top of the window under your total balance
  9. Enter the address to which you'd like to send STX, the amount of STX and an optional memo describing the transfer
  10. Select "Preview" then "Sign transaction and send" to initiate the transaction.
  11. Select "Sign transaction" and confirm the address displayed on your Ledger device.