⛓️ Blockchain Learning Path GitHub

Custodia, wallets institucionales e identidad digital · Clases 53–54

Nivel: Avanzado · ⏱️ Duración estimada: 180 min · Fuente: BIPs 32/39/44, ERC-4337, estándares W3C de identificadores descentralizados y credenciales verificables, y normativa de custodia y finanzas abiertas citada ⬅️ Currículo · 📚 Bibliografía 🧭 ⬅️ Anterior: Clases 51–52 · Mercados de capitales on-chain · 📚 Índice · ➡️ Siguiente: Clases 55–56 · Regulación y cumplimiento 📖 Glosario de términos · 🌱 ¿Nuevo en esto? Empieza aquí 👛 La guía Wallets desde cero cubre el uso individual; estas clases llevan el mismo problema a custodia institucional.


Las dos clases independientes de este tema

Esta página conserva el mapa, los conceptos compartidos y las referencias. La enseñanza evaluable ocurre en dos documentos separados; cada uno tiene fundamento, gráfico, caso, práctica, evidencia y fuentes propios.

Clase 53 · Custodia institucional de claves

¿Cómo se evita que una persona o falla única controle los activos?

Experiencia propia: ceremonia institucional de firma. Evidencia: Política de firma con quórum, límites, recuperación y trazabilidad.

Clase 54 · Identidad y autorización verificable

¿Cómo demostramos atributos sin convertir la wallet en una identidad universal?

Experiencia propia: diseño de divulgación mínima. Evidencia: Flujo de emisión y verificación con minimización y revocación.


Todo lo que has construido en las catorce clases anteriores —stablecoins, depósitos tokenizados, bonos, mercados— se reduce, al final, a quién puede firmar. La llave es el activo. Y la pregunta institucional no es "¿cómo la guardo?" sino la mucho más difícil: ¿cómo consigo que ninguna persona sola pueda mover fondos, que la operación siga siendo posible si tres personas faltan, y que todo quede auditado?

La segunda mitad de la unidad es la otra cara de la misma moneda: si el token restringe transferencias a inversores elegibles (clases 49–50), alguien tiene que probar quién es quién sin convertir cada operación en una fotocopia del pasaporte. Ahí entran identidad descentralizada, credenciales verificables y las finanzas abiertas.

🎯 Objetivos

📚 Resultados de aprendizaje

Al finalizar, el estudiante podrá:

  1. Elegir un modelo de custodia justificándolo con importe, obligación normativa y perfil operativo.
  2. Diseñar una política de cuórum que sobreviva a la pérdida de firmantes sin crear un punto único.
  3. Explicar qué protege y qué no protege cada una de las tres tecnologías de firma.
  4. Documentar una ceremonia de claves con sus controles y su evidencia.
  5. Modelar un flujo de credencial verificable con emisor, tenedor y verificador.
  6. Situar el consentimiento de finanzas abiertas frente al control de llaves, sin confundirlos.

🗺️ Temas

# Tema Por qué importa
1 Los cuatro modelos de custodia Autocustodia, terceros, institucional, calificada
2 Temperatura: caliente, templada, fría El intercambio entre disponibilidad y exposición
3 Multifirma on-chain Política visible y auditable en el contrato
4 MPC: firma sin reconstruir la clave Qué mejora y qué oculta
5 HSM y elemento seguro La clave que nunca sale del hardware
6 Derivación jerárquica (BIP-32/39/44) Una semilla, miles de cuentas, un solo respaldo
7 Cuentas inteligentes y abstracción de cuenta Políticas programables sobre la propia cuenta
8 Ceremonias, rotación y recuperación Lo que se ensaya antes de necesitarlo
9 Identidad descentralizada y credenciales verificables Probar sin revelar de más
10 Finanzas abiertas y consentimiento Otro modelo de autorización, no el mismo

🧠 Modelo mental

Una llave privada es la firma de un notario que no se puede falsificar y no se puede revocar. Quien la tiene, es. No hay atención al cliente, no hay "he sido yo, devuélvemelo" y no hay tribunal que obligue a la cadena a deshacer lo firmado.

La custodia institucional consiste en repartir esa firma para que nadie la tenga entera y en que, aun así, la organización pueda operar todos los días. Es el mismo problema que la banca resolvió con cajas fuertes de doble llave y separación de funciones, con una diferencia que lo cambia todo: si se pierden todas las copias, no hay reemisión. Un banco puede reimprimir un cheque; nadie puede reemitir una clave privada.

