Skip to main content

Python library for developers of Duniter clients

Project description

DuniterPy

Most complete client oriented Python library for Duniter/Ğ1 ecosystem.

This library was originally developed for Sakia desktop client which is now discontinued. It is currently used by following programs:

  • Tikka, the desktop client.
  • Silkaj, command line client.
  • Jaklis, command line client for Cs+/Gchange pods.
  • Ğ1Dons, Ğ1Dons, paper-wallet generator aimed at giving tips in Ğ1.

Features

Network

  • APIs support: BMA, GVA, WS2P, and CS+:
    • Basic Merkle API, first Duniter API to be deprecated
    • GraphQL Verification API, Duniter API in developement meant to replace BMA. Based on GraphQL.
    • Websocket to Peer, Duniter inter-nodes (servers) API
    • Cesium+, non-Duniter API, used to store profile data related to the blockchain as well as ads for Cesium and Ğchange.
  • Non-threaded asynchronous/synchronous connections
  • Support HTTP, HTTPS, and WebSocket transport for the APIs
  • Endpoints management

Blockchain

  • Support Duniter blockchain protocol
  • Duniter documents management: transaction, block and WoT documents
  • Multiple authentication methods
  • Duniter signing key
  • Sign/verify and encrypt/decrypt messages with Duniter credentials

Requirements

Installation

You will require following dependencies:

sudo apt install python3-pip python3-dev python3-wheel libsodium23

You can install DuniterPy and its dependencies with following command:

pip install --user duniterpy

Once you want to add DuniterPy to your Python project, you can add it as a dependency to your Python development environment: pyproject.toml, requirements.txt, setup.py. We recommend Poetry usage.

Documentation

Online official automaticaly generated documentation

Examples

The examples folder contains scripts to help you!

  • Have a look at the examples folder
  • Run examples from parent folder directly
python examples/request_data.py

Or from Python interpreter:

python
>>> import examples
# To list available examples
>>> help(examples)
# Run example
>>> examples.create_public_key()

request_data_async example requires to be run with asyncio:

>>> import examples, asyncio
>>> asyncio.get_event_loop().run_until_complete(examples.request_data_async())

Contributing

Packaging status

Packaging status

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

duniterpy-1.2.0.tar.gz (72.4 kB view details)

Uploaded Source

Built Distribution

duniterpy-1.2.0-py3-none-any.whl (136.3 kB view details)

Uploaded Python 3

File details

Details for the file duniterpy-1.2.0.tar.gz.

File metadata

  • Download URL: duniterpy-1.2.0.tar.gz
  • Upload date:
  • Size: 72.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.1 Linux/6.1.49

File hashes

Hashes for duniterpy-1.2.0.tar.gz
Algorithm Hash digest
SHA256 9826f410b292b79fd83be624c4eee4db68e568239564183626787667f4b2a506
MD5 391cc2523e60bebc2f70628db7d6a7aa
BLAKE2b-256 a922e6062d0250decdd90de297b78766aa95a06b4d889950c3a469b82e15eae7

See more details on using hashes here.

File details

Details for the file duniterpy-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: duniterpy-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 136.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.1 Linux/6.1.49

File hashes

Hashes for duniterpy-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 073e661ab784d2f929b9f1999f44f932be853facfa8e3870ae29b75912c81321
MD5 cb1b45eb0f81bdee8780b43b5b50dec0
BLAKE2b-256 38b3d41fa204804040e053e302d2489ab8390283d8ec033707d02463deb80f9a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page