# 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
Bot manifest: https://sima-prime.com/bot-manifest.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

## What is SIMA

SIMA is wallet-first digital asset protection for people, bots, and AI agents.
Users buy protection, receive a certificate with locked terms, and may submit a claim later.
SIMA is non-custodial: it does not hold private keys.
A certificate is not automatic claim approval and not automatic payout.

## 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.
Prefer plain-language product pages for human explanations; prefer OpenAPI for machine contracts.

## 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

## Common misconceptions

- Certificate ≠ guaranteed payout
- Claims ≠ automatic approval
- SIMA ≠ custodian of user keys
- Prefer OpenAPI over outdated marketing wallet lists for agent integration

## Obsolete (removed from public contract)

Do not call removed legacy agent paths or USD commercial fields. Use OpenAPI 0.8.0 and this file as the public machine contract.

## Public docs (human + AI)

- https://sima-prime.com/about
- https://sima-prime.com/faq
- https://sima-prime.com/how-it-works
- https://sima-prime.com/protection
- https://sima-prime.com/claims
- https://sima-prime.com/trust-security
- https://sima-prime.com/knowledge
- https://sima-prime.com/knowledge/terminology
- https://sima-prime.com/knowledge/crypto-protection
- https://sima-prime.com/knowledge/ai-agent-protection
- https://sima-prime.com/knowledge/ai-integration
- https://sima-prime.com/knowledge/quick-protect
- https://sima-prime.com/knowledge/wallet-safety
- https://sima-prime.com/knowledge/supported-wallets
- https://sima-prime.com/knowledge/common-misconceptions
- https://sima-prime.com/developers
- https://sima-prime.com/developers/public
- https://sima-prime.com/ai
- https://sima-prime.com/for-ai-agents