@hardkas/toolkit 0.11.1-alpha

package/dist/indexer.js

@@ -0,0 +1,111 @@
+import { EventSubscriber } from '@hardkas/core';
+import { ProjectionStoreJson } from '@hardkas/query-store';
+import { ArtifactIndexStoreJson } from '@hardkas/artifacts';
+import { DagApi } from './dag/index.js';
+export class IndexerToolkit {
+    options;
+    subscriber;
+    projection;
+    artifactIndex;
+    dag;
+    backend;
+    constructor(options) {
+        this.options = options;
+        this.subscriber = new EventSubscriber();
+        this.backend = options.backend;
+        if (!this.backend || !this.backend.capabilities.externalState) {
+            this.projection = new ProjectionStoreJson({
+                dirPath: options.dataDir ? `${options.dataDir}/projections` : '.hardkas/indexer/projections',
+                namespace: 'indexer'
+            });
+            this.artifactIndex = new ArtifactIndexStoreJson({
+                filePath: options.dataDir ? `${options.dataDir}/artifacts.json` : '.hardkas/indexer/artifacts.json'
+            });
+        }
+        this.dag = new DagApi();
+    }
+    static open(options = {}) {
+        return new IndexerToolkit(options);
+    }
+    async connect() {
+        if (this.backend?.connect) {
+            await this.backend.connect();
+        }
+    }
+    async watch(address) {
+        // Polling wrapper as per V1 rules.
+        this.subscriber.subscribe({
+            source: {}, // mock source for facade
+            type: "payment",
+            intervalMs: 1000,
+            watchedAddresses: [address],
+            handler: async (evt) => {
+                // Internally updates projections if address is involved
+            }
+        });
+    }
+    async balance(address) {
+        if (this.backend?.balance) {
+            return this.backend.balance(address);
+        }
+        const balances = this.projection?.get('balances') || {};
+        return BigInt(balances[address] || 0);
+    }
+    async history(address) {
+        if (this.backend?.history) {
+            return this.backend.history(address);
+        }
+        const history = this.projection?.get('history') || {};
+        return history[address] || [];
+    }
+    async findReceipts(opts) {
+        if (!this.artifactIndex)
+            return [];
+        return this.artifactIndex.find(opts);
+    }
+    async ingestArtifact(artifact) {
+        if (!this.artifactIndex)
+            return;
+        this.artifactIndex.index({
+            hash: artifact.id || 'mock_hash',
+            schema: artifact.schema || 'unknown.v1',
+            timestamp: new Date().toISOString(),
+            filePath: `/mock/path/${artifact.id}.json`,
+            tags: artifact.tags || []
+        });
+    }
+    async snapshot() {
+        if (this.backend && !this.backend.capabilities.snapshots && this.backend.capabilities.externalState) {
+            return {
+                backend: this.backend.name,
+                externalState: true,
+                snapshots: false,
+                dag: await this.dag.snapshot()
+            };
+        }
+        return {
+            projection: this.projection?.getAll() || {},
+            artifactIndex: this.artifactIndex?.getAll() || [],
+            dag: await this.dag.snapshot()
+        };
+    }
+    async restore(state) {
+        if (state.externalState) {
+            // Cannot restore local state over an external backend. Just restore DAG.
+            if (state.dag)
+                await this.dag.restore(state.dag);
+            return;
+        }
+        if (state.projection && this.projection)
+            this.projection.setAll(state.projection);
+        if (state.artifactIndex && this.artifactIndex)
+            this.artifactIndex.setAll(state.artifactIndex);
+        if (state.dag)
+            await this.dag.restore(state.dag);
+    }
+    async reload() {
+        await this.dag.reload();
+        // Projection and artifactIndex read synchronously from memory in this version
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"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"}

package/dist/jobs.d.ts

@@ -0,0 +1,18 @@
+import { JobHandler, JobRecord } from '@hardkas/jobs';
+import { SnapshotParticipant, SnapshotState } from './snapshot/types.js';
+export interface JobsToolkitOptions {
+    storePath?: string;
+}
+export declare class JobsToolkit implements SnapshotParticipant {
+    private runner;
+    private store;
+    private constructor();
+    static open(options?: JobsToolkitOptions): JobsToolkit;
+    registerHandler(type: string, handler: JobHandler): void;
+    enqueue(type: string, args?: any): Promise<string>;
+    getJob(id: string): Promise<JobRecord | undefined>;
+    snapshot(): Promise<SnapshotState>;
+    restore(state: SnapshotState): Promise<void>;
+    reload(): Promise<void>;
+}
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAY,YAAW,mBAAmB;IACnD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAe;IAE5B,OAAO;WAKO,IAAI,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW;IAI1D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAIlD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIlD,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAIlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/jobs.js

@@ -0,0 +1,33 @@
+import { JobRunner, JobStoreJson } from '@hardkas/jobs';
+export class JobsToolkit {
+    runner;
+    store;
+    constructor(options) {
+        this.store = new JobStoreJson({ filePath: options.storePath || '.hardkas-data/jobs.json' });
+        this.runner = new JobRunner({ store: this.store });
+    }
+    static open(options = {}) {
+        return new JobsToolkit(options);
+    }
+    registerHandler(type, handler) {
+        this.runner.registerHandler(type, handler);
+    }
+    async enqueue(type, args) {
+        return this.runner.enqueue(type, args);
+    }
+    async getJob(id) {
+        return this.runner.getJob(id);
+    }
+    async snapshot() {
+        return this.store.getAll();
+    }
+    async restore(state) {
+        this.store.setAll(state);
+    }
+    async reload() {
+        // Runner reads from store on each operation natively in current design,
+        // but if it had internal queues/caches, we'd clear them here.
+        // E.g., this.runner.clearCache();
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAyB,MAAM,eAAe,CAAC;AAO/E,MAAM,OAAO,WAAW;IACZ,MAAM,CAAY;IAClB,KAAK,CAAe;IAE5B,YAAoB,OAA2B;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,UAA8B,EAAE;QAC/C,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAEM,eAAe,CAAC,IAAY,EAAE,OAAmB;QACpD,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAU;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAAoB;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAkC,CAAC,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,MAAM;QACf,wEAAwE;QACxE,8DAA8D;QAC9D,kCAAkC;IACtC,CAAC;CACJ"}

package/dist/payment.d.ts

@@ -0,0 +1,25 @@
+import { InvoiceRecord } from './stores/invoice-store.js';
+export interface PaymentToolkitOptions {
+    storePath?: string;
+}
+export declare class PaymentToolkit {
+    readonly merchantId: string;
+    private readonly options;
+    private store;
+    private constructor();
+    static openMerchant(merchantId: string, options?: PaymentToolkitOptions): PaymentToolkit;
+    createInvoice(opts: {
+        amount: bigint;
+        currency: string;
+    }): Promise<InvoiceRecord>;
+    getInvoice(id: string): Promise<InvoiceRecord | undefined>;
+    listInvoices(): Promise<InvoiceRecord[]>;
+    stats(): Promise<{
+        totalInvoices: number;
+        paidInvoices: number;
+    }>;
+    check(invoiceId: string): Promise<string>;
+    receipt(invoiceId: string): Promise<any>;
+    simulatePay(invoiceId: string): Promise<void>;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;aAIH,UAAU,EAAE,MAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ5B,OAAO,CAAC,KAAK,CAAmB;IAEhC,OAAO;WAOO,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc;IAItF,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAI1D,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIxC,KAAK,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAWxC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7D"}

package/dist/payment.js

@@ -0,0 +1,66 @@
+import { buildKaspaUri } from '@hardkas/tx-builder';
+import { InvoiceStoreJson } from './stores/invoice-store.js';
+export class PaymentToolkit {
+    merchantId;
+    options;
+    store;
+    constructor(merchantId, options) {
+        this.merchantId = merchantId;
+        this.options = options;
+        this.store = new InvoiceStoreJson({ filePath: options.storePath || '.hardkas-data/invoices.json' });
+    }
+    static openMerchant(merchantId, options = {}) {
+        return new PaymentToolkit(merchantId, options);
+    }
+    async createInvoice(opts) {
+        const id = `inv_${Date.now()}`;
+        const result = buildKaspaUri({
+            address: `kaspa:${this.merchantId}`,
+            amountSompi: opts.amount * 100000000n, // convert to sompi
+            message: `Invoice ${id}`
+        });
+        const invoice = {
+            id,
+            merchantId: this.merchantId,
+            amount: opts.amount,
+            currency: opts.currency,
+            status: 'pending',
+            uri: result.uri,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        };
+        this.store.save(invoice);
+        return invoice;
+    }
+    async getInvoice(id) {
+        return this.store.get(id);
+    }
+    async listInvoices() {
+        return this.store.listByMerchant(this.merchantId);
+    }
+    async stats() {
+        return this.store.stats(this.merchantId);
+    }
+    async check(invoiceId) {
+        const inv = this.store.get(invoiceId);
+        return inv ? inv.status : 'not_found';
+    }
+    async receipt(invoiceId) {
+        return {
+            schema: "paymentReceipt.v1",
+            invoiceId,
+            merchantId: this.merchantId,
+            status: "paid",
+            timestamp: new Date().toISOString()
+        };
+    }
+    // For lab testing/simulation manually paying an invoice
+    async simulatePay(invoiceId) {
+        const inv = this.store.get(invoiceId);
+        if (inv) {
+            inv.status = 'paid';
+            this.store.save(inv);
+        }
+    }
+}
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,2BAA2B,CAAC;AAM5E,MAAM,OAAO,cAAc;IAIH;IACC;IAJb,KAAK,CAAmB;IAEhC,YACoB,UAAkB,EACjB,OAA8B;QAD/B,eAAU,GAAV,UAAU,CAAQ;QACjB,YAAO,GAAP,OAAO,CAAuB;QAE/C,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,IAAI,6BAA6B,EAAE,CAAC,CAAC;IACxG,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,UAAkB,EAAE,UAAiC,EAAE;QAC9E,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,IAA0C;QACjE,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,aAAa,CAAC;YACzB,OAAO,EAAE,SAAS,IAAI,CAAC,UAAU,EAAE;YACnC,WAAW,EAAE,IAAI,CAAC,MAAM,GAAG,UAAY,EAAE,mBAAmB;YAC5D,OAAO,EAAE,WAAW,EAAE,EAAE;SAC3B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAkB;YAC3B,EAAE;YACF,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,SAAS;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,EAAU;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,YAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,KAAK;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,SAAiB;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,SAAiB;QAClC,OAAO;YACH,MAAM,EAAE,mBAAmB;YAC3B,SAAS;YACT,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACN,CAAC;IAED,wDAAwD;IACjD,KAAK,CAAC,WAAW,CAAC,SAAiB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACN,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;CACJ"}

package/dist/silver/index.d.ts

@@ -0,0 +1,20 @@
+import { SilverArtifact, SilverBuildResult, SilverEvidence, SilverSimulationResult } from './types.js';
+export declare class SilverTemplate {
+    readonly name: string;
+    private readonly rawSource;
+    constructor(name: string, rawSource: string);
+    parameters(): string[];
+    fill(params: Record<string, string | number>): string;
+}
+export declare class SilverToolkit {
+    private constructor();
+    static open(): SilverToolkit;
+    private getClaims;
+    templates(): string[];
+    template(name: string): SilverTemplate;
+    build(source: string): Promise<SilverBuildResult>;
+    simulate(build: SilverBuildResult, args?: string[]): Promise<SilverSimulationResult>;
+    artifact(build: SilverBuildResult, name?: string): Promise<SilverArtifact>;
+    evidence(build: SilverBuildResult, simulation: SilverSimulationResult): Promise<SilverEvidence>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/silver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/silver/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAgB,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAErH,qBAAa,cAAc;aACK,IAAI,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAxC,IAAI,EAAE,MAAM,EAAmB,SAAS,EAAE,MAAM;IAErE,UAAU,IAAI,MAAM,EAAE;IAMtB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;CAY/D;AAED,qBAAa,aAAa;IACtB,OAAO;WAEO,IAAI,IAAI,aAAa;IAInC,OAAO,CAAC,SAAS;IAUV,SAAS,IAAI,MAAM,EAAE;IAIrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAOhC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUjD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAUpF,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAc1E,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;CAa/G"}

package/dist/silver/index.js

@@ -0,0 +1,94 @@
+import { SILVER_TEMPLATES } from './templates.js';
+export class SilverTemplate {
+    name;
+    rawSource;
+    constructor(name, rawSource) {
+        this.name = name;
+        this.rawSource = rawSource;
+    }
+    parameters() {
+        const regex = /<([^>]+)>/g;
+        const matches = [...this.rawSource.matchAll(regex)];
+        return Array.from(new Set(matches.map(m => m[1])));
+    }
+    fill(params) {
+        let filledSource = this.rawSource;
+        const requiredParams = this.parameters();
+        for (const req of requiredParams) {
+            if (!(req in params)) {
+                throw new Error(`Missing parameter for template '${this.name}': <${req}>`);
+            }
+            filledSource = filledSource.replace(new RegExp(`<${req}>`, 'g'), String(params[req]));
+        }
+        return filledSource;
+    }
+}
+export class SilverToolkit {
+    constructor() { }
+    static open() {
+        return new SilverToolkit();
+    }
+    getClaims() {
+        return {
+            realSilverCompiler: false,
+            vmConsensusEquivalence: false,
+            mainnetReady: false,
+            productionSafe: false,
+            simulatedOnly: true
+        };
+    }
+    templates() {
+        return Object.keys(SILVER_TEMPLATES);
+    }
+    template(name) {
+        if (!SILVER_TEMPLATES[name]) {
+            throw new Error(`Silver template not found: ${name}`);
+        }
+        return new SilverTemplate(name, SILVER_TEMPLATES[name]);
+    }
+    async build(source) {
+        // Mock bytecode compilation
+        const mockBytecode = Buffer.from(source).toString('hex');
+        return {
+            source,
+            bytecode: mockBytecode,
+            claims: this.getClaims()
+        };
+    }
+    async simulate(build, args) {
+        // Mock VM execution
+        return {
+            success: true,
+            executionTrace: ["OP_TRUE", "OP_CHECKSIG"],
+            gasConsumed: 1000,
+            claims: this.getClaims()
+        };
+    }
+    async artifact(build, name) {
+        const art = {
+            id: `silver-${Date.now()}`,
+            source: build.source,
+            bytecode: build.bytecode,
+            createdAt: new Date().toISOString(),
+            claims: this.getClaims()
+        };
+        if (name !== undefined) {
+            art.name = name;
+        }
+        return art;
+    }
+    async evidence(build, simulation) {
+        return {
+            schema: "hardkas.script-evidence.v1",
+            artifactId: `silver-${Date.now()}`,
+            simulationResult: {
+                success: simulation.success,
+                executionTrace: simulation.executionTrace,
+                gasConsumed: simulation.gasConsumed
+            },
+            timestamp: new Date().toISOString(),
+            claims: this.getClaims()
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/silver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/silver/index.ts"],"names":[],"mappings":"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"}

package/dist/silver/templates.d.ts

@@ -0,0 +1,2 @@
+export declare const SILVER_TEMPLATES: Record<string, string>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/silver/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/silver/templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0BnD,CAAC"}

package/dist/silver/templates.js

@@ -0,0 +1,28 @@
+export const SILVER_TEMPLATES = {
+    "op-true": `OP_TRUE`,
+    "timelock": `<locktime> OP_CHECKLOCKTIMEVERIFY OP_DROP
+<pubkey> OP_CHECKSIG`,
+    "escrow": `OP_IF
+  <buyer_pubkey> OP_CHECKSIGVERIFY
+  <arbiter_pubkey> OP_CHECKSIG
+OP_ELSE
+  <seller_pubkey> OP_CHECKSIGVERIFY
+  <arbiter_pubkey> OP_CHECKSIG
+OP_ENDIF`,
+    "htlc": `OP_IF
+  OP_SHA256 <secret_hash> OP_EQUALVERIFY
+  <receiver_pubkey> OP_CHECKSIG
+OP_ELSE
+  <locktime> OP_CHECKLOCKTIMEVERIFY OP_DROP
+  <sender_pubkey> OP_CHECKSIG
+OP_ENDIF`,
+    "atomic-swap": `OP_IF
+  OP_SHA256 <secret_hash> OP_EQUALVERIFY
+  <participant_b_pubkey> OP_CHECKSIG
+OP_ELSE
+  <locktime> OP_CHECKLOCKTIMEVERIFY OP_DROP
+  <participant_a_pubkey> OP_CHECKSIG
+OP_ENDIF`,
+    "multisig": `OP_2 <pubkey1> <pubkey2> <pubkey3> OP_3 OP_CHECKMULTISIG`
+};
+//# sourceMappingURL=templates.js.map

package/dist/silver/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/silver/templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACpD,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE;qBACK;IACjB,QAAQ,EAAE;;;;;;SAML;IACL,MAAM,EAAE;;;;;;SAMH;IACL,aAAa,EAAE;;;;;;SAMV;IACL,UAAU,EAAE,0DAA0D;CACzE,CAAC"}

package/dist/silver/types.d.ts

@@ -0,0 +1,34 @@
+export interface SilverClaims {
+    realSilverCompiler: boolean;
+    vmConsensusEquivalence: boolean;
+    mainnetReady: boolean;
+    productionSafe: boolean;
+    simulatedOnly: boolean;
+}
+export interface SilverBuildResult {
+    source: string;
+    bytecode: string;
+    claims: SilverClaims;
+}
+export interface SilverSimulationResult {
+    success: boolean;
+    executionTrace: string[];
+    gasConsumed: number;
+    claims: SilverClaims;
+}
+export interface SilverArtifact {
+    id: string;
+    name?: string;
+    source: string;
+    bytecode: string;
+    createdAt: string;
+    claims: SilverClaims;
+}
+export interface SilverEvidence {
+    schema: string;
+    artifactId: string;
+    simulationResult: Omit<SilverSimulationResult, 'claims'>;
+    timestamp: string;
+    claims: SilverClaims;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/silver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/silver/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,IAAI,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACxB"}

package/dist/silver/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/silver/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/silver/types.ts"],"names":[],"mappings":""}

package/dist/snapshot/backends/FsSnapshotBackend.d.ts

@@ -0,0 +1,14 @@
+import { SnapshotBackend, SnapshotManifest, SnapshotState } from "../types.js";
+export declare class FsSnapshotBackend implements SnapshotBackend {
+    private baseDir;
+    constructor(baseDir?: string);
+    save(id: string, name: string, state: Record<string, SnapshotState>): Promise<SnapshotManifest>;
+    load(id: string): Promise<{
+        manifest: SnapshotManifest;
+        state: Record<string, SnapshotState>;
+    }>;
+    list(): Promise<SnapshotManifest[]>;
+    delete(id: string): Promise<void>;
+    branch(baseId: string, newId: string, newName: string): Promise<SnapshotManifest>;
+}
+//# sourceMappingURL=FsSnapshotBackend.d.ts.map

package/dist/snapshot/backends/FsSnapshotBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsSnapshotBackend.d.ts","sourceRoot":"","sources":["../../../src/snapshot/backends/FsSnapshotBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM/E,qBAAa,iBAAkB,YAAW,eAAe;IACrD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAA6B;IAI5C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoC/F,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;KAAE,CAAC;IAkB/F,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqBnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAI1F"}

package/dist/snapshot/backends/FsSnapshotBackend.js

@@ -0,0 +1,82 @@
+import fs from "fs-extra";
+import path from "path";
+import crypto from "crypto";
+import { snapshotReplacer, snapshotReviver } from "../serialization.js";
+export class FsSnapshotBackend {
+    baseDir;
+    constructor(baseDir = ".hardkas-snapshots") {
+        this.baseDir = baseDir;
+    }
+    async save(id, name, state) {
+        const snapshotDir = path.join(this.baseDir, id);
+        await fs.ensureDir(snapshotDir);
+        const stateHashes = {};
+        const participants = Object.keys(state);
+        // Write each participant's state to a separate file
+        for (const [pId, pState] of Object.entries(state)) {
+            const data = JSON.stringify(pState, snapshotReplacer, 2);
+            stateHashes[pId] = crypto.createHash("sha256").update(data).digest("hex");
+            await fs.writeFile(path.join(snapshotDir, `${pId}.json`), data);
+        }
+        const manifest = {
+            schema: "hardkas.snapshot.v1",
+            snapshotId: id,
+            name,
+            createdAt: Date.now(),
+            backend: "filesystem",
+            path: snapshotDir,
+            participants,
+            stateHashes,
+            claims: {
+                containsFullStateInline: false,
+                restorableLocalState: true,
+                networkStateCaptured: false
+            }
+        };
+        // Write manifest
+        await fs.writeFile(path.join(snapshotDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+        return manifest;
+    }
+    async load(id) {
+        const snapshotDir = path.join(this.baseDir, id);
+        if (!await fs.pathExists(snapshotDir)) {
+            throw new Error(`Snapshot ${id} not found in filesystem backend at ${snapshotDir}`);
+        }
+        const manifestData = await fs.readFile(path.join(snapshotDir, "manifest.json"), "utf8");
+        const manifest = JSON.parse(manifestData);
+        const state = {};
+        for (const pId of manifest.participants) {
+            const stateData = await fs.readFile(path.join(snapshotDir, `${pId}.json`), "utf8");
+            state[pId] = JSON.parse(stateData, snapshotReviver);
+        }
+        return { manifest, state };
+    }
+    async list() {
+        if (!await fs.pathExists(this.baseDir)) {
+            return [];
+        }
+        const entries = await fs.readdir(this.baseDir, { withFileTypes: true });
+        const manifests = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const manifestPath = path.join(this.baseDir, entry.name, "manifest.json");
+                if (await fs.pathExists(manifestPath)) {
+                    const data = await fs.readFile(manifestPath, "utf8");
+                    manifests.push(JSON.parse(data));
+                }
+            }
+        }
+        return manifests;
+    }
+    async delete(id) {
+        const snapshotDir = path.join(this.baseDir, id);
+        if (await fs.pathExists(snapshotDir)) {
+            await fs.remove(snapshotDir);
+        }
+    }
+    async branch(baseId, newId, newName) {
+        const { state } = await this.load(baseId);
+        return this.save(newId, newName, state);
+    }
+}
+//# sourceMappingURL=FsSnapshotBackend.js.map

package/dist/snapshot/backends/FsSnapshotBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsSnapshotBackend.js","sourceRoot":"","sources":["../../../src/snapshot/backends/FsSnapshotBackend.ts"],"names":[],"mappings":"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"}

package/dist/snapshot/backends/MemorySnapshotBackend.d.ts

@@ -0,0 +1,13 @@
+import { SnapshotBackend, SnapshotManifest, SnapshotState } from "../types.js";
+export declare class MemorySnapshotBackend implements SnapshotBackend {
+    private snapshots;
+    save(id: string, name: string, state: Record<string, SnapshotState>): Promise<SnapshotManifest>;
+    load(id: string): Promise<{
+        manifest: SnapshotManifest;
+        state: Record<string, SnapshotState>;
+    }>;
+    list(): Promise<SnapshotManifest[]>;
+    delete(id: string): Promise<void>;
+    branch(baseId: string, newId: string, newName: string): Promise<SnapshotManifest>;
+}
+//# sourceMappingURL=MemorySnapshotBackend.d.ts.map

package/dist/snapshot/backends/MemorySnapshotBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySnapshotBackend.d.ts","sourceRoot":"","sources":["../../../src/snapshot/backends/MemorySnapshotBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI/E,qBAAa,qBAAsB,YAAW,eAAe;IACzD,OAAO,CAAC,SAAS,CAA2F;IAEtG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8B/F,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;KAAE,CAAC;IAY/F,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAInC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAO1F"}