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
UsaCrossChainProofOfHumanity 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.
Consulta de la identidad
Una vez que tienes unhumanityId 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. ElhumanityId 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 conProofOfHumanity (y, en la red principal de Ethereum, con ProofOfHumanityExtended).
- Gnosis Chain
- Ethereum Mainnet
¿Qué sigue?
Descripción general de PoH
Arquitectura y detalles técnicos
Contratos inteligentes
Interfaces principales y estructuras de datos