npm - orbitdb-relay-pinner - Versions diffs - 0.7.0 → 0.8.0 - Mend

orbitdb-relay-pinner 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/.env.example +4 -1
package/dist/config/libp2p.d.ts.map +1 -1
package/dist/config/libp2p.js +8 -0
package/dist/config/libp2p.js.map +1 -1
package/dist/services/database.d.ts +18 -0
package/dist/services/database.d.ts.map +1 -1
package/dist/services/database.js +163 -15
package/dist/services/database.js.map +1 -1
package/dist/services/metrics.d.ts.map +1 -1
package/dist/services/metrics.js +164 -154
package/dist/services/metrics.js.map +1 -1
package/dist/services/orbitdb-replication-service.d.ts.map +1 -1
package/dist/services/orbitdb-replication-service.js +55 -0
package/dist/services/orbitdb-replication-service.js.map +1 -1
package/docs/nym-vpn-ports.md +3 -2
package/package.json +8 -4

package/.env.example CHANGED Viewed

@@ -9,16 +9,19 @@
 # METRICS_HTTPS_PORT=8443
 # RELAY_TCP_PORT=50001
 # RELAY_WS_PORT=6300
+# RELAY_QUIC_PORT=50005
 # RELAY_WEBRTC_PORT=50003
-# VITE_APPEND_ANNOUNCE=/ip4/PUBLIC_IP/tcp/50001,/ip4/PUBLIC_IP/tcp/6300/ws,/ip4/PUBLIC_IP/udp/50003/webrtc-direct
+# VITE_APPEND_ANNOUNCE=/ip4/PUBLIC_IP/tcp/50001,/ip4/PUBLIC_IP/tcp/6300/ws,/ip4/PUBLIC_IP/udp/50005/quic-v1,/ip4/PUBLIC_IP/udp/50003/webrtc-direct
 # --- Listeners & transports ---
 # RELAY_TCP_PORT=9091
 # RELAY_WS_PORT=9092
+# RELAY_QUIC_PORT=9094
 # RELAY_WEBRTC_PORT=9093
 # RELAY_LISTEN_IPV4=0.0.0.0
 # RELAY_LISTEN_IPV6=::
 # RELAY_DISABLE_IPV6=false
+# RELAY_DISABLE_QUIC=false
 # RELAY_DISABLE_WEBRTC=false
 # Public IPFS/libp2p bootstrap peers (Helia/Kubo list) are enabled by default. Set true for isolated networks.
 # RELAY_DISABLE_BOOTSTRAP=false

