Human verification for Lens

Assert your Lens profile belongs to an actual human through Worldcoin's World ID protocol.

ℹ️ About

This repository contains the smart contract that enables verification of Lens Protocol profiles as owned by a unique human.

• The verification is always exposed on-chain.
• Human verification is done via the World ID protocol.
• A single human can only have one verified Lens profile. Verifying a new profile will remove the verification from the previous profile.

🚀 Deployment

The official World ID <> Lens smart contract can be found at 0x8f9b3A2Eb1dfa6D90dEE7C6373f9C0088FeEebAB on the Polygon Network. To deploy your own version of this contract, follow these instructions.

1. Get an Action ID from Worldcoin's Developer Portal.
2. Run make, then make deploy.

🧑‍💻 Development & testing

1. Install Foundry.

   curl -L https://foundry.paradigm.xyz | bash
   foundryup # run on a new terminal window; installs latest version

2. Install Node.js v16 or above (required for tests). We recommend nvm if you use multiple node versions.
3. Install dependencies & build smart contracts

   make

4. Run tests

   make test

Using the contract

To test the contract with your own deployment, we recommend you use World ID's Staging network,

1. Point your smart contract to the World ID's Staging network contract, which can be found at https://developer.worldcoin.org/api/v1/contracts.
2. Register an identity as "verified" using Worldcoin's Simulator. Be sure to click on verify identity.
3. Use the hosted World ID's widget & the Simulator to generate a ZKP to execute the humanity check.
   • Easiest way is to visit https://id.worldcoin.org/use?action_id={your_action_id}&signal={lensProfileId}&return_to=https%3A%2F%2Flocalhost%3A8000
   • When you click on the widget you'll get a QR code, copy it and paste it in the simulator.
   • After going through the process on the Simulator, you'll get the proof, nullifier hash & Merkle root in your return URL (as query string parameters).
4. Call HumanCheck.verify(PROFILE_ID, merkle_root, nullifier_hash, proof) in your contract. The last three parameters are obtained on step 6.
5. You can now check your profile is verified by calling HumanCheck.isVerified(PROFILE_ID).