cashu-ts.dev

What It Is

Cashu-TS is a JavaScript library written in TypeScript, positioned as a development SDK for Cashu wallets. It can be installed with npm i @cashu/cashu-ts; the current documentation version is v4.5.1. The project clearly states that it is still in an early stage of development, but it handles real sats, so it should not be used to hold large amounts of funds directly without proper risk controls.

Core Capabilities

Its core object is Wallet, which can be initialized with a mint URL and must be used only after calling loadMint() or loadMintFromCache(). The library supports use cases such as mint token, create token, P2PK, get token, melt token, BOLT11 payments, BOLT12 offers, NUT-19 cached responses, logging, and amount objects. WalletOps provides a fluent builder for send, receive, mint, and melt operations, making transaction construction easier to express clearly. WalletEvents can subscribe to counters, quotes, melts, and proof states, and also supports one-time waiting for payment completion, AbortSignal, timeout, and grouped cancellation.

Language, Deployment, and Integration

Cashu-TS targets TypeScript/JavaScript. Since v4, it supports ESM only and no longer supports CommonJS require(), so older projects will need to migrate. It also provides a standalone browser IIFE build, but that package is published via GitHub Releases rather than included in the npm package. The library itself is not a hosted service; examples can connect to a local mint. If a server uses mint URLs from untrusted input, the documentation recommends that the application perform its own trusted-mint allowlist validation.

Pricing and Support

The main documentation does not disclose commercial pricing, paid support, or an SLA, so it can be understood as an open-source collaborative development library available through npm. The project welcomes Issues and PRs, and provides community documentation, contribution guidelines, a project board, Matrix, Telegram, and weekly meeting channels. These are positive signals for community engagement, though information on enterprise-grade support is limited.

Pros, Cons, and Best Fit

Its strengths are that its functionality is relatively complete for Cashu wallet development, with rich examples, well-designed state subscriptions, and deterministic counter handling. It is suitable for developers who need to build browser-side, server-side, or hybrid Cashu wallet integrations. The downsides are that the project is still early-stage, the funding-risk warnings are prominent, most wallets are stateless, and proofs, counters, and database persistence must be handled by the application itself. Custom output generators are also mainly an escape hatch, with maintenance responsibility falling on the integrator. The source text does not provide information on accessibility from China; availability of npm, GitHub, and community channels should be verified based on the actual network environment.