SIMA

Example

Certificate Verification Example

Certificate verification confirms SIMA certificate record matching for a wallet-owned protection record.

Example Scenario

When this pattern applies.

An AI assistant or trading bot needs to check whether a SIMA certificate record exists before preparing a claim intake or evidence workflow.

Request

Example request shape.

POST /agent/certificate-verify
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "certificateId": "CERTIFICATE_ID",
  "walletAddress": "YOUR_WALLET_ADDRESS",
  "chain": "SOLANA"
}

Response

Example response shape.

{
  "certificateId": "CERTIFICATE_ID",
  "status": "ACTIVE",
  "walletAddress": "YOUR_WALLET_ADDRESS",
  "verified": true,
  "claimRight": true,
  "investigationRight": true
}

TypeScript

Copy-paste friendly example.

async function verifyCertificate(accessToken: string, certificateId: string) {
  const response = await fetch("https://api.sima-prime.com/agent/certificate-verify", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      certificateId,
      walletAddress: "YOUR_WALLET_ADDRESS",
      chain: "SOLANA",
    }),
  });

  if (!response.ok) throw new Error("Certificate verification failed");
  return response.json();
}

Architecture Flow

  • Authenticate wallet or agent.
  • Provide certificate id and wallet context.
  • Verify record ownership or matching.
  • Use certificate as claim/investigation right.
  • Do not treat certificate verification as claim or payout approval.

Safety Boundary

  • No private keys or seed phrases are sent to SIMA.
  • Examples do not execute payments or blockchain transfers.
  • Quotes do not issue certificates.
  • Evidence does not approve claims or authorize payout.
  • FULL_PAYMENT still requires treasury review before execution.