@bsv/overlay-express 2.3.0 → 2.3.1

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 (51) hide show
  1. package/dist/cjs/mod.js +7 -1
  2. package/dist/cjs/mod.js.map +1 -1
  3. package/dist/cjs/package.json +4 -4
  4. package/dist/cjs/src/BanAwareDiscoveryStorage.js +78 -0
  5. package/dist/cjs/src/BanAwareDiscoveryStorage.js.map +1 -0
  6. package/dist/cjs/src/BanAwareTopicManager.js +71 -0
  7. package/dist/cjs/src/BanAwareTopicManager.js.map +1 -0
  8. package/dist/cjs/src/OverlayExpress.js +348 -95
  9. package/dist/cjs/src/OverlayExpress.js.map +1 -1
  10. package/dist/cjs/src/OverlayMonitor.js +166 -8
  11. package/dist/cjs/src/OverlayMonitor.js.map +1 -1
  12. package/dist/cjs/src/ReorgStream.js +193 -0
  13. package/dist/cjs/src/ReorgStream.js.map +1 -0
  14. package/dist/cjs/tsconfig.cjs.tsbuildinfo +1 -1
  15. package/dist/esm/mod.js +3 -1
  16. package/dist/esm/mod.js.map +1 -1
  17. package/dist/esm/src/BanAwareDiscoveryStorage.js +79 -0
  18. package/dist/esm/src/BanAwareDiscoveryStorage.js.map +1 -0
  19. package/dist/esm/src/BanAwareTopicManager.js +71 -0
  20. package/dist/esm/src/BanAwareTopicManager.js.map +1 -0
  21. package/dist/esm/src/OverlayExpress.js +348 -93
  22. package/dist/esm/src/OverlayExpress.js.map +1 -1
  23. package/dist/esm/src/OverlayMonitor.js +160 -6
  24. package/dist/esm/src/OverlayMonitor.js.map +1 -1
  25. package/dist/esm/src/ReorgStream.js +190 -0
  26. package/dist/esm/src/ReorgStream.js.map +1 -0
  27. package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
  28. package/dist/types/mod.d.ts +4 -2
  29. package/dist/types/mod.d.ts.map +1 -1
  30. package/dist/types/src/BanAwareDiscoveryStorage.d.ts +36 -0
  31. package/dist/types/src/BanAwareDiscoveryStorage.d.ts.map +1 -0
  32. package/dist/types/src/BanAwareTopicManager.d.ts +28 -0
  33. package/dist/types/src/BanAwareTopicManager.d.ts.map +1 -0
  34. package/dist/types/src/OverlayExpress.d.ts +76 -4
  35. package/dist/types/src/OverlayExpress.d.ts.map +1 -1
  36. package/dist/types/src/OverlayMonitor.d.ts +45 -1
  37. package/dist/types/src/OverlayMonitor.d.ts.map +1 -1
  38. package/dist/types/src/ReorgStream.d.ts +74 -0
  39. package/dist/types/src/ReorgStream.d.ts.map +1 -0
  40. package/dist/types/tsconfig.types.tsbuildinfo +1 -1
  41. package/mod.ts +7 -1
  42. package/package.json +4 -4
  43. package/src/BanAwareDiscoveryStorage.ts +91 -0
  44. package/src/BanAwareTopicManager.ts +87 -0
  45. package/src/OverlayExpress.ts +431 -100
  46. package/src/OverlayMonitor.ts +219 -7
  47. package/src/ReorgStream.ts +221 -0
  48. package/src/__tests__/BanAwareDiscoveryStorage.test.ts +131 -0
  49. package/src/__tests__/BanAwareTopicManager.test.ts +132 -0
  50. package/src/__tests__/OverlayMonitor.test.ts +66 -1
  51. package/src/__tests__/ReorgStream.test.ts +66 -0
@@ -1,6 +1,8 @@
1
- export { default, type EngineConfig, type HealthCheckDefinition, type HealthCheckHandler, type HealthCheckResult, type HealthConfig, type HealthReport, type HealthStatus } from './src/OverlayExpress.js';
1
+ export { default, type EngineConfig, type HealthCheckDefinition, type HealthCheckHandler, type HealthCheckResult, type HealthConfig, type HealthReport, type HealthStatus, type TopicAnchorHeaderResolver } from './src/OverlayExpress.js';
2
2
  export { BanService, type BannedRecord } from './src/BanService.js';
3
3
  export { BanAwareLookupWrapper } from './src/BanAwareLookupWrapper.js';
