Metadata-Version: 2.4
Name: cosmpy
Version: 0.12.0
Summary: A library for interacting with the cosmos networks
License: Apache-2.0
License-File: AUTHORS.md
License-File: LICENSE
Keywords: CosmPy,Cosmos-SDK
Author: Fetch.AI Limited
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System
Requires-Dist: bcrypt (==5.0.0)
Requires-Dist: bech32
Requires-Dist: click (<8.1)
Requires-Dist: ecdsa
Requires-Dist: googleapis-common-protos
Requires-Dist: grpcio
Requires-Dist: jsonschema (>=3.2.0,<5)
Requires-Dist: protobuf (>=4.21.6,<6.0.dev0)
Requires-Dist: pycryptodome (>=3.18.0,<4.0.0)
Requires-Dist: pynacl (==1.6.0)
Requires-Dist: python-dateutil
Requires-Dist: requests
Requires-Dist: setuptools (<82)
Requires-Dist: sortedcontainers (==2.4.0)
Requires-Dist: virtualenv (>=20.26.6)
Project-URL: Documentation, https://network.fetch.ai/docs/guides/cosmpy/installation/
Project-URL: Homepage, https://github.com/fetchai/cosmpy
Project-URL: Repository, https://github.com/fetchai/cosmpy
Description-Content-Type: text/markdown

# CosmPy

[![Official Website](https://img.shields.io/badge/Official%20Website-fetch.ai-blue?style=flat&logo=world&logoColor=white)](https://fetch.ai) 
<a href="https://pypi.org/project/cosmpy/">
<img alt="PyPI" src="https://img.shields.io/pypi/v/cosmpy">
</a>
<a href="https://github.com/fetchai/cosmpy/actions/workflows/workflow.yml">
<img alt="CosmPy sanity checks and tests" src="https://github.com/fetchai/cosmpy/actions/workflows/workflow.yml/badge.svg">
</a>
<a href="https://pypi.org/project/cosmpy/">
<img alt="Download per Month" src="https://img.shields.io/pypi/dm/cosmpy">
</a>
[![Twitter Follow](https://img.shields.io/twitter/follow/fetch_ai?style=social)](https://x.com/fetch_ai)

A python library for interacting with cosmos based blockchain networks

## To Install

```bash
pip3 install cosmpy
```

## Getting Started

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

```python
from cosmpy.aerial.client import LedgerClient, NetworkConfig

# connect to Fetch.ai network using default parameters
ledger_client = LedgerClient(NetworkConfig.fetchai_mainnet())

alice: str = 'fetch12q5gw9l9d0yyq2th77x6pjsesczpsly8h5089x'
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](https://network.fetch.ai/docs/guides/cosmpy/installation).

## Examples

Under the `examples` directory, you can find examples of basic ledger interactions using `cosmpy`, such as transferring tokens, staking, deploying and interacting with a smart contract, and performing atomic swaps.

## 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 CosmPy project.

### Code of Conduct

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

### Contribution Guidelines

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

### Development Guidelines

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

### Issues, Questions and Discussions

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

[contributing]: https://github.com/fetchai/cosmpy/blob/main/CONTRIBUTING.md
[developing]: https://github.com/fetchai/cosmpy/blob/main/DEVELOPING.md
[coc]: https://github.com/fetchai/cosmpy/blob/main/CODE_OF_CONDUCT.md
[discussion]: https://github.com/fetchai/cosmpy/discussions
[issues]: https://github.com/fetchai/cosmpy/issues
[license]: https://github.com/fetchai/cosmpy/blob/main/LICENSE
