W3C VC Data Model 1.1 (legacy)
El W3C VC Data Model 1.1 fue la primera versión completa del estándar de Verifiable Credentials, publicada como Recommendation en 2022. Aunque ya existe la versión 2.0 (publicada en 2025), 1.1 sigue siendo relevante porque hay implementaciones productivas con esa versión y porque los conceptos fundacionales son los mismos.
Este artículo cubre 1.1 con foco en las diferencias relevantes con 2.0.
La estructura 1.1
Una credencial bajo 1.1 tiene esta estructura básica:
{
"@context": [
"https://www.w3.org/2018/credentials/v1",
"https://www.w3.org/2018/credentials/examples/v1"
],
"id": "https://salta.gob.ar/credentials/3732",
"type": ["VerifiableCredential", "ConstanciaDomicilio"],
"issuer": "did:web:salta.gob.ar",
"issuanceDate": "2026-05-18T00:00:00Z",
"credentialSubject": {
"id": "did:key:z6Mk...",
"nombre": "Juan Pérez",
"domicilio": "Av. Belgrano 1234, Salta"
},
"proof": {
"type": "Ed25519Signature2020",
"created": "2026-05-18T00:00:00Z",
"proofPurpose": "assertionMethod",
"verificationMethod": "did:web:salta.gob.ar#key-1",
"jws": "eyJhbGciOi..."
}
}
Diferencias clave con 2.0
| Aspecto | 1.1 | 2.0 |
|---|---|---|
| Context principal | /2018/credentials/v1 | /ns/credentials/v2 |
| Fechas validez | issuanceDate / expirationDate | validFrom / validUntil |
| Proofs embebidos | proof directamente en el JSON | Separado en VC-DI o JOSE-COSE |
| Credential status | credentialStatus | Igual + nuevas opciones |
| Selective disclosure | No estandarizado | Estandarizado vía SD-JWT VC |
Cuándo todavía usar 1.1
Hay tres escenarios donde 1.1 sigue siendo válido:
Integración con sistemas legacy
Si el sistema gov ya emite 1.1 y migrar a 2.0 tiene costo alto, mantener 1.1 hasta refactor mayor.
Software que solo soporta 1.1
Algunas wallets y librerías todavía no soportan 2.0 completamente. Verificar compatibilidad antes de migrar.
En proyectos nuevos sin compromisos legacy: arrancar directo con 2.0. La migración 1.1 → 2.0 no es trivial.
Migración 1.1 → 2.0
Cambios concretos en el código:
// 1.1
const vc = {
"@context": ["https://www.w3.org/2018/credentials/v1"],
issuanceDate: new Date().toISOString(),
expirationDate: oneYear.toISOString(),
};
// 2.0
const vc = {
"@context": ["https://www.w3.org/ns/credentials/v2"],
validFrom: new Date().toISOString(),
validUntil: oneYear.toISOString(),
};
Aunque los cambios parecen menores, las implicancias en wallets, verifiers y trust frameworks son significativas. Probar end-to-end antes de hacer cutover.
Referencias
Relacionados
- W3C Verifiable Credentials Data Model 2.0 — la versión 2.0 vigente
- SD-JWT VC — el formato preferido de Sovra — el formato concreto preferido