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

@kasdk/web-core

v0.15.2

Published

Rusty Kaspa WASM32 SDK bindings for RPC + Key & Address Generation + Wallet SDK

Downloads

10

Readme

WASM32 bindings for Rusty Kaspa SDK

Rusty-Kaspa WASM32 bindings offer direct integration of Rust code and Rusty-Kaspa codebase within JavaScript and TypeScript environments such as Node.js and Web Browsers.

Documentation

Please note that while WASM directly binds JavaScript and Rust resources, their names on JavaScript side are different from their name in Rust as they conform to the 'camelCase' convention in JavaScript and to the 'snake_case' convention in Rust.

The WASM32 bindings can be used in both TypeScript and JavaScript environments, where in JavaScript types will not be constrained by TypeScript type definitions.

Interfaces

The SDK is currently separated into the following top-level categories:

  • RPC API — RPC API for the Kaspa node using WebSockets.
  • Wallet SDK — Bindings for primitives related to key management and transactions.
  • Wallet API — API for the Rusty Kaspa Wallet framework.

WASM32 SDK release packages

The SDK is built as 4 packages for Web Browsers as follows:

  • KeyGen - Key & Address Generation only
  • RPC - RPC only
  • Core - RPC + Key & Address Generation + Wallet SDK
  • Full - Full SDK + Integrated Wallet For NodeJS, the SDK is built as a single package containing all features.

SDK folder structure

The following is a brief overview of the SDK folder structure (as available in the release):

  • web/kaspa - full Rusty Kaspa WASM32 SDK bindings for use in web browsers.
  • web/kaspa-rpc - only the RPC bindings for use in web browsers (reduced WASM binary size).
  • nodejs/kaspa - full Rusty Kaspa WASM32 SDK bindings for use with NodeJS.
  • docs - Rusty Kaspa WASM32 SDK documentation.
  • examples folders contain examples for NodeJS and web browsers.
  • examples/data - folder user by examples for configuration and wallet data storage.
  • examples/javascript - JavaScript examples.
  • examples/javascript/general - General SDK examples (keys & derivation, addresses, encryption, etc.).
  • examples/javascript/transactions - Creating, sending and receiving transactions.
  • examples/javascript/wallet - Interfacing with the Rusty Kaspa Wallet framework.
  • examples/typescript - TypeScript examples.

If you are using JavaScript and Visual Studio Code, it is highly recommended you replicate the jsconfig.json configuration file as is done in the SDK examples. This file allows Visual Studio to provide TypeScript-like code completion, type checking and documentation.

Included documentation in the release can be accessed by loading the docs/kaspa/index.html file in a web browser.

Building from Source

To build the WASM32 SDK from source, you need to have the Rust environment installed. To do that, follow instructions in the Rusty Kaspa README.

Once you have Rust installed, you can build the WASM32 SDK as follows:

  • ./build-release - build the release version of the WASM32 SDK + Docs. The release version also contains debug builds of the libraries.
  • ./build-web - build the web package (ES6 module)
  • ./build-node - build the NodeJS package (CommonJS module)
  • ./build-docs - runs build-web and then generates TypeDoc documentation from the resulting build.

Please note that to build from source, you need to have TypeDoc installed globally via npm install -g typedoc (see below).

Running Web examples

IMPORTANT: To view web examples, you need to serve them from a local web server and serve them from the root of the SDK folder (kaspa-wasm32-sdk if using a redistributable or rusty-kaspa/wasm if building from source). This is because examples use relative paths. WASM32 currently can not be loaded using the file:// protocol.

You can use any web server of your choice. If you don't have one, you can run one as follows:

cargo install http-server
http-server

Access the examples at http://localhost:7878/examples/web/index.html. (Make sure to change the port if you are using a different server. Many servers will serve on http://localhost:8000/examples/web/index.html by default)

If building from source, you must run build-release or build-web scripts before running the examples.

Running NodeJs examples

This applies to running examples while building the project from source as some dependencies are instantiated as a part of the build process. You just need to run node init to initialize a local config.

NOTES:

  • npm install will install NodeJs types for TypeScript and W3C websocket modules

  • npm install -g typedoc is needed for the release build to generate documentation

  • node init creates a local examples/data/config.json that contains a private key (mnemonic) use across NodeJS examples. You can override address used in some examples by specifying the address as a command line argument.

  • Majority of examples will accept following arguments: node <script> [address] [mainnet|testnet-10|testnet-11] [--address <address>] [--network <mainnet|testnet-10|testnet-11>] [--encoding <borsh|json>].

    By default all wRPC connections use Borsh binary encoding.

Example:

cd wasm
./build-release
cd examples
npm install
node init
node nodejs/javascript/general/rpc.js

Using RPC

There are multiple ways to use RPC:

  • Control over WebSocket-framed JSON-RPC protocol (you have to manually handle serialization)
  • Use RpcClient class that handles the connectivity automatically and provides RPC interfaces in a form of async function calls.

NODEJS: To use WASM RPC client in the Node.js environment, you need to introduce a W3C WebSocket object before loading the WASM32 library. The compatible WebSocket library is WebSocket and is included in the kaspa NPM package. kaspa package is a wrapper around kaspa-wasm that imports and installs this WebSocket shim in the globalThis object and then re-exports kaspa-wasm exports.

Loading in a Web App

<html>
    <head>
        <script type="module">
            import * as kaspa from './kaspa/kaspa-wasm.js';
            (async () => {
                await kaspa.default('./kaspa/kaspa-wasm_bg.wasm');
                console.log(kaspa.version());
                // ...
            })();
        </script>
    </head>
    <body></body>
</html>

Loading in a Node.js App

//
// W3C WebSocket module shim
// this is provided by NPM `kaspa` module and is only needed
// if you are building WASM libraries for NodeJS from source
//
// @ts-ignore
// globalThis.WebSocket = require('websocket').w3cwebsocket;
//

let {
    RpcClient,
    Encoding,
    initConsolePanicHook
} = require('./kaspa');

// enabling console panic hooks allows WASM to print panic details to console
// initConsolePanicHook();
// enabling browser panic hooks will create a full-page DIV with panic details
// this is useful for mobile devices where console is not available
// initBrowserPanicHook();
// if port is not specified, it will use the default port for the specified network
const rpc = new RpcClient({
    url: "127.0.0.1", 
    encoding: Encoding.Borsh, 
    network : "testnet-10"
});

(async () => {
    try {
        await rpc.connect();
        let info = await rpc.getInfo();
        console.log(info);
    } finally {
        await rpc.disconnect();
    }
})();

For more details, please follow the integrating with Kaspa guide.

Creating Documentation

Please note that to build documentation from source you need to have the Rust environment installed. The build script will first build the WASM32 SDK and then generate typedoc documentation from it.

You can build documentation from source as follows:

npm install -g typedoc
./build-docs

The resulting documentation will be located in docs/typedoc/