Skip to content

Commit cebf3bb

Browse files
committed
docs: simulation-driven testing
1 parent 877017e commit cebf3bb

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

docs/protocol-testing.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Protocol Testing
2+
3+
## Introduction
4+
5+
This document collects objectives & questions around the protocol and effects of
6+
changing the configuration parameters.
7+
8+
### Objectives
9+
10+
- Find optimal parameters for the protocol
11+
- Find correlations between parameters
12+
13+
### Red Flags
14+
15+
In all considerable cases, we want the protocol to be stable and **degrade
16+
gracefully**. If we observe the simulations abruptly diverge from expected
17+
behavior, it is a red flag.
18+
19+
## Questions
20+
21+
- Are smaller-sized, more frequent IBs better or worse than larger-sized, less
22+
frequent IBs?
23+
24+
## Test Cases
25+
26+
| No. | Description | Parameter(s) |
27+
| --- | ---------------------------- | -------------------------------------------------------------------------------- |
28+
| 1 | Impact of increasing IB size | `ib-body-max-size-bytes`, `ib-body-avg-size-bytes`, `tx-size-bytes-distribution` |
29+
| 2 | Vary IB production rate | `ib-generation-probability` |

0 commit comments

Comments
 (0)