MRxAccess Developer Portal

Identity verification API for MRxWallet integrations
v0 · MRxChain-1

Get started in 3 steps

MRxAccess lets any application verify identity and credentials in one call. No passwords. No KYC ingestion. Deterministic, signed, auditable.

1
Generate an API keyAPI Keys tab
2
Install the SDK — or call the endpoint directly
3
Call verify() — gate access on the result

JavaScript / TypeScript

import { MRxAccess } from "@myrxwallet/mrx-access";

const mrx = new MRxAccess({
  apiKey: process.env.MRX_API_KEY,
  // endpoint defaults to https://trinh.io/api/v1/access/verify
});

const result = await mrx.verify({
  wallet:      "0xPATIENT_WALLET",
  credentials: ["HEALTH_ACTIVE"],   // optional
  assurance:   "HIPAA",             // optional label
});

if (result.accepted) {
  console.log("Identity verified:", result.mrx_id);
  console.log("Trust score:",       result.mrx_score.value);
  // grant access
} else {
  console.log("Denied:", result.reason);
}

Direct HTTP (curl)

curl -X POST https://trinh.io/api/v1/access/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet":      "0xWALLET_ADDRESS",
    "credentials": ["HEALTH_ACTIVE"],
    "assurance":   "HIPAA"
  }'

Response (accepted)

{
  "accepted":             true,
  "mrx_id":               "ID-1",
  "credentials_verified": ["HEALTH_ACTIVE"],
  "mrx_score": {
    "value":   720,
    "grade":   "GOOD",
    "version": "0.1.0"
  },
  "assurance":    "HIPAA",
  "verified_at":  "2026-04-11T02:00:00Z",
  "issuer":       "MRxWallet DAO LLC (Wyoming SF0038)",
  "chain":        "MRxChain-1",
  "signature":    "hmac-sha256-hex..."
}

Generate API Key

Keys are shown once. Store them securely.

Revoke API Key

Live Endpoint Test

RESPONSE
Response will appear here...

Score Lookup

Score will appear here...

Endpoint Reference

POST
/api/v1/access/verifyAPI Key
Verify identity + credentials. Returns signed response with MRxScore.
POST
/api/v1/access/apikeyAdmin
Generate a new API key.
GET
/api/v1/mrxid/<id>Public
Full MRxID record + attestations.
GET
/api/v1/mrxid/wallet/<wallet>Public
MRxID lookup by wallet address.
GET
/api/v1/score/<id>Public
MRxScore for an MRxID. Includes full component breakdown.
GET
/api/v1/score/wallet/<wallet>Public
MRxScore by wallet address.
GET
/api/v1/profile/<wallet>Public
Full member profile: identity + NFTs + score + MRT balance.
GET
/api/v1/mrt/balance/<wallet>Public
MRT token balance + recent transactions.
GET
/api/v1/provenance/<lot_id>Public
Drug provenance chain for a lot (patented drugs only).
GET
/api/v1/provenance/audit/<lot_id>Public
CBP/FDA audit export — structured for regulatory submission.

Authentication

MethodHeaderUsed for
API KeyAuthorization: Bearer mrx_...verify endpoint
AdminX-MRx-Admin: <secret>key management, mint, reward
JWTAuthorization: Bearer <jwt>NFT mint, transfer, DAO
Publicnone requiredread endpoints

MRxScore — How It Works

Every point is explainable. No hidden inputs. Member owns the score.

InputPointsCap
Active MRxID (floor)+300 base
Active identity+100
Identity age ≥ 30 days+20
Identity age ≥ 90 days+30
Identity age ≥ 180 days+40
Identity age ≥ 1 year+60
Each verification event+205 events = max +100
Each active attestation+256 attestations
HEALTH attestation bonus+30once
COMPLIANCE attestation bonus+30once
FINANCE attestation bonus+20once
ACCESS_DENIED (last 30 days)−15 each3 events = max −45
Active BLOCK attestation−200

Grade Scale

GradeScore RangeMeaning
EXCELLENT750–850Long-standing, verified, attested identity
GOOD700–749Established identity with verification history
FAIR640–699Active identity, growing credential set
DEVELOPING580–639Active identity, limited history
NEW300–579Recently issued or minimal activity