@arkade-os/sdk 0.4.26 → 0.4.28

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

@@ -1,305 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RealmWalletRepository = void 0;
-const serialization_1 = require("../serialization");
-const scriptFromAddress_1 = require("../scriptFromAddress");
-const vtxoOwnership_1 = require("../../contracts/vtxoOwnership");
-/**
- * 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.
- */
-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 = (0, serialization_1.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,
-                    script: s.script ?? 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);
-        });
-    }
-    async getVtxosForScript(script) {
-        await this.ensureInit();
-        const results = this.realm
-            .objects("ArkVtxo")
-            .filtered("script == $0", script);
-        return [...results].map(vtxoObjectToDomain);
-    }
-    async saveVtxosForScript(key, vtxos) {
-        if (!key.address) {
-            throw new Error("RealmWalletRepository requires an address");
-        }
-        for (const vtxo of vtxos) {
-            if (!(0, vtxoOwnership_1.isVtxoForScript)(vtxo, key.script)) {
-                throw new Error(`VTXO ${vtxo.txid}:${vtxo.vout} script mismatch: expected ${key.script}, got ${vtxo.script}`);
-            }
-        }
-        return this.saveVtxos(key.address, vtxos);
-    }
-    async deleteVtxosForScript(script) {
-        await this.ensureInit();
-        this.realm.write(() => {
-            const toDelete = this.realm
-                .objects("ArkVtxo")
-                .filtered("script == $0", script);
-            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 = (0, serialization_1.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((0, serialization_1.serializeAssets)(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.settingsJson) {
-            state.settings = JSON.parse(obj.settingsJson);
-        }
-        state.lastSyncTime = obj.lastSyncTime ?? undefined;
-        return state;
-    }
-    async saveWalletState(state) {
-        await this.ensureInit();
-        this.realm.write(() => {
-            this.realm.create("ArkWalletState", {
-                key: "state",
-                lastSyncTime: state.lastSyncTime,
-                settingsJson: state.settings
-                    ? JSON.stringify(state.settings)
-                    : null,
-            }, "modified");
-        });
-    }
-}
-exports.RealmWalletRepository = RealmWalletRepository;
-// ── 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,
-        // Post-migration every row has `script`, but the backfill is
-        // idempotent: derive from `address` if the legacy column is still
-        // null (e.g. the migration hasn't run yet on this handle).
-        script: obj.script ?? (0, scriptFromAddress_1.scriptFromArkAddress)(obj.address),
-    };
-    return (0, serialization_1.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 (0, serialization_1.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 = (0, serialization_1.deserializeAssets)(JSON.parse(obj.assetsJson));
-    }
-    return tx;
-}

package/dist/cjs/repositories/scriptFromAddress.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.scriptFromArkAddress = scriptFromArkAddress;
-const base_1 = require("@scure/base");
-const index_1 = require("../index");
-/**
- * Compute the hex-encoded `scriptPubKey` locking a VTXO from its owning Ark
- * address. Used by repository-layer migrations to backfill `script` on legacy
- * rows that pre-date the column (the indexer now guarantees the field, so new
- * rows never go through this path). The `script` field is required by the
- * domain type, so backfill must produce the same value the indexer would
- * have returned — which is the hex of the address's `pkScript`.
- */
-function scriptFromArkAddress(address) {
-    return base_1.hex.encode(index_1.ArkAddress.decode(address).pkScript);
-}

package/dist/cjs/repositories/serialization.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeTransaction = exports.deserializeUtxo = exports.deserializeVtxo = exports.deserializeTapLeaf = exports.serializeTransaction = exports.serializeUtxo = exports.serializeVtxo = exports.deserializeAssets = exports.serializeAssets = exports.deserializeAsset = exports.serializeAsset = exports.serializeTapLeaf = void 0;
-const base_1 = require("@scure/base");
-const btc_signer_1 = require("@scure/btc-signer");
-const serializeTapLeaf = ([cb, s,]) => ({
-    cb: base_1.hex.encode(btc_signer_1.TaprootControlBlock.encode(cb)),
-    s: base_1.hex.encode(s),
-});
-exports.serializeTapLeaf = serializeTapLeaf;
-const serializeAsset = (a) => ({
-    assetId: a.assetId,
-    amount: a.amount.toString(),
-});
-exports.serializeAsset = serializeAsset;
-// Accept legacy persisted shapes where `amount` is a `number` — pre-bigint
-// data already on disk must keep round-tripping.
-const deserializeAsset = (a) => {
-    if (typeof a.amount === "number" && !Number.isSafeInteger(a.amount)) {
-        throw new Error(`Unsafe legacy asset amount for ${a.assetId}; re-sync from the original source`);
-    }
-    return {
-        assetId: a.assetId,
-        amount: typeof a.amount === "bigint" ? a.amount : BigInt(a.amount),
-    };
-};
-exports.deserializeAsset = deserializeAsset;
-const serializeAssets = (assets) => assets?.map(exports.serializeAsset);
-exports.serializeAssets = serializeAssets;
-const deserializeAssets = (assets) => assets?.map(exports.deserializeAsset);
-exports.deserializeAssets = deserializeAssets;
-const serializeVtxo = (v) => ({
-    ...v,
-    tapTree: base_1.hex.encode(v.tapTree),
-    forfeitTapLeafScript: (0, exports.serializeTapLeaf)(v.forfeitTapLeafScript),
-    intentTapLeafScript: (0, exports.serializeTapLeaf)(v.intentTapLeafScript),
-    extraWitness: v.extraWitness?.map(base_1.hex.encode),
-    assets: (0, exports.serializeAssets)(v.assets),
-});
-exports.serializeVtxo = serializeVtxo;
-const serializeUtxo = (u) => ({
-    ...u,
-    tapTree: base_1.hex.encode(u.tapTree),
-    forfeitTapLeafScript: (0, exports.serializeTapLeaf)(u.forfeitTapLeafScript),
-    intentTapLeafScript: (0, exports.serializeTapLeaf)(u.intentTapLeafScript),
-    extraWitness: u.extraWitness?.map(base_1.hex.encode),
-});
-exports.serializeUtxo = serializeUtxo;
-const serializeTransaction = (t) => ({
-    ...t,
-    assets: (0, exports.serializeAssets)(t.assets),
-});
-exports.serializeTransaction = serializeTransaction;
-const deserializeTapLeaf = (t) => {
-    const cb = btc_signer_1.TaprootControlBlock.decode(base_1.hex.decode(t.cb));
-    const s = base_1.hex.decode(t.s);
-    return [cb, s];
-};
-exports.deserializeTapLeaf = deserializeTapLeaf;
-const deserializeVtxo = (o) => ({
-    ...o,
-    createdAt: new Date(o.createdAt),
-    tapTree: base_1.hex.decode(o.tapTree),
-    forfeitTapLeafScript: (0, exports.deserializeTapLeaf)(o.forfeitTapLeafScript),
-    intentTapLeafScript: (0, exports.deserializeTapLeaf)(o.intentTapLeafScript),
-    extraWitness: o.extraWitness?.map(base_1.hex.decode),
-    assets: (0, exports.deserializeAssets)(o.assets),
-});
-exports.deserializeVtxo = deserializeVtxo;
-const deserializeUtxo = (o) => ({
-    ...o,
-    tapTree: base_1.hex.decode(o.tapTree),
-    forfeitTapLeafScript: (0, exports.deserializeTapLeaf)(o.forfeitTapLeafScript),
-    intentTapLeafScript: (0, exports.deserializeTapLeaf)(o.intentTapLeafScript),
-    extraWitness: o.extraWitness?.map(base_1.hex.decode),
-});
-exports.deserializeUtxo = deserializeUtxo;
-const deserializeTransaction = (o) => ({
-    ...o,
-    assets: (0, exports.deserializeAssets)(o.assets),
-});
-exports.deserializeTransaction = deserializeTransaction;

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

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLiteContractRepository = void 0;
-/**
- * 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.
- */
-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, label, metadata_json)
-             VALUES (?, ?, ?, ?, ?,
-                     ?, ?, ?)`, [
-            contract.script,
-            contract.address,
-            contract.type,
-            contract.state,
-            JSON.stringify(contract.params),
-            contract.createdAt,
-            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);
-        }
-    }
-}
-exports.SQLiteContractRepository = SQLiteContractRepository;
-// ── 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.label !== null) {
-        contract.label = row.label;
-    }
-    if (row.metadata_json !== null) {
-        contract.metadata = JSON.parse(row.metadata_json);
-    }
-    return contract;
-}

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

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLiteContractRepository = exports.SQLiteWalletRepository = void 0;
-var walletRepository_1 = require("./walletRepository");
-Object.defineProperty(exports, "SQLiteWalletRepository", { enumerable: true, get: function () { return walletRepository_1.SQLiteWalletRepository; } });
-var contractRepository_1 = require("./contractRepository");
-Object.defineProperty(exports, "SQLiteContractRepository", { enumerable: true, get: function () { return contractRepository_1.SQLiteContractRepository; } });

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

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });