@myrxwallet/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 MyRxWallet North America Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,173 @@
+# @myrxwallet/sdk
+
+Official SDK for **Chain 8472 (MyRx Chain)** — the EVM-compatible blockchain securing patient health data under the 21st Century Cures Act.
+
+[![npm version](https://img.shields.io/npm/v/@myrxwallet/sdk)](https://www.npmjs.com/package/@myrxwallet/sdk)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+[![Chain 8472](https://img.shields.io/badge/Chain-8472-7c3aed)](https://explorer.myrxwallet.io)
+[![FHIR R4](https://img.shields.io/badge/FHIR-R4-00d5d5)](https://ehr.myrxwallet.io/api/v1/fhir/r4/metadata)
+
+## Installation
+
+```bash
+npm install @myrxwallet/sdk
+# Optional: ERC-20 + bridge operations require ethers v6
+npm install ethers
+```
+
+## Chain 8472 Quick Connect
+
+```javascript
+const { Chain8472Provider, CHAIN_8472 } = require('@myrxwallet/sdk');
+
+const provider = new Chain8472Provider();
+const block = await provider.getBlockNumber();
+const balanceMRT = await provider.getBalanceMRT('0xYourAddress');
+
+console.log(`Chain ${CHAIN_8472.chainId} — block ${block}`);
+console.log(`MRT balance: ${balanceMRT}`);
+```
+
+**RPC:** `https://rpc.myrxwallet.io`  
+**Chain ID:** `8472`  
+**Explorer:** `https://explorer.myrxwallet.io`  
+**Native Token:** MRT (MyRxWallet Reward Token, 18 decimals)
+
+Add to MetaMask / any EVM wallet:
+
+```json
+{
+  "chainId": "0x2118",
+  "chainName": "MyRx Chain",
+  "rpcUrls": ["https://rpc.myrxwallet.io"],
+  "nativeCurrency": { "name": "MyRx Token", "symbol": "MRT", "decimals": 18 },
+  "blockExplorerUrls": ["https://explorer.myrxwallet.io"]
+}
+```
+
+## MRT Token
+
+```javascript
+const { MRTToken, CONTRACTS_8472 } = require('@myrxwallet/sdk');
+
+const mrt = new MRTToken();
+
+// Get token metadata
+const meta = await mrt.metadata();
+// { name: 'Wrapped MRT', symbol: 'wMRT', decimals: 18, totalSupply: '...' }
+
+// Check balance
+const balance = await mrt.balanceOf('0xYourAddress');
+
+// Transfer MRT
+const receipt = await mrt.transfer(privateKey, recipientAddress, '10.0');
+
+// Approve bridge
+await mrt.approve(privateKey, BRIDGE_CONTRACT_ADDRESS, '100.0');
+```
+
+**Wrapped MRT:** `0x00e69754c21090d69D29a2abe3B6CF153D3F1dF7`  
+**Regulatory note:** MRT rewards are infrastructure compensation — not investment yield. [Full regulatory analysis →](https://myrxwallet.io/compliance.html#staking-validators)
+
+## Multi-chain Bridge
+
+MRT is live across 5 EVM networks via MRTBridgeMint contracts.
+
+```javascript
+const { MRTBridge } = require('@myrxwallet/sdk');
+
+// List supported chains
+const chains = MRTBridge.supportedChains();
+// [{ chainId: 8453, name: 'Base', role: 'Primary bridge hub' }, ...]
+
+// Bridge MRT from Base → Chain 8472
+const bridge = new MRTBridge(BRIDGE_CONTRACT_ON_BASE, BASE_RPC_URL);
+const fee = await bridge.getBridgeFee(8472, '100');
+const result = await bridge.bridgeTo(privateKey, 8472, recipientAddress, '100');
+```
+
+| Chain | Role |
+|-------|------|
+| Base (8453) | Primary bridge hub — Across Protocol |
+| Arbitrum (42161) | L2 settlement layer |
+| Polygon (137) | High-throughput transactions |
+| Ethereum (1) | Institutional settlement |
+| BNB Chain (56) | Global accessibility |
+
+## Healthcare API (FHIR R4)
+
+```javascript
+const { MyRxHealthClient } = require('@myrxwallet/sdk');
+
+// Authenticate via SMART on FHIR (PKCE)
+const authUrl = MyRxHealthClient.buildAuthUrl({
+  clientId: 'your-client-id',
+  redirectUri: 'https://your-app.com/callback',
+  codeChallenge: codeChallenge,
+  scope: 'patient/*.read openid fhirUser',
+});
+
+// After redirect, exchange code for token
+const token = await MyRxHealthClient.exchangeCode({
+  code: authorizationCode,
+  clientId: 'your-client-id',
+  redirectUri: 'https://your-app.com/callback',
+  codeVerifier: codeVerifier,
+});
+
+// Access patient data
+const client = new MyRxHealthClient(token.access_token);
+const patient   = await client.getPatient(patientId);
+const meds      = await client.getMedications(patientId);
+const vitals    = await client.getObservations(patientId, 'vital-signs');
+const nfts      = await client.getNFTs(patientId);
+const score     = await client.getMyRxScore(patientId);
+```
+
+**FHIR Endpoint:** `https://ehr.myrxwallet.io/api/v1/fhir/r4/metadata`  
+**Standards:** HL7 FHIR R4 · US Core 6.1.0 · SMART App Launch 2.0.0 · Bulk Data 2.0.0  
+**Inferno Result:** 317/317 PASS (ONC (g)(10) certification baseline)
+
+## Validators
+
+Chain 8472 validator network secures federally-mandated patient health infrastructure.
+
+- **Phase 1 (2026):** 10–50 validators — founding team + DAO members + credentialed developers
+- **NFT-gated credentialing:** Validator rights tied to NFT tier (Founding/Provider/Community/Developer)
+- **DAO governance:** DAORX.IO — protocol parameters, emission schedules, validator standards
+
+```javascript
+// Get validator network status via raw RPC
+const provider = new Chain8472Provider();
+await provider.verify(); // confirms you're on Chain 8472
+
+// Full regulatory framework:
+// https://myrxwallet.io/docs/staking-validators-whitepaper.html
+```
+
+## Developer Portal
+
+Register for API keys and sandbox access:
+
+- **Developer Portal:** https://myrxwallet.io/developer.html
+- **Sandbox:** Instant keys prefixed `mrx_sb_`
+- **Production:** Manual review, prefixed `mrx_lv_`
+- **SMART App Registration:** `POST /api/v1/developer/register`
+
+## Compliance
+
+| Standard | Status |
+|----------|--------|
+| FHIR R4 / US Core 6.1.0 | ✅ Inferno 317/317 PASS |
+| SMART on FHIR 2.0.0 + PKCE | ✅ Live |
+| HIPAA Security Rule (45 CFR §164.312) | ✅ AES-256-GCM |
+| 21st Century Cures Act / ONC Interoperability Rule | ✅ Core requirement |
+| DEA EPCS (21 CFR Part 1311) | ✅ TOTP 2FA + audit log |
+| SEC Howey Test (MRT) | ✅ Prongs 3 & 4 not satisfied |
+
+## License
+
+Apache 2.0 — MyRxWallet North America Corporation  
+CAGE: 9VNZ7 · UEI: RKYFJECN9GL3
+
+[myrxwallet.io](https://myrxwallet.io) · [compliance](https://myrxwallet.io/compliance.html) · [developer docs](https://myrxwallet.io/developer.html)

package/examples/quickstart.js

@@ -0,0 +1,80 @@
+/**
+ * @myrxwallet/sdk — Quickstart Examples
+ *
+ * Run:  node examples/quickstart.js
+ */
+
+const {
+  Chain8472Provider,
+  MRTToken,
+  MRTBridge,
+  MyRxHealthClient,
+  CHAIN_8472,
+  CONTRACTS_8472,
+  BRIDGE_CHAINS,
+} = require('../src/index');
+
+async function main() {
+  console.log('\n=== @myrxwallet/sdk Quickstart ===\n');
+
+  // ── 1. Connect to Chain 8472 ──────────────────────────────────────────────
+  console.log('1. Connecting to Chain 8472...');
+  const provider = new Chain8472Provider();
+  const network = await provider.getNetwork();
+  console.log(`   Network: ${network.name} (Chain ID: ${network.chainId})`);
+  console.log(`   RPC: ${CHAIN_8472.rpcUrl}`);
+
+  const blockNumber = await provider.getBlockNumber();
+  console.log(`   Latest block: ${blockNumber}`);
+  console.log(`   Explorer: ${CHAIN_8472.explorerUrl}\n`);
+
+  // ── 2. Check MRT balance ──────────────────────────────────────────────────
+  console.log('2. MRT Token (Wrapped MRT on Chain 8472)...');
+  try {
+    const mrt = new MRTToken();
+    const meta = await mrt.metadata();
+    console.log(`   Name: ${meta.name}`);
+    console.log(`   Symbol: ${meta.symbol}`);
+    console.log(`   Total Supply: ${meta.totalSupply} MRT\n`);
+  } catch (e) {
+    console.log(`   (requires ethers v6: npm install ethers) — ${e.message}\n`);
+  }
+
+  // ── 3. Bridge support ────────────────────────────────────────────────────
+  console.log('3. Multi-chain Bridge — Supported Networks:');
+  const chains = MRTBridge.supportedChains();
+  chains.forEach(c => console.log(`   Chain ${c.chainId}: ${c.name} — ${c.role}`));
+  console.log('');
+
+  // ── 4. FHIR Capability Statement ─────────────────────────────────────────
+  console.log('4. FHIR R4 Capability Statement...');
+  try {
+    const cap = await MyRxHealthClient.getCapabilityStatement();
+    console.log(`   FHIR Version: ${cap.fhirVersion}`);
+    console.log(`   Software: ${cap.software?.name}`);
+    console.log(`   Status: ${cap.status}\n`);
+  } catch (e) {
+    console.log(`   (FHIR metadata: ${e.message})\n`);
+  }
+
+  // ── 5. SMART Config ───────────────────────────────────────────────────────
+  console.log('5. SMART on FHIR Configuration...');
+  try {
+    const smart = await MyRxHealthClient.getSmartConfig();
+    console.log(`   Authorization: ${smart.authorization_endpoint}`);
+    console.log(`   Token: ${smart.token_endpoint}`);
+    console.log(`   PKCE required: ${smart.code_challenge_methods_supported?.includes('S256')}\n`);
+  } catch (e) {
+    console.log(`   (SMART config: ${e.message})\n`);
+  }
+
+  // ── 6. Contracts ──────────────────────────────────────────────────────────
+  console.log('6. Chain 8472 Contract Addresses:');
+  Object.entries(CONTRACTS_8472).forEach(([k, v]) => console.log(`   ${k}: ${v}`));
+
+  console.log('\n=== @myrxwallet/sdk ready ===');
+  console.log('Install: npm install @myrxwallet/sdk');
+  console.log('Docs: https://myrxwallet.io/developer.html');
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@myrxwallet/sdk",
+  "version": "1.0.0",
+  "description": "Official SDK for Chain 8472 (MyRx Chain) — MRT Token, FHIR R4 Health API, Multi-chain Bridge. Purpose-built for federally-mandated patient health infrastructure under the 21st Century Cures Act.",
+  "main": "src/index.js",
+  "types": "types/index.d.ts",
+  "files": [
+    "src/",
+    "types/",
+    "examples/",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node examples/quickstart.js",
+    "test": "node examples/quickstart.js"
+  },
+  "keywords": [
+    "myrxwallet",
+    "chain-8472",
+    "mrt-token",
+    "healthcare",
+    "fhir",
+    "fhir-r4",
+    "smart-on-fhir",
+    "hipaa",
+    "blockchain",
+    "evm",
+    "web3",
+    "ethereum",
+    "21st-century-cures-act",
+    "onc",
+    "bridge",
+    "validator"
+  ],
+  "author": "MyRxWallet North America Corporation <info@myrxwallet.io>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MyRxWallet/myrx-sdk.git"
+  },
+  "homepage": "https://myrxwallet.io/developer.html",
+  "bugs": {
+    "url": "https://github.com/MyRxWallet/myrx-sdk/issues"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ethers": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/bridge.js

@@ -0,0 +1,67 @@
+'use strict';
+
+const { BRIDGE_CHAINS, BRIDGE_ABI, API_BASE } = require('./constants');
+const { getEthersSigner } = require('./chain');
+
+/**
+ * MRTBridge — Multi-chain bridge for MRT tokens.
+ * Deployed across 5 EVM networks: Base (primary), Arbitrum, Polygon, Ethereum, BSC.
+ * Protocols: Across, Hop, Stargate, deBridge.
+ */
+class MRTBridge {
+  /**
+   * @param {string} bridgeContractAddress  MRTBridgeMint address on current chain
+   * @param {string} rpcUrl                 RPC for current chain
+   */
+  constructor(bridgeContractAddress, rpcUrl) {
+    this.bridgeContractAddress = bridgeContractAddress;
+    this.rpcUrl = rpcUrl;
+  }
+
+  _contract(signer) {
+    const { Contract } = require('ethers');
+    return new Contract(this.bridgeContractAddress, BRIDGE_ABI, signer);
+  }
+
+  /**
+   * Bridge MRT to another chain.
+   * @param {string} privateKey
+   * @param {number} targetChainId  Chain ID of destination (see BRIDGE_CHAINS)
+   * @param {string} recipient      Destination address
+   * @param {string|number} amount  MRT amount (not wei)
+   */
+  async bridgeTo(privateKey, targetChainId, recipient, amount) {
+    if (!BRIDGE_CHAINS[targetChainId]) {
+      throw new Error(`Unsupported target chain: ${targetChainId}. Supported: ${Object.keys(BRIDGE_CHAINS).join(', ')}`);
+    }
+    const { parseUnits } = require('ethers');
+    const signer = getEthersSigner(privateKey, this.rpcUrl);
+    const contract = this._contract(signer);
+    const amountWei = parseUnits(String(amount), 18);
+    const fee = await contract.getBridgeFee(targetChainId, amountWei);
+    const tx = await contract.bridgeTo(targetChainId, recipient, amountWei, { value: fee });
+    return { txHash: tx.hash, receipt: await tx.wait() };
+  }
+
+  /** Get bridge fee for a given amount to a target chain. Returns fee in native gas token. */
+  async getBridgeFee(targetChainId, amount) {
+    const { parseUnits, formatEther } = require('ethers');
+    const { getEthersProvider } = require('./chain');
+    const provider = getEthersProvider(this.rpcUrl);
+    const { Contract } = require('ethers');
+    const contract = new Contract(this.bridgeContractAddress, BRIDGE_ABI, provider);
+    const amountWei = parseUnits(String(amount), 18);
+    const fee = await contract.getBridgeFee(targetChainId, amountWei);
+    return formatEther(fee);
+  }
+
+  /** List all supported bridge chains. */
+  static supportedChains() {
+    return Object.entries(BRIDGE_CHAINS).map(([id, info]) => ({
+      chainId: Number(id),
+      ...info,
+    }));
+  }
+}
+
+module.exports = { MRTBridge, BRIDGE_CHAINS };

package/src/chain.js

@@ -0,0 +1,122 @@
+'use strict';
+
+const { CHAIN_8472, CONTRACTS_8472, ERC20_ABI } = require('./constants');
+
+/**
+ * Chain8472Provider — lightweight wrapper around JSON-RPC for Chain 8472.
+ * Uses ethers.js v6 if available; falls back to raw fetch for environments
+ * where ethers is not bundled.
+ */
+class Chain8472Provider {
+  constructor(rpcUrl = CHAIN_8472.rpcUrl) {
+    this.rpcUrl = rpcUrl;
+    this.chainId = CHAIN_8472.chainId;
+    this._id = 0;
+  }
+
+  async _rpc(method, params = []) {
+    const res = await fetch(this.rpcUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ jsonrpc: '2.0', id: ++this._id, method, params }),
+    });
+    if (!res.ok) throw new Error(`RPC HTTP ${res.status}`);
+    const { result, error } = await res.json();
+    if (error) throw new Error(error.message || JSON.stringify(error));
+    return result;
+  }
+
+  /** Get native MRT balance for an address (returns BigInt in wei). */
+  async getBalance(address) {
+    const hex = await this._rpc('eth_getBalance', [address, 'latest']);
+    return BigInt(hex);
+  }
+
+  /** Get MRT balance formatted in ether units. */
+  async getBalanceMRT(address) {
+    const wei = await this.getBalance(address);
+    return Number(wei) / 1e18;
+  }
+
+  /** Get current block number. */
+  async getBlockNumber() {
+    const hex = await this._rpc('eth_blockNumber');
+    return parseInt(hex, 16);
+  }
+
+  /** Get gas price in wei. */
+  async getGasPrice() {
+    const hex = await this._rpc('eth_gasPrice');
+    return BigInt(hex);
+  }
+
+  /** Get transaction count (nonce) for address. */
+  async getTransactionCount(address) {
+    const hex = await this._rpc('eth_getTransactionCount', [address, 'latest']);
+    return parseInt(hex, 16);
+  }
+
+  /** Get transaction by hash. */
+  async getTransaction(txHash) {
+    return this._rpc('eth_getTransactionByHash', [txHash]);
+  }
+
+  /** Get transaction receipt. */
+  async getTransactionReceipt(txHash) {
+    return this._rpc('eth_getTransactionReceipt', [txHash]);
+  }
+
+  /** Send a signed raw transaction. Returns tx hash. */
+  async sendRawTransaction(signedTx) {
+    return this._rpc('eth_sendRawTransaction', [signedTx]);
+  }
+
+  /** Read a contract (eth_call). */
+  async call(to, data) {
+    return this._rpc('eth_call', [{ to, data }, 'latest']);
+  }
+
+  /** Get network info. */
+  async getNetwork() {
+    const chainIdHex = await this._rpc('eth_chainId');
+    return { chainId: parseInt(chainIdHex, 16), name: CHAIN_8472.name };
+  }
+
+  /** Check that we're connected to Chain 8472. */
+  async verify() {
+    const { chainId } = await this.getNetwork();
+    if (chainId !== this.chainId) {
+      throw new Error(`Wrong chain: expected ${this.chainId}, got ${chainId}`);
+    }
+    return true;
+  }
+}
+
+/**
+ * Get an ethers.js Provider for Chain 8472 (requires ethers v6 installed).
+ * @param {string} [rpcUrl]
+ */
+function getEthersProvider(rpcUrl = CHAIN_8472.rpcUrl) {
+  try {
+    const { JsonRpcProvider } = require('ethers');
+    return new JsonRpcProvider(rpcUrl, {
+      chainId: CHAIN_8472.chainId,
+      name: CHAIN_8472.name,
+    });
+  } catch {
+    throw new Error('ethers.js v6 not installed. Run: npm install ethers');
+  }
+}
+
+/**
+ * Get an ethers.js Signer connected to Chain 8472.
+ * @param {string} privateKey
+ * @param {string} [rpcUrl]
+ */
+function getEthersSigner(privateKey, rpcUrl = CHAIN_8472.rpcUrl) {
+  const { Wallet } = require('ethers');
+  const provider = getEthersProvider(rpcUrl);
+  return new Wallet(privateKey, provider);
+}
+
+module.exports = { Chain8472Provider, getEthersProvider, getEthersSigner, CHAIN_8472, CONTRACTS_8472 };

package/src/constants.js

@@ -0,0 +1,67 @@
+'use strict';
+
+// ── Chain 8472 — MyRx Chain ────────────────────────────────────────────────
+const CHAIN_8472 = {
+  chainId: 8472,
+  name: 'MyRx Chain',
+  symbol: 'MRT',
+  decimals: 18,
+  rpcUrl: 'https://rpc.myrxwallet.io',
+  explorerUrl: 'https://explorer.myrxwallet.io',
+  infoUrl: 'https://myrxwallet.io',
+};
+
+// ── Native token + Chain 8472 contracts ───────────────────────────────────
+const CONTRACTS_8472 = {
+  wrappedMRT:  '0x00e69754c21090d69D29a2abe3B6CF153D3F1dF7',
+  wrappedBTC:  '0xC8604C8FcF96cEc581e8275A2CDf04e7F7348849',
+  myRxUSD:     '0x8d86EA71F0621ffb47A5a40ab92409A022Dd30F7',
+  nftRegistry: '0x8Bfb23155f35b0cC7Ee232dC3aBB925391f90da3',
+};
+
+// ── Bridge chains — MRTBridgeMint deployed ────────────────────────────────
+const BRIDGE_CHAINS = {
+  1:     { name: 'Ethereum Mainnet',  role: 'Institutional settlement' },
+  8453:  { name: 'Base',              role: 'Primary bridge hub (Across Protocol)' },
+  42161: { name: 'Arbitrum One',      role: 'L2 settlement layer' },
+  137:   { name: 'Polygon',           role: 'High-throughput transactions' },
+  56:    { name: 'BNB Smart Chain',   role: 'Global accessibility' },
+};
+
+// ── MyRxWallet API ─────────────────────────────────────────────────────────
+const API_BASE = 'https://ehr.myrxwallet.io/api/v1';
+const BRIDGE_API = 'https://wallet.myrxwallet.io';
+
+// ── ERC-20 minimal ABI ────────────────────────────────────────────────────
+const ERC20_ABI = [
+  'function name() view returns (string)',
+  'function symbol() view returns (string)',
+  'function decimals() view returns (uint8)',
+  'function totalSupply() view returns (uint256)',
+  'function balanceOf(address) view returns (uint256)',
+  'function transfer(address to, uint256 amount) returns (bool)',
+  'function approve(address spender, uint256 amount) returns (bool)',
+  'function allowance(address owner, address spender) view returns (uint256)',
+  'event Transfer(address indexed from, address indexed to, uint256 value)',
+  'event Approval(address indexed owner, address indexed spender, uint256 value)',
+];
+
+// ── MRTBridgeMint ABI ─────────────────────────────────────────────────────
+const BRIDGE_ABI = [
+  'function mint(address to, uint256 amount) external',
+  'function burn(address from, uint256 amount) external',
+  'function bridgeTo(uint256 targetChainId, address recipient, uint256 amount) external payable',
+  'function getBridgeFee(uint256 targetChainId, uint256 amount) view returns (uint256)',
+  'event BridgeInitiated(address indexed sender, uint256 indexed targetChainId, address recipient, uint256 amount)',
+  'event BridgeCompleted(address indexed recipient, uint256 indexed sourceChainId, uint256 amount)',
+];
+
+module.exports = {
+  CHAIN_8472,
+  CONTRACTS_8472,
+  BRIDGE_CHAINS,
+  API_BASE,
+  BRIDGE_API,
+  ERC20_ABI,
+  BRIDGE_ABI,
+};

package/src/health.js

@@ -0,0 +1,207 @@
+'use strict';
+
+const { API_BASE } = require('./constants');
+
+/**
+ * MyRxHealthClient — FHIR R4 + MyRxWallet EHR API client.
+ *
+ * All endpoints require a Bearer token (obtained via SMART on FHIR OAuth 2.0 + PKCE).
+ * Standards: HL7 FHIR R4, US Core 6.1.0, SMART App Launch 2.0.0.
+ * Live: https://ehr.myrxwallet.io/api/v1/fhir/r4/metadata
+ */
+class MyRxHealthClient {
+  /**
+   * @param {string} bearerToken   JWT from SMART auth flow
+   * @param {string} [baseUrl]     API base (default: production)
+   */
+  constructor(bearerToken, baseUrl = API_BASE) {
+    this.token = bearerToken;
+    this.base = baseUrl.replace(/\/$/, '');
+  }
+
+  _headers() {
+    return {
+      'Authorization': `Bearer ${this.token}`,
+      'Content-Type': 'application/fhir+json',
+      'Accept': 'application/fhir+json',
+    };
+  }
+
+  async _get(path) {
+    const res = await fetch(`${this.base}${path}`, { headers: this._headers() });
+    if (!res.ok) throw new Error(`${res.status} ${res.statusText} — GET ${path}`);
+    return res.json();
+  }
+
+  async _post(path, body) {
+    const res = await fetch(`${this.base}${path}`, {
+      method: 'POST',
+      headers: this._headers(),
+      body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`${res.status} — POST ${path}: ${text}`);
+    }
+    return res.json();
+  }
+
+  // ── FHIR Capability Statement ────────────────────────────────────────────
+
+  /** Get FHIR R4 CapabilityStatement (no auth required). */
+  static async getCapabilityStatement(baseUrl = API_BASE) {
+    const res = await fetch(`${baseUrl}/fhir/r4/metadata`, {
+      headers: { 'Accept': 'application/fhir+json' },
+    });
+    return res.json();
+  }
+
+  /** Get SMART configuration (no auth required). */
+  static async getSmartConfig(baseUrl = 'https://ehr.myrxwallet.io') {
+    const res = await fetch(`${baseUrl}/.well-known/smart-configuration`);
+    return res.json();
+  }
+
+  // ── Patient ──────────────────────────────────────────────────────────────
+
+  /** Get FHIR Patient resource. */
+  async getPatient(patientId) {
+    return this._get(`/fhir/r4/Patient/${patientId}`);
+  }
+
+  // ── Medications ──────────────────────────────────────────────────────────
+
+  /** List MedicationRequest resources for a patient. */
+  async getMedications(patientId) {
+    return this._get(`/fhir/r4/MedicationRequest?patient=${patientId}`);
+  }
+
+  // ── Conditions ───────────────────────────────────────────────────────────
+
+  /** List Condition resources (diagnoses) for a patient. */
+  async getConditions(patientId) {
+    return this._get(`/fhir/r4/Condition?patient=${patientId}`);
+  }
+
+  // ── Observations / Vitals ────────────────────────────────────────────────
+
+  /** List Observation resources (vitals, labs) for a patient. */
+  async getObservations(patientId, category = null) {
+    const cat = category ? `&category=${category}` : '';
+    return this._get(`/fhir/r4/Observation?patient=${patientId}${cat}`);
+  }
+
+  // ── Appointments ─────────────────────────────────────────────────────────
+
+  /** Get patient appointments. */
+  async getAppointments(patientId) {
+    return this._get(`/appointments/my/${patientId}`);
+  }
+
+  /** Book an appointment. */
+  async bookAppointment(body) {
+    return this._post('/appointments/book', body);
+  }
+
+  // ── NFT Assets ───────────────────────────────────────────────────────────
+
+  /** Get all NFTs owned by a patient (prescription, lab, insurance, etc.). */
+  async getNFTs(patientId) {
+    return this._get(`/nft/patient/${patientId}`);
+  }
+
+  /** Get MRT wallet balance and recent transactions. */
+  async getMRTBalance(patientId) {
+    const [balance, txs] = await Promise.all([
+      this._get(`/gas/balance/${patientId}`),
+      this._get(`/gas/transactions/${patientId}`),
+    ]);
+    return { ...balance, transactions: txs };
+  }
+
+  // ── MyRx Score ───────────────────────────────────────────────────────────
+
+  /** Get patient's MyRx Health Score (300–850 scale). */
+  async getMyRxScore(patientId) {
+    return this._get(`/score/patient/${patientId}`);
+  }
+
+  // ── Prescription NFTs ────────────────────────────────────────────────────
+
+  /** Get all prescription NFTs for a patient. Token format: RX-{SHA256_12}. */
+  async getPrescriptionNFTs(patientId) {
+    return this._get(`/rx/patient/${patientId}`);
+  }
+
+  // ── Lab NFTs ─────────────────────────────────────────────────────────────
+
+  /** Get lab result NFTs for a patient. Token format: LAB-{PID6}-{SEQ6}. */
+  async getLabNFTs(patientId) {
+    return this._get(`/lab/my-orders`);
+  }
+
+  // ── Consent ──────────────────────────────────────────────────────────────
+
+  /** Get consent grants and audit trail for a patient. */
+  async getConsentAudit(patientId) {
+    return this._get(`/consent/audit/${patientId}`);
+  }
+
+  /** Get a shareable health summary card. */
+  async getHealthCard(patientId) {
+    return this._get(`/mycard/${patientId}`);
+  }
+
+  // ── SMART Auth helpers ───────────────────────────────────────────────────
+
+  /**
+   * Build the SMART authorization URL (PKCE flow).
+   * @param {object} opts
+   * @param {string} opts.clientId
+   * @param {string} opts.redirectUri
+   * @param {string} opts.codeChallenge  SHA-256 of code_verifier, base64url-encoded
+   * @param {string} [opts.scope]        default: 'patient/*.read openid fhirUser'
+   * @param {string} [opts.state]
+   */
+  static buildAuthUrl(opts, baseUrl = 'https://ehr.myrxwallet.io') {
+    const scope = opts.scope || 'patient/*.read openid fhirUser';
+    const state = opts.state || Math.random().toString(36).slice(2);
+    const params = new URLSearchParams({
+      response_type: 'code',
+      client_id: opts.clientId,
+      redirect_uri: opts.redirectUri,
+      scope,
+      state,
+      code_challenge: opts.codeChallenge,
+      code_challenge_method: 'S256',
+    });
+    return `${baseUrl}/oauth/authorize?${params}`;
+  }
+
+  /**
+   * Exchange authorization code for access token.
+   * @param {object} opts
+   * @param {string} opts.code
+   * @param {string} opts.clientId
+   * @param {string} opts.redirectUri
+   * @param {string} opts.codeVerifier
+   */
+  static async exchangeCode(opts, baseUrl = 'https://ehr.myrxwallet.io') {
+    const body = new URLSearchParams({
+      grant_type: 'authorization_code',
+      code: opts.code,
+      client_id: opts.clientId,
+      redirect_uri: opts.redirectUri,
+      code_verifier: opts.codeVerifier,
+    });
+    const res = await fetch(`${baseUrl}/oauth/token`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body,
+    });
+    if (!res.ok) throw new Error(`Token exchange failed: ${res.status}`);
+    return res.json();
+  }
+}
+
+module.exports = { MyRxHealthClient };

package/src/index.js

@@ -0,0 +1,51 @@
+'use strict';
+
+/**
+ * @myrxwallet/sdk — Official SDK for MyRxWallet North America Corporation
+ *
+ * Chain 8472 (MyRx Chain) — EVM-compatible blockchain for federally-mandated
+ * patient health data infrastructure pursuant to the 21st Century Cures Act.
+ *
+ * @see https://myrxwallet.io
+ * @see https://ehr.myrxwallet.io/api/v1/fhir/r4/metadata
+ */
+
+const { Chain8472Provider, getEthersProvider, getEthersSigner } = require('./chain');
+const { MRTToken } = require('./token');
+const { MRTBridge, BRIDGE_CHAINS } = require('./bridge');
+const { MyRxHealthClient } = require('./health');
+const constants = require('./constants');
+
+const {
+  CHAIN_8472,
+  CONTRACTS_8472,
+  API_BASE,
+  BRIDGE_API,
+  ERC20_ABI,
+  BRIDGE_ABI,
+} = constants;
+
+module.exports = {
+  // ── Chain 8472 ────────────────────────────────────────────────────────────
+  Chain8472Provider,
+  getEthersProvider,
+  getEthersSigner,
+
+  // ── MRT Token ─────────────────────────────────────────────────────────────
+  MRTToken,
+
+  // ── Bridge ────────────────────────────────────────────────────────────────
+  MRTBridge,
+  BRIDGE_CHAINS,
+
+  // ── Healthcare API ────────────────────────────────────────────────────────
+  MyRxHealthClient,
+
+  // ── Constants ─────────────────────────────────────────────────────────────
+  CHAIN_8472,
+  CONTRACTS_8472,
+  API_BASE,
+  BRIDGE_API,
+  ERC20_ABI,
+  BRIDGE_ABI,
+};

package/src/token.js

@@ -0,0 +1,86 @@
+'use strict';
+
+const { CONTRACTS_8472, ERC20_ABI } = require('./constants');
+const { getEthersProvider, getEthersSigner } = require('./chain');
+
+/**
+ * MRTToken — ERC-20 interface for the MRT (MyRxWallet Reward Token).
+ * MRT is the native gas + governance + validator compensation token on Chain 8472.
+ *
+ * Regulatory note: MRT rewards are infrastructure compensation for active validator
+ * work — not investment yield. Howey Test Prongs 3 & 4 are not satisfied.
+ * See: https://myrxwallet.io/compliance.html#staking-validators
+ */
+class MRTToken {
+  constructor(rpcUrl) {
+    this._provider = getEthersProvider(rpcUrl);
+  }
+
+  _contract(signerOrProvider) {
+    const { Contract } = require('ethers');
+    return new Contract(CONTRACTS_8472.wrappedMRT, ERC20_ABI, signerOrProvider || this._provider);
+  }
+
+  /** Get MRT balance for an address (returns formatted string, e.g. "100.0"). */
+  async balanceOf(address) {
+    const { formatUnits } = require('ethers');
+    const bal = await this._contract().balanceOf(address);
+    return formatUnits(bal, 18);
+  }
+
+  /** Get total MRT supply in circulation. */
+  async totalSupply() {
+    const { formatUnits } = require('ethers');
+    const sup = await this._contract().totalSupply();
+    return formatUnits(sup, 18);
+  }
+
+  /**
+   * Transfer MRT tokens.
+   * @param {string} privateKey  Sender private key
+   * @param {string} to          Recipient address
+   * @param {string|number} amount  Amount in MRT (not wei)
+   */
+  async transfer(privateKey, to, amount) {
+    const { parseUnits } = require('ethers');
+    const signer = getEthersSigner(privateKey);
+    const contract = this._contract(signer);
+    const amountWei = parseUnits(String(amount), 18);
+    const tx = await contract.transfer(to, amountWei);
+    return tx.wait();
+  }
+
+  /**
+   * Approve a spender (e.g. bridge contract) to spend MRT.
+   * @param {string} privateKey
+   * @param {string} spender
+   * @param {string|number} amount
+   */
+  async approve(privateKey, spender, amount) {
+    const { parseUnits } = require('ethers');
+    const signer = getEthersSigner(privateKey);
+    const contract = this._contract(signer);
+    const amountWei = parseUnits(String(amount), 18);
+    const tx = await contract.approve(spender, amountWei);
+    return tx.wait();
+  }
+
+  /** Get allowance in formatted MRT. */
+  async allowance(owner, spender) {
+    const { formatUnits } = require('ethers');
+    const val = await this._contract().allowance(owner, spender);
+    return formatUnits(val, 18);
+  }
+
+  /** Get token metadata. */
+  async metadata() {
+    const c = this._contract();
+    const [name, symbol, decimals, supply] = await Promise.all([
+      c.name(), c.symbol(), c.decimals(), c.totalSupply(),
+    ]);
+    const { formatUnits } = require('ethers');
+    return { name, symbol, decimals: Number(decimals), totalSupply: formatUnits(supply, 18) };
+  }
+}
+
+module.exports = { MRTToken };

package/types/index.d.ts

@@ -0,0 +1,126 @@
+// @myrxwallet/sdk — TypeScript Definitions
+// Chain 8472 (MyRx Chain) — FHIR R4 — MRT Token — Multi-chain Bridge
+
+export interface ChainConfig {
+  chainId: number;
+  name: string;
+  symbol: string;
+  decimals: number;
+  rpcUrl: string;
+  explorerUrl: string;
+  infoUrl: string;
+}
+
+export interface Contracts8472 {
+  wrappedMRT: string;
+  wrappedBTC: string;
+  myRxUSD: string;
+  nftRegistry: string;
+}
+
+export interface BridgeChainInfo {
+  chainId: number;
+  name: string;
+  role: string;
+}
+
+export interface BridgeResult {
+  txHash: string;
+  receipt: object;
+}
+
+export interface TokenMetadata {
+  name: string;
+  symbol: string;
+  decimals: number;
+  totalSupply: string;
+}
+
+export interface SmartAuthOptions {
+  clientId: string;
+  redirectUri: string;
+  codeChallenge: string;
+  scope?: string;
+  state?: string;
+}
+
+export interface CodeExchangeOptions {
+  code: string;
+  clientId: string;
+  redirectUri: string;
+  codeVerifier: string;
+}
+
+// ── Chain8472Provider ─────────────────────────────────────────────────────
+
+export class Chain8472Provider {
+  constructor(rpcUrl?: string);
+  getBalance(address: string): Promise<bigint>;
+  getBalanceMRT(address: string): Promise<number>;
+  getBlockNumber(): Promise<number>;
+  getGasPrice(): Promise<bigint>;
+  getTransactionCount(address: string): Promise<number>;
+  getTransaction(txHash: string): Promise<object>;
+  getTransactionReceipt(txHash: string): Promise<object>;
+  sendRawTransaction(signedTx: string): Promise<string>;
+  call(to: string, data: string): Promise<string>;
+  getNetwork(): Promise<{ chainId: number; name: string }>;
+  verify(): Promise<boolean>;
+}
+
+export function getEthersProvider(rpcUrl?: string): object;
+export function getEthersSigner(privateKey: string, rpcUrl?: string): object;
+
+// ── MRTToken ──────────────────────────────────────────────────────────────
+
+export class MRTToken {
+  constructor(rpcUrl?: string);
+  balanceOf(address: string): Promise<string>;
+  totalSupply(): Promise<string>;
+  transfer(privateKey: string, to: string, amount: string | number): Promise<object>;
+  approve(privateKey: string, spender: string, amount: string | number): Promise<object>;
+  allowance(owner: string, spender: string): Promise<string>;
+  metadata(): Promise<TokenMetadata>;
+}
+
+// ── MRTBridge ─────────────────────────────────────────────────────────────
+
+export class MRTBridge {
+  constructor(bridgeContractAddress: string, rpcUrl: string);
+  bridgeTo(privateKey: string, targetChainId: number, recipient: string, amount: string | number): Promise<BridgeResult>;
+  getBridgeFee(targetChainId: number, amount: string | number): Promise<string>;
+  static supportedChains(): BridgeChainInfo[];
+}
+
+// ── MyRxHealthClient ──────────────────────────────────────────────────────
+
+export class MyRxHealthClient {
+  constructor(bearerToken: string, baseUrl?: string);
+  getPatient(patientId: string): Promise<object>;
+  getMedications(patientId: string): Promise<object>;
+  getConditions(patientId: string): Promise<object>;
+  getObservations(patientId: string, category?: string): Promise<object>;
+  getAppointments(patientId: string): Promise<object>;
+  bookAppointment(body: object): Promise<object>;
+  getNFTs(patientId: string): Promise<object>;
+  getMRTBalance(patientId: string): Promise<object>;
+  getMyRxScore(patientId: string): Promise<object>;
+  getPrescriptionNFTs(patientId: string): Promise<object>;
+  getLabNFTs(patientId: string): Promise<object>;
+  getConsentAudit(patientId: string): Promise<object>;
+  getHealthCard(patientId: string): Promise<object>;
+  static getCapabilityStatement(baseUrl?: string): Promise<object>;
+  static getSmartConfig(baseUrl?: string): Promise<object>;
+  static buildAuthUrl(opts: SmartAuthOptions, baseUrl?: string): string;
+  static exchangeCode(opts: CodeExchangeOptions, baseUrl?: string): Promise<object>;
+}
+
+// ── Constants ─────────────────────────────────────────────────────────────
+
+export const CHAIN_8472: ChainConfig;
+export const CONTRACTS_8472: Contracts8472;
+export const API_BASE: string;
+export const BRIDGE_API: string;
+export const ERC20_ABI: string[];
+export const BRIDGE_ABI: string[];
+export const BRIDGE_CHAINS: Record<number, { name: string; role: string }>;