@bsv/overlay-express 2.4.2 → 2.4.9

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 (135) hide show
  1. package/LICENSE.txt +57 -27
  2. package/README.md +141 -56
  3. package/dist/cjs/mod.d.ts +11 -0
  4. package/dist/cjs/mod.d.ts.map +1 -0
  5. package/dist/cjs/mod.js.map +1 -1
  6. package/dist/cjs/package.json +26 -13
  7. package/dist/cjs/src/ArcadeProvider.d.ts +37 -0
  8. package/dist/cjs/src/ArcadeProvider.d.ts.map +1 -0
  9. package/dist/cjs/src/ArcadeProvider.js.map +1 -1
  10. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts +36 -0
  11. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts.map +1 -0
  12. package/dist/cjs/src/BanAwareDiscoveryStorage.js +5 -4
  13. package/dist/cjs/src/BanAwareDiscoveryStorage.js.map +1 -1
  14. package/dist/cjs/src/BanAwareLookupWrapper.d.ts +31 -0
  15. package/dist/cjs/src/BanAwareLookupWrapper.d.ts.map +1 -0
  16. package/dist/cjs/src/BanAwareLookupWrapper.js +3 -2
  17. package/dist/cjs/src/BanAwareLookupWrapper.js.map +1 -1
  18. package/dist/cjs/src/BanAwareTopicManager.d.ts +28 -0
  19. package/dist/cjs/src/BanAwareTopicManager.d.ts.map +1 -0
  20. package/dist/cjs/src/BanAwareTopicManager.js +3 -2
  21. package/dist/cjs/src/BanAwareTopicManager.js.map +1 -1
  22. package/dist/cjs/src/BanService.d.ts +81 -0
  23. package/dist/cjs/src/BanService.d.ts.map +1 -0
  24. package/dist/cjs/src/BanService.js.map +1 -1
  25. package/dist/cjs/src/ChaintracksProvider.d.ts +29 -0
  26. package/dist/cjs/src/ChaintracksProvider.d.ts.map +1 -0
  27. package/dist/cjs/src/ChaintracksProvider.js +1 -1
  28. package/dist/cjs/src/ChaintracksProvider.js.map +1 -1
  29. package/dist/cjs/src/JanitorService.d.ts +128 -0
  30. package/dist/cjs/src/JanitorService.d.ts.map +1 -0
  31. package/dist/cjs/src/JanitorService.js +108 -37
  32. package/dist/cjs/src/JanitorService.js.map +1 -1
  33. package/dist/cjs/src/OverlayExpress.d.ts +466 -0
  34. package/dist/cjs/src/OverlayExpress.d.ts.map +1 -0
  35. package/dist/cjs/src/OverlayExpress.js +307 -148
  36. package/dist/cjs/src/OverlayExpress.js.map +1 -1
  37. package/dist/cjs/src/OverlayMonitor.d.ts +197 -0
  38. package/dist/cjs/src/OverlayMonitor.d.ts.map +1 -0
  39. package/dist/cjs/src/OverlayMonitor.js +6 -4
  40. package/dist/cjs/src/OverlayMonitor.js.map +1 -1
  41. package/dist/cjs/src/ProviderChainBroadcaster.d.ts +18 -0
  42. package/dist/cjs/src/ProviderChainBroadcaster.d.ts.map +1 -0
  43. package/dist/cjs/src/ProviderChainBroadcaster.js +7 -3
  44. package/dist/cjs/src/ProviderChainBroadcaster.js.map +1 -1
  45. package/dist/cjs/src/ReorgStream.d.ts +74 -0
  46. package/dist/cjs/src/ReorgStream.d.ts.map +1 -0
  47. package/dist/cjs/src/ReorgStream.js +14 -6
  48. package/dist/cjs/src/ReorgStream.js.map +1 -1
  49. package/dist/cjs/src/generalGuide.md.d.ts +3 -0
  50. package/dist/cjs/src/generalGuide.md.d.ts.map +1 -0
  51. package/dist/cjs/src/generalGuide.md.js.map +1 -1
  52. package/dist/cjs/src/makeUserInterface.d.ts +22 -0
  53. package/dist/cjs/src/makeUserInterface.d.ts.map +1 -0
  54. package/dist/cjs/src/makeUserInterface.js +4 -4
  55. package/dist/cjs/src/makeUserInterface.js.map +1 -1
  56. package/dist/cjs/src/security/edgePolicy.d.ts +57 -0
  57. package/dist/cjs/src/security/edgePolicy.d.ts.map +1 -0
  58. package/dist/cjs/src/security/edgePolicy.js +379 -0
  59. package/dist/cjs/src/security/edgePolicy.js.map +1 -0
  60. package/dist/esm/mod.js.map +1 -1
  61. package/dist/esm/src/ArcadeProvider.js.map +1 -1
  62. package/dist/esm/src/BanAwareDiscoveryStorage.js +5 -4
  63. package/dist/esm/src/BanAwareDiscoveryStorage.js.map +1 -1
  64. package/dist/esm/src/BanAwareLookupWrapper.js +3 -2
  65. package/dist/esm/src/BanAwareLookupWrapper.js.map +1 -1
  66. package/dist/esm/src/BanAwareTopicManager.js +3 -2
  67. package/dist/esm/src/BanAwareTopicManager.js.map +1 -1
  68. package/dist/esm/src/ChaintracksProvider.js +1 -1
  69. package/dist/esm/src/ChaintracksProvider.js.map +1 -1
  70. package/dist/esm/src/JanitorService.js +84 -8
  71. package/dist/esm/src/JanitorService.js.map +1 -1
  72. package/dist/esm/src/OverlayExpress.js +290 -134
  73. package/dist/esm/src/OverlayExpress.js.map +1 -1
  74. package/dist/esm/src/ProviderChainBroadcaster.js +7 -3
  75. package/dist/esm/src/ProviderChainBroadcaster.js.map +1 -1
  76. package/dist/esm/src/ReorgStream.js +14 -6
  77. package/dist/esm/src/ReorgStream.js.map +1 -1
  78. package/dist/esm/src/makeUserInterface.js +3 -4
  79. package/dist/esm/src/makeUserInterface.js.map +1 -1
  80. package/dist/esm/src/security/edgePolicy.js +377 -0
  81. package/dist/esm/src/security/edgePolicy.js.map +1 -0
  82. package/dist/types/mod.d.ts +1 -1
  83. package/dist/types/mod.d.ts.map +1 -1
  84. package/dist/types/src/ArcadeProvider.d.ts.map +1 -1
  85. package/dist/types/src/BanAwareDiscoveryStorage.d.ts.map +1 -1
  86. package/dist/types/src/BanAwareLookupWrapper.d.ts.map +1 -1
  87. package/dist/types/src/BanAwareTopicManager.d.ts.map +1 -1
  88. package/dist/types/src/BanService.d.ts.map +1 -1
  89. package/dist/types/src/ChaintracksProvider.d.ts.map +1 -1
  90. package/dist/types/src/JanitorService.d.ts +14 -1
  91. package/dist/types/src/JanitorService.d.ts.map +1 -1
  92. package/dist/types/src/OverlayExpress.d.ts +48 -2
  93. package/dist/types/src/OverlayExpress.d.ts.map +1 -1
  94. package/dist/types/src/OverlayMonitor.d.ts.map +1 -1
  95. package/dist/types/src/ProviderChainBroadcaster.d.ts.map +1 -1
  96. package/dist/types/src/ReorgStream.d.ts.map +1 -1
  97. package/dist/types/src/generalGuide.md.d.ts +1 -1
  98. package/dist/types/src/generalGuide.md.d.ts.map +1 -1
  99. package/dist/types/src/makeUserInterface.d.ts +1 -2
  100. package/dist/types/src/makeUserInterface.d.ts.map +1 -1
  101. package/dist/types/src/security/edgePolicy.d.ts +57 -0
  102. package/dist/types/src/security/edgePolicy.d.ts.map +1 -0
  103. package/package.json +47 -25
  104. package/dist/cjs/tsconfig.cjs.tsbuildinfo +0 -1
  105. package/dist/esm/tsconfig.esm.tsbuildinfo +0 -1
  106. package/dist/types/tsconfig.types.tsbuildinfo +0 -1
  107. package/mod.ts +0 -47
  108. package/src/ArcadeProvider.ts +0 -232
  109. package/src/BanAwareDiscoveryStorage.ts +0 -91
  110. package/src/BanAwareLookupWrapper.ts +0 -95
  111. package/src/BanAwareTopicManager.ts +0 -87
  112. package/src/BanService.ts +0 -154
  113. package/src/ChaintracksProvider.ts +0 -79
  114. package/src/JanitorService.ts +0 -423
  115. package/src/OverlayExpress.ts +0 -2479
  116. package/src/OverlayMonitor.ts +0 -817
  117. package/src/ProviderChainBroadcaster.ts +0 -108
  118. package/src/ReorgStream.ts +0 -221
  119. package/src/__tests__/BanAwareDiscoveryStorage.test.ts +0 -131
  120. package/src/__tests__/BanAwareLookupWrapper.test.ts +0 -255
  121. package/src/__tests__/BanAwareTopicManager.test.ts +0 -132
  122. package/src/__tests__/BanService.test.ts +0 -310
  123. package/src/__tests__/InMemoryMigrationSource.test.ts +0 -11
  124. package/src/__tests__/JanitorService.test.ts +0 -941
  125. package/src/__tests__/OverlayExpress.test.ts +0 -1300
  126. package/src/__tests__/OverlayMonitor.test.ts +0 -255
  127. package/src/__tests__/OverlayProviders.live.test.ts +0 -43
  128. package/src/__tests__/OverlayProviders.test.ts +0 -123
  129. package/src/__tests__/README.md +0 -105
  130. package/src/__tests__/ReorgStream.test.ts +0 -66
  131. package/src/__tests__/makeUserInterface.test.ts +0 -193
  132. package/src/__tests__/setup.ts +0 -36
  133. package/src/auth-express-middleware.d.ts +0 -16
  134. package/src/generalGuide.md.ts +0 -74
  135. package/src/makeUserInterface.ts +0 -1224
