git.iko.soy/urbit.org
on master help sign in
rekey
98dd8e6syzygyzer
reference/vane-apis/jael.md+32
compare with master
unifiedsplit
@@ -60,12 +60,31 @@ know to their rift, life, and public key?
60
60
61### `%listen`
61### `%listen`
62
62
63+set ethereum source?
64+
63#### Accepts
65#### Accepts
64
66
65```hoon
67```hoon
66[whos=(set ship) =source]
68[whos=(set ship) =source]
67```
69```
68
70
71+A `$source` is `(each ship term)`.
72+
73+```
74+++ each
75+ |$ [this that]
76+ :: either {a} or {b}, defaulting to {a}.
77+ ::
78+ :: mold generator: produces a discriminated fork between two types,
79+ :: defaulting to {a}.
80+ ::
81+ $% [%| p=that]
82+ [%& p=this]
83+ ==
84+```
85+`term=@tas`
86+
87+
69#### Returns
88#### Returns
70
89
71
90
@@ -141,14 +160,27 @@ This `task` returns no `gift`s.
141
160
142### `%rekey`
161### `%rekey`
143
162
163+This `task` updates the ship's private keys.
164+
144#### Accepts
165#### Accepts
145
166
146```hoon
167```hoon
147[=life =ring]
168[=life =ring]
148```
169```
149
170
171+`life` is a `@ud` that is the new ship key revision number. `ring` is an `@` that is the new private key.
172+
150#### Returns
173#### Returns
151
174
175+```hoon
176+[%private-keys =life vein=(map life ring)]
177+```
178+
179+In response to a `%rekey` `task`, Jael `%give`s a `%private-keys` `gift`. `life`
180+is the new `life` given in the original `task`, and `vein` is a `map` from
181+`life`s to `ring`s that keeps track of all `life`-`ring` pairs throughout the
182+history of the ship.
183+
152
184
153### `%trim`
185### `%trim`
154
186