Documentación de Integración
API de verificación humana para proyectos Web3. Prevén bots y sybils en tus airdrops, DAOs y juegos.
Contrato de Prueba (Testnet)
Polygon Amoy (Testnet) Chain ID: 80002
0xD9f766cCbE8EBb138925D22cEA589B1c5faEdEf8
Faucet para POL (gas): faucet.polygon.technology
interface IHumanhood {
function checkHuman(address user) external view returns (bool);
}
function claimReward() external {
require(
IHumanhood(0xD9f766cCbE8EBb138925D22cEA589B1c5faEdEf8).checkHuman(msg.sender),
"Not verified as human"
);
}
Contratos de Producción (Mainnets)
Elige la red que mejor se adapte a tu proyecto. El mismo contrato funciona en todas.
| Red | Dirección del contrato | Precio por consulta |
|---|---|---|
| 🟣 Polygon Mainnet | 0x2A7396876a13812fEFc5773094f217d5380FEeB9 | $0.05 (recomendado) |
| 🟡 BNB Chain (BSC) | 0xeCB6D54ac87D99b104535f95d5c38Bf48F2CCf4b | $0.05 |
| ⚪ Ethereum Mainnet | Próximamente En desarrollo | $0.10 |
¿Cómo funciona Humanhood?
Humanhood es una API de verificación humana descentralizada. Permite que cualquier proyecto Web3 sepa si una wallet pertenece a un humano real o a un bot, pagando solo por las consultas que realiza.
🔄 Flujo completo del sistema
1. Usuario final se verifica en humanhood.tech (paga gas una vez) 2. Su wallet queda marcada como humana en la blockchain 3. Tu proyecto consulta checkHuman(wallet) 4. Si es true, el usuario recibe la recompensa 5. Tu proyecto paga $0.05 por cada consulta
🧑💻 Lo que debe hacer TU PROYECTO
- 1. Integrar nuestro contrato (3 líneas de código)
- 2. Depositar USDC en nuestro contrato (mínimo 10 USDC)
- 3. Por cada usuario, llamar a checkHuman(wallet) → cuesta $0.05
🧑💻 Lo que debe hacer el USUARIO FINAL
- 1. Conectar su wallet en humanhood.tech
- 2. Hacer clic en "Verificarme como humano" (solo paga el gas)
- 3. Su wallet queda marcada como humana para siempre ✅
📝 Código de integración para tu contrato
interface IHumanhood {
function checkHuman(address user) external view returns (bool);
}
function claimReward() external {
require(
IHumanhood(0x2A7396876a13812fEFc5773094f217d5380FEeB9).checkHuman(msg.sender),
"You are not verified as human"
);
// Tu lógica de recompensa aquí
}
✅ Resumen para tu proyecto
- 📌 Tus usuarios se verifican UNA SOLA VEZ en humanhood.tech
- 📌 Tu proyecto paga $0.05 por cada consulta a checkHuman()
- 📌 El usuario NO PAGA NADA (solo el gas una vez en su vida)
- 📌 Puedes probar gratis en testnet (Polygon Amoy)
Depositar USDC
Para usar nuestro servicio de pago por consulta, necesitas depositar USDC en nuestro contrato.
❓ Preguntas frecuentes
¿Cuánto cuesta la verificación?
Prueba gratuita: 1,000 consultas gratis en testnet.
Producción: $0.05 en Polygon o BNB Chain, $0.10 en Ethereum.
¿Qué red debo usar?
Pruebas: Polygon Amoy (testnet).
Producción: Polygon Mainnet (recomendado).
¿Necesito backend?
No. Todo es mediante contratos inteligentes.
🆘 ¿Necesitas ayuda?
Contacta con nosotros en info@humanhood.tech.