4
+ export { BanAwareTopicManager } from './src/BanAwareTopicManager.js';
5
+ export { BanAwareSHIPStorage, BanAwareSLAPStorage } from './src/BanAwareDiscoveryStorage.js';
4
6
  export { JanitorService, type JanitorConfig, type JanitorReport, type HostHealthResult } from './src/JanitorService.js';
5
- export { OverlayMonitor, analyzeOverlayLookupResponse, type OverlayLookupOutputSummary, type OverlayLookupProbe, type OverlayLookupProbeResult, type OverlayMonitorConfig, type OverlayMonitorLogger, type OverlayMonitorReport, type OverlayMonitorTarget, type OverlayMonitorThresholds, type OverlayMonitorWarning } from './src/OverlayMonitor.js';
7
+ export { OverlayMonitor, analyzeOverlayAnchorTip, analyzeOverlayLookupResponse, type OverlayAnchorProbe, type OverlayAnchorProbeResult, type OverlayLookupOutputSummary, type OverlayLookupProbe, type OverlayLookupProbeResult, type OverlayMonitorConfig, type OverlayMonitorLogger, type OverlayMonitorReport, type OverlayMonitorTarget, type OverlayMonitorThresholds, type OverlayMonitorWarning } from './src/OverlayMonitor.js';
6
8
  //# sourceMappingURL=mod.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvH,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAA"}
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAA"}
@@ -0,0 +1,36 @@
1
+ import * as DiscoveryServices from '@bsv/overlay-discovery-services';
2
+ import { BanService } from './BanService.js';
3
+ type SHIPStorage = InstanceType<typeof DiscoveryServices.SHIPStorage>;
4
+ type SLAPStorage = InstanceType<typeof DiscoveryServices.SLAPStorage>;
5
+ /**
6
+ * Prevents banned SHIP records from being written to discovery storage.
7
+ */
8
+ export declare class BanAwareSHIPStorage {
9
+ private readonly wrapped;
10
+ private readonly banService;
11
+ private readonly logger;
12
+ constructor(wrapped: SHIPStorage, banService: BanService, logger?: typeof console);
13
+ ensureIndexes(): Promise<void>;
14
+ hasDuplicateRecord(identityKey: string, domain: string, topic: string): Promise<boolean>;
15
+ storeSHIPRecord(txid: string, outputIndex: number, identityKey: string, domain: string, topic: string): Promise<void>;
16
+ deleteSHIPRecord(txid: string, outputIndex: number): Promise<void>;
17
+ findRecord(...args: Parameters<SHIPStorage['findRecord']>): ReturnType<SHIPStorage['findRecord']>;
18
+ findAll(...args: Parameters<SHIPStorage['findAll']>): ReturnType<SHIPStorage['findAll']>;
19
+ }
20
+ /**
21
+ * Prevents banned SLAP records from being written to discovery storage.
22
+ */
23
+ export declare class BanAwareSLAPStorage {
24
+ private readonly wrapped;
25
+ private readonly banService;
26
+ private readonly logger;
27
+ constructor(wrapped: SLAPStorage, banService: BanService, logger?: typeof console);
28
+ ensureIndexes(): Promise<void>;
29
+ hasDuplicateRecord(identityKey: string, domain: string, service: string): Promise<boolean>;
30
+ storeSLAPRecord(txid: string, outputIndex: number, identityKey: string, domain: string, service: string): Promise<void>;
31
+ deleteSLAPRecord(txid: string, outputIndex: number): Promise<void>;
32
+ findRecord(...args: Parameters<SLAPStorage['findRecord']>): ReturnType<SLAPStorage['findRecord']>;
33
+ findAll(...args: Parameters<SLAPStorage['findAll']>): ReturnType<SLAPStorage['findAll']>;
34
+ }
35
+ export {};
36
+ //# sourceMappingURL=BanAwareDiscoveryStorage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BanAwareDiscoveryStorage.d.ts","sourceRoot":"","sources":["../../../src/BanAwareDiscoveryStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,iBAAiB,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAA;AACrE,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAA;AAErE;;GAEG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,OAAO,OAAiB;IAG7C,aAAa,IAAK,OAAO,CAAC,IAAI,CAAC;IAI/B,kBAAkB,CAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzF,eAAe,CAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtH,gBAAgB,CAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,UAAU,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIlG,OAAO,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAGhG;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,OAAO,OAAiB;IAG7C,aAAa,IAAK,OAAO,CAAC,IAAI,CAAC;IAI/B,kBAAkB,CAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3F,eAAe,CAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxH,gBAAgB,CAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,UAAU,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIlG,OAAO,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAGhG"}
@@ -0,0 +1,28 @@
1
+ import { TopicManager } from '@bsv/overlay';
2
+ import { AdmittanceInstructions } from '@bsv/sdk';
3
+ import { BanService } from './BanService.js';
4
+ /**
5
+ * Filters banned SHIP or SLAP advertisement outputs before the overlay engine
6
+ * admits them into topic storage.
7
+ */
8
+ export declare class BanAwareTopicManager implements TopicManager {
9
+ private readonly wrapped;
10
+ private readonly banService;
11
+ private readonly protocol;
12
+ private readonly logger;
13
+ constructor(wrapped: TopicManager, banService: BanService, protocol: 'SHIP' | 'SLAP', logger?: typeof console);
14
+ identifyAdmissibleOutputs(beef: number[], previousCoins: number[], offChainValues?: number[], mode?: 'historical-tx' | 'current-tx' | 'historical-tx-no-spv'): Promise<AdmittanceInstructions>;
15
+ identifyNeededInputs(beef: number[], offChainValues?: number[]): Promise<Array<{
16
+ txid: string;
17
+ outputIndex: number;
18
+ }>>;
19
+ getDocumentation(): Promise<string>;
20
+ getMetaData(): Promise<{
21
+ name: string;
22
+ shortDescription: string;
23
+ iconURL?: string;
24
+ version?: string;
25
+ informationURL?: string;
26
+ }>;
27
+ }
28
+ //# sourceMappingURL=BanAwareTopicManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BanAwareTopicManager.d.ts","sourceRoot":"","sources":["../../../src/BanAwareTopicManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAgC,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,MAAM,GAAE,OAAO,OAAiB;IAG7C,yBAAyB,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,EAAE,MAAM,EAAE,EACvB,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,IAAI,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,sBAAsB,GAC7D,OAAO,CAAC,sBAAsB,CAAC;IA6C5B,oBAAoB,CAAE,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOvH,gBAAgB,IAAK,OAAO,CAAC,MAAM,CAAC;IAIpC,WAAW,IAAK,OAAO,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAA;QACZ,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;CAGH"}
@@ -28,6 +28,11 @@ export interface EngineConfig {
28
28
  throwOnBroadcastFailure?: boolean;
29
29
  overlayBroadcastFacilitator?: OverlayBroadcastFacilitator;
30
30
  suppressDefaultSyncAdvertisements?: boolean;
31
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
32
+ enableBASMSync?: boolean;
33
+ unprovenEvictionBlocks?: number;
34
+ reorgStreamUrl?: string;
35
+ reorgScanDepth?: number;
31
36
  }
