Skip to main content
The Wallet Development Kit (WDK) is a set of packages that expose RGB capabilities through standardised wallet abstraction interfaces. @utexo/wdk-rgb-lightning is the current Node.js / Bare module for RGB-over-Lightning. @utexo/rgb-sdk-web and @utexo/rgb-sdk-rn target application developers building end-to-end Web and mobile flows. The archived @utexo/rgb-sdk Node.js package is not used for new integrations.

​
WDK Packages

Both packages are built on rgb-lib, so the on-chain experience — UTXO management, asset state, and RGB operations — is consistent between them. They do not share asset records: give each module a separate dataDir. wdk-rgb-lightning runs in external-signer mode: the mnemonic stays in the WDK secret manager, and channel-state cryptography happens in-process through a VLS signer. Use wdk-wallet-rgb for issuance; use wdk-rgb-lightning for channels, invoices, and Lightning transfers.

​
When to Use the WDK

Use the WDK packages when:
  • You are building a new Node.js integration (use @utexo/wdk-rgb-lightning, not the archived @utexo/rgb-sdk)
  • Your application already builds on WDK-style account and manager abstractions
  • You want to plug RGB or RGB Lightning into an existing wallet architecture without adopting the UTEXOWallet lifecycle
  • You need lower-level control over account management, signing policy, and key derivation
If you are building a browser or React Native app from scratch, @utexo/rgb-sdk-web and @utexo/rgb-sdk-rn provide a higher-level UTEXOWallet API.

​
Further Reading