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

Paying Dividends to Token Holders

PreviousDestroying TokensNextVoting with Tokens

Last updated 6 months ago

Counterparty supports Dividends through user-created tokens, which in many other Communities could be called "airdrops". This means that you can pay out BTC or any Counterparty Token to holders of a any XCP user-created token. This feature lets you distribute XCP, BTC or any other token to the holders of any token you wish. You can specify an amount per unit, and everyone who holds units of your own token will receive a proportional amount of the secondary token being distributed.

This feature also has many clever uses, such as .

If you would like to check out a video explanation of a single use case of deploying Dividends using Freewallet, check out on this subject made by RobotLoveCoffee.

To Pay Dividends, go to Freewallet and right-click on the asset you would like to pay dividends to holders of this asset, and then click “Pay Dividends on TOKEN"

You can also use the “Actions” icon on the upper right and choose “Pay Dividends” though the “Token Name” input will not be automatically filled

To distribute BTC to token holders, first verify the Token Name is the correct token you wish to pay dividend to holders. In this example below we are distributing PEPECASH to holders of the asset MMMPEPE.

In the “Dividend” input make sure you select the correct Dividend Token you wish to distribute to the holders of the Token Name input.

  • For BTC, use the BTC icon

  • For XCP use the XCP icon

  • For other assets, use the drop-down menu to choose the correct asset

Only assets you have the Token Issuance Ownership can have dividends paid out to the holders of that token:

  • Either you already minted the token yourself

In this example above let's review a very important part of the Dividend process:

Viewing MMMPEPE on Tokenscan.io, we can sort the token information by Holders as shown with the Green arrow above.

The amount of the Token that is shown in the example to distribute, which is 1 PEPECASH per unit of MMMPEPE owned, will be given per unit MMMPEPE owned.

This means the number 1 Holder of MMMPEPE, who has 28 MMMPEPE tokens, will receive 28 PEPECASH total in this Dividend payment. While the 10th holder, who holds 3 MMMPEPE tokens, will only receive 3 PEPECASH total. This means with this Dividend payment you would be sending 111 PEPECASH total because there are 111 total MMMFOOD tokens.

Once you have decided these inputs mentioned above, the last step is the Fee to use when broadcasting this Dividend as a transaction.

Note for BTC Dividends to XCP Token (or user-created) token holders:

It is possible to pay out distributions using Bitcoin directly. However, this process is a regular Bitcoin transaction without any extra added data (which would make it a Counterparty transaction). This means when sending out Dividend payments of BTC, it will not be possible to distinguish it as a Counterparty type transaction on block explorers or inside Freewallet. Dividends with BTC will simply appear as a regular BTC transaction with multiple recipients and not be seen on Counterparty Block Explorers and only Bitcoin Block Explorers.

Because this makes it difficult to distinguish distributions from regular transactions, it is recommended that you use one address per asset when issuing Bitcoin dividends, and do not use that address for anything else for simpler record keeping with blockchain data. This will make it much easier to keep track of past BTC distributions. Otherwise, it may be difficult for you and/or your users to get an overview of past distribution payments.

Or you were given the rights of from somebody else

It is best to look over the section of this User Manual first.

Token Ownership
What BTC Fee should I use?
transparent voting
this informational video
Drop-down menu when right-clicking an asset you own. Pay Dividends shown with Blue Oval
Drop-down menu from the Actions tab in the upper right of Freewallet. Pay Dividends button shown with Orange Box
Pay Dividends pop-up window with sample Dividend details
Drop-down menu when selecting the Dividend
RobotLoveCoffee video explaining the Dividends feature with Counterparty tokens