runtime/uk.shusek.krwa.runtime

Package-level declarations

Types

BitOps

class BitOps

ByteArrayMemory

class ByteArrayMemory(limits: MemoryLimits) : Memory

Represents the linear memory in the Wasm program. Can be shared reference b/w the host and the guest.

ByteBufferMemory

class ByteBufferMemory(limits: MemoryLimits) : Memory

Represents the linear memory in the Wasm program. Can be shared reference b/w the host and the guest.

ConstantEvaluators

object ConstantEvaluators

CtrlFrame

class CtrlFrame(val opCode: OpCode, val startValues: Int, val endValues: Int, val height: Int, val pc: Int = 0)

ExecutionBackend

enum ExecutionBackend : Enum<ExecutionBackend>

ExecutionBackendAvailability

data class ExecutionBackendAvailability(val available: Boolean, val reason: String? = null)

ExecutionCompletedException

open class ExecutionCompletedException : WasmEngineException

Signals successful completion of execution (used by WASI proc_exit with code 0).

ExportFunction

fun interface ExportFunction

This represents an Exported function from the Wasm module.

GlobalInstance

open class GlobalInstance(var valueLow: Long, var valueHigh: Long, val type: ValType, val mutabilityType: MutabilityType)

HostFunction

open class HostFunction : ImportFunction

A HostFunction is an ExternalFunction that has been defined by the host.

ImportFunction

open class ImportFunction : ImportValue

ImportGlobal

open class ImportGlobal(module: String, name: String, instance: GlobalInstance) : ImportValue

ImportMemory

open class ImportMemory(module: String, name: String, memory: Memory?) : ImportValue

ImportTable

open class ImportTable(module: String, name: String, table: TableInstance) : ImportValue

ImportTag

open class ImportTag(module: String, name: String, tag: TagInstance) : ImportValue

ImportValue

interface ImportValue

An external value is the runtime representation of an entity that can be imported. It is an address denoting either a function instance, table instance, memory instance, or global instances in the shared store.

ImportValues

class ImportValues

Instance

class Instance : AutoCloseable

A live WebAssembly instance.

Memory

interface Memory

NativeWasmFeatures

object NativeWasmFeatures

Runtime feature checks for the host JavaScript WebAssembly implementation.

NativeWasmFunction

class NativeWasmFunction

NativeWasmGlobal

class NativeWasmGlobal

NativeWasmHostFunction

fun interface NativeWasmHostFunction

NativeWasmImports

class NativeWasmImports

NativeWasmInstance

class NativeWasmInstance

Native browser WebAssembly execution path for Kotlin/Wasm browser builds.

NativeWasmMemory

class NativeWasmMemory : Memory

NativeWasmRuntimeException

class NativeWasmRuntimeException(message: String) : WasmEngineException

NativeWasmTable

class NativeWasmTable

NativeWasmTag

class NativeWasmTag

OpCodeIdentifier

@Target(allowedTargets = [AnnotationTarget.FUNCTION])

annotation class OpCodeIdentifier(val value: OpCode)

OpcodeOps

object OpcodeOps

Common opcode helper logic shared by constant evaluation and host import glue.

PlatformInstanceExecution

interface PlatformInstanceExecution : AutoCloseable

Execution surface used by host-backed engines selected through ExecutionBackend.

PortableMemory

class PortableMemory(limits: MemoryLimits) : Memory

Portable, non-shared linear memory implementation for Kotlin targets without a specialized memory backend.

PulleyExecutionProvider

interface PulleyExecutionProvider

Supplies a platform binding for ExecutionBackend.PULLEY.

PulleyExecutionProviders

expect object PulleyExecutionProviders

actual object PulleyExecutionProviders

RuntimeJvmStatic

@Target(allowedTargets = [AnnotationTarget.FUNCTION])

expect annotation class RuntimeJvmStatic

actual typealias RuntimeJvmStatic = JvmStatic

typealias RuntimeJvmStatic = JvmStatic

Store

class Store

