How to Mint an Onchain Passport Using Human Protocol

What is an onchain passport

An onchain passport is a verifiable identity credential derived from your wallet history, distinct from physical IDs or simple wallet addresses. While a standard Ethereum address reveals only transaction balances and contract interactions, the onchain passport aggregates these signals into a human-centric score. This score acts as a digital proof-of-personhood, confirming that the wallet is controlled by a real person rather than a bot or a Sybil attack.

The system works by analyzing the history of connected services and transactions linked to your wallet. Instead of sharing sensitive personal data, the protocol uses the Ethereum Attestation Service (EAS) to create a verifiable attestation of your Passport data on the blockchain. This means the proof of your identity is stored on-chain, allowing dApps and protocols to verify your status without needing to trust a central authority.

This approach solves a critical problem in decentralized finance and governance: sybil resistance. By treating the wallet as a passport, protocols can ensure that one person receives one vote or one grant, regardless of how many wallets they control. It transforms a cold, anonymous address into a reputation-bearing entity that can participate in human-centric ecosystems.

You can think of your wallet as a bank account and the onchain passport as the ID card that proves you are the account holder. The bank sees the money, but the passport proves the human behind it. This separation of financial data from identity verification allows for privacy while maintaining trust in the system.

Prepare your wallet and browser

Before connecting to the Human Protocol, ensure your browser is ready with a compatible Web3 wallet. This setup is the foundation for signing transactions and storing your onchain identity stamps.

Install a Web3 Wallet Extension

If you do not have one, install a browser extension like MetaMask. Create a new wallet and securely back up your seed phrase offline. Never share this phrase with anyone or store it in a cloud service. This phrase is the only way to recover your funds if you lose access to your browser.

Access the Human Passport App

Navigate to the official Human Passport application at app.passport.xyz. The site will prompt you to connect your wallet. Click the "Connect Wallet" button and approve the connection request in your extension popup. This step verifies that you control the address you are using for verification.

Verify Your Browser Environment

Ensure your browser is up to date and that no ad blockers are interfering with the wallet connection. Some privacy extensions may block the Web3 provider detection. If the connection fails, try disabling extensions temporarily or using an incognito window to isolate the issue.

Collect verification stamps

To build a credible Onchain Passport, you must attach identity signals—called stamps—from external services to your wallet. Each stamp provides cryptographic proof of a specific attribute, such as GitHub activity, Twitter presence, or ENS ownership. These verified data points combine to form your Unique Humanity Score.

Connect the following services to maximize your identity verification. Start with the most impactful providers to ensure your score meets the threshold for application access.

1

Connect GitHub

Link your GitHub account to verify your developer history. The system checks for public repositories, commit frequency, and account age. This stamp is essential for proving technical engagement on the web.

2

Link Twitter/X

Verify your Twitter profile to establish social identity. The verification process confirms account age and activity levels. This helps distinguish human users from automated bots.

3

Verify ENS Name

Attach an Ethereum Name Service (ENS) domain if you own one. This provides a persistent, human-readable identifier linked to your wallet address, adding a layer of established identity to your profile.

4

Add Additional Stamps

Connect other supported providers like LinkedIn, Discord, or BrightID to further diversify your identity signals. Each additional verified stamp increases your humanity score, improving your eligibility for dApp access.

Previous

1234

Next

Once connected, the Passport system processes these proofs in the background. You can monitor your progress directly on the Human Passport dashboard. Keep in mind that some stamps require manual review or may take time to propagate across the network.

Note: The verification process relies on official APIs from these providers. Ensure you are connecting through the official Passport interface to avoid phishing attempts or data leaks.

Check your humanity score

Once you have collected stamps from various identity providers, the Human Protocol aggregates this data to calculate your Unique Humanity Score. This score is not a static number; it updates dynamically as you verify new attributes or complete additional tasks. You can view your current standing directly within the Human Passport dashboard.

For most decentralized applications (dApps), the system requires a minimum score of 20 to confirm that you are a unique human. This threshold is designed to filter out bots and Sybil attackers while allowing legitimate users with partial verification profiles to participate. If your score falls below 20, you will likely be blocked from accessing specific features, such as voting in governance or claiming airdrops.

If your score is too low, review the available stamp options in your dashboard. Some providers offer higher weightage than others, so prioritizing these can help you reach the 20-point benchmark more quickly. Remember that the goal is to prove unique humanity through diverse, reliable sources rather than simply accumulating points from a single provider.

Mint the onchain attestation

With your off-chain score calculated and verified, the final step is to convert that data into a permanent, on-chain record. This process uses the Ethereum Attestation Service (EAS) to create a verifiable attestation of your Human Protocol Passport data on the blockchain. This onchain attestation serves as a portable credential that proves your identity and reputation without exposing your raw personal data.

1. Connect your wallet

Navigate to the official Onchain Passport portal. Ensure you are on the correct domain to avoid phishing attempts. Click "Connect Wallet" and select the same Ethereum wallet you used to generate your score. This step links your blockchain identity to the attestation process.

2. Review your score

The interface will display your current Passport score. Take a moment to verify the data points included. Since this score is now becoming a permanent onchain record, ensure it accurately reflects your activity. If you need to update your data, return to the previous step to refresh your score before proceeding.

3. Submit the attestation

Click the "Mint Attestation" button. Your wallet will prompt you to confirm the transaction. Review the gas fees carefully; while some networks offer low-cost transactions, Ethereum mainnet fees can vary. Once confirmed, the attestation is recorded on-chain. You can then view your new credential on EAS scanners or integrate it into applications that support Human Protocol attestations.

Common setup errors to avoid

Minting your onchain passport is straightforward, but a few common missteps can halt the process or result in a low-scoring identity. These errors usually stem from wallet configuration issues or misunderstanding Human Protocol’s stamp requirements. Address them before you begin to ensure a smooth minting experience.

Sybil-resistant wallet misuse

A frequent error is using a wallet that lacks the necessary activity history or is flagged as automated. Human Protocol relies on "stamps"—verified proofs of human interaction—to assign a trust score. If you use a freshly created, empty wallet or a multi-sig setup that doesn’t reflect individual human behavior, your score may remain too low to mint a valid passport. Ensure your wallet has a history of genuine onchain interactions, such as signing transactions or interacting with reputable dApps, before attempting to mint.

Missing stamp requirements

Not all stamps are created equal. Some stamps, like those from Gitcoin Passport or Human Verification, carry more weight than others. A common pitfall is collecting too many low-value stamps while neglecting high-weight ones. For example, a GitHub commit stamp might verify activity but doesn’t strongly prove humanity on its own. Prioritize stamps that require identity verification, such as government ID checks or recognized social media profiles, to boost your score efficiently. Check the Human Passport dashboard to see which stamps are currently weighted most heavily.

Gas fee and network issues

Minting occurs on specific blockchains, typically Optimism or other EVM-compatible networks. A common error is attempting to mint on a network where the contract isn’t deployed or where gas fees are prohibitively high. Always ensure you have enough native token balance (e.g., ETH on Optimism) to cover gas costs. Additionally, verify that your wallet is connected to the correct network. Switching networks mid-process can cause transaction failures or silent drops. If the minting transaction hangs, check the block explorer for pending status rather than resubmitting immediately, which could lead to double-spending.

Onchain Passport setup checklist

Before you consider your onchain identity fully provisioned, verify these final steps. This checklist ensures your attestation is live and readable on the blockchain.

If any step fails, return to the Human Passport support page for troubleshooting. Your onchain history is now permanently recorded and ready for use in DeFi and other Web3 applications.

Frequently asked: what to check next