Límite de la analogía: la doble llave física protege un objeto en un sitio; aquí lo que se protege es la capacidad de autorizar, que puede ejercerse desde cualquier lugar del mundo en cualquier momento. Por eso la política no es solo criptográfica: incluye quién, cuándo, cuánto y hacia dónde.

🧩 Esquema visual

Los cuatro modelos, por control y por responsabilidad:

flowchart TD
    subgraph AUTO["Autocustodia"]
        A1["El usuario tiene la llave"] --> A2["Nadie mas puede mover"]
        A2 --> A3["Perdida = perdida total<br>sin recurso"]
    end
    subgraph TER["Custodia de tercero"]
        T1["El proveedor tiene la llave"] --> T2["Opera por cuenta del cliente"]
        T2 --> T3["Riesgo de contraparte<br>y de segregacion"]
    end
    subgraph INS["Custodia institucional"]
        I1["Llave repartida M-de-N"] --> I2["Politica, limites y traza"]
        I2 --> I3["Ninguna persona sola<br>puede mover fondos"]
    end
    subgraph CAL["Custodia calificada"]
        C1["Entidad autorizada"] --> C2["Segregacion y auditoria<br>exigidas por norma"]
        C2 --> C3["Supervision y seguro"]
    end

Credencial verificable: probar sin entregar el documento:

sequenceDiagram
    participant E as Emisor (banco, registro civil)
    participant T as Tenedor (persona)
    participant V as Verificador (plataforma)
    E->>T: emite credencial firmada<br>"es inversor elegible, mayor de edad"
    Note over T: la credencial vive en su wallet,<br>no en un servidor del verificador
    V->>T: solicita prueba de elegibilidad
    T->>V: presenta solo el atributo necesario<br>(divulgacion selectiva)
    V->>V: verifica la firma del emisor
    V-->>T: acceso concedido
    Note over V: el verificador nunca vio<br>el documento completo

📖 Conceptos y definiciones

🔬 Profundización

Multifirma, MPC y HSM: qué protege cada uno

Propiedad Multifirma on-chain MPC HSM
¿La clave completa existe alguna vez? Sí (N claves distintas) No Sí, dentro del hardware
¿La política es auditable públicamente? Sí, en el contrato No, es interna No, es interna
Coste en comisiones Mayor (varias firmas on-chain) Igual que una firma simple Igual que una firma simple
Compatibilidad entre cadenas Depende del contrato de cada red Alta: la firma es estándar Alta
Rotación de firmantes Transacción de gobernanza Reparto nuevo sin cambiar la dirección Cambio de política del dispositivo
Riesgo dominante Bug del contrato Implementación y proveedor Acceso físico y operación

La conclusión práctica no es cuál es mejor, sino qué preguntas hacer: con multifirma, "¿el contrato está auditado y quién puede cambiar los firmantes?". Con MPC, "¿quién implementó el protocolo, ha sido auditado, y qué pasa si el proveedor desaparece?". Con HSM, "¿quién tiene acceso físico y cómo se registra cada uso?".

Y una advertencia que la experiencia del sector ha cobrado cara: la mayoría de los incidentes graves de custodia no fueron roturas criptográficas. Fueron llaves con demasiados permisos, firmantes concentrados en la misma organización o el mismo servidor, interfaces de firma que mostraban algo distinto de lo que se firmaba, y compromisos de la estación de trabajo del firmante. La política de cuórum solo protege si los firmantes son realmente independientes: cinco llaves en cinco servidores del mismo administrador son una llave con cinco copias.

Diseñar el cuórum: la cuenta que casi nadie hace

Una política M-de-N tiene dos fallos posibles y opuestos:

Con 3 de 5: soporta el compromiso de hasta 2 firmantes y la pérdida de hasta 2. Con 2 de 3: soporta 1 y 1. Con 5 de 7: soporta 4 comprometidos pero solo 2 perdidos.

