git.iko.soy/urbit.org
on master help sign in
Merge branch 'ames-encryption' of github.com:urbit/docs into ames-encryption
commita06799d874a9b86b479073ca1353c7af9b82ec98 authordrbeefsupreme <drbeefsupreme@discordja.net> dateWed 9 Jun 2021, 14:43 (5 years ago) parentfefe4c1e645dc5
3 files changed+4−7
compare with master
unifiedsplit
arvo/ames/cryptography.md+2−3 arvo/reference/cryptography.md+1−3 system-overview/cryptography.md+1−1
arvo/ames/cryptography.md+2−3
@@ -42,7 +42,7 @@ message fragment is signed using the authentication key. It is encrypted using
4242
4343## Diffie-Hellman key exchange {#key-exchange}
4444
45−For each foreign ship a given ship has met, `$ames-state` contains a
45+For each foreign ship a given ship has communicated with, `$ames-state` contains a
4646`$peer-state`, inside which the `$symmetric-key` (an atom which nests under
4747`@uw`) is utilized for encrypting all Ames packets shared between the two ships.
4848The `symmetric-key` is derived using [`+shar:ed:crypto`](@/docs/arvo/reference/cryptography.md#shar) found in `sys/zuse.hoon`,
@@ -122,7 +122,7 @@ This core is used for the standard asymmetric cryptographic operations: encrypti
122122
123123#### `+ex:acru`
124124
125−This core stores keys and their fingerprints. `+sec` is the secret key (which
125+This core is used to extract keys and their fingerprints. `+sec` is the secret key (which
126126may be empty), `+pub` is the public key associated to the secret key, `+pac` is
127127the fingerprint associated to the secret key, and `+fig` is the fingerprint
128128associated to the public key. We note that when the core contains both
@@ -143,4 +143,3 @@ only the public key.
143143These arms are for symmetric encryption (`+en`) and decryption (`+de` and
144144`+dy`). The difference between the decryption arms is that `+de` returns null
145145and `+dy` crashes upon failure.
146−
arvo/reference/cryptography.md+1−3
@@ -18,8 +18,7 @@ library reference.
1818
1919`zuse` contains several cryptosuites. The ones utilized by Ames are
2020[`+ed:crypto`](#ed), [`+aes:crypto`](#aes), and [`+crub:crypto`](#crub), with
21−the latter being the only one which is implementable as an [`+acru:ames`
22−core](@/docs/arvo/ames/cryptography/#crypto-core).
21+the latter being the only one which is implemented as an [`+acru:ames`](@/docs/arvo/ames/cryptography/#crypto-core)-shaped core.
2322
2423## `+crub:crypto` {#crub}
2524
@@ -219,4 +218,3 @@ This core contains several doors, each one used for a different variation of AES
219218according to key size and mode. The only ones currently in use are
220219`+siva:aes:crypto` and `+sivc:aes:crypto`, which are 128-bit and
221220256-bit modes of [`AES-SIV`](https://www.aes-siv.com) respectively.
222−
system-overview/cryptography.md+1−1
@@ -120,5 +120,5 @@ The following pages contained more detailed information about the cryptography
120120utilized by each of the system components.
121121
122122 - [Ames](@/docs/arvo/ames/cryptography.md)
123− - [zuse](@/docs/arvo/reference/cryptography.md)
123+ - [Zuse](@/docs/arvo/reference/cryptography.md)
124124 - [Vere](@/docs/vere/cryptography.md)