Python wrapper for the Zenroom virtual machine
Project description
zenroom.py 🐍
A python wrapper for Zenroom
This library attempts to provide a very simple wrapper around the Zenroom (https://zenroom.dyne.org/) crypto virtual machine developed as part of the DECODE project (https://decodeproject.eu/), that aims to make the Zenroom virtual machine easier to call from normal Python code.
This library has been developed for a specific deliverable within the project, and as such will likely not be suitable for most people's needs. Here we directly include a binary build of Zenroom compiled only for Linux (amd64), so any other platforms will be unable to use this library. This library has also only been tested under Python 3.
Zenroom itself does have good cross platform functionality, so if you are interested in finding out more about the functionalities offered by Zenroom, then please visit the website linked to above to find out more.
🚩 Table of Contents (click to expand)
💾 Installation
pip install zenroom
NOTE - the above command attempts to install the zenroom package, pulling in the Zenroom VM as a precompiled binary, so will only work on Linux (amd64) machines.
🎮 Usage
Two main calls are exposed, one to run zencode and one for zenroom scripts.
If you don't know what zencode is, you can start with this blogpost
https://decodeproject.eu/blog/smart-contracts-english-speaker
A good set of examples of zencode contracts could be found here
https://github.com/DECODEproject/dddc-pilot-contracts
ZENCODE
Here a quick usage example:
from zenroom import zenroom
contract = """Scenario 'coconut': "To run over the mobile wallet the first time and store the output as keypair.keys"
Given that I am known as 'identifier'
When I create my new keypair
Then print all data
"""
result, errors = zenroom.zencode_exec(contract)
print(result)
NOTE The result is in bytes and not string if you want a string you want to .decode() it
The zencode function accepts the following:
script(str): Required byte string or string containing script which Zenroom will executekeys(str): Optional byte string or string containing keys which Zenroom will usedata(str): Optional byte string or string containing data upon which Zenroom will operateconf(str): Optional byte string or string containing conf data for Zenroomverbosity(int): Optional int which controls Zenroom's log verbosity ranging from 1 (least verbose) up to 3 (most verbose)
Returns
- tuple: The output from Zenroom expressed as a byte string, the eventual errors generated as a string
ZENROOM SCRIPTS
from zenroom import zenroom
script = "print('Hello world')"
output, errors = zenroom.zenroom_exec(script)
print(output)
The same arguments and the same result are applied as the zencode call.
📋 Testing
Tests are made wuth pytests, just run
python setup.py test
🌐 Links
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file zenroom-1.0.0rc1.tar.gz.
File metadata
- Download URL: zenroom-1.0.0rc1.tar.gz
- Upload date:
- Size: 12.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 23ee91363590609c72e4cc066682dbcd52ca0b6fff0d188b162b4b8d7fc35872 |
|
| MD5 | 734124233a74fe436cfea7cbff92023f |
|
| BLAKE2b-256 | 27bb1618ec996fd2a041400777091315309f3e0facd8b249278347421224c45d |
File details
Details for the file zenroom-1.0.0rc1-py3-none-any.whl.
File metadata
- Download URL: zenroom-1.0.0rc1-py3-none-any.whl
- Upload date:
- Size: 16.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 774d7570196b727d4ac99d9394f962b00eeeb0f29564772ed96bb8de6eb3c2f4 |
|
| MD5 | 4670a77228b1f9b26b137666df98a092 |
|
| BLAKE2b-256 | 917123e024300718f04231a0ee67a8f9292709aad0b96eddaf499c2795b3d961 |
