Aleph.im message specification
Project description
Aleph.im Message Specification
This library aims to provide an easy way to create, update and manipulate messages from Aleph.im.
It mainly consists in pydantic models that provide field type validation and IDE autocompletion for messages.
This library provides:
- schema validation when parsing messages.
- cryptographic hash validation that the
item_hashmatches the content of the message. - type validation using type checkers such as mypy in development environments.
- autocompletion support in development editors.
The item_hash is commonly used as unique message identifier on Aleph.im.
Cryptographic signatures are out of scope of this library and part of the aleph-sdk-python
project, due to their extended scope and dependency on cryptographic libraries.
This library is used in both client and node software of Aleph.im.
Usage
pip install aleph-message
import requests
from aleph_message import parse_message
from pydantic import ValidationError
ALEPH_API_SERVER = "https://official.aleph.cloud"
MESSAGE_ITEM_HASH = "9b21eb870d01bf64d23e1d4475e342c8f958fcd544adc37db07d8281da070b00"
message_dict = requests.get(ALEPH_API_SERVER + "/api/v0/messages.json?hashes=" + MESSAGE_ITEM_HASH).json()
try:
message = parse_message(message_dict["messages"][0])
print(message.sender)
except ValidationError as e:
print(e.json(indent=4))
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 aleph-message-0.4.0.tar.gz.
File metadata
- Download URL: aleph-message-0.4.0.tar.gz
- Upload date:
- Size: 11.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6b5cb289152371a111d895f13c028f2d0328565a56ab749b5c1f97cc16ef0ef5 |
|
| MD5 | e04f9eb2e0335b8ad74ba22fbee8667d |
|
| BLAKE2b-256 | eaaccd08a6481dc32e1de6e26704bf4bab30f4269347d48a2874f12bb79e76a5 |
Provenance
File details
Details for the file aleph_message-0.4.0-py3-none-any.whl.
File metadata
- Download URL: aleph_message-0.4.0-py3-none-any.whl
- Upload date:
- Size: 14.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5a01389267d0160235a0c3f7c406609f7a3e101302beee5a8bedf9ec82c6342b |
|
| MD5 | 5d684098aa1a211141f045f1ce32745d |
|
| BLAKE2b-256 | 010f0a94281cfa991d7e1524759c5763676ba0c74392ee053c3009a0cad40b37 |
