Skip to main content

Residency

ZKPassport is not only limited to passports or even national (or citizen) IDs, but also supports some residence permits. Electronic residence permits are not as common as electronic passports or national IDs, but they exist. France and Germany are examples of countries that issue electronic residence permits.

These examples use the @zkpassport/ui card.

Check residency​

Check if the user is resident of a specific country. France is used as an example here since Titre de Séjour are now electronic residence permits.

import { ZKPassportQRCode } from "@zkpassport/ui/react";

<ZKPassportQRCode
  name="ZKPassport"
  logo="https://zkpassport.id/logo.png"
  purpose="Prove you are resident in France"
  scope="france-resident"
  query={(queryBuilder) =>
    queryBuilder.eq("document_type", "residence_permit").eq("issuing_country", "France").done()
  }
  onResult={({ verified, result }) => {
    if (verified) {
      const isResidentInFrance =
        result.document_type.eq.result && result.issuing_country.eq.result;
      console.log("User is resident in France", isResidentInFrance);
    } else {
      console.log("Verification failed");
    }
  }}
/>;

Check EU residency​

Check if the user is resident of a group of countries. EU is used as an example here, as there are multiple countries in the EU issuing electronic residence permits. Only the query and result handling change — drop them into the same card as above.

import { EU_COUNTRIES } from "@zkpassport/sdk";

const query = (queryBuilder) =>
  queryBuilder.eq("document_type", "residence_permit").in("issuing_country", EU_COUNTRIES).done();

const onResult = ({ verified, result }) => {
  if (verified) {
    const isEUResident = result.document_type.eq.result && result.issuing_country.in.result;
    console.log("User is resident in EU", isEUResident);
  }
};