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. Exploring Balances, History, Exchange and Dispensers

Understanding Dispenser Markets

PreviousExploring Token Information and Enhanced Asset InformationNextBuying XCP and User Created Tokens from a Dispenser

Last updated 6 months ago

Freewallet integrates a new Counterparty feature called Dispensers that allow for all Tokens and Subassets to be “Dispensed” by sending BTC to a specific Dispenser address from a compatible Counterparty Wallet. This function was released when was added to the Counterparty protocol. With the release of counterparty-core 10.4 and later versions, only Counterparty compatible wallets can initiate a Dispense. Make sure to only use the most recent Freewallet version (or wallet ) to initiate Dispenses.

This function is entirely separate from BTC/TOKEN pairs and the BTCpay function. To learn more about the BTCpay check out the section.

Freewallet shows two tabs for the XCP and PEPECASH Dispensers available, but any token can be set up in a dispenser and dispensed at any price the seller choses

Freewallet first shows a tab for any open dispensers you have created on the address selected under the “My Dispensers” tab. Freewallet also shows two tabs for the XCP and PEPECASH Dispensers available, but any Token can be dispensed using this feature

To add a Token you would like to view the Dispensers of, simply click the gear icon in the top right and select “Add Dispenser Watchlist".

You can sort through these available dispensers by clicking the “BTC Price” column and other columns to sort the information the way you want.

You can also search the Dispenser available for any Asset by viewing its Asset page on Tokenscan and clicking the “Dispensers” tab on it’s token page

Above is an example of the XCP Asset page with the “Dispensers” tab clicked to view available dispensers. Keep in mind there is complete freedom for a seller to Dispense not just 1 whole token in a dispenser, but also fractions of tokens (such as XCP). It is up to you the user, to read the information correctly and understand how many tokens will Dispenser when sending BTC to these dispensers. Below is a good example:

When organizing the Dispensers for XCP in Freewallet by 'BTC price' as shown with the blue arrow, the cheapest dispensers actually are dispensing only fractions of an XCP per dispense (as shown in the red box). If you are looking to dispense 1 single XCP per BTC price (as shown in the blue box), make sure you are reading the information shown with a very keen eye before making any purchases. To learn more about this buying process for Dispenser Markets, review

Buying XCP and User Created Tokens from a Dispenser
CIP 21
Horizon
as shown on the Counterparty website
Understanding BTCpay and BTC/TOKEN on the DEx
Dispensers tab in Freewallet - No dispensers are live on this address
Clicking the gear icon on the upper right will show you a few tools you can use
Setting up a custom Dispenser Watchlist
BTC price column shown with the Blue arrow - Give amount under 1 full token shown in red box (avoid!)