@secondlayer/shared 6.8.1 → 6.10.0

package/dist/src/db/queries/contracts.js

@@ -0,0 +1,90 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/db/jsonb.ts
+import { sql } from "kysely";
+function jsonb(value) {
+  const escaped = JSON.stringify(value, (_k, v) => typeof v === "bigint" ? v.toString() : v).replace(/'/g, "''");
+  return sql`${sql.raw(`'${escaped}'::jsonb`)}`;
+}
+function parseJsonb(value) {
+  if (typeof value === "string") {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return value;
+    }
+  }
+  return value ?? {};
+}
+
+// src/db/queries/contracts.ts
+import { sql as sql2 } from "kysely";
+async function recordContractDeploy(db, row) {
+  await db.insertInto("contracts").values({
+    contract_id: row.contractId,
+    deployer: row.deployer,
+    block_height: row.blockHeight
+  }).onConflict((oc) => oc.column("contract_id").doNothing()).execute();
+}
+async function setContractAbi(db, contractId, data) {
+  await db.updateTable("contracts").set({
+    abi: data.abi == null ? null : jsonb(data.abi),
+    abi_status: data.status,
+    abi_fetched_at: new Date,
+    ...data.declaredTraits ? { declared_traits: data.declaredTraits } : {},
+    ...data.inferredStandards ? { inferred_standards: data.inferredStandards } : {}
+  }).where("contract_id", "=", contractId).execute();
+}
+async function getContract(db, contractId) {
+  return await db.selectFrom("contracts").selectAll().where("contract_id", "=", contractId).executeTakeFirst() ?? null;
+}
+async function listContractsPendingAbi(db, limit = 100) {
+  return db.selectFrom("contracts").selectAll().where("abi_status", "=", "pending").where("canonical", "=", true).orderBy("block_height", "asc").limit(limit).execute();
+}
+async function listContractsByTrait(db, trait, opts = {}) {
+  const conformance = opts.conformance ?? "any";
+  let q = db.selectFrom("contracts").selectAll().where("canonical", "=", true);
+  if (conformance === "declared") {
+    q = q.where(sql2`${sql2.ref("declared_traits")} @> ARRAY[${trait}]`);
+  } else if (conformance === "inferred") {
+    q = q.where(sql2`${sql2.ref("inferred_standards")} @> ARRAY[${trait}]`);
+  } else {
+    q = q.where(sql2`(${sql2.ref("declared_traits")} @> ARRAY[${trait}] OR ${sql2.ref("inferred_standards")} @> ARRAY[${trait}])`);
+  }
+  if (opts.afterId)
+    q = q.where("contract_id", ">", opts.afterId);
+  return q.orderBy("contract_id", "asc").limit(opts.limit ?? 100).execute();
+}
+async function resolveTraitContractIds(db, trait, asOfBlock) {
+  const rows = await db.selectFrom("contracts").select("contract_id").where("canonical", "=", true).where("block_height", "<=", asOfBlock).where(sql2`(${sql2.ref("declared_traits")} @> ARRAY[${trait}] OR ${sql2.ref("inferred_standards")} @> ARRAY[${trait}])`).execute();
+  return rows.map((r) => r.contract_id);
+}
+async function markContractsNonCanonical(db, fromBlockHeight) {
+  await db.updateTable("contracts").set({ canonical: false }).where("block_height", ">=", fromBlockHeight).execute();
+}
+export {
+  setContractAbi,
+  resolveTraitContractIds,
+  recordContractDeploy,
+  markContractsNonCanonical,
+  listContractsPendingAbi,
+  listContractsByTrait,
+  getContract
+};
+
+//# debugId=FF480204BC0AAD0A64756E2164756E21
+//# sourceMappingURL=contracts.js.map

