WickraTerminal 0.1.7

<p align="center"> <a href="https://wickra.org"><img src="https://raw.githubusercontent.com/wickra-lib/.github/main/profile/wickra-banner.webp?v=514-7" alt="Wickra Terminal — the data-driven streaming trading terminal: one core in ten languages, a native TUI and a Web renderer" width="100%"></a> </p>

Wickra Terminal — C#

▶ Live demo: the Wickra library's own 514 indicators over real Binance market data, computed live in your browser — live.wickra.org · zero backend, powered by wickra-wasm.

One core. Ten languages. Two renderers — for C#. dotnet add package WickraTerminal — prebuilt native library, no system dependencies.

.NET bindings for the wickra-terminal data-driven core, over the Wickra C ABI hub via P/Invoke. Build a Terminal from a JSON config, drive it with command JSON, read back frame view-models — the same protocol as the native TUI and every other binding.

Install

dotnet add package WickraTerminal

The native library ships prebuilt per platform under runtimes/<rid>/native/, selected automatically. There is nothing to compile. Targets .NET 8 and later.

Requirements

• .NET 8.0 or newer
• The native wickra_terminal library on the loader path (the package ships it; a source build stages it, see below)

Building from this repository (contributors)

cargo build -p wickra-terminal-c            # produces the native wickra_terminal library
dotnet test bindings/csharp/WickraTerminal.Tests
dotnet run --project examples/csharp        # the runnable example

Both the test project and the example copy the native library next to their output so the default P/Invoke resolver finds it, on Windows, Linux and macOS.

Quick start

using WickraTerminal;

using var term = new Terminal(
    "{\"sources\":[{\"Synth\":{\"seed\":1}}]," +
    "\"layout\":{\"panels\":[{\"kind\":\"Chart\",\"rect\":{\"x\":0,\"y\":0,\"w\":100,\"h\":100}}]}}");

term.Command("{\"type\":\"Subscribe\",\"source\":0,\"symbol\":\"BTC/USDT\"}");
string frame = term.Command("{\"type\":\"Tick\"}");
Console.WriteLine(frame);
Console.WriteLine(Terminal.Version());

API

Terminal implements IDisposable and carries a finaliser, so using is the intended form but a dropped handle is still reclaimed.

The command protocol

Every binding drives the same nineteen commands, and the frame that comes back is the same JSON in all of them:

ListIndicators is the one command that answers rather than renders, and each row carries needs_reference, which marks the pairwise indicators that compare two markets and so require a reference symbol in their spec. A row for one of the two friendly aliases also carries alias_of naming the canonical kind it builds, so Macd and MacdIndicator read as one indicator rather than two.

A frame is {"panels": [...]}, one entry per configured panel, each tagged with its panel kind — chart, book, tape, watchlist, footprint, profile, bars. See docs/ for the panel and source references.

Cross-language equality

The same config and the same command sequence produce a byte-identical frame in Rust, Python, Node.js, WASM, C, C++, C#, Go, Java and R. That is not an aspiration: golden/ holds a recorded feed and the expected frame, and every binding's test suite asserts its own output against that one file.

Benchmark

benchmarks/ reports this binding's throughput over the shared core. It measures the call overhead of [LibraryImport] P/Invoke over the C ABI, not a cross-library ratio (the same Rust core runs under every binding) — see the repository BENCHMARKS.md for the numbers, the machine and how each harness is run.

Documentation

The full guide, the spec reference and the API documentation live in the main repository and the documentation site:

• Repository: https://github.com/wickra-lib/wickra-terminal

• Docs (guides, spec reference, cookbook): https://terminal.wickra.org

• Runnable example: examples/csharp/

• Repository: https://github.com/wickra-lib/wickra-terminal

• Panels, sources, renderers, streaming: docs/

• Cookbook: docs/Cookbook.md

• Built on Wickra: https://github.com/wickra-lib/wickra · https://docs.wickra.org

Wickra Terminal ships native bindings for Python, Node.js, WASM and Rust, plus a C ABI hub that any C-capable language (C, C++, C#, Go, Java, R) links against — all forwarding to the same data-driven, unsafe-forbidden Rust core.

Security

Found a security issue? Please don't open a public issue. Report it privately via the repository's Security tab ("Report a vulnerability") or email support@wickra.org with a subject line starting [wickra security]. Full policy: https://github.com/wickra-lib/wickra-terminal/blob/main/SECURITY.md.

Disclaimer

This software is provided "as is", without warranty of any kind. It is a research and engineering tool, not financial advice. Trading carries risk of loss. Run in paper mode and against exchange testnets, and review the code before risking real capital.

License

Licensed under either of Apache-2.0 or MIT at your option.