Developer Docs
architecture · spec · sdk
Getting Started5 min read
Try KYA locally
Generate a simulated run receipt, tamper with it and check it using the offline verifier.
Install Python 3.12+ and uv. This source checkout provides the new verifier and local playground; the published SDK package may not yet include this command. Dependency installation may use the network.
bash
git clone https://github.com/solvent-labs-org/metaorcha.git
cd metaorcha
uv sync --all-packages
cd apps/attestation-playground
PLAYGROUND_MODE=sim uv run uvicorn playground.main:app --host 127.0.0.1 --port 8040- Open http://127.0.0.1:8040 and confirm sim mode.
- Compare Golden: valid with Golden: tampered.
- Run agent to build a simulated step chain, then Copy → verifier and edit a step value to see verification fail.
- Download the original envelope and verify it in another terminal.
bash
# From the cloned metaorcha repository, in a second terminal:
uv run --package orcha-sdk orcha-sdk verify /path/to/envelope.jsonRead the verdict precisely
Exit 0 means valid, 1 means invalid and 2 means an input or usage error. Verification checks the embedded key, without a network call or DID resolution. This local simulation performs no real agent task and moves no real money.
For the envelope format, golden vectors and real-harness setup, use the KYA guide linked under Core Links. Run attestation and settlement gating are opt-in.