Update README

Author: chiliec

README.md

@@ -3,35 +3,60 @@
 ![Tests Status](https://github.com/VIZ-Blockchain/viz-python-lib/actions/workflows/tests.yml/badge.svg)
 [![Documentation Status](https://readthedocs.org/projects/viz-python-lib/badge/?version=latest)](https://viz-python-lib.readthedocs.io/en/latest/?badge=latest)
 
-**This library is in alpha state, API unstable**
+## Usage examples
 
-Built on top of [python-graphenelib](https://github.com/xeroc/python-graphenelib/)
+Read dynamic global properties:
 
-## Dependencies
+```python
+from viz import Client
+from pprint import pprint
 
-#### Linux dependencies
+viz = Client(node='https://api.viz.world/')
+pprint(viz.info())
+```
 
-```sh
-sudo apt-get install libffi-dev libssl-dev python-dev
+Award someone:
+
+```python
+from viz import Client
+
+node = "https://node.viz.cx/"
+viz = Client(node=node, keys=["5...your_private_regular_key..."])
+initiator = "your_account"
+percent = 10.5
+viz.award("id", percent, "with love", None, initiator)
 ```
 
-#### Windows dependencies
+Award someone with fixed reward:
 
-Install regular version of [OpenSSL](https://slproweb.com/products/Win32OpenSSL.html) (not Light) suitable for your core processor.
+```python
+from viz import Client
 
-#### MacOS dependencies
+node = "wss://node.viz.cx/ws"
+viz = Client(node=node, keys=["5...your_private_regular_key..."])
+initiator = "your_account"
+reward_amount = 3.5 # "3.50 VIZ"
+max_energy = 30 # 30%
+viz.fixed_award("id", reward_amount, max_energy, "with fixed reward", None, initiator)
+```
 
-Apple has deprecated use of OpenSSL in favor of its own TLS and crypto libraries. This means that you will need to install and export some OpenSSL settings yourself, before you can install viz-python-lib:
+Send a custom operation:
 
-```sh
-brew install openssl
+```python
+from viz import Client
+
+node = "wss://node.viz.cx/ws"
+viz = Client(node=node, keys=["5...your_private_regular_key..."])
+account = "your_account"
+protocol = "color.place"
+json = {"x":35, "y":70, "color":"#e50000"}
+viz.custom(protocol, json, None, [account])
 ```
 
-and then use the following commands:
+Any direct RPC call:
 
-```sh
-export CFLAGS="-I$(brew --prefix openssl)/include"
-export LDFLAGS="-L$(brew --prefix openssl)/lib"
+```python
+viz.rpc.some_rpc_method()
 ```
 
 ## Installation
@@ -51,22 +76,31 @@ cd viz-python-lib/
 poetry install
 ```
 
-## Usage
+## Development
 
-Basic read query example:
+### Dependencies
 
-```python
-from viz import Client
-from pprint import pprint
+#### Linux dependencies
 
-node = 'https://api.viz.world/'
+```sh
+sudo apt-get install libffi-dev libssl-dev python-dev
+```
 
-viz = Client(node=node)
-pprint(viz.info())
+#### Windows dependencies
+
+Install regular version of [OpenSSL](https://slproweb.com/products/Win32OpenSSL.html) (not Light) suitable for your core processor.
+
+#### MacOS dependencies
+
+Apple has deprecated use of OpenSSL in favor of its own TLS and crypto libraries. This means that you will need to install and export some OpenSSL settings yourself, before you can install viz-python-lib:
+
+```sh
+brew install openssl
 ```
 
-Direct RPC calls:
+and then use the following commands:
 
-```python
-viz.rpc.some_rpc_method()
+```sh
+export CFLAGS="-I$(brew --prefix openssl)/include"
+export LDFLAGS="-L$(brew --prefix openssl)/lib"
 ```