orbitdb-relay-pinner 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# orbitdb-relay-pinner
+
+OrbitDB relay + pinning/sync service used by our apps and tests.
+
+## CLI
+
+Build:
+
+```bash
+npm --prefix packages/orbitdb-relay-pinner run build
+```
+
+Run:
+
+```bash
+node packages/orbitdb-relay-pinner/dist/cli.js
+```
+
+Test mode (deterministic peer id via `TEST_PRIVATE_KEY`):
+
+```bash
+node packages/orbitdb-relay-pinner/dist/cli.js --test
+```
+
+## Why This Exists
+
+- The relay must be able to verify OrbitDB entries created by `did:key` identities.
+- This package registers `@orbitdb/identity-provider-did` with a `key-did-resolver` resolver before opening OrbitDB.
+
+## Environment Variables (common)
+
+- `RELAY_TCP_PORT`, `RELAY_WS_PORT`, `RELAY_WEBRTC_PORT`
+- `RELAY_DISABLE_WEBRTC=true` to disable UDP `/webrtc-direct` listener in constrained environments
+- `METRICS_PORT=0` to bind metrics on an ephemeral port (avoid `EADDRINUSE`)
+- `TEST_PRIVATE_KEY` for `--test` runs
+

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAA"}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { startRelay } from './relay.js';
+function hasFlag(name) {
+    return process.argv.includes(name);
+}
+async function main() {
+    const runtime = await startRelay({
+        testMode: hasFlag('--test'),
+    });
+    const handleShutdown = async () => {
+        try {
+            await runtime.stop();
+        }
+        finally {
+            process.exit(0);
+        }
+    };
+    process.on('SIGINT', handleShutdown);
+    process.on('SIGTERM', handleShutdown);
+}
+main().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAA;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;KAC5B,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;IACpC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;AACvC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/config/libp2p.d.ts

@@ -0,0 +1,4 @@
+import type { PrivateKey } from '@libp2p/interface';
+import type { Datastore } from 'interface-datastore';
+export declare const createLibp2pConfig: (privateKey: PrivateKey, datastore: Datastore) => any;
+//# sourceMappingURL=libp2p.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"libp2p.d.ts","sourceRoot":"","sources":["../../src/config/libp2p.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAoBpD,eAAO,MAAM,kBAAkB,GAAI,YAAY,UAAU,EAAE,WAAW,SAAS,KA8D1E,GAAI,CAAA"}

package/dist/config/libp2p.js

