Skip to main content

Typescript Libraries

Two TypeScript options exist. Start with qubic-typescript — it covers everything the older Qubic TypeScript Library does (identity and crypto helpers, transaction building, and direct TCP access to a node) and adds an RPC gateway client, a Bob live-node client, typed contract wrappers, event decoding, and React hooks. It's split into focused packages, so you install only what you need.

The Qubic TypeScript Library is still worth reaching for in two cases:

  • You're maintaining a project already built on it — it's stable and widely used.
  • You need the raw node protocol from a browser, which it reaches through qubic.li's WebSocket bridge. qubic-typescript's @qubic.org/tcp uses Node's net module, so it runs on Node and Bun but not in the browser.

qubic-typescript (SDK)​

qubic-typescript is a modular TypeScript SDK, split into focused packages for crypto, transaction building, RPC, ABI codec, live node subscriptions, and React integration. It is built for Bun and works with Node.js.

note

qubic-typescript is in public beta — core APIs are stable and in production use, but the public surface has not frozen yet. Pin to an exact version and check the changelog when upgrading.

For the package list, install instructions, dependency graph, and end-to-end examples, see the qubic-typescript README. For frontend work specifically, the @qubic.org/react package provides hooks and wallet providers out of the box.

Qubic TypeScript Library​

The Qubic TypeScript Library is the earlier single-package library for interacting with the Qubic network from JavaScript/TypeScript, covering identities, node connections, balances, transactions, and smart contract interaction. Its companion Qubic Vault TypeScript Library handles encrypted identity storage.

For installation and usage, see the ts-library README and the ts-vault-library README. The HM25 frontend example shows both in a real application.