read

suspend fun read(circuitName: String, vararg args: Any?): String

Call a view/getter circuit and return its result as JSON — no proving, no transaction. Reads a contract's computed views (e.g. a treasury balance or a proposal struct) that aren't exposed as raw ledger fields via observeLedger. BigInt → decimal string, Bytes → hex, structs preserved; parse the JSON per circuit. A read-only handle (no signing keys) is sufficient.

Throws

if this contract was built without an address.