Skip to content
OnchainQueries

OQ — G00 · Changelog

Query engine and CLI releases. Every capability listed here is one the engine really has — the version numbers and dates are illustrative.

Placeholder version numbers and dates — capabilities are real

v0.9.0

Arrow Flight transport

Results can now be delivered as Arrow IPC streams with a signed Flight ticket, alongside the default Parquet parts.

  • Added--transport flight produces Arrow IPC stream parts with an .arrow extension.
  • AddedThe Flight manifest carries a signed flight_ticket; pass the decoded ticket to GetFlightInfo and pull batches with DoGet on port 8091.
  • ChangedBoth transports now write manifest.json last and use the same verified download flow.
  • FixedFlight upload and exchange methods are explicitly disabled — the platform is read-only.

v0.8.0

TRY_CAST hybrid execution

TRY_CAST is evaluated through a local evaluation step so invalid values become NULL instead of failing the query.

  • AddedTRY_CAST support for single-table queries, evaluated locally.
  • ChangedPredicates containing TRY_CAST are no longer pushed down; they evaluate locally.
  • ChangedHybrid execution is limited to exactly one physical source table — no CTEs, joins or set operations in the same query.

v0.7.0

Automatic engine selection

--engine auto became the default, selecting a resource class from the shape of the SQL.

  • Addedauto selects large for joins, windows and UNNEST; medium for grouping, ordering or SQL over 2,000 bytes; small otherwise.
  • ChangedExplicitly choosing a class changes resource limits only — it does not expand the compatibility surface or bypass capacity.
  • FixedThread tokens are released when a task ends, including before retry backoff, so idle work no longer holds the global source budget.

v0.6.0

Checksum-verified downloads

Every result part is now verified against the manifest before it is given its final name.

  • AddedPer-part SHA-256 in the manifest, with size and checksum verification on download.
  • AddedParts download to .partial and are atomically renamed only after verification.
  • AddedRe-running against the same output directory reuses parts that already match.
  • Changedmanifest.json is written last, so its presence means the download completed.

v0.5.0

Consistency fingerprinting

OnchainQueries now refuses to publish a result that spans two versions of the source.

  • AddedSource partitions are fingerprinted before and after execution.
  • AddedThe catalog hash and high-watermark slot used to plan a query are recorded on the result.
  • ChangedIf the catalog or relevant partitions change during execution, affected work is retried rather than published.

v0.4.0

OnchainQL compatibility layer

The first curated OnchainQL surface, with explicit translations and explicit refusals.

  • AddedTranslations for date_trunc, count_if, approx_percentile, from_base58, to_base58, json_extract, json_extract_scalar, varbinary casts, ARRAY literals, INTERVAL and TIMESTAMP.
  • AddedA restricted UNNEST shape rewritten to an array join.
  • AddedTyped parameters across 13 types, including int256, uint256 and parameterised decimals.
  • Changedelement_at, filter, reduce, transform, zip_with, the map family, json_parse and json_array_length now return explicit compatibility errors rather than running with different semantics.