@cashu/coco-sqlite

⚠️ Release candidate: Coco is stabilizing for v1, but breaking changes may still land before the final 1.0 release. Pin versions in production.

Node storage adapter for Coco built on better-sqlite3.

Install

npm install @cashu/coco-core @cashu/coco-sqlite better-sqlite3

Usage

import Database from 'better-sqlite3';
import { initializeCoco } from '@cashu/coco-core';
import { SqliteRepositories } from '@cashu/coco-sqlite';

const database = new Database('./coco.db');
const repositories = new SqliteRepositories({ database });
await repositories.init();

const manager = await initializeCoco({
  repo: repositories,
  seedGetter,
});

Notes

• The coco_cashu_keysets table no longer has a foreign key to coco_cashu_mints. Keysets are deleted manually in the repository when a mint is deleted. This improves compatibility with backends that cannot perform async work inside transactions (e.g., IndexedDB) and avoids FK timing issues during initial sync.