# SIMA — LLM / Agent Context

Official website: https://sima-prime.com
Enter SIMA: https://sima-prime.com/enter
OpenAPI (source of truth): https://sima-prime.com/openapi.json
Developer sync: https://sima-prime.com/developer-sync.json
Public SDK: https://github.com/Mustafashehab/SIMA-Agent-SDK
npm: npm install @sima-prime/agent-sdk
MCP: npx @sima-prime/mcp-server

## Sync status

- API / OpenAPI version: 0.8.0
- SDK version: 0.2.0
- Last synchronized: 2026-07-12
- Purchase flow: offer → purchase → payment-intent → confirm-payment → ACTIVE

## Constitution

The production OpenAPI document is the only source of truth for agent API paths and commercial fields.
Do not use obsolete endpoints or USD commercial fields.

## Production purchase flow

```text
POST /agent/wallet/nonce
POST /agent/wallet/verify
POST /agent/protection/offer
POST /agent/protection/purchase
GET  /agent/protection/certificates/{id}/payment-intent
     → caller sends SOL on-chain (outside SIMA SDK)
POST /agent/protection/certificates/{id}/confirm-payment
GET  /agent/protection/certificates/{id}
```

## Available agent endpoints (OpenAPI 0.8.0)

- POST /agent/wallet/nonce — wallet auth challenge
- POST /agent/wallet/verify — verify signature, returns accessToken
- POST /agent/protection/offer — asset-denominated commercial terms (protectedAmount)
- POST /agent/protection/purchase — PURCHASE_PROTECTION creates PENDING_PAYMENT certificate
- GET /agent/protection/certificates/{id}/payment-intent — SOL treasury instructions
- POST /agent/protection/certificates/{id}/confirm-payment — RPC verify → ACTIVE
- GET /agent/protection/certificates/{id} — read certificate

## Offer example (asset-denominated)

```json
{
  "contractVersion": "SIMA_AGENT_PROTECTION_OFFER_V1",
  "protectedAmount": "1000",
  "premiumAmount": "50",
  "coverageAmount": "500",
  "deductibleAmount": "100",
  "maximumNetPayment": "400",
  "rulesVersion": "SIMA_V1_50_5_10_40",
  "purchaseEndpoint": "POST /agent/protection/purchase"
}
```

## SIMA V1 economics

Premium = 5% of protected amount
Coverage = 50% of protected amount
Deductible = 10% of protected amount
Maximum Net Payment = 40% of protected amount
Denomination = protected contract asset (not USD)

## Timing (BM-001)

- Quote Validity: 30 seconds
- Payment Window: 30 seconds after acceptance
- Protection Window: 5 minutes after premium payment
- Certificate Lifetime: 24 hours
- Claim Window: 24 hours
- Historical Record: permanent

## Safety

- No private keys required by SIMA
- SDK does not sign or transfer SOL
- Confirm-payment activates certificates when on-chain payment verifies
- Claims are investigated separately; no automatic claim approval or payout

## Obsolete (removed from public contract)

Do not call removed legacy agent paths or USD commercial fields. See docs/CHANGELOG_FOR_DEVELOPERS.md.

## Public docs

- https://sima-prime.com/developers
- https://sima-prime.com/developers/public
- https://sima-prime.com/knowledge
- https://sima-prime.com/ai
- https://sima-prime.com/for-ai-agents