@ocap/indexdb-sqlite 1.29.8 → 1.29.10

package/esm/db/base.d.mts

@@ -36,7 +36,9 @@ declare class SqliteBaseIndexDB extends BaseIndexDB implements IIndexDB {
    */
   listAssets(params?: Partial<TRequestListAssets>): Promise<IListAssetsResult>;
   /**
-   * List top accounts by token balance
+   * List top accounts by token balance.
+   * For tokenAddress filter: uses balance table JOIN for indexed lookup.
+   * Without tokenAddress: uses SQL ORDER BY + LIMIT directly.
    */
   listTopAccounts(params?: Partial<TRequestListTopAccounts>): Promise<IListAccountsResult>;
   /**

package/esm/db/base.mjs

@@ -1,6 +1,6 @@
+import { sql } from "kysely";
 import { BaseIndexDB, formatDelegationAfterRead, formatNextPagination, formatPagination, parseDateTime } from "@ocap/indexdb";
 import { toChecksumAddress } from "@arcblock/did/lib/type";
-import { BN } from "@ocap/util";
 import { DEFAULT_TOKEN_DECIMAL } from "@ocap/util/lib/constant";
 import debugFactory from "debug";
 import omit from "lodash/omit.js";
@@ -55,8 +55,8 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 			includeItxData
 		});
 		let qb = this.db.selectFrom("tx").selectAll();
-		if (sender && receiver) if (direction === "MUTUAL") qb = qb.where((eb) => eb.or([eb.and([eb("sender", "=", sender), eb("receiver", "=", receiver)]), eb.and([eb("sender", "=", receiver), eb("receiver", "=", sender)])]));
-		else if (direction === "ONE_WAY") qb = qb.where("sender", "=", sender).where("receiver", "=", receiver);
+		const isMutual = !!(sender && receiver && direction === "MUTUAL");
+		if (sender && receiver) if (direction === "MUTUAL") {} else if (direction === "ONE_WAY") qb = qb.where("sender", "=", sender).where("receiver", "=", receiver);
 		else qb = qb.where((eb) => eb.or([eb("sender", "=", sender), eb("receiver", "=", receiver)]));
 		else if (sender) qb = qb.where("sender", "=", sender);
 		else if (receiver) qb = qb.where("receiver", "=", receiver);
@@ -71,18 +71,68 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 		const { validity } = validityFilter;
 		if (validity === "VALID") qb = qb.where("valid", "=", 1);
 		else if (validity === "INVALID") qb = qb.where("valid", "=", 0);
-		if (factories.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("factories")]).as("je")).select("je.value").where("je.value", "in", factories)));
-		if (assets.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("assets")]).as("je")).select("je.value").where("je.value", "in", assets)));
-		if (tokens.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("tokens")]).as("je")).select("je.value").where("je.value", "in", tokens)));
-		if (accounts.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("accounts")]).as("je")).select("je.value").where("je.value", "in", accounts)));
-		if (rollups.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("rollups")]).as("je")).select("je.value").where("je.value", "in", rollups)));
-		if (stakes.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("stakes")]).as("je")).select("je.value").where("je.value", "in", stakes)));
-		if (delegations.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("delegations")]).as("je")).select("je.value").where("je.value", "in", delegations)));
-		if (tokenFactories.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("tokenFactories")]).as("je")).select("je.value").where("je.value", "in", tokenFactories)));
-		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
+		const txRefTypeMap = {
+			factories: "factory",
+			tokens: "token",
+			assets: "asset",
+			accounts: "account",
+			rollups: "rollup",
+			stakes: "stake",
+			delegations: "delegation",
+			tokenFactories: "tokenFactory"
+		};
+		const applyJsonArrayFilter = (column, values) => {
+			const refType = txRefTypeMap[column];
+			qb = qb.where("hash", "in", this.db.selectFrom("tx_ref").select("hash").where("type", "=", refType).where("value", "in", values));
+		};
+		if (factories.length) applyJsonArrayFilter("factories", factories);
+		if (assets.length) applyJsonArrayFilter("assets", assets);
+		if (tokens.length) applyJsonArrayFilter("tokens", tokens);
+		if (accounts.length) applyJsonArrayFilter("accounts", accounts);
+		if (rollups.length) applyJsonArrayFilter("rollups", rollups);
+		if (stakes.length) applyJsonArrayFilter("stakes", stakes);
+		if (delegations.length) applyJsonArrayFilter("delegations", delegations);
+		if (tokenFactories.length) applyJsonArrayFilter("tokenFactories", tokenFactories);
+		let total;
+		const activeJsonFilters = [];
+		if (factories.length) activeJsonFilters.push(["factory", factories]);
+		if (assets.length) activeJsonFilters.push(["asset", assets]);
+		if (tokens.length) activeJsonFilters.push(["token", tokens]);
+		if (accounts.length) activeJsonFilters.push(["account", accounts]);
+		if (rollups.length) activeJsonFilters.push(["rollup", rollups]);
+		if (stakes.length) activeJsonFilters.push(["stake", stakes]);
+		if (delegations.length) activeJsonFilters.push(["delegation", delegations]);
+		if (tokenFactories.length) activeJsonFilters.push(["tokenFactory", tokenFactories]);
+		const hasNonJsonFilters = !!(sender || receiver || types.length || txs.length || parsedStart || parsedEnd || validity);
+		if (isMutual) {
+			const [c1, c2] = await Promise.all([this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", sender).where("receiver", "=", receiver).executeTakeFirst(), this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", receiver).where("receiver", "=", sender).executeTakeFirst()]);
+			total = (c1?.count ?? 0) + (c2?.count ?? 0);
+		} else if (!hasNonJsonFilters && activeJsonFilters.length === 1) {
+			const [refType, values] = activeJsonFilters[0];
+			total = (await this.db.selectFrom("tx_ref").select(this.db.fn.countAll().as("count")).where("type", "=", refType).where("value", "in", values).executeTakeFirst())?.count ?? 0;
+		} else if (sender && receiver && direction !== "ONE_WAY") {
+			const [senderCount, receiverCount] = await Promise.all([this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", sender).executeTakeFirst(), this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("receiver", "=", receiver).executeTakeFirst()]);
+			total = (senderCount?.count ?? 0) + (receiverCount?.count ?? 0);
+		} else total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
-		qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
-		let transactions = (await qb.execute()).map((row) => {
+		let rawResults;
+		if (isMutual) {
+			const q1 = this.db.selectFrom("tx").selectAll().where("sender", "=", sender).where("receiver", "=", receiver);
+			const q2 = this.db.selectFrom("tx").selectAll().where("sender", "=", receiver).where("receiver", "=", sender);
+			rawResults = await q1.unionAll(q2).orderBy(pagination.order.field, orderDir).limit(pagination.size).offset(pagination.cursor).execute();
+		} else if (!hasNonJsonFilters && activeJsonFilters.length === 1 && pagination.order.field === "time") {
+			const [refType, values] = activeJsonFilters[0];
+			const hashes = (await this.db.selectFrom("tx_ref").select("hash").where("type", "=", refType).where("value", "in", values).orderBy("time", orderDir).limit(pagination.size).offset(pagination.cursor).execute()).map((r) => r.hash);
+			if (hashes.length > 0) {
+				const dataRows = await this.db.selectFrom("tx").selectAll().where("hash", "in", hashes).execute();
+				const hashOrder = new Map(hashes.map((h, i) => [h, i]));
+				rawResults = [...dataRows].sort((a, b) => (hashOrder.get(a.hash) ?? 0) - (hashOrder.get(b.hash) ?? 0));
+			} else rawResults = [];
+		} else {
+			qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
+			rawResults = await qb.execute();
+		}
+		let transactions = rawResults.map((row) => {
 			const tx = { ...row };
 			[
 				"receipts",
@@ -212,7 +262,9 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 		};
 	}
 	/**
-	* List top accounts by token balance
+	* List top accounts by token balance.
+	* For tokenAddress filter: uses balance table JOIN for indexed lookup.
+	* Without tokenAddress: uses SQL ORDER BY + LIMIT directly.
 	*/
 	async listTopAccounts(params = {}) {
 		const { paging, tokenAddress } = params;
@@ -230,12 +282,8 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 			paging,
 			pagination
 		});
