Qubic TypeScript SDK

Modular TypeScript packages for building on the Qubic network — crypto, transactions, RPC, contracts, events, and React hooks.

The Qubic TypeScript SDK is a collection of focused packages that cover everything from raw cryptography to React hooks. You pick what you need; the packages are independently installable and tree-shakeable.

Built for Bun. Works with Node.js.

Packages

@qubic.org/typesBranded primitives, protocol constants, shared error types

@qubic.org/cryptoK12 hash, SchnorrQ signatures, FourQ key derivation

@qubic.org/txBinary transaction builder, signer, and verifier

@qubic.org/walletWallet, encrypted vault, and seed utilities

@qubic.org/rpcType-safe REST client for the Qubic RPC gateway

@qubic.org/bobLive node client — JSON-RPC 2.0, REST, WebSocket subscriptions

@qubic.org/eventsBinary event decoder, filter builder, typed subscription helpers

@qubic.org/registryVersioned ABI registry for all Qubic smart contracts

@qubic.org/contractsGenerated typed wrappers for every deployed contract

@qubic.org/tcpDirect TCP transport — framing, connection pool, typed requests

@qubic.org/reactReact hooks and providers — TanStack Query, VaultProvider

Where to start

Getting started

Send your first transaction in under 5 minutes.

React dApp

Build a browser wallet with hooks and wallet connectors.

Contract queries

Read data from any deployed Qubic smart contract.

Live events

Subscribe to transfers and contract logs over WebSocket.

Package dependency graph

graph TD
  types["@qubic.org/types"]
  crypto["@qubic.org/crypto"]
  tx["@qubic.org/tx"]
  rpc["@qubic.org/rpc"]
  registry["@qubic.org/registry"]
  contracts["@qubic.org/contracts"]
  bob["@qubic.org/bob"]
  wallet["@qubic.org/wallet"]
  events["@qubic.org/events"]
  tcp["@qubic.org/tcp"]
  react["@qubic.org/react"]

  types --> crypto
  types --> rpc
  types --> registry
  types --> bob
  types --> tcp
  types --> events
  crypto --> tx
  crypto --> wallet
  crypto --> tcp
  crypto --> events
  tx --> wallet
  registry --> contracts
  rpc --> contracts
  bob --> events
  wallet --> react
  events --> react

@qubic.org/types has no dependencies and can be installed anywhere. Every other package depends on it.