package/dist/src/db/queries/contracts.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/db/jsonb.ts", "../src/db/queries/contracts.ts"],
+  "sourcesContent": [
+    "import { type RawBuilder, sql } from \"kysely\";\n\n/**\n * Safely encode a JS value as a JSONB literal for Kysely inserts/updates.\n * Kysely + postgres.js double-encodes JSON when using parameterized queries\n * with ::jsonb casts. This uses sql.raw to inline a properly escaped literal.\n *\n * Generic parameter lets callers set the RawBuilder's output type so they\n * don't need to cast at the insert site. Default is `unknown` — widen at\n * the call site when the column type is narrower, e.g. `jsonb<MyShape>(...)`.\n */\nexport function jsonb<T = unknown>(value: T): RawBuilder<T> {\n\tconst escaped = JSON.stringify(value, (_k, v) =>\n\t\ttypeof v === \"bigint\" ? v.toString() : v,\n\t).replace(/'/g, \"''\");\n\treturn sql`${sql.raw(`'${escaped}'::jsonb`)}`;\n}\n\n/**\n * Safely parse a JSONB value from the database.\n * Handles double-encoded strings where postgres.js returns a JSON string\n * instead of a parsed object.\n */\nexport function parseJsonb<T = unknown>(value: unknown): T {\n\tif (typeof value === \"string\") {\n\t\ttry {\n\t\t\treturn JSON.parse(value) as T;\n\t\t} catch {\n\t\t\treturn value as T;\n\t\t}\n\t}\n\treturn (value ?? {}) as T;\n}\n",
+    "import { type Kysely, sql } from \"kysely\";\nimport { jsonb } from \"../jsonb.ts\";\nimport type { Contract, Database } from \"../types.ts\";\n\n/**\n * Contract registry queries — backing for trait-based discovery. Populated from\n * contract deploys; ABI fetched async; standards inferred by static analysis.\n */\n\nexport type AbiStatus = \"pending\" | \"fetched\" | \"failed\" | \"unparseable\";\n\n/** Record a contract deploy (idempotent). ABI is fetched separately + async. */\nexport async function recordContractDeploy(\n\tdb: Kysely<Database>,\n\trow: { contractId: string; deployer: string; blockHeight: number },\n): Promise<void> {\n\tawait db\n\t\t.insertInto(\"contracts\")\n\t\t.values({\n\t\t\tcontract_id: row.contractId,\n\t\t\tdeployer: row.deployer,\n\t\t\tblock_height: row.blockHeight,\n\t\t})\n\t\t.onConflict((oc) => oc.column(\"contract_id\").doNothing())\n\t\t.execute();\n}\n\n/** Store a fetched ABI + the traits/standards derived from it. */\nexport async function setContractAbi(\n\tdb: Kysely<Database>,\n\tcontractId: string,\n\tdata: {\n\t\tabi: unknown | null;\n\t\tstatus: AbiStatus;\n\t\tdeclaredTraits?: string[];\n\t\tinferredStandards?: string[];\n\t},\n): Promise<void> {\n\tawait db\n\t\t.updateTable(\"contracts\")\n\t\t.set({\n\t\t\tabi: data.abi == null ? null : jsonb(data.abi),\n\t\t\tabi_status: data.status,\n\t\t\tabi_fetched_at: new Date(),\n\t\t\t...(data.declaredTraits ? { declared_traits: data.declaredTraits } : {}),\n\t\t\t...(data.inferredStandards\n\t\t\t\t? { inferred_standards: data.inferredStandards }\n\t\t\t\t: {}),\n\t\t})\n\t\t.where(\"contract_id\", \"=\", contractId)\n\t\t.execute();\n}\n\nexport async function getContract(\n\tdb: Kysely<Database>,\n\tcontractId: string,\n): Promise<Contract | null> {\n\treturn (\n\t\t(await db\n\t\t\t.selectFrom(\"contracts\")\n\t\t\t.selectAll()\n\t\t\t.where(\"contract_id\", \"=\", contractId)\n\t\t\t.executeTakeFirst()) ?? null\n\t);\n}\n\n/** Contracts still awaiting an ABI fetch (drives the fetch/backfill worker). */\nexport async function listContractsPendingAbi(\n\tdb: Kysely<Database>,\n\tlimit = 100,\n): Promise<Contract[]> {\n\treturn db\n\t\t.selectFrom(\"contracts\")\n\t\t.selectAll()\n\t\t.where(\"abi_status\", \"=\", \"pending\")\n\t\t.where(\"canonical\", \"=\", true)\n\t\t.orderBy(\"block_height\", \"asc\")\n\t\t.limit(limit)\n\t\t.execute();\n}\n\nexport type Conformance = \"declared\" | \"inferred\" | \"any\";\n\n/** Discovery: contracts matching a trait/standard, by conformance source. */\nexport async function listContractsByTrait(\n\tdb: Kysely<Database>,\n\ttrait: string,\n\topts: { conformance?: Conformance; limit?: number; afterId?: string } = {},\n): Promise<Contract[]> {\n\tconst conformance = opts.conformance ?? \"any\";\n\tlet q = db.selectFrom(\"contracts\").selectAll().where(\"canonical\", \"=\", true);\n\n\tif (conformance === \"declared\") {\n\t\tq = q.where(sql<boolean>`${sql.ref(\"declared_traits\")} @> ARRAY[${trait}]`);\n\t} else if (conformance === \"inferred\") {\n\t\tq = q.where(\n\t\t\tsql<boolean>`${sql.ref(\"inferred_standards\")} @> ARRAY[${trait}]`,\n\t\t);\n\t} else {\n\t\tq = q.where(\n\t\t\tsql<boolean>`(${sql.ref(\"declared_traits\")} @> ARRAY[${trait}] OR ${sql.ref(\"inferred_standards\")} @> ARRAY[${trait}])`,\n\t\t);\n\t}\n\n\tif (opts.afterId) q = q.where(\"contract_id\", \">\", opts.afterId);\n\treturn q\n\t\t.orderBy(\"contract_id\", \"asc\")\n\t\t.limit(opts.limit ?? 100)\n\t\t.execute();\n}\n\n/**\n * As-of-block trait resolution (B4): contract IDs conforming to `trait` whose\n * deploy block ≤ `asOfBlock`. Lets a trait-scoped subgraph reindex a token's\n * full history even if classification lagged its deploy.\n */\nexport async function resolveTraitContractIds(\n\tdb: Kysely<Database>,\n\ttrait: string,\n\tasOfBlock: number,\n): Promise<string[]> {\n\tconst rows = await db\n\t\t.selectFrom(\"contracts\")\n\t\t.select(\"contract_id\")\n\t\t.where(\"canonical\", \"=\", true)\n\t\t.where(\"block_height\", \"<=\", asOfBlock)\n\t\t.where(\n\t\t\tsql<boolean>`(${sql.ref(\"declared_traits\")} @> ARRAY[${trait}] OR ${sql.ref(\"inferred_standards\")} @> ARRAY[${trait}])`,\n\t\t)\n\t\t.execute();\n\treturn rows.map((r) => r.contract_id);\n}\n\n/** Reorg: flip contracts deployed at/above a reorged height to non-canonical. */\nexport async function markContractsNonCanonical(\n\tdb: Kysely<Database>,\n\tfromBlockHeight: number,\n): Promise<void> {\n\tawait db\n\t\t.updateTable(\"contracts\")\n\t\t.set({ canonical: false })\n\t\t.where(\"block_height\", \">=\", fromBlockHeight)\n\t\t.execute();\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "FF480204BC0AAD0A64756E2164756E21",
+  "names": []
+}