-		let qb = this.db.selectFrom("account").selectAll();
-		if (pagination.order.field !== "balance") {
-			const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
-			qb = qb.orderBy(pagination.order.field, orderDir);
-		}
-		let accounts = (await qb.execute()).map((row) => {
+		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
+		const parseAccount = (row) => {
 			const account = { ...row };
 			[
 				"stake",
@@ -251,31 +299,21 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 				return token;
 			});
 			return account;
-		});
-		if (tokenAddress) accounts = accounts.filter((acc) => {
-			const tokens = acc.tokens;
-			if (!Array.isArray(tokens)) return false;
-			const owned = tokens.find((t) => t.address === tokenAddress);
-			return owned ? owned.balance > "0" : false;
-		});
-		if (pagination.order.field === "balance" && tokenAddress) {
-			const descending = pagination.order.type === "desc";
-			accounts.sort((a, b) => {
-				const tokensA = a.tokens;
-				const tokensB = b.tokens;
-				const tokenA = tokensA?.find((t) => t.address === tokenAddress);
-				const tokenB = tokensB?.find((t) => t.address === tokenAddress);
-				const balanceA = new BN(tokenA ? tokenA.balance : "0");
-				const balanceB = new BN(tokenB ? tokenB.balance : "0");
-				if (balanceB.gt(balanceA)) return descending ? 1 : -1;
-				if (balanceB.eq(balanceA)) return 0;
-				return descending ? -1 : 1;
-			});
+		};
+		if (tokenAddress) {
+			const total$1 = (await this.db.selectFrom("balance").select(this.db.fn.countAll().as("count")).where("tokenAddress", "=", tokenAddress).where("balance", "!=", "0").executeTakeFirst())?.count ?? 0;
+			const sortField$1 = pagination.order.field === "balance" ? "b.balanceNum" : `a.${pagination.order.field}`;
+			return {
+				accounts: (await this.db.selectFrom("balance as b").innerJoin("account as a", "a.address", "b.address").selectAll("a").where("b.tokenAddress", "=", tokenAddress).where("b.balance", "!=", "0").orderBy(sortField$1, orderDir).limit(pagination.size).offset(pagination.cursor).execute()).map(parseAccount),
+				paging: formatNextPagination(total$1, pagination)
+			};
 		}
-		const total = accounts.length;
-		accounts = accounts.slice(pagination.cursor, pagination.cursor + pagination.size);
+		let qb = this.db.selectFrom("account").selectAll();
+		const sortField = pagination.order.field === "balance" ? "balanceNum" : pagination.order.field;
+		qb = qb.orderBy(sortField, orderDir);
+		const total = (await this.db.selectFrom("account").select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		return {
-			accounts,
+			accounts: (await qb.limit(pagination.size).offset(pagination.cursor).execute()).map(parseAccount),
 			paging: formatNextPagination(total, pagination)
 		};
 	}
@@ -457,7 +495,10 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 		if (parsedStart && parsedEnd) qb = qb.where("renaissanceTime", ">", parsedStart).where("renaissanceTime", "<=", parsedEnd);
 		else if (parsedStart) qb = qb.where("renaissanceTime", ">", parsedStart);
 		else if (parsedEnd) qb = qb.where("renaissanceTime", "<=", parsedEnd);
