Error Composing Dispenser TX - Balance History

This error pops up when trying to create a dispenser on an address that has Bitcoin transaction history on it already. As explained in the Setting up a Dispenser section:

There are a few ways to set up a dispenser:

  • 1 - The 'old fashioned way' would be to pick an address you control and manually send the Token(s) you would like to dispense along with some BTC to cover the BTC fees associated with creating the dispenser to a brand new address (that is not your main used address). In this example, the "Source" and "Dispenser" outputs would be the same.

  • 2 - Simply creating a Dispenser on your main "Address #1" (or whatever main address you use) and making sure you understand to not accidently send BTC to this address and 'accidently dispense' the token by refilling the address with Bitcoin. In this example, the "Source" and "Dispenser" outputs would be the same.

  • 3 - Creating a brand-new address in Freewallet (that has Bitcoin history on it yet) and creating the dispenser on that new address without having to send Bitcoin or the Token(s) to it. This is the most common (and cheapest) way to set up a new Dispenser. In this example, the "Source" and "Dispenser" outputs would be different addresses as shown. - Take Note only 1 single dispenser can be made on a new address using this method. Any more dispensers you wish to create will have to use the "#1" method explained above.

This error usually pops up when you are using method #3 and are trying to open multiple dispensers on this separate new address you created:

  • If you do get this transaction through (which can happen if two tx's are confirmed in the same block), your dispenser will not be made and will not show on xchain.io

  • It will also show a "Error: [404:] {"ip":"xxxxxxxxxx","message":"Error: Not Found","data":null}" message when looking up the transaction on xcp.dev

The fix for this is to use the Dispenser creating method #1 (the 'old fashioned way') which involves manually sending the assets you would like to dispense and creating a dispenser so the Source and Dispenser addresses are the same.

Last updated