View as Markdown Open in Claude Open in ChatGPT llms.txt

Core Concepts¶

Partner Account¶

A partner account represents one organization integrating with Yanez. Each partner account has a stable partner_id, an environment, a status, and one or more signing keys.

Partner status must be active before production traffic is accepted.

Signing Keys¶

Partners generate an Ed25519 key pair and keep the private key in backend secret storage. Yanez stores only the public JWK.

Public JWK shape:

{
  "kty": "OKP",
  "crv": "Ed25519",
  "x": "base64url-encoded-32-byte-public-key"
}

Private JWKs include a d field. Do not send private keys to Yanez — any JWK containing d is rejected.

Identity and Keys¶

The yid, bio-derived BLS keys, threshold tiers, addresses, and public key binding apply to every Yanez product, so they're defined on the shared Identity and Keys page.

Sandbox and Production¶

Use sandbox for development and integration testing. Production credentials, hostnames, signing keys, and partner account status are separate.