The runtime storage for all function, global, memory, table instances.

TableInstance

open class TableInstance(table: Table, initialValue: Int)

TagInstance

open class TagInstance(tag: TagType)

TrapException

open class TrapException(msg: String) : WasmEngineException

Wasm spec: runtime trap during execution (unreachable, OOB access, null ref, etc.).

WasmArray

class WasmArray : WasmGcRef

Runtime representation of a WasmGC array instance.

WasmException

open class WasmException(instance: Instance, tagIdx: Int, args: LongArray) : RuntimeException

WasmExecutionPolicy

sealed interface WasmExecutionPolicy

Selects one complete WebAssembly execution strategy for an Instance.

WasmExternRef

class WasmExternRef(valueValue: Long) : WasmGcRef

Wrapper for externref values converted to anyref via any.convert_extern. Prevents GC ref ID collisions between extern values and native GC objects.

WasmFunctionHandle

fun interface WasmFunctionHandle

Represents a function that can be called from Wasm.

WasmGcRef

fun interface WasmGcRef

Marker interface for WasmGC heap objects (structs and arrays).

WasmI31Ref

class WasmI31Ref(value: Int) : WasmGcRef

Boxed representation of an i31ref value for storage in int-typed containers (tables, globals). On the stack, i31 values use an efficient tagged-long encoding (see uk.shusek.krwa.wasm.types.Value.encodeI31). This class is only used when i31 values need to pass through int-typed storage where the tag would be lost.

WasmInterruptedException

open class WasmInterruptedException : WasmEngineException

Thrown when the host interrupts a running Wasm execution.

WasmJsExecution

class WasmJsExecution

class WasmJsGlobal

class WasmJsTable

class WasmJsTag

data class WasmMemoryPolicy(val maxBytesPerMemory: Long = 256L * 1024L * 1024L, val maxTotalBytes: Long = 512L * 1024L * 1024L, val maxMemories: Int = 16)

Bounds every WebAssembly memory owned by one instance.

WasmRuntimeException

open class WasmRuntimeException : WasmEngineException

Engine-specific runtime error in compiled code paths (e.g., OOB memory access).

WasmStruct

class WasmStruct(typeIdxValue: Int, fields: LongArray) : WasmGcRef

Runtime representation of a WasmGC struct instance. Fields are stored as raw long values (same encoding as stack values).

WasmtimeExecutionConfig

data class WasmtimeExecutionConfig(val target: String = WasmtimeAutomaticTarget, val precompiledModuleBytes: ByteArray? = null, val maxMemoryBytes: Long = DefaultWasmtimeMaxMemoryBytes, val maxWasmStackBytes: Long = DefaultWasmtimeMaxWasmStackBytes, val maxTableElements: Long = WasmtimeUnlimitedResourceLimit, val maxInstances: Long = DefaultWasmtimeCoreMaxInstances, val maxTables: Long = DefaultWasmtimeCoreMaxTables, val maxMemories: Long = DefaultWasmtimeCoreMaxMemories, val maxFuel: Long = WasmtimeUnlimitedResourceLimit)

WasmtimeNativeImageFeature

class WasmtimeNativeImageFeature : Feature

Native Image registrations required by the JVM Wasmtime backend.

WasmtimePreview3ComponentConfig

data class WasmtimePreview3ComponentConfig(val target: String = WasmtimeAutomaticTarget, val precompiledComponentBytes: ByteArray, val preopens: List<WasmtimePreview3Preopen>, val arguments: List<String> = emptyList(), val environment: Map<String, String> = emptyMap(), val networkPolicy: WasmtimePreview3NetworkPolicy = WasmtimePreview3NetworkPolicy(), val maxMemoryBytes: Long = DefaultWasmtimeMaxMemoryBytes, val executionTimeoutMillis: Long = 0, val maxWasmStackBytes: Long = DefaultWasmtimeMaxWasmStackBytes, val maxTableElements: Long = WasmtimeUnlimitedResourceLimit, val maxInstances: Long = WasmtimeUnlimitedResourceLimit, val maxTables: Long = WasmtimeUnlimitedResourceLimit, val maxMemories: Long = WasmtimeUnlimitedResourceLimit, val maxFuel: Long = WasmtimeUnlimitedResourceLimit)

