cashubtc / cashu-ts

Cashu TS ⚠️ **Don't be reckless:** This project is in early development, it does however work with real sats! Always use amounts you don't mind losing. Cashu TS is a JavaScript library for Cashu wallets written in TypeScript. Install Quick Start (Create a wallet) There are a number of ways to instantiate a wallet, depending on your needs. Wallet classes are mostly stateless, so you can instantiate and throw them away as needed. Your app must therefore manage state, such as fetching and storing proofs in a database. NB: You must always call or after instantiating a wallet. Usage We provide comprehensive examples categorized by use case: • **Basic Guide**: Getting Started, and basic token operations. • **WalletOps**: Translation Builder Usage Recipes. • **WalletEvents**: Event Subscriptions • **Deterministic Counters**: Deterministic counters (persist, inspect, bump). Note: Builder hooks vs Global events builders include per-operation hooks (onCountersReserved) that fire during a single transaction build. provides global subscriptions that can outlive a single builder call. Use the builder hooks for transaction-local callbacks, and WalletEvents for app-wide subscriptions. Browser usage (standalone build) Cashu TS provides a standalone browser build (IIFE) intended for demos and non-bundler usage. The standalone bundle is published as part of GitHub Releases rather than the npm package. --- Contribute We welcome contributions from anyone — newcomers, experienced developers, and AI-assisted workflows alike. If you want to contribute: • Start by reading COMMUNITY.md to understand our contribution philosophy, review expectations, and how to get involved. • Open an Issue or a PR. • Track progress using our projects. • For process details, see the contributing guide. --- Contact & Community We are building in the open and encourage active participation: • Join our weekly call — listen, introduce yourself, or ask questions. • Participate in our matrix server or telegram channel for ongoing discussion and collaboration. Being part of the conversation is the best way to have impact and become a long-term contributor.