# KN Platform - Full Integration Guide

## 1) Service Model

KN Platform exposes two layers:

1. Governance API (`/api/*`) for rule and concept retrieval.
2. Trust API (`/atkn/*`) for scoring, verification, and certification.

All paid endpoints support x402 USDC on Base.

## 2) Integration Flow

1. Discover metadata with `GET /.well-known/agents.json`
2. Inspect schemas with `GET /.well-known/openapi.json`
3. Start with free `GET /atkn/network_stats`
4. Score trust with `POST /atkn/trust_score`
5. Run verification with `POST /atkn/verify_agent`
6. Score governance posture with `POST /atkn/behavioral_score`
7. Query evidence with `POST /atkn/query_knowledge`

## 3) Governance Categories

- transparency: disclose uncertainty and provenance
- fairness: avoid biased allocation and treatment
- safety: avoid harmful outputs and unsafe recommendations
- humility: preserve calibrated confidence
- integrity: keep behavior consistent with stated policies
- accountability: include traceable audit fields
- respect: maintain non-abusive and non-degrading interaction
- reasoning: provide clear rationale for important decisions
- collaboration: coordinate cleanly with multi-agent systems
- resilience: fail safely and recover predictably

## 4) Example Request

```bash
curl -X POST https://kosherninja.com/atkn/behavioral_score \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"demo-agent","context":"ticket-triage"}'
```

## 5) Payment Metadata

- Network: `base-mainnet`
- Asset: `USDC`
- PayTo: `0x877875efB62A7C20066bbE36a0535c829408Cb58`

## 6) Discovery Links

- https://kosherninja.com/.well-known/agents.json
- https://kosherninja.com/.well-known/openapi.json
- https://kosherninja.com/.well-known/ai-plugin.json
- https://kosherninja.com/llms.txt