32
37
  export type HealthStatus = 'ok' | 'degraded' | 'error';
33
38
  export interface HealthCheckResult {
@@ -68,6 +73,11 @@ export interface HealthReport {
68
73
  checks: HealthCheckResult[];
69
74
  context?: Record<string, any>;
70
75
  }
76
+ export type TopicAnchorHeaderResolver = (blockHeight: number) => Promise<{
77
+ blockHeight: number;
78
+ blockHash: string;
79
+ merkleRoot?: string;
80
+ } | undefined>;
71
81
  /**
72
82
  * OverlayExpress class provides an Express-based server for hosting Overlay Services.
73
83
  * It allows configuration of various components like databases, topic managers, and lookup services.
@@ -90,6 +100,14 @@ export default class OverlayExpress {
90
100
  managers: Record<string, TopicManager>;
91
101
  services: Record<string, LookupService>;
92
102
  enableGASPSync: boolean;
103
+ enableBASMSync: boolean;
104
+ unprovenEvictionBlocks: number;
105
+ basmBlockPollIntervalMs: number;
106
+ private basmBlockPollTimer?;
107
+ reorgStreamUrl?: string;
108
+ reorgScanDepth: number;
109
+ private reorgAdapter?;
110
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
93
111
  arcApiKey: string | undefined;
94
112
  arcCallbackToken: string | undefined;
95
113
  verboseRequestLogging: boolean;
@@ -188,6 +206,33 @@ export default class OverlayExpress {
188
206
  * @param enable - true to enable, false to disable
189
207
  */
190
208
  configureEnableGASPSync(enable: boolean): void;
209
+ /**
210
+ * Enables or disables BRC-136 BASM synchronization.
211
+ * BASM is opt-in because it requires direct proofs and block hash resolution.
212
+ */
213
+ configureEnableBASMSync(enable: boolean): void;
214
+ /**
215
+ * Configures the block header resolver used to derive BASM block hashes.
216
+ */
217
+ configureTopicAnchorHeaderResolver(resolver: TopicAnchorHeaderResolver): void;
218
+ /**
219
+ * Configures the go-chaintracks (Arcade) reorg SSE stream used to reconcile
220
+ * BASM anchors with blockchain reorganizations in real time.
221
+ * @param url - The reorg stream URL, e.g. `https://arcade.example/v2/reorg/stream`.
222
+ * @param scanDepth - Optional revalidation-sweep depth in blocks (default 3).
223
+ */
224
+ configureReorgStream(url: string, scanDepth?: number): void;
225
+ /**
226
+ * Configures the opt-in unproven state eviction threshold.
227
+ */
228
+ configureUnprovenEviction(config: {
229
+ thresholdBlocks?: number;
230
+ }): void;
231
+ /**
232
+ * Configures how often the BASM anchor chain is extended with empty anchors to
233
+ * follow the chain tip. Set to 0 to disable periodic polling.
234
+ */
235
+ configureBASMBlockPollInterval(intervalMs: number): void;
191
236
  /**
192
237
  * Enables or disables verbose request logging.
193
238
  * @param enable - true to enable, false to disable
@@ -251,19 +296,21 @@ export default class OverlayExpress {
251
296
  * By default, auto-configures SHIP and SLAP unless autoConfigureShipSlap = false
252
297
  * Then it merges in any advanced engine config from `this.engineConfig`.
253
298
  *
254
- * When a BanService is available (from configureMongo), SHIP and SLAP lookup
255
- * services are automatically wrapped with BanAwareLookupWrapper to prevent
256
- * GASP from re-syncing banned tokens.
299
+ * When a BanService is available (from configureMongo), auto-configured SHIP
300
+ * and SLAP managers, discovery storage, and lookup services are wrapped so
301
+ * banned outputs are not admitted or indexed.
257
302
  *
258
303
  * @param autoConfigureShipSlap - Whether to auto-configure SHIP and SLAP services (default: true)
259
304
  */
260
305
  configureEngine(autoConfigureShipSlap?: boolean): Promise<void>;
261
- /** Wrap SHIP/SLAP with ban-aware filter if BanService is configured. */
306
+ /** Wrap SHIP/SLAP managers and services with ban-aware filters if BanService is configured. */
262
307
  private wrapBanAwareServices;
263
308
  /** Build the sync config based on enableGASPSync and engineConfig. */
264
309
  private buildSyncConfig;
265
310
  /** Build the ARC broadcaster if an API key is configured. */
266
311
  private buildBroadcaster;
312
+ /** Build the BASM block header resolver. */
313
+ private buildTopicAnchorHeaderResolver;
267
314
  /** Resolve the SLAP trackers from config or network defaults. */
268
315
  private resolveSlapTrackers;
269
316
  /** Build the WalletAdvertiser (or use user-provided one). */
@@ -301,11 +348,36 @@ export default class OverlayExpress {
301
348
  private banDomainAndRemoveRecords;
302
349
  private runHealthCheck;
303
350
  private collectHealthReport;
351
+ /**
352
+ * Renders a request or response body for verbose logging, truncating overly long payloads.
353
+ */
354
+ private formatBodyForLog;
355
+ /**
356
+ * Installs middleware that verbosely logs incoming requests and outgoing responses.
357
+ */
358
+ private setupVerboseRequestLogging;
304
359
  /**
305
360
  * Starts the Express server.
306
361
  * Sets up routes and begins listening on the configured port.
307
362
  */
308
363
  start(): Promise<void>;
364
+ /**
365
+ * Runs the post-listen startup work: advertiser init, advertisement sync,
366
+ * and the optional GASP/BASM background syncs.
367
+ */
368
+ private runStartupSync;
369
+ /** Attempt a GASP sync at startup when enabled. */
370
+ private runGaspStartupSync;
371
+ /** Attempt a BASM sync at startup when enabled, then begin tip-following. */
372
+ private runBasmStartupSync;
373
+ /** Poll for new blocks to advance anchor chains and detect reorgs. */
374
+ private startBASMBlockPolling;
375
+ /** Real-time reorg reconciliation via the go-chaintracks (Arcade) reorg SSE. */
376
+ private startBASMReorgStream;
377
+ /** Extend every topic's BASM anchor chain to the current chain tip. */
378
+ private advanceBASMAnchorChains;
379
+ /** Revalidate recent BASM anchors against the chain tracker, reconciling any reorg. */
380
+ private revalidateBASMAnchors;
309
381
  }
310
382
  export {};
311
383
  //# sourceMappingURL=OverlayExpress.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"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"}
@@ -9,10 +9,19 @@ export interface OverlayLookupProbe {
9
9
  query: unknown;
10
10
  maxOutputs?: number;
11
11
  }
12
+ export interface OverlayAnchorProbe {
13
+ name?: string;
14
+ topic: string;
15
+ expectedTac?: string;
16
+ expectedBlockHeight?: number;
17
+ currentHeight?: number;
18
+ maxTipLagBlocks?: number;
19
+ }
12
20
  export interface OverlayMonitorTarget {
13
21
  name: string;
14
22
  baseUrl: string;
15
23
  probes: OverlayLookupProbe[];
24
+ anchorProbes?: OverlayAnchorProbe[];
16
25
  headers?: Record<string, string>;
17
26
  }
18
27
  export interface OverlayMonitorThresholds {
@@ -20,6 +29,8 @@ export interface OverlayMonitorThresholds {
20
29
  beefBytes?: number;
21
30
  txsWithoutProof?: number;
22
31
  requireSubjectProof?: boolean;
32
+ anchorTipLagBlocks?: number;
33
+ expiredUnprovenCount?: number;
23
34
  }
24
35
  export interface OverlayMonitorConfig {
25
36
  targets: OverlayMonitorTarget[];
@@ -33,7 +44,7 @@ export interface OverlayMonitorConfig {
33
44
  now?: () => Date;
34
45
  }
35
46
  export interface OverlayMonitorWarning {
36
- code: 'response-bytes' | 'beef-bytes' | 'txs-without-proof' | 'subject-proof-missing';
47
+ code: 'response-bytes' | 'beef-bytes' | 'txs-without-proof' | 'subject-proof-missing' | 'anchor-tip-mismatch' | 'anchor-stale-height' | 'expired-unproven-state';
37
48
  message: string;
38
49
  value: number | boolean;
39
50
  threshold?: number | boolean;
@@ -68,14 +79,30 @@ export interface OverlayLookupProbeResult {
68
79
  durationMs: number;
69
80
  error?: string;
70
81
  }
82
+ export interface OverlayAnchorProbeResult {
83
+ target: string;
84
+ url: string;
85
+ probe: string;
86
+ topic: string;
87
+ status: number;
88
+ ok: boolean;
89
+ responseBytes: number;
90
+ blockHeight?: number;
91
+ tac?: string;
92
+ warnings: OverlayMonitorWarning[];
93
+ durationMs: number;
94
+ error?: string;
95
+ }
71
96
  export interface OverlayMonitorReport {
72
97
  startedAt: Date;
73
98
  completedAt: Date;
74
99
  durationMs: number;
75
100
  results: OverlayLookupProbeResult[];
101
+ anchorResults: OverlayAnchorProbeResult[];
76
102
  summary: {
77
103
  targetCount: number;
78
104
  probeCount: number;
105
+ anchorProbeCount: number;
79
106
  failedProbeCount: number;
80
107
  responseBytes: number;
81
108
  outputCount: number;
@@ -119,7 +146,24 @@ export declare class OverlayMonitor {
119
146
  start(): void;
120
147
  stop(): void;
121
148
  private runProbe;
149
+ private runAnchorProbe;
122
150
  }
151
+ export declare function analyzeOverlayAnchorTip(options: {
152
+ target: string;
153
+ url: string;
154
+ probe: string;
155
+ topic: string;
156
+ status: number;
157
+ ok: boolean;
158
+ responseBody: Record<string, unknown>;
159
+ responseBytes: number;
160
+ durationMs: number;
161
+ thresholds?: OverlayMonitorThresholds;
162
+ expectedTac?: string;
163
+ expectedBlockHeight?: number;
164
+ currentHeight?: number;
165
+ maxTipLagBlocks?: number;
166
+ }): OverlayAnchorProbeResult;
123
167
  export declare function analyzeOverlayLookupResponse(options: AnalyzeOptions): OverlayLookupProbeResult;
124
168
  export {};
125
169
  //# sourceMappingURL=OverlayMonitor.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"OverlayMonitor.d.ts","sourceRoot":"","sources":["../../../src/OverlayMonitor.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"OverlayMonitor.d.ts","sourceRoot":"","sources":["../../../src/OverlayMonitor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Consumes the go-chaintracks (Arcade) reorg SSE stream (`GET /v2/reorg/stream`)
3
+ * and normalizes each `ReorgEvent` into the overlay engine's `handleReorg` input.
4
+ *
5
+ * The stream emits `data: <JSON>\n\n` frames (no `event:`/`id:` lines) with
6
+ * `: keepalive` comment frames in between. Because there are no event ids, a
7
+ * reconnect cannot replay events missed while disconnected — so every (re)connect
8
+ * triggers an `onConnect` catch-up (the engine's revalidation sweep).
9
+ */
10
+ /** Input shape accepted by `Engine.handleReorg`. */
11
+ export interface ReorgHandlerInput {
12
+ orphanedBlockHashes: string[];
13
+ rebuildFromHeight: number;
14
+ newTipHeight: number;
15
+ }
16
+ /**
17
+ * Parses a single SSE data frame (a go-chaintracks `ReorgEvent` JSON document)
18
+ * into `handleReorg` input. Returns `null` for malformed frames.
19
+ *
20
+ * `ReorgEvent` = { orphanedHashes: string[], commonAncestor: BlockHeader|null,
21
+ * newTip: BlockHeader, depth: number }. Block hashes are go-sdk `chainhash.Hash`
22
+ * values marshaled as reversed (display) hex; they are lower-cased here to match
23
+ * the overlay's stored block hashes.
24
+ */
25
+ export declare function parseReorgEvent(frame: string): ReorgHandlerInput | null;
26
+ /**
27
+ * Splits an SSE byte buffer into complete event payloads. Frames are delimited by
28
+ * a blank line (`\n\n`); within a frame, `data:` lines are concatenated and
29
+ * comment lines (starting with `:`) are ignored. Any trailing partial frame is
30
+ * returned in `rest` for the next read.
31
+ */
32
+ export declare function extractSseFrames(buffer: string): {
33
+ events: string[];
34
+ rest: string;
35
+ };
36
+ export interface ReorgSseAdapterOptions {
37
+ /** Reorg SSE URL, e.g. `https://arcade.example/v2/reorg/stream`. */
38
+ url: string;
39
+ /** Invoked for each parsed reorg event. */
40
+ onReorg: (input: ReorgHandlerInput) => Promise<void>;
41
+ /** Invoked on every (re)connect for catch-up, since the stream has no replay. */
42
+ onConnect?: () => Promise<void>;
43
+ logger?: Pick<typeof console, 'log' | 'warn' | 'error'>;
44
+ /** Delay before reconnecting after the stream ends or errors. */
45
+ reconnectDelayMs?: number;
46
+ /** Injectable fetch (defaults to global fetch); aids testing. */
47
+ fetchImpl?: typeof fetch;
48
+ }
49
+ /**
50
+ * Long-lived SSE client that keeps the overlay's BASM anchors reconciled with
51
+ * chain reorgs. Auto-reconnects with a fixed delay and runs a catch-up on connect.
52
+ */
53
+ export declare class ReorgSseAdapter {
54
+ private readonly url;
55
+ private readonly onReorg;
56
+ private readonly onConnect?;
57
+ private readonly logger;
58
+ private readonly reconnectDelayMs;
59
+ private readonly fetchImpl;
60
+ private controller?;
61
+ private stopped;
62
+ constructor(options: ReorgSseAdapterOptions);
63
+ /** Begins consuming the stream in the background. */
64
+ start(): void;
65
+ /** Stops consuming and aborts any in-flight connection. */
66
+ stop(): void;
67
+ private runLoop;
68
+ private connectOnce;
69
+ private runCatchUp;
70
+ private pumpEvents;
71
+ private processReorgFrame;
72
+ private delay;
73
+ }
74
+ //# sourceMappingURL=ReorgStream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReorgStream.d.ts","sourceRoot":"","sources":["../../../src/ReorgStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiCxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAE,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsBpF;AAED,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACvD,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,OAAO,CAAQ;gBAEV,OAAO,EAAE,sBAAsB;IAS5C,qDAAqD;IACrD,KAAK,IAAK,IAAI;IAOd,2DAA2D;IAC3D,IAAI,IAAK,IAAI;YAKC,OAAO;YAgBP,WAAW;YAeX,UAAU;YAWV,UAAU;YAiBV,iBAAiB;YAajB,KAAK;CAMpB"}