@arkade-os/sdk 0.4.0-next.0 → 0.4.0-next.1

package/dist/esm/repositories/realm/walletRepository.js

@@ -0,0 +1,269 @@
+import { serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, } from '../serialization.js';
+/**
+ * Realm-based implementation of WalletRepository.
+ *
+ * Consumers must open Realm with the schemas from `./schemas.ts` and pass
+ * the instance to the constructor.
+ *
+ * Realm handles schema creation on open, so `ensureInit()` is a no-op.
+ * The consumer owns the Realm lifecycle — `[Symbol.asyncDispose]` is a no-op.
+ */
+export class RealmWalletRepository {
+    constructor(realm) {
+        this.realm = realm;
+        this.version = 1;
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────
+    async ensureInit() {
+        // Realm handles schema on open — nothing to initialise.
+    }
+    async [Symbol.asyncDispose]() {
+        // no-op — consumer owns the Realm lifecycle
+    }
+    // ── Clear ──────────────────────────────────────────────────────────
+    async clear() {
+        await this.ensureInit();
+        this.realm.write(() => {
+            this.realm.delete(this.realm.objects("ArkVtxo"));
+            this.realm.delete(this.realm.objects("ArkUtxo"));
+            this.realm.delete(this.realm.objects("ArkTransaction"));
+            this.realm.delete(this.realm.objects("ArkWalletState"));
+        });
+    }
+    // ── VTXO management ────────────────────────────────────────────────
+    async getVtxos(address) {
+        await this.ensureInit();
+        const results = this.realm
+            .objects("ArkVtxo")
+            .filtered("address == $0", address);
+        return [...results].map(vtxoObjectToDomain);
+    }
+    async saveVtxos(address, vtxos) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            for (const vtxo of vtxos) {
+                const s = serializeVtxo(vtxo);
+                this.realm.create("ArkVtxo", {
+                    pk: `${s.txid}:${s.vout}`,
+                    address,
+                    txid: s.txid,
+                    vout: s.vout,
+                    value: s.value,
+                    tapTree: s.tapTree,
+                    forfeitCb: s.forfeitTapLeafScript.cb,
+                    forfeitS: s.forfeitTapLeafScript.s,
+                    intentCb: s.intentTapLeafScript.cb,
+                    intentS: s.intentTapLeafScript.s,
+                    statusJson: JSON.stringify(s.status),
+                    virtualStatusJson: JSON.stringify(s.virtualStatus),
+                    createdAt: typeof s.createdAt === "string"
+                        ? s.createdAt
+                        : s.createdAt instanceof Date
+                            ? s.createdAt.toISOString()
+                            : new Date(s.createdAt).toISOString(),
+                    isUnrolled: s.isUnrolled ?? false,
+                    isSpent: s.isSpent === undefined ? null : s.isSpent,
+                    spentBy: s.spentBy ?? null,
+                    settledBy: s.settledBy ?? null,
+                    arkTxId: s.arkTxId ?? null,
+                    extraWitnessJson: s.extraWitness
+                        ? JSON.stringify(s.extraWitness)
+                        : null,
+                    assetsJson: s.assets ? JSON.stringify(s.assets) : null,
+                }, "modified");
+            }
+        });
+    }
+    async deleteVtxos(address) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            const toDelete = this.realm
+                .objects("ArkVtxo")
+                .filtered("address == $0", address);
+            this.realm.delete(toDelete);
+        });
+    }
+    // ── UTXO management ────────────────────────────────────────────────
+    async getUtxos(address) {
+        await this.ensureInit();
+        const results = this.realm
+            .objects("ArkUtxo")
+            .filtered("address == $0", address);
+        return [...results].map(utxoObjectToDomain);
+    }
+    async saveUtxos(address, utxos) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            for (const utxo of utxos) {
+                const s = serializeUtxo(utxo);
+                this.realm.create("ArkUtxo", {
+                    pk: `${s.txid}:${s.vout}`,
+                    address,
+                    txid: s.txid,
+                    vout: s.vout,
+                    value: s.value,
+                    tapTree: s.tapTree,
+                    forfeitCb: s.forfeitTapLeafScript.cb,
+                    forfeitS: s.forfeitTapLeafScript.s,
+                    intentCb: s.intentTapLeafScript.cb,
+                    intentS: s.intentTapLeafScript.s,
+                    statusJson: JSON.stringify(s.status),
+                    extraWitnessJson: s.extraWitness
+                        ? JSON.stringify(s.extraWitness)
+                        : null,
+                }, "modified");
+            }
+        });
+    }
+    async deleteUtxos(address) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            const toDelete = this.realm
+                .objects("ArkUtxo")
+                .filtered("address == $0", address);
+            this.realm.delete(toDelete);
+        });
+    }
+    // ── Transaction history ────────────────────────────────────────────
+    async getTransactionHistory(address) {
+        await this.ensureInit();
+        const results = this.realm
+            .objects("ArkTransaction")
+            .filtered("address == $0", address);
+        const txs = [...results].map(txObjectToDomain);
+        txs.sort((a, b) => a.createdAt - b.createdAt);
+        return txs;
+    }
+    async saveTransactions(address, txs) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            for (const tx of txs) {
+                this.realm.create("ArkTransaction", {
+                    pk: `${address}:${tx.key.boardingTxid}:${tx.key.commitmentTxid}:${tx.key.arkTxid}`,
+                    address,
+                    boardingTxid: tx.key.boardingTxid,
+                    commitmentTxid: tx.key.commitmentTxid,
+                    arkTxid: tx.key.arkTxid,
+                    type: tx.type,
+                    amount: tx.amount,
+                    settled: tx.settled,
+                    createdAt: tx.createdAt,
+                    assetsJson: tx.assets
+                        ? JSON.stringify(tx.assets)
+                        : null,
+                }, "modified");
+            }
+        });
+    }
+    async deleteTransactions(address) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            const toDelete = this.realm
+                .objects("ArkTransaction")
+                .filtered("address == $0", address);
+            this.realm.delete(toDelete);
+        });
+    }
+    // ── Wallet state ───────────────────────────────────────────────────
+    async getWalletState() {
+        await this.ensureInit();
+        const results = this.realm
+            .objects("ArkWalletState")
+            .filtered("key == $0", "state");
+        const items = [...results];
+        if (items.length === 0)
+            return null;
+        const obj = items[0];
+        const state = {};
+        if (obj.lastSyncTime !== null && obj.lastSyncTime !== undefined) {
+            state.lastSyncTime = obj.lastSyncTime;
+        }
+        if (obj.settingsJson) {
+            state.settings = JSON.parse(obj.settingsJson);
+        }
+        return state;
+    }
+    async saveWalletState(state) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            this.realm.create("ArkWalletState", {
+                key: "state",
+                lastSyncTime: state.lastSyncTime ?? null,
+                settingsJson: state.settings
+                    ? JSON.stringify(state.settings)
+                    : null,
+            }, "modified");
+        });
+    }
+}
+// ── Realm object → Domain converters ─────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function vtxoObjectToDomain(obj) {
+    const serialized = {
+        txid: obj.txid,
+        vout: obj.vout,
+        value: obj.value,
+        tapTree: obj.tapTree,
+        forfeitTapLeafScript: {
+            cb: obj.forfeitCb,
+            s: obj.forfeitS,
+        },
+        intentTapLeafScript: {
+            cb: obj.intentCb,
+            s: obj.intentS,
+        },
+        status: JSON.parse(obj.statusJson),
+        virtualStatus: JSON.parse(obj.virtualStatusJson),
+        createdAt: new Date(obj.createdAt),
+        isUnrolled: obj.isUnrolled,
+        isSpent: obj.isSpent === null ? undefined : obj.isSpent,
+        spentBy: obj.spentBy ?? undefined,
+        settledBy: obj.settledBy ?? undefined,
+        arkTxId: obj.arkTxId ?? undefined,
+        extraWitness: obj.extraWitnessJson
+            ? JSON.parse(obj.extraWitnessJson)
+            : undefined,
+        assets: obj.assetsJson ? JSON.parse(obj.assetsJson) : undefined,
+    };
+    return deserializeVtxo(serialized);
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function utxoObjectToDomain(obj) {
+    const serialized = {
+        txid: obj.txid,
+        vout: obj.vout,
+        value: obj.value,
+        tapTree: obj.tapTree,
+        forfeitTapLeafScript: {
+            cb: obj.forfeitCb,
+            s: obj.forfeitS,
+        },
+        intentTapLeafScript: {
+            cb: obj.intentCb,
+            s: obj.intentS,
+        },
+        status: JSON.parse(obj.statusJson),
+        extraWitness: obj.extraWitnessJson
+            ? JSON.parse(obj.extraWitnessJson)
+            : undefined,
+    };
+    return deserializeUtxo(serialized);
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function txObjectToDomain(obj) {
+    const tx = {
+        key: {
+            boardingTxid: obj.boardingTxid,
+            commitmentTxid: obj.commitmentTxid,
+            arkTxid: obj.arkTxid,
+        },
+        type: obj.type,
+        amount: obj.amount,
+        settled: obj.settled,
+        createdAt: obj.createdAt,
+    };
+    if (obj.assetsJson) {
+        tx.assets = JSON.parse(obj.assetsJson);
+    }
+    return tx;
+}

package/dist/esm/repositories/serialization.js

@@ -0,0 +1,40 @@
+import { hex } from "@scure/base";
+import { TaprootControlBlock } from "@scure/btc-signer";
+export const serializeTapLeaf = ([cb, s,]) => ({
+    cb: hex.encode(TaprootControlBlock.encode(cb)),
+    s: hex.encode(s),
+});
+export const serializeVtxo = (v) => ({
+    ...v,
+    tapTree: hex.encode(v.tapTree),
+    forfeitTapLeafScript: serializeTapLeaf(v.forfeitTapLeafScript),
+    intentTapLeafScript: serializeTapLeaf(v.intentTapLeafScript),
+    extraWitness: v.extraWitness?.map(hex.encode),
+});
+export const serializeUtxo = (u) => ({
+    ...u,
+    tapTree: hex.encode(u.tapTree),
+    forfeitTapLeafScript: serializeTapLeaf(u.forfeitTapLeafScript),
+    intentTapLeafScript: serializeTapLeaf(u.intentTapLeafScript),
+    extraWitness: u.extraWitness?.map(hex.encode),
+});
+export const deserializeTapLeaf = (t) => {
+    const cb = TaprootControlBlock.decode(hex.decode(t.cb));
+    const s = hex.decode(t.s);
+    return [cb, s];
+};
+export const deserializeVtxo = (o) => ({
+    ...o,
+    createdAt: new Date(o.createdAt),
+    tapTree: hex.decode(o.tapTree),
+    forfeitTapLeafScript: deserializeTapLeaf(o.forfeitTapLeafScript),
+    intentTapLeafScript: deserializeTapLeaf(o.intentTapLeafScript),
+    extraWitness: o.extraWitness?.map(hex.decode),
+});
+export const deserializeUtxo = (o) => ({
+    ...o,
+    tapTree: hex.decode(o.tapTree),
+    forfeitTapLeafScript: deserializeTapLeaf(o.forfeitTapLeafScript),
+    intentTapLeafScript: deserializeTapLeaf(o.intentTapLeafScript),
+    extraWitness: o.extraWitness?.map(hex.decode),
+});

package/dist/esm/repositories/sqlite/contractRepository.js

@@ -0,0 +1,135 @@
+/**
+ * SQLite-based implementation of ContractRepository.
+ *
+ * Uses the SQLExecutor interface so consumers can plug in any SQLite driver
+ * (expo-sqlite, better-sqlite3, etc.).
+ *
+ * Tables are created lazily on first operation via `ensureInit()`.
+ * The consumer owns the SQLExecutor lifecycle — `[Symbol.asyncDispose]` is a no-op.
+ */
+export class SQLiteContractRepository {
+    constructor(db, options) {
+        this.db = db;
+        this.version = 1;
+        this.initPromise = null;
+        this.prefix = sanitizePrefix(options?.prefix ?? "ark_");
+        this.table = `${this.prefix}contracts`;
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────
+    ensureInit() {
+        if (!this.initPromise) {
+            this.initPromise = this.init();
+        }
+        return this.initPromise;
+    }
+    async init() {
+        await this.db.run(`
+            CREATE TABLE IF NOT EXISTS ${this.table} (
+                script TEXT PRIMARY KEY,
+                address TEXT NOT NULL,
+                type TEXT NOT NULL,
+                state TEXT NOT NULL,
+                params_json TEXT NOT NULL,
+                created_at INTEGER NOT NULL,
+                expires_at INTEGER,
+                label TEXT,
+                metadata_json TEXT
+            )
+        `);
+        await this.db.run(`CREATE INDEX IF NOT EXISTS idx_${this.prefix}contracts_type ON ${this.table} (type)`);
+        await this.db.run(`CREATE INDEX IF NOT EXISTS idx_${this.prefix}contracts_state ON ${this.table} (state)`);
+    }
+    async [Symbol.asyncDispose]() {
+        // no-op — consumer owns the SQLExecutor lifecycle
+    }
+    // ── Clear ──────────────────────────────────────────────────────────
+    async clear() {
+        await this.ensureInit();
+        await this.db.run(`DELETE FROM ${this.table}`);
+    }
+    // ── Contract management ────────────────────────────────────────────
+    async getContracts(filter) {
+        await this.ensureInit();
+        const conditions = [];
+        const params = [];
+        if (filter) {
+            this.addFilterCondition(conditions, params, "script", filter.script);
+            this.addFilterCondition(conditions, params, "state", filter.state);
+            this.addFilterCondition(conditions, params, "type", filter.type);
+        }
+        let sql = `SELECT * FROM ${this.table}`;
+        if (conditions.length > 0) {
+            sql += ` WHERE ${conditions.join(" AND ")}`;
+        }
+        const rows = await this.db.all(sql, params);
+        return rows.map(contractRowToDomain);
+    }
+    async saveContract(contract) {
+        await this.ensureInit();
+        await this.db.run(`INSERT OR REPLACE INTO ${this.table}
+                (script, address, type, state, params_json,
+                 created_at, expires_at, label, metadata_json)
+             VALUES (?, ?, ?, ?, ?,
+                     ?, ?, ?, ?)`, [
+            contract.script,
+            contract.address,
+            contract.type,
+            contract.state,
+            JSON.stringify(contract.params),
+            contract.createdAt,
+            contract.expiresAt ?? null,
+            contract.label ?? null,
+            contract.metadata ? JSON.stringify(contract.metadata) : null,
+        ]);
+    }
+    async deleteContract(script) {
+        await this.ensureInit();
+        await this.db.run(`DELETE FROM ${this.table} WHERE script = ?`, [
+            script,
+        ]);
+    }
+    // ── Helpers ─────────────────────────────────────────────────────────
+    addFilterCondition(conditions, params, column, value) {
+        if (value === undefined)
+            return;
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return;
+            const placeholders = value.map(() => "?").join(", ");
+            conditions.push(`${column} IN (${placeholders})`);
+            params.push(...value);
+        }
+        else {
+            conditions.push(`${column} = ?`);
+            params.push(value);
+        }
+    }
+}
+// ── Row → Domain converter ──────────────────────────────────────────────
+const SAFE_PREFIX = /^[a-zA-Z0-9_]+$/;
+function sanitizePrefix(prefix) {
+    if (!SAFE_PREFIX.test(prefix)) {
+        throw new Error(`Invalid table prefix "${prefix}": only letters, digits, and underscores are allowed`);
+    }
+    return prefix;
+}
+function contractRowToDomain(row) {
+    const contract = {
+        script: row.script,
+        address: row.address,
+        type: row.type,
+        state: row.state,
+        params: JSON.parse(row.params_json),
+        createdAt: row.created_at,
+    };
+    if (row.expires_at !== null) {
+        contract.expiresAt = row.expires_at;
+    }
+    if (row.label !== null) {
+        contract.label = row.label;
+    }
+    if (row.metadata_json !== null) {
+        contract.metadata = JSON.parse(row.metadata_json);
+    }
+    return contract;
+}

package/dist/esm/repositories/sqlite/index.js

@@ -0,0 +1,2 @@
+export { SQLiteWalletRepository } from './walletRepository.js';
+export { SQLiteContractRepository } from './contractRepository.js';

package/dist/esm/repositories/sqlite/types.js

@@ -0,0 +1 @@
+export {};