From 49f3b39e4a8e0f562d952ca418e93b42a8c6a17c Mon Sep 17 00:00:00 2001
From: folex <0xdxdy@gmail.com>
Date: Fri, 30 Jul 2021 15:00:01 +0300
Subject: [PATCH] README: link to doc & add example

---
 readme.md | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/readme.md b/readme.md
index f38137e..84a76ac 100644
--- a/readme.md
+++ b/readme.md
@@ -1,5 +1,4 @@
 ## Aqua
-
 Aqua is a new-gen language for distributed systems.
 
 Aqua programs are executed on many peers, sequentially
@@ -10,12 +9,26 @@ Therefore, Aqua scripts are compiled into several targets at once, with AIR and
 
 ## aqua-lib
 
-TBD
+API of the protocol-level functions in the Fluence Network.
 
-### usage
+This API is available on all peers powered by Fluence nodes, and a part of the API is available on JS/TS-based (browsers, NodeJS) peers.
 
-TBD
+### Documentation
+See [Aqua Book](https://fluence.dev/aqua-book/libraries/aqua-dht).
 
-### references
+### How to use it in Aqua
+
+Add `@fluencelabs/aqua-lib` to your package.json dependencies, and then in your Aqua script, import and use it:
+```haskell
+import "@fluencelabs/aqua-lib"
+
+-- gather Peer.identify from all nodes in the neighbourhood
+func getPeersInfo() -> []Info:
+    infos: *Info
+    nodes <- Kademlia.neighborhood(%init_peer_id%, nil, nil)
+    for node in nodes:
+        on node:
+            infos <- Peer.identify()
+    <- infos
+```
 
-- To get started writing aqua see: https://github.com/fluencelabs/aqua-playground