Skip to main content
Everything the Walley app shows in its dashboard is available programmatically.

Balances and holdings

A balance aggregates one instrument: total_balance, unlocked_balance, locked_balance, holding_count, and usd_value where the registry prices it. Behind each balance are on-ledger holding contracts, you can fetch them when your dApp needs contract ids:
The token registry lists every instrument the wallet can hold; the SDK also uses it to resolve a token’s admin party so you can name tokens by id alone:

Sending

If the receiver has a transfer preapproval, the transfer settles instantly. Otherwise it becomes a pending two-step transfer they must act on. Every flow helper has a prepare_* twin that stops at the fee quote, and takes wait=False for fire-and-forget submission.

Incoming transfers

Preapprovals and merge delegation

Opt in to instant receives, or let the operator consolidate fragmented holdings:
Both are ordinary transactions under the hood — prepared, signed with your key, and submitted — so they return the same result objects with fee information.

Party lookups