Saltar al contenido principal

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

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

Los usuarios de V1 tienen un 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

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.
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.
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.
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