walley-sdk 0.3.0

Official Python SDK for the Walley wallet API on Canton Network

walley-sdk

Official Python SDK for Walley — programmatic self-custody of CIP-56 tokens on Canton Network. Your process holds the wallet's key, signs locally, and submits transactions; the API only ever sees public keys and signatures.

pip install walley-sdk

from walley import Walley

w = Walley(
    key_file="~/.config/walley/alice.key",   # PEM or 24-word mnemonic file
    party_hint="walley-alice",
)

for balance in w.balances:
    print(balance.instrument_id, balance.total_balance)

result = w.transactions.execute(commands)   # your dapp's own ledger commands
result = w.transfers.send(receiver="walley-bob::1220...", amount="5")
print(result.update_id, result.fee)

Transaction fees are drawn from a prepaid traffic balance. Pre-buy traffic, then send freely; each fee is reserved from the balance and settled from the completion — no per-transaction payment step:

w.traffic.purchase("10")               # buy 10 CC of traffic
print(w.traffic.balance().available)   # spendable balance (may go negative once)

If the balance goes negative the next send raises InsufficientTrafficError — call w.traffic.purchase(amount) to continue.

Full documentation: docs.walley.cc/python-sdk — quickstart, keys & authentication, transactions & the prepaid traffic model, wallet operations, and ledger reads.

Development

cd walley-sdk
pip install -e '.[dev]'
pytest