Quick Start
Testing with the World ID Simulator
On-chain apps will see a delay of 5-30 minutes for verifications of new identities. If you're testing an on-chain app, please reference the On-Chain Verification documentation for details.
To develop and test with World ID, you can set up staging apps. Staging apps use the protocol's staging network. This network is intended to aid with development, and it provides more flexibility to create new identities, issue credentials and try different edge cases.
The staging network uses a separate infrastructure and has the following key characteristics:
- Identities and credentials are managed in the World ID Simulator. The Simulator is used instead of the World App or other clients.
- Proofs can be verified using the Debugger tab in the Developer Portal.
- For on-chain verifications, the World ID smart contract is deployed to the Polygon Mumbai-Testnet.
Access the World ID Simulator at https://simulator.worldcoin.org to generate test identities and credentials.
Using the Staging network
Using the staging network as an end user is simple, just go to the World ID Simulator on either a mobile device or a desktop browser.
- Create or load a staging identity. Read more about identity generation here.
- Get your Orb credential by verifying your identity within the Simulator.
- Note that it may take identities 3-5 minutes to be verified.
- Scan or paste a QR code generated by the IDKit Widget.
- If you are testing your on desktop, you can click the QR code to copy it to your clipboard to paste into the Simulator.
Verifying proofs
If your action is running on Cloud, all you have to do is ensure you're using the Staging app's App ID. When you create an action you select whether you want to run it in staging or production mode and the Developer Portal will do the proper validation automatically for you in the Debugger.
About identity generation
When you use the simulator you are required to generate or load a World ID identity first. You can either generate a temporary identity which is stored on localStorage and persisted until you log out or clear your browser storage, or generate an identity with any ETH wallet for stronger persistence.
When you generate an identity with an external wallet, we use a signature from your wallet to generate the seed entropy for your identity. This means, if you ever use the same wallet again on the simulator, the same World ID identity will be generated, which can help with persistence and working across devices. Your wallet's private key is never exposed to the simulator.