sim-rs: update configuration docs

Author: SupernaviX

data/simulation/config.d.ts

@@ -248,6 +248,11 @@ export interface Config {
    * where nodes deliberately withhold EBs until near the end of the voting phase.
    */
   "late-eb-attack"?: LateEBAttackConfig | null;
+  /**
+   * Configuration for a "late TX" attack,
+   * where EB producers create TXs which they do not disseminate until also disseminating the EB.
+   */
+  "late-tx-attack"?: LateTXAttackConfig | null;
 }
 
 export type CleanupPolicies = "all" | CleanupPolicy[];
@@ -327,7 +332,25 @@ export enum MempoolSamplingStrategy {
  */
 export interface LateEBAttackConfig {
   /** The set of stake pools which are participating in the attack. */
-  "attacker-nodes": string[],
+  "attackers": NodeSelection,
   /** How long the attackers will wait before diffusing their EBs */
   "propagation-delay-ms": number,
+}
+
+/**
+ * Configuration for a "late TX" attack,
+ * where EB producers create TXs which they do not disseminate until also disseminating the EB.
+ */
+export interface LateTXAttackConfig {
+  /** The set of stake pools which are participating in the attack. */
+  attackers: NodeSelection,
+  /** How often does one of these nodes perform this attack when they get the chance? */
+  "attack-probability": number,
+  /** How many transactions are generated as part of the attack? */
+  "tx-generation-distribution": Distribution,
+}
+
+export type NodeSelection = NodesNodeSelection;
+export interface NodesNodeSelection {
+  "nodes": string[];
 }

data/simulation/config.schema.json

@@ -75,12 +75,9 @@
     "LateEBAttackConfig": {
       "description": "Configuration for a \"late EB\" attack,\nwhere nodes deliberately withhold EBs until near the end of the voting phase.",
       "properties": {
-        "attacker-nodes": {
-          "description": "The set of stake pools which are participating in the attack.",
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
+        "attackers": {
+          "$ref": "#/definitions/NodesNodeSelection",
+          "description": "The set of stake pools which are participating in the attack."
         },
         "propagation-delay-ms": {
           "description": "How long the attackers will wait before diffusing their EBs",
@@ -89,6 +86,24 @@
       },
       "type": "object"
     },
+    "LateTXAttackConfig": {
+      "description": "Configuration for a \"late TX\" attack,\nwhere EB producers create TXs which they do not disseminate until also disseminating the EB.",
+      "properties": {
+        "attack-probability": {
+          "description": "How often does one of these nodes perform this attack when they get the chance?",
+          "type": "number"
+        },
+        "attackers": {
+          "$ref": "#/definitions/NodesNodeSelection",
+          "description": "The set of stake pools which are participating in the attack."
+        },
+        "tx-generation-distribution": {
+          "$ref": "#/definitions/Distribution",
+          "description": "How many transactions are generated as part of the attack?"
+        }
+      },
+      "type": "object"
+    },
     "LeiosVariant": {
       "enum": [
         "short",
@@ -119,6 +134,17 @@
       "enum": ["ordered-by-id", "random"],
       "type": "string"
     },
+    "NodesNodeSelection": {
+      "properties": {
+        "nodes": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "NormalDistribution": {
       "properties": {
         "distribution": {
@@ -311,6 +337,10 @@
       "$ref": "#/definitions/LateEBAttackConfig",
       "description": "Configuration for a \"late EB\" attack,\nwhere nodes deliberately withhold EBs until near the end of the voting phase."
     },
+    "late-tx-attack": {
+      "$ref": "#/definitions/LateTXAttackConfig",
+      "description": "Configuration for a \"late TX\" attack,\nwhere EB producers create TXs which they do not disseminate until also disseminating the EB."
+    },
     "leios-header-diffusion-time-ms": {
       "description": "The expected time it takes a header to fully diffuse across the network.\nThis is Δhdr from the Leios paper.",
       "type": "number"