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

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

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealmContractRepository = void 0;
+/**
+ * Realm-based implementation of ContractRepository.
+ *
+ * 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 RealmContractRepository {
+    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("ArkContract"));
+        });
+    }
+    // ── Contract management ────────────────────────────────────────────
+    async getContracts(filter) {
+        await this.ensureInit();
+        let results = this.realm.objects("ArkContract");
+        if (filter) {
+            const filterParts = [];
+            const filterArgs = [];
+            let argIndex = 0;
+            argIndex = this.addFilterCondition(filterParts, filterArgs, "script", filter.script, argIndex);
+            argIndex = this.addFilterCondition(filterParts, filterArgs, "state", filter.state, argIndex);
+            argIndex = this.addFilterCondition(filterParts, filterArgs, "type", filter.type, argIndex);
+            if (filterParts.length > 0) {
+                const query = filterParts.join(" AND ");
+                results = results.filtered(query, ...filterArgs);
+            }
+        }
+        return [...results].map(contractObjectToDomain);
+    }
+    async saveContract(contract) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            this.realm.create("ArkContract", {
+                script: contract.script,
+                address: contract.address,
+                type: contract.type,
+                state: contract.state,
+                paramsJson: JSON.stringify(contract.params),
+                createdAt: contract.createdAt,
+                expiresAt: contract.expiresAt ?? null,
+                label: contract.label ?? null,
+                metadataJson: contract.metadata
+                    ? JSON.stringify(contract.metadata)
+                    : null,
+            }, "modified");
+        });
+    }
+    async deleteContract(script) {
+        await this.ensureInit();
+        this.realm.write(() => {
+            const toDelete = this.realm
+                .objects("ArkContract")
+                .filtered("script == $0", script);
+            this.realm.delete(toDelete);
+        });
+    }
+    // ── Helpers ─────────────────────────────────────────────────────────
+    addFilterCondition(parts, args, column, value, argIndex) {
+        if (value === undefined)
+            return argIndex;
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return argIndex;
+            const conditions = value.map((_, i) => {
+                return `${column} == $${argIndex + i}`;
+            });
+            parts.push(`(${conditions.join(" OR ")})`);
+            args.push(...value);
+            return argIndex + value.length;
+        }
+        else {
+            parts.push(`${column} == $${argIndex}`);
+            args.push(value);
+            return argIndex + 1;
+        }
+    }
+}
+exports.RealmContractRepository = RealmContractRepository;
+// ── Realm object → Domain converter ──────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function contractObjectToDomain(obj) {
+    const contract = {
+        script: obj.script,
+        address: obj.address,
+        type: obj.type,
+        state: obj.state,
+        params: JSON.parse(obj.paramsJson),
+        createdAt: obj.createdAt,
+    };
+    if (obj.expiresAt !== null && obj.expiresAt !== undefined) {
+        contract.expiresAt = obj.expiresAt;
+    }
+    if (obj.label !== null && obj.label !== undefined) {
+        contract.label = obj.label;
+    }
+    if (obj.metadataJson !== null && obj.metadataJson !== undefined) {
+        contract.metadata = JSON.parse(obj.metadataJson);
+    }
+    return contract;
+}

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArkRealmSchemas = exports.RealmContractRepository = exports.RealmWalletRepository = void 0;
+var walletRepository_1 = require("./walletRepository");
+Object.defineProperty(exports, "RealmWalletRepository", { enumerable: true, get: function () { return walletRepository_1.RealmWalletRepository; } });
+var contractRepository_1 = require("./contractRepository");
+Object.defineProperty(exports, "RealmContractRepository", { enumerable: true, get: function () { return contractRepository_1.RealmContractRepository; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "ArkRealmSchemas", { enumerable: true, get: function () { return schemas_1.ArkRealmSchemas; } });

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

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Realm object schemas for the Ark wallet.
+ *
+ * All schema names are prefixed with "Ark" to avoid collisions with
+ * other Realm schemas in the consuming application.
+ *
+ * Since `realm` is a peer dependency (not installed in this package),
+ * schemas are defined as plain JS objects conforming to Realm's
+ * ObjectSchema shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArkRealmSchemas = exports.ArkContractSchema = exports.ArkWalletStateSchema = exports.ArkTransactionSchema = exports.ArkUtxoSchema = exports.ArkVtxoSchema = void 0;
+exports.ArkVtxoSchema = {
+    name: "ArkVtxo",
+    primaryKey: "pk",
+    properties: {
+        pk: "string", // composite: `${txid}:${vout}`
+        address: { type: "string", indexed: true },
+        txid: "string",
+        vout: "int",
+        value: "int",
+        tapTree: "string", // hex-encoded
+        forfeitCb: "string",
+        forfeitS: "string",
+        intentCb: "string",
+        intentS: "string",
+        extraWitnessJson: "string?",
+        statusJson: "string",
+        virtualStatusJson: "string",
+        spentBy: "string?",
+        settledBy: "string?",
+        arkTxId: "string?",
+        createdAt: "string", // ISO 8601
+        isUnrolled: "bool",
+        isSpent: "bool?",
+        assetsJson: "string?",
+    },
+};
+exports.ArkUtxoSchema = {
+    name: "ArkUtxo",
+    primaryKey: "pk",
+    properties: {
+        pk: "string", // composite: `${txid}:${vout}`
+        address: { type: "string", indexed: true },
+        txid: "string",
+        vout: "int",
+        value: "int",
+        tapTree: "string", // hex-encoded
+        forfeitCb: "string",
+        forfeitS: "string",
+        intentCb: "string",
+        intentS: "string",
+        extraWitnessJson: "string?",
+        statusJson: "string",
+    },
+};
+exports.ArkTransactionSchema = {
+    name: "ArkTransaction",
+    primaryKey: "pk",
+    properties: {
+        pk: "string", // composite: `${address}:${boardingTxid}:${commitmentTxid}:${arkTxid}`
+        address: { type: "string", indexed: true },
+        boardingTxid: "string",
+        commitmentTxid: "string",
+        arkTxid: "string",
+        type: "string",
+        amount: "int",
+        settled: "bool",
+        createdAt: "int",
+        assetsJson: "string?",
+    },
+};
+exports.ArkWalletStateSchema = {
+    name: "ArkWalletState",
+    primaryKey: "key",
+    properties: {
+        key: "string",
+        lastSyncTime: "int?",
+        settingsJson: "string?",
+    },
+};
+exports.ArkContractSchema = {
+    name: "ArkContract",
+    primaryKey: "script",
+    properties: {
+        script: "string",
+        address: "string",
+        type: { type: "string", indexed: true },
+        state: { type: "string", indexed: true },
+        paramsJson: "string",
+        createdAt: "int",
+        expiresAt: "int?",
+        label: "string?",
+        metadataJson: "string?",
+    },
+};
+/**
+ * All Realm schemas needed by the Ark wallet repositories.
+ * Pass this array to your Realm configuration's `schema` property.
+ */
+exports.ArkRealmSchemas = [
+    exports.ArkVtxoSchema,
+    exports.ArkUtxoSchema,
+    exports.ArkTransactionSchema,
+    exports.ArkWalletStateSchema,
+    exports.ArkContractSchema,
+];

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

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Minimal interface for the subset of the Realm API used by the
+ * Ark repositories.  Consumers pass their real Realm instance and
+ * the compiler validates it satisfies this shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealmWalletRepository = void 0;
+const serialization_1 = require("../serialization");
+/**
+ * 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,
+                }, "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 = (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(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");
+        });
+    }
+}
+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,
+    };
+    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 = JSON.parse(obj.assetsJson);
+    }
+    return tx;
+}

package/dist/cjs/repositories/serialization.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializeUtxo = exports.deserializeVtxo = exports.deserializeTapLeaf = exports.serializeUtxo = exports.serializeVtxo = 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 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),
+});
+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 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),
+});
+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;