Solana Client Zig

Zig-based Solana RPC/WebSocket client. Exposes the solana_client module for RPC, PubSub, and transaction helpers built on top of solana-sdk-zig.

Requirements

• Zig 0.15.2 (matches CI)
• For integration tests: a local Solana validator (e.g., surfpool start --no-tui or solana-test-validator) reachable at http://127.0.0.1:8899.

Dependency note

• solana_sdk is pulled from the remote tarball at commit 18974325397deef61bc07992b69d7cab18180354 of DaviRain-Su/solana-sdk-zig (configured in build.zig.zon).

Common tasks

• Format: zig fmt --check build.zig src integration
• Unit tests: zig build test --summary all
• Integration tests (require local validator):
  1. Start validator: surfpool start --no-tui (or solana-test-validator)
  2. Run: zig build integration-test --summary all

CI overview

GitHub Actions workflow (.github/workflows/ci.yml):

• Format Check (Ubuntu): zig fmt --check build.zig src integration
• Unit Tests (Ubuntu & macOS): zig build test --summary all
• RPC Integration Tests (Ubuntu): installs Surfpool, waits for health, then zig build integration-test --summary all

Module usage

Add to your Zig project and import:

const client = @import("solana_client");

Refer to src/ for available APIs (RPC client, transactions, pubsub, etc.).