Saltar al contenido principal

Guía de integración de Proof of Humanity 2.0

Esta guía está dirigida a los desarrolladores que quieren verificar si una dirección pertenece a un humano registrado.
Los integradores consumen la identidad mediante CrossChainProofOfHumanity. Quienes operan PoH gestionan el registro mediante ProofOfHumanity. Si estás integrando PoH en una aplicación, solo necesitas CrossChainProofOfHumanity.

Inicio rápido: verifica a un humano

Usa CrossChainProofOfHumanity como contrato de integración en todas las cadenas compatibles. Expone tanto las humanidades registradas localmente como las sincronizadas entre cadenas.

Direcciones de CrossChainProofOfHumanity

  • Usa isHuman(address) cuando solo necesites verificar que es un humano.
  • Usa humanityOf(address) y almacena los datos de la aplicación por ID de humanidad cuando la identidad deba sobrevivir a los cambios de billetera.
El estado entre cadenas se entrega mediante la sincronización de los puentes, por lo que un registro, una revocación o una transferencia recientes pueden no aparecer de inmediato en otra cadena.

Consulta de la identidad

Una vez que tienes un humanityId a partir de humanityOf(address), estas funciones de solo lectura ofrecen más detalles:
Para consultar el estado completo de una humanidad (estado de los avales, solicitudes pendientes, vencimiento, propietario) mediante getHumanityInfo(humanityId), y las funciones de gestión del registro que usan los operadores, consulta la referencia de contratos inteligentes.

Diseño de la identidad soulbound

PoH V2 sigue el principio: 1 humano → 1 ID de humanidad ↔ 1 dirección de billetera. El humanityId es un identificador soulbound que persiste entre cambios de billetera. Si un usuario pierde el acceso a su billetera, puede volver a registrarse con una nueva dirección conservando el mismo humanityId. Las aplicaciones que asocian la reputación, los activos o el historial al humanityId en lugar de a la dirección los conservan cuando el usuario cambia de billetera.
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. La llamada a isHuman() cubre automáticamente los registros de V1 mediante el Fork Module.

Direcciones de los contratos de registro

Quienes gestionan el registro directamente interactúan con ProofOfHumanity (y, en la red principal de Ethereum, con ProofOfHumanityExtended).

¿Qué sigue?

Descripción general de PoH

Arquitectura y detalles técnicos

Contratos inteligentes

Interfaces principales y estructuras de datos