Documentation Index
Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
Use this file to discover all available pages before exploring further.
Self-orchestrated direct-to-chain operations (uses @kashdao/protocol-sdk). Like the default Kash-orchestrated mode, this path is non-custodial — the difference is who builds and submits trades.
Generated from kash docs --json. Each command’s behaviour is documented in-binary via kash protocol <subcommand> --help — this page is the structured reference.
Usage
kash protocol <subcommand> [options]
Subcommands
kash protocol balance
Read on-chain USDC + gas balance for a smart account (defaults to the profile’s).
Arguments
account (optional) — smart-account address (defaults to the active profile’s smartAccount)
kash protocol market
Read on-chain market state (reserves, supplies, weights, derived probabilities).
Arguments
address — market contract address (0x-prefixed)
kash protocol quote
On-chain price quote for buying or selling an outcome.
Arguments
address — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-s, --side <buy|sell> | trade side: buy or sell |
-o, --outcome <index> | outcome index (0-based) |
-a, --amount <decimal> | amount: USDC decimal for buy (e.g. “10”), outcome-token decimal for sell (e.g. “1.5”) |
kash protocol position
Read on-chain outcome-token holdings (ERC-1155) for a market.
Arguments
market — market contract address (0x-prefixed)account (optional) — EOA or smart-account address whose holdings to read (default: profile’s smartAccount)
kash protocol allowance
Read the on-chain USDC allowance from account to spender.
Arguments
spender — spender contract address (e.g. a market) — 0x-prefixedaccount (optional) — owner address (default: profile’s smartAccount)
kash protocol smart-account
Smart-account address derivation and deployment-status checks.
kash protocol smart-account compute
Derive the deterministic smart-account address for an EOA owner.
Options
| Flag | Description |
|---|
-o, --owner <address> | EOA owner address (0x-prefixed) |
-s, --salt <n> | optional salt as a non-negative integer (default 0) |
kash protocol smart-account is-deployed
Check whether a smart account has bytecode (i.e. has been deployed on-chain).
Arguments
address (optional) — smart account address (default: profile’s smartAccount)
kash protocol fees
EIP-1559 fee estimate for the configured chain (uses eth_feeHistory).
Options
| Flag | Description |
|---|
--blocks <n> | number of recent blocks to sample (default 4) |
--percentile <n> | priority-fee percentile to take from each sampled block (1-99, default 50) |
--base-multiplier <n> | multiplier applied to predicted next-block base fee (default 2.0; raise for congested chains) |
--priority-floor-gwei <n> | floor for maxPriorityFeePerGas in gwei (default 1) |
kash protocol token-id
Compute the ERC-1155 token id for a (marketId, outcomeIndex) pair (offline; no RPC).
Options
| Flag | Description |
|---|
-m, --market-id <bigint> | on-chain numeric market id (decimal or 0x-prefixed hex) |
-o, --outcome <index> | outcome index (0-255) |
kash protocol decode-revert
Decode raw revert data into (name, args) using the Market + EntryPoint ABIs.
Arguments
data — raw revert data (0x-prefixed hex)
kash protocol trade
Direct-mode trade execution (UserOp signed locally, submitted via bundler).
kash protocol trade buy
One-shot BUY: prepare → simulate → sign → submit (and wait by default).
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-a, --amount <usdc> | USDC to spend (decimal — e.g. “10” or “12.50”) |
--slippage-bps <n> | slippage tolerance in basis points (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--dry-run | prepare + simulate but DO NOT sign or submit; print the UserOp |
--no-simulate | skip the eth_call preflight (faster, riskier) |
--no-wait | fire-and-forget: return userOpHash without waiting for inclusion |
--wait-timeout-ms <n> | cap on the receipt wait (default 60000) |
--wait-interval-ms <n> | receipt poll interval (default 1500) |
kash protocol trade sell
One-shot SELL: prepare → simulate → sign → submit (and wait by default).
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-t, --tokens <amount> | outcome tokens to sell (decimal — WAD precision) |
--slippage-bps <n> | slippage tolerance in basis points (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--dry-run | prepare + simulate but DO NOT sign or submit; print the UserOp |
--no-simulate | skip the eth_call preflight (faster, riskier) |
--no-wait | fire-and-forget: return userOpHash without waiting for inclusion |
--wait-timeout-ms <n> | cap on the receipt wait (default 60000) |
--wait-interval-ms <n> | receipt poll interval (default 1500) |
kash protocol trade close
Sell the entire SA balance for an outcome (one-shot prepare → submit).
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
--slippage-bps <n> | slippage tolerance in basis points (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--dry-run | prepare + simulate but DO NOT sign or submit; print the UserOp |
--no-simulate | skip the eth_call preflight (faster, riskier) |
--no-wait | fire-and-forget: return userOpHash without waiting for inclusion |
--wait-timeout-ms <n> | cap on the receipt wait (default 60000) |
--wait-interval-ms <n> | receipt poll interval (default 1500) |
kash protocol trade approve
USDC approval — required once before the first BUY.
Arguments
spender — spender contract address (typically a Market) — 0x-prefixed
Options
| Flag | Description |
|---|
-a, --amount <usdc> | atomic-USDC amount to approve (decimal); default is unlimited (MAX_UINT256) |
--dry-run | prepare + simulate but DO NOT sign or submit; print the UserOp |
--no-simulate | skip the eth_call preflight (faster, riskier) |
--no-wait | fire-and-forget: return userOpHash without waiting for inclusion |
--wait-timeout-ms <n> | cap on the receipt wait (default 60000) |
--wait-interval-ms <n> | receipt poll interval (default 1500) |
kash protocol userop
Granular UserOp lifecycle: build, simulate, submit, hash, receipt, wait.
kash protocol userop build
Build (prepare) a fully-populated unsigned UserOp ready for offline signing.
kash protocol userop build buy
Build a fully-populated unsigned BUY UserOp ready for offline signing.
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-a, --amount <usdc> | USDC to spend (decimal) |
--slippage-bps <n> | slippage tolerance in bps (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--out <path> | write the UserOp envelope to a file (default stdout) |
--no-simulate | skip eth_call preflight in prepare |
kash protocol userop build sell
Build a fully-populated unsigned SELL UserOp ready for offline signing.
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-t, --tokens <amount> | outcome tokens to sell (WAD decimal) |
--slippage-bps <n> | slippage tolerance in bps (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--out <path> | write the UserOp envelope to a file (default stdout) |
--no-simulate | skip eth_call preflight in prepare |
kash protocol userop build close
Build a fully-populated unsigned UserOp that closes a position (full balance).
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
--slippage-bps <n> | slippage tolerance in bps (default 50 = 0.5%) |
--deadline-sec <n> | unix-seconds deadline (default now + 5min) |
--out <path> | write the UserOp envelope to a file (default stdout) |
--no-simulate | skip eth_call preflight in prepare |
kash protocol userop build approve
Build a fully-populated unsigned approve UserOp ready for offline signing.
Arguments
spender — spender contract address (typically a Market) — 0x-prefixed
Options
| Flag | Description |
|---|
-a, --amount <usdc> | atomic-USDC amount (decimal); default unlimited (MAX_UINT256) |
--out <path> | write the UserOp envelope to a file (default stdout) |
--no-simulate | skip eth_call preflight in prepare |
kash protocol userop simulate
Simulate (eth_call) an UnsignedUserOp from a file or stdin.
Arguments
file (optional) — path to a UserOp JSON file (omit or pass ”-” for stdin)
kash protocol userop submit
Submit a SignedUserOp from a file or stdin to the configured bundler.
Arguments
file (optional) — path to a SignedUserOp JSON file (omit or pass ”-” for stdin)
Options
| Flag | Description |
|---|
--skip-staleness-check | bypass the EIP-191 staleness check (for typed-data signers) |
--wait | wait for receipt after submitting |
--wait-timeout-ms <n> | cap on the receipt wait (default 60000) |
--wait-interval-ms <n> | receipt poll interval (default 1500) |
kash protocol userop hash
Recompute the canonical EIP-4337 v0.7 hash for a UnsignedUserOp.
Arguments
file (optional) — path to a UserOp JSON file (omit or pass ”-” for stdin)
kash protocol userop receipt
Fetch the bundler receipt for a UserOp hash (null if not yet included).
Arguments
hash — UserOp hash (0x-prefixed, 32 bytes)
kash protocol userop wait
Wait for a UserOp to be included; polls with exponential backoff.
Arguments
hash — UserOp hash (0x-prefixed, 32 bytes)
Options
| Flag | Description |
|---|
--wait-timeout-ms, --timeout-ms <n> | total time budget across polls (default 60000) — distinct from the global —timeout-ms (per-HTTP-request) |
--interval-ms <n> | poll interval (default 1500) |
kash protocol watch
Subscribe to on-chain trade events for a market (NDJSON stream).
Arguments
market — market contract address (0x-prefixed)
Options
| Flag | Description |
|---|
--max-events <n> | exit cleanly after observing N events |
--timeout-ms <n> | exit cleanly after this wall-clock budget (ms) |
