Skip to main content

Human Passport

You can attach a Human Passport (formerly Gitcoin Passport) Proof of Personhood score to your DEMOS address by following these steps. The default score threshold the node enforces when linking is 20.

1. Connect your wallet

2. Fetch the Human Passport Score

Retrieve the Human Passport score for the EVM address you want to link. The score is fetched from the node’s cached data (not directly from the Human Passport API) via the gcr_routine mechanism.

3. Send an Identity request

Build a HumanPassportIdentityData payload and submit the link transaction. Required and optional fields:
  • address — required EVM address being verified.
  • verificationMethod — required, either "api" or "onchain".
  • chainId — required when verificationMethod is "onchain". The SDK throws if it is missing.
  • signature — optional, for enhanced verification.
  • referralCode — optional.
The node verifies the Human Passport score and persists the identity if the score meets the threshold (default: 20).
A successful transaction response should look like this:

4. Getting linked Human Passport identities

After the confirmation block has been forged, you can list the Human Passport identities linked to a DEMOS address. The method returns an array of SavedHumanPassportIdentity records (address, score, stamps, verification method, timestamps).

5. Removing a Human Passport identity

You can create a transaction to remove a linked Human Passport identity. Only the EVM address is needed.
A successful transaction response should look like this: