Another round of documentation design/content amends

[fstoqnov-iohk]

Last bit of design and content updates (minor padding/centring and the discord link pointing to the correct discord invite)

I have also added the following scripts to the package.json

"preview-build": "docusaurus build",
"preview-install": "docusaurus install"

These are for more easily running vercel deploys manually (as the vercel has issues running the prepare script) - note that to deploy and preview it successfully you'd still need to update the config to warn for broken links and the update landing page to / as of right now (due to vercel/docusaurus limitations)

Let me know if you're happy with this last bit of want me to remove the extra scripts

[github-actions[bot]]

Transaction costs

Sizes and execution budgets for Hydra protocol transactions. Note that unlisted parameters are currently using arbitrary values and results are not fully deterministic and comparable to previous runs.

Metadata
Generated at	2024-08-14 13:42:20.061562838 UTC
Max. memory units	14000000
Max. CPU units	10000000000
Max. tx size (kB)	16384

Script summary

Name	Hash	Size (Bytes)
νInitial	2fac819a1f4f14e29639d1414220d2a18b6abd6b8e444d88d0dda8ff	3799
νCommit	2043a9f1a685bcf491413a5f139ee42e335157c8c6bc8d9e4018669d	1743
νHead	bd9fad235c871fb7f837c767593018a84be3083ff80f9dab5f1c55f9	10194
μHead	c8038945816586c4d38926ee63bba67821eb863794220ebbd0bf79ee*	4607

• The minting policy hash is only usable for comparison. As the script is parameterized, the actual script is unique per head.

  Init transaction costs

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	5193	5.61	2.21	0.44
2	5390	6.99	2.76	0.46
3	5591	8.37	3.30	0.49
5	5994	11.45	4.53	0.54
10	6998	18.30	7.24	0.66
56	16247	81.43	32.21	1.76

Commit transaction costs

This uses ada-only outputs for better comparability.

UTxO	Tx size	% max Mem	% max CPU	Min fee ₳
1	559	10.52	4.15	0.29
2	748	13.86	5.65	0.34
3	934	17.33	7.20	0.38
5	1309	24.65	10.44	0.48
10	2248	45.22	19.36	0.75
20	4114	95.99	40.76	1.40

CollectCom transaction costs

Parties	UTxO (bytes)	Tx size	% max Mem	% max CPU	Min fee ₳
1	57	549	21.46	8.41	0.41
2	113	659	32.95	13.05	0.54
3	170	769	44.26	17.76	0.67
4	226	879	60.45	24.38	0.85
5	284	989	73.88	30.09	1.01
6	339	1100	94.35	38.51	1.24

Cost of Decrement Transaction

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	627	17.93	7.87	0.38
2	773	19.11	9.07	0.40
3	923	19.97	10.07	0.42
5	1241	23.45	12.87	0.49
10	2172	36.73	21.68	0.70
49	7779	96.84	73.55	1.81

Close transaction costs

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	668	21.02	9.42	0.42
2	790	22.41	10.79	0.44
3	916	23.88	12.19	0.47
5	1259	27.16	15.32	0.54
10	2024	35.53	23.25	0.69
50	8040	98.99	83.86	1.91

Contest transaction costs

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	627	26.76	11.34	0.48
2	758	28.48	12.83	0.51
3	1008	31.10	15.04	0.55
5	1199	34.15	17.67	0.61
10	2143	45.20	27.14	0.81
39	6467	99.21	73.76	1.77

Abort transaction costs

There is some variation due to the random mixture of initial and already committed outputs.

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	5069	17.51	7.61	0.57
2	5133	27.48	11.97	0.68
3	5393	42.65	18.89	0.87
4	5362	55.99	24.67	1.02
5	5536	74.04	32.84	1.23
6	5797	93.35	41.58	1.46

FanOut transaction costs

Involves spending head output and burning head tokens. Uses ada-only UTxO for better comparability.

Parties	UTxO	UTxO (bytes)	Tx size	% max Mem	% max CPU	Min fee ₳
5	0	0	5022	7.75	3.28	0.46
5	1	56	5055	8.88	3.99	0.47
5	5	283	5190	13.41	6.84	0.54
5	10	569	5361	19.06	10.39	0.62
5	20	1138	5700	30.19	17.43	0.77
5	30	1707	6041	41.90	24.72	0.93
5	40	2275	6379	52.64	31.59	1.08
5	50	2845	6719	64.17	38.80	1.24
5	81	4608	7770	99.53	61.01	1.74

End-to-end benchmark results

This page is intended to collect the latest end-to-end benchmark results produced by Hydra's continuous integration (CI) system from the latest master code.

Please note that these results are approximate as they are currently produced from limited cloud VMs and not controlled hardware. Rather than focusing on the absolute results, the emphasis should be on relative results, such as how the timings for a scenario evolve as the code changes.

Generated at 2024-08-14 13:44:56.357478223 UTC

Baseline Scenario

Number of nodes	1
Number of txs	3000
Avg. Confirmation Time (ms)	5.870141812
P99	10.086171239999997ms
P95	8.175055249999998ms
P50	5.5677035ms
Number of Invalid txs	0

Three local nodes

Number of nodes	3
Number of txs	9000
Avg. Confirmation Time (ms)	24.099866046
P99	50.50201812000005ms
P95	33.31768769999997ms
P50	22.0858345ms
Number of Invalid txs	0

[github-actions[bot]]

Test Results

467 tests  ±0   460 :white_check_mark: ±0   16m 55s :stopwatch: - 1m 7s 148 suites ±0     7 :zzz: ±0    5 files   ±0     0 :x: ±0 

Results for commit adaebd8d. ± Comparison against base commit 30148ce5.