webycash-sdk 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export declare class WebycashError extends Error {
+    code: number;
+    constructor(code: number, message: string);
+}
+export declare function version(): string;
+export declare function amountParse(s: string): bigint;
+export declare function amountFormat(wats: bigint): string;
+export declare class Wallet {
+    private ptr;
+    constructor(dbPath: string, seed?: Buffer);
+    close(): void;
+    balance(): string;
+    insert(webcash: string): void;
+    pay(amount: string, memo?: string): string;
+    check(): void;
+    merge(maxOutputs?: number): string;
+    recover(masterSecretHex: string, gapLimit?: number): string;
+    stats(): string;
+    exportSnapshot(): string;
+    encryptSeed(password: string): void;
+}

package/dist/index.js

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Wallet = exports.WebycashError = void 0;
+exports.version = version;
+exports.amountParse = amountParse;
+exports.amountFormat = amountFormat;
+const koffi_1 = __importDefault(require("koffi"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const LIB_NAME = {
+    linux: "libwebycash_sdk.so",
+    darwin: "libwebycash_sdk.dylib",
+    win32: "webycash_sdk.dll",
+};
+function findLib() {
+    const name = LIB_NAME[os_1.default.platform()];
+    if (!name)
+        throw new Error(`Unsupported platform: ${os_1.default.platform()}`);
+    // Check next to this module first
+    const local = path_1.default.join(__dirname, "..", name);
+    try {
+        require("fs").accessSync(local);
+        return local;
+    }
+    catch { }
+    return name; // Fall back to system search
+}
+const lib = koffi_1.default.load(findLib());
+// ── FFI declarations ────────────────────────────────────────────
+const WebyWalletPtr = koffi_1.default.pointer("WebyWallet", koffi_1.default.opaque());
+const WebyWalletPtrPtr = koffi_1.default.pointer(WebyWalletPtr);
+const CharPtrPtr = koffi_1.default.pointer("char*", koffi_1.default.pointer(koffi_1.default.types.char));
+const ffi = {
+    weby_wallet_open: lib.func("int32_t weby_wallet_open(const char*, _Out_ WebyWallet**)"),
+    weby_wallet_open_with_seed: lib.func("int32_t weby_wallet_open_with_seed(const char*, const uint8_t*, size_t, _Out_ WebyWallet**)"),
+    weby_wallet_free: lib.func("void weby_wallet_free(WebyWallet*)"),
+    weby_wallet_balance: lib.func("int32_t weby_wallet_balance(const WebyWallet*, _Out_ char**)"),
+    weby_wallet_insert: lib.func("int32_t weby_wallet_insert(const WebyWallet*, const char*)"),
+    weby_wallet_pay: lib.func("int32_t weby_wallet_pay(const WebyWallet*, const char*, const char*, _Out_ char**)"),
+    weby_wallet_check: lib.func("int32_t weby_wallet_check(const WebyWallet*)"),
+    weby_wallet_merge: lib.func("int32_t weby_wallet_merge(const WebyWallet*, uint32_t, _Out_ char**)"),
+    weby_wallet_recover: lib.func("int32_t weby_wallet_recover(const WebyWallet*, const char*, uint32_t, _Out_ char**)"),
+    weby_wallet_stats: lib.func("int32_t weby_wallet_stats(const WebyWallet*, _Out_ char**)"),
+    weby_wallet_export_snapshot: lib.func("int32_t weby_wallet_export_snapshot(const WebyWallet*, _Out_ char**)"),
+    weby_wallet_encrypt_seed: lib.func("int32_t weby_wallet_encrypt_seed(const WebyWallet*, const char*)"),
+    weby_version: lib.func("const char* weby_version()"),
+    weby_last_error_message: lib.func("const char* weby_last_error_message()"),
+    weby_amount_parse: lib.func("int32_t weby_amount_parse(const char*, _Out_ int64_t*)"),
+    weby_amount_format: lib.func("int32_t weby_amount_format(int64_t, _Out_ char**)"),
+    weby_free_string: lib.func("void weby_free_string(char*)"),
+};
+// ── Helpers ─────────────────────────────────────────────────────
+class WebycashError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "WebycashError";
+    }
+}
+exports.WebycashError = WebycashError;
+function check(rc) {
+    if (rc !== 0) {
+        const msg = ffi.weby_last_error_message();
+        throw new WebycashError(rc, msg ?? `Error code ${rc}`);
+    }
+}
+function takeString(ptr) {
+    if (!ptr)
+        return "";
+    const s = koffi_1.default.decode(ptr, "char*");
+    ffi.weby_free_string(ptr);
+    return s;
+}
+// ── Public API ──────────────────────────────────────────────────
+function version() {
+    return ffi.weby_version();
+}
+function amountParse(s) {
+    const out = [BigInt(0)];
+    check(ffi.weby_amount_parse(s, out));
+    return out[0];
+}
+function amountFormat(wats) {
+    const out = [null];
+    check(ffi.weby_amount_format(wats, out));
+    return takeString(out[0]);
+}
+class Wallet {
+    constructor(dbPath, seed) {
+        const out = [null];
+        if (seed) {
+            if (seed.length !== 32)
+                throw new Error("seed must be 32 bytes");
+            check(ffi.weby_wallet_open_with_seed(dbPath, seed, seed.length, out));
+        }
+        else {
+            check(ffi.weby_wallet_open(dbPath, out));
+        }
+        this.ptr = out[0];
+    }
+    close() {
+        if (this.ptr) {
+            ffi.weby_wallet_free(this.ptr);
+            this.ptr = null;
+        }
+    }
+    balance() {
+        const out = [null];
+        check(ffi.weby_wallet_balance(this.ptr, out));
+        return takeString(out[0]);
+    }
+    insert(webcash) {
+        check(ffi.weby_wallet_insert(this.ptr, webcash));
+    }
+    pay(amount, memo = "") {
+        const out = [null];
+        check(ffi.weby_wallet_pay(this.ptr, amount, memo, out));
+        return takeString(out[0]);
+    }
+    check() {
+        check(ffi.weby_wallet_check(this.ptr));
+    }
+    merge(maxOutputs = 20) {
+        const out = [null];
+        check(ffi.weby_wallet_merge(this.ptr, maxOutputs, out));
+        return takeString(out[0]);
+    }
+    recover(masterSecretHex, gapLimit = 20) {
+        const out = [null];
+        check(ffi.weby_wallet_recover(this.ptr, masterSecretHex, gapLimit, out));
+        return takeString(out[0]);
+    }
+    stats() {
+        const out = [null];
+        check(ffi.weby_wallet_stats(this.ptr, out));
+        return takeString(out[0]);
+    }
+    exportSnapshot() {
+        const out = [null];
+        check(ffi.weby_wallet_export_snapshot(this.ptr, out));
+        return takeString(out[0]);
+    }
+    encryptSeed(password) {
+        check(ffi.weby_wallet_encrypt_seed(this.ptr, password));
+    }
+}
+exports.Wallet = Wallet;

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "webycash-sdk",
+  "version": "0.1.1",
+  "description": "Webcash cross-platform SDK — Node.js/TypeScript bindings",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": "https://github.com/webycash/webycash-sdk",
+  "keywords": ["webcash", "wallet", "sdk", "payments"],
+  "files": ["dist", "*.so", "*.dylib", "*.dll"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "koffi": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5.4"
+  }
+}