You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/website/versioned_docs/version-maintained/glossary.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ Below is a comprehensive list of definitions for some common terms used in the M
8
8
9
9
## Beacon
10
10
11
-
A beacon represents a point of the blockchain for which a [Mithril certificate](#certificate) is created. It embeds at least the version of the [Cardano network](#cardano-network) that is targeted, the associated [epoch](#epoch), and the [immutable file number](#immutable-file-number).
11
+
A beacon represents a point of the blockchain for which a [Mithril certificate](#certificate) is created. It embeds the [epoch](#epoch) of the [Cardano network](#cardano-network) that is targeted, and either the block number or the [immutable file number](#immutable-file-number).
12
12
13
13
## Cardano network
14
14
@@ -34,7 +34,7 @@ A Cardano transactions set snapshot represents, in a succinct way, the Cardano t
34
34
35
35
The Mithril aggregator combines the produced [multi-signature](#multi-signature) and some metadata into a Mithril certificate that will be later used by the [Mithril client](#mithril-client) to verify the authenticity of a [snapshot](#snapshot). The certificates are chained so that the [stake distribution](#stake-distribution) used to create the signatures is verifiably genuine.
36
36
37
-
> More information is available on the [certificates page](./mithril/mithril-protocol/certificates.md).
37
+
> More information is available on the [certificates page](./mithril/advanced/mithril-protocol/certificates.md).
38
38
39
39
## Epoch
40
40
@@ -48,45 +48,45 @@ Inside the database of a [Cardano node](#cardano-node), the blockchain state is
48
48
49
49
For each [beacon](#beacon), the [Mithril signers](#mithril-signer) will compute on their end a message representing the blockchain state, and sign it with their verification keys to create an [individual signature](#individual-signature). Upon winning one or more lotteries, the Mithril signer will be able to use this individual signature to participate in the creation of a [multi-signature](#multi-signature).
50
50
51
-
> More information is available on the [protocol page](./mithril/mithril-protocol/protocol.md).
51
+
> More information is available on the [protocol page](./mithril/advanced/mithril-protocol/protocol.md).
52
52
53
53
## Mithril aggregator
54
54
55
55
The Mithril aggregator is a trustless node of the [Mithril network](#mithril-network) that orchestrates the work of the [Mithril signer](#mithril-signer) nodes and gathers their [individual signatures](#individual-signature) to produce [Mithril multi-signatures](#multi-signature) and their associated [certificates](#certificate).
56
56
57
57
It is also in charge of creating and storing the [snapshot](#snapshot) archive.
58
58
59
-
> More information is available on the [aggregator page](./mithril/mithril-network/aggregator.md).
59
+
> More information is available on the [aggregator page](./mithril/advanced/mithril-network/aggregator.md).
60
60
61
61
## Mithril client
62
62
63
63
The Mithril client node within the [Mithril network](#mithril-network) is used to restore a [Cardano full node](#cardano-node) by retrieving, from a [Mithril aggregator](#mithril-aggregator), a remote [snapshot](#snapshot) and its [certificate](#certificate) chain. Finally, it is used to verify snapshot and certificate validity using the Mithril cryptographic primitives.
64
64
65
-
> More information is available on the [client page](./mithril/mithril-network/client.md).
65
+
> More information is available on the [client page](./mithril/advanced/mithril-network/client.md).
66
66
67
67
## Mithril network
68
68
69
69
In its current version, the Mithril network is a network of nodes responsible for creating [snapshots](#snapshot) and [certificates](#certificate) that enable fast bootstrap of a [Cardano node](#cardano-node). It runs on top of the [Cardano network](#cardano-network).
70
70
71
-
> More information is available on the [architecture page](./mithril/mithril-network/architecture.md).
71
+
> More information is available on the [architecture page](./mithril/advanced/mithril-network/architecture.md).
72
72
73
73
## Mithril protocol
74
74
75
75
The Mithril protocol allows stakeholders in a proof-of-stake blockchain network to individually sign messages that are aggregated into a multi-signature which guarantees that they represent a minimum share of the total stake.
76
76
77
-
> More information is on the [protocol page](./mithril/mithril-protocol/protocol.md).
77
+
> More information is on the [protocol page](./mithril/advanced/mithril-protocol/protocol.md).
78
78
79
79
## Mithril signer
80
80
81
81
The Mithril signer is a node of the [Mithril network](#mithril-network) that works transparently on top of the [stake pool operator](#stake-pool-operator-spo) Cardano nodes and which individually signs the ledger state.
82
82
83
-
> More information is available on the [signer page](./mithril/mithril-network/signer.md).
83
+
> More information is available on the [signer page](./mithril/advanced/mithril-network/signer.md).
84
84
85
85
## Multi-signature
86
86
87
87
The Mithril multi-signature is an aggregate of [individual signatures](#individual-signature), which guarantees that a minimum share of the total stake has participated in its creation.
88
88
89
-
> More information is available on the [protocol page](./mithril/mithril-protocol/protocol.md).
89
+
> More information is available on the [protocol page](./mithril/advanced/mithril-protocol/protocol.md).
90
90
91
91
## Snapshot
92
92
@@ -106,4 +106,4 @@ A stake pool operator, also known as an SPO, represents a party that holds (via
106
106
107
107
To create [individual signatures](#individual-signature), [Mithril signers](#mithril-signer) must register their signing public key: the verification key. To guarantee their genuineness, they are signed by the associated [Cardano key pair](#cardano-key-pair). It is worth mentioning that a [Mithril signer](#mithril-signer) must be aware of the verification keys of all the other Mithril signers to produce valid individual signatures.
108
108
109
-
> More information is available on the [protocol page](./mithril/mithril-protocol/protocol.md).
109
+
> More information is available on the [protocol page](./mithril/advanced/mithril-protocol/protocol.md).
Copy file name to clipboardExpand all lines: docs/website/versioned_docs/version-maintained/manual/develop/nodes/mithril-aggregator.md
+9-2Lines changed: 9 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ Mithril aggregator is responsible for collecting individual signatures from the
14
14
15
15
:::tip
16
16
17
-
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/mithril-network/architecture.md) overview
17
+
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/advanced/mithril-network/architecture.md) overview
18
18
19
-
- For more information about the **Mithril aggregator**, please see the [aggregator node](../../../mithril/mithril-network/aggregator.md) overview.
19
+
- For more information about the **Mithril aggregator**, please see the [aggregator node](../../../mithril/advanced/mithril-network/aggregator.md) overview.
20
20
21
21
:::
22
22
@@ -398,6 +398,7 @@ Here are the available subcommands:
398
398
|**genesis sign**| Signs the genesis payload with the genesis secret key |
399
399
|**genesis import**| Imports the genesis signature (the payload signed with the genesis secret key) and creates and imports a genesis certificate in the store |
400
400
|**genesis bootstrap**| Bootstraps a genesis certificate (test only usage) |
401
+
|**genesis generate-keypair**| Generates a genesis keypair |
401
402
|**era list**| Lists the supported eras |
402
403
|**era generate-tx-datum**| Generates the era markers transaction datum to be stored on-chain |
403
404
|**tools recompute-certificates-hash**| Loads all certificates in the database, recomputing their hash, and updating all related entities |
@@ -483,6 +484,12 @@ Here is a list of the available parameters:
483
484
|`target_signed_payload_path`|`--target-signed-payload-path`| - | - | Path of the signed payload to export. | - | - | - |
484
485
|`genesis_secret_key_path`|`--genesis-secret-key-path`| - | - | Path of the genesis secret key. | - | - | - |
485
486
487
+
`genesis generate-keypair` command:
488
+
489
+
| Parameter | Command line (long) | Command line (short) | Environment variable | Description | Default value | Example | Mandatory |
Copy file name to clipboardExpand all lines: docs/website/versioned_docs/version-maintained/manual/develop/nodes/mithril-client-library-wasm.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ It is responsible for handling the different types of data certified by Mithril
20
20
21
21
:::tip
22
22
23
-
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/mithril-network/architecture.md) overview.
23
+
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/advanced/mithril-network/architecture.md) overview.
Copy file name to clipboardExpand all lines: docs/website/versioned_docs/version-maintained/manual/develop/nodes/mithril-client-library.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,9 +20,9 @@ It is responsible for handling the different types of data certified by Mithril
20
20
21
21
:::tip
22
22
23
-
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/mithril-network/architecture.md) overview
23
+
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/advanced/mithril-network/architecture.md) overview
24
24
25
-
- For more information about the **Mithril client** node, please see [this overview](../../../mithril/mithril-network/client.md)
25
+
- For more information about the **Mithril client** node, please see [this overview](../../../mithril/advanced/mithril-network/client.md)
26
26
27
27
- Check out the [`Bootstrap a Cardano node`](../../getting-started/bootstrap-cardano-node.md) guide.
Copy file name to clipboardExpand all lines: docs/website/versioned_docs/version-maintained/manual/develop/nodes/mithril-signer.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ Mithril signer is responsible for producing individual signatures that are colle
14
14
15
15
:::tip
16
16
17
-
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/mithril-network/architecture.md) overview
17
+
- For more information about the **Mithril network**, please see the [architecture](../../../mithril/advanced/mithril-network/architecture.md) overview
18
18
19
-
- For more information about the **Mithril signer** node, please see [this overview](../../../mithril/mithril-network/signer.md)
19
+
- For more information about the **Mithril signer** node, please see [this overview](../../../mithril/advanced/mithril-network/signer.md)
20
20
21
21
- Check out the [`Run a Mithril signer node`](../../operate/run-signer-node.md) guide.
0 commit comments