proof-of-passport-sdk v1.0.0

SDK

Installation

yarn add @proofofpassport/sdk

Development

yarn install-sdk

Tests

yarn test

How to use

Web2 applications

To use the ProofOfPassportWeb2Verifier in Web2 applications, import and initialize it as follows:

import { ProofOfPassportWeb2Verifier } from '@proofofpassport/sdk';
const verifier = new ProofOfPassportWeb2Verifier({
scope: "yourScope",
requirements: [["older_than", "18"], ["nationality", "France"]]
});

parameters for ProofOfPassportWeb2Verifier

Finally, verify the proof: The function fired from the Proof of Passport app will send a ProofOfPassportWeb2Inputs object.

const result = await verifier.verify(proofOfPassportWeb2Inputs); // proofOfPassportWeb2Inputs : ProofOfPassportWeb2Inputs

Web3 application

For Web3 applications, use the ProofOfPassportWeb3Verifier as follows:

import { ProofOfPassportWeb3Verifier } from '@proofofpassport/sdk';
const verifier = new ProofOfPassportWeb3Verifier({
scope: "yourScope",
rpcUrl: "https://custom.rpc.url"
});

Parameters for ProofOfPassportWeb3Verifier

Verify the user owns a sbt which satisfies the requirements:

const result = await verifier.verify(address, tokenId);

Handle the report

Each verification will returns a ProofOfPassportReport object which contains all the informations about the verification of each requirement.

If a requirement is not satisfied, the corresponding field will be set to true. The valid field will be false if there is at least one requirement that is not satisfied.

nullifier and user_identifier are also accessible as report fields.

const report = await verifier.verify(publicSignals, proof);
const nullifier = report.nullifier;
const userIdentifier = report.user_identifier;