Skip to content
No description, website, or topics provided.
JavaScript CSS HTML Other
Branch: master
Clone or download
Pull request Compare This branch is 324 commits ahead of austintgriffith:master.
guifel Merge pull request #3 from TomAFrench/master
Functional Liquidity Burner wallet by Tom French.
Latest commit 51c1888 Jan 14, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github delete dockerhubmetadata.yml as nonfunctional Jan 8, 2020
config Dedupe web3's bn.js (190 KB gzipped) Jul 2, 2019
src made network id accessible from dapparatus Jan 8, 2020
.dockerignore dockerised burner wallet Sep 22, 2019
.env.development removed burner core Dec 11, 2019
Dockerfile fix docker image generation Sep 23, 2019
LICENSE MIT Feb 22, 2019
package.json fix docker image generation Sep 23, 2019
yarn.lock Add local mode Jun 20, 2019


🔥 The Liquidity Burner Wallet is a quick web wallet used to move small amounts of crypto quickly. On page load an Ethereum keypair is automatically generated and used to sign transactions with an incredibly simple interface. Sending funds is as easy as a QR code scan.

🌊 Liquidity Burner Wallet is similar to the Burner Wallet but rather than using the relatively centralised xDai sidechain, it instead allows free near-instant transactions on the Liquidity Network NOCUST commit chain. This means that your funds are secured by the main Ethereum network in a non-custodial fashion. The very small number of validators of the xDai chain (currently only 11!) can lock your funds indefinitely if they wanted to. As it is non-custorial, no matter what happens to Liquidity Network you can always withdraw your money back to the Ethereum mainnet!

💵 Burners are analogous to cash: quick and easy but less secure. You wouldn't stuff thousands of dollars in your pocket on the way out the door at night, don't trust a seed phrase in localstorage with more than you are willing to lose.

🎫 Using paper wallets,, or solidcoins, users can be instantly onboarded into a wallet and have tokens or localcoins to purchase goods or services.

🏠 Don't forget to sweep funds to colder storage when you get home at night and burn your ephemeral keys!

🌉 Press the [Bridge] button to move ETH or DAI that you have sent to your burner onto the NOCUST Hub.

🏦 Press the [Exchange] button to buy fDAI with fETH using the TEX.

🗝️ If you would like more permanence, press the [Advanced] button and use a short pass phrase to seed a keypair.

All projects should have a 'burner' version of their product. Take simple fundamentals from your app and put them in an easy to access web version before the barriers to entry. Use this to educate your users about your product and incentivize them to take the next step and download your app.

🙏 Thanks to Austin Griffith, the original creator of the Burner Wallet which this is based on.

🛠️ If you are interested in contributing development to the Liquidity Burner Wallet, read on...

Where can I use the Liquidity Burner Wallet?

A number of versions of the Liquidity Burner Wallet are hosted at the links below:

The Limbo testnet runs a NOCUST hub which runs with a shorter checkpoint round time (6 minutes instead of 36 hours). This allows easier testing of withdrawals as two checkpoints need to pass before funds become available on the blockchain.


A burner wallet is automatically generated upon visiting and your private key is stored in a cookie so it will be there when you come back. However, if you want to host your own copy of the Liquidity Burner Wallet then a docker image can be downloaded using the command

docker pull tomfrench/liquidityburner:latest

An example docker compose file is shown below:

version: "3.2"
    image: tomfrench/liquidityburner:latest
      MAINNET_WEB3_PROVIDER: '[[APIKEY]]' // Required for ENS resolution
      HUB_CONTRACT_ADDRESS: '0x83aFD697144408C344ce2271Ce16F33A74b3d98b'
      HUB_API_URL: ''
      TOKEN: "DAI"
      - "80:80"

There are a number of hubs deployed on various networks so WEB3_PROVIDER, HUB_CONTRACT_ADDRESS and HUB_API_URL must be set appropriately to interact with the desired hub.

The TOKEN environment variable determines which token other than ETH is used within the wallet. This token must be registered by the hub operator for it to be available.


Assuming you have nodejs and git already installed...

clone the burner wallet repo

git clone
cd liquidity-burner

install burner:

npm i

start the app :

npm start
You can’t perform that action at this time.