kraken-shared

name	kraken-shared
version	1.0.0
description	Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.
metadata	{"openclaw":{"category":"finance"},"requires":{"bins":["kraken"]}}

kraken-shared

This tool is experimental. Commands execute real financial transactions on the Kraken exchange. Test with kraken paper before using real funds. See DISCLAIMER.md for full terms.

Invocation Contract

Always call:

kraken <command> [args...] -o json 2>/dev/null

Rules:

• Parse stdout only.
• Treat stderr as diagnostics.
• Exit code 0 means success.
• Non-zero exit means failure with JSON envelope in stdout.
• Streaming commands (session start, record, ws, streamd) emit JSONL: match lines by their "type" field (e.g. scan for "type":"session_started" to get the session handle) — never assume a line position, because live market frames interleave on stdout.
• Probe capability, not version, at the start of a loop: exits on a build that speaks this contract and on an older one — cannot tell them apart across a vocabulary change.