# HardKAS — Developer Framework & Transaction Simulator for Kaspa L1 > HardKAS is an open-source, local-first development framework, transaction simulator, and visual IDE for Kaspa L1. > Inspired by the ergonomics of Ethereum tools (Hardhat, Foundry), built from first principles for Kaspa's UTXO BlockDAG. ## Core Truth & Boundaries - Kaspa L1 is a Proof-of-Work UTXO BlockDAG running Kaspa Script (NOT an EVM, no Solidity on L1). - Versions: repository development tree is `0.13.0-rc.3` (may be ahead of npm `latest`; check `npm view @hardkas/cli dist-tags`). - Managed Docker simnet (`--profile toccata-v2`) runs `rusty-kaspad` `v2.1.0` (container `hardkas-kaspad-toccata-v2`, JSON wRPC `ws://127.0.0.1:18210`). - Mainnet is blocked by policy (no reads, signing, or broadcast). - `simulated` and local `silver test` (`SCRIPT_VM`) are NOT independent consensus proof; use `simnet` for real-node verification. - Prefer HardKAS CLI/SDK over custom `kaspa-wasm` scripts for payments, keystores, SilverScript, and artifact verification. ## Token-Saving Reading Rule for Agents - For a standard KAS payment on `simnet`, use the **Fast Path** below directly — do **not** read `llms-full.txt` (23 KB) and do **not** run `doctor`/`silver doctor` first. - Only read a specific recipe anchor or `https://hardkas.dev/llms-full.txt` when you need SilverScript, Toccata covenants, artifact verification, or error codes: - Send KAS: https://hardkas.dev/docs/ai/workflows#1-send-kas-on-simnet-and-confirm-the-transaction - SilverScript P2SH: https://hardkas.dev/docs/ai/workflows#2-compile-and-execute-silverscript-p2sh-workflows - Covenants (valid & invalid): https://hardkas.dev/docs/ai/workflows#3-perform-valid-and-invalid-covenant-transitions-against-a-real-node - Verify receipts: https://hardkas.dev/docs/ai/workflows#4-verify-transaction-receipts-and-execution-artifacts - Diagnose node/UTXOs: https://hardkas.dev/docs/ai/workflows#5-diagnose-node-rpc-account-and-utxo-problems - CLI vs SDK: https://hardkas.dev/docs/ai/workflows#6-select-the-appropriate-hardkas-cli-or-sdk-workflow - Full AI Reference (all above combined): https://hardkas.dev/llms-full.txt ## Fast Path: Send KAS on Simnet (2 commands, no config file needed) - Omit `--url` if using the default HardKAS localnet (`ws://127.0.0.1:18210`). `--wait` waits until `CONFIRMED` on the same node (default `--wait-timeout 60`; on timeout it exits `1` with `code: TX_SEND_WAIT_FAILED` and `outcome: submitted`). ```bash export HARDKAS_PASSWORD='choose-a-simnet-password' hardkas accounts real import --name payer --address --network simnet --private-key-env PK --password-env HARDKAS_PASSWORD && \ hardkas tx send --from payer --to --amount 10 --network simnet --url ws://:18210 --password-env HARDKAS_PASSWORD --yes --wait --json ``` ## Canonical Web Endpoints - Homepage: https://hardkas.dev/ - HardKAS IDE: https://hardkas.dev/ide/ - Documentation Base: https://hardkas.dev/docs/ - Build on Kaspa with AI: https://hardkas.dev/docs/ai/ - Canonical AI Workflows (6 tasks): https://hardkas.dev/docs/ai/workflows - AI Troubleshooting & Error Codes: https://hardkas.dev/docs/ai/troubleshooting - Claude Code & Cursor Guide: https://hardkas.dev/docs/ai/claude-code-and-cursor - 5-Minute Quickstart: https://hardkas.dev/docs/getting-started/quickstart - CLI Command Reference: https://hardkas.dev/docs/reference/cli - SDK Core Reference: https://hardkas.dev/docs/reference/sdk/core/ ## First Checks (for SilverScript, Covenants, or Debugging) ```bash hardkas doctor --json hardkas silver doctor --network simnet --json ```