/* This file is part of GNU Taler (C) 2019 Taler Systems S.A. GNU Taler is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version. GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Taler; see the file COPYING. If not, see */ /** * Helpers to create headless wallets. * @author Florian Dold */ /** * Imports. */ import { Wallet } from "../wallet"; import { MemoryBackend, BridgeIDBFactory, shimIndexedDB, } from "@gnu-taler/idb-bridge"; import { openTalerDatabase } from "../db"; import { HttpRequestLibrary } from "../util/http"; import { NodeThreadCryptoWorkerFactory } from "../crypto/workers/nodeThreadWorker"; import { NodeHttpLib } from "./NodeHttpLib"; import { Logger } from "../util/logging"; import { SynchronousCryptoWorkerFactory } from "../crypto/workers/synchronousWorker"; import type { IDBFactory } from "@gnu-taler/idb-bridge"; import { WalletNotification } from "@gnu-taler/taler-util"; const logger = new Logger("headless/helpers.ts"); const nodejs_fs = (function () { let fs: typeof import("fs"); return function() { if (!fs) { /** * need to use an expression when doing a require if we want * webpack not to find out about the requirement */ const _r = "require" fs = module[_r]("fs") } return fs } })() export interface DefaultNodeWalletArgs { /** * Location of the wallet database. * * If not specified, the wallet starts out with an empty database and * the wallet database is stored only in memory. */ persistentStoragePath?: string; /** * Handler for asynchronous notifications from the wallet. */ notifyHandler?: (n: WalletNotification) => void; /** * If specified, use this as HTTP request library instead * of the default one. */ httpLib?: HttpRequestLibrary; } /** * Generate a random alphanumeric ID. Does *not* use cryptographically * secure randomness. */ function makeId(length: number): string { let result = ""; const characters = "abcdefghijklmnopqrstuvwxyz0123456789"; for (let i = 0; i < length; i++) { result += characters.charAt(Math.floor(Math.random() * characters.length)); } return result; } /** * Get a wallet instance with default settings for node. */ export async function getDefaultNodeWallet( args: DefaultNodeWalletArgs = {}, ): Promise { BridgeIDBFactory.enableTracing = false; const myBackend = new MemoryBackend(); myBackend.enableTracing = false; const storagePath = args.persistentStoragePath; if (storagePath) { try { const dbContentStr: string = nodejs_fs().readFileSync(storagePath, { encoding: "utf-8", }); const dbContent = JSON.parse(dbContentStr); myBackend.importDump(dbContent); } catch (e) { const code: string = e.code; if (code === "ENOENT") { logger.trace("wallet file doesn't exist yet"); } else { logger.error("could not open wallet database file"); throw e; } } myBackend.afterCommitCallback = async () => { // Allow caller to stop persisting the wallet. if (args.persistentStoragePath === undefined) { return; } const tmpPath = `${args.persistentStoragePath}-${makeId(5)}.tmp`; const dbContent = myBackend.exportDump(); nodejs_fs().writeFileSync(tmpPath, JSON.stringify(dbContent, undefined, 2), { encoding: "utf-8", }); // Atomically move the temporary file onto the DB path. nodejs_fs().renameSync(tmpPath, args.persistentStoragePath); }; } BridgeIDBFactory.enableTracing = false; const myBridgeIdbFactory = new BridgeIDBFactory(myBackend); const myIdbFactory: IDBFactory = (myBridgeIdbFactory as any) as IDBFactory; let myHttpLib; if (args.httpLib) { myHttpLib = args.httpLib; } else { myHttpLib = new NodeHttpLib(); } const myVersionChange = (): Promise => { logger.error("version change requested, should not happen"); throw Error( "BUG: wallet DB version change event can't happen with memory IDB", ); }; shimIndexedDB(myBridgeIdbFactory); const myDb = await openTalerDatabase(myIdbFactory, myVersionChange); let workerFactory; try { // Try if we have worker threads available, fails in older node versions. const _r = "require" const worker_threads = module[_r]("worker_threads"); // require("worker_threads"); workerFactory = new NodeThreadCryptoWorkerFactory(); } catch (e) { logger.warn( "worker threads not available, falling back to synchronous workers", ); workerFactory = new SynchronousCryptoWorkerFactory(); } const w = new Wallet(myDb, myHttpLib, workerFactory); if (args.notifyHandler) { w.addNotificationListener(args.notifyHandler); } return w; }