> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleros.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de integración

> Verifica humanos únicos con Proof of Humanity V2 mediante CrossChainProofOfHumanity en la red principal de Ethereum y en Gnosis Chain.

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

> [!NOTE]
>
> 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.

```solidity theme={null}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

interface ICrossChainProofOfHumanity {
    function isHuman(address account) external view returns (bool);
    function humanityOf(address account) external view returns (bytes20);
}

contract HumanOnly {
    ICrossChainProofOfHumanity public immutable proofOfHumanity;

    error NotHuman();

    constructor(address crossChainProofOfHumanity) {
        proofOfHumanity = ICrossChainProofOfHumanity(crossChainProofOfHumanity);
    }

    modifier onlyHuman() {
        if (!proofOfHumanity.isHuman(msg.sender)) revert NotHuman();
        _;
    }

    function humanOnlyAction() external onlyHuman {
        // Application logic
    }
}
```

### Direcciones de CrossChainProofOfHumanity

| Red | CrossChainProofOfHumanity |
| - | - |
| Ethereum Mainnet | `0xa478095886659168E8812154fB0DE39F103E74b2` |
| Gnosis Chain | `0x16044E1063C08670f8653055A786b7CC2034d2b0` |

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

> [!WARNING]
>
> 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:

```solidity theme={null}
function isClaimed(bytes20 _humanityId) external view returns (bool);
function boundTo(bytes20 _humanityId) external view returns (address);
```

| Función | Propósito |
| - | - |
| `isClaimed(humanityId)` | Devuelve true si el ID de humanidad está reclamado activamente |
| `boundTo(humanityId)` | Devuelve la dirección de billetera vinculada actualmente a un ID de humanidad |

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](https://docs.kleros.io/es/developers/products/poh/smart-contracts.md).

***

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

```
humanity.owner == lostAddress      // Lost access
humanity.owner == address(0)       // Removal requested
humanity.owner == newAddress       // Re-registered with new wallet
```

> [!NOTE]
>
> 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`).

> [tab] Gnosis Chain
>
> | Contrato | Dirección |
> | - | - |
> | ProofOfHumanity | `0xa4AC94C4fa65Bb352eFa30e3408e64F72aC857bc` |
> | CrossChainProofOfHumanity | `0x16044E1063C08670f8653055A786b7CC2034d2b0` |
> | AMB Bridge Gateway | `0x6Ef5073d79c42531352d1bF5F584a7CBd270c6B1` |

> [tab] Ethereum Mainnet
>
> | Contrato | Dirección |
> | - | - |
> | ProofOfHumanityExtended | `0xbE9834097A4E97689d9B667441acafb456D0480A` |
> | CrossChainProofOfHumanity | `0xa478095886659168E8812154fB0DE39F103E74b2` |
> | AMB Bridge Gateway | `0xddafACf8B4a5087Fc89950FF7155c76145376c1e` |
> | Fork Module | `0x068a27Db9c3B8595D03be263d52c813cb2C99cCB` |

***

## ¿Qué sigue?

> [card] [Descripción general de PoH](https://docs.kleros.io/es/developers/products/poh/overview.md)
>
> Arquitectura y detalles técnicos

> [card] [Contratos inteligentes](https://docs.kleros.io/es/developers/products/poh/smart-contracts.md)
>
> Interfaces principales y estructuras de datos


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.