You can find the latest version of the Stacks Wallet for testing against the Stacks Testnet under the "Releases" tab of the blockstack/stacks-wallet repository on GitHub.
Expand the "Assets" section for the latest release and select the version with "testnet" in the filename that matches your operating system (MacOS, Windows or Linux).
Users who have deposited BTC into the Stacks Wallet to pay for transaction fees can withdraw any remaining amounts by downloading and installing version v3.1.1.
This version comes with a new feature within "Settings" under "Withdraw BTC" that empowers you to enter a BTC receive for receipt of all remaining BTC in another wallet.
You can subsequently deposit additional BTC if you still need to pay for transaction fees on Stacks 1.0. Note, however, that BTC will no longer be needed for paying such fees on Stacks 2.0.
While v3.1.1 will stop functioning for the purposes of sending STX upon the release of Stacks 2.0, this version will remain available for users who want to withdraw BTC at their leisure.
Versions are available for MacOS, Windows and Linux. There's no other requirement for getting started with the Stacks Wallet.
Support is available on Discord and Reddit as well as at support@blockstack.com.
The Stacks app is available in Ledger Live. You'll need to install it there before proceeding to connect your Ledger Nano S or X device to the Stacks Wallet for authentication.
- Download and open Ledger Live
- Connect your Ledger device
- Upgrade your firmware for Ledger Nano S to version 1.6.1 or Nano X to version 1.2.4-5 or greater.
- Select "Settings" in the top-right corner of Ledger Live then the "Experimental features" tab
- Toggle on "Developer Mode"
- Go to "Manager" on the left-hand side of Ledger Live
- Connect and enter your PIN on your Ledger device
- Confirm "Allow Ledger manager" on device
- Search "Stacks" and select "Install"
- Return to Stacks Wallet and proceed with authentication
Important:
- Don't turn on "Developer Mode" before upgrading your firmware, otherwise Ledger Live won't show you the dialog to upgrade. If you don't see the upgrade option, turn off "Developer Mode" before proceeding.
- Press both top buttons on your Ledger device simultaneously to proceed whenever it shows "Pending Ledger review" on the screen.
- Ledger Blue has been discontinued and is not supported by the Stacks Wallet. You'll need to transfer your recovery phrase to a separate Nano S or X device.
Verify receive address on Ledger device
- Open the Stacks Wallet
- Select "I already have a wallet"
- Select "Continue with Ledger"
- Connect your Ledger and enter its PIN on the device
- Open the Stacks app on your Ledger device
- Select "Continue" to view the receive address on your Ledger device
View your balance with Ledger device
- Open the Stacks Wallet
- Select "I already have a wallet"
- Select "Continue with Ledger"
- Connect your Ledger and enter its PIN on the device
- Open the Stacks app on your Ledger device
- Select "Continue" to view the receive address on your Ledger device
- Select "Accept" on your Ledger device
- Your total balance is shown at the top of the window under "Total balance"
Receive STX with Ledger device
- Open the Stacks Wallet
- Select "I already have a wallet"
- Select "Continue with Ledger"
- Connect your Ledger and enter its PIN on the device
- Open the Stacks app on your Ledger device
- Select "Continue" to view the receive address on your Ledger device
- Select "Accept" on your Ledger device
- Select "Receive" at the top of the window under your total balance
- Copy the address shown or scan the displayed QR code to another wallet to receive STX from it
Send STX with Ledger device
- Open the Stacks Wallet
- Select "I already have a wallet"
- Select "Continue with Ledger"
- Connect your Ledger and enter its PIN on the device
- Open the Stacks app on your Ledger device
- Select "Continue" to view the receive address on your Ledger device
- Select "Accept" on your Ledger device
- Select "Send" at the top of the window under your total balance
- Enter the address to which you'd like to send STX, the amount of STX and an optional memo describing the transfer
- Select "Preview" then "Sign transaction and send" to initiate the transaction.
- Select "Sign transaction" and confirm the address displayed on your Ledger device.
The Stacks Wallet uses very small amounts of Bitcoin to pay fees for sending transactions. You need very small amounts of Bitcoin (BTC) for gas. The cost of gas you need fluctuates with the market price of Bitcoin.
You need an account with Coinbase or similar exchange to buy Bitcoin and send it to the Stacks Wallet. If you attempt to send STX with your wallet and you do not have enough Bitcoin to fuel the transaction, you’ll see this dialog:
To increase your Bitcoin for transactions, do the following:
- Click the settings icon in the upper right corner of the wallet. The system opens the “Settings” dialog.
- The dialog shows you how much BTC you currently have in your account.
- Select “Add BTC”. The systems displays the “Top Up” dialog with a Bitcoin address.
- Record the BTC address.
- Go to your Coinbase or similar account.
- Send Bitcoin to the address presented by the Stacks Wallet.
Review your Stacks Wallet settings to see the increase in your balance. Your BTC balance only appears in this area. The Bitcoin fuel address is tied to your Stacks wallet private key. No one else including Blockstack can access the Bitcoin.
To withdraw Bitcoin from the fuel address. Click on the Withdraw BTC button in the “Settings” dialog. Note that you can only withdraw the entire balance in one transaction.
It is important that you understand how to keep good security for your Stacks Wallet software.
Your wallet Secret Key or seed phrase is a cryptographic key with which you need to use the strictest security available to you.
The Cryptocurrency Security Standard publishes guidelines for key storage. These guidelines are presented from least (Level I) to most secure (Level III). We recommend you store your keys with at least Level II security. This level states that you should:
- Back up each of your cryptographic keys.
- Store the backup in a location separate location from where you use a key. For example, if you use the key at the office, you can store the key are your office.
- Protect your backup from access by unauthorized parties. For example, a safe, safe deposit box, or lock box are good examples of protecting access to a backup.
- Employ some form of tamper mechanism that allows your to determine when if you key was accessed by someone else. For example, you could use a sealed paper envelopes with handwritten signatures over the seal as a tamper mechanism.
You are responsible for recalling and protecting your keys. Blockstack does not store your seed phrase and cannot help you recover it. If you lose your seed phrase, you lose the key to your STX tokens, which can be a very costly mistake.
You can use any of these hardware wallets with the Stacks Wallet v3.0:
- Ledger Nano S
- Ledger Blue
- Trezor One
However, you can only use Ledger Nano S with v3.1 in particular and Ledger Blue is not compatible with the newer Stacks Wallet v4.x.
The private key on your hardware wallet device is used by the Stacks Wallet software to sign send transactions. Please consult the manufacturer for support in setting up and configuring your device.
Due to technical compatibility issues, we are currently unable to support other Trezor wallets such as Trezor T. Trezor support will also be dropped entirely from the new Stacks Wallet v4.x for Stacks 2.0.
Additionally, Trezor devices work with the Stacks Wallet only up to firmware version 1.8.3. If you have a newer firmware, we suggest you switch from Trezor to a Ledger hardware device by entering your existing Trezor seed phrase into a new Ledger device.
See Ledger documentation for guidance. You will need the original 24-word recovery phrase that you backed up when setting up your Trezor.
Alternatively, you can try downgrading your Trezor's firmware by following the instructions on this page. However, downgrading your Trezor firmware is dangerous and will erase your Trezor device, so make sure you have your Trezor seed phrase backed up first.
Just as you don’t keep all the money you have in your bank in a physical wallet, you shouldn’t keep large numbers of tokens in your cryptocurrency wallet. Instead, if you have a large number of crypto assets, you should store them with a custodial service. Custodial services protect your token holdings using high-security systems.
Custodial services have different techniques for storing crypto assets. The techniques vary according to factors such as the liquidity level you want to maintain or the security you would like. If you own large numbers of token assets as an investment, you should choose a custodial service as if you were selecting any investment service. Consider your needs, the firm’s reputation, fees, and so forth.
The Stacks Wallet is not recommended for institutional holdings. Blockstack suggests a firm such as Coinbase Custody for institutional holders. Coinbase Custody charges its clients a management fee based on assets. Of course, like any responsible asset holder, you should do your own research and select a service that meets your needs. The Investopedia's article What Are Cryptocurrency Custody Solutions? is one place to start.
Resetting the Stacks Wallet clears all your data from the Stacks Wallet on your desktop computers and returns the wallet to its original state.
- If you previously entered a Stacks address or its associated 24-word seed phrase, resetting clears the address from the Stacks Wallet.
- If you previously connected to a hardware wallet, resetting removes the connection to the hardware wallet.
Resetting the wallet does nothing to addresses or their associated balances. They are maintained on the Stacks blockchain.
- Click the settings icon in the upper-right corner of the wallet. The system opens the “Settings” dialog.
- Select “Reset Wallet”. Confirm the reset or choose to cancel by selecting “Close”.
- Select “Are you sure?” to complete the reset. The wallet displays the “Terms of Use”. You can accept to enter the wallet again or simply choose “Quit”.
If you used the original v1.x of the wallet, you should begin using the Stacks Wallet v3.x or greater with the same 24-word seed phrase from that wallet.
The v2.x version of the wallet required a hardware wallet to send and receive STX. You can connect this same hardware wallet to the v3.x version of the Stacks Wallet software. Choose “Use existing wallet” upon opening Stacks Wallet v3.x. You don't need to create a new wallet.
Sending stacks is a transaction you must authorize or sign. If you have connected your Stacks Wallet to a hardware wallet. The Stacks Wallet software uses the hardware wallet to sign your send transactions. A software-only wallet asks you for the 24-word key phase you used to create the wallet.
- Open the Stacks Wallet. If you are starting after a reset, choose "Use a Hardware Wallet".
- Connect your hardware wallet to your computer.
- Select "Send". The system displays the "Send" dialog.
- Complete the dialog with the transaction information.
- Select "Continue". If you do not have enough Bitcoin to fuel the transaction, the system notifies you. If you don't have enough Bitcoin, you must "Top Up". Otherwise, the system prompts you to connect to your hardware wallet. Your hardware wallet will prompt you for additional information and actions.
- Select "Continue". The Stacks Wallet displays a confirmation dialog.
- Select "Confirm" to complete your transaction.
- Select "Close". The send transaction appears in your "Transaction History". Blockchain transactions can take minutes or hours to complete. Select "Refresh" if you don't immediately see the transaction in your history.
To receive Stacks, give a STX address directly to a user via email or text, for example.
- Click the Receive button to display the wallet address to which others can send STX.
- Email or text the address to the person or organization sending to you. A Stacks address is a public addresses. Anyone with the address, can view the address balance or send money to the address.
- Look for the receipt transaction in your transaction history. Once the person has sent you STX, you see a PENDING transaction which means the transaction is still being recorded by the blockchain.
- Blockchain transactions take time. It may be minutes or hours before the transaction is recorded in the blockchain. When the transaction is complete, you can see a receipt for the transaction in your Stacks Wallet. The PENDING marker goes away once the funds are recorded on the blockchain.
When you start the Stacks Wallet it prompts you to create a new or choose an existing wallet. You should create a new wallet if you have not previously connected a hardware device to the Stacks Wallet v3 software or if you do not have an existing 24 word seed phrase.
Use with a hardware wallet
Initialize and configure your wallet according to the manufacturer's instructions before you use it with the Stacks Wallet software. Some hardware wallets require that you have additional software installed to support the hardware wallets interactions with the Stacks Wallet.
- Trezor One with Trezor Bridge
- Ledger Nano S
- Ledger Blue
Make sure you have installed any prerequisite software. It is a good idea to connect your hardware wallet to your computer before starting the Stacks Wallet software, but it is not required.
When your hardware device is ready, do the following:
- Connect your hardware wallet to your computer as you normally would.
- Double-click on the wallet software to open it.
- Select Create new wallet or Use existing wallet.
If you connected your hardware device to an old version of the Stacks Wallet software, you choose Create new wallet. After you make this initial connection, the next time you start the wallet, you can choose Use existing wallet.
The system asks if you have a hardware wallet. Choose Yes, I do. The system prompts you to select a hardware wallet. - Select the hardware wallet you want to use. This example uses a Trezor wallet.
- The system prompts you to connect your device.
- Connect your wallet to your computer and choose Continue. The system prompts you to export a public key.
- Select Export. The Stacks Wallet shows the current wallet balance.
Software-only wallet
If you have an existing 24 word seed phrase from this or a previous version of the Stacks Wallet software, you don't need to create a new wallet, you can Use existing wallet. This procedure assumes you are creating a wallet for the first time.
- Double-click on the wallet software to open it.
- Select Create new wallet. The system asks if you have a hardware wallet.
- Choose No, I don't. The system prompts cautions you that a hardware wallet is recommended.
- Choose Continue without a hardware wallet. The system generates a seed phrase for you and prompts you to write it down. Don't lose your seed phrase. If you lose your seed phrase, you lose your STX tokens and can never get them back.
- Write down each word in the displayed order.
- Store your written seed phrase in a secure location such as a safe deposit box.
- Click I've written down my seed phrase.
- Select Done. The system displays the balance for the address that corresponds to your seed phrase.
Reset the wallet
A “reset” function under the “Settings” menu is always available regardless of whether you are using a hardware wallet or a software-only. Resetting returns the wallet to its original state. It does not change your STX balance, your Stacks addresses, or any connected hardware wallet in any way.
Troubleshooting
Having problems with your Ledger or Trezor device? See more details at Which hardware wallets are supported by the Stacks Wallet v3.x?.
For macOS:
- Go to the wallet download page in your browser.
- Select the macOS Download button. This button downloads the software to your computer.
- To verify the authenticity of the downloaded package before installation, open a terminal window. To find the terminal software, enter terminal into the Spotlight search.
- In the terminal window, enter the command to change directory to the folder where you downloaded the wallet software. The default location is the Downloads folder, type the following into the terminal and press RETURN on your keyboard:
cd ~/Downloads
- In the terminal window, type the following command to verify the authenticity of the downloaded file Stacks-"Wallet-macOS-3.1.0-en-US.dmg":
shasum -a 512 Stacks-Wallet-macOS-3.1.0-en-US.dmgshasum -a 512 Stacks-Wallet-macOS-3.1.0-en-US.dmg - Verify that the resulting hash (a string of letters and numbers) is the same as the hash published on the Stacks Wallet's Github repository.
- To proceed with installation, open the downloaded file and complete the setup.
For Windows:
- Select the Windows Download button on this page. This button downloads the software to your computer.
- To verify the authenticity of the downloaded package before installation, open a command prompt. To find the command prompt software, enter command into the Start menu.
- In the command prompt window, enter the command to change directory to the folder where you downloaded the wallet software. The default location is the Downloads folder, type the following at the command prompt and press RETURN on your keyboard: "cd <You-User-Directory>/Downloads"
- In the command prompt window, type the following command to verify the authenticity of the downloaded file Stacks-Wallet-win10-3.1.0-en-US.dmg:
certUtil -hashfile Stacks-Wallet-win10-3.0.0.exe SHA512certUtil -hashfile Stacks-Wallet-win10-3.0.0.exe SHA512 - Verify that the resulting hash (a string of letters and numbers) is the same as the hash published on the Stacks Wallet's Github repository.
Follow these instructions to install the Stacks Wallet v4.x:
- Download for MacOS, Windows or Linux
- Double click the download and drag the "Stacks Wallet" icon into your "Applications" folder.
- Double click the "Stacks Wallet" application to open
- Select "Create a new wallet" if you haven't used the Stacks Wallet before.
If you have a Ledger S device, ensure that it's connected and unlocked with your PIN. Ensure that the "Stacks" application is installed on your Ledger device using the "Ledger instructions" below. Then proceed to select "Use a Ledger wallet".
If you do not have a Ledger device, select "Create a software wallet". - If you've selected "Create a software wallet", follow the instructions provided to generate and save a 24-word Secret Key.
Ledger instructions:
The Stacks app for Ledger devices has been submitted for review and listing in Ledger Live. In the meantime, you’ll need to build and install it from source for use with the Stacks Wallet v4.x:
- Ensure that version 3.x of Python is installed on your device.
- Download zxtools.sh from the Ledger Blockstack releases page
- Run chmod +x ./zxtool.sh
- Plug in your Ledger device
- Run ./zxtool.sh load
- After some short setup, you’ll be prompted to install the Ledger app on your Ledger device.
You’re now ready to use the Stacks Wallet with this Ledger device.
Note that manual installs from source work only with Ledger S devices specifically. Users of Ledger X devices will need to wait for official listing in Ledger Live.
The Stacks Wallet is a cryptocurrency wallet for managing your STX tokens.
Generally speaking, cryptocurrency wallets enable the sending and receiving of cryptocurrency quantities. Unlike physical wallets for carrying cash, cryptocurrency wallets don’t contain tokens directly inside of them; they merely provide a mechanism for managing them on a blockchain using credentials.
The Stacks Wallet specifically empowers you to manage your STX tokens on the Stacks blockchain, as those tokens are associated with a single publicly-known Stacks address and a single privately-held “Secret Key” (otherwise known as a “seed” or “mnemonic” phrase), which serves as your sole credential.
Your Stacks address is akin to a bank account number, in that it’s known and shared publicly so others can send STX tokens to you.
Conversely, your Secret Key is akin to a password, in that it should be kept completely private and used only to authenticate with trusted software like the Stacks Wallet so you can send STX to others and otherwise manage your own holdings. However, unlike a traditional password, no one can ever reset your Secret Key should it get lost. It’s absolutely vital that you secure your Secret Key since its lost will entail the lost of all associated STX tokens irreparably.
The Secret Key consists of 24 words separated by spaces. The words, spaces and their positions in the sequence are all critically important. Be sure to record them exactly as presented by the Stacks Wallet.
When sending STX from the Stacks Wallet, the software digitally signs a token transfer from your address to another then broadcasts it to the Stacks network. After the network has received and validated this transaction, tokens will be moved from your address to the specified destination address. The transaction will be permanently and irreversibly recorded on the Stacks blockchain.
Using the Stacks Wallet, you can:
- Generate a new STX address with associated Secret Key
- Send STX from your STX address
- Receive STX to your STX address
- View the balance for your address and associated details
- Review the transaction history associated with your address
In version 3.x, you can additionally:
- Pay for fees associated with sending STX in BTC
- Deposit and withdraw BTC to and from the wallet's “fuel” address for paying these fees
- Optionally authenticate with a Ledger or Trezor hardware device
In version 4.x:
- Pay for fees associated with sending STX in STX
- Participate in Stacking for the chance to earn BTC as paid out to a separate BTC wallet
- Optionally authenticate with a Ledger hardware device
Use the Stacks Wallet with a hardware wallet device raises the level of security by keeping your Secret Key away from your desktop computer at all times during initial authentication and transaction signing.
No. STX holdings that have yet to unlock as part of a purchase-based unlocking schedule cannot be used for Stacking until they unlock.
Consult the Stacking Earnings Model for an estimation of how much you could potentially earn in BTC from participating in Stacking.
The estimator provides only estimates and is provided exclusively for illustrative purposes. Actual results may vary significantly and depend on a large number of unpredictable factors, such as the price of STX, the price of BTC, transaction fees, the number of miners, the number of Stacking participants, and many other factors. You should not rely on the estimator for any financial decisions.
Users can always revoke their delegation of Stacking to another address by calling a smart contract that has implemented #revoke-delegate-stx.
They can choose to delegate Stacking with an optional future burn height, upon which delegation will get revoked automatically. See #delegate-stx.
We expect the amount to be around 100,000 STX upon the release of mainnet.
The value will fluctuate based on both the total supply of STX and the total amount of current participation. It will be reported by Stacks blockchain nodes at path /v2/pox with the min_amount_ustx property and denominated in microstacks (μstx).
There are two major versions of the Stacks Wallet available for installation on desktop computers:
- v3.x: Current production-ready version compatible with the Stacks 1.0 mainnet. Users can send and receive STX while paying fees in BTC.
- v4.x: New version under development compatible with only the Stacks 2.0 Testnet. Users can send and receive testnet STX while paying fees in testnet STX. They can also participate in Stacking with testnet STX.
Version v3.x will cease to work once Stacks 2.0 reaches mainnet. All users will need to install v4.x or greater at that point to manage STX in production.
In the meantime, users are encouraged to use v3.x to manage their STX holdings and v4.x to test against the Stacks 2.0 Testnet using separate hardware wallet devices as applicable.
We encourage all users on previous versions to upgrade to v3.x and use their same 24-word mnemonic seed or hardware device for authentication.
Stacking is an innovative mechanism that rewards STX token holders for participating in the Stacks blockchain’s consensus process, called Proof of Transfer (PoX).
STX holders who participate in Stacking are called Stackers. Every time a new block is mined on the Stacks blockchain, the protocol sends BTC committed by miners to Stackers as a reward for adding value to the network. All eligible Stackers are rewarded with BTC approximately once per Stacking cycle (e.g. 7 days, though the exact duration is prone to change).
The Stacks Earning Model can be used to estimate potential BTC rewards from participating in Stacking.
Stacks holders can participate in Stacking with v4.x or greater of the Stacks Wallet, as well as applications and services provided by other entities.
Stacks holders need a dynamic minimum amount of STX to participate directly (an estimated 100,000k STX upon mainnet, though this amount is prone to fluctuate based on overall participation and supply). Those who don’t possess that minimum can participate in third-party Stacking delegation services, which allow them to pool their holdings with others for joint participation.
More details on Proof of Transfer, STX mining, and Stacking are available in this blog post and this draft whitepaper.
The Stacks Wallet unfortunately no longer supports authentication and transaction signing with Trezor devices. This is due to how Trezor supports integrations, in which the company's availability and engagement is required to set them up in contrast to Ledger's open model.
If you've used a Trezor device with a previous version of the wallet, you have two options going forward:
- Purchase a Ledger device and load the 12- or 24-word recovery phrase you saved when originally setting up our Trezor device into your Ledger device. See "Restore from recovery phrase" from Ledger.
- Enter the 12- or 24-word recovery phrase you saved when originally setting up our Trezor device directly into the wallet upon selecting "Sign In" and viewing a prompt for your "Secret Key".
Warning: We highly advise that you continue using the Stacks Wallet with a hardware device, even if you can no longer use your Trezor device, to ensure the same level of security to which you're accustomed. As such, option #1 above is recommended over option #2 despite the extra cost and time required.
We hope to support Trezor again some day soon, but there is currently no timing expectation available. We will update the community if and when this work gets underway.
The Hiro PBC team is aware of the following issues affecting Stacks Wallet performance and is actively working to resolve them.
Please ensure that you've downloaded the latest version of the Stacks Wallet since other bugs and issues are known to affect older versions.
- Users attempting to withdraw STX holdings from exchanges (e.g. OKCoin, Binance, KuCoin) have reported transactions as labeled "invalid" or "pending" perpetually.
These issues appear related to fixes needed on the exchange's side in regards to Stacks 2.0 integration. They are not related to the Stacks Wallet software specifically, and unfortunately there is nothing Hiro PBC can do to resolve them aside from general advisory support.
Please contact your relevant exchange for help if you are unable to withdraw successfully. - Ledger Nano X users have been unable to send STX. However, a fix is now provided by the latest version of the Stacks app listed on Ledger Live. Please upgrade within Ledger Live if you've encountered this problem.
If you've previously set your "Manager provider" to 4 under "Experimental features" in Ledger Live's settings, you'll need to toggle it off or otherwise set to 1 before this version appears for installation. - Ledger Nano X users sometimes find that their devices crash after displaying "Pending Ledger review" on the screen. View GitHub issue.
- Users are unable to send multiple transactions for inclusion in the same block on the Stacks blockchain. View GitHub issue.
See all GitHub issues for the Stacks Wallet that track other known areas of improvement, or file your own.
Join the #support channel on Discord and post a message describing your issue if you need personal assistance.
Secret Keys are 12- or 24-word phrases that authenticate you to products built with the Stacks blockchain such as the Stacks Wallet.
They are otherwise known as "seed phrases" or "mnemonic seed phrases".
The desktop Stacks Wallet has always generated 24-word Secret Keys for new users, whereas other products such as the Blockstack Browser and web-based Stacks Wallet have generated 12-word Secret Keys for new users.
Generally speaking, if you purchased STX before 2021, your STX holdings are almost certainly associated with a 24-word Secret Key. If you have a 12-word Secret Key, you most likely generated it when trying separately to use apps built with Stacks (or Blockstack) in a web browser. Please ensure that you are entering the 24-word Secret Key into the desktop Stacks Wallet to view and manage your balance.
Secret Keys are like strong passwords in that they protect your identity and STX holdings. However, unlike passwords, they can never be recovered – by you or anyone else – if lost. So be sure to always back up a copy in a very secure place that you remember! See our instructions for securing Secret Keys.
You can use 12- or 24-word Secret Keys across both the desktop and web versions of the Stacks Wallet. However, we generally recommend that you generate and use a separate Secret Key for entry in the web browser since it's a less secure environment than desktop software.
Always double check that you trust any downloaded software or website that prompts you for your Secret Key before proceeding to enter it!
It's common for cryptocurrency users to suffer phishing attacks that fool them into providing their Secret Keys to malicious actors. Once your Secret Key is stolen by "bad" websites or software, there are no guarantees that you will get your associated STX or other digital assets back. And you will surely have to generate a new Secret Key for future usage since the original one will have been compromised forever.
Follow these instructions if you've already locked STX for Stacking in the Stacks Wallet but wish to increase the amount of STX locked for improved chances to receive BTC rewards.
Note: These instructions require you set up STX holdings across two separate Ledger devices or software wallets. Please proceed only if you feel comfortable dealing with multiple devices or Secret Keys. We highly recommend you do so with two Ledger devices and not two software wallets, for security purposes.
- Ensure that you've secured the Ledger device or Secret Key for your existing wallet, as well as possess the BTC address you've already used to initiate Stacking.
- Go to "Settings" in the Stacks Wallet and select "Reset wallet".
- Accept the "Terms of Service".
- Choose "Create a new wallet" and proceed with either your second Ledger device or new software wallet, securing your new recovery phrase or Secret Key in the process.
- Choose "Receive" once you've finished setup and copy the address displayed for your new wallet somewhere for easy access outside the Stacks Wallet (e.g. notes).
- Go to "Settings" in the Stacks Wallet and select "Reset wallet".
- Accept the "Terms of Service".
- Choose "I already have a wallet" and proceed with your first Ledger device or existing software wallet.
- Choose "Send", paste the address for your new wallet, and enter the additional amount of STX you'd like to lock for Stacking plus 0.0002 STX to cover fees.
- Confirm the transaction with your Ledger device or password.
- Go to "Settings" in the Stacks Wallet and select "Reset wallet".
- Accept the "Terms of Service".
- Choose "I already have a wallet" and proceed with your second Ledger device or new software wallet.
- Wait for the incoming transfer to confirm.
- Select "Get started" on the right-hand side to view the Stacking form.
- Enter the additional amount of STX you'd like to lock for Stacking, the same or greater number of cycles as you previously set for Stacking, and the same BTC address you previously used to initiate Stacking.
- Submit the Stacking form and confirm with your Ledger device or password.
You will now participate in Stacking with the total STX locked by both of your wallets for any given cycle in which they are both still locked.
Alternatively, you can simply wait until your STX unlock for your single wallet after the total number of cycles in which they've been locked transpire. You'll then be able to reinitiate Stacking with a new total using the single wallet instead of creating a new one for adding STX before those cycles transpire.