Skip to main content

Build on Kaspa with AI

HardKAS is a local-first development framework, transaction planner/signer, SilverScript toolchain wrapper, and artifact verifier for Kaspa L1.

[!IMPORTANT] Kaspa L1 is a Proof-of-Work UTXO BlockDAG, NOT an EVM.

  • Do not write Solidity or EVM RPC scripts for Kaspa L1.
  • Do not write custom kaspa-wasm payment/signing scripts when a HardKAS CLI command or SDK method already implements the operation.
  • Do not treat simulated ledger runs or local silver test (SCRIPT_VM) runs as real node consensus proof.

Versions & Pinned Toolchain​

  • Repository development version: 0.13.0-rc.3 (may be ahead of npm latest; check npm view @hardkas/cli dist-tags and use npx @hardkas/cli@latest when installing from npm outside the monorepo)
  • Localnet node (--profile toccata-v2): rusty-kaspad v2.1.0 (container hardkas-kaspad-toccata-v2, JSON wRPC port 18210; custom Docker setups may publish another port such as 26510)
  • SilverScript compiler: silverc v1.0.0 (installed via hardkas toolchain install silverc)
  • Node.js requirement: 24.22.1

What HardKAS Does (and Does Not Do)​

AreaStatus in this releaseNotes for agents
Payments (tx plan, tx sign, tx send, tx wait, tx status)Verified on simnetUses upstream kaspa-wasm Generator; supports Schnorr & ECDSA, CLTV (--lock-time-daa / --lock-time-ms), and multi-recipient batches.
SilverScript P2SH (silver compile, verify, deploy, spend)Verified on simnetCompiles .sil with pinned silverc v1.0.0, deploys and spends v0 P2SH contracts.
Toccata 1:1 Covenants (silver covenant genesis, transition, inspect)Verified on simnetReal v1 transactions on rusty-kaspad v2.1.0 with covenant_id lineage checks.
Artifact & Receipt Verification (artifact inspect, artifact verify, tx receipt)VerifiedIntegrity check works offline on all networks; network & consensus checks query a real node of the artifact's network.
silver covenant start|advance (1:N, N:M), kcc20, silver test --on-node, zk toccata spend, testnet-10ExperimentalExplicitly opt-in or experimental; do not present them as stable.
silver test, silver debug, silver preflight (local runner)Unverified (SCRIPT_VM)Requires --allow-unverified-runner with a local build; never independent consensus proof. Use --on-node or real node spends for consensus checks.
mainnet (reads, signing, broadcast)Blocked by policyRefused before any network connection (MAINNET_CONNECTION_DISABLED, MAINNET_SIGNING_DISABLED, MAINNET_BROADCAST_DISABLED).
vProgs, trustless bridges, @hardkas/l2, @hardkas/pskt-nativeNot supported / Not publishedOnly offline artifact inspection for vProgs; do not invent bridge or L2 commands.

Environment Matrix​

Environmentnetwork flagNode requiredConsensus proof?Typical use
In-memory ledgersimulatedNoNo (synthetic UTXOs, no script VM)Fast local loop, replay verify
Managed or custom simnetsimnetYes (rusty-kaspad 2.1.0)Yes (local node consensus)Payments, SilverScript P2SH, Toccata v1 covenants
Public Testnet-10testnet-10Yes (opt-in)Yes (experimental)Public test funds only (experimental: true, allowPublic: true)
MainnetmainnetRefusedOffline artifact verify onlyBlocked for RPC, signing, and broadcast

First Checks Before Running Tasks​

Run these machine-readable checks first so you never assume unavailable features:

hardkas doctor --json
hardkas silver doctor --network simnet --json

In TypeScript SDK code, call sdk.capabilities.get() before invoking optional or experimental namespaces.

Canonical Entry Points​