Skip to content

Latest commit

 

History

History
125 lines (85 loc) · 5.53 KB

README.md

File metadata and controls

125 lines (85 loc) · 5.53 KB
Raw

Burner Wallet 2.0

The Burner Wallet 2.0 is a modular, extendable and customizable web application for seamless crypto payments.

Create a burner wallet in just a few lines of code:

const core = new BurnerCore({
  signers: [new InjectedSigner(), new LocalSigner()],
  gateways: [new InfuraGateway(process.env.REACT_APP_INFURA_KEY), new XDaiGateway()],
  assets: [xdai, dai, eth],
});

const exchange = new Exchange({ pairs: [new XDaiBridge(), new Uniswap('dai')] });

const BurnerWallet = () =>
  <ModernUI
    core={core}
    plugins={[exchange, new ENSPlugin()]}
  />

Running the wallet

Simple, customized wallet

Do you want to customize your own version of the wallet? Check out the simple application in the basic-wallet directory.

Alternatively, visit https://burnerfactory.com to create your own wallet without writing any code!

Setting Infura key

By default, basic-wallet uses the InfuraGateway for connecting to commonly used Ethereum chains.

The entry point takes an Infura key from the REACT_APP_INFURA_KEY environment variable. For your wallet to function correctly, you must create a file named .env in the basic-wallet folder with the following value:

REACT_APP_INFURA_KEY=<your infura key>

You can generate an Infura key at https://infura.io/

Add a custom token

You can add any ERC20 token to your wallet by constructing a new ERC20Asset and adding it to the asset list.

The id parameter is the internal ID used by the wallet, while the name parameter is the display name that will be displayed to the user. network is the chain ID of the chain the token is deployed to ('1' for mainnet, '100' xDai, etc). address is the address where the token contract is deployed.

import { xdai, dai, eth, ERC20Asset } from '@burner-wallet/assets';

const bos = new ERC20Asset({
  id: 'bos',
  name: 'Boston Token',
  network: '100',
  address: '0x52ad726d80dbb4A9D4430d03657467B99843406b',
});

const core = new BurnerCore({
  assets: [bos, xdai, dai, eth],
});

Local developer wallet

Are you a developer, hoping to test changes to other modules in this project (modern-ui, ui-core or various plugins)?

Run yarn start-local in the project root. This will start a wallet on localhost:3000 that is connected to your local Ganache instance (connecting to node http://localhost:8545 by default).

Before the wallet server launches, a script create a pre-filled account. This account will hold 1 Ganache ETH and 100 test tokens.

Note that Metamask will override the local account, disable it or open in incognito mode for local development.

Packages

This is a monorepo that contains the following packages:

  • @burner-wallet/modern-ui: The standard user interface for burner wallets
  • @burner-wallet/classic-ui: The original burner wallet design. Maintained for nostalgia.
  • @burner-wallet/ui-core: The core UI logic for all burner wallets (not to be confused with the @burner-wallet/core package, which contains core blockchain logic).
  • @burner-wallet/types: Typescript type bindings

Plugins:

  • @burner-wallet/exchange: An extendable plugin for implementing asset exchanges and bridges
  • @burner-wallet/ens-plugin: Support for the Ethereum Name Service
  • @burner-wallet/erc681-plugin: Support for scanning ERC681 payment request QR codes
  • @burner-wallet/legacy-plugin: Allow scanning old paper wallets and handling old URL routes
  • @burner-wallet/link-plugin: Send tokens to friends over text by sending funds to a URL
  • @burner-wallet/metamask-plugin: Button to unlock Metamask. Requires InjectedSigner
  • @burner-wallet/recent-accounts-plugin: Suggest recent accounts when sending funds
  • @burner-wallet/seed-phrase-plugin: Load accounts by seed phrase

The Burner Wallet 2 is dependent on the burner-core packages (@burner-wallet/core and @burner-wallet/assets) for handling core blockchain functionality.

Plugin Development

The burner wallet functionality can be extended by passing plugin objects to the BurnerUI component.

Reference Plugins

This repo contains a number of standard plugins that can be considered "officially supported"

  • Exchange: For exchanging or bridging different assets. Note that the exchange itself is also extendable by adding new exchange pairs.
  • LegacyPlugin: Supports URLs and QR codes from Austin's original burner code
  • LinkPlugin: Allows generating links, which can be opened to claim tokens

The burner-factory-plugins repo also contains a number of other plugins:

API Reference

API reference for plugin development is available in the Readme for the @burner-wallet/ui-core package.