@@ -0,0 +1,466 @@
1
+ import express from 'express';
2
+ import { Engine, LookupService, TopicManager, Advertiser } from '@bsv/overlay';
3
+ import { ChainTracker, Broadcaster, OverlayBroadcastFacilitator, WalletInterface, SessionManager, AsyncSessionManager } from '@bsv/sdk';
4
+ import Knex from 'knex';
5
+ import { MongoClient, Db } from 'mongodb';
6
+ import { type UIConfig } from './makeUserInterface.js';
7
+ import { BanService } from './BanService.js';
8
+ import type { Server } from 'node:http';
9
+ import { type HttpServerPolicyDefaults, type SecurityHeadersOptions } from './security/edgePolicy.js';
10
+ /**
11
+ * Knex database migration.
12
+ */
13
+ interface Migration {
14
+ name?: string;
15
+ up: (knex: Knex.Knex) => Promise<void>;
16
+ down?: (knex: Knex.Knex) => Promise<void>;
17
+ }
18
+ /**
19
+ * Configuration options that map to Engine constructor parameters.
20
+ */
21
+ export type SyncConfigurationEntry = string[] | 'SHIP' | false;
22
+ export type SyncConfigurationMap = Record<string, SyncConfigurationEntry>;
23
+ export interface EngineConfig {
24
+ chainTracker?: ChainTracker | 'scripts only';
25
+ shipTrackers?: string[];
26
+ slapTrackers?: string[];
27
+ broadcaster?: Broadcaster;
28
+ advertiser?: Advertiser;
29
+ syncConfiguration?: SyncConfigurationMap;
30
+ logTime?: boolean;
31
+ logPrefix?: string;
32
+ throwOnBroadcastFailure?: boolean;
33
+ overlayBroadcastFacilitator?: OverlayBroadcastFacilitator;
34
+ suppressDefaultSyncAdvertisements?: boolean;
35
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
36
+ enableBASMSync?: boolean;
37
+ unprovenEvictionBlocks?: number;
38
+ reorgStreamUrl?: string;
39
+ reorgScanDepth?: number;
40
+ unprovenMaintenanceIntervalMs?: number;
41
+ }
42
+ export type HealthStatus = 'ok' | 'degraded' | 'error';
43
+ export interface HealthCheckResult {
44
+ name: string;
45
+ scope: 'live' | 'ready';
46
+ status: HealthStatus;
47
+ critical: boolean;
48
+ message?: string;
49
+ details?: Record<string, any>;
50
+ durationMs: number;
51
+ }
52
+ export type HealthCheckHandler = () => Promise<Omit<HealthCheckResult, 'name' | 'scope' | 'critical' | 'durationMs'> | void> | Omit<HealthCheckResult, 'name' | 'scope' | 'critical' | 'durationMs'> | void;
53
+ export interface HealthCheckDefinition {
54
+ name: string;
55
+ scope?: 'live' | 'ready';
56
+ critical?: boolean;
57
+ handler: HealthCheckHandler;
58
+ }
59
+ export interface HealthConfig {
60
+ includeDetails: boolean;
61
+ timeoutMs: number;
62
+ contextProvider?: () => Promise<Record<string, any> | undefined> | Record<string, any> | undefined;
63
+ }
64
+ export interface HealthReport {
65
+ status: HealthStatus;
66
+ live: boolean;
67
+ ready: boolean;
68
+ service: {
69
+ name: string;
70
+ advertisableFQDN: string;
71
+ port: number;
72
+ network: 'main' | 'test';
73
+ startedAt?: string;
74
+ uptimeMs: number;
75
+ topicManagerCount: number;
76
+ lookupServiceCount: number;
77
+ };
78
+ checks: HealthCheckResult[];
79
+ context?: Record<string, any>;
80
+ }
81
+ export interface EdgePolicyConfig {
82
+ environmentPrefix: string;
83
+ allowedOrigins?: string[];
84
+ jsonBodyLimitBytes: number;
85
+ binaryBodyLimitBytes: number;
86
+ maxConcurrentRequests: number;
87
+ http: HttpServerPolicyDefaults;
88
+ securityHeaders: SecurityHeadersOptions;
89
+ }
90
+ export type TopicAnchorHeaderResolver = (blockHeight: number) => Promise<{
91
+ blockHeight: number;
92
+ blockHash: string;
93
+ merkleRoot?: string;
94
+ } | undefined>;
95
+ /**
96
+ * OverlayExpress class provides an Express-based server for hosting Overlay Services.
97
+ * It allows configuration of various components like databases, topic managers, and lookup services.
98
+ * It encapsulates an Express application and provides methods to start the server.
99
+ */
100
+ export default class OverlayExpress {
101
+ name: string;
102
+ privateKey: string;
103
+ advertisableFQDN: string;
104
+ app: express.Application;
105
+ port: number;
106
+ logger: typeof console;
107
+ knex?: Knex.Knex;
108
+ migrationsToRun: Migration[];
109
+ mongoDb?: Db;
110
+ mongoClient?: MongoClient;
111
+ network: 'main' | 'test';
112
+ chainTracker: ChainTracker | 'scripts only';
113
+ engine?: Engine;
114
+ managers: Record<string, TopicManager>;
115
+ services: Record<string, LookupService>;
116
+ enableGASPSync: boolean;
117
+ enableBASMSync: boolean;
118
+ unprovenEvictionBlocks: number;
119
+ basmBlockPollIntervalMs: number;
120
+ private basmBlockPollTimer?;
121
+ unprovenMaintenanceIntervalMs: number;
122
+ private unprovenMaintenanceTimer?;
123
+ reorgStreamUrl?: string;
124
+ reorgScanDepth: number;
125
+ private reorgAdapter?;
126
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
127
+ arcApiKey: string | undefined;
128
+ arcCallbackToken: string | undefined;
129
+ arcadeUrl: string | undefined;
130
+ arcadeApiKey: string | undefined;
131
+ arcadeDeploymentId: string | undefined;
132
+ arcadeChaintracksApiPrefix: string;
133
+ private arcadeProvider?;
134
+ verboseRequestLogging: boolean;
135
+ webUIConfig: UIConfig;
136
+ engineConfig: EngineConfig;
137
+ private readonly adminToken;
138
+ janitorConfig: {
139
+ requestTimeoutMs: number;
140
+ hostDownRevokeScore: number;
141
+ autoBanOnRemoval: boolean;
142
+ allowPrivateHosts: boolean;
143
+ };
144
+ banService?: BanService;
145
+ adminIdentityKey?: string;
146
+ serverWallet?: WalletInterface;
147
+ authSessionManager?: SessionManager | AsyncSessionManager;
148
+ private startTime?;
149
+ healthConfig: HealthConfig;
150
+ healthChecks: HealthCheckDefinition[];
151
+ isListening: boolean;
152
+ server?: Server;
153
+ private closePromise?;
154
+ edgePolicyConfig: EdgePolicyConfig;
155
+ /**
156
+ * Constructs an instance of OverlayExpress.
157
+ * @param name - The name of the service
158
+ * @param privateKey - Private key used for signing advertisements
159
+ * @param advertisableFQDN - The fully qualified domain name where this service is available. Does not include "https://".
160
+ * @param adminToken - Optional. An administrative Bearer token used to protect admin routes.
161
+ * If not provided, a random token will be generated at runtime.
162
+ */
163
+ constructor(name: string, privateKey: string, advertisableFQDN: string, adminToken?: string);
164
+ /**
165
+ * Returns the current admin token in case you need to programmatically retrieve or display it.
166
+ */
167
+ getAdminToken(): string;
168
+ /**
169
+ * Configures the port on which the server will listen.
170
+ * @param port - The port number
171
+ */
172
+ configurePort(port: number): void;
173
+ /**
174
+ * Configures the web user interface
175
+ * @param config - Web UI configuration options
176
+ */
177
+ configureWebUI(config: UIConfig): void;
178
+ /**
179
+ * Configures the janitor service parameters
180
+ * @param config - Janitor configuration options
181
+ * - requestTimeoutMs: Timeout for health check requests (default: 10000ms)
182
+ * - hostDownRevokeScore: Number of consecutive failures before deleting output (default: 3)
183
+ * - autoBanOnRemoval: Whether to auto-ban domains when removed by janitor (default: true)
184
+ * - allowPrivateHosts: Permit private/HTTP targets for isolated local development (default: false)
185
+ */
186
+ configureJanitor(config: Partial<typeof this.janitorConfig>): void;
187
+ /**
188
+ * Configures health-report behavior.
189
+ */
190
+ configureHealth(config: Partial<HealthConfig>): void;
191
+ /**
192
+ * Configures explicit browser origins and bounded request/resource policy.
193
+ * Public cross-origin access is the default; pass allowedOrigins or set
194
+ * OVERLAY_CORS_MODE=allowlist to restrict browser callers.
195
+ */
196
+ configureEdgePolicy(config: Partial<Omit<EdgePolicyConfig, 'http' | 'securityHeaders'>> & {
197
+ http?: Partial<HttpServerPolicyDefaults>;
198
+ securityHeaders?: SecurityHeadersOptions;
199
+ }): void;
200
+ /**
201
+ * Registers an application-specific health check.
202
+ */
203
+ registerHealthCheck(definition: HealthCheckDefinition): void;
204
+ /**
205
+ * Configures the admin identity key for wallet-based admin detection.
206
+ * When set, the frontend can compare the user's wallet identity key against this
207
+ * to determine whether to show the admin dashboard.
208
+ *
209
+ * @param identityKey - The hex-encoded public key of the admin
210
+ */
211
+ configureAdminIdentityKey(identityKey: string): void;
212
+ /**
213
+ * Configures BRC-103 session storage for the administrative mutual-auth
214
+ * middleware. Horizontally scaled services should supply a shared
215
+ * AsyncSessionManager rather than use the default process-local store.
216
+ */
217
+ configureAuthSessionManager(sessionManager: SessionManager | AsyncSessionManager): void;
218
+ /**
219
+ * Configures the logger to be used by the server.
220
+ * @param logger - A logger object (e.g., console)
221
+ */
222
+ configureLogger(logger: typeof console): void;
223
+ /**
224
+ * Configures the BSV Blockchain network to be used ('main' or 'test').
225
+ * By default, it re-initializes chainTracker as a WhatsOnChain for that network.
226
+ * @param network - The network ('main' or 'test')
227
+ */
228
+ configureNetwork(network: 'main' | 'test'): void;
229
+ /**
230
+ * Configures the ChainTracker to be used.
231
+ * If 'scripts only' is used, it implies no full SPV chain tracking in the Engine.
232
+ * @param chainTracker - An instance of ChainTracker or 'scripts only'
233
+ */
234
+ configureChainTracker(chainTracker?: ChainTracker | 'scripts only'): void;
235
+ /**
236
+ * Configures the ARC API key.
237
+ * @param apiKey - The ARC API key
238
+ */
239
+ configureArcApiKey(apiKey: string): void;
240
+ /**
241
+ * Configures the ARC callback token expected by /arc-ingest.
242
+ * @param token - The token ARC should present when posting callback notifications.
243
+ */
244
+ configureArcCallbackToken(token: string): void;
245
+ /**
246
+ * Configures Arcade for first-choice transaction propagation and proof lookup.
247
+ */
248
+ configureArcade(url: string, config?: {
249
+ apiKey?: string;
250
+ deploymentId?: string;
251
+ chaintracksApiPrefix?: string;
252
+ }): void;
253
+ /**
254
+ * Configures a go-chaintracks compatible service for header validation and
255
+ * BASM reorg streaming. Arcade exposes this at `/chaintracks/v2`.
256
+ */
257
+ configureChaintracks(url: string, config?: {
258
+ apiPrefix?: string;
259
+ reorgStream?: boolean;
260
+ scanDepth?: number;
261
+ }): void;
262
+ /**
263
+ * Enables or disables GASP synchronization (high-level setting).
264
+ * This is a broad toggle that can be overridden or customized through syncConfiguration.
265
+ * @param enable - true to enable, false to disable
266
+ */
267
+ configureEnableGASPSync(enable: boolean): void;
268
+ /**
269
+ * Enables or disables BRC-136 BASM synchronization.
270
+ * BASM is opt-in because it requires direct proofs and block hash resolution.
271
+ */
272
+ configureEnableBASMSync(enable: boolean): void;
273
+ /**
274
+ * Configures the block header resolver used to derive BASM block hashes.
275
+ */
276
+ configureTopicAnchorHeaderResolver(resolver: TopicAnchorHeaderResolver): void;
277
+ /**
278
+ * Configures the go-chaintracks (Arcade) reorg SSE stream used to reconcile
279
+ * BASM anchors with blockchain reorganizations in real time.
280
+ * @param url - The reorg stream URL, e.g. `https://arcade.example/v2/reorg/stream`.
281
+ * @param scanDepth - Optional revalidation-sweep depth in blocks (default 3).
282
+ */
283
+ configureReorgStream(url: string, scanDepth?: number): void;
284
+ /**
285
+ * Configures the opt-in unproven state eviction threshold.
286
+ */
287
+ configureUnprovenEviction(config: {
288
+ thresholdBlocks?: number;
289
+ }): void;
290
+ /**
291
+ * Configures periodic unproven maintenance. Each run first tries configured
292
+ * proof providers, then evicts rows that are still unproven past the threshold.
293
+ */
294
+ configureUnprovenMaintenance(config: {
295
+ intervalMs?: number;
296
+ thresholdBlocks?: number;
297
+ }): void;
298
+ /**
299
+ * Configures how often the BASM anchor chain is extended with empty anchors to
300
+ * follow the chain tip. Set to 0 to disable periodic polling.
301
+ */
302
+ configureBASMBlockPollInterval(intervalMs: number): void;
303
+ /**
304
+ * Enables or disables verbose request logging.
305
+ * @param enable - true to enable, false to disable
306
+ */
307
+ configureVerboseRequestLogging(enable: boolean): void;
308
+ /**
309
+ * Configure Knex (SQL) database connection.
310
+ * @param config - Knex configuration object, or a MySQL connection string loaded from configuration.
311
+ */
312
+ configureKnex(config: Knex.Knex.Config | string): Promise<void>;
313
+ /**
314
+ * Configures the MongoDB database connection.
315
+ * Also initializes the BanService for persistent ban tracking.
316
+ * @param connectionString - MongoDB connection string
317
+ */
318
+ configureMongo(connectionString: string): Promise<void>;
319
+ /**
320
+ * Configures a Topic Manager.
321
+ * @param name - The name of the Topic Manager
322
+ * @param manager - An instance of TopicManager
323
+ */
324
+ configureTopicManager(name: string, manager: TopicManager): void;
325
+ /**
326
+ * Configures a Lookup Service.
327
+ * @param name - The name of the Lookup Service
328
+ * @param service - An instance of LookupService
329
+ */
330
+ configureLookupService(name: string, service: LookupService): void;
331
+ /**
332
+ * Configures a Lookup Service using Knex (SQL) database.
333
+ * @param name - The name of the Lookup Service
334
+ * @param serviceFactory - A factory function that creates a LookupService instance using Knex
335
+ */
336
+ configureLookupServiceWithKnex(name: string, serviceFactory: (knex: Knex.Knex) => {
337
+ service: LookupService;
338
+ migrations: Migration[];
339
+ }): void;
340
+ /**
341
+ * Configures a Lookup Service using MongoDB.
342
+ * @param name - The name of the Lookup Service
343
+ * @param serviceFactory - A factory function that creates a LookupService instance using MongoDB
344
+ */
345
+ configureLookupServiceWithMongo(name: string, serviceFactory: (mongoDb: Db) => LookupService): void;
346
+ /**
347
+ * Advanced configuration method for setting or overriding any
348
+ * Engine constructor parameters via an EngineConfig object.
349
+ *
350
+ * Example usage:
351
+ * configureEngineParams({
352
+ * logTime: true,
353
+ * throwOnBroadcastFailure: true,
354
+ * overlayBroadcastFacilitator: new MyCustomFacilitator()
355
+ * })
356
+ *
357
+ * These fields will be respected when we finally build/configure the Engine
358
+ * in the `configureEngine()` method below.
359
+ */
360
+ configureEngineParams(params: EngineConfig): void;
361
+ /**
362
+ * Configures the Overlay Engine itself.
363
+ * By default, auto-configures SHIP and SLAP unless autoConfigureShipSlap = false
364
+ * Then it merges in any advanced engine config from `this.engineConfig`.
365
+ *
366
+ * When a BanService is available (from configureMongo), auto-configured SHIP
367
+ * and SLAP managers, discovery storage, and lookup services are wrapped so
368
+ * banned outputs are not admitted or indexed.
369
+ *
370
+ * @param autoConfigureShipSlap - Whether to auto-configure SHIP and SLAP services (default: true)
371
+ */
372
+ configureEngine(autoConfigureShipSlap?: boolean): Promise<void>;
373
+ /** Wrap SHIP/SLAP managers and services with ban-aware filters if BanService is configured. */
374
+ private wrapBanAwareServices;
375
+ /** Build the sync config based on enableGASPSync and engineConfig. */
376
+ private buildSyncConfig;
377
+ /** Build the configured transaction propagation provider chain. */
378
+ private buildBroadcaster;
379
+ private ensureArcadeProvider;
380
+ private fetchArcadeProof;
381
+ private fetchConfiguredMerkleProof;
382
+ /** Build the BASM block header resolver. */
383
+ private buildTopicAnchorHeaderResolver;
384
+ /** Resolve the SLAP trackers from config or network defaults. */
385
+ private resolveSlapTrackers;
386
+ /** Build the WalletAdvertiser (or use user-provided one). */
387
+ private buildAdvertiser;
388
+ /** Initialize the server wallet for BSV mutual authentication. */
389
+ private initServerWallet;
390
+ /**
391
+ * Ensures that Knex is configured and returns it.
392
+ * @throws Error if Knex is not configured
393
+ */
394
+ private ensureKnex;
395
+ /**
396
+ * Ensures that MongoDB is configured and returns it.
397
+ * @throws Error if MongoDB is not configured
398
+ */
399
+ private ensureMongo;
400
+ /**
401
+ * Ensures that the Overlay Engine is configured and returns it.
402
+ * @throws Error if the Engine is not configured
403
+ */
404
+ private ensureEngine;
405
+ /**
406
+ * Creates a JanitorService instance with current configuration.
407
+ */
408
+ private createJanitor;
409
+ /** Ban a domain and remove all its SHIP/SLAP records from MongoDB. */
410
+ private handleBanDomain;
411
+ /** Parse outpoint string, ban it, and evict it from all lookup services. */
412
+ private handleBanOutpoint;
413
+ /** Evict an output from a specific service or all services (silent per-service errors). */
414
+ private evictFromServices;
415
+ /** Look up the domain of an outpoint from SHIP or SLAP records. */
416
+ private lookupDomainForOutpoint;
417
+ /** Ban a domain and delete all SHIP/SLAP records for it. */
418
+ private banDomainAndRemoveRecords;
419
+ private runHealthCheck;
420
+ private collectHealthReport;
421
+ /**
422
+ * Renders a request or response body for verbose logging, truncating overly long payloads.
423
+ */
424
+ private formatBodyForLog;
425
+ private redactHeadersForLog;
426
+ private arcCallbackRequestToken;
427
+ private arcCallbackAuthorized;
428
+ private processArcIngest;
429
+ /**
430
+ * Installs middleware that verbosely logs incoming requests and outgoing responses.
431
+ */
432
+ private setupVerboseRequestLogging;
433
+ /**
434
+ * Starts the Express server.
435
+ * Sets up routes and begins listening on the configured port.
436
+ */
437
+ start(): Promise<void>;
438
+ /**
439
+ * Stops new HTTP work, background synchronization, and database clients.
440
+ *
441
+ * The operation is idempotent so multiple signal handlers or embedding
442
+ * runtimes can share shutdown ownership safely.
443
+ */
444
+ close(): Promise<void>;
445
+ private closeResources;
446
+ /**
447
+ * Runs the post-listen startup work: advertiser init, advertisement sync,
448
+ * and the optional GASP/BASM background syncs.
449
+ */
450
+ private runStartupSync;
451
+ /** Attempt a GASP sync at startup when enabled. */
452
+ private runGaspStartupSync;
453
+ /** Attempt a BASM sync at startup when enabled, then begin tip-following. */
454
+ private runBasmStartupSync;
455
+ /** Poll for new blocks to advance anchor chains and detect reorgs. */
456
+ private startBASMBlockPolling;
457
+ /** Real-time reorg reconciliation via the go-chaintracks (Arcade) reorg SSE. */
458
+ private startBASMReorgStream;
459
+ /** Extend every topic's BASM anchor chain to the current chain tip. */
460
+ private advanceBASMAnchorChains;
461
+ /** Revalidate recent BASM anchors against the chain tracker, reconciling any reorg. */
462
+ private revalidateBASMAnchors;
463
+ private startUnprovenMaintenance;
464
+ }
465
+ export {};
466
+ //# sourceMappingURL=OverlayExpress.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"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"}