VC type
Residency

TASKS LIST

  • Add introduction
  • Create use cases
  • Document schema
  • Create references to standards and protocols

Residency (RecidencyCredential) type.

The ResidencyCredential is a type of verifiable credential that certifies an individual's place of residence. Using a structured location schema, this credential provides a secure and verifiable way to confirm where a person lives without disclosing unnecessary personal information. It is particularly useful in scenarios where proof of residency is required, such as accessing local services, verifying eligibility for resident discounts, or confirming address details for official purposes.

For example, on the Human Cloud Network, grants may be distributed with restrictions that only allow grantees who reside in specific locations to qualify. A ResidencyCredential can be used to verify that applicants meet these geographic criteria, ensuring that resources are allocated appropriately and in accordance with grant guidelines. By using this credential, organizations can efficiently and securely confirm residency status, helping to streamline processes and maintain trust.

Examples

Example of Local Council Issued ResidencyCredential.

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://schema.org/"
  ],
  "type": [
    "VerifiableCredential",
    "ResidencyCredential"
  ],
  "issuer": {
    "id": "did:example:localgovernment456",
    "name": "City of Springfield",
    "logo": "ipfs://QmSpringfieldLogoHashExample"
  },
  "issuanceDate": "2024-08-08T00:00:00Z",
  "credentialSubject": {
    "id": "did:example:resident789",
    "type": "Person",
    "residence": {
      "@type": "Place",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "123 Main Street",
        "addressLocality": "Springfield",
        "addressRegion": "IL",
        "postalCode": "62701",
        "addressCountry": "US"
      }
    }
  },
  "nonTransferable": true,
  "proof": {
    "type": "JwtProof2020",
    "jws": "eyJhbGciOiJFZERTQSIsIm...signature"
  }
}

Example of Identity Service Issued ResidencyCredential with Evidence

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://schema.org/"
  ],
  "type": [
    "VerifiableCredential",
    "ResidencyCredential"
  ],
  "issuer": {
    "id": "did:example:identityservice123",
    "name": "Trusted Identity Service",
    "logo": "ipfs://QmIdentityServiceLogoHashExample"
  },
  "issuanceDate": "2024-08-08T00:00:00Z",
  "credentialSubject": {
    "id": "did:example:resident789",
    "type": "Person",
    "residence": {
      "@type": "Place",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "456 Elm Street",
        "addressLocality": "Springfield",
        "addressRegion": "IL",
        "postalCode": "62701",
        "addressCountry": "US"
      }
    }
  },
  "nonTransferable": true,
  "evidence": [
    {
      "type": "DocumentVerification",
      "documentType": "UtilityBill",
      "documentIssuer": "Springfield Utility Company",
      "issuanceDate": "2024-07-15",
      "verificationMethod": "VisualInspection",
      "description": "Utility bill issued less than 1 month ago, verified by visual inspection."
    },
    {
      "type": "DocumentVerification",
      "documentType": "Passport",
      "documentIssuer": "US Department of State",
      "issuanceDate": "2020-01-01",
      "verificationMethod": "VisualInspection",
      "description": "Passport verified by visual inspection to confirm identity."
    }
  ],
  "proof": {
    "type": "JwtProof2020",
    "jws": "eyJhbGciOiJFZERTQSIsIm...signature"
  }
}
Age OverKYC