py-algorand-sdk
A python library for interacting with the Algorand network.
Installation
Run $ pip3 install py-algorand-sdk to install the package.
Alternatively, choose a distribution file, and run $ pip3 install [file name].
Supported Python versions
py-algorand-sdk's minimum Python version policy attempts to balance several constraints.
- Make it easy for the community to use py-algorand-sdk by minimizing or excluding the need to customize Python installations.
- Provide maintainers with access to newer language features that produce more robust software.
Given these constraints, the minimum Python version policy is: Target Python version on newest Ubuntu LTS released >= 6 months ago.
The rationale is:
- If a major Linux OS distribution bumps a Python version, then it's sufficiently available to the community for us to upgrade.
- The 6 month time buffer ensures we delay upgrades until the community starts using a recently released LTS version.
SDK Development
Install dependencies
pip3 install -r requirements.txt
Run tests
make docker-test
Set up the Algorand Sandbox based test-harness without running the tests
make harness
Format code
black .
Update algosdk/__init__.pyi which allows downstream developers importing algosdk and using VSCode's PyLance to have improved type analysis
make generate-init
Lint types
make mypy(ormypy algosdk)
Check all lints required by the C.I. process
make lint
Run non-test-harness related unit tests
make pytest-unit
We use cucumber testing for all of our SDKs, including this one. Please refer to algorand-sdk-testing for guidance and existing tests that you may need to update. Depending on the type of update you wish to contribute, you may also need to have corresponding updates in the other SDKs (Go, JS, and Java). Feel welcome to ask for collaboration on that front.
Quick start
Here's a simple example you can run without a node.
from algosdk import account, encoding
# generate an account
private_key, address = account.generate_account()
print("Private key:", private_key)
print("Address:", address)
# check if the address is valid
if encoding.is_valid_address(address):
print("The address is valid!")
else:
print("The address is invalid.")
Node setup
Follow the instructions in Algorand's developer resources to install a node on your computer.
You can also set up a local Algorand Sandbox with make harness.
Running examples/example.py
Before running example.py, start kmd on a private network or testnet node:
./goal kmd start -d [data directory]
Next, create a wallet and an account:
./goal wallet new [wallet name] -d [data directory]
./goal account new -d [data directory] -w [wallet name]
Visit the Algorand dispenser and enter the account address to fund your account.
Next, in tokens.py, either update the tokens and addresses, or provide a path to the data directory. Alternatively, tokens.py also defaults to the sandbox harness configurations for algod and kmd, which can be brought up by running make harness.
You're now ready to run example.py!
Documentation
Documentation for the Python SDK is available at py-algorand-sdk.readthedocs.io.
License
py-algorand-sdk is licensed under an MIT license. See the LICENSE file for details.
2 maintainers
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file py_algorand_sdk-2.12.0.tar.gz.
File metadata
- Download URL: py_algorand_sdk-2.12.0.tar.gz
- Upload date:
- Size: 91.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0726a714879d8962aeb72379321b236bb7991b7e8c931ae35ba75c8977f52fae
|
|
| MD5 |
f58ba1930e2724dec7eb7fef1983206d
|
|
| BLAKE2b-256 |
90fe2a1e864809321d467a0e26fbcbc4498ec153b64df53e2bcd3a6062706af0
|
File details
Details for the file py_algorand_sdk-2.12.0-py3-none-any.whl.
File metadata
- Download URL: py_algorand_sdk-2.12.0-py3-none-any.whl
- Upload date:
- Size: 114.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7a627e79060912a619418582d9fce838a0f0acc3c58a21d46b2fca458522211
|
|
| MD5 |
94177df943420ec210997cb3e6485a36
|
|
| BLAKE2b-256 |
d7b9f5256cc2aab463481bb08352aa8db4c95cbe53021e03c7ba7e924473f0e6
|