package/dist/config/libp2p.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"libp2p.d.ts","sourceRoot":"","sources":["../../src/config/libp2p.ts"],"names":[],"mappings":"~~AAiBA~~,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;~~AA2DpD~~,KAAK,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC,CAAA;AAEzE,eAAO,MAAM,kBAAkB,GAC7B,YAAY,UAAU,EACtB,WAAW,SAAS,EACpB,gBAAe,qBAA0B,~~KAkFpC~~,GACN,CAAA"}
1	+ {"version":3,"file":"libp2p.d.ts","sourceRoot":"","sources":["../../src/config/libp2p.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AA+DpD,KAAK,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC,CAAA;AAEzE,eAAO,MAAM,kBAAkB,GAC7B,YAAY,UAAU,EACtB,WAAW,SAAS,EACpB,gBAAe,qBAA0B,KAqFpC,GACN,CAAA"}

package/dist/config/libp2p.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { noise } from '@chainsafe/libp2p-noise';
+import { quic } from '@chainsafe/libp2p-quic';
 import { yamux } from '@chainsafe/libp2p-yamux';
 import { circuitRelayTransport, circuitRelayServer } from '@libp2p/circuit-relay-v2';
 import { identify, identifyPush } from '@libp2p/identify';
@@ -28,10 +29,12 @@ function readRelayListenEnv() {
     const tcpPort = Number(process.env.RELAY_TCP_PORT || 9091);
     const wsPort = Number(process.env.RELAY_WS_PORT || 9092);
     const webrtcPort = Number(process.env.RELAY_WEBRTC_PORT || 9093);
+    const quicPort = Number(process.env.RELAY_QUIC_PORT || 9094);
     const listenIpv4 = process.env.RELAY_LISTEN_IPV4 || '0.0.0.0';
     const listenIpv6 = process.env.RELAY_LISTEN_IPV6 || '::';
     const disableIpv6 = process.env.RELAY_DISABLE_IPV6 === 'true' || process.env.RELAY_DISABLE_IPV6 === '1';
     const disableWebRtc = process.env.RELAY_DISABLE_WEBRTC === 'true' || process.env.RELAY_DISABLE_WEBRTC === '1';
+    const disableQuic = process.env.RELAY_DISABLE_QUIC === 'true' || process.env.RELAY_DISABLE_QUIC === '1';
     const disableBootstrap = process.env.RELAY_DISABLE_BOOTSTRAP === 'true' || process.env.RELAY_DISABLE_BOOTSTRAP === '1';
     const disableAutoNAT = process.env.RELAY_DISABLE_AUTONAT === 'true' || process.env.RELAY_DISABLE_AUTONAT === '1';
     const pubsubTopics = (process.env.PUBSUB_TOPICS ||
@@ -45,10 +48,12 @@ function readRelayListenEnv() {
         tcpPort,
         wsPort,
         webrtcPort,
+        quicPort,
         listenIpv4,
         listenIpv6,
         disableIpv6,
         disableWebRtc,
+        disableQuic,
         disableBootstrap,
         disableAutoNAT,
         pubsubTopics,
@@ -64,11 +69,13 @@ export const createLibp2pConfig = (privateKey, datastore, extraServices = {}) =>
             listen: [
                 `/ip4/${e.listenIpv4}/tcp/${e.tcpPort}`,
                 `/ip4/${e.listenIpv4}/tcp/${e.wsPort}/ws`,
+                ...(!e.disableQuic ? [`/ip4/${e.listenIpv4}/udp/${e.quicPort}/quic-v1`] : []),
                 ...(!e.disableWebRtc ? [`/ip4/${e.listenIpv4}/udp/${e.webrtcPort}/webrtc-direct`] : []),
                 ...(!e.disableIpv6
                     ? [
                         `/ip6/${e.listenIpv6}/tcp/${e.tcpPort}`,
                         `/ip6/${e.listenIpv6}/tcp/${e.wsPort}/ws`,
+                        ...(!e.disableQuic ? [`/ip6/${e.listenIpv6}/udp/${e.quicPort}/quic-v1`] : []),
                         ...(!e.disableWebRtc ? [`/ip6/${e.listenIpv6}/udp/${e.webrtcPort}/webrtc-direct`] : []),
                     ]
                     : []),
@@ -78,6 +85,7 @@ export const createLibp2pConfig = (privateKey, datastore, extraServices = {}) =>
         transports: [
             circuitRelayTransport(),
             tcp(),
+            ...(!e.disableQuic ? [quic()] : []),
             ...(!e.disableWebRtc ? [webRTC(), webRTCDirect()] : []),
             webSockets(),
         ],

package/dist/config/libp2p.js.map CHANGED Viewed

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

package/dist/services/database.d.ts CHANGED Viewed

@@ -13,6 +13,7 @@ export declare class DatabaseService {
     eventHandlers: Map<string, any>;
     syncInFlight: Map<string, Promise<void>>;
     openInFlight: Map<string, Promise<any>>;
+    databaseUseCounts: Map<string, number>;
     pinQueue: PQueue;
     queuedImageCids: Set<string>;
     pinnedImageCids: Set<string>;
@@ -26,6 +27,7 @@ export declare class DatabaseService {
         address: string;
         lastSyncedAt: string;
     }>;
+    knownDatabasesByAddress: Set<string>;
     /** Manifest `name` by OrbitDB address (for logs / pubsub). */
     orbitDbNameByAddress: Map<string, string>;
     constructor();
@@ -33,6 +35,13 @@ export declare class DatabaseService {
     getCachedDbName(dbAddress: string): string | undefined;
     /** Load manifest to populate {@link orbitDbNameByAddress} without sync logging (e.g. before pubsub subscribe log). */
     prefetchManifestForLogging(dbAddress: string): Promise<void>;
+    getKnownHeadsProtocols(): string[];
+    isKnownHeadsProtocol(protocol: string): boolean;
+    handleOnDemandHeadsProtocol(protocol: string, context: {
+        connection?: {
+            remotePeer?: unknown;
+        };
+    }, getRegisteredHandler: (protocol: string) => any): Promise<void>;
     createPinningHttpHandlers(): PinningHttpHandlers;
     /**
      * GET `/ipfs/<cid>` — stream content only when the CID is pinned in Helia and all bytes come from the local blockstore.
@@ -58,12 +67,21 @@ export declare class DatabaseService {
     private enqueueImageCidsForPinning;
     private waitForUpdateEvent;
     private normalizeOrbitdbAccessAddress;
+    private rememberKnownDatabaseAddress;
+    private rememberKnownDatabaseAddressesFromRecords;
+    private dbAddressFromHeadsProtocol;
+    private waitForRegisteredHeadsHandler;
+    private ensurePeerConnection;
     private summarizeManifest;
     private loadManifest;
     private waitForDatabaseActivity;
     private waitForDatabaseHeads;
     private preOpenAccessController;
     private openDatabase;
+    private retainOpenDatabase;
+    private releaseOpenDatabase;
+    private closeDatabaseSilently;
+    private installNonFatalDatabaseErrorHandlers;
     private installAccessControllerDebugHooks;
     private inspectIdentityHash;
     private collectIdentityHashesFromLog;

package/dist/services/database.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"AAeA,OAAO,MAAM,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAA8B,MAAM,cAAc,CAAA;~~AAkBlG~~,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAElE,qBAAa,eAAe;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5B,cAAc,EAAE,OAAO,CAAA;IACvB,OAAO,EAAE,GAAG,CAAA;IACZ,IAAI,EAAE,GAAG,CAAA;IACT,0FAA0F;IAC1F,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChF,8DAA8D;IAC9D,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;;~~IAoBzC~~,qFAAqF;IACrF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD,sHAAsH;IAChH,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,yBAAyB,IAAI,mBAAmB;IAgDhD;;OAEG;YACW,uBAAuB;IAgDrC;;;OAGG;YACW,+BAA+B;IA2LvC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM;IA+B9C,OAAO,CAAC,2BAA2B;IAgGnC,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,6BAA6B;IAmDrC,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,4BAA4B;IAcpC,OAAO,CAAC,oCAAoC;IAe5C,OAAO,CAAC,kCAAkC;YAU5B,2BAA2B;YAkE3B,WAAW;IA6BzB,OAAO,CAAC,0BAA0B;YAuCpB,kBAAkB;IAkChC,OAAO,CAAC,6BAA6B;IAQrC,OAAO,CAAC,iBAAiB;YAWX,YAAY;YAkCZ,uBAAuB;YAqCvB,oBAAoB;YA+BpB,uBAAuB;YA8DvB,YAAY;~~IAiB1B~~,OAAO,CAAC,iCAAiC;YAwD3B,mBAAmB;YAsDnB,4BAA4B;YA2B5B,qBAAqB;YA4BrB,4BAA4B;IAkBpC,qBAAqB,CAAC,SAAS,EAAE,MAAM;IAK7C,aAAa;IAIP,IAAI;CAaX"}
1	+ {"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"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"}

package/dist/services/database.js CHANGED Viewed

@@ -25,6 +25,9 @@ const DelegatedTodoAccessController = (opts = {}) => DelegatedTodoAccessControll
 DelegatedTodoAccessController.type = DelegatedTodoAccessControllerBase.type;
 const DEFERRED_ACL_PREFIX = '/orbitdb-deferred/';
 const ORBITDB_PREFIX = '/orbitdb/';
+const ORBITDB_HEADS_PREFIX = '/orbitdb/heads';
+const ON_DEMAND_HEADS_HANDLER_TIMEOUT_MS = 5000;
+const RELAY_ERROR_HANDLER_INSTALLED = Symbol('relayErrorHandlerInstalled');
 export class DatabaseService {
     metrics;
     identityDatabases;
@@ -33,6 +36,7 @@ export class DatabaseService {
     eventHandlers;
     syncInFlight;
     openInFlight;
+    databaseUseCounts;
     pinQueue;
     queuedImageCids;
     pinnedImageCids;
@@ -43,6 +47,7 @@ export class DatabaseService {
     pinningSyncOperations;
     pinningFailedSyncs;
     pinnedDatabasesByAddress;
+    knownDatabasesByAddress;
     /** Manifest `name` by OrbitDB address (for logs / pubsub). */
     orbitDbNameByAddress;
     constructor() {
@@ -53,6 +58,7 @@ export class DatabaseService {
         this.eventHandlers = new Map();
         this.syncInFlight = new Map();
         this.openInFlight = new Map();
+        this.databaseUseCounts = new Map();
         this.pinQueue = new PQueue({ concurrency: 4 });
         this.queuedImageCids = new Set();
         this.pinnedImageCids = new Set();
@@ -60,6 +66,7 @@ export class DatabaseService {
         this.pinningSyncOperations = 0;
         this.pinningFailedSyncs = 0;
         this.pinnedDatabasesByAddress = new Map();
+        this.knownDatabasesByAddress = new Set();
         this.orbitDbNameByAddress = new Map();
     }
     /** Resolved DB name from last successful manifest load for this address (if any). */
@@ -77,6 +84,28 @@ export class DatabaseService {
             // ignore
         }
     }
+    getKnownHeadsProtocols() {
+        return Array.from(this.knownDatabasesByAddress).map((dbAddress) => `${ORBITDB_HEADS_PREFIX}${dbAddress}`);
+    }
+    isKnownHeadsProtocol(protocol) {
+        const dbAddress = this.dbAddressFromHeadsProtocol(protocol);
+        return dbAddress != null && this.knownDatabasesByAddress.has(dbAddress);
+    }
+    async handleOnDemandHeadsProtocol(protocol, context, getRegisteredHandler) {
+        const dbAddress = this.dbAddressFromHeadsProtocol(protocol);
+        if (dbAddress == null || !this.knownDatabasesByAddress.has(dbAddress)) {
+            throw new Error(`No replicated database known for protocol ${protocol}`);
+        }
+        await this.ensurePeerConnection(context?.connection?.remotePeer);
+        const db = await this.retainOpenDatabase(dbAddress);
+        try {
+            const handlerRecord = await this.waitForRegisteredHeadsHandler(protocol, getRegisteredHandler);
+            await handlerRecord.handler(context);
+        }
+        finally {
+            await this.releaseOpenDatabase(dbAddress, db);
+        }
+    }
     createPinningHttpHandlers() {
         return {
             getStats: () => ({
@@ -204,6 +233,7 @@ export class DatabaseService {
         }
         const syncPromise = (async () => {
             this.pinningSyncOperations++;
+            this.rememberKnownDatabaseAddress(dbAddress);
             const manifest = await this.loadManifest(dbAddress);
             let dbName = typeof manifest?.name === 'string' && manifest.name ? manifest.name : null;
             syncLog('Starting sync for database:', inspect({ dbAddress, dbName }, { depth: null, colors: false, compact: false }));
@@ -214,10 +244,12 @@ export class DatabaseService {
             let receivedUpdate = false;
             let fallbackScanUsed = false;
             let extractedMediaCids = [];
+            const aclDbAddress = this.normalizeOrbitdbAccessAddress(manifest?.accessController || null);
+            this.rememberKnownDatabaseAddress(aclDbAddress);
             try {
                 aclDb = await this.preOpenAccessController(dbAddress, { manifest });
                 syncLog('Opening database:', inspect({ dbAddress, dbName }, { depth: null, colors: false, compact: false }));
-                db = await this.openDatabase(dbAddress);
+                db = await this.retainOpenDatabase(dbAddress);
                 if (typeof db?.name === 'string' && db.name) {
                     dbName = db.name;
                 }
@@ -234,6 +266,7 @@ export class DatabaseService {
                 if (didReceiveUpdate) {
                     receivedUpdate = true;
                     const updateRecords = updates.map((entry) => ({ value: entry?.payload?.value ?? entry?.value ?? entry }));
+                    this.rememberKnownDatabaseAddressesFromRecords(updateRecords);
                     const extractedEntries = this.extractImageCids(updateRecords);
                     extractedMediaCids = extractedEntries.map((e) => e.cid);
                     this.logDiscoveredMediaCids(dbAddress, extractedEntries, 'updates');
@@ -249,6 +282,7 @@ export class DatabaseService {
                         const all = await db.all();
                         const rows = Array.isArray(all) ? all : [];
                         const scanRecords = rows.map((row) => ({ value: row?.value ?? row }));
+                        this.rememberKnownDatabaseAddressesFromRecords(scanRecords);
                         const scanEntries = this.extractImageCids(scanRecords);
                         extractedMediaCids = scanEntries.map((e) => e.cid);
                         if (rows.length === 0) {
@@ -295,19 +329,11 @@ export class DatabaseService {
                 }
             }
             finally {
-                try {
-                    await db?.close?.();
+                if (db) {
+                    await this.releaseOpenDatabase(dbAddress, db);
                 }
-                catch {
-                    // ignore close failures
-                }
-                try {
-                    if (aclDb && aclDb !== db) {
-                        await aclDb.close?.();
-                    }
-                }
-                catch {
-                    // ignore close failures
+                if (aclDb && aclDb !== db && aclDbAddress) {
+                    await this.releaseOpenDatabase(aclDbAddress, aclDb);
                 }
             }
             return { success, receivedUpdate, fallbackScanUsed, extractedMediaCids };
@@ -723,6 +749,80 @@ export class DatabaseService {
         }
         return address.startsWith(ORBITDB_PREFIX) ? address : null;
     }
+    rememberKnownDatabaseAddress(dbAddress) {
+        if (typeof dbAddress !== 'string' || !dbAddress.startsWith(ORBITDB_PREFIX)) {
+            return;
+        }
+        this.knownDatabasesByAddress.add(dbAddress);
+    }
+    rememberKnownDatabaseAddressesFromRecords(records) {
+        const visit = (value, depth = 0) => {
+            if (depth > 4 || value == null)
+                return;
+            if (typeof value === 'string') {
+                this.rememberKnownDatabaseAddress(value);
+                return;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value)
+                    visit(item, depth + 1);
+                return;
+            }
+            if (typeof value === 'object') {
+                for (const nested of Object.values(value)) {
+                    visit(nested, depth + 1);
+                }
+            }
+        };
+        for (const record of records) {
+            visit(record?.value ?? record);
+        }
+    }
+    dbAddressFromHeadsProtocol(protocol) {
+        if (typeof protocol !== 'string' || !protocol.startsWith(`${ORBITDB_HEADS_PREFIX}/`))
+            return null;
+        const dbAddress = protocol.slice(ORBITDB_HEADS_PREFIX.length);
+        return dbAddress.startsWith(ORBITDB_PREFIX) ? dbAddress : null;
+    }
+    async waitForRegisteredHeadsHandler(protocol, getRegisteredHandler, timeoutMs = ON_DEMAND_HEADS_HANDLER_TIMEOUT_MS) {
+        const startedAt = Date.now();
+        let lastError = null;
+        while (!this.isShuttingDown && Date.now() - startedAt < timeoutMs) {
+            try {
+                return getRegisteredHandler(protocol);
+            }
+            catch (error) {
+                lastError = error;
+                await delay(50);
+            }
+        }
+        throw lastError ?? new Error(`Timed out waiting for handler ${protocol}`);
+    }
+    async ensurePeerConnection(remotePeer) {
+        if (remotePeer == null)
+            return;
+        const libp2p = this.ipfs?.libp2p;
+        if (!libp2p || typeof libp2p.getConnections !== 'function' || typeof libp2p.dial !== 'function') {
+            return;
+        }
+        try {
+            const existingConnections = libp2p.getConnections(remotePeer);
+            if (Array.isArray(existingConnections) && existingConnections.some((connection) => connection?.status !== 'closed')) {
+                return;
+            }
+        }
+        catch {
+            // fall through and try a best-effort dial
+        }
+        const peerId = remotePeer?.toString?.() || String(remotePeer);
+        try {
+            await libp2p.dial(remotePeer);
+            syncLog('Dialed peer back before on-demand heads open:', peerId);
+        }
+        catch (error) {
+            syncLog('Failed to dial peer back before on-demand heads open:', peerId, error?.message || String(error));
+        }
+    }
     summarizeManifest(manifest, dbAddress, cid) {
         return {
             dbAddress,
@@ -828,7 +928,7 @@ export class DatabaseService {
             return null;
         }
         syncLog('Pre-opening access controller before database sync:', dbCtx(), 'acl:', accessControllerAddress);
-        const aclDb = await this.openDatabase(accessControllerAddress);
+        const aclDb = await this.retainOpenDatabase(accessControllerAddress);
         this.installAccessControllerDebugHooks(aclDb, accessControllerAddress);
         syncLog('Access-controller state after open:', inspect(await this.snapshotDatabaseState(aclDb, 'acl-open'), { depth: null, colors: false, compact: false }));
         const { didReceiveActivity, activity } = await this.waitForDatabaseActivity(aclDb, timeoutMs);
@@ -856,12 +956,60 @@ export class DatabaseService {
         const openPromise = this.orbitdb.open(dbAddress);
         this.openInFlight.set(dbAddress, openPromise);
         try {
-            return await openPromise;
+            const db = await openPromise;
+            this.installNonFatalDatabaseErrorHandlers(db, dbAddress);
+            return db;
         }
         finally {
             this.openInFlight.delete(dbAddress);
         }
     }
+    async retainOpenDatabase(dbAddress) {
+        const db = await this.openDatabase(dbAddress);
+        this.databaseUseCounts.set(dbAddress, (this.databaseUseCounts.get(dbAddress) ?? 0) + 1);
+        return db;
+    }
+    async releaseOpenDatabase(dbAddress, db) {
+        const current = this.databaseUseCounts.get(dbAddress) ?? 0;
+        if (current <= 1) {
+            this.databaseUseCounts.delete(dbAddress);
+            await this.closeDatabaseSilently(db);
+            return;
+        }
+        this.databaseUseCounts.set(dbAddress, current - 1);
+    }
+    async closeDatabaseSilently(db) {
+        try {
+            await db?.close?.();
+        }
+        catch {
+            // ignore close failures
+        }
+    }
+    installNonFatalDatabaseErrorHandlers(db, dbAddress) {
+        const attach = (emitter, source) => {
+            if (!emitter?.on)
+                return;
+            if (emitter[RELAY_ERROR_HANDLER_INSTALLED])
+                return;
+            emitter.on('error', (error) => {
+                const payload = {
+                    dbAddress,
+                    dbName: db?.name || null,
+                    source,
+                    error: error?.message || String(error),
+                    stack: error?.stack || null,
+                };
+                // eslint-disable-next-line no-console
+                console.error('OrbitDB emitted a non-fatal error:', inspect(payload, { depth: null, colors: false, compact: false }));
+            });
+            emitter[RELAY_ERROR_HANDLER_INSTALLED] = true;
+        };
+        attach(db?.events, 'db.events');
+        if (db?.sync?.events && db.sync.events !== db.events) {
+            attach(db.sync.events, 'db.sync.events');
+        }
+    }
     installAccessControllerDebugHooks(db, dbAddress) {
         if (!loggingConfig.enableSyncLogs)
             return;