Happy to announce the Freewallet User Manual thanks to the hard work by Counterparty community member @davesta_xcp!



All encryption is handled client-side. Neither your passphrase nor any of your private information ever leaves your browser, workstation, or mobile device.

FreeWallet passphrases are highly secure, and protect your wallet from any brute force attacks. They are also rather easy to learn and hard to mistype.


With FreeWallet, your passphrase is literally your wallet, and all of your addresses and keys are generated on-the-fly when you log in.

There are no wallet files to backup or secure, and using your passphrase you can access your wallet from any trusted machine with a web browser.

Open Source

FreeWallet Mobile is open-source, and available for anyone to fork or review, so you know that it works exactly the way that it is supposed to.

FreeWallet Desktop is also open-source, and available for anyone to fork or review.


Send Bitcoin, XCP, or any other counterparty token/asset to any bitcoin address.


Receive Bitcoin, XCP, or any other counterparty token via a scannable QR Code.

Issue Tokens

Quickly and easily create your own tokens to use for whatever you would like.


Sign a transaction with any address in your wallet, or sign a message that others can verify.


Broadcast any message to the bitcoin blockchain for anyone to see.

Multiple Addresses

Supports multiple addresses as well as segwit, importing private keys, and watch-only addresses.

Mainnet & Testnet Supported

Support for Bitcoin Core (BTC) transactions on both Mainnet and Testnet.

Password Protected

Add an Password, PIN or thumbprint scan to give your wallet an additional layer of security.

QR Code Authorization

Support for QR Code Authorization which allows anyone to register/login to a site using only their bitcoin address.

Decentralized Exchange

Integrated exchange interface that allows peer-to-peer trading of counterparty tokens in a truly decentralized and trustless manner.

Decentralized Betting*

Integrated betting interface that allows anyone to operate a oracle, browse a listing of available feeds, and place bets on feeds.

Dividends / Distributions

Distribute an token of your choosing to holders of any other counterparty token.


Easily setup dispensers or vending machines to sell your tokens directly for Bitcoin (BTC).

MPMA Sends

Multi-Peer-Multi-Asset (MPMA) Sends allow sending of many tokens to many addresses in a single transaction.

Dispenser Watchlists

Setup dispenser watchlists to ensure your getting the best price on your dispenser purchases.

* = In development


FreeWallet Mobile

FreeWallet Desktop


FreeWallet Mobile

Version 0.1.9 - March 15, 2019
  • FIXED - Removed defunct blocktrail.com API calls
  • FIXED - Removed defunct counterpartychain.io API calls
  • FIXED - Setup all API calls with multiple failovers
  • FIXED - Native QR Code Scanning
  • UPDATE - Updated all plugin versions
  • NEW - Added ability to lock token
  • NEW - Added ability to view private keys
Version 0.1.8 - July 07, 2017
  • NEW - Added support for importing private keys
Version 0.1.7 - June 14, 2017
  • NEW - Added support for subassets
  • NEW - Added support for pending transactions
  • NEW - Added ability to copy address from transaction history
  • NEW - Manually adjustable miners fee
  • NEW - Setup failovers for API calls on balance/address/history/broadcast
  • UPDATE - Start using XChain.io API instead of counterpartychain.io API
  • UPDATE - Start broadcasting transactions via XChain.io send_tx API
Version 0.1.5 - December 15, 2016
  • FIXED - Issue with url handling
  • FIXED - Issue with spinner fields being read-only on android
Version 0.1.4 - November 26, 2016
  • NEW - Cache currency price/conversion info locally
  • NEW - Added QR Code Authorization support
  • FIXED - Improved QR Code scanning support
  • FIXED - Misc issues with amount/price fields
Version 0.1.3 - November 5, 2016
  • NEW - Inital App Store release (iOS)
  • NEW - Inital Play Store release (Android)
  • REMOVED - iOS Updates to hide all but BTC balances for new wallets
Version 0.1.2 - October 25, 2016
  • REMOVED - iOS updates to prevent sending XCP
Version 0.1.1 - September 19, 2016
  • NEW - Added USD Support to Balances, Send, and Receive screens
  • NEW - Added Content-Security-Policy
  • FIXED - Issue with Sencha Touch app cache not updating properly
  • FIXED - Issue with scrollbars on IOS
  • FIXED - Issue with camera scanning on IOS 10
