Skip to main content

hardkas tx

hardkas tx profile​

Synopsis (Generated)​

Purpose: Show detailed mass and fee breakdown for a transaction plan stable

Arguments​

  • <path> (Required):

Options​

  • --json (Default: false): Output as JSON

hardkas tx batch​

Synopsis (Generated)​

Purpose: Process a batch of transactions sequentially stable

Options​

  • --file <path>: Path to JSON file containing batch payments
  • --network <name>: Network name
  • --workspace <path>: Override workspace root directory
  • --json (Default: false): Output as JSON

hardkas tx plan​

Synopsis (Generated)​

Purpose: Build a transaction plan artifact stable

Arguments​

  • <from> (Optional):
  • <to> (Optional):

Options​

  • --target <name>: Named execution target from hardkas.config.ts
  • --from <accountOrAddress>: Sender account name or address (default: alice)
  • --to <address>: Recipient address or account name (default: bob)
  • --amount <kas>: Amount in KAS, up to 8 decimals (default: 1)
  • --network <name>: simulated, simnet, devnet, testnet-10, testnet-12 or mainnet (default: the config's default target)
  • --fee-rate <sompiPerMass>: Whole sompi per gram of mass (default: 1 in the simulator, 100 on real networks; not a live estimate)
  • --change <accountOrAddress>: Change destination (account name or address); default: the sender
  • --provider <type> (Default: auto): Provider mode (auto, rpc, simulated)
  • --url <url>: Node wRPC URL (default: ws://127.0.0.1:18210 for simnet and devnet; the config's rpcUrl is not used)
  • --out <path>: Save plan as artifact JSON
  • --save <path>: Alias for --out (Save plan as artifact JSON)
  • --workflow-id <id>: Optional deterministic workflow ID override
  • --assumption-level <level>: Optional assumption level override
  • --wait-lock (Default: false): No effect, kept for compatibility: the command takes no lock of its own, and each store write waits for the store (up to 30 s)
  • --lock-timeout <ms> (Default: 30000): No effect, kept for compatibility (see --wait-lock)
  • --json (Default: false): Output as JSON

Semantic Contract (Curated)​

  • Environments: Simulator, Localnet, RPC
  • Reads: Workspace config, Kaspa node RPC (for real-node path)
  • Writes: TxPlanArtifact json file
  • Produces: TxPlanArtifact
  • Accepted Identifiers:
  • Evidence Semantics: Proves that a geometrically valid, fee-paying transaction was possible using available UTXOs at a specific virtualDaaScore.
  • Planner Path: The kaspa-wasm Generator on every path: a real node (KASPA_WASM_GENERATOR) and the simulator (SYNTHETIC_SIMULATOR, over its identities).

Known Limitations​

  • A payment that needs more than one transaction is refused (MULTI_TRANSACTION_PLAN_REQUIRED): consolidate the UTXOs first.
  • Concept: /concepts/transactions/planning.md
  • Concept: /concepts/transactions/utxos.md
  • Guide: /guides/transactions/create-a-transaction.md

hardkas tx sign​

Synopsis (Generated)​

Purpose: Sign a transaction plan artifact stable

Arguments​

  • <planPath> (Required):

Options​

  • --account <name>: Account name to sign with
  • --out <path>: Save signed artifact JSON
  • --fixture (Default: false): Sign with the built-in fixture test key (any network except mainnet)
  • --allow-mainnet-signing (Default: false): Mainnet signing stays refused in this release (MAINNET_SIGNING_DISABLED); the flag has no effect
  • --threshold <number>: Synthetic multisig threshold for tests (no Kaspa multisig script is produced)
  • --required-signers <list>: Comma-separated signers, no spaces (with --threshold above 1)
  • --append (Default: false): Append signature to a partially signed transaction
  • --target <name>: Named execution target from hardkas.config.ts
  • --password-env <env>: Read the encrypted account's keystore password from this environment variable
  • --password-stdin (Default: false): Read the encrypted account's keystore password from stdin
  • --wait-lock (Default: false): No effect, kept for compatibility: the command takes no lock of its own, and each store write waits for the store (up to 30 s)
  • --lock-timeout <ms> (Default: 30000): No effect, kept for compatibility (see --wait-lock)
  • --json (Default: false): Output as JSON

Semantic Contract (Curated)​

  • Environments: Simulator, Localnet, RPC
  • Reads: TxPlanArtifact, Local private keys / deterministic simulator keys
  • Writes: SignedTxArtifact json file
  • Produces: SignedTxArtifact
  • Accepted Identifiers: filepath, canonical artifactId
  • ⚠️ Side Effects: Cryptographic signing operations
  • Evidence Semantics: Proves authorization. Cryptographically asserts that the holder of the private keys approved the exact geometric bounds in the plan.
  • Concept: /concepts/transactions/signing.md
  • Guide: /guides/transactions/sign-a-transaction.md

hardkas tx status​

Synopsis (Generated)​

Purpose: Show the derived state of a txId (SUBMITTED, MEMPOOL_ACCEPTED, ACCEPTED, CONFIRMED, FINALIZED, REORGED, …) from the workspace evidence plus one new observation, or the signature coverage of a plan/signed artifact path

Arguments​

  • <txIdOrPath> (Required):

Options​

  • --no-observe: Derive from the evidence already in the workspace; take no new observation
  • -n, --network <network>: Network whose configured node observes (default: the network of the recorded submission)
  • --json (Default: false): Output as JSON

hardkas tx send​

Synopsis (Generated)​

Purpose: Broadcast a signed transaction or send directly stable

Arguments​

  • <signedPath> (Optional):

Options​

  • --target <name>: Named execution target from hardkas.config.ts (signed-artifact mode: it must match the artifact and never redirects the send)
  • --from <accountOrAddress>: Sender (shortcut mode)
  • --to <address>: Recipient (shortcut mode)
  • --amount <kas>: Amount in KAS (shortcut mode)
  • --network <name>: Network name
  • --fee-rate <sompiPerMass>: Fee rate in sompi per mass (shortcut mode)
  • --provider <type> (Default: auto): Provider mode (auto, rpc, simulated; signed-artifact mode only)
  • --url <url>: RPC URL (optional override)
  • --yes (Default: false): Confirm broadcast. Required unless the network is simulated or simnet (in shortcut mode, unless --network simulated or simnet is given): without it the send is refused (NOT EXECUTED, exit 3) and nothing is written
  • --wait-lock (Default: false): No effect, kept for compatibility: the command takes no lock of its own, and each store write waits for the store (up to 30 s)
  • --lock-timeout <ms> (Default: 30000): No effect, kept for compatibility (see --wait-lock)
  • --json (Default: false): Output as JSON
  • --track <label>: Signed-artifact mode: after an accepted broadcast, record a deployment with this label

Semantic Contract (Curated)​

  • Environments: Simulator, Localnet, RPC
  • Reads: SignedTxArtifact
  • Writes: TxReceiptArtifact json file
  • Produces: TxReceiptArtifact
  • Accepted Identifiers: filepath, canonical artifactId
  • ⚠️ Side Effects: Submits transaction to network mempool or mutates local simulator state.
  • Evidence Semantics: Proves submission acceptance by the target environment (mempool inclusion or simulator mutation). DOES NOT prove finality.

Known Limitations​

  • The printed next steps name the receipt's canonical artifactId (hardkas explain <artifactId>); the txId is reported as txId and is looked up with --tx.
  • Concept: /concepts/transactions/submission.md
  • Guide: /guides/transactions/submit-a-transaction.md

hardkas tx receipt​

Synopsis (Generated)​

Purpose: Show transaction receipt stable

Arguments​

  • &lt;txId&gt; (Required):

Options​

  • --json (Default: false): Output as JSON

hardkas tx wait​

Synopsis (Generated)​

Purpose: Wait until the derived state of a txId reaches ACCEPTED or CONFIRMED (blue-score depth ≥ the HardKAS policy), observing the configured node, then until that node's UTXO view reflects it stable

Arguments​

  • &lt;txId&gt; (Required):

Options​

  • --until &lt;target&gt; (Default: confirmed): accepted or confirmed
  • --timeout &lt;seconds&gt; (Default: 60): Timeout in seconds
  • --interval &lt;seconds&gt; (Default: 2): Seconds between observations
  • -n, --network &lt;network&gt;: Network whose configured node observes (default: the network of the recorded submission)
  • --json (Default: false): Output as JSON

hardkas tx verify​

Synopsis (Generated)​

Purpose: Perform deep semantic verification of a transaction plan preview

Arguments​

  • &lt;path&gt; (Required):

Options​

  • --json (Default: false): Output as JSON

hardkas tx compare​

Synopsis (Generated)​

Purpose: Compare simulated vs real receipts for fidelity stable

Arguments​

  • &lt;simulatedPath&gt; (Required):
  • &lt;realPath&gt; (Required):