A wallet assistant checks whether a wallet has active SIMA certificates, prepares a quote when needed, and prompts the user or policy engine before any purchase step.

Request

Example request shape.

GET /agent/certificates
Authorization: Bearer ACCESS_TOKEN

Response

Example response shape.

{
  "certificates": [
    {
      "id": "CERTIFICATE_ID",
      "status": "ACTIVE",
      "maximumNetPaymentUsd": "400.00"
    }
  ]
}

TypeScript

Copy-paste friendly example.

async function listWalletCertificates(accessToken: string) {
  const response = await fetch("https://api.sima-prime.com/agent/certificates", {
    headers: { Authorization: `Bearer ${accessToken}` },
  });

  if (!response.ok) throw new Error("Unable to read SIMA certificates");
  return response.json();
}

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

  if (!response.ok) throw new Error("Claim intake preparation failed");
  return response.json();
}

Architecture Flow

Autonomous wallet authenticates.
Wallet lists certificate records.
Wallet prepares quote if no relevant certificate exists.
Wallet starts claim intake only when investigation is needed.
Wallet treats evidence and payout statuses as separate later steps.

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.