Generating Mock Credentials

Create test credentials for development and testing. Mock data generation for SDK flows and on-chain verification without real palm scans.

As developer you may want to generate mock credentials to test against your applications.

Humanity provides a testing playground through a credentials generator that is tied both to sandbox environment when working with the SDK / API and Humanity testnet when working with On-Chain infrastructure.

The process involves

1. Creating the Mock Credential.
2. Using the Mock Credential.

1. Creating the Mock Credential

1. Go to https://app.sandbox.humanity.org/ and Sign up or Log in.
2. Once inside the Dashboard, select the Create tab and search for the credential you want to generate.

In the example below we are going to create a mock credential for Palm Print which is included under the API's identity:read scope.

The scope exposes the is_human preset, allowing us to check whether or not an account has passed a KYC check OR palm enrollment via mobile app or hardware.

ℹ️ A complete list of scopes and presets and how they are bundled is here SDK OAuth Scopes and Presets

Select the credential then click Generate Credential to complete the process.

Once created, you can view all your current active credentials as well as delete them from the View/Delete tab.

2. Using the Mock Credential

Working with the SDK / API

Visit the Developer Portal at https://developers.humanity.org/ and select the application you want to work with.

Then go to Settings tab and select the scopes your application is going to request matching the mock credentials you generated from the Credentials Generator.

Make sure you are under sandbox tab when selecting your app scopes.

In the example below we are setting our app to request is Human by selecting Identity Information mapped as identity:read scope which includes the Is Human field.

Your app then will request your users for consent to expose the identity:read scope which included the is_human preset through the OAuth flow so you can check your app against your generated mock credentials.

Working On-Chain

Your dApp can check against these mock credentials as well when working with testnet . Think of it as the equivalent of the sandbox environment when working with the SDK / API . This way you can, for example, check if a user is a unique human (went through palm or vein scan) and safely test that credential in your dApp.

The image above shows the front end for an dApp deployed on testnet which is checking a wallet address against the On-Chain Oracle returning the requested credential (with claimID humanity_identity ) for our dApp to determine whether or not a particular wallet address is eligible for an airdrop.