This repository contains a series of small example apps that illustrate how to code up common use cases for a Bitcoin Cash application using the bch-js JavaScript library and the bch-api REST API, offered by FullStack.cash

Here are two YouTube walk-through videos to help you get started:

• Introduction to bch-js and the bch-js-examples repository
• Working with the FullStack.cash JWT token

The low-level directory contains low-level applications exercising a single feature of bch-js. Think of these examples like lego blocks that can be used to build a bigger app.

The applications directory contains example applications like wallets, tokens, voting, and other ideas.

For a full-blown wallet, check out the slp-cli-wallet. This is both a command-line wallet as well as an NPM JavaScript library for providing high-level wallet functionality to your own applications.

If you want to chat with other developers interested in Bitcoin Cash, be sure to join our Telegram channel.

Installation

Prior to running these examples, you need to setup this code repository.

Start command line (cmd). In your home directory (e.g. C:\users\abc) run these commands

git clone https://github.com/nghiacc/bch-js-examples.git

Go to the new directory:

cd bch-js-examples

Run this command to install the required dependencies.

npm install

Running Examples

You can run each example script by entering its directory and executing npm start

More Information

If you're new to Bitcoin Cash or need to brush up on your fundamentals, here are some resources:

• Mastering Bitcoin Cash
• bch-js and bch-api Documentation

Basic ABC Wallet Functions

These basic examples in the applications/wallet directory are used to bootstrap an ABC wallet for use with the other examples. Recommended path:

1. Create a testnet wallet
2. Fund it with the testnet faucet
3. Check the balance
4. Send some ABC tokens

SLP Wallet Functions

These basic examples in the applications/wallet directory are used to bootstrap an ABC wallet for use with the other examples. Recommended path:

1. Create an SLP wallet
2. Fund it with a small amount of Bitcoin ABC token (0.0001 is sufficient)
3. Check the balance
4. Create token Change the following info in the create-token.js before running npm start:

    // Generate SLP config object
  const configObj = {
    name: 'ABC SLP Test Token',
    ticker: 'SLPABC',
    documentUrl: 'https://FullStack.cash',
    decimals: 8,
    initialQty: 100,
    documentHash: '',
    mintBatonVout: 2 // 2 - flexible supply
  }

A note about testnet

Testnet isn't just a network for software developers. Many mining pools, research labs, and even malicious miners, use the testnet and can disrupt the development workflow. Most professional developers on the Bitcoin Cash network prefer to use mainnet. They use 1000 satoshi transactions (a fraction of a penny) to test their software, and avoid using the disruptive testnet.

That being said. FullStack.cash provides a testnet faucet here to help developers get started without needing to purchase any Bitcoin Cash.