WasmtimePreview3ExecutionCancellation

class WasmtimePreview3ExecutionCancellation : <ERROR CLASS> ERROR CLASS: Symbol not found for AutoCloseable

class WasmtimePreview3ExecutionCancellation : AutoCloseable

WasmtimePreview3HttpEndpoint

data class WasmtimePreview3HttpEndpoint(val protocol: WasmtimePreview3HttpProtocol, val host: String, val port: Int)

WasmtimePreview3HttpProtocol

enum WasmtimePreview3HttpProtocol : Enum<WasmtimePreview3HttpProtocol>

WasmtimePreview3NetworkPolicy

data class WasmtimePreview3NetworkPolicy(val httpEndpoints: List<WasmtimePreview3HttpEndpoint> = emptyList())

WasmtimePreview3Preopen

data class WasmtimePreview3Preopen(val hostRoot: String, val guestRoot: String = "/", val writable: Boolean = true)

WasmtimePulleyExecution

class WasmtimePulleyExecution : PlatformInstanceExecution

Properties

DefaultWasmtimeCoreMaxInstances

const val DefaultWasmtimeCoreMaxInstances: Long = 1

DefaultWasmtimeCoreMaxMemories

const val DefaultWasmtimeCoreMaxMemories: Long = 16

DefaultWasmtimeCoreMaxTables

const val DefaultWasmtimeCoreMaxTables: Long = 128

DefaultWasmtimeMaxMemoryBytes

const val DefaultWasmtimeMaxMemoryBytes: Long

DefaultWasmtimeMaxWasmStackBytes

const val DefaultWasmtimeMaxWasmStackBytes: Long

WasmtimeAutomaticTarget

const val WasmtimeAutomaticTarget: String

Selects the safest supported Wasmtime target for the current platform.

WasmtimeModuleCompilerBuildIdentity

const val WasmtimeModuleCompilerBuildIdentity: String

WasmtimeNativeTarget

const val WasmtimeNativeTarget: String

WasmtimePulley32Target

const val WasmtimePulley32Target: String

WasmtimePulleyTarget

const val WasmtimePulleyTarget: String

WasmtimeUnlimitedResourceLimit

const val WasmtimeUnlimitedResourceLimit: Long

Functions

apply

fun WasmFunctionHandle.apply(instance: Instance, vararg args: Long): LongArray?

availability

fun ExecutionBackend.availability(): ExecutionBackendAvailability

canonicalizeExactNetworkHost

fun canonicalizeExactNetworkHost(host: String): String

Validates and canonicalizes one exact ASCII DNS name, IPv4 literal, or IPv6 literal.

installWasmtimePulleyExecutionProviderIfAvailable

expect fun installWasmtimePulleyExecutionProviderIfAvailable()

actual fun installWasmtimePulleyExecutionProviderIfAvailable()

iosWasmtimeCompileModuleToCwasm

fun iosWasmtimeCompileModuleToCwasm(moduleBytes: ByteArray, target: String = WasmtimePulleyTarget, maxWasmStackBytes: Long = DefaultWasmtimeMaxWasmStackBytes): ByteArray

iosWasmtimeModuleCompilerIdentity

fun iosWasmtimeModuleCompilerIdentity(target: String = WasmtimePulleyTarget, maxWasmStackBytes: Long = DefaultWasmtimeMaxWasmStackBytes): String?

iosWasmtimeModuleCompilerUnavailableReason

fun iosWasmtimeModuleCompilerUnavailableReason(target: String = WasmtimePulleyTarget, maxWasmStackBytes: Long = DefaultWasmtimeMaxWasmStackBytes): String?

isAvailable

fun ExecutionBackend.isAvailable(): Boolean

readCString