Version 0.1.1 - September 1, 2016
  • NEW - Initial release for iOS and Android

FreeWallet Desktop

Version 0.9.31 - Apr 15th, 2024
  • UPDATE Set default CP API servers to public.xchain.io
  • NEW Added ‘Reset to Defaults’ option in server settings
  • FIXED Built with nwjs-0.84.0-sdk (fixes MacOS hanging issues)
Version 0.9.30 - Apr 11th, 2024
  • UPDATE Start using SSL by default for CP API
Version 0.9.29 - Feb 29th, 2024
  • FIXED Fixed issue with ADS and tx fee calculations
  • NEW Added "UTXO Usage" preference in settings
Version 0.9.28 - Feb 15th, 2024
  • UPDATE Improved transaction fee interface
  • UPDATE Improved MPMA send transaction fee support
  • UPDATE Adjusted default tx size to 256 bytes
Version 0.9.27 - Feb 8th, 2024
  • UPDATE Better transaction fee estimation support
Version 0.9.26 - Nov 30th, 2023
  • NEW Added support for new issuance IDs (22/23)
  • NEW Added checks to verify wallet is unlocked before allowing add/import addresses
  • UPDATE Update to pass `null` for description in asset issuance transfers
  • UPDATE Update to start using `lock` flag in issuances instead of `LOCK` text
Version 0.9.25 - Sep 22nd, 2023
  • FIXED Fixed issue with missing first address
  • FIXED Fixed issue with wallet auto-locking
Version 0.9.24 - Sep 19th, 2023
  • FIXED Fixed issues with sweep form
  • FIXED Fixed issue with fee not being properly passed on issuances
  • NEW Added support for pooling ADS donations
  • NEW Added support for reviewing license agreement
  • NEW Started passing forward `advanced` params in CP API requests
  • NEW Added Betting tab back with build bounty
  • NEW Added support for adding up to 100 new addresses at once
  • NEW Added support for importing many private keys at once
  • NEW Added support for auto-lock feature
  • NEW Added support for decoding XCP transactions in sign transactions
Version 0.9.23 - May 4th, 2023
  • NEW Added support for editing DUST preferences
  • NEW Added support for CIP25 (Viewing NFTs and Stamps)
  • NEW Added issuance data encoding cost notification
  • NEW Added Automatic Donation System (ADS)
  • NEW Added balance list view options menu
  • UPDATE Increase max asset description length to 10k characters
  • UPDATE Added lazy loading of asset list images
  • FIXED Fixed security issue with autocomplete
  • FIXED Fixed Trezor Support
  • FIXED Fixed issues with BTC/XCP asset divisibility not being set
  • FIXED Fixed satoshi rounding issues by using `getSatoshis()`
Version 0.9.22 - September 9th, 2022
  • FIXED - Issue with `reset supply` form always passing divisible as true
Version 0.9.21 - September 2nd, 2022
  • UPDATE - Changed default token type to non-divisible
  • UPDATE - Updated MPMA data encoding fee calculations
  • FIXED - updated `checkWalletUpgrade()` to use `ajax()`
  • FIXED - Got basic Trezor integration working again
  • NEW - Updates to support CIP03 Token Resets
  • NEW - Updates to support CIP24 Oracled Dispensers
  • NEW - Added 'Close Dispenser' main menu item
Version 0.9.20 - May 26th, 2022
  • UPDATE - Update to only pull list of open dispensers for watchlists
  • UPDATE - Increased asset description length to 200 characters
  • UPDATE - Added additional MPMA Send list validations
  • UPDATE - Added better API error handling
  • UPDATE - Start passing pubkey on all `create_send` requests
  • FIXED- Fixed issue with asterisks in asset descriptions
  • FIXED- Fixed issue with wallet addresses persisting after wallet reset
  • FIXED- Fixed MAX button to subtract miners fee from max amount
  • FIXED- Fixed issue with mpma amounts being rounded at times
  • NEW - Support for collapsible subassets
  • NEW - Support for importing bech32 addresses
