MEDOVANT PROTOCOL

Infraestructura verificable para el mantenimiento de equipamiento médico crítico

🎥 Ver Demo  ·  🔍 Solana Explorer  ·  📂 Documentación

---

Estado actual

Programa completado / Graduado — Solana Latam Labs · WayLearn · Junio–Agosto 2026

Milestone	Fecha	Estado
🧭 Roadmap inicial del producto	26 jun	✅ Entregado
🧱 Business Foundation	3 jul	✅ Entregado
🏗️ Arquitectura técnica del MVP	10 jul	✅ Entregado
🔍 Validación inicial con usuarios	31 jul	✅ Entregado
⚙️ MVP funcional	21 ago	✅ Entregado
🎤 Pitch deck + Demo Day Readiness	25 ago	✅ Entregado
🚀 Demo Day	31 ago	🏁 Completado

El programa Anchor está deployado en Devnet con 15 tests pasando.

---

El problema

El mantenimiento de equipos médicos críticos — ventiladores, resonadores, equipos de diagnóstico — se gestiona con papel, confianza ciega y procesos manuales. No hay verificación independiente de que el trabajo se realizó, los pagos llegan tarde o generan conflictos, y reunir documentación para una auditoría regulatoria puede tomar días.

Actor	Problema hoy
🏥 Hospital / clínica	Paga el mantenimiento sin poder verificar de forma independiente si el trabajo se hizo correctamente
🔧 Técnico biomédico	Cobra tarde, o no cobra — sin forma de construir reputación verificable entre distintos clientes
📋 Auditor / regulador	Sin trazabilidad confiable del historial de mantenimiento para procesos de auditoría

---

La solución

Medovant registra cada activo médico como una identidad digital on-chain. Los pagos se bloquean en un vault PDA al reportar una falla y se liberan automáticamente cuando hospital y técnico confirman que el trabajo fue realizado — sin intermediarios, sin papel, sin posibilidad de modificar el historial.

El hospital paga solo cuando el trabajo está verificado.
El técnico cobra automáticamente al completarlo.
El auditor consulta el historial sin depender de nadie.

Medovant nace desde la perspectiva de la ingeniería clínica: el protocolo fue diseñado desde el conocimiento del dominio, no al revés.

---

¿Por qué Solana?

🚀 Velocidad Finalidad sub-segundo. Las intervenciones médicas no pueden esperar confirmaciones de minutos.

💰 Costo Registrar cientos de equipos cuesta menos de $5. Viable para hospitales de cualquier tamaño.

🔐 Escrow nativo Vault PDA system-owned con invoke_signed. Sin contratos complejos ni intermediarios.

---

Flujo del protocolo

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   🏥 Hospital          ◎ Vault PDA          🔧 Técnico         │
│       │                     │                    │             │
│       │  initialize_asset   │                    │             │
│       │ ──────────────────► │                    │             │
│       │                     │                    │             │
│       │  report_issue       │                    │             │
│       │  + lock SOL ──────► │                    │             │
│       │                     │  SOL bloqueado     │             │
│       │                     │  (nadie lo toca)   │             │
│       │                     │                    │             │
│       │     complete_maintenance (ambos firman)   │             │
│       │ ──────────────────────────────────────►  │             │
│       │                     │                    │             │
│       │                     │  SOL liberado ───► │             │
│       │                     │                    │  +reputation│
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

Arquitectura

Wallet (Phantom)
        │
        ▼
React Frontend (Vite + TypeScript + Tailwind)
├── Landing value-first → elige rol (🏥 Hospital | 🔧 Técnico) → wallet
├── 🏥 Hospital Mode   → registro, incidencias, verificación
└── 🔧 Technician Mode → jobs disponibles, cobro, reputación
        │
        ▼
Anchor Program ── 5JMd8ADy1KHBhohX6NLbz6WQdyCQTfLd55Gmzo2r34WD
        │
        ├── Asset PDA              seeds: ["equipment", hospital, asset_id]
        ├── Vault PDA              seeds: ["vault", asset_pda]  ← system-owned escrow
        └── TechnicianProfile PDA  seeds: ["technician", tech_pubkey]

        [v1.1 — en desarrollo]
        ├── Event Indexer (Helius RPC)
        └── PostgreSQL / Supabase

→ Ver arquitectura completa en docs/ARCHITECTURE.md

---

Instrucciones del smart contract

Instrucción	Firmantes	Efecto
register_technician	🔧 Técnico	Crea TechnicianProfile PDA
initialize_asset(asset_id)	🏥 Hospital	Crea Asset PDA · status = Active
report_issue(reward)	🏥 Hospital	Bloquea SOL en Vault PDA · failure_count++
complete_maintenance	🏥 + 🔧 Ambos	Doble firma · libera escrow · reputación +1
decommission_asset	🏥 Hospital	Cierra PDA · rent devuelto al hospital

Dual-Wallet complete_maintenance (PST Hand-Off)

complete_maintenance requires two distinct wallets (hospital pays fees, technician executes). The protocol uses a Partially Signed Transaction (PST) hand-off so neither party shares their private key:

• Hospital builds & partially signs → exports JSON payload
• Technician verifies (re-derives PDAs, checks invariants) → adds signature → submits

Details: docs/PST_HANDOFF.md

---

Mecanismo de escrow

El Vault PDA es una cuenta system-owned (space=0) — el patrón correcto para escrow nativo de SOL en Solana:

// report_issue: crea vault y bloquea SOL
system_program::create_account(CpiContext::new_with_signer(...))?;
system_program::transfer(CpiContext::new(...), reward)?;

// complete_maintenance: libera SOL al técnico via invoke_signed
system_program::transfer(
    CpiContext::new_with_signer(..., &[vault_seeds]),
    reward
)?;

⚠️ Las cuentas program-owned no pueden ser debitadas via CPI ordinario. El vault system-owned con invoke_signed es el único patrón correcto para escrow nativo de SOL.

---

Seguridad

Mecanismo	Dónde se aplica
has_one = hospital	report_issue, complete_maintenance, decommission_asset
require!(status == Active)	report_issue
require!(status == IssueReported)	complete_maintenance
require!(reward > 0)	report_issue
Doble firma obligatoria	complete_maintenance (hospital + técnico)
PDA seed validation	Todas las instrucciones via Anchor

---

Frontend

🏥 Hospital Mode Dashboard con KPIs conectados a datos on-chain Registro y gestión de activos médicos Reporte de incidencias con bloqueo de fondos Verificación y aprobación de mantenimientos

🔧 Technician Mode Earnings on-chain verificables Jobs completados con reputación on-chain Órdenes disponibles con escrow garantizado Complete & Get Paid en un click

Landing value-first (nuevo)

• El visitante entiende la propuesta de valor antes de cualquier interacción con la wallet: hero con tagline + descripción, 3 tarjetas de actores (Hospital · Técnico · Auditor) y 3 pasos de "Cómo funciona" con línea de tiempo numerada.
• Dos CTA (Entrar como Hospital / Entrar como Técnico) reemplazan al botón único de conectar: el modal de wallet abre solo después de elegir rol, y el rol elegido navega al dashboard correspondiente al conectarse.
• Efecto hover verde en los CTA y secciones con estética más corporativa.

Light/Dark mode · Bilingüe EN/ES · Responsive · Wallet adapter (Phantom) · Estados de error ante fallas de RPC en dashboards

---

Tests

anchor test

15 tests pasando ✅

Suite (describe)	Casos cubiertos
medovant	Ciclo completo del activo (initialize_asset → report_issue → complete_maintenance → decommission_asset) · perfil de técnico · transiciones de estado · reward > 0 · has_one = hospital · doble firma
medovant › edge cases (#7)	Re-registro de técnico sobre PDA existente falla · técnico sin perfil registrado falla · firmante técnico distinto al dueño del profile falla · decommission con escrow activo falla (SOL protegido en vault) · decommission con vault drenado libera el rent al hospital
medovant › complete_maintenance replay (#36)	complete_maintenance repetido falla: no drena el vault ni re-credita reputación

---

Correr localmente

Prerrequisitos: Rust · Solana CLI · Anchor 0.32.1 · Node.js 18+

# Smart contract
anchor build
anchor test
anchor deploy --provider.cluster devnet

# Copiar IDL al frontend
cp target/idl/medovant.json app/src/idl/medovant.json

# Frontend
cd app && npm install && npm run dev
# → localhost:5173

💡 El técnico firma con su propia wallet conectada (Phantom) — el rol técnico usa tu wallet en modo demo. Asegurate de tener SOL en Devnet para las fees de transacción.

---

Roadmap

v1.0 ✅  MVP técnico (Hackathon — Marzo 2026)
          Escrow PDA · Reputación on-chain · Dual role UI · 9 tests · Devnet deploy

v1.1 🔄  Incubación WayLearn (Junio–Agosto 2026)
          Landing value-first con roles (#18) · Estados de error en dashboards (#12)
          Panel admin read-only (#19) · Indexador de eventos · Historial completo por activo
          QR físico por equipo · Metadata off-chain (Supabase)
          Evidencia adjunta al mantenimiento · Validación con usuarios reales

v2.0 📋  Post-Demo Day
          Abstracción de wallet para usuarios no cripto
          Integración con sistemas hospitalarios (CMMS/HIS)
          Marketplace de técnicos certificados · API pública

v3.0 🔭  Escala
          Redes hospitalarias y ministerios de salud
          Empresas de mantenimiento tercerizadas
          Infraestructura crítica fuera del sector salud

→ Ver roadmap detallado en docs/ROADMAP.md

---

Deployment

Network	Solana Devnet
Program ID	5JMd8ADy1KHBhohX6NLbz6WQdyCQTfLd55Gmzo2r34WD
Upgrade Authority	2BaSXPAHkDZyusqegFACrHfU1WdBiWNuPdJNZTsvri76
Explorer	Ver programa en Devnet
Demo	Ver en YouTube

---

Stack

---

Solana Latam Labs · Incubación WayLearn · 2026

"Infraestructura crítica construida sobre Solana."