Skip to content

Kernel Package v0

Jump to bottom
grysz edited this page Jun 5, 2026 · 1 revision

Kernel Package v0

kaspascript kernel package <contract.ks> emits one JSON object combining the compiler artifact with KaspaScript kernel metadata.

Root Fields

{
  "schema_version": "kaspascript.kernel.package.v0",
  "package_target": "verified-tn12",
  "source_snapshots": [],
  "artifact": {},
  "bytecode_hex": "...",
  "bytecode_asm": "...",
  "kernel": {},
  "fee_estimate": {}
}

Kernel Object

The kernel object includes:

  • schema_version
  • blueprint
  • readiness
  • capabilities
  • wallet_previews
  • indexer_schema
  • fee_policy

Readiness Levels

Readiness is serialized as lowercase v0 labels:

  • verified
  • preview
  • blocked

future-mainnet remains blocked until mainnet activation evidence exists for the required features.

Source Snapshots

The package currently pins Rusty Kaspa source snapshots for:

  • v1.3.0-toc.5
  • tn10-toc3

These are evidence metadata, not a replacement for node or consensus validation.

Golden Snapshots

The repo golden-tests kernel package output for:

  • tests/contracts/escrow.ks
  • tests/contracts/vault.ks

Snapshots live in:

  • tests/golden/escrow.kernel.json
  • tests/golden/vault.kernel.json

Full schema reference:

https://github.com/gryszzz/Kaspa-Script/blob/main/docs/KERNEL_PACKAGE_SCHEMA.md

Clone this wiki locally