معرفی شرکت ها
enchaintesdk-0.1.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Enchainté SDK for Python3
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | enchaintesdk-0.1.3 |
| نام | enchaintesdk |
| نسخه کتابخانه | 0.1.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Albert Canyelles Ruiz |
| ایمیل نویسنده | acanyelles@enchainte.com |
| آدرس صفحه اصلی | https://github.com/enchainte/enchainte-sdk-py |
| آدرس اینترنتی | https://pypi.org/project/enchaintesdk/ |
| مجوز | - |
# Enchainté SDK - Python
This SDK offers all the features available in the Enchainté Toolset:
- Write messages
- Get messages proof
- Validate proof
- Get messages details
## Installation
The SDK can be installed with PIP as follows:
```shell
$ pip install enchaintesdk
```
## Usage
The following examples summarize how to access the different functionalities available:
### Prepare data
In order to interact with the SDK data must be processed through the Message module.
There are several ways to generate a Message:
```python
from enchaintesdk import Message
# From a dict
d = {'data': 'Example Data'}
Message.fromDict(d)
# From a hash string (hex encoded 64-chars long string with no "0x" prefix)
Message.fromHash('5ac706bdef87529b22c08646b74cb98baf310a46bd21ee420814b04c71fa42b1')
# From a hex encoded string (with no "0x" prefix)
Message.fromHex('0123456789abcdef')
# From a string
Message.fromString('Example Data')
# From a bytes
Message.fromBytes(b'Example Data')
# Retrieve the computed message
Message.fromBytes(b'Example Data').getHash()
```
### Send messages
This example shows how to send data to Enchainté.
```python
from enchaintesdk import EnchainteClient, Message, EnchainteSDKException, ConfigEnv
import os
api_key = os.getenv("ENCHAINTE_APIKEY", default='api_key')
client = EnchainteClient(api_key, environment=ConfigEnv.TEST)
messages = [Message.fromString('Example Data 1')]
try:
send_receipt = client.sendMessages(messages)
print('sendReceipt status: ', send_receipt[0].status)
except EnchainteSDKException:
raise
```
### Get messages status
This example shows how to get all the details and status of messages:
```python
from enchaintesdk import EnchainteClient, Message, EnchainteSDKException, ConfigEnv
import os
apiKey = os.getenv("ENCHAINTE_APIKEY", default='apiKey')
client = EnchainteClient(apiKey, environment=ConfigEnv.TEST)
messages = [
Message.fromString('Example Data 1'),
Message.fromString('Example Data 2'),
Message.fromString('Example Data 3')
]
try:
m_receipts = client.getMessages(messages)
for mr in m_receipts:
print("MessageReceipt: {{anchor_id: {}, client:{}, message:{}, status:{}}}".format(
mr.anchor, mr.client, mr.message, mr.status))
except EnchainteSDKException:
raise
```
### Wait for messages to process
This example shows how to wait for a message to be processed by Enchainté after sending i:
```python
from enchaintesdk import EnchainteClient, Message, EnchainteSDKException, ConfigEnv
import os
api_key = os.getenv("ENCHAINTE_APIKEY", default='api_key')
client = EnchainteClient(api_key, environment=ConfigEnv.TEST)
messages = [Message.fromString('Example Data 1')]
try:
send_receipt = client.sendMessages(messages)
anchor = client.waitAnchor(send_receipt[0].anchor)
print("Anchor: {{id: {}, blocks:{}, network:{}, root: {}, status:{}}}".format(
anchor.id, anchor.block_roots, anchor.networks, anchor.root, anchor.status))
except EnchainteSDKException:
raise
```
### Get and validate messages proof
This example shows how to get a proof for an array of messages and validate it:
```python
from enchaintesdk import EnchainteClient, Message, EnchainteSDKException, ConfigEnv
import os
apiKey = os.getenv("ENCHAINTE_APIKEY", default='apiKey')
client = EnchainteClient(apiKey, environment=ConfigEnv.TEST)
messages = [
Message.fromString('Example Data 1'),
Message.fromString('Example Data 2'),
Message.fromString('Example Data 3')
]
try:
proof = client.getProof(messages)
timestamp = client.verifyProof(proof)
# or simply: timestamp = client.verifyMessages(messages)
print('When were our messages sent to blockchain? : {}'.format(is_valid_boolean))
except EnchainteSDKException:
raise
```
### Full example
This snippet shows a complete data cycle including: write, message status polling and proof retrieval and validation.
```python
#!/usr/bin/env python3
from enchaintesdk import EnchainteClient, Message, EnchainteSDKException
import random
import time
import os
def randHex(l):
''' Helper function to generate a random message.'''
val = [int(random.uniform(0, 256)) for x in range(0, l)]
result = ''
for n in val:
result += ('%x' % n)
return result
def main():
apiKey = os.getenv("API_KEY", default='apiKey')
client = EnchainteClient(apiKey)
try:
messages = [Message.fromString(randHex(64))]
send_receipt = client.sendMessages(messages)
print('Message sent to Enchainté. Waiting for anchor to be processed ...')
client.waitAnchor(send_receipt[0].anchor)
print('Anchor retrieved. Getting Message proof ...')
proof = client.getProof(messages)
print('Verifying proof ...')
timestamp = client.verifyProof(proof)
if timestamp <= 0:
print('Data not registered on the blockchain.')
print('Success!')
except EnchainteSDKException as e:
print(e)
if __name__ == "__main__":
# execute only if run as a script
main()
```
نیازمندی
| مقدار | نام |
|---|---|
| >=2.24.0 | requests |
| >=5.6.0 | web3 |
| >=3.0 | pycryptodome |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.5 | Python |
نحوه نصب
نصب پکیج whl enchaintesdk-0.1.3:
pip install enchaintesdk-0.1.3.whl
نصب پکیج tar.gz enchaintesdk-0.1.3:
pip install enchaintesdk-0.1.3.tar.gz