Kaspa Python SDK

The Kaspa Python SDK provides bindings to Rust & Rusty-Kaspa source, allowing Python developers to interact with the Kaspa BlockDAG.

A native extension module, kaspa, is built from these bindings using PyO3 and Maturin.

[!IMPORTANT] This project has moved! Welcome to the new home of Kaspa Python SDK, which historically lived here.

Versions < 1.1.0 were built from the old repository.

Versions >= 1.1.0 are/will be built from this repository.

Features

This SDK provides features across the following categories:

• RPC Client — RPC API for the Kaspa node using WebSockets.
• Wallet SDK — Bindings for wallet-related primitives such as key management, derivation, and transactions.
• Managed Wallet — A fully managed interface for the Rusty Kaspa Wallet API bundled into one Python class.
• SilverScript — Experimental SilverScript contract compilation, locking scripts, and unlocking scripts.
• ZK Scripts — Experimental builder that turns RISC Zero zero-knowledge proofs into Kaspa locking and unlocking scripts, verified on-chain.

This package strives to mirror the Kaspa WASM32 SDK from a feature and API perspective, while respecting Python conventions.

Documentation

Full documentation is available on the documentation site, including (but not limited to):

• Installation Guide
• Examples
• API Reference

The documentation site is versioned:

• dev refers to the latest in main branch
• latest refers to the most recent production release
• Specific version tags are available

Documentation is not available for versions prior to 1.1.0. However, the API is very close, if not the exact same, for those versions and 1.1.0.

Quick Install

The Kaspa Python SDK is available on PyPI (link). As such, it can be installed from PyPI via:

pip install kaspa

Security-critical applications should consider building and installing from source. Instructions can be found here on the documentation site.

Example

A very basic RPC example:

import asyncio
from kaspa import Resolver, RpcClient

async def main():
    # Connect to Public Node Network (PNN) with Resolver
    client = RpcClient(resolver=Resolver())
    await client.connect()

    # Execute RPC Call
    print(await client.get_block_dag_info())

if __name__ == "__main__":
    asyncio.run(main())

Additional detailed examples can be found in the following locations:

• The Examples section of the documentation site
• The examples directory of this project

Core Concepts & Contributing

The Contributing Guide details various technical core concepts and information about this project.

License

This project is licensed under the ISC License.