@@ -0,0 +1,91 @@
+import { noise } from '@chainsafe/libp2p-noise';
+import { yamux } from '@chainsafe/libp2p-yamux';
+import { circuitRelayTransport, circuitRelayServer } from '@libp2p/circuit-relay-v2';
+import { identify, identifyPush } from '@libp2p/identify';
+import { webRTC, webRTCDirect } from '@libp2p/webrtc';
+import { webSockets } from '@libp2p/websockets';
+import { gossipsub } from '@chainsafe/libp2p-gossipsub';
+import { pubsubPeerDiscovery } from '@libp2p/pubsub-peer-discovery';
+import { kadDHT, removePrivateAddressesMapper } from '@libp2p/kad-dht';
+import { bootstrap } from '@libp2p/bootstrap';
+import { tcp } from '@libp2p/tcp';
+import { ping } from '@libp2p/ping';
+import { autoNAT } from '@libp2p/autonat';
+import { autoTLS } from '@ipshipyard/libp2p-auto-tls';
+import { keychain } from '@libp2p/keychain';
+import { prometheusMetrics } from '@libp2p/prometheus-metrics';
+const appendAnnounce = (process.env.NODE_ENV === 'development' ? process.env.VITE_APPEND_ANNOUNCE_DEV : process.env.VITE_APPEND_ANNOUNCE) || '';
+const appendAnnounceArray = appendAnnounce
+    .split(',')
+    .map((addr) => addr.trim())
+    .filter(Boolean);
+const RELAY_TCP_PORT = Number(process.env.RELAY_TCP_PORT || 9091);
+const RELAY_WS_PORT = Number(process.env.RELAY_WS_PORT || 9092);
+const RELAY_WEBRTC_PORT = Number(process.env.RELAY_WEBRTC_PORT || 9093);
+const RELAY_LISTEN_IPV4 = process.env.RELAY_LISTEN_IPV4 || '0.0.0.0';
+const RELAY_LISTEN_IPV6 = process.env.RELAY_LISTEN_IPV6 || '::';
+const RELAY_DISABLE_IPV6 = process.env.RELAY_DISABLE_IPV6 === 'true' || process.env.RELAY_DISABLE_IPV6 === '1';
+const RELAY_DISABLE_WEBRTC = process.env.RELAY_DISABLE_WEBRTC === 'true' || process.env.RELAY_DISABLE_WEBRTC === '1';
+export const createLibp2pConfig = (privateKey, datastore) => ({
+    privateKey,
+    datastore,
+    metrics: prometheusMetrics(),
+    addresses: {
+        listen: [
+            `/ip4/${RELAY_LISTEN_IPV4}/tcp/${RELAY_TCP_PORT}`,
+            `/ip4/${RELAY_LISTEN_IPV4}/tcp/${RELAY_WS_PORT}/ws`,
+            ...(!RELAY_DISABLE_WEBRTC ? [`/ip4/${RELAY_LISTEN_IPV4}/udp/${RELAY_WEBRTC_PORT}/webrtc-direct`] : []),
+            ...(!RELAY_DISABLE_IPV6
+                ? [
+                    `/ip6/${RELAY_LISTEN_IPV6}/tcp/${RELAY_TCP_PORT}`,
+                    `/ip6/${RELAY_LISTEN_IPV6}/tcp/${RELAY_WS_PORT}/ws`,
+                    ...(!RELAY_DISABLE_WEBRTC ? [`/ip6/${RELAY_LISTEN_IPV6}/udp/${RELAY_WEBRTC_PORT}/webrtc-direct`] : []),
+                ]
+                : []),
+        ],
+        ...(appendAnnounceArray.length > 0 && { appendAnnounce: appendAnnounceArray }),
+    },
+    transports: [circuitRelayTransport(), tcp(), ...(!RELAY_DISABLE_WEBRTC ? [webRTC(), webRTCDirect()] : []), webSockets()],
+    peerDiscovery: [
+        pubsubPeerDiscovery({
+            interval: 5000,
+            topics: ['todo._peer-discovery._p2p._pubsub'],
+            listenOnly: false,
+        }),
+    ],
+    connectionEncrypters: [noise()],
+    streamMuxers: [yamux()],
+    services: {
+        ping: ping(),
+        autonat: autoNAT(),
+        aminoDHT: kadDHT({
+            protocol: '/ipfs/kad/1.0.0',
+            peerInfoMapper: removePrivateAddressesMapper,
+        }),
+        relay: circuitRelayServer({
+            hopTimeout: 30000,
+            reservations: {
+                maxReservations: 1000,
+                reservationTtl: 2 * 60 * 60 * 1000,
+                defaultDataLimit: BigInt(1024 * 1024 * 1024),
+                defaultDurationLimit: 2 * 60 * 1000,
+            },
+        }),
+        identify: identify(),
+        identifyPush: identifyPush(),
+        pubsub: gossipsub({ allowPublishToZeroTopicPeers: true }),
+        ...(!process.env.disableAutoTLS && {
+            autoTLS: autoTLS({
+                autoConfirmAddress: true,
+                ...(process.env.STAGING === 'true' && {
+                    acmeDirectory: 'https://acme-staging-v02.api.letsencrypt.org/directory',
+                }),
+            }),
+        }),
+        keychain: keychain(),
+    },
+    connectionGater: {
+        denyDialMultiaddr: async () => false,
+    },
+});
+//# sourceMappingURL=libp2p.js.map

package/dist/config/libp2p.js.map

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

package/dist/config/logging.d.ts