package/dist/src/db/queries/integrity.d.ts

@@ -61,9 +61,22 @@ interface SubgraphsTable {
 	handler_code: string | null;
 	source_code: string | null;
 	project_id: string | null;
+	database_url_enc: ColumnType<Buffer | null, Buffer | null | undefined, Buffer | null>;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
+interface ContractsTable {
+	contract_id: string;
+	deployer: string;
+	block_height: number;
+	canonical: Generated<boolean>;
+	abi: unknown | null;
+	declared_traits: Generated<string[]>;
+	inferred_standards: Generated<string[]>;
+	abi_status: Generated<string>;
+	abi_fetched_at: Date | null;
+	created_at: Generated<Date>;
+}
 interface SubgraphGapsTable {
 	id: Generated<string>;
 	subgraph_id: string;
@@ -367,6 +380,26 @@ interface Pox4SignersDailyTable {
 	aggregation_calls: Generated<number>;
 	updated_at: Generated<Date>;
 }
+interface BurnBlockRewardsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	reward_index: number;
+	recipient_btc: string;
+	amount_sats: string;
+	burn_amount: Generated<string>;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
 type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
 interface SbtcEventsTable {
 	cursor: string;
@@ -519,6 +552,7 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	index_progress: IndexProgressTable;
+	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
 	accounts: AccountsTable;
@@ -554,6 +588,8 @@ interface Database {
 	pox4_calls: Pox4CallsTable;
 	pox4_cycles_daily: Pox4CyclesDailyTable;
 	pox4_signers_daily: Pox4SignersDailyTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;

package/dist/src/db/queries/subgraph-gaps.d.ts

@@ -61,9 +61,22 @@ interface SubgraphsTable {
 	handler_code: string | null;
 	source_code: string | null;
 	project_id: string | null;
+	database_url_enc: ColumnType<Buffer | null, Buffer | null | undefined, Buffer | null>;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
+interface ContractsTable {
+	contract_id: string;
+	deployer: string;
+	block_height: number;
+	canonical: Generated<boolean>;
+	abi: unknown | null;
+	declared_traits: Generated<string[]>;
+	inferred_standards: Generated<string[]>;
+	abi_status: Generated<string>;
+	abi_fetched_at: Date | null;
+	created_at: Generated<Date>;
+}
 interface SubgraphGapsTable {
 	id: Generated<string>;
 	subgraph_id: string;
@@ -367,6 +380,26 @@ interface Pox4SignersDailyTable {
 	aggregation_calls: Generated<number>;
 	updated_at: Generated<Date>;
 }
+interface BurnBlockRewardsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	reward_index: number;
+	recipient_btc: string;
+	amount_sats: string;
+	burn_amount: Generated<string>;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
 type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
 interface SbtcEventsTable {
 	cursor: string;
@@ -519,6 +552,7 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	index_progress: IndexProgressTable;
+	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
 	accounts: AccountsTable;
@@ -554,6 +588,8 @@ interface Database {
 	pox4_calls: Pox4CallsTable;
 	pox4_cycles_daily: Pox4CyclesDailyTable;
 	pox4_signers_daily: Pox4SignersDailyTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;

package/dist/src/db/queries/subgraph-operations.d.ts

@@ -61,9 +61,22 @@ interface SubgraphsTable {
 	handler_code: string | null;
 	source_code: string | null;
 	project_id: string | null;
+	database_url_enc: ColumnType<Buffer | null, Buffer | null | undefined, Buffer | null>;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
+interface ContractsTable {
+	contract_id: string;
+	deployer: string;
+	block_height: number;
+	canonical: Generated<boolean>;
+	abi: unknown | null;
+	declared_traits: Generated<string[]>;
+	inferred_standards: Generated<string[]>;
+	abi_status: Generated<string>;
+	abi_fetched_at: Date | null;
+	created_at: Generated<Date>;
+}
 interface SubgraphGapsTable {
 	id: Generated<string>;
 	subgraph_id: string;
@@ -367,6 +380,26 @@ interface Pox4SignersDailyTable {
 	aggregation_calls: Generated<number>;
 	updated_at: Generated<Date>;
 }
+interface BurnBlockRewardsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	reward_index: number;
+	recipient_btc: string;
+	amount_sats: string;
+	burn_amount: Generated<string>;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
 type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
 interface SbtcEventsTable {
 	cursor: string;
@@ -519,6 +552,7 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	index_progress: IndexProgressTable;
+	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
 	accounts: AccountsTable;
@@ -554,6 +588,8 @@ interface Database {
 	pox4_calls: Pox4CallsTable;
 	pox4_cycles_daily: Pox4CyclesDailyTable;
 	pox4_signers_daily: Pox4SignersDailyTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;

package/dist/src/db/queries/subgraphs.d.ts

@@ -1,4 +1,5 @@
 import { Kysely } from "kysely";
+import postgres from "postgres";
 import { ColumnType, Generated, Selectable } from "kysely";
 interface BlocksTable {
 	height: number;
@@ -61,9 +62,22 @@ interface SubgraphsTable {
 	handler_code: string | null;
 	source_code: string | null;
 	project_id: string | null;
+	database_url_enc: ColumnType<Buffer | null, Buffer | null | undefined, Buffer | null>;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
+interface ContractsTable {
+	contract_id: string;
+	deployer: string;
+	block_height: number;
+	canonical: Generated<boolean>;
+	abi: unknown | null;
+	declared_traits: Generated<string[]>;
+	inferred_standards: Generated<string[]>;
+	abi_status: Generated<string>;
+	abi_fetched_at: Date | null;
+	created_at: Generated<Date>;
+}
 interface SubgraphGapsTable {
 	id: Generated<string>;
 	subgraph_id: string;
@@ -367,6 +381,26 @@ interface Pox4SignersDailyTable {
 	aggregation_calls: Generated<number>;
 	updated_at: Generated<Date>;
 }
+interface BurnBlockRewardsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	reward_index: number;
+	recipient_btc: string;
+	amount_sats: string;
+	burn_amount: Generated<string>;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
 type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
 interface SbtcEventsTable {
 	cursor: string;
@@ -519,6 +553,7 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	index_progress: IndexProgressTable;
+	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
 	accounts: AccountsTable;
@@ -554,6 +589,8 @@ interface Database {
 	pox4_calls: Pox4CallsTable;
 	pox4_cycles_daily: Pox4CyclesDailyTable;
 	pox4_signers_daily: Pox4SignersDailyTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;
@@ -709,6 +746,24 @@ interface SubscriptionDeliveriesTable {
 	dispatched_at: Generated<Date>;
 }
 /**
+* BYO data plane helpers. A subgraph's user-owned Postgres connection string is
+* stored encrypted at rest in `database_url_enc` (AES-GCM envelope). Plaintext
+* only exists transiently — at deploy (to encrypt) and at pool construction (to
+* connect). Never serialize it into API responses.
+*/
+declare function encryptDatabaseUrl(url: string): Buffer;
+/** Decrypt a subgraph's BYO connection string, or null when managed. */
+declare function subgraphDatabaseUrl(subgraph: Subgraph): string | null;
+/** True when the subgraph writes/serves from a user-owned DB. */
+declare function isByoSubgraph(subgraph: Subgraph): boolean;
+/**
+* Resolve the Kysely instance a subgraph's data plane lives on: the user's DB
+* when BYO, else the managed target DB. Pools are cached by URL in db/index.ts.
+*/
+declare function resolveSubgraphDb(subgraph: Subgraph): Kysely<Database>;
+/** Raw postgres.js client for a subgraph's data plane (DDL / serving queries). */
+declare function resolveSubgraphRawClient(subgraph: Subgraph): ReturnType<typeof postgres>;
+/**
 * Convert a subgraph name to its PostgreSQL schema name (legacy form).
 * Pre shared-rip every tenant DB had its own schema namespace so disambiguation
 * was implicit. Kept for oss mode (single-tenant) and legacy-row fallback.
@@ -733,6 +788,8 @@ declare function registerSubgraph(db: Kysely<Database>, data: {
 	startBlock?: number
 	handlerCode?: string
 	sourceCode?: string
+	/** BYO data plane: encrypted user-DB connection string, or null = managed. */
+	databaseUrlEnc?: Buffer | null
 }): Promise<Subgraph>;
 declare function getSubgraph(db: Kysely<Database>, name: string, accountId?: string): Promise<Subgraph | null>;
 declare function listSubgraphs(db: Kysely<Database>, accountId?: string): Promise<Subgraph[]>;
@@ -743,4 +800,4 @@ declare function updateSubgraphHandlerPath(db: Kysely<Database>, name: string, h
 	sourceCode?: string
 }): Promise<void>;
 declare function deleteSubgraph(db: Kysely<Database>, name: string, accountId?: string): Promise<Subgraph | null>;
-export { updateSubgraphStatus, updateSubgraphHandlerPath, registerSubgraph, recordSubgraphProcessed, pgSchemaNameFor, pgSchemaName, listSubgraphs, getSubgraph, deleteSubgraph };
+export { updateSubgraphStatus, updateSubgraphHandlerPath, subgraphDatabaseUrl, resolveSubgraphRawClient, resolveSubgraphDb, registerSubgraph, recordSubgraphProcessed, pgSchemaNameFor, pgSchemaName, listSubgraphs, isByoSubgraph, getSubgraph, encryptDatabaseUrl, deleteSubgraph };