ksp connect
ksp connect
Command ReferenceOpen an interactive client session to a remote KSP server with full cryptographic handshake negotiation.
Networking & Diagnostics
Purpose
Open an interactive client session to a remote KSP server with full cryptographic handshake negotiation.
Syntax
Command-line specificationbash / powershell
ksp connect <SERVER_URI> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <SERVER_URI> | Target server address (e.g., `127.0.0.1:9876` or `ksp://api.kspprotocol.dev:9876`). |
Options & Flags
| Option Flag | Description |
|---|---|
| --insecure | Skip certificate signature verification (use ONLY for local debugging). |
| --cipher <NAME> | Force specific AEAD cipher: `aes-256-gcm` or `chacha20-poly1305`. |
| --stream <ID> | Automatically open stream ID upon session establishment. |
Example Usage
Example command
ksp connect 127.0.0.1:9876 --cipher chacha20-poly1305
Expected Output
[+] Initiating TCP connection to 127.0.0.1:9876... [+] Sending ClientHello (Random: 0x8A9D... | X25519 Ephemeral Key) [+] Received ServerHello + Certificate (Subject: localhost) [✔] Certificate verified via local root anchor! [✔] Session Established! SessionID: 0x4B9E3A... | Cipher: ChaCha20-Poly1305 ksp-session(0x4B9E)> _
Implementation Notes
Enters an interactive REPL command prompt once authenticated where you can type commands like `open`, `send`, `streams`, or `exit`.