Skip to content

Commit

Permalink
Update known issues
Browse files Browse the repository at this point in the history
  • Loading branch information
v0d1ch committed Mar 29, 2023
1 parent dc4563e commit 33c9a67
Showing 1 changed file with 8 additions and 23 deletions.
31 changes: 8 additions & 23 deletions docs/docs/getting-started/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,35 +4,20 @@

### hydra-node

- Hydra node crashes after a fork

+ It ocurs during a fork and expects the operator to restart its hydra-node.

+ Reference: [issue #560](https://github.com/input-output-hk/hydra/issues/560) Hydra node crashed after a fork.

+ Workaround: Restarting your node should be enough to come back to live.

- The current transaction size has a limit of ~16KB. This causes the following inconveniences:

+ The protocol can only handle a maximum number of participants by Head. See [cost of collectcom transaction](https://hydra.family/head-protocol/benchmarks/transaction-cost/#cost-of-collectcom-transaction) or the `hydra-node` will inform you of the current configured maximum when trying to configure too many peers.

+ Only one or no utxo can be committed by each party to a Head.

+ The head cannot be finalized if holding more than ~100 assets. See [cost of fanout transaction](https://hydra.family/head-protocol/benchmarks/transaction-cost/#cost-of-fanout-transaction) for latest numbers.

- Comitting a `UTxO` with a `ReferenceScript` will make the head not finalizable.
- The protocol can only handle a maximum number of participants by Head. See [cost of collectcom transaction](https://hydra.family/head-protocol/benchmarks/transaction-cost/#cost-of-collectcom-transaction) or the `hydra-node` will inform you of the current configured maximum when trying to configure too many peers.

+ The `hydra-node` does prevent this from happening, but transactions in the
Head protocol done by other implementations may result in the Head be not
finalizable by `hydra-node`.
- Only one or no utxo can be committed by each party to a Head.

+ Creating output with reference scripts on the layer 2 ledger is
non-problematic.
- The head cannot be finalized if holding more than ~100 assets. See [cost of fanout transaction](https://hydra.family/head-protocol/benchmarks/transaction-cost/#cost-of-fanout-transaction) for latest numbers.

+ If you run into this, file an issue and the Hydra team will be able to help
you finalize your head in a manual workaround.
- There are couple of ideas around reducing the risk of loosing funds in a Hydra Head:
- [Always abortable Head](https://github.com/input-output-hk/hydra/issues/699)
- [Limit size/complexity of UTxOs in the Head](https://github.com/input-output-hk/hydra/issues/698)
- [Only sign closable snapshots](https://github.com/input-output-hk/hydra/issues/370)

- Not an issue, but a workaround: The internal wallet of `hydra-node` requires a UTXO to be marked as "fuel" to drive the Hydra protocol transactions. See [user manual](https://hydra.family/head-protocol/docs/getting-started/demo/with-docker/#seeding-the-network).
* Not an issue, but a workaround: The internal wallet of `hydra-node` requires a UTXO to be marked as "fuel" to drive the Hydra protocol transactions. See [user manual](https://hydra.family/head-protocol/docs/getting-started/demo/with-docker/#seeding-the-network).

### hydra-tui

Expand Down

0 comments on commit 33c9a67

Please sign in to comment.