npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

simple-bitcoin-wallet

v0.0.9

Published

For web developers building applications for Bitcoin Cash, Simple Wallet provides an easy and quick way to create BCH wallets and send bitcoin around. simple-wallet give developers high-level interfaces that hides most of the complexity required for such

Downloads

13

Readme

Simple Bitcoin Wallet

Build Status

For web developers building applications for Bitcoin Cash, Simple Wallet provides an easy and quick way to create BCH wallets and send bitcoin around. simple-bitcoin-wallet gives developers high-level interfaces that hides most of the complexity required for such functionality. The mission is to make interaction with Bitcoin Cash Blockchain as simple as possible.

Simple Wallet is used for Honest.Cash. It uses Bitbox and rest.bitcoin.com.

The default derivation path for the wallet keypair is m/44'/0'/0'/0/0.

Functionality

  • Create wallets

  • Send Transactions (1:n fund distribution possible!)

  • Upload and Download data from the blockchain (deprecated)

  • Support for encryption of recovery phrases

How to use it?

Import

Add to your HTML scripts

<script src="https://honest.cash/js/simple-bitcoin-wallet.min.js"></script>

Node module

npm install simple-bitcoin-wallet --save
// module import
import SimpleWallet from "simple-bitcoin-wallet";

// nodejs modules
const SimpleWallet = require("simple-bitcoin-wallet");

Create new wallets

const simpleWallet = new SimpleWallet();

// 12 words seed phrase for the wallet
console.log(simpleWallet.mnemonic);

// cash address derived from the seed (derivation path: m/44'/0'/0'/0/0)
console.log(simpleWallet.cashAddress);

// legacy address derived from the seed (derivation path: m/44'/0'/0'/0/0)
console.log(simpleWallet.legacyAddress);

// private key for the BCH address derived from the seed (derivation path: m/44'/0'/0'/0/0)
console.log(simpleWallet.privateKey);

Mnemonic encryption

const simpleWallet = new SimpleWallet(null, {
  password: "myStrongPassword"
});

// 12 words seed phrase for the wallet
console.log(simpleWallet.mnemonic);

// encrypted mnemonic
console.log(simpleWallet.mnemonicEncrypted);

const simpleWallet2 = new SimpleWallet(simpleWallet.mnemonicEncrypted, {
  password: "myStrongPassword"
});

// decrypted mnemonic
console.log(simpleWallet.mnemonic);

Initialize wallet with mnemonic

// initialize with 12 words seed phrase for the wallet
const simpleWallet = new SimpleWallet("minor bench until split suffer shine series bag avoid cruel orient aunt");

// initialize for specific HD derivation path
const simpleWallet2 = new SimpleWallet("minor bench until split suffer shine series bag avoid cruel orient aunt", {
    HdPath: "m/44'/0'/0'/1'"
});

Send transactions

You can send funds to other BCH wallets. You can distribute funds to N users by simply extending the receiver array.

const simpleWallet = new SimpleWallet("minor bench until split suffer shine series bag avoid cruel orient aunt");

const receivers = [
    {
        address: "bitcoincash:qp2rmj8heytjrksxm2xrjs0hncnvl08xwgkweawu9h",
        // amount in satoshis, 1 satoshi = 0.00000001 Bitcoin
        amountSat: 100000
    }
];

const tx = await simpleWallet.send(receivers);

// Transaction ID
// you can then see the transaction in one of the explorers
// example: `https://explorer.bitcoin.com/bch/tx/${tx.txid}`;
console.log(tx.txid);

Send OP_RETURN transaction

You can include any OP_RETURN data outputs to your receivers array when sending a transaction. The OP_RETURN data is included using an array of strings. The strings are utf8 by default, but can be interpreted as hex by prepending the string with '0x'. This allows you to use applications with an OP_RETURN protocol, such as memo.cash.

const simpleWallet = new SimpleWallet("minor bench until split suffer shine series bag avoid cruel orient aunt");

