diff options
author | Martin Schanzenbach <schanzen@gnunet.org> | 2021-12-07 12:41:33 +0100 |
---|---|---|
committer | Martin Schanzenbach <schanzen@gnunet.org> | 2021-12-07 12:41:33 +0100 |
commit | 6e2f32b7fae8debf8465c613b5504b6fc058787f (patch) | |
tree | 9fbe0feaf6bc9eb1b7ba48353a9d34dbcac5868f | |
parent | acfbf3bdd521855def795697f6fc2d30a78ba11e (diff) | |
download | lsd0004-6e2f32b7fae8debf8465c613b5504b6fc058787f.tar.gz lsd0004-6e2f32b7fae8debf8465c613b5504b6fc058787f.zip |
overlay API
-rw-r--r-- | draft-schanzen-r5n.xml | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/draft-schanzen-r5n.xml b/draft-schanzen-r5n.xml index f9f5f46..7216641 100644 --- a/draft-schanzen-r5n.xml +++ b/draft-schanzen-r5n.xml | |||
@@ -346,6 +346,46 @@ see how we can offer even the most minimal protections against peer | |||
346 | The peer public key is the public key of the corresponding | 346 | The peer public key is the public key of the corresponding |
347 | Ed25519<xref target="ed25519" /> peer private key. | 347 | Ed25519<xref target="ed25519" /> peer private key. |
348 | </t> | 348 | </t> |
349 | <t> | ||
350 | Any implementation of this specification MUST expose the two API | ||
351 | procedures "GET" and "PUT". | ||
352 | </t> | ||
353 | <section> | ||
354 | <name>The GET procedure</name> | ||
355 | <t> | ||
356 | The GET procedure is defined as follows: | ||
357 | </t> | ||
358 | <artwork name="" type="" align="left" alt=""><![CDATA[ | ||
359 | GET(key[, options]) -> RESULTS as List | ||
360 | or | ||
361 | GET(key[, options], callbackFunction) | ||
362 | ]]></artwork> | ||
363 | <t> | ||
364 | The procedure takes two arguments. The first argument is the query | ||
365 | key and is mandatory. The GET procedure may also allow the caller | ||
366 | to specifiy query options. | ||
367 | </t> | ||
368 | <t> | ||
369 | The procedure either returns a list of results or allows the caller | ||
370 | to provide a callback function which is called for any result | ||
371 | received from the DHT until the procedure is cancelled. | ||
372 | </t> | ||
373 | </section> | ||
374 | <section> | ||
375 | <name>The PUT procedure</name> | ||
376 | <t> | ||
377 | The PUT procedure is defined as follows: | ||
378 | </t> | ||
379 | <artwork name="" type="" align="left" alt=""><![CDATA[ | ||
380 | PUT(key[, options], PAYLOAD) | ||
381 | ]]></artwork> | ||
382 | <t> | ||
383 | The procedure takes three arguments. The first argument is the query | ||
384 | key and is mandatory. The PUT procedure may also allow the caller | ||
385 | to specifiy put options. The third argument is the payload data which | ||
386 | is to be stored under the provided put key. | ||
387 | </t> | ||
388 | </section> | ||
349 | </section> | 389 | </section> |
350 | <section anchor="blockstorage" numbered="true" toc="default"> | 390 | <section anchor="blockstorage" numbered="true" toc="default"> |
351 | <name>Block Storage</name> | 391 | <name>Block Storage</name> |