@aztec/p2p 0.0.1-commit.c7c42ec → 0.0.1-commit.cf93bcc56

package/dest/services/dummy_service.js

@@ -35,6 +35,15 @@ import { PeerDiscoveryState } from './service.js';
    * Register a callback into the validator client for when a block proposal is received
    */ registerBlockReceivedCallback(_callback) {}
     /**
+   * Register a callback into the validator client for when a checkpoint proposal is received
+   */ registerCheckpointReceivedCallback(_callback) {}
+    /**
+   * Register a callback for when a duplicate proposal is detected
+   */ registerDuplicateProposalCallback(_callback) {}
+    /**
+   * Register a callback for when a duplicate attestation is detected
+   */ registerDuplicateAttestationCallback(_callback) {}
+    /**
    * Sends a request to a peer.
    * @param _protocol - The protocol to send the request on.
    * @param _request - The request to send.
@@ -50,6 +59,12 @@ import { PeerDiscoveryState } from './service.js';
    */ sendBatchRequest(_protocol, _requests) {
         return Promise.resolve([]);
     }
+    sendRequestToPeer(_peerId, _subProtocol, _payload, _dialTimeout) {
+        return Promise.resolve({
+            status: ReqRespStatus.SUCCESS,
+            data: Buffer.from([])
+        });
+    }
     /**
    * Returns the ENR of the peer.
    * @returns The ENR of the peer, otherwise undefined.
@@ -59,6 +74,9 @@ import { PeerDiscoveryState } from './service.js';
     validate(_txs) {
         return Promise.resolve();
     }
+    validatePropagatedTx(_tx, _peerId) {
+        return Promise.resolve(true);
+    }
     addReqRespSubProtocol(_subProtocol, _handler, _validator) {
         return Promise.resolve();
     }
@@ -67,6 +85,29 @@ import { PeerDiscoveryState } from './service.js';
     }
     //this is no-op
     registerThisValidatorAddresses(_address) {}
+    /**
+   * Get dummy BatchTxRequesterLibP2PService for testing
+   */ getBatchTxRequesterService() {
+        return {
+            reqResp: this,
+            connectionSampler: new DummyReqResp().getConnectionSampler(),
+            txValidatorConfig: {
+                l1ChainId: 1,
+                rollupVersion: 1,
+                proofVerifier: {
+                    verifyProof: ()=>Promise.resolve({
+                            valid: true,
+                            durationMs: 0,
+                            totalDurationMs: 0
+                        }),
+                    stop: ()=>Promise.resolve()
+                }
+            },
+            peerScoring: {
+                penalizePeer: (_peerId, _penalty)=>{}
+            }
+        };
+    }
 }
 /**
  * A dummy implementation of the Peer Discovery Service.
@@ -169,6 +210,13 @@ export class DummyReqResp {
             data: Buffer.from([])
         });
     }
+    /**
+   * Get dummy connection sampler for testing
+   */ getConnectionSampler() {
+        return {
+            getPeerListSortedByConnectionCountAsc: ()=>[]
+        };
+    }
     addSubProtocol(_subProtocol, _handler, _validator) {
         return Promise.resolve();
     }

package/dest/services/encoding.d.ts

@@ -27,7 +27,7 @@ export declare class SnappyTransform implements DataTransform {
     private logger;
     constructor(maxSizesKb?: Record<TopicType, number>, defaultMaxSizeKb?: number, logger?: import("@aztec/foundation/log").Logger);
     inboundTransform(topicStr: string, data: Uint8Array): Uint8Array;
-    inboundTransformData(data: Buffer, topic?: TopicType): Buffer;
+    inboundTransformData(data: Buffer, topic?: TopicType, maxSizeKbOverride?: number): Buffer;
     outboundTransform(_topicStr: string, data: Uint8Array): Uint8Array;
     outboundTransformData(data: Buffer): Buffer;
 }
