Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Python-Cardano/pycardano
A lightweight Cardano library in Python
https://github.com/Python-Cardano/pycardano
blockchain cardano hacktoberfest library python
Last synced: 13 days ago
JSON representation
A lightweight Cardano library in Python
- Host: GitHub
- URL: https://github.com/Python-Cardano/pycardano
- Owner: Python-Cardano
- License: mit
- Created: 2022-01-08T23:21:48.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T13:15:34.000Z (19 days ago)
- Last Synced: 2024-10-26T03:31:13.686Z (16 days ago)
- Topics: blockchain, cardano, hacktoberfest, library, python
- Language: Python
- Homepage: https://pycardano.readthedocs.io
- Size: 3.93 MB
- Stars: 214
- Watchers: 12
- Forks: 67
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
---
## PyCardano
[](https://pypi.python.org/pypi/pycardano/)
[](https://pypi.python.org/pypi/pycardano/)
[](https://pypi.python.org/pypi/pycardano/)
[](https://github.com/Python-Cardano/pycardano/actions/workflows/main.yml)
[](https://codecov.io/gh/Python-Cardano/pycardano)
[](https://pycardano.readthedocs.io/en/latest/?badge=latest)
[](https://discord.gg/qT9Mn9xjgz)
[](https://twitter.com/PyCardano)
PyCardano is a Cardano library written in Python. It allows users to create and sign transactions without
depending on third-party Cardano serialization tools, such as
[cardano-cli](https://github.com/input-output-hk/cardano-node#cardano-cli) and
[cardano-serialization-lib](https://github.com/Emurgo/cardano-serialization-lib), making it a lightweight library, which
is simple and fast to set up in all types of environments.
Current goal of this project is to enable developers to write off-chain code and tests in pure Python for Plutus DApps.
Nevertheless, we see the potential in expanding this project to a full Cardano node client, which
could be beneficial for faster R&D iterations.
### Features
- [x] Shelly address
- [x] Transaction builder
- [x] Transaction signing
- [x] Multi-asset
- [X] Chain backend integration
- [X] Fee calculation
- [X] UTxO selection
- [X] Native script
- [X] Native token
- [X] Metadata
- [X] Plutus script
- [X] Staking certificates
- [X] Reward withdraw
- [X] Mnemonic
- [X] HD Wallet
- [ ] Byron Address
- [ ] Pool certificate
- [ ] Protocol proposal update
### Installation
Install the library using [pip](https://pip.pypa.io/en/stable/):
`pip install pycardano`
### Documentation
https://pycardano.readthedocs.io/en/latest/
### Examples
#### Full stack DApp
A full stack testnet DApp is hosted on replit: https://pycardano.cffls.repl.co/
To learn more details, go to the [DApp page](https://github.com/Python-Cardano/pycardano/tree/main/examples/full_stack).
#### Transaction creation and signing
Expand code
```python
"""Build a transaction using transaction builder"""
from blockfrost import ApiUrls
from pycardano import *
# Use testnet
network = Network.TESTNET
# Read keys to memory
# Assume there is a payment.skey file sitting in current directory
psk = PaymentSigningKey.load("payment.skey")
# Assume there is a stake.skey file sitting in current directory
ssk = StakeSigningKey.load("stake.skey")
pvk = PaymentVerificationKey.from_signing_key(psk)
svk = StakeVerificationKey.from_signing_key(ssk)
# Derive an address from payment verification key and stake verification key
address = Address(pvk.hash(), svk.hash(), network)
# Create a BlockFrost chain context
context = BlockFrostChainContext("your_blockfrost_project_id", base_url=ApiUrls.preprod.value)
# Create a transaction builder
builder = TransactionBuilder(context)
# Tell the builder that transaction input will come from a specific address, assuming that there are some ADA and native
# assets sitting at this address. "add_input_address" could be called multiple times with different address.
builder.add_input_address(address)
# Get all UTxOs currently sitting at this address
utxos = context.utxos(address)
# We can also tell the builder to include a specific UTxO in the transaction.
# Similarly, "add_input" could be called multiple times.
builder.add_input(utxos[0])
# Send 1.5 ADA and a native asset (CHOC) in quantity of 2000 to an address.
builder.add_output(
TransactionOutput(
Address.from_primitive(
"addr_test1vrm9x2zsux7va6w892g38tvchnzahvcd9tykqf3ygnmwtaqyfg52x"
),
Value.from_primitive(
[
1500000,
{
bytes.fromhex(
"57fca08abbaddee36da742a839f7d83a7e1d2419f1507fcbf3916522" # Policy ID
): {
b"CHOC": 2000 # Asset name and amount
}
},
]
),
)
)
# We can add multiple outputs, similar to what we can do with inputs.
# Send 2 ADA and a native asset (CHOC) in quantity of 200 to ourselves
builder.add_output(
TransactionOutput(
address,
Value.from_primitive(
[
2000000,
{
bytes.fromhex(
"57fca08abbaddee36da742a839f7d83a7e1d2419f1507fcbf3916522" # Policy ID
): {
b"CHOC": 200 # Asset name and amount
}
},
]
),
)
)
# Create final signed transaction
signed_tx = builder.build_and_sign([psk], change_address=address)
# Submit signed transaction to the network
context.submit_tx(signed_tx)
```
See more usages under [examples](https://github.com/Python-Cardano/pycardano/tree/main/examples).
### Development
Click to expand
#### Workspace setup
Clone the repository:
`git clone https://github.com/Python-Cardano/pycardano.git`
PyCardano uses [poetry](https://python-poetry.org/) to manage its dependencies.
Install poetry for osx / linux / bashonwindows:
`curl -sSL https://install.python-poetry.org | python3 -`
Go to [poetry installation](https://python-poetry.org/docs/#installation) for more details.
Change directory into the repo, install all dependencies using poetry, and you are all set!
`cd pycardano && poetry install`
When testing or running any program, it is recommended to enter
a [poetry shell](https://python-poetry.org/docs/cli/#shell) in which all python dependencies are automatically
configured: `poetry shell`.
#### Test
PyCardano uses [pytest](https://docs.pytest.org/en/6.2.x/) for unit testing.
Run all tests:
`make test`
Run all tests in a specific test file:
`poetry run pytest test/pycardano/test_transaction.py`
Run a specific test function:
`poetry run pytest -k "test_transaction_body"`
Run a specific test function in a test file:
`poetry run pytest test/pycardano/test_transaction.py -k "test_transaction_body"`
#### Test coverage
We use [Coverage](https://coverage.readthedocs.io/en/latest/) to calculate the test coverage.
Test coverage could be generated by: `make cov`
A html report could be generated and opened in browser by: `make cov-html`
### Style guidelines
The package uses
[Google style](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html) docstring.
Code could be formatted with command: `make format`
The code style could be checked by [flake8](https://flake8.pycqa.org/en/latest/): `make qa`
### Docs generation
The majority of package documentation is created by the docstrings in python files.
We use [sphinx](https://www.sphinx-doc.org/en/master/) with
[Read the Docs theme](https://sphinx-rtd-theme.readthedocs.io/en/stable/) to generate the
html pages.
Build docs and open the docs in browser:
`make docs`
## Donation and Sponsor
If you find this project helpful, please consider donate or sponsor us. Your donation and sponsor will allow us to
spend more time on improving PyCardano and adding more features in the future.
You can support us by 1) sponsoring through Github, or 2) donating ADA to our ADA Handle `pycardano` or to the address below:
[`addr1vxa4qadv7hk2dd3jtz9rep7sp92lkgwzefwkmsy3qkglq5qzv8c0d`](https://cardanoscan.io/address/61bb5075acf5eca6b632588a3c87d00955fb21c2ca5d6dc0910591f050)
## Sponsors :heart:
