Unify energy VCs into Electricity Credentials by Anusree-J · Pull Request #208 · beckn/DEG

Anusree-J · 2026-03-24T04:36:17Z

Summary

Consolidates four separate energy Verifiable Credentials (utility-customer, consumption-profile, generation-profile, storage-profile) into a single Customer Credential (electricity-credential/) and restructures the Program Enrollment Credential to share data objects with it.

What changed

Unified credential: A single CustomerCredential (W3C VC 2.0) issued per meter, with five sections under credentialSubject:
- customerProfile (required) — customer number, meter number, meterType enum (from Green Button/ESPI), identity reference
- customerDetails (required) — name, installation address (aligned with beckn Location schema + openLocationCode), service connection date
- consumptionProfile (optional) — premises type, connection type, sanctioned load, tariff
- generationProfile (optional) — DER type, capacity, commissioning date, manufacturer
- storageProfile (optional) — battery capacity, power rating, storage type
W3C VC Data Model 2.0 upgrade: Both credentials now use validFrom/validUntil (replaces issuanceDate/expirationDate), credentials/v2 context, and all date-time values carry explicit timezone offsets.
Reusable patterns introduced:
- idRef (issuedBy DID + subjectId) — replaces licenseNumber on issuers and maskedIdNumber/maskedIdType on customers
- credentialStatus — structured DeDi revocation with statusPurpose and statusListCredential
Program Enrollment restructured: credentialSubject now uses optional customerProfile and customerDetails objects (same shape as the Customer Credential) instead of flat consumerNumber/fullName fields. enrollmentValidUntil replaces validUntil to avoid collision with the VC-level field.
Namespace migration: utility: → deg: prefix; all context/schema URLs moved from nfh-trust-labs.github.io to schema.beckn.io.
Old schemas archived: The four individual profile VCs moved to eos-schemas/ for reference.

Files added/changed

Path	Change
`electricity-credential/`	New — schema.json, context.jsonld, example.json, readme.md
`program-enrollment-vc/`	Restructured schema, context, example, readme
`eos-schemas/`	Archived original per-profile VCs (renames only)
`readme.md` (top-level)	Updated overview, directory structure, shared patterns docs
`examples/program-enrollment-vc.json`	Deleted (superseded by in-folder example)

Test plan

Validate electricity-credential/example.json against electricity-credential/schema.json using a JSON Schema draft 2020-12 validator
Validate program-enrollment-vc/example.json against program-enrollment-vc/schema.json
Verify @context URLs in both examples resolve or are consistent with schema.beckn.io conventions
Confirm eos-schemas/ contains all original files (no data loss from the archive move)

🤖 Generated with Claude Code

Combines the 4 separate credentials (utility-customer, consumption-profile, generation-profile, storage-profile) into a single W3C VC using the credentialSubject array pattern. The 5 equal-level subjects are: - ConsumerProfile (meterNumber, consumerNumber, maskedIdNumber) - ConsumerDetails (fullName, installationAddress, serviceConnectionDate) - ConsumptionProfile (premisesType, connectionType, sanctionedLoadKW, tariffCategoryCode) - GenerationProfile (generationType, capacityKW, commissioningDate, manufacturer, modelNumber) - StorageProfile (storageCapacityKWh, powerRatingKW, commissioningDate, storageType) https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Remove redundant id repetition across all 5 subjects. Now uses a single credentialSubject object with the consumer DID declared once at the top, and 5 equal-level sibling properties: consumerProfile, consumerDetails, consumptionProfile, generationProfile, storageProfile. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

1. credentialSubject.id now optional (per W3C VC Data Model) 2. serviceConnectionDate moved to customerProfile 3. Renamed to ElectricityCredential 4. Added validFrom/validUntil (VC Data Model 2.0 validity period) 5. Added maskedIdType alongside maskedIdNumber 6. Issuer id is now a URL (per W3C VC 2.0 issuer spec) 7. Added meterType (Smart, Conventional, Prepaid) to customerProfile 8. Renamed consumer → customer throughout https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Documents all classes, properties, ranges, and external vocabulary mappings used by the ElectricityCredential specification. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Renames the folder and updates all internal URIs (context.jsonld, schema.json, example.json) and the parent readme. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