@@ -47,4 +47,4 @@ export declare function readSnappyPreamble(data: Uint8Array): {
     decompressedSize: number;
     bytesRead: number;
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5jb2RpbmcuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2aWNlcy9lbmNvZGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEVBQUUsU0FBUyxFQUFzQixNQUFNLG1CQUFtQixDQUFDO0FBRWxFLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQy9ELE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBQ3ZFLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBYWpEOzs7R0FHRztBQUNILHdCQUFnQixXQUFXLENBQUMsTUFBTSxFQUFFLEdBQUcsQ0FBQyxPQUFPLEdBQUcsTUFBTSxDQUt2RDtBQUVELHdCQUFnQixZQUFZLENBQUMsS0FBSyxFQUFFLFVBQVUsR0FBRyxNQUFNLENBSXREO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLE9BQU8sRUFBRSxPQUFPLHVCQUsxQztBQVlEOztHQUVHO0FBQ0gscUJBQWEsZUFBZ0IsWUFBVyxhQUFhO0lBRWpELE9BQU8sQ0FBQyxVQUFVO0lBQ2xCLE9BQU8sQ0FBQyxnQkFBZ0I7SUFDeEIsT0FBTyxDQUFDLE1BQU07SUFIaEIsWUFDVSxVQUFVLEdBQUUsTUFBTSxDQUFDLFNBQVMsRUFBRSxNQUFNLENBQXFCLEVBQ3pELGdCQUFnQixHQUFFLE1BQWtCLEVBQ3BDLE1BQU0seUNBQXVDLEVBQ25EO0lBR0osZ0JBQWdCLENBQUMsUUFBUSxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsVUFBVSxHQUFHLFVBQVUsQ0FHL0Q7SUFFTSxvQkFBb0IsQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLEtBQUssQ0FBQyxFQUFFLFNBQVMsR0FBRyxNQUFNLENBWW5FO0lBR0QsaUJBQWlCLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsVUFBVSxHQUFHLFVBQVUsQ0FFakU7SUFFTSxxQkFBcUIsQ0FBQyxJQUFJLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FLakQ7Q0FDRjtBQUVEOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsd0JBQWdCLGtCQUFrQixDQUFDLElBQUksRUFBRSxVQUFVLEdBQUc7SUFBRSxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFBQyxTQUFTLEVBQUUsTUFBTSxDQUFBO0NBQUUsQ0FtQ3BHIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5jb2RpbmcuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2aWNlcy9lbmNvZGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEVBQWtCLFNBQVMsRUFBc0IsTUFBTSxtQkFBbUIsQ0FBQztBQUVsRixPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUMvRCxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUN2RSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQWFqRDs7O0dBR0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLE1BQU0sRUFBRSxHQUFHLENBQUMsT0FBTyxHQUFHLE1BQU0sQ0FLdkQ7QUFFRCx3QkFBZ0IsWUFBWSxDQUFDLEtBQUssRUFBRSxVQUFVLEdBQUcsTUFBTSxDQUl0RDtBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxPQUFPLEVBQUUsT0FBTyx1QkFLMUM7QUFjRDs7R0FFRztBQUNILHFCQUFhLGVBQWdCLFlBQVcsYUFBYTtJQUVqRCxPQUFPLENBQUMsVUFBVTtJQUNsQixPQUFPLENBQUMsZ0JBQWdCO0lBQ3hCLE9BQU8sQ0FBQyxNQUFNO0lBSGhCLFlBQ1UsVUFBVSxHQUFFLE1BQU0sQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFxQixFQUN6RCxnQkFBZ0IsR0FBRSxNQUFrQixFQUNwQyxNQUFNLHlDQUF1QyxFQUNuRDtJQUdKLGdCQUFnQixDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLFVBQVUsR0FBRyxVQUFVLENBRy9EO0lBRU0sb0JBQW9CLENBQUMsSUFBSSxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsRUFBRSxTQUFTLEVBQUUsaUJBQWlCLENBQUMsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVkvRjtJQUdELGlCQUFpQixDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLFVBQVUsR0FBRyxVQUFVLENBRWpFO0lBRU0scUJBQXFCLENBQUMsSUFBSSxFQUFFLE1BQU0sR0FBRyxNQUFNLENBS2pEO0NBQ0Y7QUFFRDs7Ozs7Ozs7Ozs7R0FXRztBQUNILHdCQUFnQixrQkFBa0IsQ0FBQyxJQUFJLEVBQUUsVUFBVSxHQUFHO0lBQUUsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0lBQUMsU0FBUyxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBbUNwRyJ9

package/dest/services/encoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/services/encoding.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAsB,MAAM,mBAAmB,CAAC;AAElE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAajD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAKvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAItD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,uBAK1C;AAYD;;GAEG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAEjD,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,MAAM;IAHhB,YACU,UAAU,GAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAqB,EACzD,gBAAgB,GAAE,MAAkB,EACpC,MAAM,yCAAuC,EACnD;IAGJ,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAG/D;IAEM,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAYnE;IAGD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAEjE;IAEM,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmCpG"}
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/services/encoding.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,SAAS,EAAsB,MAAM,mBAAmB,CAAC;AAElF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAajD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAKvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAItD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,uBAK1C;AAcD;;GAEG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAEjD,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,MAAM;IAHhB,YACU,UAAU,GAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAqB,EACzD,gBAAgB,GAAE,MAAkB,EACpC,MAAM,yCAAuC,EACnD;IAGJ,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAG/D;IAEM,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAY/F;IAGD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAEjE;IAEM,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmCpG"}

package/dest/services/encoding.js

@@ -1,7 +1,7 @@
 // Taken from lodestar: https://github.com/ChainSafe/lodestar
 import { sha256 } from '@aztec/foundation/crypto/sha256';
 import { createLogger } from '@aztec/foundation/log';
-import { TopicType, getTopicFromString } from '@aztec/stdlib/p2p';
+import { MAX_TX_SIZE_KB, TopicType, getTopicFromString } from '@aztec/stdlib/p2p';
 import { compressSync, uncompressSync } from 'snappy';
 import xxhashFactory from 'xxhash-wasm';
 // Load WASM
@@ -41,13 +41,15 @@ export function msgIdToStrFn(msgId) {
     return sha256(Buffer.concat(vec)).subarray(0, 20);
 }
 const DefaultMaxSizesKb = {
-    // Tx effects should not exceed 128kb, so 512kb for the full tx obj should be sufficient
-    [TopicType.tx]: 512,
+    [TopicType.tx]: MAX_TX_SIZE_KB,
     // An attestation has roughly 30 fields, which is 1kb, so 5x is plenty
-    [TopicType.block_attestation]: 5,
+    [TopicType.checkpoint_attestation]: 5,
     // Proposals may carry some tx objects, so we allow a larger size capped at 10mb
     // Note this may not be enough for carrying all tx objects in a block
-    [TopicType.block_proposal]: 1024 * 10
+    [TopicType.block_proposal]: 1024 * 10,
+    // Checkpoint proposals carry almost the same data as a block proposal (see the lastBlockProposal)
+    // Only diff is an additional header, which is pretty small compared to the 10mb limit
+    [TopicType.checkpoint_proposal]: 1024 * 10
 };
 /**
  * Snappy transform for libp2p gossipsub
@@ -65,11 +67,11 @@ const DefaultMaxSizesKb = {
         const topic = getTopicFromString(topicStr);
         return this.inboundTransformData(Buffer.from(data), topic);
     }
-    inboundTransformData(data, topic) {
+    inboundTransformData(data, topic, maxSizeKbOverride) {
         if (data.length === 0) {
             return data;
         }
-        const maxSizeKb = this.maxSizesKb[topic] ?? this.defaultMaxSizeKb;
+        const maxSizeKb = maxSizeKbOverride ?? this.maxSizesKb[topic] ?? this.defaultMaxSizeKb;
         const { decompressedSize } = readSnappyPreamble(data);
         if (decompressedSize > maxSizeKb * 1024) {
             this.logger.warn(`Decompressed size ${decompressedSize} exceeds maximum allowed size of ${maxSizeKb}kb`);

package/dest/services/gossipsub/index.d.ts

@@ -0,0 +1,3 @@
+export * from './scoring.js';
+export * from './topic_score_params.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zZXJ2aWNlcy9nb3NzaXBzdWIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyx5QkFBeUIsQ0FBQyJ9

package/dest/services/gossipsub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/gossipsub/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/dest/services/gossipsub/index.js

@@ -0,0 +1,2 @@
+export * from './scoring.js';
+export * from './topic_score_params.js';

package/dest/services/gossipsub/scoring.d.ts

@@ -1,7 +1,25 @@
 import type { PeerScoreThresholds } from '@chainsafe/libp2p-gossipsub/score';
 /**
- * The following params is implemented by Lighthouse at
- * https://github.com/sigp/lighthouse/blob/b0ac3464ca5fb1e9d75060b56c83bfaf990a3d25/beacon_node/eth2_libp2p/src/behaviour/gossipsub_scoring_parameters.rs#L83
+ * Weight applied to application-level peer scores before contributing to gossipsub score.
+ *
+ * Note: positive topic scores can partially offset app penalties, so alignment with
+ * app-level thresholds is best-effort rather than strict.
+ */
+export declare const APP_SPECIFIC_WEIGHT = 10;
+/**
+ * Gossipsub peer score thresholds aligned with application-level scoring.
+ *
+ * These thresholds work with appSpecificWeight=10 to align gossipsub behavior
+ * with application-level peer states (Healthy → Disconnect → Banned).
+ *
+ * Alignment:
+ * - gossipThreshold (-500): Matches Disconnect state (app score -50 × weight 10)
+ * - publishThreshold (-1000): Matches Ban state (app score -100 × weight 10)
+ * - graylistThreshold (-2000): For severe attacks (ban + topic penalties)
+ *
+ * The 1:2:4 ratio follows Lodestar's approach and gossipsub spec recommendations.
+ *
+ * @see https://github.com/libp2p/specs/blob/master/pubsub/gossipsub/gossipsub-v1.1.md#peer-scoring
  */
 export declare const gossipScoreThresholds: PeerScoreThresholds;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NvcmluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2dvc3NpcHN1Yi9zY29yaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFFN0U7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHFCQUFxQixFQUFFLG1CQU1uQyxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NvcmluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2dvc3NpcHN1Yi9zY29yaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFFN0U7Ozs7O0dBS0c7QUFDSCxlQUFPLE1BQU0sbUJBQW1CLEtBQUssQ0FBQztBQUV0Qzs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILGVBQU8sTUFBTSxxQkFBcUIsRUFBRSxtQkFXbkMsQ0FBQyJ9

package/dest/services/gossipsub/scoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/services/gossipsub/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAMnC,CAAC"}
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/services/gossipsub/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAWnC,CAAC"}

package/dest/services/gossipsub/scoring.js

@@ -1,10 +1,27 @@
 /**
- * The following params is implemented by Lighthouse at
- * https://github.com/sigp/lighthouse/blob/b0ac3464ca5fb1e9d75060b56c83bfaf990a3d25/beacon_node/eth2_libp2p/src/behaviour/gossipsub_scoring_parameters.rs#L83
+ * Weight applied to application-level peer scores before contributing to gossipsub score.
+ *
+ * Note: positive topic scores can partially offset app penalties, so alignment with
+ * app-level thresholds is best-effort rather than strict.
+ */ export const APP_SPECIFIC_WEIGHT = 10;
+/**
+ * Gossipsub peer score thresholds aligned with application-level scoring.
+ *
+ * These thresholds work with appSpecificWeight=10 to align gossipsub behavior
+ * with application-level peer states (Healthy → Disconnect → Banned).
+ *
+ * Alignment:
+ * - gossipThreshold (-500): Matches Disconnect state (app score -50 × weight 10)
+ * - publishThreshold (-1000): Matches Ban state (app score -100 × weight 10)
+ * - graylistThreshold (-2000): For severe attacks (ban + topic penalties)
+ *
+ * The 1:2:4 ratio follows Lodestar's approach and gossipsub spec recommendations.
+ *
+ * @see https://github.com/libp2p/specs/blob/master/pubsub/gossipsub/gossipsub-v1.1.md#peer-scoring
  */ export const gossipScoreThresholds = {
-    gossipThreshold: -4000,
-    publishThreshold: -8000,
-    graylistThreshold: -16000,
-    acceptPXThreshold: 100,
-    opportunisticGraftThreshold: 5
+    /** Below this, peer is not gossiped to (matches Disconnect state) */ gossipThreshold: -500,
+    /** Below this, self-published messages are not propagated to peer (matches Ban state) */ publishThreshold: -1000,
+    /** Below this, all RPCs from peer are ignored (severe attack scenario) */ graylistThreshold: -2000,
+    /** Above this, peer can offer peer exchange (PX) */ acceptPXThreshold: 100,
+    /** Above this, peer can be grafted to mesh opportunistically */ opportunisticGraftThreshold: 5
 };

package/dest/services/gossipsub/topic_score_params.d.ts

@@ -0,0 +1,161 @@
+import { TopicType } from '@aztec/stdlib/p2p';
+import { createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
+/**
+ * Network parameters needed to compute topic-specific gossipsub scoring parameters.
+ */
+export type TopicScoringNetworkParams = {
+    /** L2 slot duration in milliseconds */
+    slotDurationMs: number;
+    /** Gossipsub heartbeat interval in milliseconds */
+    heartbeatIntervalMs: number;
+    /** Target committee size (number of validators expected to attest per slot) */
+    targetCommitteeSize: number;
+    /** Duration per block in milliseconds when building multiple blocks per slot. If undefined, single block mode. */
+    blockDurationMs?: number;
+};
+/**
+ * Calculates the number of blocks per slot based on timing parameters.
+ * Uses the shared calculation from @aztec/stdlib/timetable.
+ *
+ * @param slotDurationMs - L2 slot duration in milliseconds
+ * @param blockDurationMs - Duration per block in milliseconds (undefined = single block mode)
+ * @returns Number of blocks per slot
+ */
+export declare function calculateBlocksPerSlot(slotDurationMs: number, blockDurationMs: number | undefined): number;
+/**
+ * Determines the decay window in slots based on expected message frequency.
+ * Low-frequency topics need longer decay windows to accumulate meaningful counter values.
+ *
+ * @param expectedMessagesPerSlot - Expected messages per slot for this topic
+ * @returns Number of slots over which the counter should decay to ~1%
+ */
+export declare function getDecayWindowSlots(expectedMessagesPerSlot: number): number;
+/**
+ * Computes the decay factor for exponential decay over a given window.
+ * After `heartbeatsInWindow` heartbeats, the counter decays to ~1% of its original value.
+ *
+ * @param heartbeatIntervalMs - Gossipsub heartbeat interval in milliseconds
+ * @param slotDurationMs - L2 slot duration in milliseconds
+ * @param decayWindowSlots - Number of slots over which to decay
+ * @returns Decay factor (0 < decay < 1), applied each heartbeat
+ */
+export declare function computeDecay(heartbeatIntervalMs: number, slotDurationMs: number, decayWindowSlots: number): number;
+/**
+ * Computes the steady-state convergence value for a decaying counter.
+ * If messages arrive at a constant rate and decay is applied each heartbeat,
+ * the counter converges to: rate / (1 - decay)
+ *
+ * @param messagesPerHeartbeat - Expected messages per heartbeat
+ * @param decay - Decay factor applied each heartbeat
+ * @returns Convergence value (steady-state counter value)
+ */
+export declare function computeConvergence(messagesPerHeartbeat: number, decay: number): number;
+/**
+ * Computes a conservative threshold for mesh message deliveries.
+ * The threshold should be low enough to avoid penalizing honest peers with normal variance.
+ *
+ * @param convergence - Steady-state counter value
+ * @param conservativeFactor - Fraction of convergence to use as threshold (e.g., 0.3)
+ * @returns Threshold value
+ */
+export declare function computeThreshold(convergence: number, conservativeFactor: number): number;
+/**
+ * Gets the expected messages per slot for a given topic type.
+ *
+ * @param topicType - The topic type
+ * @param targetCommitteeSize - Target committee size
+ * @param blocksPerSlot - Number of blocks per slot
+ * @returns Expected messages per slot, or undefined if unpredictable
+ */
+export declare function getExpectedMessagesPerSlot(topicType: TopicType, targetCommitteeSize: number, blocksPerSlot: number): number | undefined;
+/** Maximum P1 score contribution per topic */
+export declare const MAX_P1_SCORE = 8;
+/** Maximum P2 score contribution per topic */
+export declare const MAX_P2_SCORE = 25;
+/** Maximum P3 penalty per topic (must exceed P1 + P2 to cause pruning) */
+export declare const MAX_P3_PENALTY_PER_TOPIC: number;
+/** Number of topics with P3 enabled in MBPS mode (block_proposal + checkpoint_proposal + checkpoint_attestation) */
+export declare const NUM_P3_ENABLED_TOPICS = 3;
+/** Total maximum P3b penalty across all topics after pruning in MBPS mode */
+export declare const TOTAL_MAX_P3B_PENALTY: number;
+/**
+ * Factory class for creating gossipsub topic scoring parameters.
+ * Computes shared values once and reuses them across all topics.
+ */
+export declare class TopicScoreParamsFactory {
+    private readonly params;
+    /** Number of blocks per slot based on timetable configuration */
+    readonly blocksPerSlot: number;
+    /** Decay factor for invalid message penalties (P4) */
+    readonly invalidDecay: number;
+    /** Number of heartbeats per slot */
+    readonly heartbeatsPerSlot: number;
+    /** P1: Time in mesh quantum (slot duration in ms - score increases by ~1 per slot) */
+    readonly timeInMeshQuantum: number;
+    /** P1: Time in mesh cap (number of slots to reach max score) */
+    readonly timeInMeshCap: number;
+    /** P1: Time in mesh weight (normalized so max P1 = MAX_P1_SCORE) */
+    readonly timeInMeshWeight: number;
+    /** P2: First message deliveries decay factor */
+    readonly firstMessageDeliveriesDecay: number;
+    /** P2: First message deliveries cap (convergence-based) */
+    readonly firstMessageDeliveriesCap: number;
+    /** P2: First message deliveries weight (normalized so max P2 = MAX_P2_SCORE) */
+    readonly firstMessageDeliveriesWeight: number;
+    /** Base parameters common to all topics */
+    private readonly baseParams;
+    constructor(params: TopicScoringNetworkParams);
+    /**
+     * Creates scoring parameters for topics with unpredictable or zero message rates.
+     * Disables P1, P2, P3, and P3b to avoid unbalanced positive score accumulation.
+     *
+     * Rationale: If P1/P2 were enabled without P3, the topic would contribute free
+     * positive scores that could offset penalties from other topics, preventing
+     * proper mesh pruning of non-contributing peers.
+     */
+    private createDisabledP3Params;
+    /**
+     * Creates scoring parameters for topics with predictable message rates.
+     * Enables P1, P2, P3, and P3b for balanced scoring.
+     *
+     * The scoring is designed so that:
+     * - P1 + P2 max = 8 + 25 = 33 (positive rewards for good behavior)
+     * - P3 max = -34 (penalty exceeds P1+P2 to ensure pruning of non-contributors)
+     * - After pruning: P1 resets, P2 decays, P3b persists with slow decay
+     *
+     * @param expectedPerSlot - Expected messages per slot
+     */
+    private createEnabledP3Params;
+    /**
+     * Creates topic score parameters for a specific topic type.
+     *
+     * @param topicType - The topic type
+     * @returns TopicScoreParams for the topic
+     */
+    createForTopic(topicType: TopicType): ReturnType<typeof createTopicScoreParams>;
+    /**
+     * Creates all topic score parameters for gossipsub configuration.
+     *
+     * @param protocolVersion - Protocol version string for topic naming
+     * @returns Record mapping topic strings to their score parameters
+     */
+    createAll(protocolVersion: string): Record<string, ReturnType<typeof createTopicScoreParams>>;
+}
+/**
+ * Creates topic score parameters for a specific topic type.
+ * Convenience function that creates a factory internally.
+ *
+ * @param topicType - The topic type
+ * @param params - Network parameters for scoring calculation
+ * @returns TopicScoreParams for the topic
+ */
+export declare function createTopicScoreParamsForTopic(topicType: TopicType, params: TopicScoringNetworkParams): ReturnType<typeof createTopicScoreParams>;
+/**
+ * Creates all topic score parameters for gossipsub configuration.
+ *
+ * @param protocolVersion - Protocol version string for topic naming
+ * @param params - Network parameters for scoring calculation
+ * @returns Record mapping topic strings to their score parameters
+ */
+export declare function createAllTopicScoreParams(protocolVersion: string, params: TopicScoringNetworkParams): Record<string, ReturnType<typeof createTopicScoreParams>>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9waWNfc2NvcmVfcGFyYW1zLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2VydmljZXMvZ29zc2lwc3ViL3RvcGljX3Njb3JlX3BhcmFtcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsU0FBUyxFQUFxQixNQUFNLG1CQUFtQixDQUFDO0FBR2pFLE9BQU8sRUFBRSxzQkFBc0IsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBRTNFOztHQUVHO0FBQ0gsTUFBTSxNQUFNLHlCQUF5QixHQUFHO0lBQ3RDLHVDQUF1QztJQUN2QyxjQUFjLEVBQUUsTUFBTSxDQUFDO0lBQ3ZCLG1EQUFtRDtJQUNuRCxtQkFBbUIsRUFBRSxNQUFNLENBQUM7SUFDNUIsK0VBQStFO0lBQy9FLG1CQUFtQixFQUFFLE1BQU0sQ0FBQztJQUM1QixrSEFBa0g7SUFDbEgsZUFBZSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQzFCLENBQUM7QUFFRjs7Ozs7OztHQU9HO0FBQ0gsd0JBQWdCLHNCQUFzQixDQUFDLGNBQWMsRUFBRSxNQUFNLEVBQUUsZUFBZSxFQUFFLE1BQU0sR0FBRyxTQUFTLEdBQUcsTUFBTSxDQUUxRztBQUVEOzs7Ozs7R0FNRztBQUNILHdCQUFnQixtQkFBbUIsQ0FBQyx1QkFBdUIsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVEzRTtBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQWdCLFlBQVksQ0FBQyxtQkFBbUIsRUFBRSxNQUFNLEVBQUUsY0FBYyxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQU9sSDtBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQWdCLGtCQUFrQixDQUFDLG9CQUFvQixFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FFdEY7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLFdBQVcsRUFBRSxNQUFNLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FFeEY7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsd0JBQWdCLDBCQUEwQixDQUN4QyxTQUFTLEVBQUUsU0FBUyxFQUNwQixtQkFBbUIsRUFBRSxNQUFNLEVBQzNCLGFBQWEsRUFBRSxNQUFNLEdBQ3BCLE1BQU0sR0FBRyxTQUFTLENBc0JwQjtBQWtDRCw4Q0FBOEM7QUFDOUMsZUFBTyxNQUFNLFlBQVksSUFBSSxDQUFDO0FBZTlCLDhDQUE4QztBQUM5QyxlQUFPLE1BQU0sWUFBWSxLQUFLLENBQUM7QUEwQi9CLDBFQUEwRTtBQUMxRSxlQUFPLE1BQU0sd0JBQXdCLFFBQXFDLENBQUM7QUFFM0Usb0hBQW9IO0FBQ3BILGVBQU8sTUFBTSxxQkFBcUIsSUFBSSxDQUFDO0FBRXZDLDZFQUE2RTtBQUM3RSxlQUFPLE1BQU0scUJBQXFCLFFBQW1ELENBQUM7QUFFdEY7OztHQUdHO0FBQ0gscUJBQWEsdUJBQXVCO0lBMkN0QixPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU07SUExQ25DLGlFQUFpRTtJQUNqRSxTQUFnQixhQUFhLEVBQUUsTUFBTSxDQUFDO0lBRXRDLHNEQUFzRDtJQUN0RCxTQUFnQixZQUFZLEVBQUUsTUFBTSxDQUFDO0lBRXJDLG9DQUFvQztJQUNwQyxTQUFnQixpQkFBaUIsRUFBRSxNQUFNLENBQUM7SUFFMUMsc0ZBQXNGO0lBQ3RGLFNBQWdCLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUUxQyxnRUFBZ0U7SUFDaEUsU0FBZ0IsYUFBYSxFQUFFLE1BQU0sQ0FBQztJQUV0QyxvRUFBb0U7SUFDcEUsU0FBZ0IsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0lBRXpDLGdEQUFnRDtJQUNoRCxTQUFnQiwyQkFBMkIsRUFBRSxNQUFNLENBQUM7SUFFcEQsMkRBQTJEO0lBQzNELFNBQWdCLHlCQUF5QixFQUFFLE1BQU0sQ0FBQztJQUVsRCxnRkFBZ0Y7SUFDaEYsU0FBZ0IsNEJBQTRCLEVBQUUsTUFBTSxDQUFDO0lBRXJELDJDQUEyQztJQUMzQyxPQUFPLENBQUMsUUFBUSxDQUFDLFVBQVUsQ0FZekI7SUFFRixZQUE2QixNQUFNLEVBQUUseUJBQXlCLEVBd0M3RDtJQUVEOzs7Ozs7O09BT0c7SUFDSCxPQUFPLENBQUMsc0JBQXNCO0lBMkI5Qjs7Ozs7Ozs7OztPQVVHO0lBQ0gsT0FBTyxDQUFDLHFCQUFxQjtJQXdDN0I7Ozs7O09BS0c7SUFDSCxjQUFjLENBQUMsU0FBUyxFQUFFLFNBQVMsR0FBRyxVQUFVLENBQUMsT0FBTyxzQkFBc0IsQ0FBQyxDQVM5RTtJQUVEOzs7OztPQUtHO0lBQ0gsU0FBUyxDQUFDLGVBQWUsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUFDLE1BQU0sRUFBRSxVQUFVLENBQUMsT0FBTyxzQkFBc0IsQ0FBQyxDQUFDLENBUzVGO0NBQ0Y7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsd0JBQWdCLDhCQUE4QixDQUM1QyxTQUFTLEVBQUUsU0FBUyxFQUNwQixNQUFNLEVBQUUseUJBQXlCLEdBQ2hDLFVBQVUsQ0FBQyxPQUFPLHNCQUFzQixDQUFDLENBRzNDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQWdCLHlCQUF5QixDQUN2QyxlQUFlLEVBQUUsTUFBTSxFQUN2QixNQUFNLEVBQUUseUJBQXlCLEdBQ2hDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsVUFBVSxDQUFDLE9BQU8sc0JBQXNCLENBQUMsQ0FBQyxDQUczRCJ9

package/dest/services/gossipsub/topic_score_params.d.ts.map

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