@claw-network/node 0.2.0

package/dist/indexer/query.d.ts

@@ -0,0 +1,141 @@
+/**
+ * IndexerQuery — paginated, filterable read access to indexed chain data.
+ *
+ * All query methods return a `PaginatedResult<T>` so the REST API can
+ * forward pagination metadata directly to callers.
+ *
+ * Internally, every query is a prepared SQLite statement (parameterised to
+ * prevent SQL injection).  The underlying `better-sqlite3` connection is
+ * synchronous — perfectly adequate for a single-node daemon.
+ */
+import Database from 'better-sqlite3';
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface PaginationOpts {
+    /** Maximum number of rows (default: 50, max: 200). */
+    limit?: number;
+    /** Number of rows to skip (default: 0). */
+    offset?: number;
+}
+export interface TransferRow {
+    id: number;
+    block: number;
+    txHash: string;
+    fromAddr: string;
+    toAddr: string;
+    amount: string;
+    timestamp: number;
+}
+export interface TransferFilter extends PaginationOpts {
+    /** Filter transfers involving this address (sender OR recipient). */
+    address?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}
+export interface EscrowRow {
+    escrowId: string;
+    depositor: string;
+    beneficiary: string;
+    arbiter: string;
+    amount: string;
+    status: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface EscrowFilter extends PaginationOpts {
+    /** Filter by depositor, beneficiary, or arbiter address. */
+    address?: string;
+    status?: number;
+}
+export interface ServiceContractRow {
+    contractId: string;
+    client: string;
+    provider: string;
+    status: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ServiceContractFilter extends PaginationOpts {
+    /** Filter by client or provider address. */
+    address?: string;
+    status?: number;
+}
+export interface ProposalRow {
+    proposalId: number;
+    proposer: string;
+    pType: number;
+    status: number;
+    createdAt: number;
+}
+export interface ProposalFilter extends PaginationOpts {
+    proposer?: string;
+    status?: number;
+}
+export interface VoteRow {
+    proposalId: number;
+    voter: string;
+    support: number;
+    weight: string;
+    timestamp: number;
+}
+export interface VoteFilter extends PaginationOpts {
+    proposalId?: number;
+    voter?: string;
+}
+export interface ReviewRow {
+    reviewHash: string;
+    reviewerDid: string;
+    subjectDid: string;
+    relatedTxHash: string;
+    timestamp: number;
+}
+export interface ReviewFilter extends PaginationOpts {
+    subjectDid?: string;
+    reviewerDid?: string;
+}
+export interface DidCacheRow {
+    controller: string;
+    activeKey: string;
+    isActive: boolean;
+    updatedAt: number;
+}
+export interface EventRow {
+    id: number;
+    block: number;
+    txHash: string;
+    logIndex: number;
+    contract: string;
+    eventName: string;
+    args: string;
+    timestamp: number;
+}
+export interface EventFilter extends PaginationOpts {
+    contract?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}
+export declare class IndexerQuery {
+    private readonly db;
+    constructor(db: Database.Database);
+    getTransfers(filter?: TransferFilter): PaginatedResult<TransferRow>;
+    getEscrows(filter?: EscrowFilter): PaginatedResult<EscrowRow>;
+    getServiceContracts(filter?: ServiceContractFilter): PaginatedResult<ServiceContractRow>;
+    getProposals(filter?: ProposalFilter): PaginatedResult<ProposalRow>;
+    getVotes(filter?: VoteFilter): PaginatedResult<VoteRow>;
+    getReviews(filter?: ReviewFilter): PaginatedResult<ReviewRow>;
+    /**
+     * Look up a single DID record from the indexer cache.
+     *
+     * @param didHash  The keccak256 hash of the full DID string.
+     * @returns Cached record, or `null` if not found.
+     */
+    getDid(didHash: string): DidCacheRow | null;
+    getEvents(filter?: EventFilter): PaginatedResult<EventRow>;
+    private count;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/indexer/query.d.ts.map

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

package/dist/indexer/query.js

@@ -0,0 +1,244 @@
+/**
+ * IndexerQuery — paginated, filterable read access to indexed chain data.
+ *
+ * All query methods return a `PaginatedResult<T>` so the REST API can
+ * forward pagination metadata directly to callers.
+ *
+ * Internally, every query is a prepared SQLite statement (parameterised to
+ * prevent SQL injection).  The underlying `better-sqlite3` connection is
+ * synchronous — perfectly adequate for a single-node daemon.
+ */
+// ---------------------------------------------------------------------------
+// IndexerQuery
+// ---------------------------------------------------------------------------
+export class IndexerQuery {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ── Transfers ───────────────────────────────────────────────────────────
+    getTransfers(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.address) {
+            where.push('(from_addr = ? OR to_addr = ?)');
+            params.push(filter.address, filter.address);
+        }
+        if (filter.fromBlock !== undefined) {
+            where.push('block >= ?');
+            params.push(filter.fromBlock);
+        }
+        if (filter.toBlock !== undefined) {
+            where.push('block <= ?');
+            params.push(filter.toBlock);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('wallet_transfers', clause, params);
+        const rows = this.db
+            .prepare(`SELECT id, block, tx_hash AS txHash, from_addr AS fromAddr,
+                to_addr AS toAddr, amount, timestamp
+         FROM wallet_transfers ${clause}
+         ORDER BY block DESC, id DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Escrows ─────────────────────────────────────────────────────────────
+    getEscrows(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.address) {
+            where.push('(depositor = ? OR beneficiary = ? OR arbiter = ?)');
+            params.push(filter.address, filter.address, filter.address);
+        }
+        if (filter.status !== undefined) {
+            where.push('status = ?');
+            params.push(filter.status);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('escrows', clause, params);
+        const rows = this.db
+            .prepare(`SELECT escrow_id AS escrowId, depositor, beneficiary, arbiter,
+                amount, status, created_at AS createdAt, updated_at AS updatedAt
+         FROM escrows ${clause}
+         ORDER BY created_at DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Service contracts ───────────────────────────────────────────────────
+    getServiceContracts(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.address) {
+            where.push('(client = ? OR provider = ?)');
+            params.push(filter.address, filter.address);
+        }
+        if (filter.status !== undefined) {
+            where.push('status = ?');
+            params.push(filter.status);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('service_contracts', clause, params);
+        const rows = this.db
+            .prepare(`SELECT contract_id AS contractId, client, provider, status,
+                created_at AS createdAt, updated_at AS updatedAt
+         FROM service_contracts ${clause}
+         ORDER BY created_at DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Proposals ───────────────────────────────────────────────────────────
+    getProposals(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.proposer) {
+            where.push('proposer = ?');
+            params.push(filter.proposer);
+        }
+        if (filter.status !== undefined) {
+            where.push('status = ?');
+            params.push(filter.status);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('proposals', clause, params);
+        const rows = this.db
+            .prepare(`SELECT proposal_id AS proposalId, proposer, p_type AS pType,
+                status, created_at AS createdAt
+         FROM proposals ${clause}
+         ORDER BY created_at DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Votes ───────────────────────────────────────────────────────────────
+    getVotes(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.proposalId !== undefined) {
+            where.push('proposal_id = ?');
+            params.push(filter.proposalId);
+        }
+        if (filter.voter) {
+            where.push('voter = ?');
+            params.push(filter.voter);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('votes', clause, params);
+        const rows = this.db
+            .prepare(`SELECT proposal_id AS proposalId, voter, support, weight, timestamp
+         FROM votes ${clause}
+         ORDER BY timestamp DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Reviews ─────────────────────────────────────────────────────────────
+    getReviews(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.subjectDid) {
+            where.push('subject_did = ?');
+            params.push(filter.subjectDid);
+        }
+        if (filter.reviewerDid) {
+            where.push('reviewer_did = ?');
+            params.push(filter.reviewerDid);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('reviews', clause, params);
+        const rows = this.db
+            .prepare(`SELECT review_hash AS reviewHash, reviewer_did AS reviewerDid,
+                subject_did AS subjectDid, related_tx_hash AS relatedTxHash,
+                timestamp
+         FROM reviews ${clause}
+         ORDER BY timestamp DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── DID cache ───────────────────────────────────────────────────────────
+    /**
+     * Look up a single DID record from the indexer cache.
+     *
+     * @param didHash  The keccak256 hash of the full DID string.
+     * @returns Cached record, or `null` if not found.
+     */
+    getDid(didHash) {
+        const row = this.db
+            .prepare(`SELECT controller, active_key AS activeKey,
+                is_active AS isActive, updated_at AS updatedAt
+         FROM did_cache
+         WHERE did_hash = ?`)
+            .get(didHash);
+        if (!row)
+            return null;
+        return {
+            controller: row.controller,
+            activeKey: row.activeKey,
+            isActive: row.isActive === 1,
+            updatedAt: row.updatedAt,
+        };
+    }
+    // ── Generic events ──────────────────────────────────────────────────────
+    getEvents(filter = {}) {
+        const { limit, offset } = normalisePagination(filter);
+        const where = [];
+        const params = [];
+        if (filter.contract) {
+            where.push('contract = ?');
+            params.push(filter.contract);
+        }
+        if (filter.eventName) {
+            where.push('event_name = ?');
+            params.push(filter.eventName);
+        }
+        if (filter.fromBlock !== undefined) {
+            where.push('block >= ?');
+            params.push(filter.fromBlock);
+        }
+        if (filter.toBlock !== undefined) {
+            where.push('block <= ?');
+            params.push(filter.toBlock);
+        }
+        const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+        const total = this.count('events', clause, params);
+        const rows = this.db
+            .prepare(`SELECT id, block, tx_hash AS txHash, log_index AS logIndex,
+                contract, event_name AS eventName, args, timestamp
+         FROM events ${clause}
+         ORDER BY block DESC, id DESC
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return { items: rows, total, limit, offset };
+    }
+    // ── Helpers ─────────────────────────────────────────────────────────────
+    count(table, whereClause, params) {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS cnt FROM ${table} ${whereClause}`)
+            .get(...params);
+        return row.cnt;
+    }
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+const MAX_LIMIT = 200;
+const DEFAULT_LIMIT = 50;
+function normalisePagination(opts) {
+    let limit = opts.limit ?? DEFAULT_LIMIT;
+    if (limit < 1)
+        limit = 1;
+    if (limit > MAX_LIMIT)
+        limit = MAX_LIMIT;
+    const offset = Math.max(opts.offset ?? 0, 0);
+    return { limit, offset };
+}
+//# sourceMappingURL=query.js.map

package/dist/indexer/query.js.map

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

package/dist/indexer/store.d.ts

@@ -0,0 +1,95 @@
+/**
+ * IndexerStore SQLite persistence for the Event Indexer.
+ *
+ * Manages all on-chain event data:
+ * - Generic `events` table (raw event log)
+ * - Module-specific materialized tables (transfers, contracts, proposals, votes, reviews, escrows)
+ * - Indexer metadata (last indexed block, etc.)
+ *
+ * Uses `better-sqlite3` for synchronous, single-connection access
+ * ideal for a single-node daemon where reads and writes are serialised.
+ */
+import Database from 'better-sqlite3';
+export interface RawEvent {
+    block: number;
+    txHash: string;
+    logIndex: number;
+    contract: string;
+    eventName: string;
+    args: string;
+    timestamp: number;
+}
+export interface WalletTransfer {
+    id?: number;
+    block: number;
+    txHash: string;
+    fromAddr: string;
+    toAddr: string;
+    amount: string;
+    timestamp: number;
+}
+export interface IndexedServiceContract {
+    contractId: string;
+    client: string;
+    provider: string;
+    status: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface IndexedProposal {
+    proposalId: number;
+    proposer: string;
+    pType: number;
+    status: number;
+    createdAt: number;
+}
+export interface IndexedVote {
+    proposalId: number;
+    voter: string;
+    support: number;
+    weight: string;
+    timestamp: number;
+}
+export interface IndexedReview {
+    reviewHash: string;
+    reviewerDid: string;
+    subjectDid: string;
+    relatedTxHash: string;
+    timestamp: number;
+}
+export interface EscrowRecord {
+    escrowId: string;
+    depositor: string;
+    beneficiary: string;
+    arbiter: string;
+    amount: string;
+    status: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare class IndexerStore {
+    private readonly _db;
+    constructor(dbPath: string);
+    /** Expose the underlying Database instance (for IndexerQuery). */
+    get database(): Database.Database;
+    getMeta(key: string): string | undefined;
+    setMeta(key: string, value: string): void;
+    get lastIndexedBlock(): number;
+    set lastIndexedBlock(block: number);
+    insertEvent(event: RawEvent): void;
+    insertTransfer(t: WalletTransfer): void;
+    upsertEscrow(e: EscrowRecord): void;
+    updateEscrowStatus(escrowId: string, status: number, updatedAt: number): void;
+    updateEscrowAmount(escrowId: string, amount: string, updatedAt: number): void;
+    upsertServiceContract(c: IndexedServiceContract): void;
+    updateServiceContractStatus(contractId: string, status: number, updatedAt: number): void;
+    upsertProposal(p: IndexedProposal): void;
+    updateProposalStatus(proposalId: number, status: number): void;
+    insertVote(v: IndexedVote): void;
+    insertReview(r: IndexedReview): void;
+    upsertDid(didHash: string, controller: string, activeKey: string, isActive: boolean, updatedAt: number): void;
+    /** Execute a batch of operations inside a single SQLite transaction. */
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/indexer/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/indexer/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAMtC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AA6GD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;gBAE5B,MAAM,EAAE,MAAM;IAO1B,kEAAkE;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAEhC;IAID,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOxC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzC,IAAI,gBAAgB,IAAI,MAAM,CAG7B;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAEjC;IAID,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAmBlC,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI;IAWvC,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI;IAsBnC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM7E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ7E,qBAAqB,CAAC,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAmBtD,2BAA2B,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,IAAI;IAUP,cAAc,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI;IAWxC,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ9D,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAWhC,YAAY,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAiBpC,SAAS,CACP,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI;IAkBP,wEAAwE;IACxE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAM9B,KAAK,IAAI,IAAI;CAGd"}