- Delete utility-customer-vc, consumption-profile-vc, generation-profile-vc, storage-profile-vc - Restructure program-enrollment-vc to use shared customerProfile and customerDetails objects (both optional), matching the electricity credential structure - Upgrade program enrollment to W3C VC Data Model 2.0 (validFrom/validUntil instead of issuanceDate/expirationDate) - Rename validUntil field to enrollmentValidUntil to avoid collision with the VC-level validUntil - Update parent readme https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Use correct URL format: example-utility.com/vc-revocation-registry https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Only customerProfile is required in credentialSubject. customerDetails, consumptionProfile, generationProfile, and storageProfile are all optional. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

licenseNumber is no longer a required field on the issuer object. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Updated all references across both electricity-credential and program-enrollment-vc specs. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

…e, add geo/plusCode, fix meterType, remove UtilityIssuer - Rename ElectricityCredential to CustomerCredential (deg:CustomerCredential) - Change namespace prefix from energy: to deg: across all context files - Remove enum constraint from meterType (no standard list exists) - Add geo coordinates (latitude/longitude) and plusCode to installationAddress - Remove UtilityIssuer custom type, use standard W3C issuer property - Make licenseNumber optional in program-enrollment issuer - Update all readmes to reflect changes https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Change all schema $id and context URLs from nfh-trust-labs.github.io/vc-schemas to anusree-j.github.io/DEG/specification to point to the DEG repo itself. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

specification/energy-credentials/electricity-credential/example.json

ameetdesh · 2026-03-25T04:10:36Z

specification/energy-credentials/electricity-credential/example.json

+      "customerNumber": "UTIL-2025-001234567",
+      "meterNumber": "MET2025789456123",
+      "meterType": "Smart",
+      "maskedIdType": "SSN",


great to have maskedIdType!

specification/energy-credentials/electricity-credential/example.json

Anusree-J · 2026-03-25T16:24:51Z

specification/energy-credentials/electricity-credential/example.json

