Skip to main content

Getting Started

Welcome to the HumanPass Developer Guides. This section provides comprehensive documentation for developers looking to integrate HumanPass into their applications. HumanPass offers a cross-chain human identity and reputation framework that helps verify unique human identity across multiple blockchain environments.

Understanding HumanPass​

HumanPass is built on three core pillars:

  1. World ID Verification: Leveraging World Chain's Proof of Personhood to verify unique human identity
  2. Cross-Chain Identity: Extending verified identity across multiple blockchain environments through Soulbound Tokens (SBTs)
  3. Human Identity Score (HIS): A reputation framework that reflects verification level, linked accounts, and ecosystem engagement

By integrating HumanPass into your application, you can:

  • Filter out bots and Sybil accounts to create a more secure and trustworthy environment
  • Verify users' human status across multiple blockchain environments
  • Access users' Human Identity Scores to make informed decisions based on verification level
  • Leverage a unified human layer that works across different chains and platforms

Planned Integration Options​

HumanPass is developing a JavaScript SDK (JS-SDK) to provide a seamless way to integrate HumanPass verification into web applications. The SDK is scheduled for release in Q1 2026 as part of our roadmap.

Note: The JS-SDK is currently in development. This documentation outlines the intended functionality.

Key features will include:

  • World ID verification integration
  • Wallet connection and SBT verification
  • Social account verification
  • Human Identity Score (HIS) access
  • Cross-chain identity verification

Learn more about the planned JS-SDK →

Integration Process Overview​

  1. Choose an Integration Method: Select the integration method that best suits your application needs
  2. Register Your Application: Create a developer account and register your application (coming soon)
  3. Implement the Integration: Follow our step-by-step guides to implement the integration
  4. Test Your Integration: Use our testing tools to ensure your integration works correctly
  5. Deploy to Production: Once testing is complete, deploy your integration to production

Understanding the HumanPass Ecosystem​

HumanPass consists of two main components:

1. World Mini App​

The World Mini App serves as the primary interface for users to:

  • Create and verify their HumanPass profile
  • Connect their social accounts (Twitter/X, Telegram)
  • View their verification status and Human Identity Score (HIS)
  • Receive authentication requests from web applications

2. HumanPass Web Portal​

The HumanPass Web Portal (humanpass.world) allows users to:

  • Connect their blockchain wallets (currently EVM-compatible wallets)
  • Verify their identity across multiple chains
  • Access HumanPass-integrated dApps and services
  • View their Human Points and verification status

Your integration will interact with both components to provide a complete verification experience.

Best Practices​

When integrating HumanPass into your application, consider these best practices:

  1. Progressive Verification: Start with minimal verification requirements and progressively request more as needed
  2. Clear Communication: Help users understand what verification steps are required and why
  3. Privacy First: Only request the verification methods necessary for your application
  4. Error Handling: Implement proper error handling for verification failures and cancellations
  5. Testing: Thoroughly test your integration across different browsers and devices

Next Steps​

  • Explore the JS-SDK documentation to learn more about the planned integration options
  • Review the Technical Overview to understand the underlying architecture
  • Check our Roadmap for upcoming features and development milestones