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. Troubleshooting / Issues

"Failure to send not enough BTC in wallet"

Previous"Error While Trying to Broadcast Transaction"NextMy Freewallet Exchange/Dispenser tab is resetting the data when I try to sort by BTC Price?

Last updated 6 months ago

This error usually looks something like:

Error composing send transaction via API: Insufficient BTC at address [Your BTC Address]. (Need approximately 0.00XXXX BTC.) To spend unconfirmed coins, use the flag --unconfirmed. (Unconfirmed coins cannot be spent from multi‐sig addresses.)

  • First off, this could simply mean you actually do not have enough BTC in your wallet to pay the fee.

This does not have anything to do with your address being a “multi-sig address”. If you know you do have enough BTC in your account to cover the costs, the reasoning for this error could be many different things.

  • The second most common reason this is shown is because you may have some 'unconfirmed' transactions that were sent out from the address, but the Freewallet User Interface has not shown the data yet in the History tab.

Because there can be quite a long time between bitcoin blocks, it's always best to search your address on a BTC block explorer like blockstream.info and a Counterparty block explorer like Tokenscan.io. Before trying to spend the BTC shown in your wallet, take a look to see if any past transactions are still unconfirmed. This error message could simply mean that you have sent out transactions that have not been confirmed, so the balance still shows in your BTC section of Freewallet but a portion of that BTC is not spendable.

  • What could also be likely is that you are trying to send the MAX amount of BTC and the fee you are using makes it so you do not have enough Bitcoin to send this transaction. The first thing to try here is the change the BTC amount sent and try again.

  • Also remember sometimes just closing and re-opening the Freewallet application will update the data Freewallet is pulling from to the latest block data on the blockchain.

  • If none of those fix's work, it is more likely this means the amount of BTC on your address is ‘fragmented’ and the total balance you see is actually been split up into many smaller parts which are called UTXO’s (Unspent Transaction Output’s).

This would make more sense as you could well enough have more than enough to cover the BTC fee with your ‘total’ BTC balance, but it is comprised of many smaller amounts of BTC or UTXO’s that make up that total amount.

You can think of this issue in a different way: You don’t have a $100 bill in your account you have 10,000 pennies in UTXO’s and to cover your costs for the fee you need $1. Freewallet wallet does not let you spend the $1 fee with 100 pennies and will show you this error.

A couple of solutions have been proposed and documented to deal with and fix this issue but the simplest one out of all of them is to send more BTC to the address yourself (more than enough to cover the transaction cost) and then send ALL of the BTC in your account to yourself.

In the Bitcoin world this is called “consolidating UTXO’s” and is very common. A good article to review about how UTXO's work and how to deal with them when using Freewallet then check out .

There is no “consolidating UTXO’s” function natively yet in Freewallet though there are 3rd party wallets that do support this.

If you would like to see this feature supported in Freewallet, join . Every opinion posted there, no matter how small, will help future users and the developer to understand what is wanted in the community regarding Freewallet Functions.

Many community members recommend other wallets to do this process with such as , but other wallets support this feature too.

Just make sure when you are importing your Private Key for the address you are having this error that you do so with a wallet service you trust.

For more information on what your private key is for this specific address in question and how to view it, review the section titled .

like here
this Medium Article on the subject
the discussion on the Freewallet github
Electrum
Displaying the Seed Phrase and Private Key of your Addresses(s)