A javascript client library for building Zcash browser wallets

WebZjs aims to make it simple to securely interact with Zcash from within the browser. This is primarily to support the development of web wallets and browser plugins.

Being a private blockchain Zcash places a lot more demands on the wallet than a public blockchain like Ethereum. WebZjs uses everything at its disposal to give efficient sync times and a good user experience.

Add the @webzjs/webz-core package to your javascript project.

Before using the library it is important to initialize the Wasm module and the thread pool.

import initWasm, { initThreadPool, WebWallet } from "@webzjs/webz-core";

initWasm();
initThreadPool(8); // can set any number of threads here, ideally match it to window.navigator.hardwareConcurrency

Once this has been done we can create a WebWallet instance. You can theoretically have multiple of these per application but most cases will only want one. A single wallet can handle multiple Zcash accounts.

let wallet = new WebWallet("main", "https://zcash-mainnet.chainsafe.dev", 1);

Once you have a wallet instance it needs an account. Accounts can be added in a number of different ways. Here an account will be added from a 24 word seed phrase

await wallet.create_account("<24 words here>", 0, birthdayHeight);

and once an account is added the wallet can sync to the network.

await wallet.sync();

The sync process can take a long time depending on the wallet age and usage. This runs in a webworker so will not block the main. It is safe to trigger the sync process and then interact with the wallet using other methods while the sync runs in the background.

For more details check out the hosted docs at https://chainsafe.github.io/WebZjs/

• Rust and Cargo
• This repo uses just as a command runner. Please install this first.
• wasm-pack
• Requires clang 17 or later
  • On Mac this can be installed by updating LLVM using your preferred package manager (e.g. macports, brew)
• Tested with Rust nightly-2024-08-07

This just script uses wasm-pack to build a web-ready copy of webz-core into the packages directory

just build

Install pnpm

First build WebZjs with

just build

Install js dependencies with

pnpm i

Build the demo wallet with

pnpm build

Serve it with

pnpm serve

Browser tests are run in a headless browser environment and can be run with

just test-web

These libraries are currently under development, have received no reviews or audit, and come with no guarantees whatsoever.

All code in this workspace is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.