@kashscript/kstack

kash — universal CLI for the KashScript Foundry. Manage identities, mint trades, run Neuron operations, deploy contracts — all from one binary.

# zero-install
npx @kashscript/kstack --help

# or install globally
bun add -g @kashscript/kstack
npm install -g @kashscript/kstack

Runs under Node 18+, Bun 1+, Deno, and any npx-compatible runner.

Command surface

kash identity   <subcommand>   Create / inspect / manage did:kash identities
kash trade      <subcommand>   Hydrate manifests, deploy clones, sign signals
kash neuron     <subcommand>   Run agentic operations, replay traces, audit ledgers
kash auth       <subcommand>   Sign in / out of the Kash-Registry license server

Each top-level command has its own --help with full flag listings.

Highlights

Identity

kash identity create --handle alice
kash identity show
kash identity export-mnemonic   # for backup

Trade

# First-time install of the suite onto a chain
kash trade forge-deploy --chain 8453 --key 0x… [--paymaster --entry-point 0x…]

# Deploy an individual trade from a manifest
kash trade deploy --manifest ./otdc.json --chain 8453 --factory 0x…

# Watch a trade's FSM live
kash trade status --address 0x… --chain 8453 --watch

# Sign an EIP-712 settle / revert / dispute signal locally
kash trade sign --address 0x… --action settle --chain 8453 --private-key 0x…

Neuron

kash neuron status                    # ledger health snapshot
kash neuron audit --since 24h         # audit-trail extract
kash neuron oreoasis-status           # Oreoasis prototype dashboard

Auth

kash login                            # signed-challenge flow → Access Token
kash logout
kash whoami

Library mode

Every command body is exported from a library subpath so you can wrap them in your own CLI or CI runner:

import { deployCommand } from "@kashscript/trade-sdk/cli";
import { signCommand }   from "@kashscript/trade-sdk/cli";

await deployCommand({ /* fully typed opts */ });

The umbrella kash binary is a thin commander shell over these typed bodies — bring your own argument parser if you'd rather.

License

Apache-2.0. Also covered by SSLA v1.0 Schedule A (Permissive). See LICENSE.