Freewallet.io User Manual
Freewallet.io User Manual
  • Getting Started
    • What is Freewallet?
    • What are the features of Freewallet?
    • Where can I access Freewallet?
    • Where can I access previous versions of Freewallet?
    • What is Tokenscan.io?
    • Why do I need small amounts of Bitcoin to do things in Freewallet?
    • What BTC fee should I use?
    • What is the Automatic Donation System? How do I turn it off?
    • What is an Asset/Token/NFT? How can I store them?
    • I want to trade a certain Asset, is it legitimate?
    • How to find the License Agreement
    • What else do I need to know?
  • Exploring Balances, History, Exchange and Dispensers
    • Address Balances
    • Address History
    • Viewing Tokens
    • Exploring Token Information and Enhanced Asset Information
    • Understanding Dispenser Markets
    • Buying XCP and User Created Tokens from a Dispenser
    • The Decentralized Counterparty Exchange (DEx)
    • Understanding Exchange Pairs
    • Buying and Selling XCP and Tokens on the DEx
    • Understanding BTCpay and BTC/TOKEN on the DEx
  • Freewallet Functions
    • Creating a Wallet
    • Locking and Unlocking Your Freewallet
    • Viewing, Creating and Importing Addresses
    • Show a QR Code for your Address
    • Sending and Receiving BTC
    • Sending / Receiving XCP and User Created Tokens
    • Displaying the Seed Phrase and Private Key of your Address(s)
    • Using the Multi Send function
    • Create a Counterparty Token (NFTs and FTs)
    • How to Change Token Properties
    • Changing the Token Description
    • Issuing more Token Units
    • Resetting Your Token Issuance
    • Locking Your Token Issuance
    • Transfer Token Ownership
    • Destroying Tokens
    • Paying Dividends to Token Holders
    • Voting with Tokens
    • Broadcast information on the Bitcoin blockchain
    • Signing a Message Using Freewallet
    • Signing a Transaction Using Freewallet
    • Using the Sweep Function
    • Setting up a Dispenser
    • Closing a Dispenser
    • Cancelling Exchange Orders
    • Starting an Exchange Pair that has no orders up yet on the DEx
    • Minting Open Fairmints
  • Common Questions Using Freewallet (FAQ)
    • What if you make a mistake?
    • Where can I see my current version?
    • How do I check my Freewallet Server settings?
    • How do I use the Debug function on Freewallet?
    • Can I use the Counterparty/Bitcoin Testnet in Freewallet?
    • Can I burn BTC for XCP?
    • What’s a Stamp?
    • What’s an Ordinal?
    • If Tokenscan is down for maintenance, can I still access my funds?
    • Why is there more than one input on my BTC transactions?
    • Does Freewallet support two-factor authentication?
    • Can you lock a Token description?
    • Can I run my own Counterparty server?
    • How do I use Freewallet to mint an Emblem Curated Vault?
    • How do you create a Burn Address for use on Counterparty?
  • Troubleshooting / Issues
    • I sent BTC (or a Token) to Freewallet, why doesn't it show up?
    • Why can't I see my assets I own or created with 0 issuance?
    • "Error While Trying to Broadcast Transaction"
    • "Failure to send not enough BTC in wallet"
    • My Freewallet Exchange/Dispenser tab is resetting the data when I try to sort by BTC Price?
    • "Public key was neither provided nor published in blockchain."
    • I logged in and see none of my assets but I see them on tokenscan!
    • Help! I used too small of a fee and my transaction is not confirming!
    • I sent/dispensed an XCP asset to a Wrapped Segwit Address (address beginning with "3")
    • I sent/dispensed an XCP asset to a Taproot Address (an address that starts with "bc1p")
    • I updated Freewallet and can only see my first 20 addresses! How can I get them back?
    • My second transaction on an MPMA (Multi-send) is not getting confirmed and giving me an error
    • Freewallet gave me a TX link but Tokenscan says "Transaction not found on tokenscan"
    • Error composing dividend transaction via API: ['zero dividend']
    • My MacOS/Windows is saying Freewallet is not verified by the app store. What should I do?
    • Counterparty API Communication Error!
    • What is a Counterparty API Error?
    • Stuck on "Checking Data Encoding Fees"
    • Constructed transaction does not parse correctly
    • My transaction is too low of an "Effective Fee Rate"
    • Error Composing Dispenser TX - Balance History
    • I entered my created password and stuck on "You will need to unlock..."
  • Getting Support
Powered by GitBook
On this page
  1. Freewallet Functions

