Introducción
Proof of Humanity (PoH) es un registro de identidades humanas únicas resistente a ataques Sybil. Esta página cubre tanto V1 (red principal de Ethereum) como V2 (Gnosis Chain). Cada humano verificado recibe un ID de humanidad soulbound (humanityId) que persiste aunque cambie de billetera. PoH V2 usa Kleros Court para resolver las disputas cuando se impugnan los perfiles. A diferencia de V1, en la que cada registro estaba vinculado a una dirección de billetera concreta, V2 separa la identidad de la dirección. Un humano corresponde a un ID de humanidad, que corresponde a una dirección de billetera en cada momento. Si un usuario pierde el acceso a su billetera, puede eliminar la dirección perdida y volver a registrarse con una nueva usando el mismo humanityId.
Contratos inteligentes
Interfaces principales, estructuras de datos y direcciones de los contratos
V1 (Ethereum Mainnet)
PoH V1 funciona en la red principal de Ethereum y la integración con V1 sigue disponible. Un Fork Module permite que V2 reconozca los registros de V1. La integración con EPNS/Push Protocol que estaba activa en V1 se ha interrumpido, y en V2 la sustituyen Atlas + SendGrid. Para las direcciones de los contratos V1, consulta Direcciones de despliegue.V2 (Gnosis Chain)
Las secciones siguientes documentan los detalles técnicos de PoH V2. Notas técnicas para integradores:- Airdrop de PNK: los primeros 10.000 humanos verificados pueden reclamar 1.200 PNK, que se duplican haciendo staking en el Humanity Court. Un panel hace seguimiento de los registros y de las reclamaciones del airdrop.
- Limitación de Ledger: las billeteras de hardware no admiten actualmente EIP-7702 en Gnosis Chain, que es necesario para el flujo estándar de reclamación del airdrop. Hay disponible una guía de reclamación manual.
- Notificaciones por correo electrónico: cada paso del flujo del perfil activa notificaciones que Atlas procesa de principio a fin, incluidas las revocaciones pendientes, la actividad de avales, los flujos disputados y los resultados de las impugnaciones.
- Claves de evidencia: la interfaz escribe los archivos de evidencias con la clave de evidencia correcta. Court V1 y Dispute Resolver incluyen una solución de normalización para los envíos antiguos que usaban una clave incorrecta.
- Flujo de ejecución: el avance de los perfiles usa un flujo de ejecución de avance automático reescrito.
- Seguridad: las revisiones de seguridad del frontend cubren los vectores de ataque XSS, y la aplicación funciona con una versión parcheada de NextJS 15.
- En curso: un contrato distribuidor de recompensas por avales y un sistema de referidos (especificaciones técnicas en revisión).
Atlas es una biblioteca de backend interna solo para los equipos de desarrollo de Kleros. No está pensada para su uso o integración por parte de la comunidad.
Direcciones de los contratos
- Gnosis Chain (producción)
- Ethereum Mainnet (Fork Module de V1)
PoH V2 funciona en Gnosis Chain como cadena principal. El estado entre cadenas se sincroniza con otras cadenas mediante contratos puente. Los registros de V1 siguen siendo accesibles mediante un Fork Module.
Arquitectura
PoH V2 consta de tres capas:1
Registro de identidades
Contrato principal que gestiona los ID de humanidad, las solicitudes de registro, los avales y los periodos de impugnación. Cada ID de humanidad es un valor
bytes20 que identifica de forma única a un humano verificado.2
Sincronización entre cadenas
Los contratos puente propagan el estado de humanidad entre cadenas, lo que permite comprobar
isHuman() en cualquier red compatible.3
Resolución de disputas
Los registros impugnados crean disputas en Kleros Court. Los jurados evalúan las evidencias en vídeo y la validez de los avales conforme a la política de registro.
Modelo de identidad
humanityId igual a su dirección de registro original (bytes20(address)). Los usuarios de V2 reciben un nuevo humanityId único al registrarse.
Ciclo de vida del registro
Funciones clave
ID de humanidad soulbound
ID de humanidad soulbound
Los ID de humanidad persisten aunque cambie la billetera. Las aplicaciones que almacenan los datos por
humanityId en lugar de por dirección conservan la reputación y los activos de los usuarios aunque cambie la billetera subyacente.Verificación entre cadenas
Verificación entre cadenas
La función
isHuman() está disponible en varias cadenas mediante los contratos CrossChainProofOfHumanity. La sincronización usa infraestructura de puentes para propagar el estado de los registros.Compatibilidad con V1
Compatibilidad con V1
Un Fork Module permite que V2 reconozca los registros de V1. La llamada a
isHuman() comprueba automáticamente tanto los registros nativos de V2 como los de V1.Sistema de avales
Sistema de avales
Quienes se registran necesitan el aval de un humano verificado existente. El bot keeper procesa automáticamente los avales y las retiradas de recompensas, lo que reduce la intervención manual.
Recursos
Repositorio de GitHub
Código fuente de los contratos inteligentes
Aplicación en vivo
Interfaz de PoH en producción
Discord
Soporte para desarrolladores