Verification Result

The VerificationResult type is the response returned by SelfBackendVerifier.verify() from @selfxyz/core. It contains the verification status, disclosed identity attributes, and user context data.

VerificationResult

type VerificationResult = {
  attestationId: AttestationId;
  isValidDetails: {
    isValid: boolean;
    isMinimumAgeValid: boolean;
    isOfacValid: boolean;
  };
  forbiddenCountriesList: string[];
  discloseOutput: GenericDiscloseOutput;
  userData: {
    userIdentifier: string;
    userDefinedData: string;
  };
};

Fields

Field	Type	Description
attestationId	AttestationId	Identifier for the attestation type (passport, national ID, etc.)
isValidDetails.isValid	boolean	Whether the ZK proof verified successfully on-chain
isValidDetails.isMinimumAgeValid	boolean	Whether the user meets the configured minimum age requirement
isValidDetails.isOfacValid	boolean	Whether the user passed the OFAC sanctions check
forbiddenCountriesList	string[]	Country codes unpacked from the proof's public signals
discloseOutput	GenericDiscloseOutput	Disclosed identity attributes from the ZK circuit
userData.userIdentifier	string	User identifier extracted from the verification context
userData.userDefinedData	string	Application-defined data passed through the verification flow

GenericDiscloseOutput

The disclosed identity attributes requested during verification. Only fields that were requested in the disclosure configuration will contain meaningful values.

type GenericDiscloseOutput = {
  nullifier: string;
  forbiddenCountriesListPacked: string[];
  issuingState: string;
  name: string;
  idNumber: string;
  nationality: string;
  dateOfBirth: string;
  gender: string;
  expiryDate: string;
  minimumAge: string;
  ofac: boolean[];
};

Fields

Field	Type	Description
nullifier	string	Unique nullifier derived from the proof (prevents double-use)
forbiddenCountriesListPacked	string[]	Packed representation of forbidden countries from the circuit
issuingState	string	Three-letter code of the document's issuing country
name	string	Full name from the identity document
idNumber	string	Document number
nationality	string	Three-letter nationality code
dateOfBirth	string	Date of birth
gender	string	Gender as recorded on the document
expiryDate	string	Document expiry date
minimumAge	string	The verified minimum age value
ofac	boolean[]	OFAC check results

VerificationConfig

The configuration passed to SelfBackendVerifier to specify what checks to perform.

type VerificationConfig = {
  minimumAge?: number;
  excludedCountries?: Country3LetterCode[];
  ofac?: boolean;
};

Field	Type	Description
minimumAge	number (optional)	Minimum age requirement. Verification fails if the user is younger.
excludedCountries	Country3LetterCode[] (optional)	List of three-letter country codes to exclude
ofac	boolean (optional)	Whether to check the user against the OFAC sanctions list