Install the package
GOPRIVATE='github.com/Fabric-Labs/*'
GONOSUMDB='github.com/Fabric-Labs/*'
go get github.com/Fabric-Labs/polyester-sdk-go@v0.1.0a35Requires a recent Go toolchain (see go.mod in the repository). Realtime and on-chain Funding helpers are always included.
The source repository is currently private. Your GitHub account needs access, and Git must be
authenticated (credential helper, SSH rewrite, or CI token). GOPRIVATE / GONOSUMDB prevent
the Go proxy and checksum database from treating the private module as public.
Source (access required): Fabric-Labs/polyester-sdk-go.
@latest.
Version v0.1.0a35 is the current API-key-only release. It supports signed unary calls, binary
realtime subscriptions with handshake-before-return, and opaque pagination tokens for complete
trigger list/event scans. Breaking public API changes are called out in the repository changelog.Default endpoints
With no override, the client targets Polyester testnet / devnet:
| Setting | Default |
|---|---|
| API | https://api-devnet.polyester.ai |
| WebSocket | wss://api-devnet.polyester.ai |
Override with Config.APIURL / Config.WSURL. FromEnv does not load those URL env vars.
Verify the install
Public market data needs no credentials:
client, err := polyester.New(polyester.Config{})
if err != nil { log.Fatal(err) }
defer client.Close()
ctx := context.Background()overview, err := client.MarketOverview.List(ctx, nil, 5, "", false)
if err != nil { log.Fatal(err) }
for _, market := range overview.Markets {
fmt.Println(market.Symbol, market.LastPrice.Ticks())
}If that prints a few markets, you are connected. Next: Quickstart.
Contributor live harness (strict)
make test # unit only (CI)
make test-integration # live (reads .env)
# or: go test -tags=integration -v ./tests/integration/...Credentialed live tests need POLYESTER_API_KEY_ID / POLYESTER_API_PRIVATE_KEY (optional POLYESTER_ACCOUNT_ID). Optional gates: POLYESTER_TEST_MUTATION=1, POLYESTER_TEST_FUNDED=1.
Set POLYESTER_TEST_STRICT_LIVE=1 for release certification so soft-skips fail instead of
appearing green.