Version 0.9.19 - September 7th, 2021
  • UPDATE - Adjust minimum tx fee code to allow lower minimums
  • UPDATE - Limit dispenser watchlists to 10
  • UPDATE - Limit exchange market list to 10
  • UPDATE - Allow default market and exchange tabs to be removed
  • UPDATE - Dispenser updates to add more protection
  • FIXED- Fixed issue with removing assets from dispenser watchlist
  • FIXED- Ignore tabs when changing amount values
  • NEW - Hide passphrase by default on entry
  • NEW - BTC Name Service and asset support in sends
  • NEW - Added 'Copy' button to view address page
Version 0.9.18 - April 17, 2021
  • NEW - Added warning about setting up dispensers on used addresses
Version 0.9.17 - March 29, 2021
  • NEW - Allow segwit addresses to export private keys
  • UPDATE - Disabled MPMA sends from segwit addresses to prevent loss of BTC
Version 0.9.16 - March 16, 2021
  • NEW - Added support for opening dispensers on empty addresses
  • NEW - Added multiple dispensers on same address warning
  • UPDATE - 'Buy FULLACCESS' button now links direct to official dispenser
  • UPDATE - Stopped forcing quantity to multiple of what dispensers is offering
Version 0.9.15 - March 14, 2021
  • NEW - Added support for editing minimum transaction fee
  • UPDATE - Started enforcing minimum fee on transactions
  • UPDATE - Adjusted MPMA send settings and minimum fee
Version 0.9.14 - March 11, 2021
  • FIXED - Issue with MPMA sends not working properly at times
Version 0.9.13 - March 10, 2021
  • NEW - Started using api.counterparty.io API
  • FIXED - Issue with sends using text memos
Version 0.9.12 - January 15, 2021
  • NEW - Added support for destroy transactions
  • NEW - Added support for displaying transaction status
  • NEW - Added support for decoding hex memos
  • NEW - Added "Cancel Order" option to main menu
  • NEW - Bumped minimum BTC order amount to 0.00001
  • FIXED - Issue with MPMA tx fee not being passed to API
  • FIXED - Issue with context menus appearing in wrong locations
  • FIXED - Issue with asset description changing on issuing supply
Version 0.9.11 - March 1, 2020
  • NEW - Added BIP39 passphrase support
  • FIXED - Fixed send amount formatting issue
Version 0.9.10 - February 25, 2020
  • NEW - Changed licensing to MIT
  • NEW - Added support for segwit addresses
  • NEW - Added support for burns
  • NEW - Added support for sweeps
  • NEW - Added support for dispensers
  • NEW - Added support for destroys
  • NEW - Added support for multi-peer-multi-assets sends (MPMA)
  • NEW - Added donation annoyware
  • NEW - Opened Exchange interface to everyone
  • NEW - Added Dispensers watchlist interface
Version 0.9.9 - February 20, 2019
  • FIXED - Removed defunct blocktrail.com API calls (more info)
  • FIXED - Setup all API calls with multiple failovers
  • FIXED - Updated bounty amounts to adjust for XCP value drop in last year
  • NEW - Added ability to buy XCHAINPEPE and FULLACCESS tokens from DEX
  • NEW - Added “API Keys” section to settings
Version 0.9.8 - March 29, 2018
  • NEW - Added basic framework for hardware wallet support (import & sign)
  • NEW - Added basic Trezor hardware wallet integration
Version 0.9.7 - March 15, 2018
  • FIXED - Issue with create_btcpay API calls failing (more info)
  • FIXED - issue with markets sidebar displaying wrong volume and % (more info)
  • FIXED - Issues with URIs not working on windows/linux (more info)
  • NEW - Added support for addresses with 1,000+ assets/tokens (more info)
  • NEW - Ability to check for version update manually
Version 0.9.6 - Feburary 10, 2018
  • NEW - Added support for Highcharts
  • NEW - Added support for Decentralized Exchange (DEX)
  • NEW - Added market view (chart, orders, history, etc)
  • NEW - Added 20+ technical indicators to market view
  • NEW - Added suport Auto-BTCpay and manual BTCpay notifications
  • NEW - Added support for /api/history/address endpoint
  • NEW - Added support for displaying asset lock status via lock/unlock icons
  • NEW - Added version update notification system
  • FIXED - Issue where asset description was reset when issuing additional supply
  • FIXED - Issue where issuing additional supply was resetting description
  • FIXED - Display issue with pending transactions in history list
Version 0.9.5 - October 13, 2017
  • NEW - Initial release for Windows, Mac, and Linux