@@ -0,0 +1,12 @@
+export declare const loggingConfig: {
+    enableGeneralLogs: boolean;
+    enableSyncLogs: boolean;
+    enableSyncStats: boolean;
+    logLevels: {
+        connection: boolean;
+        peer: boolean;
+        database: boolean;
+        sync: boolean;
+    };
+};
+//# sourceMappingURL=logging.d.ts.map

package/dist/config/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/config/logging.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;;;;CAUzB,CAAA"}

package/dist/config/logging.js

@@ -0,0 +1,12 @@
+export const loggingConfig = {
+    enableGeneralLogs: process.env.ENABLE_GENERAL_LOGS !== 'false' && process.env.ENABLE_GENERAL_LOGS !== '0',
+    enableSyncLogs: process.env.ENABLE_SYNC_LOGS !== 'false' && process.env.ENABLE_SYNC_LOGS !== '0',
+    enableSyncStats: process.env.ENABLE_SYNC_STATS !== 'false' && process.env.ENABLE_SYNC_STATS !== '0',
+    logLevels: {
+        connection: process.env.LOG_LEVEL_CONNECTION === 'true',
+        peer: process.env.LOG_LEVEL_PEER === 'true',
+        database: process.env.LOG_LEVEL_DATABASE === 'true',
+        sync: process.env.LOG_LEVEL_SYNC === 'true',
+    },
+};
+//# sourceMappingURL=logging.js.map

package/dist/config/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/config/logging.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG;IACzG,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG;IAChG,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG;IACnG,SAAS,EAAE;QACT,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;QACvD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM;QAC3C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM;QACnD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM;KAC5C;CACF,CAAA"}

package/dist/events/handlers.d.ts

@@ -0,0 +1,2 @@
+export declare function setupEventHandlers(libp2p: any, databaseService: any): () => void;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/events/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/events/handlers.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,cAmEnE"}

package/dist/events/handlers.js

@@ -0,0 +1,70 @@
+import { identify } from '@libp2p/identify';
+import PQueue from 'p-queue';
+import { WebSocketsSecure } from '@multiformats/multiaddr-matcher';
+import { log, syncLog } from '../utils/logger.js';
+import { loggingConfig } from '../config/logging.js';
+export function setupEventHandlers(libp2p, databaseService) {
+    const cleanupFunctions = [];
+    const peerConnectHandler = async (event) => {
+        const peer = event.detail;
+        try {
+            if (loggingConfig.logLevels.peer)
+                log('peer:connect', peer);
+            await identify(peer);
+        }
+        catch (err) {
+            if (err?.code !== 'ERR_UNSUPPORTED_PROTOCOL' && loggingConfig.logLevels.peer) {
+                // eslint-disable-next-line no-console
+                console.error('Failed to identify peer:', err);
+            }
+        }
+    };
+    libp2p.addEventListener('peer:connect', peerConnectHandler);
+    cleanupFunctions.push(() => libp2p.removeEventListener('peer:connect', peerConnectHandler));
+    const certificateHandler = () => {
+        const interval = setInterval(() => {
+            const mas = libp2p
+                .getMultiaddrs()
+                .filter((ma) => WebSocketsSecure.exactMatch(ma) && ma.toString().includes('/sni/'))
+                .map((ma) => ma.toString());
+            if (mas.length > 0)
+                clearInterval(interval);
+        }, 1000);
+    };
+    libp2p.addEventListener('certificate:provision', certificateHandler);
+    cleanupFunctions.push(() => libp2p.removeEventListener('certificate:provision', certificateHandler));
+    const peerDisconnectHandler = async (event) => {
+        libp2p.peerStore.delete(event.detail);
+    };
+    libp2p.addEventListener('peer:disconnect', peerDisconnectHandler);
+    cleanupFunctions.push(() => libp2p.removeEventListener('peer:disconnect', peerDisconnectHandler));
+    const syncQueue = new PQueue({ concurrency: 2 });
+    const pubsubMessageHandler = (event) => {
+        const msg = event.detail;
+        syncLog('Received pubsub message:', msg.topic);
+        if (msg.topic && msg.topic.startsWith('/orbitdb/')) {
+            syncQueue.add(() => databaseService.syncAllOrbitDBRecords(msg.topic));
+        }
+    };
+    libp2p.services.pubsub.addEventListener('message', pubsubMessageHandler);
+    cleanupFunctions.push(() => libp2p.services.pubsub.removeEventListener('message', pubsubMessageHandler));
+    const connectionOpenHandler = async (event) => {
+        const connection = event.detail;
+        if (loggingConfig.logLevels.connection)
+            log('connection:open', connection.remoteAddr.toString());
+    };
+    libp2p.addEventListener('connection:open', connectionOpenHandler);
+    cleanupFunctions.push(() => libp2p.removeEventListener('connection:open', connectionOpenHandler));
+    const pubsub = libp2p.services.pubsub;
+    pubsub.addEventListener('subscription-change', (event) => {
+        if (event.detail?.subscriptions) {
+            for (const subscription of event.detail.subscriptions) {
+                if (subscription.topic?.startsWith('/orbitdb/')) {
+                    syncQueue.add(() => databaseService.syncAllOrbitDBRecords(subscription.topic));
+                }
+            }
+        }
+    });
+    return () => cleanupFunctions.forEach((cleanup) => cleanup());
+}
+//# sourceMappingURL=handlers.js.map