Y sobre esa base se construye lo demás, que es lo que convierte una configuración en una política:

  1. Independencia real: personas, dispositivos, ubicaciones y organizaciones distintas.
  2. Escalones por importe: hasta X, 2 de 5; por encima, 4 de 5 y ventana temporal.
  3. Lista de destinos permitidos para operaciones recurrentes; todo lo demás, cuórum alto.
  4. Retardo temporal en cambios de política: un atacante con cuórum tiene que esperar, y ese tiempo es la única oportunidad de detección.
  5. Recuperación probada: un firmante de respaldo cuya llave se ha usado al menos una vez en un ensayo. Un respaldo nunca probado no es un respaldo, es una suposición.

Una semilla, un árbol, un respaldo

La derivación jerárquica resuelve un problema operativo real: una organización necesita cientos de direcciones —por producto, por cliente, por finalidad— y respaldar cientos de claves es inviable. Con BIP-32/39/44, una sola semilla genera un árbol determinista:

m / 44' / 60' / 0' / 0 / 0     propósito / moneda / cuenta / cadena / índice

Cambiando el índice se obtienen direcciones distintas, sin relación pública entre ellas y todas recuperables del mismo respaldo. La clave pública extendida permite además generar direcciones de recepción y vigilar saldos sin capacidad de firma: contabilidad y conciliación pueden trabajar sin tocar nunca material sensible.

El precio, y hay que decirlo claro: la semilla es un punto único. Quien la obtenga controla el árbol entero. Por eso en entornos institucionales la semilla no es el sistema de custodia sino un componente dentro de él, protegido por reparto (Shamir o MPC), hardware y ceremonia. En los laboratorios de este programa nunca se guardan semillas reales: se usan valores de prueba conocidos y documentados como tales.

Identidad: probar sin entregar

Las clases 49–50 dejaron un requisito abierto: el token restringe transferencias a inversores elegibles, y alguien tiene que acreditar la elegibilidad. La solución ingenua —que cada plataforma recoja y almacene documentos— crea un problema serio: cada verificador se convierte en un depósito de datos personales, con su riesgo de filtración y su coste de cumplimiento.

El modelo de credenciales verificables invierte la relación. Un emisor de confianza (un banco que ya hizo la debida diligencia, un registro público) firma una afirmación sobre una persona. El tenedor la guarda en su wallet. El verificador comprueba la firma del emisor sin contactar con él y sin recibir el documento. Con divulgación selectiva —o con las pruebas de conocimiento cero de las clases 29–30— se puede demostrar "soy mayor de edad" o "soy inversor elegible" sin revelar la fecha de nacimiento ni el patrimonio.

Lo que este modelo no resuelve, y conviene no prometer: la revocación (¿sigue siendo válida la credencial hoy?), la vinculación entre la persona y su llave, la recuperación si pierde el dispositivo, y quién responde si el emisor certificó mal. Son problemas abiertos con soluciones parciales, y presentarlos como resueltos es el error más común del sector de identidad.

Finanzas abiertas es otra cosa, y conviene no mezclarlas. El consentimiento de un sistema de finanzas abiertas —como el que establece en Chile la Ley 21.521, desarrollado en regulación chilena— autoriza a un tercero a acceder a datos o iniciar un pago en tu nombre dentro del sistema bancario. Es autorización delegada y revocable sobre una relación existente. Una llave privada es control directo e irrevocable sobre un activo. Un producto que integre ambos mundos necesita las dos capas, claramente separadas, y equivocarse al describirlas ante un usuario es un problema serio.

💡 En una frase: custodiar no es guardar una llave, es diseñar quién puede autorizar qué, en cuánto tiempo y con qué evidencia — y probar que sigue funcionando cuando faltan personas.

🎓 Si ya dominas esto — lo que se descubre en el primer incidente
  • Firmar a ciegas es la vulnerabilidad más rentable. Si el firmante no puede verificar de forma independiente qué autoriza, la seguridad del cuórum es cosmética: bastan interfaces comprometidas para que cinco personas firmen algo distinto de lo que leen. La mitigación es verificación fuera de banda del destino y del importe.
  • La rotación sin ensayo no existe. Rotar firmantes es la operación más peligrosa del sistema: se ejecuta pocas veces, casi nunca se practica y un error deja los fondos inaccesibles. Debe ensayarse en un entorno idéntico antes de tocar producción.
  • La cuenta inteligente cambia el modelo de amenazas. Límites diarios, listas de destinos y recuperación social son mejoras reales; a cambio, la lógica de la cuenta es código que puede tener errores y que alguien puede actualizar. Se gana flexibilidad y se añade una superficie que antes no existía.
  • La segregación se comprueba, no se cree. Ante un custodio, la pregunta es si los activos están en cuentas separadas identificables como del cliente, y qué ocurriría en un concurso del custodio. La respuesta debe estar en un documento, no en una web comercial.
  • El respaldo es una copia más. Cada copia de la semilla es una superficie de ataque. El reparto (Shamir, MPC) es preferible a la duplicación, y cada fragmento necesita su propio control físico y su propia traza.
  • La revocación de credenciales filtra información. Consultar si una credencial sigue vigente puede revelar al emisor dónde se está usando. Las listas de revocación y los acumuladores criptográficos existen precisamente para evitarlo, y tienen su propio coste.