Viewing, Creating and Importing Addresses

PreviousLocking and Unlocking Your FreewalletNextShow a QR Code for your Address

Last updated 11 months ago

Please take note: A bitcoin seed can generate billions of addresses in theory, but Freewallet will only import the first 20 upon seed recovery. Any new addresses (not a part of the original 20) that were created in Freewallet will not automatically load in from the passphrase alone if you log out of Freewallet or lose your device. To recover any additional addresses you created beyond the original 20, simply add them again and they will appear again in the Change Address list. The process for doing this is explained below in this section. Each individual address has its own private key, for any IMPORTED addresses (not created within this deterministic Freewallet seed-phrase combination) you are responsible to write down and maintain the private key of each address if you imported any specific addresses. Any imported address info will be LOST if you log-out or lose your device. Learn more about how to view private keys for each address you own or create at .

Freewallet starts you off with a "Address #1" Legacy Bitcoin address, but will automatically generate 10 Legacy BTC addresses and 10 Segwit addresses upon wallet creation or import.

Freewallet starts you off on Legacy BTC Address #1. Which you can view by clicking the Address icon in the top right

You can view the rest of the 19 addresses generated by clicking the Address icon on the top right of Freewallet and choosing “Change Address.” Your first 20 addresses are labeled up to #10 for legacy BTC addresses and up to #10 for your Segwit Addresses

When you change your address (by simply double clicking on the address you desire to change to), it will now show you the contents of this address in the Balances tab and on your main screen. If it doesn't at first load up the balances when you change your address, use the refresh button using the gear icon in the upper left, or in the "History" tab in the upper left. This will refresh the data with the new data when you changed account

To add a new address, click the Address Actions tab in the upper right of Freewallet:

Then by clicking the Add New Address button, a pop-up will appear:

Freewallet supports the creation or import of several different kinds of addresses:

  • Regular Address - P2PKH (Normal or Legacy) - begins with 1

  • Segwit Address* - Bech32 (Segwit) - begins with bc1q

  • Taproot Address* - Segwit (also called Ordinals address) - begins with bc1p

  • Watch Only Address - any address type (no functions are able to be used)

  • Hardware Wallet Address - Trezor, Ledger and KeepKey supported

*Note that the private key of your default 'Address #1' noted above as a "Regular address" is also the private key for your 'Segwit Address #1' with the only change being that your segwit address has the prefix "p2wpkh:" before the private key.

*It is NOT recommended at this time to store any Ordinal inscriptions or Runes on a Freewallet Taproot address as it may result in a loss of the specific UTXO's (that hold Ordinals or Runes) when sending Bitcoin from this address

From this popup, you can create any type of address you would like to use as well as the number of addresses you would like to add at this time.

If you already have a private key for an address and you would like to import it into Freewallet for use with Counterparty functions, first navigate to the top right Address Actions icon and click Import Private Keys

Addresses (of any of the supported types) can be imported here and multiple addresses can also be imported at one time. Just make sure to input one private key per line when importing as shown in the Import Private Key popup window:

When any new addresses are added (created or imported) they will now appear on the "Change Address" menu and are able to double click the new address to access it.

With the address currently selected as described above you can also Label your address by clicking the “Settings” icon and navigating to “Wallet” and changed the wallet label under the “Label” entry. This is entirely private, within Freewallet only, and is not shown on the blockchain. It will also be reset when logging out of this seed-phrase.

Another aspect to be aware of is that the private keys for your Segwit Address #1 is simply the private key for your Legacy Address #1 but with the prefix "p2wpkh:" before it.

P2SH Segwit Addresses (addresses that start with a "3") are

As for the process of adding a hardware wallet address, it is the same process as described above, but you would select "Add Hardware Address". The current hardware address types supported are: , and

The process for linking a Trezor wallet has been explained in further detail by Subterranean in .

This is simply how Segwit private keys work, is very useful to know and is explained in more depth in the section.

not supported by Freewallet at this time
Trezor
Ledger
KeepKey
a very descriptive Medium article here
Displaying the Seed Phrase and Private Key of your Address(s)
Displaying the Seed Phrase and Private key for your Address(s)
Add New Address pop-up
Add New Address popup with Address Type's shown
Import Private Keys pop-up window
Right-clicking any address when viewing the Change Wallet Address menu, shows you a couple of options
Address specific Label shown with Blue Oval - which is in "Settings" under the "Wallet" tab
Screenshot import process from the Subterranean Medium article for imported Hardware wallets