Install
Create a client
X-Request-Id automatically.
Authentication
Ed25519 (backend services)
OTP (user sign-in)
Making API calls
Typed sub-clients are available via the facade:Error handling
The SDK returns typed*zeam.Error values with classified kinds:
Configuration options
| Option | Description |
|---|---|
WithEnvironment(env) | Target endpoint. Use EnvironmentProduction for all API access. EnvironmentCustom(url) for local development only. Access mode is determined by credentials, not by this setting. |
WithTokenStore(store) | Token persistence backend (default: in-memory) |
WithTimeout(d) | Per-call deadline (default: 30s) |
WithLogger(logger) | Structured logger (receives redacted payloads only) |
WithObservability(hook) | OpenTelemetry event hook |
WithInsecureTransport() | Allow plain HTTP (local dev only) |
WithPinnedRootCAs(pool) | Pin TLS root certificates |
WithStellarNetwork(passphrase) | Override network passphrase (default: Public Main) |
WithSkipVersionCheck() | Disable /healthz version handshake |
Version compatibility
The SDK performs a runtime handshake against/healthz to verify gateway compatibility. If the gateway is older than zeam.MinGatewayVersion, the SDK returns zeam.ErrIncompatibleGateway immediately.
Repository
Full source, examples, and detailed documentation:github.com/ZeamMoney/zeam-sdk-go
See SDK recipes for complete workflow examples.
