add process-compose demo

[disassembler]

Adds nix run .#demo to start the demo cluster locally with one command

• fixes prepare and seed scripts to work both with and without docker

---

• CHANGELOG updated or not needed
• Documentation updated or not needed
• Haddocks updated or not needed
• No new TODOs introduced or explained herafter

[github-actions]

Transactions 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-07-19 07:59:57.417473683 UTC
Max. memory units	14000000
Max. CPU units	10000000000
Max. tx size (kB)	16384

Script summary

Name	Hash	Size (Bytes)
νInitial	e6685648e63ab510b49d2ce632c570d2ef53f44f3cbdf82ed553906c	4081
νCommit	fce3b967fb72f4a3be8dfa30defe413258ff453e5d32d6752d83f9cf	2060
νHead	10a116037de398d6b0721152336d602f0ea653eb3dfe540d5da63fe4	9367
μHead	4f93fdfeda690e005d3f5a180208edd3f65ddd0892466ad7f4dd678b*	4236

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

Cost of Init Transaction

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	4818	5.79	2.29	0.43
2	5018	7.17	2.84	0.45
3	5223	8.46	3.34	0.47
5	5623	11.22	4.43	0.52
10	6627	18.20	7.20	0.64
58	16277	84.19	33.30	1.79

Cost of Commit Transaction

This is using ada-only outputs for better comparability.

UTxO	Tx size	% max Mem	% max CPU	Min fee ₳
1	559	9.25	3.68	0.28
2	748	11.94	4.93	0.32
3	931	14.70	6.20	0.35
5	1307	20.44	8.83	0.44
10	2251	36.05	15.86	0.65
26	5240	98.14	42.75	1.48

Cost of CollectCom Transaction

Parties	UTxO (bytes)	Tx size	% max Mem	% max CPU	Min fee ₳
1	57	544	14.36	5.77	0.33
2	113	654	22.94	9.31	0.43
3	169	764	31.88	13.10	0.54
4	225	874	43.08	17.84	0.67
5	282	984	56.38	23.45	0.82
6	336	1095	70.98	29.69	0.99
7	397	1209	87.97	36.89	1.18

Cost of Close Transaction

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	549	7.77	3.74	0.26
2	772	9.16	5.91	0.30
3	919	9.82	6.97	0.32
5	797	9.69	4.84	0.30
10	1917	14.96	14.67	0.46
50	8009	48.06	62.05	1.34

Cost of Contest Transaction

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	612	8.35	4.63	0.28
2	820	9.50	6.06	0.31
3	894	9.85	6.79	0.32
5	1227	11.51	9.21	0.36
10	1937	15.90	15.10	0.47
50	8020	51.25	63.31	1.37

Cost of Abort Transaction

Some variation because of random mixture of still initial and already committed outputs.

Parties	Tx size	% max Mem	% max CPU	Min fee ₳
1	4680	16.56	7.22	0.54
2	4863	28.00	12.37	0.68
3	4921	37.36	16.40	0.79
4	5090	56.13	24.87	1.01
5	5234	71.19	31.48	1.18
6	5510	99.94	44.45	1.52

Cost of FanOut Transaction

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	4650	7.63	3.20	0.44
5	1	57	4684	8.94	3.99	0.46
5	5	285	4821	13.22	6.71	0.52
5	10	569	4989	18.41	10.05	0.59
5	20	1136	5327	30.38	17.41	0.76
5	30	1706	5668	41.37	24.35	0.91
5	40	2278	6010	52.36	31.29	1.06
5	50	2846	6349	63.37	38.24	1.22
5	82	4668	7435	99.71	60.97	1.72

End-To-End Benchmark Results

This page is intended to collect the latest end-to-end benchmarks results produced by Hydra's Continuous Integration system from the latest master code.

Please take those results with a grain of salt as they are currently produced from very limited cloud VMs and not controlled hardware. Instead of focusing on the absolute results, the emphasis should be on relative results, eg. how the timings for a scenario evolve as the code changes.

Generated at 2024-07-19 08:02:13.126703701 UTC

Baseline Scenario

Number of nodes	1
Number of txs	3000
Avg. Confirmation Time (ms)	4.547615357
P99	8.455142569999959ms
P95	5.485101649999999ms
P50	4.106649ms
Number of Invalid txs	0

Three local nodes

Number of nodes	3
Number of txs	9000
Avg. Confirmation Time (ms)	21.370660790
P99	53.06538340000005ms
P95	29.33757754999999ms
P50	19.3156905ms
Number of Invalid txs	0

[github-actions]

Test Results

437 tests  ±0   425 ✅ ±0   15m 10s ⏱️ -16s
143 suites ±0    12 💤 ±0 
  5 files   ±0     0 ❌ ±0 

Results for commit a7d189f. ± Comparison against base commit 209de1d.

♻️ This comment has been updated with latest results.

[noonio]

This is a great idea!

I note that at present if I just run it the nodes don't startup with the following error:

[v0d1ch]

@noonio I saw the same error you pasted above but all of the sudden everything works for me again. Can you retry? I suspect the file permissions on cardano keys were off.

[v0d1ch]

Thanks @disassembler !

[noonio]

Agree; it works for me now too!