compact-engine/com.midnight.kuira.core.compact/ContractRuntime

ContractRuntime

object ContractRuntime

Native bridge to the Rust contract runtime.

Exposes functions that match the WASM onchain-runtime exactly:

persistentHashAligned: binary_repr + SHA-256 (proper field-aligned encoding)
bigIntToValue / valueToBigInt: field element encoding
contractQuery: VM opcode execution via state handles

Functions

assembleContractCallTx

fun assembleContractCallTx(paramsJson: String): String?

Assemble a contract call transaction from circuit execution output.

assembleDeployTx

fun assembleDeployTx(paramsJson: String): String?

Assemble a contract DEPLOY transaction from constructor output.

bigIntToValue

fun bigIntToValue(bigintStr: String): String?

Convert BigInt (hex string) to Value (JSON).

contractQuery

fun contractQuery(handle: Long, opcodesJson: String): String?

Execute opcodes against a contract state handle.

ensureLoaded

fun ensureLoaded()

persistentCommitAligned

fun persistentCommitAligned(inputJson: String): String?

Compute persistent commit: SHA-256(opening || binary_repr(value)).

persistentHash

fun persistentHash(inputHex: String): String?

Raw persistent hash (SHA-256) of hex bytes.

persistentHashAligned

fun persistentHashAligned(alignedValueJson: String): String?

Persistent hash with proper AlignedValue encoding (matches WASM).

stateClone

fun stateClone(handle: Long): Long

Clone a state handle (saves initial state before circuit queries).

stateCreate

fun stateCreate(stateHex: String): Long

Create a contract state from SCALE hex, return handle.

stateCreateWithNulls

fun stateCreateWithNulls(structureJson: String): Long

Create state from a JSON structure descriptor (nested arrays of nulls).

stateFree

fun stateFree(handle: Long)

Free a contract state handle.

stateReadFields

fun stateReadFields(handle: Long): String?

Read contract state fields as JSON.

stateSetOperation

fun stateSetOperation(handle: Long, operationName: String)

Set an operation on a state handle.

valueToBigInt

fun valueToBigInt(valueJson: String): String?

Convert Value (JSON) to BigInt (decimal string).