const receivers = [
    {
        address: "bitcoincash:qp2rmj8heytjrksxm2xrjs0hncnvl08xwgkweawu9h",
        // amount in satoshis, 1 satoshi = 0.00000001 Bitcoin
        amountSat: 100000
    },
    {
        // Post memo containing the text "Hello world!"
        opReturn: ["0x6d02", "Hello world!"]
    }
];

const tx = await simpleWallet.send(receivers);

// Transaction ID
// you can then see the transaction in one of the explorers
// example: `https://explorer.bitcoin.com/bch/tx/${tx.txid}`;
console.log(tx.txid);

getBalance(bchAddress?: string): Promise

Gets balance (confirmed + unconfirmed) for an BCH address

// will get a balance for simpleWallet.cashAddress
const myBalance = await simpleWallet.getBalance();

// will get a balance for any address
const balanceOfOtherAddress = await simpleWallet.getBalance("bitcoincash:qp2rmj8heytjrksxm2xrjs0hncnvl08xwgkweawu9h");

Get full address info

// will get a balance for simpleWallet.cashAddress
const myWalletInfo = await simpleWallet.getWalletInfo();

// will get a balance for any address
const walletInfoOfOtherAddress = await simpleWallet.getWalletInfo("bitcoincash:qp2rmj8heytjrksxm2xrjs0hncnvl08xwgkweawu9h");
/**
{
    balance: 0.00373518
    balanceSat: 373518
    cashAddress: "bitcoincash:qrlhkg4d9z3y88j246a6482xzregxaxnfsagmd2kh3"
    legacyAddress: "1QHrpX426kFvoxRNPZh9aW5Qve5emndARr"
    totalReceived: 0.15087197
    totalReceivedSat: 15087197
    totalSent: 0.14713679
    totalSentSat: 14713679
    transactions: [ "txId1", "txId2" ]
    txApperances: 2
    unconfirmedBalance: 0
    unconfirmedBalanceSat: 0
    unconfirmedTxApperances: 0
}
*/

Upload and download stuff on Bitcoin Cash

You can save and retrieve data on the Bitcoin Cash blockchain using the BitcoinFiles protocol. This is fullt integrated into simple-bitcoin-wallet.

const simpleWallet = new SimpleWallet("minor bench until split suffer shine series bag avoid cruel orient aunt");

// any data is allowed
const data = {
    title: "Hello wordl",
    body: "Hello world",
    author: "honest_cash"
};

// meta is optional
const meta = {
    title: "hello wordl",
    extUri: "https://honest.cash"
};

const { fileId } = await simpleWallet.upload(data, meta);

// 3 sec later request the file.
setTimeout(async () => {
    const result = await simpleWallet.download(fileId);

    console.log(result);
}, 3000);

Error Handling

try {
    tx = await simpleWallet.send([
        { address: "bitcoincash:qrlhkg4d9z3y88j246a6482xzregxaxnfsagmd2kh3", amountSat: 1000 }
    ]);
} catch (err) {
    console.error(err);

    if (err.message && err.message.indexOf("Insufficient") > -1) {
        return alert("Insufficient balance on your BCH account.");
    }

    return alert("Error. Try again later.");
}

Save keys in the browser

While developing BCH apps, remember to never send the private keys / mnemonic / seed phrase to your servers.

  1. Your servers can be hacked
  2. Depending on your jurisdiction you may not have the allowance to manage the funds of your users
const simpleWallet1 = new SimpleWallet();

// save the mnemonic for later
localStorage.setItem("BCH_MNEMONIC", simpleWallet.mnemonic);

// retrieve mnemonic to initialize the wallet
const simpleWallet2 = new SimpleWallet(localStorage.getItem("BCH_MNEMONIC"));

Under the hood

  • Simple wallet is a wallet implemented for honest.cash. It combines functionality of multiple libraries and recombines them in a way that makes it simple for developers to begin working with Bitcoin Cash blockchain.

  • Simple Bitcoin Wallet is powered by Bitbox Light (a fork of Bitbox SDK) and communicates with the Cloud API rest.bitcoin.com.

Licence

Copyright 2018-2019

MIT

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.