MRxAccess lets any application verify identity and credentials in one call. No passwords. No KYC ingestion. Deterministic, signed, auditable.
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);
}
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"
}'
{
"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..."
}
Keys are shown once. Store them securely.
| Method | Header | Used for |
|---|---|---|
| API Key | Authorization: Bearer mrx_... | verify endpoint |
| Admin | X-MRx-Admin: <secret> | key management, mint, reward |
| JWT | Authorization: Bearer <jwt> | NFT mint, transfer, DAO |
| Public | none required | read endpoints |
Every point is explainable. No hidden inputs. Member owns the score.
| Input | Points | Cap |
|---|---|---|
| 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 | +20 | 5 events = max +100 |
| Each active attestation | +25 | 6 attestations |
| HEALTH attestation bonus | +30 | once |
| COMPLIANCE attestation bonus | +30 | once |
| FINANCE attestation bonus | +20 | once |
| ACCESS_DENIED (last 30 days) | −15 each | 3 events = max −45 |
| Active BLOCK attestation | −200 | — |
| Grade | Score Range | Meaning |
|---|---|---|
| EXCELLENT | 750–850 | Long-standing, verified, attested identity |
| GOOD | 700–749 | Established identity with verification history |
| FAIR | 640–699 | Active identity, growing credential set |
| DEVELOPING | 580–639 | Active identity, limited history |
| NEW | 300–579 | Recently issued or minimal activity |