Skip to content

1.3.0

Choose a tag to compare

@t-0-ci t-0-ci released this 08 Oct 08:03
· 47 commits to master since this release

All five SDKs (Go, Node, Python, Java, C#) now behave the same under one shared contract and one set of cross-language tests (#399). The shared rules are in docs/CROSS_SDK_RULES.md.

New

  • One custom-signer shape in every SDK (#398): a function from a 32-byte digest to a signature and a 65-byte uncompressed public key. Go crypto.SignFn, Node SignerFunction, Python SignFn, Java DigestSigner (now a functional interface), C# SignFn. Every SDK has a signer-from-hex factory whose result is the client's signer argument. The client checks the signer's output before sending, and a signer that fails gives Internal "signing the request failed: ". Hex-key calls are unchanged.
  • Public helpers in every SDK: PublicKeyFromPrivateKey, and a response-validation helper (C# gains Validate.Check). Node's validate takes the registry option for predefined rules declared in the application's own protos.

Breaking changes

  • Node toleranceMs and DEFAULT_TOLERANCE_MS are removed.
  • The timestamp-window constants Java Headers.TIMESTAMP_VALIDITY_WINDOW_MS, C# Headers.TimestampValidityWindow, Node REQUEST_VALIDITY_MILLIS and Python TIMESTAMP_TOLERANCE_MS are removed. Each SDK now has one window constant.
  • C# T0Config.FromEnvironment and QuotePublisherService moved to the C# starter.
  • Custom-signer code:
    • Go and Python refuse a private key together with a custom signer.
    • C# custom signers move to SignFn. ISigner stays as an obsolete compatibility path.

Deprecated, not removed

  • Java withMaxInboundMessageSize and DEFAULT_ENDPOINT.
  • Node DEFAULT_ENDPOINT, createService(...).contextValues and signatureValidation.
  • C# ISigner.
  • Go ServerStartupTimeout.

Other changes you may notice

  • Servers: Go serves an Upgrade: h2c request as HTTP/1.1, and StartServer returns once the port is bound. C# response validation now applies predefined rules declared in the application's own protos, so a response that breaks one is refused, as in Go, Java and Python.
  • Clients: whitespace inside a base URL is refused. Node accepts gzip responses. Java and C# send no keepalive pings, and C# keeps no cookies.
  • Messages: several SDK error texts changed to the shared ones (timeouts, signer, validation field paths). Node's request verifier answers a wrong-length signature with 401, and a bare 0x is refused.
  • Dependencies: Python requires protovalidate 2.0 or newer. Node pins @noble/curves and @noble/hashes to 2.4.0.
  • Starters: they share their values: port 8080, and a quote interval outside 1..2147483647 falls back to 5000.

Full Changelog: v1.2.2...v1.3.0