Skip to main content

A Python SDK for Kii

Project description

KiiPy

A python library for interacting with KiiChain and other Cosmos-based blockchain networks

Sanity checks and tests

This project has been forked from Fetch AI's CosmPy.

DEVELOPMENT NOTES

This project is still under development.

Details on how to setup the dev environment can be found in the development guidelines. Using poetry virtual environment is highly encouraged to ensure seamless development.

Notes:

  • Items that need to be looked into are marked as TODO: in the code and docs.
  • Workflows are failing due to usage limits. It's advisable to fix this to ensure code quality. Current workaround is to make sure to run corresponding checks and tests locally.

Installation

Install with pip

pip install kiipy

Install from source code

  1. Clone the repository
git clone https://github.com/KiiBlockchain/kiipy.git
cd kiipy
  1. Install the required dependencies
poetry install
  1. Open the virtual environment
poetry shell

Getting Started

Below is a simple example for querying an account's balances:

from kiipy.aerial.client import LedgerClient, NetworkConfig

# connect to Kii test network using default parameters
ledger_client = LedgerClient(NetworkConfig.kii_testnet())

alice: str = 'kii1pyt53arxkg5t4aww892esskltrf54mg88va98y'
balances = ledger_client.query_bank_all_balances(alice)

# show all coin balances
for coin in balances:
  print(f'{coin.amount}{coin.denom}')

Documentation

The full documentation can be found here.

Examples

Under the examples directory, you can find examples of basic ledger interactions using kiipy, such as transferring tokens, staking, and deploying.

Contributing

All contributions are very welcome! Remember, contribution is not only PRs and code, but any help with docs or helping other developers solve their issues are very appreciated!

Read below to learn how you can take part in the KiiPy project.

Code of Conduct

Please be sure to read and follow our Code of Conduct. By participating, you are expected to uphold this code.

Contribution Guidelines

Read our contribution guidelines to learn about our issue and pull request submission processes, coding rules, and more.

Development Guidelines

Read our development guidelines to learn about the development processes and workflows.

Issues, Questions and Discussions

We use GitHub Issues for tracking requests and bugs, and GitHub Discussions for general questions and discussion.

License

The KiiPy project is licensed under Apache License 2.0.

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

kiipy-0.1.0.tar.gz (250.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kiipy-0.1.0-py3-none-any.whl (547.8 kB view details)

Uploaded Python 3

File details

Details for the file kiipy-0.1.0.tar.gz.

File metadata

  • Download URL: kiipy-0.1.0.tar.gz
  • Upload date:
  • Size: 250.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for kiipy-0.1.0.tar.gz
Algorithm Hash digest
SHA256 746543364cd9cf642e4d98f4d67a56f2b06be6f4b10d07effe7fb6897adb73eb
MD5 2054ee369b13f135daee974d2e5df673
BLAKE2b-256 958f5852941d8ed720bf9953448736194b1d701f3f9be2755511dbb2cca4ee32

See more details on using hashes here.

File details

Details for the file kiipy-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: kiipy-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 547.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for kiipy-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 69885677c317faaa20eac08d509f68f03e6ad686a9511e2c8e88a9ffe02d2c31
MD5 7f27b711c6007f18f19fbc458c827e5e
BLAKE2b-256 dacf3a06fde76ba2d87789eab35e67b78b77ffbc2c067b34aab5d4374fc8b2b2

See more details on using hashes here.

Supported by

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