on master help sign in
public-keys
608e5adsyzygyzer
reference/vane-apis/jael.md+15−2
@@ -226,7 +226,8 @@ history of the ship.
226
226
227### `%public-keys`
227### `%public-keys`
228
228
229−This `task` creates a subscription for the callee to a selection of the public keys kept by Jael.
229+This `task` creates a subscription for the callee to a selection of the public
230+keys kept by Jael. This `task` can originate locally or remotely.
230
231
231#### Accepts
232#### Accepts
232
233
@@ -240,6 +241,18 @@ This `task` creates a subscription for the callee to a selection of the public k
240```hoon
241```hoon
241[%public-keys =public-keys-result]
242[%public-keys =public-keys-result]
242```
243```
244+If the `task` originated locally, Jael `%give`s a `%public-keys` `gift` in
245+ response. If it originated remotely, Jael `%give`s a `%boon` `gift` to back
246+ to Ames wrapping a `%public-keys` `gift`.
247+
248+A `$public-keys-result` is the following.
249+```hoon
250+ +$ public-keys-result
251+ $% [%full points=(map ship point)]
252+ [%diff who=ship =diff:point]
253+ [%breach who=ship]
254+```
255+
243
256
244
257
245### `%rekey`
258### `%rekey`
@@ -252,7 +265,7 @@ This `task` updates the ship's private keys.
252[=life =ring]
265[=life =ring]
253```
266```
254
267
255−`life` is a `@ud` that is the new ship key revision number. `ring` is an `@` that is the new private key.
268+`life` is a `@ud` that is the new ship key revision number. `ring` is a `@` that is the new private key.
256
269
257#### Returns
270#### Returns
258
271