+  "issuer": {
+    "id": "https://example-utility.com/issuers/energy-dept",
+    "name": "Example Energy Utility",
+    "licenseNumber": "REG-2025-00001"


Anusree-J · 2026-03-25T16:33:34Z

specification/energy-credentials/electricity-credential/example.json

+  "validUntil": "2026-01-13T10:30:00Z",
+  "credentialStatus": {
+    "id": "https://dedi.global/dedi/query/example-utility.com/vc-revocation-registry",
+    "type": "dediregistry"


add statuspurpose = revocation
type = dedi

give both URLs

https://dedi.global/dedi/lookup/example-utility.com/vc-revocation-registry/hashed-value-of-cred

@context

…um, datetime offsets - Replace licenseNumber and maskedIdType/maskedIdNumber with reusable idRef pattern (issuedBy DID + authority-domain:id-value subjectId) - Update credentialStatus to full dedi structure with statusPurpose and statusListCredential - Add meterType enum from Green Button/ESPI: AMR, AMI, Electromechanical, Forward, Reverse, Bidirectional, Prepaid, NetMeter, Other - Convert all date fields to date-time with explicit timezone offset (non-GMT) - Update @context URLs to schema.beckn.io (no /energy/, no .jsonld extension) - Move old per-profile schemas and examples into eos-schemas/ archive - Rewrite all three readmes to reflect the new structures

Align the installationAddress object with the beckn protocol Location schema (https://schema.beckn.io/Location/2.0). All beckn Location fields included (id, descriptor, map_url, gps, address, city, district, state, country, area_code, circle, polygon, 3dspace, rating) plus openLocationCode as a DEG extension. Required fields: address, area_code, country. Context uses beckn: namespace for Location terms.

Add beckn Location context and update all DEG context URLs to use proper .jsonld paths (e.g., https://schema.beckn.io/deg/CustomerProfile/context.jsonld).

ameetdesh · 2026-03-31T15:56:06Z

Hi @Anusree-J could you add a PR description?

ameetdesh · 2026-04-01T02:53:02Z

specification/energy-credentials/electricity-credential/example.json

+    "https://schema.beckn.io/deg/CustomerDetails/context.jsonld",
+    "https://schema.beckn.io/deg/ConsumptionProfile/context.jsonld",
+    "https://schema.beckn.io/deg/GenerationProfile/context.jsonld",
+    "https://schema.beckn.io/deg/StorageProfile/context.jsonld"


will check with @ravi-prakash-v on whether he prefers flat class hierarchy vs. nested under deg. I presume, we will need to upload these, and in a follow-up, use $ref: url within schema.json to invoke them by reference.

ameetdesh · 2026-04-01T06:18:56Z

specification/energy-credentials/electricity-credential/example.json

+    "https://www.w3.org/ns/credentials/v2",
+    "https://schema.org/",
+    "https://schema.beckn.io/Location/2.0/context.jsonld",
+    "https://schema.beckn.io/deg/CustomerCredential/context.jsonld",


For future: We may want to add version names in folders, create those in specification/schema and publish them on schema.beckn.io under flat structure

ishdham · 2026-04-06T09:03:04Z

specification/energy-credentials/electricity-credential/readme.md

+| `meterType` | enum | Yes | Type of meter — see [meterType enum](#metertype-enum) |
+| `idRef` | object | No | External identity reference (e.g., government ID) — see [idRef](#idref) |
+
+#### meterType enum


Potential usability issue here by defining this as an enum. This seems to be mixing a set of orthogonal concepts.

Meter technology : AMR/AMI/Electromechanical
Direction : Forward/Reverse/Bidirectional
Payment settlement terms : Prepaid
Billing / settlement : NetMeter

Once can have a AMI, bidirectional, prepaid, netmetering meter.

The terms are also not obvious - e.g. Forward/Reverse. Would terms like Import/Export be easier?

ishdham · 2026-04-06T09:04:36Z

specification/energy-credentials/electricity-credential/readme.md

+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `premisesType` | enum | Yes | `Residential`, `Commercial`, `Industrial`, or `Agricultural` |


Shouldn't premiseType be part of customer profile

ishdham · 2026-04-06T09:05:34Z

specification/energy-credentials/electricity-credential/readme.md

+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `assetId` | string | No | Unique identifier for the generation asset |


This is a customer profile - should it be limited to 1 asset. What if I have solar and wind both installed?

ishdham · 2026-04-06T09:06:31Z

specification/energy-credentials/electricity-credential/readme.md

+| `generationType` | enum | Yes | `Solar`, `Wind`, `MicroHydro`, or `Other` |
+| `capacityKW` | number | Yes | Installed generation capacity in kW |
+| `commissioningDate` | date-time | Yes | Date and time when the system was activated |
+| `manufacturer` | string | No | Equipment manufacturer |


Is this manufacturer of inverter / grid connection / ...?

Restructure the schemas repo around a stable, versioned URL pattern (`schemas/<name>/v<version>/schema.json`) and replace placeholder content with real JSON Schemas. Cleanup: - Drop space-in-name `energy credentials/` directory - Move `schemas/salary-slip/{schema.json,README.md}` -> `schemas/salary-slip/v1/` - Rename the existing `schema.json` (which was a sample instance, not a schema) to `example.json` and add a real JSON Schema alongside it - Fix typo in root README, list available schemas, document URL pattern and immutability/versioning policy - Add CONTRIBUTING.md describing add/revise workflow Real schemas added under `schemas/<name>/v1/` with `$id` matching their raw GitHub URL: - education, employment, identity, health, business (sourced from OpenCred's bundled built-in templates) - electricity (Customer Credential, sourced from beckn/DEG#208 with upstream attribution) All schemas validated with ajv (draft-07 and 2020-12). Both examples (electricity, salary-slip) validate against their schemas. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Restructure the schemas repo around a stable, versioned URL pattern (`schemas/<name>/v<version>/schema.json`) and replace placeholder content with real JSON Schemas. Cleanup: - Drop space-in-name `energy credentials/` directory - Move `schemas/salary-slip/{schema.json,README.md}` -> `schemas/salary-slip/v1/` - Rename the existing `schema.json` (which was a sample instance, not a schema) to `example.json` and add a real JSON Schema alongside it - Fix typo in root README, list available schemas, document URL pattern and immutability/versioning policy - Add CONTRIBUTING.md describing add/revise workflow Real schemas added under `schemas/<name>/v1/` with `$id` matching their raw GitHub URL: - education, employment, identity, health, business (sourced from OpenCred's bundled built-in templates) - electricity (Customer Credential, sourced from beckn/DEG#208 with upstream attribution) All schemas validated with ajv (draft-07 and 2020-12). Both examples (electricity, salary-slip) validate against their schemas. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

claude and others added 20 commits March 23, 2026 12:09

Add per-meter credential note to readme

7d01c36

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Move serviceConnectionDate back to customerDetails

32327e5

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Add vocabulary file for energy profile VC

aed66a8

Documents all classes, properties, ranges, and external vocabulary mappings used by the ElectricityCredential specification. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Remove vocab.md — not needed

18db1b2

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Rename energy-profile-vc to electricity-credential

145f538

Renames the folder and updates all internal URIs (context.jsonld, schema.json, example.json) and the parent readme. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Fix DeDi revocation registry URLs in examples

4b45309

Use correct URL format: example-utility.com/vc-revocation-registry https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Make all credentialSubject sections optional except customerProfile

ae72cc7

Only customerProfile is required in credentialSubject. customerDetails, consumptionProfile, generationProfile, and storageProfile are all optional. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Make issuer licenseNumber optional

3a4ddcb

licenseNumber is no longer a required field on the issuer object. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Replace Aadhaar with SSN/NationalID in maskedIdType examples

4b381fe

Updated all references across both electricity-credential and program-enrollment-vc specs. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Update namespace URLs to reference DEG repository

efc1345

Change all schema $id and context URLs from nfh-trust-labs.github.io/vc-schemas to anusree-j.github.io/DEG/specification to point to the DEG repo itself. https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Fix namespace URLs to use beckn/DEG as the origin repo

64b9526

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Fix namespace URLs to use github.com/beckn/DEG

0408402

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Add @type GeoCoordinates to geo object in example per schema.org

8042426

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Rename plusCode to openLocationCode (standard name, not Google branding)

655e1ff

https://claude.ai/code/session_01Uu922mXdheZs3VSroAkdqt

Merge branch 'beckn:main' into claude/add-energy-profiles-R7CbF

7c3eaa7

Anusree-J closed this Mar 24, 2026

Anusree-J reopened this Mar 24, 2026

Anusree-J changed the title ~~edited~~ edited energy VCs Mar 24, 2026

Anusree-J mentioned this pull request Mar 24, 2026

Energy vc edits #207

Closed

ameetdesh reviewed Mar 25, 2026

View reviewed changes

Anusree-J commented Mar 25, 2026

View reviewed changes

Change customerDetails from optional to required

a415755

Anusree-J marked this pull request as draft March 26, 2026 04:58

Anusree-J marked this pull request as ready for review March 26, 2026 10:13

Anusree-J marked this pull request as draft March 26, 2026 10:13

Update readme.md

054dd19

ameetdesh assigned ameetdesh and Anusree-J and unassigned ameetdesh and Anusree-J Mar 27, 2026

ameetdesh changed the title ~~edited energy VCs~~ Unify energy VCs into Electricity Credentials Mar 27, 2026

Anusree-J marked this pull request as ready for review March 31, 2026 06:40

Update @context URLs to use .jsonld format

656392a

Add beckn Location context and update all DEG context URLs to use proper .jsonld paths (e.g., https://schema.beckn.io/deg/CustomerProfile/context.jsonld).

ameetdesh reviewed Apr 1, 2026

View reviewed changes

ameetdesh mentioned this pull request Apr 1, 2026

Add ESPI-native Meter Data and Billing Summary Verifiable Credential schemas #186

Open

6 tasks

ishdham reviewed Apr 6, 2026

View reviewed changes

Anusree-J mentioned this pull request Apr 7, 2026

chore: clean up repo structure and add real schemas nfh-trust-labs/opencred-vc-schemas#4

Merged

6 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Unify energy VCs into Electricity Credentials#208

Unify energy VCs into Electricity Credentials#208
Anusree-J wants to merge 25 commits intobeckn:mainfrom
Anusree-J:energy-vc-edits

Anusree-J commented Mar 24, 2026 •

edited by ameetdesh

Loading

Uh oh!

Uh oh!

ameetdesh Mar 25, 2026

Uh oh!

Uh oh!

Anusree-J Mar 25, 2026 •

edited

Loading

Uh oh!

Anusree-J Mar 25, 2026 •

edited

Loading

Uh oh!

Anusree-J Mar 25, 2026

Uh oh!

ameetdesh commented Mar 31, 2026

Uh oh!

ameetdesh Apr 1, 2026

Uh oh!

ameetdesh Apr 1, 2026

Uh oh!

ishdham Apr 6, 2026

Uh oh!

ishdham Apr 6, 2026

Uh oh!

ishdham Apr 6, 2026

Uh oh!

ishdham Apr 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

Anusree-J commented Mar 24, 2026 • edited by ameetdesh Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What changed

Files added/changed

Test plan

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Anusree-J Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Anusree-J Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ameetdesh commented Mar 31, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Anusree-J commented Mar 24, 2026 •

edited by ameetdesh

Loading

Anusree-J Mar 25, 2026 •

edited

Loading

Anusree-J Mar 25, 2026 •

edited

Loading