@ocap/indexdb-sqlite 1.29.5

package/lib/db/base.d.cts

@@ -0,0 +1,76 @@
+import { Database } from "../interfaces.cjs";
+import { BaseIndexDB } from "@ocap/indexdb";
+import { IIndexDB, IIndexTable, IListAccountsResult, IListAssetsResult, IListDelegationsResult, IListFactoriesResult, IListRollupBlocksResult, IListRollupValidatorsResult, IListRollupsResult, IListStakesResult, IListTokenFactoriesResult, IListTokensResult, IListTransactionsResult, IndexTableTypeMap, TRequestListAssets, TRequestListDelegations, TRequestListFactories, TRequestListRollupBlocks, TRequestListRollupValidators, TRequestListRollups, TRequestListStakes, TRequestListTokenFactories, TRequestListTokens, TRequestListTopAccounts, TRequestListTransactions } from "@ocap/types";
+import { Kysely } from "kysely";
+
+//#region src/db/base.d.ts
+
+/**
+ * Base SQLite IndexDB implementation
+ * Contains all the list methods with SQL-based filtering
+ */
+declare class SqliteBaseIndexDB extends BaseIndexDB implements IIndexDB {
+  protected db: Kysely<Database>;
+  tx: IIndexTable<IndexTableTypeMap['tx']>;
+  account: IIndexTable<IndexTableTypeMap['account']>;
+  asset: IIndexTable<IndexTableTypeMap['asset']>;
+  token: IIndexTable<IndexTableTypeMap['token']>;
+  factory: IIndexTable<IndexTableTypeMap['factory']>;
+  stake: IIndexTable<IndexTableTypeMap['stake']>;
+  delegation: IIndexTable<IndexTableTypeMap['delegation']>;
+  rollup: IIndexTable<IndexTableTypeMap['rollup']>;
+  rollupBlock: IIndexTable<IndexTableTypeMap['rollupBlock']>;
+  rollupValidator: IIndexTable<IndexTableTypeMap['rollupValidator']>;
+  tokenDistribution: IIndexTable<IndexTableTypeMap['tokenDistribution']>;
+  tokenFactory: IIndexTable<IndexTableTypeMap['tokenFactory']>;
+  /**
+   * List transactions with filtering and pagination
+   */
+  listTransactions(params?: Partial<TRequestListTransactions>): Promise<IListTransactionsResult>;
+  /**
+   * Get related addresses for account migration tracking
+   */
+  getRelatedAddresses(address: string): Promise<string[]>;
+  /**
+   * List assets with filtering and pagination
+   */
+  listAssets(params?: Partial<TRequestListAssets>): Promise<IListAssetsResult>;
+  /**
+   * List top accounts by token balance
+   */
+  listTopAccounts(params?: Partial<TRequestListTopAccounts>): Promise<IListAccountsResult>;
+  /**
+   * List tokens with filtering and pagination
+   */
+  listTokens(params?: Partial<TRequestListTokens>): Promise<IListTokensResult>;
+  /**
+   * List token factories (bonding curve)
+   */
+  listTokenFactories(params?: Partial<TRequestListTokenFactories>): Promise<IListTokenFactoriesResult>;
+  /**
+   * List asset factories
+   */
+  listFactories(params?: Partial<TRequestListFactories>): Promise<IListFactoriesResult>;
+  /**
+   * List stakes
+   */
+  listStakes(params?: Partial<TRequestListStakes>): Promise<IListStakesResult>;
+  /**
+   * List rollups
+   */
+  listRollups(params?: Partial<TRequestListRollups>): Promise<IListRollupsResult>;
+  /**
+   * List rollup blocks
+   */
+  listRollupBlocks(params?: Partial<TRequestListRollupBlocks>): Promise<IListRollupBlocksResult>;
+  /**
+   * List rollup validators
+   */
+  listRollupValidators(params?: Partial<TRequestListRollupValidators>): Promise<IListRollupValidatorsResult>;
+  /**
+   * List delegations
+   */
+  listDelegations(params?: Partial<TRequestListDelegations>): Promise<IListDelegationsResult>;
+}
+//#endregion
+export { SqliteBaseIndexDB as default };

package/lib/db/index.cjs

