Skip to content

Commit a6a121d

Browse files
authored
Update ADR status (#1637)
These should reflect the current state of affairs on the hydra-node implementation.
1 parent 40a18b7 commit a6a121d

10 files changed

+25
-21
lines changed

docs/adr/2022-03-17_015-admin-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 15
33
title: |
44
15. Configuration Through an Admin API
55
authors: []
6-
tags: [Draft]
6+
tags: [Proposed]
77
---
88

99
## Status
1010

11-
Draft
11+
Proposed
1212

1313
## Context
1414

docs/adr/2022-03-28_017-udp-networking.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 17
33
title: |
44
17. Use UDP protocol for Hydra networking
55
authors: []
6-
tags: [Draft]
6+
tags: [Proposed]
77
---
88

99
## Status
1010

11-
Draft
11+
Proposed
1212

1313
## Context
1414

docs/adr/2022-07-22_019-reference-scripts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 19
33
title: |
44
19. Use of reference scripts
55
authors: []
6-
tags: [Proposed]
6+
tags: [Accepted]
77
---
88

99
## Status
1010

11-
Proposed
11+
Accepted
1212

1313
## Context
1414

docs/adr/2022-12-05_021-Bounded-transaction-validity-on-Hydra-protocol-transactions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ tags: [Accepted]
88

99
## Status
1010

11-
Proposed
11+
Accepted
1212

1313
## Context
1414

docs/adr/2022-12-06_022-model-based-testing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Accepted
3232
- We need to ensure the Model covers the full lifecycle of a Hydra Head network which at the time of writing this ADR is not the case
3333
- There cannot be _One Model to Rule Them All_ so we should refrain from defining different `StateModel` or different `RunModel` depending on what needs to be tested
3434
- In particular, testing against adversarial conditions will certainly require defining different instances of the `Network` or `Chain` components, for example:
35-
- An _Active Adversary_ that fully the controls the protocol and the parties,
35+
- An _Accepted Adversary_ that fully the controls the protocol and the parties,
3636
- A _Network Adversary_ that can delay and or drop messages,
3737
- A _Faulty Filesystem_ that can causes exceptions when reading or writing files,
3838
- ...

docs/adr/2023-08-18_025-resource-based-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 25
33
title: |
44
25. Event-sourced, resource-based API
55
authors: []
6-
tags: [Draft]
6+
tags: [Proposed]
77
---
88

99
## Status
1010

11-
Draft
11+
Proposed
1212

1313
## Context
1414

docs/adr/2023-09-08_026-stateless-observation-construction.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
slug: 26
33
title: |
4-
26. Stateless transaction observaion & construction
5-
authors: []
6-
tags: [Draft]
4+
26. Stateless transaction observation & construction
5+
authors: [ch1bo]
6+
tags: [Proposed]
77
---
88

99
## Status
1010

11-
Draft
11+
Proposed
1212

1313
## Context
1414

docs/adr/2023-09-09_027-network-resilience.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 27
33
title: |
44
27. Network failures model
55
authors: [abailly, pgrange]
6-
tags: [Proposed]
6+
tags: [Accepted]
77
---
88

99
## Status
1010

11-
Draft
11+
Accepted
1212

1313
## Context
1414

docs/adr/2023-10-16_028_offline_adr.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,23 @@ slug: 28
33
title: |
44
28. Offline mode
55
authors: [cardenaso11]
6-
tags: []
6+
tags: [Accepted]
77
---
8+
89
## Status
9-
Proposed
10+
11+
Accepted
1012

1113
## Context
14+
1215
Currently, the Hydra node requires a Layer 1 Cardano node running in order to operate; The L1 node is needed to submit and watch for L1 transactions. Generally speaking, the transactions watched are for learning the state of the Hydra node, as reflected by the L1 chain. The transactions submitted are to transition between states (e.g. after submitting a Commit tx to the L1, a node watches to see when all other nodes have also Committed.)
1316

1417
There are applications for the Hydra node where interaction with an L1 chain is unnecessary. Offline mode will be a key component of the Gummiworm protocol, a Layer 2 protocol being built by Sundae Labs, which enables actors other than Hydra head participants to validate transactions that occur in the head.
1518

1619
The Hydra node offline mode would remove the dependency on the L1 Cardano node, for applications like Gummiworm where it is unneeded. It would also remove the dependency on the L1 Cardano node for peer-to-peer Hydra node communication. This would be useful for other Layer 2s that build on top of Hydra instead of duplicating its efforts, and for anyone who wants to easily validate a set of Cardano transactions.
20+
1721
## Decision
22+
1823
Hydra node will be executable in offline mode, as an alternative to the default online mode. When online, the Hydra node depends on querying a Cardano node for Era History information and Genesis parameters. When offline this is not necessary, because the Hydra node will not connect to any Layer 1 .
1924

2025
The initial state of the head will be specified in a flag, which makes any Commit redundant. The flag will specify a file for the starting Layer 2 UTXO. The Hydra node can be configured to write the current UTXO into a file, including the starting UTXO file.
@@ -25,7 +30,6 @@ Commit endpoint will return 400 instead of building a transaction, in offline mo
2530

2631
Support for peer Hydra nodes in offline mode is considered out of scope, as it doesn't seem immediately useful. A node running in offline mode will not be configurable with any peer nodes, nor will it make a network connection to any peer nodes.
2732

28-
2933
## Consequences
3034

3135
The Hydra node would be usable offline, for transaction validation, and other custom L2 applications. The lifecycle & state machine associated with a Hydra would remain unchanged in both online, and offline mode.

docs/adr/2023-12-06_029-use-cbor-for-tx.md renamed to docs/adr/2023-12-06_030-use-cbor-for-tx.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ slug: 30
33
title: |
44
30. Use CBOR in external representation of Cardano transactions
55
authors: [abailly]
6-
tags: [Proposed]
6+
tags: [Accepted]
77
---
88

99
## Status
1010

11-
Proposed
11+
Accepted
1212

1313
## Context
1414

0 commit comments

Comments
 (0)