package/dist/events/handlers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { RelayOptions, RelayRuntime } from './relay.js';
+export { startRelay } from './relay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { startRelay } from './relay.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/relay.d.ts

@@ -0,0 +1,9 @@
+export type RelayOptions = {
+    testMode?: boolean;
+    storageDir?: string;
+};
+export type RelayRuntime = {
+    stop: () => Promise<void>;
+};
+export declare function startRelay(opts?: RelayOptions): Promise<RelayRuntime>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4D/E"}

package/dist/relay.js

@@ -0,0 +1,69 @@
+import { createLibp2p } from 'libp2p';
+import { createHelia } from 'helia';
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string';
+import { privateKeyFromProtobuf } from '@libp2p/crypto/keys';
+import { createLibp2pConfig } from './config/libp2p.js';
+import { initializeStorage } from './services/storage.js';
+import { DatabaseService } from './services/database.js';
+import { MetricsServer } from './services/metrics.js';
+import { setupEventHandlers } from './events/handlers.js';
+export async function startRelay(opts = {}) {
+    const isTestMode = Boolean(opts.testMode);
+    const storageDir = opts.storageDir || './orbitdb/pinning-service';
+    const storage = await initializeStorage(storageDir);
+    const { blockstore, datastore } = storage;
+    let privateKey = storage.privateKey;
+    if (isTestMode) {
+        const hex = process.env.TEST_PRIVATE_KEY;
+        if (!hex)
+            throw new Error('Missing TEST_PRIVATE_KEY in --test mode');
+        privateKey = privateKeyFromProtobuf(uint8ArrayFromString(hex, 'hex'));
+    }
+    const libp2p = await createLibp2p(createLibp2pConfig(privateKey, datastore));
+    const ipfs = await createHelia({ libp2p, datastore, blockstore });
+    const databaseService = new DatabaseService();
+    await databaseService.initialize(ipfs);
+    const cleanupEventHandlers = await setupEventHandlers(libp2p, databaseService);
+    const metricsServer = new MetricsServer();
+    metricsServer.start();
+    // Important: Playwright setup waits for this marker.
+    // eslint-disable-next-line no-console
+    console.log('p2p addr: ', libp2p.getMultiaddrs().map((ma) => ma.toString()));
+    return {
+        stop: async () => {
+            try {
+                cleanupEventHandlers?.();
+            }
+            catch {
+                // ignore
+            }
+            try {
+                // best effort; helia/libp2p will close underlying stores as well
+                // @ts-expect-error helia internal store wrappers
+                await ipfs.blockstore?.child?.child?.child?.close?.();
+            }
+            catch {
+                // ignore
+            }
+            try {
+                await datastore.close();
+            }
+            catch {
+                // ignore
+            }
+            try {
+                await blockstore.close();
+            }
+            catch {
+                // ignore
+            }
+            try {
+                await libp2p.stop();
+            }
+            catch {
+                // ignore
+            }
+        },
+    };
+}
+//# sourceMappingURL=relay.js.map