🧪 Laboratorio guiado

🧪 Estas prácticas están catalogadas y resueltas paso a paso en el catálogo de laboratorios.

  1. Política de cuórum, resistencia y congelación — simula compromisos y pérdidas de firmantes sobre varias configuraciones M-de-N y escalones por importe:
pnpm lab:quorum

Comprueba lo que la intuición no da: pasar de 3 de 5 a 4 de 5 duplica la resistencia al ataque y la paga con riesgo de congelación, mientras que pasar de 3 de 5 a 5 de 7 la duplica sin perder tolerancia a la pérdida. Ampliar N es lo que compra las dos cosas.

  1. Pruebas del bloque (junto con el resto de la suite):
pnpm test
  1. Ceremonia documentada. Escribe el acta de una ceremonia de generación de claves: participantes y sus roles, sala y controles, hardware, verificación de la integridad del software, generación, reparto, verificación de cada fragmento, prueba de firma, custodia física y testigos. Ensáyala con valores de prueba y anota qué salió distinto del guion.

  2. Flujo de credencial verificable. Modela sobre papel la elegibilidad de un inversor para el token restringido de las clases 49–50: quién emite, qué atributo se presenta, cómo se revoca y qué ve el verificador. Marca explícitamente qué datos no llegan a la plataforma.

📝 Reto verificable

Redacta la política de custodia de una tesorería institucional que mantiene activos tokenizados y opera a diario. Debe incluir: modelo elegido con su justificación (importe, obligación normativa, perfil operativo); tecnología de firma con las preguntas de auditoría respondidas; configuración de cuórum con el análisis de resistencia a compromiso y a pérdida; escalones por importe y destinos permitidos; separación de deberes nominal; guion de ceremonia y de rotación; procedimiento de recuperación probado; y el modelo de identidad para autorizar contrapartes.

Criterio de aceptación: la política resiste el compromiso de un firmante y la pérdida de otro sin bloquear la operación; ninguna persona puede iniciar y aprobar la misma operación; el procedimiento de recuperación indica cuándo se ensayó por última vez; y hay al menos un control que detecta —no solo previene— una firma indebida.

⚠️ Errores frecuentes

Síntoma Causa y cómo comprobarlo
"Tenemos multifirma, estamos seguros" Si los firmantes no son independientes es una llave con copias
Fondos congelados por perder llaves M demasiado alto o N demasiado bajo; recalcula con el laboratorio
Respaldo nunca probado Un respaldo sin ensayo es una suposición; ensáyalo con valores de prueba
Firmar sin verificar el destino Firma a ciegas; verifica importe y destino fuera de banda
"El custodio está regulado, hay segregación" Compruébalo en documentación contractual, no en la web comercial
Confundir MPC con multifirma MPC no expone política on-chain; multisig sí. Cambian las preguntas de auditoría
Guardar la semilla en gestor de contraseñas Punto único con acceso remoto; usa reparto y hardware
Confundir consentimiento de finanzas abiertas con control de llave Uno es autorización revocable, el otro control irrevocable
Emitir credenciales sin plan de revocación Una credencial que no se puede revocar es válida para siempre

🛡️ Seguridad y ética

🔗 Referencias

✅ Criterio de dominio


🧭 Navegación

⬅️ Clases 51–52 · Mercados de capitales on-chain · 📚 Índice del currículo · ➡️ Clases 55–56 · Regulación y cumplimiento


🧠 Autoevaluación de la unidad

Responde sin volver atrás. Cada opción incorrecta corresponde a un error frecuente documentado en estas clases: si fallas, la explicación te dice qué releer.