-		if (assets.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("assets")]).as("je")).select("je.value").where("je.value", "in", assets)));
+		if (assets.length) qb = qb.where((eb) => {
+			const conditions = assets.map((v) => eb(sql`INSTR(${sql.ref("assets")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
 		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
 		qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
@@ -550,8 +591,14 @@ var SqliteBaseIndexDB = class extends BaseIndexDB {
 		if (parsedStart && parsedEnd) qb = qb.where("genesisTime", ">", parsedStart).where("genesisTime", "<=", parsedEnd);
 		else if (parsedStart) qb = qb.where("genesisTime", ">", parsedStart);
 		else if (parsedEnd) qb = qb.where("genesisTime", "<=", parsedEnd);
-		if (txs.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("txs")]).as("je")).select("je.value").where("je.value", "in", txs)));
-		if (validators.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("validators")]).as("je")).select("je.value").where("je.value", "in", validators)));
+		if (txs.length) qb = qb.where((eb) => {
+			const conditions = txs.map((v) => eb(sql`INSTR(${sql.ref("txs")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
+		if (validators.length) qb = qb.where((eb) => {
+			const conditions = validators.map((v) => eb(sql`INSTR(${sql.ref("validators")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
 		if (tokenAddress) qb = qb.where((eb) => eb(eb.fn("json_extract", [eb.ref("tokenInfo"), eb.val("$.address")]), "=", tokenAddress));
 		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";

package/esm/db/index.mjs

@@ -1,6 +1,7 @@
 import { createKysely } from "../kysely.mjs";
 import { runMigrations } from "../migrations/index.mjs";
 import base_default from "../table/base.mjs";
+import account_default from "../table/account.mjs";
 import transaction_default from "../table/transaction.mjs";
 import base_default$1 from "./base.mjs";
 import package_default from "../package.mjs";
@@ -96,7 +97,7 @@ var SqliteIndexDB = class extends base_default$1 {
 				]
 			}
 		});
-		this.account = new base_default({
+		this.account = new account_default({
 			name: "account",
 			uniqIndex: "address",
 			db: this.db,

package/esm/interfaces.d.mts

@@ -20,6 +20,7 @@ interface Database {
   tokenDistribution: TokenDistributionTable;
   tokenFactory: TokenFactoryTable;
   balance: BalanceTable;
+  tx_ref: TxRefTable;
 }
 /**
  * Transaction table for indexed transactions
@@ -318,6 +319,16 @@ interface BalanceTable {
   balanceNum: string | null;
   data: string | null;
 }
+/**
+ * Junction table for fast tx JSON array lookups.
+ * Normalizes the JSON array columns (factories, tokens, etc.) into indexed rows.
+ */
+interface TxRefTable {
+  hash: string;
+  type: string;
+  value: string;
+  time: string | null;
+}
 /**
  * SQLite-specific operation context with optional transaction
  */
@@ -325,4 +336,4 @@ interface SqliteOperationContext {
   txn?: Transaction<Database>;
 }
 //#endregion
-export { AccountTable, AssetTable, BalanceTable, Database, DelegationTable, FactoryTable, RollupBlockTable, RollupTable, RollupValidatorTable, SqliteOperationContext, StakeTable, TokenDistributionTable, TokenFactoryTable, TokenTable, TxTable };
+export { AccountTable, AssetTable, BalanceTable, Database, DelegationTable, FactoryTable, RollupBlockTable, RollupTable, RollupValidatorTable, SqliteOperationContext, StakeTable, TokenDistributionTable, TokenFactoryTable, TokenTable, TxRefTable, TxTable };

package/esm/migrations/002-composite-indexes.d.mts

@@ -0,0 +1,12 @@
+import { Kysely } from "kysely";
+
+//#region src/migrations/002-composite-indexes.d.ts
+
+/**
+ * Add composite indexes for covering WHERE + ORDER BY query patterns.
+ * These eliminate filesort when filtering by one column and sorting by another.
+ */
+declare function up(db: Kysely<unknown>): Promise<void>;
+declare function down(db: Kysely<unknown>): Promise<void>;
+//#endregion
+export { down, up };

package/esm/migrations/002-composite-indexes.mjs

@@ -0,0 +1,73 @@
+import { __exportAll } from "../_virtual/rolldown_runtime.mjs";
+import { sql } from "kysely";
+
+//#region src/migrations/002-composite-indexes.ts
+var _002_composite_indexes_exports = /* @__PURE__ */ __exportAll({
+	down: () => down,
+	up: () => up
+});
+/**
+* Add composite indexes for covering WHERE + ORDER BY query patterns.
+* These eliminate filesort when filtering by one column and sorting by another.
+*/
+async function up(db) {
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_sender_time ON tx(sender, time DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_receiver_time ON tx(receiver, time DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_type_time ON tx(type, time DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_valid_time ON tx(valid, time DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_asset_owner_renaissance ON asset(owner, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_asset_parent_renaissance ON asset(parent, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_stake_sender_renaissance ON stake(sender, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_stake_receiver_renaissance ON stake(receiver, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_delegation_from_renaissance ON delegation(from_, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_delegation_to_renaissance ON delegation(to_, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_rollupblock_rollup_genesis ON rollupBlock(rollup, genesisTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_rollupvalidator_rollup_genesis ON rollupValidator(rollup, genesisTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_factory_owner_renaissance ON factory(owner, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_token_issuer_renaissance ON token(issuer, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tokenfactory_owner_renaissance ON tokenFactory(owner, renaissanceTime DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_sender_receiver_time ON tx(sender, receiver, time DESC)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_balance_token_amount ON balance(tokenAddress, balanceNum DESC)`.execute(db);
+	await sql`CREATE TABLE IF NOT EXISTS tx_ref (hash TEXT NOT NULL, type TEXT NOT NULL, value TEXT NOT NULL, time TEXT)`.execute(db);
+	await sql`CREATE UNIQUE INDEX IF NOT EXISTS idx_tx_ref_pk ON tx_ref(hash, type, value)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_ref_lookup ON tx_ref(type, value)`.execute(db);
+	await sql`CREATE INDEX IF NOT EXISTS idx_tx_ref_time_lookup ON tx_ref(type, value, time DESC)`.execute(db);
+	for (const [type, column] of [
+		["factory", "factories"],
+		["token", "tokens"],
+		["asset", "assets"],
+		["account", "accounts"],
+		["rollup", "rollups"],
+		["stake", "stakes"],
+		["delegation", "delegations"],
+		["tokenFactory", "tokenFactories"]
+	]) await sql.raw(`INSERT OR IGNORE INTO tx_ref (hash, type, value, time) SELECT tx.hash, '${type}', je.value, tx.time FROM tx, json_each(tx.${column}) AS je WHERE tx.${column} IS NOT NULL AND tx.${column} != '[]'`).execute(db);
+}
+async function down(db) {
+	for (const idx of [
+		"idx_tx_sender_time",
+		"idx_tx_receiver_time",
+		"idx_tx_type_time",
+		"idx_tx_valid_time",
+		"idx_asset_owner_renaissance",
+		"idx_asset_parent_renaissance",
+		"idx_stake_sender_renaissance",
+		"idx_stake_receiver_renaissance",
+		"idx_delegation_from_renaissance",
+		"idx_delegation_to_renaissance",
+		"idx_rollupblock_rollup_genesis",
+		"idx_rollupvalidator_rollup_genesis",
+		"idx_factory_owner_renaissance",
+		"idx_token_issuer_renaissance",
+		"idx_tokenfactory_owner_renaissance",
+		"idx_tx_sender_receiver_time",
+		"idx_balance_token_amount",
+		"idx_tx_ref_pk",
+		"idx_tx_ref_lookup",
+		"idx_tx_ref_time_lookup"
+	]) await sql.raw(`DROP INDEX IF EXISTS ${idx}`).execute(db);
+	await sql`DROP TABLE IF EXISTS tx_ref`.execute(db);
+}
+
+//#endregion
+export { _002_composite_indexes_exports, down, up };

package/esm/migrations/index.mjs

@@ -1,4 +1,5 @@
 import { _001_genesis_exports } from "./001-genesis.mjs";
+import { _002_composite_indexes_exports } from "./002-composite-indexes.mjs";
 import { Migrator } from "kysely";
 
 //#region src/migrations/index.ts
@@ -8,7 +9,10 @@ import { Migrator } from "kysely";
 */
 var InMemoryMigrationProvider = class {
 	async getMigrations() {
-		return { "001-genesis": _001_genesis_exports };
+		return {
+			"001-genesis": _001_genesis_exports,
+			"002-composite-indexes": _002_composite_indexes_exports
+		};
 	}
 };
 /**

package/esm/table/account.d.mts

@@ -0,0 +1,31 @@
+import SqliteTable from "./base.mjs";
+import { TIndexedAccountState } from "@ocap/types";
+
+//#region src/table/account.d.ts
+
+/**
+ * Account table for SQLite IndexDB
+ * Extends base table to maintain the balance junction table
+ * for fast listTopAccounts queries with tokenAddress filter.
+ */
+declare class AccountTable extends SqliteTable<TIndexedAccountState> {
+  /**
+   * Override _insert to sync balance table after inserting an account.
+   */
+  _insert(row: TIndexedAccountState | Record<string, unknown>): Promise<TIndexedAccountState>;
+  /**
+   * Override _update to sync balance table after updating an account.
+   */
+  _update(key: string | Record<string, unknown>, updates: Partial<TIndexedAccountState>): Promise<TIndexedAccountState>;
+  /**
+   * Sync the balance table from account tokens.
+   * Deletes existing entries for this address, then inserts current token balances.
+   */
+  private syncBalance;
+  /**
+   * Override _reset to also clear the balance table
+   */
+  _reset(): Promise<void>;
+}
+//#endregion
+export { AccountTable as default };

package/esm/table/account.mjs

@@ -0,0 +1,58 @@
+import base_default from "./base.mjs";
+import { sql } from "kysely";
+
+//#region src/table/account.ts
+/**
+* Account table for SQLite IndexDB
+* Extends base table to maintain the balance junction table
+* for fast listTopAccounts queries with tokenAddress filter.
+*/
+var AccountTable = class extends base_default {
+	/**
+	* Override _insert to sync balance table after inserting an account.
+	*/
+	async _insert(row) {
+		const result = await super._insert(row);
+		await this.syncBalance(row);
+		return result;
+	}
+	/**
+	* Override _update to sync balance table after updating an account.
+	*/
+	async _update(key, updates) {
+		const result = await super._update(key, updates);
+		await this.syncBalance(result);
+		return result;
+	}
+	/**
+	* Sync the balance table from account tokens.
+	* Deletes existing entries for this address, then inserts current token balances.
+	*/
+	async syncBalance(data) {
+		const address = data.address;
+		if (!address) return;
+		let tokens = data.tokens;
+		if (typeof tokens === "string") try {
+			tokens = JSON.parse(tokens);
+		} catch {
+			return;
+		}
+		if (!Array.isArray(tokens)) return;
+		await sql`DELETE FROM balance WHERE address = ${address}`.execute(this.db);
+		for (const t of tokens) if (t.address && t.balance && t.balance !== "0") {
+			const balanceNum = (t.balance.replace(/^0+/, "") || "0").padStart(40, "0");
+			await sql`INSERT INTO balance (address, tokenAddress, balance, balanceNum) VALUES (${address}, ${t.address}, ${t.balance}, ${balanceNum})`.execute(this.db);
+		}
+	}
+	/**
+	* Override _reset to also clear the balance table
+	*/
+	async _reset() {
+		await super._reset();
+		await this.db.deleteFrom("balance").execute();
+	}
+};
+var account_default = AccountTable;
+
+//#endregion
+export { account_default as default };

package/esm/table/transaction.d.mts

@@ -6,13 +6,19 @@ import { TIndexedTransaction } from "@ocap/types";
 /**
  * Transaction table for SQLite IndexDB
  * Extends base table to call formatTxBeforeInsert on insert
+ * and maintain the tx_ref junction table for fast JSON array lookups
  */
 declare class TransactionTable extends SqliteTable<TIndexedTransaction> {
   /**
    * Override _insert to format transaction before inserting
-   * This populates assets, tokens, factories, etc. from itxJson
+   * This populates assets, tokens, factories, etc. from itxJson,
+   * then inserts corresponding rows into tx_ref for indexed lookups.
    */
   _insert(row: TIndexedTransaction | Record<string, unknown>): Promise<TIndexedTransaction>;
+  /**
+   * Override _reset to also clear the tx_ref junction table
+   */
+  _reset(): Promise<void>;
 }
 //#endregion
 export { TransactionTable as default };

package/esm/table/transaction.mjs

@@ -1,19 +1,48 @@
 import base_default from "./base.mjs";
+import { sql } from "kysely";
 import { formatTxBeforeInsert } from "@ocap/indexdb";
 
 //#region src/table/transaction.ts
+const TX_REF_TYPES = [
+	["factory", "factories"],
+	["token", "tokens"],
+	["asset", "assets"],
+	["account", "accounts"],
+	["rollup", "rollups"],
+	["stake", "stakes"],
+	["delegation", "delegations"],
+	["tokenFactory", "tokenFactories"]
+];
 /**
 * Transaction table for SQLite IndexDB
 * Extends base table to call formatTxBeforeInsert on insert
+* and maintain the tx_ref junction table for fast JSON array lookups
 */
 var TransactionTable = class extends base_default {
 	/**
 	* Override _insert to format transaction before inserting
-	* This populates assets, tokens, factories, etc. from itxJson
+	* This populates assets, tokens, factories, etc. from itxJson,
+	* then inserts corresponding rows into tx_ref for indexed lookups.
 	*/
 	async _insert(row) {
 		const formatted = formatTxBeforeInsert(row);
-		return super._insert(formatted);
+		const result = await super._insert(formatted);
+		const data = formatted;
+		const hash = data.hash;
+		const time = data.time || null;
+		for (const [type, field] of TX_REF_TYPES) {
+			const values = data[field];
+			if (!Array.isArray(values) || values.length === 0) continue;
+			for (const v of values) if (typeof v === "string" && v) await sql`INSERT OR IGNORE INTO tx_ref (hash, type, value, time) VALUES (${hash}, ${type}, ${v}, ${time})`.execute(this.db);
+		}
+		return result;
+	}
+	/**
+	* Override _reset to also clear the tx_ref junction table
+	*/
+	async _reset() {
+		await super._reset();
+		await this.db.deleteFrom("tx_ref").execute();
 	}
 };
 var transaction_default = TransactionTable;

package/lib/db/base.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let kysely = require("kysely");
 let _ocap_indexdb = require("@ocap/indexdb");
 let _arcblock_did_lib_type = require("@arcblock/did/lib/type");
-let _ocap_util = require("@ocap/util");
 let _ocap_util_lib_constant = require("@ocap/util/lib/constant");
 let debug = require("debug");
 debug = require_rolldown_runtime.__toESM(debug);
@@ -59,8 +59,8 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 			includeItxData
 		});
 		let qb = this.db.selectFrom("tx").selectAll();
-		if (sender && receiver) if (direction === "MUTUAL") qb = qb.where((eb) => eb.or([eb.and([eb("sender", "=", sender), eb("receiver", "=", receiver)]), eb.and([eb("sender", "=", receiver), eb("receiver", "=", sender)])]));
-		else if (direction === "ONE_WAY") qb = qb.where("sender", "=", sender).where("receiver", "=", receiver);
+		const isMutual = !!(sender && receiver && direction === "MUTUAL");
+		if (sender && receiver) if (direction === "MUTUAL") {} else if (direction === "ONE_WAY") qb = qb.where("sender", "=", sender).where("receiver", "=", receiver);
 		else qb = qb.where((eb) => eb.or([eb("sender", "=", sender), eb("receiver", "=", receiver)]));
 		else if (sender) qb = qb.where("sender", "=", sender);
 		else if (receiver) qb = qb.where("receiver", "=", receiver);
@@ -75,18 +75,68 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 		const { validity } = validityFilter;
 		if (validity === "VALID") qb = qb.where("valid", "=", 1);
 		else if (validity === "INVALID") qb = qb.where("valid", "=", 0);
-		if (factories.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("factories")]).as("je")).select("je.value").where("je.value", "in", factories)));
-		if (assets.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("assets")]).as("je")).select("je.value").where("je.value", "in", assets)));
-		if (tokens.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("tokens")]).as("je")).select("je.value").where("je.value", "in", tokens)));
-		if (accounts.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("accounts")]).as("je")).select("je.value").where("je.value", "in", accounts)));
-		if (rollups.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("rollups")]).as("je")).select("je.value").where("je.value", "in", rollups)));
-		if (stakes.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("stakes")]).as("je")).select("je.value").where("je.value", "in", stakes)));
-		if (delegations.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("delegations")]).as("je")).select("je.value").where("je.value", "in", delegations)));
-		if (tokenFactories.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("tokenFactories")]).as("je")).select("je.value").where("je.value", "in", tokenFactories)));
-		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
+		const txRefTypeMap = {
+			factories: "factory",
+			tokens: "token",
+			assets: "asset",
+			accounts: "account",
+			rollups: "rollup",
+			stakes: "stake",
+			delegations: "delegation",
+			tokenFactories: "tokenFactory"
+		};
+		const applyJsonArrayFilter = (column, values) => {
+			const refType = txRefTypeMap[column];
+			qb = qb.where("hash", "in", this.db.selectFrom("tx_ref").select("hash").where("type", "=", refType).where("value", "in", values));
+		};
+		if (factories.length) applyJsonArrayFilter("factories", factories);
+		if (assets.length) applyJsonArrayFilter("assets", assets);
+		if (tokens.length) applyJsonArrayFilter("tokens", tokens);
+		if (accounts.length) applyJsonArrayFilter("accounts", accounts);
+		if (rollups.length) applyJsonArrayFilter("rollups", rollups);
+		if (stakes.length) applyJsonArrayFilter("stakes", stakes);
+		if (delegations.length) applyJsonArrayFilter("delegations", delegations);
+		if (tokenFactories.length) applyJsonArrayFilter("tokenFactories", tokenFactories);
+		let total;
+		const activeJsonFilters = [];
+		if (factories.length) activeJsonFilters.push(["factory", factories]);
+		if (assets.length) activeJsonFilters.push(["asset", assets]);
+		if (tokens.length) activeJsonFilters.push(["token", tokens]);
+		if (accounts.length) activeJsonFilters.push(["account", accounts]);
+		if (rollups.length) activeJsonFilters.push(["rollup", rollups]);
+		if (stakes.length) activeJsonFilters.push(["stake", stakes]);
+		if (delegations.length) activeJsonFilters.push(["delegation", delegations]);
+		if (tokenFactories.length) activeJsonFilters.push(["tokenFactory", tokenFactories]);
+		const hasNonJsonFilters = !!(sender || receiver || types.length || txs.length || parsedStart || parsedEnd || validity);
+		if (isMutual) {
+			const [c1, c2] = await Promise.all([this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", sender).where("receiver", "=", receiver).executeTakeFirst(), this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", receiver).where("receiver", "=", sender).executeTakeFirst()]);
+			total = (c1?.count ?? 0) + (c2?.count ?? 0);
+		} else if (!hasNonJsonFilters && activeJsonFilters.length === 1) {
+			const [refType, values] = activeJsonFilters[0];
+			total = (await this.db.selectFrom("tx_ref").select(this.db.fn.countAll().as("count")).where("type", "=", refType).where("value", "in", values).executeTakeFirst())?.count ?? 0;
+		} else if (sender && receiver && direction !== "ONE_WAY") {
+			const [senderCount, receiverCount] = await Promise.all([this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("sender", "=", sender).executeTakeFirst(), this.db.selectFrom("tx").select(this.db.fn.countAll().as("count")).where("receiver", "=", receiver).executeTakeFirst()]);
+			total = (senderCount?.count ?? 0) + (receiverCount?.count ?? 0);
+		} else total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
-		qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
-		let transactions = (await qb.execute()).map((row) => {
+		let rawResults;
+		if (isMutual) {
+			const q1 = this.db.selectFrom("tx").selectAll().where("sender", "=", sender).where("receiver", "=", receiver);
+			const q2 = this.db.selectFrom("tx").selectAll().where("sender", "=", receiver).where("receiver", "=", sender);
+			rawResults = await q1.unionAll(q2).orderBy(pagination.order.field, orderDir).limit(pagination.size).offset(pagination.cursor).execute();
+		} else if (!hasNonJsonFilters && activeJsonFilters.length === 1 && pagination.order.field === "time") {
+			const [refType, values] = activeJsonFilters[0];
+			const hashes = (await this.db.selectFrom("tx_ref").select("hash").where("type", "=", refType).where("value", "in", values).orderBy("time", orderDir).limit(pagination.size).offset(pagination.cursor).execute()).map((r) => r.hash);
+			if (hashes.length > 0) {
+				const dataRows = await this.db.selectFrom("tx").selectAll().where("hash", "in", hashes).execute();
+				const hashOrder = new Map(hashes.map((h, i) => [h, i]));
+				rawResults = [...dataRows].sort((a, b) => (hashOrder.get(a.hash) ?? 0) - (hashOrder.get(b.hash) ?? 0));
+			} else rawResults = [];
+		} else {
+			qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
+			rawResults = await qb.execute();
+		}
+		let transactions = rawResults.map((row) => {
 			const tx = { ...row };
 			[
 				"receipts",
@@ -216,7 +266,9 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 		};
 	}
 	/**
-	* List top accounts by token balance
+	* List top accounts by token balance.
+	* For tokenAddress filter: uses balance table JOIN for indexed lookup.
+	* Without tokenAddress: uses SQL ORDER BY + LIMIT directly.
 	*/
 	async listTopAccounts(params = {}) {
 		const { paging, tokenAddress } = params;
@@ -234,12 +286,8 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 			paging,
 			pagination
 		});
-		let qb = this.db.selectFrom("account").selectAll();
-		if (pagination.order.field !== "balance") {
-			const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
-			qb = qb.orderBy(pagination.order.field, orderDir);
-		}
-		let accounts = (await qb.execute()).map((row) => {
+		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
+		const parseAccount = (row) => {
 			const account = { ...row };
 			[
 				"stake",
@@ -255,31 +303,21 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 				return token;
 			});
 			return account;
-		});
-		if (tokenAddress) accounts = accounts.filter((acc) => {
-			const tokens = acc.tokens;
-			if (!Array.isArray(tokens)) return false;
-			const owned = tokens.find((t) => t.address === tokenAddress);
-			return owned ? owned.balance > "0" : false;
-		});
-		if (pagination.order.field === "balance" && tokenAddress) {
-			const descending = pagination.order.type === "desc";
-			accounts.sort((a, b) => {
-				const tokensA = a.tokens;
-				const tokensB = b.tokens;
-				const tokenA = tokensA?.find((t) => t.address === tokenAddress);
-				const tokenB = tokensB?.find((t) => t.address === tokenAddress);
-				const balanceA = new _ocap_util.BN(tokenA ? tokenA.balance : "0");
-				const balanceB = new _ocap_util.BN(tokenB ? tokenB.balance : "0");
-				if (balanceB.gt(balanceA)) return descending ? 1 : -1;
-				if (balanceB.eq(balanceA)) return 0;
-				return descending ? -1 : 1;
-			});
+		};
+		if (tokenAddress) {
+			const total$1 = (await this.db.selectFrom("balance").select(this.db.fn.countAll().as("count")).where("tokenAddress", "=", tokenAddress).where("balance", "!=", "0").executeTakeFirst())?.count ?? 0;
+			const sortField$1 = pagination.order.field === "balance" ? "b.balanceNum" : `a.${pagination.order.field}`;
+			return {
+				accounts: (await this.db.selectFrom("balance as b").innerJoin("account as a", "a.address", "b.address").selectAll("a").where("b.tokenAddress", "=", tokenAddress).where("b.balance", "!=", "0").orderBy(sortField$1, orderDir).limit(pagination.size).offset(pagination.cursor).execute()).map(parseAccount),
+				paging: (0, _ocap_indexdb.formatNextPagination)(total$1, pagination)
+			};
 		}
-		const total = accounts.length;
-		accounts = accounts.slice(pagination.cursor, pagination.cursor + pagination.size);
+		let qb = this.db.selectFrom("account").selectAll();
+		const sortField = pagination.order.field === "balance" ? "balanceNum" : pagination.order.field;
+		qb = qb.orderBy(sortField, orderDir);
+		const total = (await this.db.selectFrom("account").select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		return {
-			accounts,
+			accounts: (await qb.limit(pagination.size).offset(pagination.cursor).execute()).map(parseAccount),
 			paging: (0, _ocap_indexdb.formatNextPagination)(total, pagination)
 		};
 	}
@@ -461,7 +499,10 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 		if (parsedStart && parsedEnd) qb = qb.where("renaissanceTime", ">", parsedStart).where("renaissanceTime", "<=", parsedEnd);
 		else if (parsedStart) qb = qb.where("renaissanceTime", ">", parsedStart);
 		else if (parsedEnd) qb = qb.where("renaissanceTime", "<=", parsedEnd);
-		if (assets.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("assets")]).as("je")).select("je.value").where("je.value", "in", assets)));
+		if (assets.length) qb = qb.where((eb) => {
+			const conditions = assets.map((v) => eb(kysely.sql`INSTR(${kysely.sql.ref("assets")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
 		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";
 		qb = qb.orderBy(pagination.order.field, orderDir).offset(pagination.cursor).limit(pagination.size);
@@ -554,8 +595,14 @@ var SqliteBaseIndexDB = class extends _ocap_indexdb.BaseIndexDB {
 		if (parsedStart && parsedEnd) qb = qb.where("genesisTime", ">", parsedStart).where("genesisTime", "<=", parsedEnd);
 		else if (parsedStart) qb = qb.where("genesisTime", ">", parsedStart);
 		else if (parsedEnd) qb = qb.where("genesisTime", "<=", parsedEnd);
-		if (txs.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("txs")]).as("je")).select("je.value").where("je.value", "in", txs)));
-		if (validators.length) qb = qb.where((eb) => eb.exists(eb.selectFrom(eb.fn("json_each", [eb.ref("validators")]).as("je")).select("je.value").where("je.value", "in", validators)));
+		if (txs.length) qb = qb.where((eb) => {
+			const conditions = txs.map((v) => eb(kysely.sql`INSTR(${kysely.sql.ref("txs")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
+		if (validators.length) qb = qb.where((eb) => {
+			const conditions = validators.map((v) => eb(kysely.sql`INSTR(${kysely.sql.ref("validators")}, ${`"${v}"`})`, ">", 0));
+			return conditions.length === 1 ? conditions[0] : eb.or(conditions);
+		});
 		if (tokenAddress) qb = qb.where((eb) => eb(eb.fn("json_extract", [eb.ref("tokenInfo"), eb.val("$.address")]), "=", tokenAddress));
 		const total = (await qb.clearSelect().select(this.db.fn.countAll().as("count")).executeTakeFirst())?.count ?? 0;
 		const orderDir = pagination.order.type === "desc" ? "desc" : "asc";

package/lib/db/base.d.cts

@@ -36,7 +36,9 @@ declare class SqliteBaseIndexDB extends BaseIndexDB implements IIndexDB {
    */
   listAssets(params?: Partial<TRequestListAssets>): Promise<IListAssetsResult>;
   /**
-   * List top accounts by token balance
+   * List top accounts by token balance.
+   * For tokenAddress filter: uses balance table JOIN for indexed lookup.
+   * Without tokenAddress: uses SQL ORDER BY + LIMIT directly.
    */
   listTopAccounts(params?: Partial<TRequestListTopAccounts>): Promise<IListAccountsResult>;
   /**

package/lib/db/index.cjs

@@ -2,6 +2,7 @@ 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_account = require('../table/account.cjs');
 const require_table_transaction = require('../table/transaction.cjs');
 const require_db_base = require('./base.cjs');
 const require_package = require('../package.cjs');
@@ -97,7 +98,7 @@ var SqliteIndexDB = class extends require_db_base.default {
 				]
 			}
 		});
-		this.account = new require_table_base.default({
+		this.account = new require_table_account.default({
 			name: "account",
 			uniqIndex: "address",
 			db: this.db,

package/lib/interfaces.d.cts

@@ -20,6 +20,7 @@ interface Database {
   tokenDistribution: TokenDistributionTable;
   tokenFactory: TokenFactoryTable;
   balance: BalanceTable;
+  tx_ref: TxRefTable;
 }
 /**
  * Transaction table for indexed transactions
@@ -318,6 +319,16 @@ interface BalanceTable {
   balanceNum: string | null;
   data: string | null;
 }
+/**
+ * Junction table for fast tx JSON array lookups.
+ * Normalizes the JSON array columns (factories, tokens, etc.) into indexed rows.
+ */
+interface TxRefTable {
+  hash: string;
+  type: string;
+  value: string;
+  time: string | null;
+}
 /**
  * SQLite-specific operation context with optional transaction
  */
@@ -325,4 +336,4 @@ interface SqliteOperationContext {
   txn?: Transaction<Database>;
 }
 //#endregion
-export { AccountTable, AssetTable, BalanceTable, Database, DelegationTable, FactoryTable, RollupBlockTable, RollupTable, RollupValidatorTable, SqliteOperationContext, StakeTable, TokenDistributionTable, TokenFactoryTable, TokenTable, TxTable };
+export { AccountTable, AssetTable, BalanceTable, Database, DelegationTable, FactoryTable, RollupBlockTable, RollupTable, RollupValidatorTable, SqliteOperationContext, StakeTable, TokenDistributionTable, TokenFactoryTable, TokenTable, TxRefTable, TxTable };

package/lib/migrations/002-composite-indexes.cjs

@@ -0,0 +1,80 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let kysely = require("kysely");
+
+//#region src/migrations/002-composite-indexes.ts
+var _002_composite_indexes_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	down: () => down,
+	up: () => up
+});
+/**
+* Add composite indexes for covering WHERE + ORDER BY query patterns.
+* These eliminate filesort when filtering by one column and sorting by another.
+*/
+async function up(db) {
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_sender_time ON tx(sender, time DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_receiver_time ON tx(receiver, time DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_type_time ON tx(type, time DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_valid_time ON tx(valid, time DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_asset_owner_renaissance ON asset(owner, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_asset_parent_renaissance ON asset(parent, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_stake_sender_renaissance ON stake(sender, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_stake_receiver_renaissance ON stake(receiver, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_delegation_from_renaissance ON delegation(from_, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_delegation_to_renaissance ON delegation(to_, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_rollupblock_rollup_genesis ON rollupBlock(rollup, genesisTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_rollupvalidator_rollup_genesis ON rollupValidator(rollup, genesisTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_factory_owner_renaissance ON factory(owner, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_token_issuer_renaissance ON token(issuer, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tokenfactory_owner_renaissance ON tokenFactory(owner, renaissanceTime DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_sender_receiver_time ON tx(sender, receiver, time DESC)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_balance_token_amount ON balance(tokenAddress, balanceNum DESC)`.execute(db);
+	await kysely.sql`CREATE TABLE IF NOT EXISTS tx_ref (hash TEXT NOT NULL, type TEXT NOT NULL, value TEXT NOT NULL, time TEXT)`.execute(db);
+	await kysely.sql`CREATE UNIQUE INDEX IF NOT EXISTS idx_tx_ref_pk ON tx_ref(hash, type, value)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_ref_lookup ON tx_ref(type, value)`.execute(db);
+	await kysely.sql`CREATE INDEX IF NOT EXISTS idx_tx_ref_time_lookup ON tx_ref(type, value, time DESC)`.execute(db);
+	for (const [type, column] of [
+		["factory", "factories"],
+		["token", "tokens"],
+		["asset", "assets"],
+		["account", "accounts"],
+		["rollup", "rollups"],
+		["stake", "stakes"],
+		["delegation", "delegations"],
+		["tokenFactory", "tokenFactories"]
+	]) await kysely.sql.raw(`INSERT OR IGNORE INTO tx_ref (hash, type, value, time) SELECT tx.hash, '${type}', je.value, tx.time FROM tx, json_each(tx.${column}) AS je WHERE tx.${column} IS NOT NULL AND tx.${column} != '[]'`).execute(db);
+}
+async function down(db) {
+	for (const idx of [
+		"idx_tx_sender_time",
+		"idx_tx_receiver_time",
+		"idx_tx_type_time",
+		"idx_tx_valid_time",
+		"idx_asset_owner_renaissance",
+		"idx_asset_parent_renaissance",
+		"idx_stake_sender_renaissance",
+		"idx_stake_receiver_renaissance",
+		"idx_delegation_from_renaissance",
+		"idx_delegation_to_renaissance",
+		"idx_rollupblock_rollup_genesis",
+		"idx_rollupvalidator_rollup_genesis",
+		"idx_factory_owner_renaissance",
+		"idx_token_issuer_renaissance",
+		"idx_tokenfactory_owner_renaissance",
+		"idx_tx_sender_receiver_time",
+		"idx_balance_token_amount",
+		"idx_tx_ref_pk",
+		"idx_tx_ref_lookup",
+		"idx_tx_ref_time_lookup"
+	]) await kysely.sql.raw(`DROP INDEX IF EXISTS ${idx}`).execute(db);
+	await kysely.sql`DROP TABLE IF EXISTS tx_ref`.execute(db);
+}
+
+//#endregion
+Object.defineProperty(exports, '_002_composite_indexes_exports', {
+  enumerable: true,
+  get: function () {
+    return _002_composite_indexes_exports;
+  }
+});
+exports.down = down;
+exports.up = up;

package/lib/migrations/002-composite-indexes.d.cts

@@ -0,0 +1,12 @@
+import { Kysely } from "kysely";
+
+//#region src/migrations/002-composite-indexes.d.ts
+
+/**
+ * Add composite indexes for covering WHERE + ORDER BY query patterns.
+ * These eliminate filesort when filtering by one column and sorting by another.
+ */
+declare function up(db: Kysely<unknown>): Promise<void>;
+declare function down(db: Kysely<unknown>): Promise<void>;
+//#endregion
+export { down, up };

package/lib/migrations/index.cjs

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_migrations_001_genesis = require('./001-genesis.cjs');
+const require_migrations_002_composite_indexes = require('./002-composite-indexes.cjs');
 let kysely = require("kysely");
 
 //#region src/migrations/index.ts
@@ -9,7 +10,10 @@ let kysely = require("kysely");
 */
 var InMemoryMigrationProvider = class {
 	async getMigrations() {
-		return { "001-genesis": require_migrations_001_genesis._001_genesis_exports };
+		return {
+			"001-genesis": require_migrations_001_genesis._001_genesis_exports,
+			"002-composite-indexes": require_migrations_002_composite_indexes._002_composite_indexes_exports
+		};
 	}
 };
 /**

package/lib/table/account.cjs

@@ -0,0 +1,60 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_table_base = require('./base.cjs');
+let kysely = require("kysely");
+
+//#region src/table/account.ts
+/**
+* Account table for SQLite IndexDB
+* Extends base table to maintain the balance junction table
+* for fast listTopAccounts queries with tokenAddress filter.
+*/
+var AccountTable = class extends require_table_base.default {
+	/**
+	* Override _insert to sync balance table after inserting an account.
+	*/
+	async _insert(row) {
+		const result = await super._insert(row);
+		await this.syncBalance(row);
+		return result;
+	}
+	/**
+	* Override _update to sync balance table after updating an account.
+	*/
+	async _update(key, updates) {
+		const result = await super._update(key, updates);
+		await this.syncBalance(result);
+		return result;
+	}
+	/**
+	* Sync the balance table from account tokens.
+	* Deletes existing entries for this address, then inserts current token balances.
+	*/
+	async syncBalance(data) {
+		const address = data.address;
+		if (!address) return;
+		let tokens = data.tokens;
+		if (typeof tokens === "string") try {
+			tokens = JSON.parse(tokens);
+		} catch {
+			return;
+		}
+		if (!Array.isArray(tokens)) return;
+		await kysely.sql`DELETE FROM balance WHERE address = ${address}`.execute(this.db);
+		for (const t of tokens) if (t.address && t.balance && t.balance !== "0") {
+			const balanceNum = (t.balance.replace(/^0+/, "") || "0").padStart(40, "0");
+			await kysely.sql`INSERT INTO balance (address, tokenAddress, balance, balanceNum) VALUES (${address}, ${t.address}, ${t.balance}, ${balanceNum})`.execute(this.db);
+		}
+	}
+	/**
+	* Override _reset to also clear the balance table
+	*/
+	async _reset() {
+		await super._reset();
+		await this.db.deleteFrom("balance").execute();
+	}
+};
+var account_default = AccountTable;
+
+//#endregion
+exports.default = account_default;

package/lib/table/account.d.cts

@@ -0,0 +1,31 @@
+import SqliteTable from "./base.cjs";
+import { TIndexedAccountState } from "@ocap/types";
+
+//#region src/table/account.d.ts
+
+/**
+ * Account table for SQLite IndexDB
+ * Extends base table to maintain the balance junction table
+ * for fast listTopAccounts queries with tokenAddress filter.
+ */
+declare class AccountTable extends SqliteTable<TIndexedAccountState> {
+  /**
+   * Override _insert to sync balance table after inserting an account.
+   */
+  _insert(row: TIndexedAccountState | Record<string, unknown>): Promise<TIndexedAccountState>;
+  /**
+   * Override _update to sync balance table after updating an account.
+   */
+  _update(key: string | Record<string, unknown>, updates: Partial<TIndexedAccountState>): Promise<TIndexedAccountState>;
+  /**
+   * Sync the balance table from account tokens.
+   * Deletes existing entries for this address, then inserts current token balances.
+   */
+  private syncBalance;
+  /**
+   * Override _reset to also clear the balance table
+   */
+  _reset(): Promise<void>;
+}
+//#endregion
+export { AccountTable as default };

package/lib/table/transaction.cjs

@@ -1,21 +1,50 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_table_base = require('./base.cjs');
+let kysely = require("kysely");
 let _ocap_indexdb = require("@ocap/indexdb");
 
 //#region src/table/transaction.ts
+const TX_REF_TYPES = [
+	["factory", "factories"],
+	["token", "tokens"],
+	["asset", "assets"],
+	["account", "accounts"],
+	["rollup", "rollups"],
+	["stake", "stakes"],
+	["delegation", "delegations"],
+	["tokenFactory", "tokenFactories"]
+];
 /**
 * Transaction table for SQLite IndexDB
 * Extends base table to call formatTxBeforeInsert on insert
+* and maintain the tx_ref junction table for fast JSON array lookups
 */
 var TransactionTable = class extends require_table_base.default {
 	/**
 	* Override _insert to format transaction before inserting
-	* This populates assets, tokens, factories, etc. from itxJson
+	* This populates assets, tokens, factories, etc. from itxJson,
+	* then inserts corresponding rows into tx_ref for indexed lookups.
 	*/
 	async _insert(row) {
 		const formatted = (0, _ocap_indexdb.formatTxBeforeInsert)(row);
-		return super._insert(formatted);
+		const result = await super._insert(formatted);
+		const data = formatted;
+		const hash = data.hash;
+		const time = data.time || null;
+		for (const [type, field] of TX_REF_TYPES) {
+			const values = data[field];
+			if (!Array.isArray(values) || values.length === 0) continue;
+			for (const v of values) if (typeof v === "string" && v) await kysely.sql`INSERT OR IGNORE INTO tx_ref (hash, type, value, time) VALUES (${hash}, ${type}, ${v}, ${time})`.execute(this.db);
+		}
+		return result;
+	}
+	/**
+	* Override _reset to also clear the tx_ref junction table
+	*/
+	async _reset() {
+		await super._reset();
+		await this.db.deleteFrom("tx_ref").execute();
 	}
 };
 var transaction_default = TransactionTable;

package/lib/table/transaction.d.cts

@@ -6,13 +6,19 @@ import { TIndexedTransaction } from "@ocap/types";
 /**
  * Transaction table for SQLite IndexDB
  * Extends base table to call formatTxBeforeInsert on insert
+ * and maintain the tx_ref junction table for fast JSON array lookups
  */
 declare class TransactionTable extends SqliteTable<TIndexedTransaction> {
   /**
    * Override _insert to format transaction before inserting
-   * This populates assets, tokens, factories, etc. from itxJson
+   * This populates assets, tokens, factories, etc. from itxJson,
+   * then inserts corresponding rows into tx_ref for indexed lookups.
    */
   _insert(row: TIndexedTransaction | Record<string, unknown>): Promise<TIndexedTransaction>;
+  /**
+   * Override _reset to also clear the tx_ref junction table
+   */
+  _reset(): Promise<void>;
 }
 //#endregion
 export { TransactionTable as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ocap/indexdb-sqlite",
   "description": "OCAP indexdb adapter that uses SQLite as backend",
-  "version": "1.29.8",
+  "version": "1.29.10",
   "author": "wangshijun <shijun@arcblock.io> (https://www.arcblock.io)",
   "bugs": {
     "url": "https://github.com/ArcBlock/blockchain/issues",
@@ -14,7 +14,7 @@
     "wangshijun <shijun@arcblock.io> (https://www.arcblock.io)"
   ],
   "devDependencies": {
-    "@ocap/indexdb-test": "1.29.8"
+    "@ocap/indexdb-test": "1.29.10"
   },
   "homepage": "https://github.com/ArcBlock/blockchain/tree/master/indexdb/sqlite",
   "keywords": [
@@ -63,10 +63,10 @@
     "clean": "rm -rf lib esm"
   },
   "dependencies": {
-    "@arcblock/did": "1.29.8",
-    "@ocap/indexdb": "1.29.8",
-    "@ocap/types": "1.29.8",
-    "@ocap/util": "1.29.8",
+    "@arcblock/did": "1.29.10",
+    "@ocap/indexdb": "1.29.10",
+    "@ocap/types": "1.29.10",
+    "@ocap/util": "1.29.10",
     "debug": "^4.4.3",
     "better-sqlite3": "^11.8.1",
     "kysely": "^0.27.0",