package/dist/relay.js.map

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

package/dist/services/database.d.ts

@@ -0,0 +1,14 @@
+import { MetricsServer } from './metrics.js';
+export declare class DatabaseService {
+    metrics: MetricsServer;
+    identityDatabases: Map<string, any>;
+    databaseContexts: Map<string, any>;
+    updateTimers: Map<string, any>;
+    openDatabases: Map<string, any>;
+    eventHandlers: Map<string, any>;
+    orbitdb: any;
+    constructor();
+    initialize(ipfs: any): Promise<void>;
+    syncAllOrbitDBRecords(dbAddress: string): Promise<void>;
+}
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C,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,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,OAAO,EAAE,GAAG,CAAA;;IAWN,UAAU,CAAC,IAAI,EAAE,GAAG;IAMpB,qBAAqB,CAAC,SAAS,EAAE,MAAM;CAmD9C"}

package/dist/services/database.js

@@ -0,0 +1,78 @@
+import { createOrbitDB, useIdentityProvider } from '@orbitdb/core';
+import OrbitDBIdentityProviderDID from '@orbitdb/identity-provider-did';
+import * as KeyDIDResolver from 'key-did-resolver';
+import { MetricsServer } from './metrics.js';
+import { log, syncLog, logSyncStats } from '../utils/logger.js';
+import { loggingConfig } from '../config/logging.js';
+export class DatabaseService {
+    metrics;
+    identityDatabases;
+    databaseContexts;
+    updateTimers;
+    openDatabases;
+    eventHandlers;
+    orbitdb;
+    constructor() {
+        this.metrics = new MetricsServer();
+        this.identityDatabases = new Map();
+        this.databaseContexts = new Map();
+        this.updateTimers = new Map();
+        this.openDatabases = new Map();
+        this.eventHandlers = new Map();
+    }
+    async initialize(ipfs) {
+        OrbitDBIdentityProviderDID.setDIDResolver(KeyDIDResolver.getResolver());
+        useIdentityProvider(OrbitDBIdentityProviderDID);
+        this.orbitdb = await createOrbitDB({ ipfs });
+    }
+    async syncAllOrbitDBRecords(dbAddress) {
+        syncLog('Starting sync for database:', dbAddress);
+        const endTimer = this.metrics.startSyncTimer('all_databases');
+        try {
+            let db;
+            if (this.openDatabases.has(dbAddress)) {
+                db = this.openDatabases.get(dbAddress);
+            }
+            else {
+                db = await this.orbitdb.open(dbAddress);
+                this.openDatabases.set(dbAddress, db);
+            }
+            const previousCounts = this.identityDatabases.get(dbAddress) || { posts: 0, comments: 0, media: 0 };
+            const records = await db.all();
+            if (records.length > 0) {
+                syncLog(`Sample record from ${db.name}:`, JSON.stringify(records[0], null, 2));
+            }
+            let recordCounts = { posts: 0, comments: 0, media: 0 };
+            let dbType = 'unknown';
+            if (db.name.includes('posts') || db.name.includes('post')) {
+                recordCounts.posts = records.length;
+                dbType = 'posts';
+            }
+            else if (db.name.includes('comments') || db.name.includes('comment')) {
+                recordCounts.comments = records.length;
+                dbType = 'comments';
+            }
+            else if (db.name.includes('media')) {
+                recordCounts.media = records.length;
+                dbType = 'media';
+            }
+            else if (db.name.includes('settings') || db.name.includes('config')) {
+                dbType = 'settings';
+            }
+            const peerId = db?.identity?.id;
+            logSyncStats(dbType, dbAddress, peerId, recordCounts, previousCounts);
+            this.identityDatabases.set(dbAddress, recordCounts);
+            this.metrics.trackSync('documents', 'success');
+            endTimer();
+        }
+        catch (err) {
+            this.metrics.trackSync('documents', 'failure');
+            endTimer();
+            if (loggingConfig.logLevels.database) {
+                // eslint-disable-next-line no-console
+                console.error('Failed to sync database:', err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/services/database.js.map

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

package/dist/services/metrics.d.ts

@@ -0,0 +1,9 @@
+import http from 'http';
+export declare class MetricsServer {
+    constructor();
+    getMetrics(): Promise<string>;
+    start(port?: number | string): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse> | null> | null;
+    trackSync(type: string, status?: string): void;
+    startSyncTimer(type: string): (labels?: Partial<Record<"type", string | number>> | undefined) => number;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/services/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/services/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAqBvB,qBAAa,aAAa;;IAWlB,UAAU;IAIhB,KAAK,CAAC,IAAI,GAAE,MAAM,GAAG,MAAyC;IAsC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAY;IAI1C,cAAc,CAAC,IAAI,EAAE,MAAM;CAG5B"}

package/dist/services/metrics.js

@@ -0,0 +1,68 @@
+import http from 'http';
+import client from 'prom-client';
+import { logger } from '@libp2p/logger';
+const log = logger('le-space:relay');
+let metricsInstance = null;
+const syncCounter = new client.Counter({
+    name: 'orbitdb_sync_total',
+    help: 'Total number of OrbitDB synchronization operations',
+    labelNames: ['type', 'status'],
+});
+const syncDurationHistogram = new client.Histogram({
+    name: 'orbitdb_sync_duration_seconds',
+    help: 'Duration of OrbitDB synchronization operations',
+    labelNames: ['type'],
+    buckets: [0.1, 0.5, 1, 2, 5, 10],
+});
+export class MetricsServer {
+    constructor() {
+        if (!metricsInstance) {
+            if (!client.register.getSingleMetric('process_cpu_user_seconds_total')) {
+                client.collectDefaultMetrics();
+            }
+            metricsInstance = this;
+        }
+        return metricsInstance;
+    }
+    async getMetrics() {
+        return await client.register.metrics();
+    }
+    start(port = process.env.METRICS_PORT || 9090) {
+        if (process.env.METRICS_DISABLED === 'true' || process.env.METRICS_DISABLED === '1') {
+            log('Metrics server disabled (METRICS_DISABLED)');
+            return null;
+        }
+        const desiredPort = typeof port === 'string' ? Number(port) : port;
+        const createServer = () => http.createServer(async (req, res) => {
+            if (req.url === '/metrics') {
+                res.setHeader('Content-Type', client.register.contentType);
+                res.end(await this.getMetrics());
+            }
+            else {
+                res.statusCode = 404;
+                res.end('Not found');
+            }
+        });
+        const listen = (p) => new Promise((resolve) => {
+            const server = createServer();
+            server.on('error', (err) => {
+                if (err?.code === 'EADDRINUSE' && p !== 0) {
+                    log(`Metrics port ${p} in use; retrying on an ephemeral port`);
+                    listen(0).then(resolve);
+                    return;
+                }
+                log('Metrics server failed to start:', err?.message || err);
+                resolve(null);
+            });
+            server.listen(p, () => resolve(server));
+        });
+        return listen(Number.isFinite(desiredPort) ? desiredPort : 9090);
+    }
+    trackSync(type, status = 'success') {
+        syncCounter.labels(type, status).inc();
+    }
+    startSyncTimer(type) {
+        return syncDurationHistogram.startTimer({ type });
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/services/metrics.js.map

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

package/dist/services/storage.d.ts

@@ -0,0 +1,6 @@
+export declare function initializeStorage(hostDirectory: string): Promise<{
+    datastore: any;
+    blockstore: any;
+    privateKey: any;
+}>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/services/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AAsBA,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACtE,SAAS,EAAE,GAAG,CAAA;IACd,UAAU,EAAE,GAAG,CAAA;IACf,UAAU,EAAE,GAAG,CAAA;CAChB,CAAC,CAUD"}

package/dist/services/storage.js

@@ -0,0 +1,28 @@
+import { LevelBlockstore } from 'blockstore-level';
+import { LevelDatastore } from 'datastore-level';
+import { join } from 'path';
+import { Key } from 'interface-datastore';
+import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+async function loadOrCreateRelayPrivateKey(datastore) {
+    const key = new Key('/le-space/relay/private-key');
+    try {
+        const bytes = await datastore.get(key);
+        return privateKeyFromProtobuf(bytes);
+    }
+    catch (err) {
+        if (err?.code !== 'ERR_NOT_FOUND')
+            throw err;
+    }
+    const privateKey = await generateKeyPair('Ed25519');
+    await datastore.put(key, privateKeyToProtobuf(privateKey));
+    return privateKey;
+}
+export async function initializeStorage(hostDirectory) {
+    const datastore = new LevelDatastore(join(hostDirectory, '/', 'ipfs', '/', 'data'));
+    await datastore.open();
+    const blockstore = new LevelBlockstore(join(hostDirectory, '/', 'ipfs', '/', 'blocks'));
+    await blockstore.open();
+    const privateKey = await loadOrCreateRelayPrivateKey(datastore);
+    return { datastore, blockstore, privateKey };
+}
+//# sourceMappingURL=storage.js.map

package/dist/services/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAGnG,KAAK,UAAU,2BAA2B,CAAC,SAAoB;IAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAElD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACtC,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,EAAE,IAAI,KAAK,eAAe;YAAE,MAAM,GAAG,CAAA;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAA;IACnD,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAA;IAC1D,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB;IAK3D,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;IACnF,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAEtB,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IACvF,MAAM,UAAU,CAAC,IAAI,EAAE,CAAA;IAEvB,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,SAAS,CAAC,CAAA;IAE/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAA;AAC9C,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export declare const log: (...args: any[]) => void;
+export declare const syncLog: (...args: any[]) => void;
+export declare const logSyncStats: (dbType: string, address: string, peerId: string | undefined, recordCounts: {
+    posts?: number;
+    comments?: number;
+    media?: number;
+}, previousCounts?: {
+    posts?: number;
+    comments?: number;
+    media?: number;
+}) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAuE,CAAA;AAC7G,eAAO,MAAM,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAoE,CAAA;AAE9G,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,QAAQ,MAAM,GAAG,SAAS,EAC1B,cAAc;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACnE,iBAAgB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,SA+B3E,CAAA"}

package/dist/utils/logger.js

@@ -0,0 +1,38 @@
+import { logger, enable } from '@libp2p/logger';
+import { loggingConfig } from '../config/logging.js';
+const baseLogger = logger('le-space:relay');
+if (loggingConfig.enableGeneralLogs)
+    enable('le-space:relay:*');
+const syncLogger = logger('le-space:relay:sync');
+if (loggingConfig.enableSyncLogs)
+    enable('le-space:relay:sync');
+export const log = loggingConfig.enableGeneralLogs ? baseLogger : () => { };
+export const syncLog = loggingConfig.enableSyncLogs ? syncLogger : () => { };
+export const logSyncStats = (dbType, address, peerId, recordCounts, previousCounts = {}) => {
+    if (!loggingConfig.enableSyncStats)
+        return;
+    const changes = {
+        posts: (recordCounts.posts || 0) - (previousCounts.posts || 0),
+        comments: (recordCounts.comments || 0) - (previousCounts.comments || 0),
+        media: (recordCounts.media || 0) - (previousCounts.media || 0),
+    };
+    const hasChanges = Object.values(changes).some((c) => c !== 0);
+    if (!hasChanges && !loggingConfig.enableSyncLogs)
+        return;
+    const timestamp = new Date().toISOString();
+    // eslint-disable-next-line no-console
+    console.log(`[${timestamp}] 🔄 DB_SYNC: ${dbType}`);
+    // eslint-disable-next-line no-console
+    console.log(`  📍 Address: ${address}`);
+    // eslint-disable-next-line no-console
+    console.log(`  👤 Peer: ${peerId || 'local'}`);
+    // eslint-disable-next-line no-console
+    console.log(`  📊 Records: Posts=${recordCounts.posts || 0}, Comments=${recordCounts.comments || 0}, Media=${recordCounts.media || 0}`);
+    if (hasChanges) {
+        // eslint-disable-next-line no-console
+        console.log(`  📈 Changes: Posts=${changes.posts >= 0 ? '+' : ''}${changes.posts}, Comments=${changes.comments >= 0 ? '+' : ''}${changes.comments}, Media=${changes.media >= 0 ? '+' : ''}${changes.media}`);
+    }
+    // eslint-disable-next-line no-console
+    console.log('  ─────────────────────────────────────────────────────────');
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAA;AAE3C,IAAI,aAAa,CAAC,iBAAiB;IAAE,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAE/D,MAAM,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAA;AAChD,IAAI,aAAa,CAAC,cAAc;IAAE,MAAM,CAAC,qBAAqB,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,GAAG,GAA6B,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAE,UAAkB,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAA;AAC7G,MAAM,CAAC,MAAM,OAAO,GAA6B,aAAa,CAAC,cAAc,CAAC,CAAC,CAAE,UAAkB,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAA;AAE9G,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAc,EACd,OAAe,EACf,MAA0B,EAC1B,YAAmE,EACnE,iBAAwE,EAAE,EAC1E,EAAE;IACF,IAAI,CAAC,aAAa,CAAC,eAAe;QAAE,OAAM;IAE1C,MAAM,OAAO,GAAG;QACd,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9D,QAAQ,EAAE,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvE,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,CAAC;KAC/D,CAAA;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9D,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,CAAC,cAAc;QAAE,OAAM;IAExD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC1C,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,iBAAiB,MAAM,EAAE,CAAC,CAAA;IACnD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAA;IACvC,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,IAAI,OAAO,EAAE,CAAC,CAAA;IAC9C,sCAAsC;IACtC,OAAO,CAAC,GAAG,CACT,uBAAuB,YAAY,CAAC,KAAK,IAAI,CAAC,cAAc,YAAY,CAAC,QAAQ,IAAI,CAAC,WAAW,YAAY,CAAC,KAAK,IAAI,CAAC,EAAE,CAC3H,CAAA;IACD,IAAI,UAAU,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,GAAG,CACT,uBAAuB,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,cAAc,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,WAAW,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAChM,CAAA;IACH,CAAC;IACD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAA;AAC5E,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "orbitdb-relay-pinner",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "OrbitDB relay + pinning/sync service for Helia/libp2p stacks.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "orbitdb-relay-pinner": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/add-shebang.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@chainsafe/libp2p-gossipsub": "^14.1.1",
+    "@chainsafe/libp2p-noise": "^16.1.3",
+    "@chainsafe/libp2p-yamux": "^7.0.1",
+    "@ipshipyard/libp2p-auto-tls": "^1.0.0",
+    "@libp2p/autonat": "^2.0.30",
+    "@libp2p/circuit-relay-v2": "^3.2.11",
+    "@libp2p/crypto": "^5.1.1",
+    "@libp2p/identify": "^3.0.29",
+    "@libp2p/keychain": "^5.2.1",
+    "@libp2p/ping": "^2.0.29",
+    "@libp2p/prometheus-metrics": "^4.3.18",
+    "@libp2p/pubsub-peer-discovery": "^11.0.1",
+    "@libp2p/tcp": "^10.1.10",
+    "@libp2p/webrtc": "^5.2.12",
+    "@libp2p/websockets": "^9.2.10",
+    "@multiformats/multiaddr-matcher": "^1.7.0",
+    "@orbitdb/core": "^3.0.2",
+    "@orbitdb/identity-provider-did": "^1.0.2",
+    "blockstore-level": "^2.0.1",
+    "datastore-level": "^11.0.1",
+    "dotenv": "^16.5.0",
+    "helia": "^5.3.0",
+    "interface-datastore": "^8.3.1",
+    "p-queue": "^8.1.0",
+    "prom-client": "^15.1.3",
+    "uint8arrays": "^5.1.0",
+    "key-did-resolver": "^4.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}