Metaorcha

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
  1. Open http://127.0.0.1:8040 and confirm sim mode.
  2. Compare Golden: valid with Golden: tampered.
  3. Run agent to build a simulated step chain, then Copy → verifier and edit a step value to see verification fail.
  4. 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.json
Read 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.