Skip to content

v1.0.0: The public Kyro platform

Latest
Latest

Choose a tag to compare

View all tags
@vaibhav0xq vaibhav0xq released this 14 Aug 05:52
v1.0.0
8966332

Summary

kyro-public is now the public home of the Kyro platform. v1.0.0 ships the curated app surface, the v1 API contract, the TypeScript SDK, runnable examples and the docs site source. The hosted Kyro service powers the API; this repo holds everything needed to build against it.

Highlights

  • Counterparty Check workbench: docked console, verdict rail and tabbed evidence replace the long-scroll report
  • Decision API v1: stable routes, keyed access and predictable outcomes for every valid wallet
  • Decision receipts: document-style pages with stable permalinks you can hand to a counterparty
  • Batch checks: many wallets in one call, priced upfront, with explicit no_score results
  • OpenAPI v1 and TypeScript SDK: typed client generated from the frozen spec
  • Dedicated docs site: full developer documentation at docs.thekyro.co

What's Changed

Everything below is relative to v0.2.1, the last of the public mirror milestones.

Counterparty Check

  • Rebuilt the check surface as a workbench: docked console, verdict rail and tabbed evidence panes
  • Anonymous checks run against a visible request budget; per-action prices show in the console before you spend
  • Every check can mint a shareable receipt that shows the decision and its context, nothing more

Wallet intake

  • Intake now runs a paced pipeline with honest progress states
  • The client checks its budget first and never fires requests that cannot succeed
  • Refreshes run one at a time per wallet; stale in-progress states expire instead of wedging the flow

Coverage transparency

  • Decision responses carry coverage metadata that says how much evidence backs the result
  • Advisory warnings flag data gaps without changing the verdict

Reliability

  • Wallet-changing actions require a fresh single-use signed challenge; reads never prompt for signatures
  • Responses stay conservative when evidence is thin instead of guessing
  • Hardened refresh and timeout handling so slow upstreams degrade gracefully

Repo refresh

  • Removed legacy mirror internals; 270 files changed to leave a curated public surface
  • History preserved with no rewrites; earlier tags and releases stay up as historical mirror milestones
  • Code and docs are MIT licensed

Developer Platform

  • OpenAPI v1: public/kyro-openapi.yaml is the source of truth, with a PDF rendering beside it; spec, API and SDK types move in lockstep
  • Predictable lookups: a decision request for any valid wallet always answers; wallets without a committed score get a conservative baseline instead of a 404
  • Honest batching: oversized batch requests are rejected without charge
  • Rate limits: anonymous and keyed access are both limited, with standard rate limit headers on v1 responses and limits documented in the public docs
  • TypeScript SDK: typed client under sdk/typescript with ESM and CJS builds, tested against the public behaviors; source-first in this release, so build it from the repo
  • Examples: small end-to-end integrations under examples/
  • Docs: deep API documentation lives at docs.thekyro.co; source in docs-site/

Compatibility

  • The v1 contract is stable from here; breaking changes get a new major
  • Legacy .arcid names keep resolving alongside .kyro
  • Existing receipt permalinks keep working
  • Earlier releases (v0.1.1 through v0.2.1) remain up as history

Links

Full Changelog: v0.2.1...v1.0.0

Assets 2
Loading