Closing a Dispenser

It is possible to close a dispenser right from the My Dispenser tab in the Dispensers tab or to manually close it using the Transaction Hash with the Actions tab in Freewallet.

  • It will require a Bitcoin transaction to do so and comes with a bit of responsibility when doing so.

  • Once a Close Dispenser transaction is confirmed it will take five Bitcoin confirmation blocks for the asset in the dispenser to be returned to you.

It is important to first note ANY unconfirmed transactions on your dispenser before you close it. Though it is possible to close a dispenser before someone’s dispense has finished (especially if they used too low of a fee), if you do not refund the funds sent from Unconfirmed Dispenses it is seen as a very disrespectful and a fraudulent action to do to your buyers.

To check if there are any unconfirmed Dispenses, view your Dispenser on xchain.io and click the "Unconfirmed" tab at the bottom of the page:

Since all of these transactions are publicly broadcasted on the Bitcoin blockchain, this data will be easy to access and unchangeable in the future.

It is much more responsible to openly express you are in control of the dispenser and will accurately address if any buyer issues arise because of low transaction fees or unconfirmed attempts at dispenses.

To close a dispenser, first navigate to the address you created the dispenser from (also called the Origin Address) or navigate to the address the dispenser is currently live on (also called the Source Address).

  • You are able to close a dispenser from the Origin OR Source address in Freewallet.

Then go to the “Dispensers” tab on the top of Freewallet.

If you do not see your asset in the My Dispensers tab and you verify you are selected on the Origin or Source address for this dispenser, you can also manually close it by clicking the "Actions" tab on the upper right and choosing "Close Dispenser":

Here you will see the option to “Close” your dispenser on the right side. Simply click that red "Close" button and Freewallet will pop up this prompt:

Since you are able to close an open dispenser from the Source or Origin address, Freewallet asks you for the specific transaction ID for this dispenser.

  • To review what the Origin and Source addresses are, look over the Setting up a Dispenser section of the User Manual.

This information can be found on xchain and is marked as the "Transaction Hash" of that specific dispenser:

From the close dispenser popup you can also choose your BTC fee you would like to use. If you are wondering what BTC fee to use, check out the What BTC fee should I use? section of this User Manual.

  • If you have closed this dispenser from the Origin address, the asset(s) will be returned to the Origin address after five Bitcoin confirmation blocks after the Close Dispenser transaction has been initially confirmed.

  • If you have closed this dispenser from the Source address, the asset(s) will be returned to the Source address after five Bitcoin confirmation blocks after the Close Dispenser transaction has been initially confirmed.

After you click close dispenser, the transaction will be sent to the Bitcoin network and when it is confirmed your Dispenser will now be closed.

After five confirmation blocks you will now be able to freely send and access the token(s) that were once in the dispenser.

This dispenser feature is still in discussion and many Community Members have voiced their opinions on making this feature better in the future. Please check out the Counterparty Forums and the Counterparty Github for more information on this discussion.

Last updated