@@ -0,0 +1,552 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_kysely = require('../kysely.cjs');
+const require_migrations_index = require('../migrations/index.cjs');
+const require_table_base = require('../table/base.cjs');
+const require_table_transaction = require('../table/transaction.cjs');
+const require_db_base = require('./base.cjs');
+const require_package = require('../package.cjs');
+
+//#region src/db/index.ts
+const { name, version } = require_package.default;
+/**
+* SQLite IndexDB Implementation
+* Uses SQLite via Kysely as the storage backend for indexed blockchain data
+*/
+var SqliteIndexDB = class extends require_db_base.default {
+	/**
+	* Creates an instance of SqliteIndexDB
+	*
+	* @param config - SQLite configuration (defaults to in-memory)
+	*
+	* @example
+	* ```typescript
+	* // In-memory database for testing
+	* const db = new SqliteIndexDB();
+	* await db.initialize();
+	*
+	* // File-based database for production
+	* const db = new SqliteIndexDB({ filename: './data/index.sqlite' });
+	* await db.initialize();
+	* ```
+	*/
+	constructor(config = { filename: ":memory:" }) {
+		super();
+		this.initialized = false;
+		this.name = name;
+		this.version = version;
+		this.config = config;
+		this.initSync();
+	}
+	/**
+	* Synchronous initialization
+	* Called from constructor for immediate table availability
+	*/
+	initSync() {
+		this.db = require_kysely.createKysely(this.config);
+		this.tx = new require_table_transaction.default({
+			name: "tx",
+			uniqIndex: "hash",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"receipts",
+					"tx",
+					"accounts",
+					"assets",
+					"tokens",
+					"tokenSymbols",
+					"factories",
+					"rollups",
+					"stakes",
+					"delegations",
+					"tokenFactories",
+					"data"
+				],
+				booleanFields: [
+					"receiptsVerified",
+					"finalized",
+					"valid"
+				],
+				columnMapping: { index: "index_" },
+				knownColumns: [
+					"hash",
+					"code",
+					"height",
+					"index",
+					"receipts",
+					"receiptsVerified",
+					"receiver",
+					"sender",
+					"time",
+					"tx",
+					"type",
+					"finalized",
+					"valid",
+					"accounts",
+					"assets",
+					"tokens",
+					"tokenSymbols",
+					"factories",
+					"rollups",
+					"stakes",
+					"delegations",
+					"tokenFactories",
+					"genesisTime",
+					"renaissanceTime",
+					"data"
+				]
+			}
+		});
+		this.account = new require_table_base.default({
+			name: "account",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"stake",
+					"tokens",
+					"data"
+				],
+				numericFields: { balance: "balanceNum" },
+				knownColumns: [
+					"address",
+					"balance",
+					"gasBalance",
+					"moniker",
+					"pk",
+					"nonce",
+					"numTxs",
+					"numAssets",
+					"issuer",
+					"migratedTo",
+					"migratedFrom",
+					"stake",
+					"tokens",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.asset = new require_table_base.default({
+			name: "asset",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"display",
+					"tags",
+					"stake",
+					"data"
+				],
+				booleanFields: ["readonly", "transferrable"],
+				knownColumns: [
+					"address",
+					"owner",
+					"moniker",
+					"readonly",
+					"transferrable",
+					"issuer",
+					"parent",
+					"ttl",
+					"consumedTime",
+					"endpoint",
+					"display",
+					"tags",
+					"stake",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.token = new require_table_base.default({
+			name: "token",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"foreignToken",
+					"metadata",
+					"spenders",
+					"minters",
+					"data"
+				],
+				numericFields: { totalSupply: "totalSupplyNum" },
+				knownColumns: [
+					"address",
+					"symbol",
+					"name",
+					"decimal",
+					"unit",
+					"description",
+					"icon",
+					"totalSupply",
+					"initialSupply",
+					"maxTotalSupply",
+					"foreignToken",
+					"issuer",
+					"website",
+					"metadata",
+					"tokenFactoryAddress",
+					"spenders",
+					"minters",
+					"type",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.factory = new require_table_base.default({
+			name: "factory",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"trustedIssuers",
+					"tokens",
+					"input",
+					"output",
+					"display",
+					"hooks",
+					"data"
+				],
+				columnMapping: { limit: "limit_" },
+				knownColumns: [
+					"address",
+					"owner",
+					"name",
+					"description",
+					"settlement",
+					"limit",
+					"trustedIssuers",
+					"tokens",
+					"numMinted",
+					"lastSettlement",
+					"input",
+					"output",
+					"display",
+					"hooks",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.tokenFactory = new require_table_base.default({
+			name: "tokenFactory",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"curve",
+					"token",
+					"reserveToken",
+					"input",
+					"output",
+					"data"
+				],
+				numericFields: {
+					reserveBalance: "reserveBalanceNum",
+					currentSupply: "currentSupplyNum"
+				},
+				knownColumns: [
+					"address",
+					"owner",
+					"name",
+					"description",
+					"moniker",
+					"status",
+					"curve",
+					"tokenAddress",
+					"reserveAddress",
+					"reserveBalance",
+					"currentSupply",
+					"feeRate",
+					"token",
+					"reserveToken",
+					"input",
+					"output",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.stake = new require_table_base.default({
+			name: "stake",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"tokens",
+					"revokedTokens",
+					"assets",
+					"revokedAssets",
+					"slashers",
+					"data"
+				],
+				booleanFields: ["revocable"],
+				knownColumns: [
+					"address",
+					"sender",
+					"receiver",
+					"revocable",
+					"tokens",
+					"revokedTokens",
+					"assets",
+					"revokedAssets",
+					"slashers",
+					"nonce",
+					"revokeWaitingPeriod",
+					"message",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.delegation = new require_table_base.default({
+			name: "delegation",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"ops",
+					"context",
+					"data"
+				],
+				columnMapping: {
+					from: "from_",
+					to: "to_"
+				},
+				knownColumns: [
+					"address",
+					"from",
+					"to",
+					"ops",
+					"context",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.rollup = new require_table_base.default({
+			name: "rollup",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"seedValidators",
+					"validators",
+					"foreignToken",
+					"tokenInfo",
+					"migrateHistory",
+					"vaultHistory",
+					"data"
+				],
+				booleanFields: ["paused", "closed"],
+				knownColumns: [
+					"address",
+					"tokenAddress",
+					"vaultAddress",
+					"contractAddress",
+					"paused",
+					"closed",
+					"seedValidators",
+					"validators",
+					"blockHash",
+					"issuer",
+					"foreignToken",
+					"minStakeAmount",
+					"maxStakeAmount",
+					"minSignerCount",
+					"maxSignerCount",
+					"minBlockSize",
+					"maxBlockSize",
+					"minBlockInterval",
+					"leaveWaitingPeriod",
+					"publishWaitingPeriod",
+					"publishSlashRate",
+					"tokenInfo",
+					"depositFeeRate",
+					"withdrawFeeRate",
+					"proposerFeeShare",
+					"publisherFeeShare",
+					"minDepositAmount",
+					"minWithdrawAmount",
+					"totalDepositAmount",
+					"totalWithdrawAmount",
+					"migrateHistory",
+					"vaultHistory",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.rollupBlock = new require_table_base.default({
+			name: "rollupBlock",
+			uniqIndex: "hash",
+			db: this.db,
+			schema: {
+				jsonFields: [
+					"signatures",
+					"txs",
+					"validators",
+					"tokenInfo",
+					"data"
+				],
+				booleanFields: ["governance"],
+				knownColumns: [
+					"hash",
+					"rollup",
+					"height",
+					"merkleRoot",
+					"previousHash",
+					"txsHash",
+					"txs",
+					"proposer",
+					"signatures",
+					"rewardAmount",
+					"mintedAmount",
+					"burnedAmount",
+					"minReward",
+					"validators",
+					"tokenInfo",
+					"governance",
+					"data",
+					"genesisTime",
+					"renaissanceTime"
+				]
+			}
+		});
+		this.rollupValidator = new require_table_base.default({
+			name: "rollupValidator",
+			uniqIndex: "address",
+			db: this.db,
+			schema: {
+				jsonFields: ["data"],
+				knownColumns: [
+					"address",
+					"rollup",
+					"pk",
+					"moniker",
+					"endpoint",
+					"joinTime",
+					"leaveTime",
+					"genesisTime",
+					"renaissanceTime",
+					"totalStake",
+					"availableStake",
+					"revokedStake",
+					"totalGain",
+					"proposedBlockCount",
+					"verifiedBlockCount",
+					"latestBlockHeight",
+					"latestBlockHash",
+					"data"
+				]
+			}
+		});
+		this.tokenDistribution = new require_table_base.default({
+			name: "tokenDistribution",
+			uniqIndex: "tokenAddress",
+			db: this.db,
+			schema: {
+				jsonFields: ["distribution", "data"],
+				knownColumns: [
+					"tokenAddress",
+					"holders",
+					"distribution",
+					"stake",
+					"gasStake",
+					"revokedStake",
+					"gas",
+					"fee",
+					"slashedVault",
+					"account",
+					"txTime",
+					"genesisTime",
+					"renaissanceTime",
+					"data"
+				]
+			}
+		});
+		this.balance = new require_table_base.default({
+			name: "balance",
+			uniqIndex: ["address", "tokenAddress"],
+			db: this.db,
+			schema: {
+				jsonFields: ["data"],
+				numericFields: { balance: "balanceNum" },
+				knownColumns: [
+					"address",
+					"tokenAddress",
+					"balance",
+					"data"
+				]
+			}
+		});
+		this.attachReadyListeners();
+	}
+	/**
+	* Async initialization - runs migrations
+	* Call this after constructor to ensure database schema is ready
+	*/
+	async initialize() {
+		if (this.initialized) return;
+		await require_migrations_index.runMigrations(this.db);
+		this.initialized = true;
+	}
+	/**
+	* Execute multiple operations within a database transaction
+	*
+	* @param fn - Function receiving Kysely transaction object
+	* @returns Result of the transaction function
+	*/
+	async runAsLambda(fn) {
+		return this.db.transaction().execute(fn);
+	}
+	/**
+	* Reset all tables (for testing)
+	*/
+	async reset() {
+		for (const table of [
+			"tx",
+			"account",
+			"asset",
+			"token",
+			"factory",
+			"tokenFactory",
+			"stake",
+			"delegation",
+			"rollup",
+			"rollupBlock",
+			"rollupValidator",
+			"tokenDistribution",
+			"balance"
+		]) {
+			const tableInstance = this[table];
+			if (tableInstance?.reset) await tableInstance.reset();
+		}
+	}
+	/**
+	* Close database connection
+	*/
+	async close() {
+		await this.db.destroy();
+	}
+	/**
+	* Get the underlying Kysely instance (for advanced operations)
+	*/
+	getKysely() {
+		return this.db;
+	}
+};
+var db_default = SqliteIndexDB;
+
+//#endregion
+exports.default = db_default;

package/lib/db/index.d.cts

@@ -0,0 +1,80 @@
+import { Database } from "../interfaces.cjs";
+import SqliteBaseIndexDB from "./base.cjs";
+import { SqliteConfig } from "../kysely.cjs";
+import { IIndexDB, IIndexTable, IndexTableTypeMap } from "@ocap/types";
+import { Kysely, Transaction } from "kysely";
+
+//#region src/db/index.d.ts
+
+/**
+ * SQLite IndexDB Implementation
+ * Uses SQLite via Kysely as the storage backend for indexed blockchain data
+ */
+declare class SqliteIndexDB extends SqliteBaseIndexDB implements IIndexDB {
+  name: string;
+  version: string;
+  protected db: Kysely<Database>;
+  private config;
+  private initialized;
+  tx: IIndexTable<IndexTableTypeMap['tx']>;
+  account: IIndexTable<IndexTableTypeMap['account']>;
+  asset: IIndexTable<IndexTableTypeMap['asset']>;
+  token: IIndexTable<IndexTableTypeMap['token']>;
+  factory: IIndexTable<IndexTableTypeMap['factory']>;
+  stake: IIndexTable<IndexTableTypeMap['stake']>;
+  delegation: IIndexTable<IndexTableTypeMap['delegation']>;
+  rollup: IIndexTable<IndexTableTypeMap['rollup']>;
+  rollupBlock: IIndexTable<IndexTableTypeMap['rollupBlock']>;
+  rollupValidator: IIndexTable<IndexTableTypeMap['rollupValidator']>;
+  tokenDistribution: IIndexTable<IndexTableTypeMap['tokenDistribution']>;
+  tokenFactory: IIndexTable<IndexTableTypeMap['tokenFactory']>;
+  balance: IIndexTable<IndexTableTypeMap['tokenDistribution']>;
+  /**
+   * Creates an instance of SqliteIndexDB
+   *
+   * @param config - SQLite configuration (defaults to in-memory)
+   *
+   * @example
+   * ```typescript
+   * // In-memory database for testing
+   * const db = new SqliteIndexDB();
+   * await db.initialize();
+   *
+   * // File-based database for production
+   * const db = new SqliteIndexDB({ filename: './data/index.sqlite' });
+   * await db.initialize();
+   * ```
+   */
+  constructor(config?: SqliteConfig);
+  /**
+   * Synchronous initialization
+   * Called from constructor for immediate table availability
+   */
+  private initSync;
+  /**
+   * Async initialization - runs migrations
+   * Call this after constructor to ensure database schema is ready
+   */
+  initialize(): Promise<void>;
+  /**
+   * Execute multiple operations within a database transaction
+   *
+   * @param fn - Function receiving Kysely transaction object
+   * @returns Result of the transaction function
+   */
+  runAsLambda<T>(fn: (txn: Transaction<Database>) => T | Promise<T>): Promise<T>;
+  /**
+   * Reset all tables (for testing)
+   */
+  reset(): Promise<void>;
+  /**
+   * Close database connection
+   */
+  close(): Promise<void>;
+  /**
+   * Get the underlying Kysely instance (for advanced operations)
+   */
+  getKysely(): Kysely<Database>;
+}
+//#endregion
+export { SqliteIndexDB as default };

package/lib/index.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_db_base = require('./db/base.cjs');
+const require_db_index = require('./db/index.cjs');
+
+//#region src/index.ts
+var src_default = require_db_index.default;
+
+//#endregion
+exports.SqliteBaseIndexDB = require_db_base.default;
+exports.default = src_default;