go
/
DateKeys-App
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Start the DateKeys TypeScript project

Browse Source 
Skeleton for the TypeScript implementation of DateKeys v0.8.x: the plans
in docs/, testdata/ vendored from g.activething.com/go/DateKeys at 5719f6a
with a zero-dependency sync and check script, and the TypeScript and vitest
tooling already used by the prototype, which now lives in ../AppOld.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
main
dev 2 weeks ago
commit ba8418cdbf
31 changed files with 2853 additions and 0 deletions
Show Stats Download Patch File Download Diff File

6
.gitattributes vendored
Unescape View File

@ -0,0 +1,6 @@
# Source files are normalised to LF.
* text=auto eol=lf
# Vendored Go fixtures and vectors must keep their exact bytes: their SHA-256 is
# recorded in testdata/SOURCE.json and in the fixtures themselves.
testdata/** -text

5
.gitignore vendored
Unescape View File

@ -0,0 +1,5 @@
node_modules/
.svelte-kit/
build/
coverage/
*.log

50
README.md
Unescape View File

@ -0,0 +1,50 @@
# DateKeys App
Implementación en TypeScript del protocolo DateKeys v0.8.1 y página de prueba en el navegador. Sustituye al prototipo, archivado en `../AppOld` (API Quicknet en Go, CLI tlock y cliente Svelte, commit `4d2b0a1`).
La implementación de referencia es la librería Go `g.activething.com/go/DateKeys`, en `../datekeys-go`. El plan de trabajo está en [docs/PLAN_codec_cbor_y_pagina_svelte.md](docs/PLAN_codec_cbor_y_pagina_svelte.md).
## Contenido previsto
| Parte | Ubicación | Paso del plan |
|---|---|---|
| Codec CBOR del subconjunto, parsers de schema, DateKey, `inspect` | `src/lib/dkc/` | 4 |
| Página inspector, sin red | SvelteKit, ruta `/inspect` | 5 |
| Cifrado y descifrado en el navegador | fase 2 | 6 |
## Reglas
- Los fixtures y vectores del Go son la verdad. Este proyecto nunca genera fixtures propios: `testdata/` es una copia exacta de un commit de la librería Go.
- Dependencias de ejecución: solo `age`, `drand`, `tlock` y lo que ellas arrastran. Ahora mismo no hay ninguna.
- Tooling de desarrollo: solo el de la lista siguiente. Cualquier otra dependencia se propone por escrito y no se instala sin aprobación.
## Tooling de desarrollo
| Paquete | Versión | Estado |
|---|---|---|
| `typescript` | 5.9.3 | en `package.json`; ya usado en el prototipo |
| `vitest` | 5.0.1 | en `package.json`; ya usado en el prototipo |
| `@vitest/coverage-v8` | la de `vitest` | pendiente de aprobación; cobertura del 100 % del codec |
| `@types/node` | 24.x | pendiente de aprobación; tests que leen `testdata/` desde disco |
| `svelte`, `@sveltejs/kit`, `@sveltejs/vite-plugin-svelte`, `vite`, `svelte-check` | las del prototipo | paso 5 |
| `@sveltejs/adapter-static` | por fijar | paso 5, pendiente de aprobación: la página es estática y no necesita servidor |
Todas las versiones se fijan exactas y `package-lock.json` se versiona.
## testdata
```bash
npm run testdata:sync
```
Copia `testdata/` de `../datekeys-go` en `HEAD`, leyendo los blobs con git para no arrastrar cambios sin commit, y escribe `testdata/SOURCE.json` con el commit completo y el SHA-256 de cada fichero. Para fijar otro commit: `node scripts/sync-testdata.mjs sync --commit <rev>`.
```bash
npm run testdata:check
```
Comprueba que los ficheros coinciden con `SOURCE.json`, sin faltantes ni sobrantes, y vuelve a leerlos del repositorio Go en el commit registrado. Sin la opción `--against`, `node scripts/sync-testdata.mjs check` verifica solo la copia local. Ambos comandos usan solo Node y git.
`.gitattributes` marca `testdata/**` como binario para que git no altere ningún byte.
Copia actual: 22 ficheros de `5719f6a4b3654f608091e32290d9fcfbc7e38062`.

347
docs/PLAN_codec_cbor_y_pagina_svelte.md
Unescape View File

@ -0,0 +1,347 @@
# Plan: codec CBOR propio y página de prueba en Svelte
Estado: v2, 25 de septiembre de 2026. Sustituye a la v1 (conservada en `AppOld/docs`) con la revisión, el panel sobre `data` y las decisiones 2, 3 y 4. La decisión 1 queda pendiente de confirmar el límite N (sección 3).
Alcance: sustituir la dependencia CBOR externa de `datekeys-go` por un codec propio, escribir el mismo codec en TypeScript en el proyecto nuevo `App`, y construir sobre él la página de prueba: primero un inspector de cápsulas, después cifrado y descifrado en el navegador.
Regla de dependencias del proyecto: en ejecución, solo `age`, `drand`, `tlock` y lo que ellas arrastran, en cualquier lenguaje. El tooling de desarrollo queda fuera de la regla, pero solo se admite el de la lista de la sección 13. Toda dependencia nueva, de ejecución o de tooling, se propone por escrito y no se instala sin aprobación.
---
## 1. Situación de partida
| Elemento | Estado verificado el 25-09-2026 |
|---|---|
| `datekeys-go`, paquete `codec` | Usa `github.com/fxamacker/cbor/v2` v2.9.4, que arrastra `github.com/x448/float16`. Es la única dependencia directa fuera de la regla. |
| Uso de esa librería | `codec` (Marshal, Unmarshal, Peek, CheckSchema, Valid) y structs con etiquetas `cbor:"N,keyasint"` en `profile`, `capsule`, `accesskey`, `extension` e `internal/testkit`. `extension.Wire.Data` es `cbor.RawMessage`. |
| Fixtures y vectores | Cinco cápsulas `.dkc`, dos `.dkk`, vectores de ronda, `dk1_` y `profile_hash`. Los vectores se regeneran byte a byte. Los `.dkc` se generaron una vez y están congelados: la aleatoriedad de `age` no se puede inyectar, así que regenerar una cápsula cambia `capsule_id`, las claves y todos sus bytes. |
| Proyecto TypeScript | `App`, nuevo y separado. Tiene un esqueleto sin dependencias instaladas, los planes en `docs/` y `testdata/` copiado del commit `5719f6a` de `datekeys-go` con `scripts/sync-testdata.mjs`, que verifica cada fichero contra `testdata/SOURCE.json`. |
| Prototipo | `AppOld`: API Quicknet en Go, CLI tlock y cliente Svelte (`web-client`), commit `4d2b0a1`. No se modifica. |
| `web` | Landing estática de datekeys.com. Fuera de este plan. |
Fallos de la librería actual que este plan corrige, todos reproducidos el 25-09-2026:
| Fallo | Reproducción | Se corrige en |
|---|---|---|
| `CheckDisjoint` es cuadrático y `DecodeHeader` lo ejecuta antes de comprobar las extensiones críticas | una PUBLIC_HEADER de 880 KB con 40 000 + 40 000 extensiones se decodifica sin error en 8,3 s, sin red ni secretos | paso 1 (máximo de 64 por array) y paso 2a (fusión lineal) |
| Asimetría entre sellar y abrir | `Encrypt` sella `data` de control con 14 o 15 arrays anidados; al llegar la fecha, `Open` la rechaza en el paso 14 (`exceeded max nested level 16`) y la cápsula ya no se puede abrir | paso 2a (`data` pasa a ser una hoja) y autocomprobación del encoder |
| Veredicto no determinista | la misma cápsula de 810 bytes, con `data` de cabecera `{NaN:0, NaN:1}`, la acepta `Inspect` 437 veces de 500 y `Open` 82 de 100 | paso 2a (fxamacker sale del camino de `data`) |
| `extension.New(id, v, nil)` emite `f6` | contradice §58.1 | paso 2a (`New` recibe `[]byte` y rechaza vacío) |
---
## 2. Subconjunto CBOR del protocolo
Del CDDL `spec/datekeys.cddl` se deduce que el protocolo solo usa:
| Tipo CBOR | Tipo mayor | Uso |
|---|---|---|
| Entero sin signo | 0 | versiones, claves de mapa, política, periodo, genesis, versión de extensión |
| Cadena de bytes | 2 | identificadores, hashes, claves, `capsule_digest`, `data` de extensión |
| Cadena de texto | 3 | etiquetas de tipo, ids, DateKey compacta, `access_type` |
| Array | 4 | listas de extensiones |
| Mapa con claves enteras | 5 | todos los objetos |
El spec lo nombra en §58 como perfil del protocolo: RFC 8949 §4.2.1 restringido a los tipos mayores 0, 2, 3, 4 y 5, con claves enteras sin signo. Con claves enteras coinciden el orden por bytes, el orden por longitud y el orden numérico, así que no hay ambigüedad de perfil.
Reglas que el codec impone al decodificar y al codificar:
- enteros y longitudes en su forma más corta;
- longitudes definidas;
- claves de mapa en orden ascendente estricto, sin duplicados;
- mapas cerrados: toda clave no prevista por el schema se rechaza;
- texto UTF-8 válido;
- tamaños acotados por el schema y por los límites de §57, que pasan a ser MUST (sección 9);
- como mucho tres niveles de contenedores (objeto, array de extensiones y extensión). `data` es una hoja y el codec nunca desciende dentro.
Se rechazan con `ERR_NON_CANONICAL_CBOR`: enteros negativos, flotantes, tags, valores simples, longitudes indefinidas y claves no enteras. Los límites de tamaño usan el código que decida la sección 9.
Tras decodificar, el decodificador reencodifica y compara byte a byte con la entrada. Es una defensa independiente de la decodificación estricta, y ahora cubre también `data`.
---
## 3. Decisión normativa: `data` de las extensiones
**Tipo: `bstr` no vacío.** Bytes opacos para el protocolo base. Un panel comparó cuatro opciones con tres jueces independientes (seguridad, interoperabilidad y gobernanza del spec) y un red team contra la ganadora:
| Opción | Puntos (máx. 30) |
|---|---|
| A. `bstr` opaco no vacío | 25,5 (ganadora para los tres jueces) |
| B. Subconjunto estructurado recursivo | 19 |
| C. `any` fijado a un perfil preciso (CDE o dCBOR) | 11 |
| D. `any` como hoy, fijando el comportamiento de fxamacker | 6,5 |
A gana porque:
- el protocolo base no analiza nada de `data`, sin superficie de parser ni recursión;
- un lector nunca analiza la `data` de extensiones que no conoce;
- la validez base es una comprobación de longitud, idéntica en todas las implementaciones.
Es el diseño de X.509 (`extnValue` OCTET STRING) y TLS (`extension_data` opaco).
B es la rival seria, pero:
- obliga a cada lector a validar datos que §54 dice que no interpreta;
- congela el espacio de valores;
- sus ventajas (canonicidad interna, vista estructurada, comprobación al sellar) se recuperan en A mediante la regla de registro de la sección 9.
El red team no refutó el tipo.
**Justificación §76.** Se basa en casos reproducibles, no en el tamaño del código:
1. El CDDL se contradice: las líneas 12 a 14 dicen que `null` y los vacíos nunca representan ausencia, y la línea 82 declara `? 2 => any`.
2. `extension.New(id, v, nil)` emite `f6`.
3. El veredicto no determinista con claves NaN.
4. El fixture oficial `time_only_extensions` usa claves de texto y `true`.
5. La asimetría de profundidad: una cápsula sellada que no se abre tras la espera. Es el caso decisivo.
**Límite de tamaño: pendiente de confirmar.** El panel propuso N = 65 535 (el límite de TLS). El red team mostró que ninguna evidencia sostiene un N concreto, y que un N uniforme de 64 KiB bloquearía el modo `opaque_onion` del Dead Man Switch de los borradores v0.1 y v0.2, si ese servicio llevara cada capa anterior en una extensión de control. Según una simulación del red team con la librería actual, crece unos 477 bytes por renovación y se bloquea en la renovación 139. El diseño del Dead Man Switch sigue abierto, así que el argumento es condicional.
Opciones:
1. **Recomendada:** sin N propio. `data` queda acotada por la trama de su contenedor (§57, que pasa a MUST), y cada extensión registrada declara su máximo en §72.
2. Límites por contenedor: 65 535 en PUBLIC_HEADER (pública y leída antes del desbloqueo) y la trama en CONTROL_CBOR y `.dkk`.
3. N uniforme de 65 535, registrando en §76 que limita el `opaque_onion`.
---
## 4. Diseño del codec en Go
Paquete `codec` reescrito sin reflexión y sin etiquetas de struct.
```go
// Codificación: se acumula en un []byte. El primer error queda fijado y
// Err lo devuelve; las llamadas posteriores no hacen nada.
type Encoder struct{ buf []byte; err error }
func (e *Encoder) Map(pairs int)
func (e *Encoder) Array(items int)
func (e *Encoder) Uint(v uint64)
func (e *Encoder) Bstr(b []byte)
func (e *Encoder) Text(s string) // rechaza UTF-8 inválido
func (e *Encoder) Out() ([]byte, error)
// Decodificación: cursor estricto sobre la entrada. El Decoder guarda la
// última clave de cada mapa abierto y exige orden ascendente estricto.
type Decoder struct{ /* entrada, posición, pila de últimas claves */ }
func (d *Decoder) Map(max int) (pairs int, err error)
func (d *Decoder) Key() (uint64, error)
func (d *Decoder) EndMap() error
func (d *Decoder) Array(max int) (items int, err error)
func (d *Decoder) Uint(max uint64) (uint64, error)
func (d *Decoder) Bstr(min, max int) ([]byte, error) // longitud comprobada contra lo que queda antes de copiar
func (d *Decoder) Text(max int) (string, error)
func (d *Decoder) Done() error // rechaza bytes sobrantes
// Canonicidad: decodifica con decode, reencodifica con encode y compara.
func Unmarshal(in []byte, decode func(*Decoder) error, encode func(*Encoder)) error
// Lee las claves 0 y 1 de un mapa (tipo y versión) antes de la
// decodificación estricta (spec §70).
func Peek(in []byte) (typeTag string, version uint64, err error)
// Recorredor genérico del subconjunto, con profundidad y tamaño acotados.
// Es auxiliar: vectores compartidos, fuzzing, vista informativa del
// inspector y extensiones registradas cuyo `data` sea CBOR. Nunca decide
// la validez base de un objeto.
func Walk(in []byte, maxDepth, maxLen int) error
```
Cada schema escribe su codificación y decodificación a mano, en su paquete, en sustitución de los structs `wire`:
| Schema | Paquete | Claves |
|---|---|---|
| Provider Profile | `profile` | 0 a 10 |
| PUBLIC_HEADER | `capsule` | 0 a 4, opcionales 5 y 6 |
| CONTROL_CBOR | `capsule` | 0 a 3, opcionales 4 y 5 |
| `.dkk` body | `accesskey` | 0 a 5, opcionales 6, 7 y 8 |
| `verification_metadata` | `accesskey` | 0 |
| extensión | `extension` | 0, 1, opcional 2 (`bstr` no vacío) |
Reglas comunes:
- una clave opcional ausente se omite;
- un array vacío, un mapa vacío o un `h''` en una clave opcional es un error explícito, no un efecto de `omitempty`;
- la etiqueta de tipo y la versión se comprueban antes de decodificar el resto;
- los errores envuelven el sentinel de §69 que corresponda.
Cambios en `extension`:
- `New` recibe `[]byte` y rechaza vacío o fuera de límite;
- el array se rechaza por su cabecera si supera 64 elementos, antes de iterar;
- `CheckDisjoint` se sustituye por una fusión lineal de los dos arrays ordenados.
Autocomprobación del encoder: `Encrypt`, `EncodeHeader`, `EncodeControl` y el encoder de `.dkk` decodifican lo que producen con el decodificador del lector antes de sellar o escribir. Hay un fuzz target que exige que todo encode correcto implique un decode correcto.
`go.mod` pierde `github.com/fxamacker/cbor/v2` y `github.com/x448/float16`. No entra nada a cambio.
---
## 5. Diseño del codec en TypeScript
Mismo diseño y misma API, en `App/src/lib/dkc/cbor.ts`, sobre `Uint8Array`, sin dependencias:
- texto con `TextDecoder('utf-8', { fatal: true, ignoreBOM: true })`; sin `ignoreBOM`, un BOM inicial desaparece y TS rechaza lo que Go acepta;
- `Text` del encoder comprueba `isWellFormed()` antes de codificar, porque `TextEncoder` sustituye en silencio un surrogate suelto por `efbfbd`;
- los `extension_id` se comparan por sus bytes UTF-8, nunca como cadenas JavaScript, que comparan en orden UTF-16 (el par U+FF61 y U+10000 sale al revés); un port ingenuo divergió en 782 de 200 000 entradas;
- enteros siempre como `number`: todos los `uint` del CDDL quedan acotados por debajo de 2⁵³ (sección 9), y el decodificador rechaza lo que supere `Number.MAX_SAFE_INTEGER`;
- `data` se devuelve como `Uint8Array`; `undefined` significa clave ausente.
Los parsers de schema van en el mismo directorio: `profile.ts`, `header.ts`, `control.ts`, `accesskey.ts`, `extension.ts`, `datekey.ts` e `inspect.ts`, que cubre los pasos 1 a 8 de §63.
`datekey.ts` no porta el `roundForTime` del prototipo. Ese código usa `Date.parse`, que trunca a milisegundos, y falla el vector "genesis + 1ns" de `quicknet_rounds.json` (da la ronda 1 en vez de la 2). Hace falta un parser RFC 3339 con precisión de nanosegundos.
La cabecera `age` de OUTER_TIME_AGE y PAYLOAD_AGE (pasos 5, 6 y 8) se analiza con un parser estricto según la gramática de `age`: stanzas, cuerpo base64 canónico, líneas de 64 columnas y línea MAC, sobre los ficheros binarios que localizan las longitudes del prelude. El filtro de líneas `-> ` del prototipo es demasiado laxo.
---
## 6. Vectores compartidos entre lenguajes
Fichero `testdata/vectors/cbor.json` en `datekeys-go`, generado desde Go y congelado. `App` lo recibe con `sync-testdata`. Los casos genéricos se ejecutan con `Walk`; los de schema, con el decodificador de cada schema. Los enteros por encima de 2⁵³ van como cadena decimal.
```json
{
"accept": [
{ "name": "uint 23 inline", "hex": "17", "value": 23 },
{ "name": "uint 24 one byte", "hex": "1818", "value": 24 },
{ "name": "uint 256 two bytes", "hex": "190100", "value": 256 },
{ "name": "uint 2^32 eight bytes", "hex": "1b0000000100000000", "value": 4294967296 },
{ "name": "empty bstr", "hex": "40" },
{ "name": "map two sorted keys", "hex": "a200010101" },
{ "name": "text with leading BOM", "hex": "64efbbbf61" }
],
"reject": [
{ "name": "uint 23 with one extra byte", "hex": "1817", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "bstr length not shortest", "hex": "5800", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "keys out of order", "hex": "a201000001", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "duplicate key", "hex": "a200000001", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "text key", "hex": "a1616100", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "indefinite array", "hex": "9f01ff", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "tag", "hex": "c101", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "float", "hex": "f97e00", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "true", "hex": "f5", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "null", "hex": "f6", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "negative int", "hex": "20", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "truncated uint", "hex": "1901", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "length beyond input", "hex": "5affffffff", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "trailing byte", "hex": "0100", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "invalid UTF-8", "hex": "61ff", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "overlong UTF-8", "hex": "62c080", "error": "ERR_NON_CANONICAL_CBOR" },
{ "name": "UTF-8 surrogate", "hex": "63eda080", "error": "ERR_NON_CANONICAL_CBOR" }
]
}
```
Además, un bloque por schema: objeto válido mínimo, clave desconocida, clave obligatoria ausente, tipo incorrecto y tamaño fuera de límite.
Casos de extensión:
- `data` con `40`, con `5801xx` y en el límite de la sección 3 y uno más;
- `data` con tipo distinto de `bstr`: texto, `null`, `uint`, mapa, tag y longitud indefinida;
- 64 y 65 extensiones en un array;
- un `extension_id` que empieza por BOM;
- el par de orden U+FF61 y U+10000;
- `extension_version` en 2⁵³ − 1 y 2⁵³.
---
## 7. Tests
1. **Regresión byte a byte.** Tras el paso 2b, `profile_hash` de Quicknet, los hex de prelude, cabecera y control de las cinco cápsulas, y los dos `.dkk` completos tienen que ser idénticos a los fixtures congelados, sin ninguna excepción: el cambio de `data` y la regeneración de su fixture ocurren antes, en el paso 2a.
2. **Asertos sobre los bytes exactos de `data`** en los tests de conformidad, no solo sobre su número (`conformance_test.go:165` y `205`, `accesskey_test.go:54`).
3. **Vectores compartidos** de la sección 6, en Go y en TypeScript.
4. **Corpus de mutaciones exportado.** Los 45 casos de `capsule/mutation_test.go` (23 de ellos en los pasos 1 a 8 y sin red) se exportan como vectores congelados: bytes, código de error y paso. TypeScript tiene que reproducir el código y el paso de cada uno. Además, un corpus diferencial de mutaciones aleatorias con semilla fija y el veredicto de Go.
5. **Fuzzing en Go** de `Decoder`, de `Walk`, de cada decodificador de schema y de la propiedad "encode correcto implica decode correcto". El corpus de mutación existente sigue pasando.
6. **TypeScript con `vitest`.** Carga los fixtures de `App/testdata` y compara `inspect` con la salida congelada de `datekeys inspect -json` de cada fixture, generada en Go y guardada en `testdata`; los tests no ejecutan Go. Pasa `quicknet_rounds.json`, `dk1.json` y `profile_quicknet.json`.
7. **Cobertura** del codec al 100 % en ambos lenguajes. En TypeScript necesita `@vitest/coverage-v8` (sección 13).
---
## 8. La página de prueba en Svelte
En el proyecto `App`, como sitio estático, sin servidor.
**Fase 1, inspector.** Ruta `/inspect`. Carga un `.dkc` desde disco o uno de los fixtures, ejecuta los pasos 1 a 8 y muestra, como la CLI Go, el resultado de cada paso: prelude, cabecera, política, DateKey, fecha de apertura, argumentos del stanza `tlock` frente al perfil pinneado y recuento de stanzas de OUTER_TIME_AGE y PAYLOAD_AGE. Sin secretos. Una CSP con `connect-src 'self'` garantiza que la página no habla con ningún otro origen.
Contrato de las extensiones:
- id, versión, crítica o no, conocida o no, longitud y hex siempre;
- una vista de texto si los bytes son UTF-8 imprimible;
- una vista decodificada con `Walk` si los bytes son CBOR del subconjunto, marcada como informativa y no validada por el protocolo;
- todo el texto escapado;
- nunca se construyen objetos ni `Map` de JavaScript a partir de claves (`__proto__`, colisiones por encima de 2⁵³);
- la `data` de PUBLIC_HEADER y `.dkk` se marca como pública y no autenticada hasta el paso 15.
**Fase 2, cifrar y descifrar.** Solo cuando la fase 1 pase con todos los fixtures y el corpus exportado.
Necesita `age-encryption` 0.3.1, la librería `age` oficial en TypeScript, que admite `Recipient` e `Identity` propios. Arrastra `@noble/ciphers`, `@noble/curves` 2, `@noble/hashes` 2, `@noble/post-quantum` y `@scure/base`. Como `tlock-js` 0.9 sigue en `@noble/curves` 1.9.7 y `@noble/hashes` 1.8.0, el bundle tendrá dos versiones mayores de noble. La aprobación se decide al empezar la fase 2 (decisión 4).
Piezas de `tlock-js` y `drand-client`:
- `tlock-js` aporta `encryptOnG2RFC9380` y `decryptOnG1` desde `crypto/ibe`, que no tiene restricción de `exports`;
- la serialización del cuerpo del stanza (U‖V‖W) no está ahí y se escribe aparte;
- `drand-client` verifica los releases.
Las identidades `tlock` y X25519 aplican la cardinalidad de §63 (pasos 11, 13 y 17) dentro de `unwrapFileKey`, como en Go. La prueba de aceptación descifra un fixture `time_and_key` en el navegador con la firma embebida, sin red.
---
## 9. Cambios en la especificación y el CDDL
Todos en un único cambio normativo, con la justificación §76 de la sección 3:
- **Extensiones.**
- CDDL: `extensions = [1*64 extension]` y `extension = { 0 => extension-id, 1 => extension-version, ? 2 => bstr .size (1..MAX) }`, con MAX según la opción elegida en la sección 3.
- §31 y §54: `data` es una cadena de bytes opaca. El protocolo base nunca la decodifica ni la valida, y la validez de PUBLIC_HEADER, CONTROL_CBOR y `.dkk` nunca depende de su contenido. Una extensión sin datos omite la clave 2, y `h''` es inválido.
- §31 y §54: se elimina la excepción de multiplicidad ("salvo que el schema registrado permita multiplicidad"), que contradice al CDDL y a la implementación de referencia. La multiplicidad va dentro de `data`.
- §54: una extensión crítica conocida con `data` inválida se rechaza con un código definido (nuevo en §69, o uno existente nombrado expresamente). Una no crítica conocida con `data` inválida se marca como inutilizable y el objeto sigue siendo válido.
- **Enteros.** `extension_version`, `period` y `genesis_time` acotados, como mucho a 2⁵³ − 1; para `extension_version` basta con 2³² − 1. En TypeScript, 2⁵³ + 1 se confunde con 2⁵³, y una versión crítica desconocida podría pasar por conocida.
- **§57.** Los límites pasan de "V1 recomienda" a MUST para encoders y decoders. Un único código de error para toda violación de límites; la referencia usa hoy `ERR_INTEGRITY` para las tramas.
- **§58.** Nombra el perfil de la sección 2, aplica también a la cabecera del `bstr` de `data` y nunca a su contenido.
- **§72.**
- Cada extensión registrada declara la codificación de su `data`, su forma canónica, su longitud máxima y sus vectores.
- Si la codificación es CBOR, usa el perfil de §58 de forma recursiva, con contenedores no vacíos y sin `null`.
- Sus lectores rechazan codificaciones no canónicas, y su encoder decodifica lo que produce antes de sellar.
- Las extensiones de firma firman los bytes exactos de `data`.
- **§64.** Mutaciones nuevas: `data` con tipo incorrecto, `data` vacía, `data` por encima del límite y 65 extensiones.
- **§68.** Un fixture `.dkk` con una extensión.
- **§74.** Se retira "formato exacto de extensiones" de lo provisional.
- **Documentación.** Se actualizan `docs/traceability.md` (decisión 6) y `CHANGELOG.md`, que recoge la rotura de API: `extension.New` recibe `[]byte`, y `data` distinta de `bstr` o vacía deja de ser válida. El fixture se regenera en el mismo commit.
---
## 10. Orden de trabajo y criterios de aceptación
| Paso | Contenido | Hecho cuando |
|---|---|---|
| 1 | Cambios de spec y CDDL de la sección 9 | texto aprobado |
| 2a | Con fxamacker todavía dentro: `data` como `bstr`, `New([]byte)`, máximo de 64, fusión lineal, autocomprobación del encoder. Se regenera `time_only_extensions` con `-force` (cabecera: los bytes de "public label", que no son CBOR; control: un ejemplo CBOR del subconjunto) y se añade el `.dkk` con extensión. | tests verdes; los tres fallos de la sección 1 tienen test de regresión; commit en Gitea |
| 2b | Codec propio en Go y baja de fxamacker | cero cambios en `testdata/`; regresión completa de la sección 7; `govulncheck` sin cambios; una noche de fuzzing limpia; commit en Gitea |
| 3 | Vectores CBOR, corpus de mutaciones exportado y salidas de `inspect -json` congeladas | Go los genera y los pasa; ficheros congelados |
| 4 | En `App`: `sync-testdata`, codec y parsers TypeScript, `inspect.ts` | `vitest` reproduce fixtures, vectores y corpus exportado; cobertura del codec al 100 % |
| 5 | Ruta `/inspect` | abre los fixtures y un `.dkc` arrastrado; la CSP bloquea cualquier otro origen |
| 6 | Fase 2 | `age-encryption` aprobada; un fixture `time_and_key` se descifra en el navegador |
---
## 11. Riesgos
- **Dos codecs propios** en vez de una librería auditada por muchos. Mitigación: subconjunto mínimo, `data` opaca, vectores compartidos, regresión byte a byte sin excepciones, corpus de mutaciones exportado y fuzzing.
- **Desviación entre Go y TypeScript.** Los fixtures y vectores del Go son la verdad; TypeScript nunca genera fixtures propios, y `testdata/SOURCE.json` fija el commit de origen y el hash de cada fichero.
- **Parser estricto de cabecera `age` en TypeScript.** Cubierto por las mutaciones de los pasos 5, 6 y 8.
- **`data` opaca aplaza la validación a cada extensión.** Es el tipo de fallo de CVE-2020-1971. Mitigación: la regla de §72, el perfil con nombre y el recorredor compartido.
- **Límite de `data`.** Si se elige un N uniforme, puede limitar servicios futuros, como el `opaque_onion` del Dead Man Switch.
---
## 12. Decisiones
1. **`data`:** `bstr` no vacío (recomendado, sección 3). Pendiente de confirmar el límite: la trama del contenedor (recomendado), límites por contenedor o un N uniforme de 65 535.
2. **Proyecto TypeScript:** aparte, en `App`. El prototipo queda en `AppOld`. Decidido.
3. **Regla de dependencias:** afecta a las de ejecución. El tooling de desarrollo se admite solo desde la lista explícita de la sección 13. Decidido.
4. **`age-encryption` 0.3.1:** se decide al empezar la fase 2. Decidido.
---
## 13. Tooling de desarrollo de `App`
| Paquete | Versión | Estado |
|---|---|---|
| `typescript` | 5.9.3 | en `package.json`; ya usado en el prototipo |
| `vitest` | 5.0.1 | en `package.json`; ya usado en el prototipo |
| `@vitest/coverage-v8` | la de `vitest` | pendiente de aprobación (sección 7) |
| `@types/node` | 24.x | pendiente de aprobación; tests que leen `testdata/` |
| `svelte`, `@sveltejs/kit`, `@sveltejs/vite-plugin-svelte`, `vite`, `svelte-check` | las del prototipo | paso 5 |
| `@sveltejs/adapter-static` | por fijar | pendiente de aprobación; paso 5, sitio estático |
Todas las versiones se fijan exactas y `package-lock.json` se versiona.

276
docs/PLAN_libreria_go.md
Unescape View File

@ -0,0 +1,276 @@
# Plan de implementación: `datekeys-go`
Implementación de referencia en Go de la **DateKeys Protocol Specification v0.8.1**.
Estado: borrador para revisión. Fecha: 25 de septiembre de 2026.
---
## 1. Objetivo y principios
Construir desde cero una librería Go que implemente el protocolo base tal como lo fija la v0.8.1, con estas reglas:
1. **La especificación manda.** El código no añade semántica. Si el código descubre un problema en el spec, se abre un caso reproducible según la política de cambios de la sección 76.
2. **Cero criptografía propia.** Solo `age`, `tlock` y la verificación BLS de `drand`. La librería aporta framing, CBOR, bindings, reglas de verificación y flujo.
3. **Validar todo lo verificable localmente antes de tocar red o secretos.** Sección 63.
4. **Fallar cerrado.** Ningún plaintext parcial, ningún error enmascarado, ningún "verified: true" ajeno.
5. **Superficie pequeña y auditable.** Pocas dependencias, todas pinneadas, builds reproducibles, y un mapa de trazabilidad spec ↔ código para la revisión externa.
6. **Nueva librería, no refactor.** Lo aprovechable del prototipo se copia y se adapta; el repositorio actual no se modifica.
---
## 2. Alcance de la primera versión de la librería (v0.1.0)
Implementa:
- DateKey: resolución fecha → ronda, `dk1_` canónico, vectores (secciones 14 a 19).
- Provider Profile Quicknet: struct, CBOR canónico, `profile_hash`, registro pinneado (secciones 10 a 13).
- Adaptador drand: obtención de releases por relays, verificación BLS local, modo estricto (secciones 35, 45 a 52).
- `.dkc`: prelude, PUBLIC_HEADER, CONTROL_CBOR, `header_binding`, `time_only` y `time_and_key`, flujo de cifrado y descifrado completo con SHOULD y MUST (secciones 20 a 39, 61 a 63).
- `.dkk`: framing, body, identity portable de un solo uso (secciones 40 a 44).
- Extensiones genéricas con reglas de duplicados y orden canónico (sección 54).
- Catálogo de errores (sección 69). Límites de parser (57). Canonicidad CBOR y omisión de opcionales (58, 58.1).
- Fixtures, mutaciones, fuzzing y CLI mínima.
No implementa, a propósito:
- Servidor de Release API ni Release Queue. La librería define la interfaz de fuente de releases; el servidor actual podrá consumirla más adelante.
- Almacenamiento, entrega de `.dkk`, servicios, extensiones concretas.
- Cliente TypeScript. Vendrá después con la misma suite de fixtures.
---
## 3. Decisiones de diseño
### 3.1 Módulo y layout
Repositorio: Gitea propio, `https://g.activething.com/go/DateKeys.git`. Módulo: `g.activething.com/go/DateKeys`, la ruta que el propio Gitea anuncia en su etiqueta `go-import`. Si más adelante se quiere una ruta en `datekeys.com` que no dependa del servidor, es un cambio de una línea en `go.mod` y un `sed` en las importaciones, siempre antes de publicar. Go 1.26, con `go.mod` fijando la última versión de parche de la serie. No se usa GitHub para nada del proyecto; las dependencias alojadas allí se obtienen como módulos Go, igual que cualquier otra.
```text
datekeys-go/
go.mod
LICENSE Apache-2.0 (código)
README.md SECURITY.md CONTRIBUTING.md TRADEMARKS.md CHANGELOG.md
spec/
DateKeys_Protocol_Specification_v0.8.1.md copia congelada
datekeys.cddl schema normativo de todos los CBOR
datekey/ DateKey, resolución, dk1_ canónico
profile/ Provider Profile, CBOR canónico, hash, registro pinneado, quicknet.go
provider/ interfaces Condition, Release, ReleaseSource, Verify
provider/drand/ relays HTTP, verificación BLS, modo estricto
codec/ CBOR determinista: Encode, Decode con comprobación por reencodificación, límites
codec/bech32/ codificación Bech32 para la forma humana de identities (ver 4.3)
agewrap/ identities y recipients envolventes de age: cardinalidad, sonda de inspección, stanza tlock
extension/ tipos y reglas de extensiones
capsule/ .dkc: framing, cabecera, control, binding, Encrypt, Inspect, Open
accesskey/ .dkk: framing, body, identity
errors.go sentinel errors del catálogo de la sección 69
internal/testkit/ generación de fixtures, escritor de cabeceras age malformadas, mutadores
testdata/fixtures/ fixtures oficiales y sus valores esperados
docs/traceability.md mapa sección del spec → paquete, función, test
cmd/datekeys/ CLI: encrypt, decrypt, inspect, datekey, profile
```
### 3.2 API pública, deliberadamente pequeña
```go
// datekey
type DateKey struct { ProfileID string; Round uint64 }
func Resolve(p *profile.Profile, at time.Time) (DateKey, error) // §15, precisión completa
func Parse(s string) (DateKey, error) // §19, solo forma canónica
func (d DateKey) Compact() string // dk1_...
func (d DateKey) UnlockAt(p *profile.Profile) time.Time
// profile
type Profile struct { ID, Provider, Network string; ChainHash [32]byte; PublicKey []byte;
Period time.Duration; GenesisTime int64; Scheme string; GenesisSeed [32]byte }
func (p *Profile) CanonicalCBOR() []byte
func (p *Profile) Hash() [32]byte // §11
var Quicknet *Profile // §12, pinneado en el binario
type Registry interface { Lookup(id string) (*Profile, bool) }
// provider
type Condition struct { Round uint64 }
type Release struct { Round uint64; Signature []byte }
type ReleaseSource interface { Fetch(ctx context.Context, p *profile.Profile, c Condition) (Release, error) }
func Verify(p *profile.Profile, c Condition, r Release) error // §51, BLS local siempre
// capsule
type Policy uint8 // TimeOnly = 0, TimeAndKey = 1
type EncryptOptions struct {
Profile *profile.Profile
UnlockAt time.Time
Policy Policy
Recipients []age.Recipient // X25519 de destinatarios conocidos
NewPortableKey bool // genera I_ACCESS y devuelve la .dkk
Critical, Noncritical []extension.Extension
}
type Result struct { DateKey datekey.DateKey; CapsuleID [16]byte; PortableKey *accesskey.AccessKey }
func Encrypt(dst io.Writer, src io.Reader, opts EncryptOptions) (*Result, error)
type Inspection struct { /* prelude, cabecera, política, ronda, unlock, resultado de cada comprobación */ }
func Inspect(r io.ReadSeeker, reg profile.Registry) (*Inspection, error) // pasos 1 a 8, sin red ni secretos
type OpenOptions struct {
Registry profile.Registry
Source provider.ReleaseSource
Identities []age.Identity // X25519 propias del destinatario
AccessKey *accesskey.AccessKey // .dkk portable
Now func() time.Time // inyectable para tests
}
func Open(dst io.Writer, r io.ReadSeeker, opts OpenOptions) error // pasos 9 a 18
// accesskey
type AccessKey struct { CredentialID, CapsuleID [16]byte; Type string; Material []byte;
Verification *Verification; Critical, Noncritical []extension.Extension }
func Encode(w io.Writer, k *AccessKey) error
func Decode(r io.Reader) (*AccessKey, error)
func (k *AccessKey) Identity() (age.Identity, error)
```
Reglas de la API:
- `io.Reader` y `io.Writer` en todo; el payload nunca se carga entero en memoria.
- `Open` recibe `io.ReadSeeker` para poder inspeccionar la cabecera de PAYLOAD_AGE en el offset `16 + PUBLIC_HEADER_LEN + SEALED_CONTROL_LEN` antes de pedir el release. Si el lector no permite seek, se omite el SHOULD y se aplica el MUST al abrir.
- El reloj se inyecta. Ningún paquete llama a `time.Now` directamente salvo la CLI.
- Ningún tipo imprime secretos en `String()`. Las identities se pasan como tipos de `age`, no como bytes sueltos, salvo en `accesskey`.
### 3.3 Cómo se usan `age` y `tlock`
- **PAYLOAD_AGE e INNER_ACCESS_AGE:** `age.Encrypt` y `age.Decrypt` con recipients e identities X25519 de la API pública de `age`.
- **OUTER_TIME_AGE:** `age.Encrypt` con un recipient propio en `agewrap` que llama a `tlock.TimeLock` y `tlock.CiphertextToBytes`, ambos exportados, y emite el stanza `tlock <ronda> <chainhash>` con el mismo formato que `tlock`. Para abrir, una identity propia que comprueba el conjunto completo de stanzas, la ronda y el chain hash contra la DateKey y el perfil, y llama a `tlock.TimeUnlock`, que verifica el beacon antes de descifrar.
- Motivo: `tlock.New(...).Decrypt` usa una identity no exportada en la que no podemos imponer la cardinalidad ni evitar que todo error se convierta en `ErrTooEarly`. Usando su núcleo exportado se mantiene la compatibilidad de stanza con `tle` y se gana control del flujo.
- **Cardinalidad MUST:** en las tres identities envolventes, dentro de `Unwrap`, que recibe todos los stanzas del fichero. Sin APIs internas.
- **Inspección SHOULD:** `age.ExtractHeader` lee únicamente la cabecera del fichero, y `age.DecryptHeader` con una identity sonda, cuyo `Unwrap` registra los stanzas recibidos y devuelve un error centinela distinto de `ErrIncorrectIdentity`, entrega los stanzas parseados por `age` sin descifrar nada ni usar secretos. Ambas funciones son API pública de `age` 1.3. Para PAYLOAD_AGE se aplica en el offset del prelude. No hace falta parser propio.
---
## 4. Dependencias
| Dependencia | Versión | Uso | Nota |
|---|---|---|---|
| `filippo.io/age` | v1.3.2 | ficheros age, X25519, `Stanza`, `Recipient`, `Identity` | única implementación de STREAM; no se reimplementa |
| `github.com/drand/tlock` | v1.2.0 | `TimeLock`, `TimeUnlock`, `CiphertextToBytes`, `BytesToCiphertext` | no se usa `tlock.New`, `Encrypt` ni `Decrypt` |
| `github.com/drand/drand/v2` | v2.1.7 | `crypto.Scheme`, `VerifyBeacon`, `chain.Info` | arrastra gRPC y otros; `govulncheck` ya confirmó que no son alcanzables |
| `github.com/drand/kyber` y `kyber-bls12381` | transitivas | pairing BLS12-381 | sobre `kilic/bls12-381`, archivado; vigilar y documentar en SECURITY.md |
| `github.com/fxamacker/cbor/v2` | v2.9.4 | CBOR determinista | `CoreDetEncOptions` para codificar; límites en decodificación |
Sin otras dependencias en la librería. Tests con la biblioteca estándar. CLI con `flag`. HTTP con `net/http`.
### 4.1 Política de versiones
`go.mod` pinneado, `go.sum` verificado, `go mod verify` en CI, `govulncheck` en cada PR, Renovate (compatible con Gitea) solo para parches, con revisión manual de cualquier cambio en `age`, `tlock`, `drand` o `kyber`.
### 4.2 Canonicidad CBOR
Codificar con Core Deterministic Encoding. Al decodificar, además de los límites de `fxamacker` (sin longitudes indefinidas, sin tags, sin claves duplicadas, profundidad y tamaños acotados), se **reencodifica y se compara byte a byte** con la entrada. Cualquier diferencia es `ErrNonCanonicalCBOR`. Es el mismo principio que `dk1_` y no depende de que una librería prometa rechazar todas las formas no canónicas.
### 4.3 Bech32
`age` solo acepta identities y recipients X25519 en Bech32 por su API pública, y su paquete Bech32 es `internal`. El `.dkk` guarda 32 bytes crudos por spec. Se necesita un codificador Bech32 de unas cien líneas para pasar de bytes a `AGE-SECRET-KEY-1...` y de `age1...` a bytes. Es codificación, no criptografía. Opciones: copiar el paquete interno de `age` con su licencia BSD y atribución, o reimplementar BIP-173 con vectores de prueba. Propuesta: copiar, para no divergir.
---
## 5. Qué se copia del prototipo
| Origen | Destino | Cambios |
|---|---|---|
| `pkg/datekeys/key.go`: `RoundForTime`, `TimeForRound`, `ParseDateKey`, `FromRound` | `datekey/` | quitar campos de API y el alias `EncryptionKey`; el struct de respuesta HTTP se queda en el servidor |
| `pkg/datekeys/key_test.go`, `FuzzRecipient` | `datekey/` | renombrar, ampliar con vectores de la sección 65 |
| `internal/quicknet/trust.go` | `profile/quicknet.go` | añadir CBOR canónico y hash; conservar la autocomprobación de chain hash |
| `internal/drand/client.go` y tests | `provider/drand/` | carrera entre relays, respuestas malformadas, cancelación; adaptar a `ReleaseSource` |
| `pkg/datekeys/crypto.go` | no se copia | sustituido por `agewrap` sobre el núcleo exportado de `tlock`; se conserva la doble verificación BLS |
| `tests/integration/quicknet_test.go` | `provider/drand/`, build tag `integration` | prueba en vivo contra Quicknet |
| `cmd/datekeys` | reescrito | misma ergonomía, nueva API |
| `internal/api`, `web-client` | no se tocan | consumirán la librería más adelante |
---
## 6. Estilo de código
- Identificadores, comentarios de código, mensajes de error y commits en **inglés**. Documentación de usuario en inglés con versión en español. Motivo: la revisión externa y la comunidad de `age` y drand.
- `gofmt`, `goimports`, `go vet`, `staticcheck`, `golangci-lint` con configuración corta: `errcheck`, `govet`, `staticcheck`, `ineffassign`, `unparam`, `gosec` en modo aviso.
- Errores: un sentinel por entrada del catálogo de la sección 69, envueltos con `%w` y contexto; nunca se sustituye un error por otro más cómodo. Los tests de mutación comprueban `errors.Is`.
- Parsers: límites antes de reservar memoria, `io.LimitReader`, ningún `panic` alcanzable desde la entrada. Todo parser tiene un objetivo de fuzzing.
- Sin estado global mutable. El registro de perfiles se pasa explícitamente; el registro por defecto contiene solo Quicknet.
- Comentarios de paquete y de función citan la sección del spec que implementan, por ejemplo `// Spec §26`.
- Secretos: no se registran en logs, no aparecen en `String()`, se borran de buffers propios al terminar, sin prometer más de lo que Go garantiza.
- Salida atómica en la CLI: fichero temporal en el mismo directorio y renombrado al final; nunca sobrescribir destinos existentes.
- Versionado semántico. `v0.x` hasta que el spec sea v1.0. Sin promesa de estabilidad de API antes de `v1.0.0`.
---
## 7. Estrategia de tests
1. **Unitarios** por paquete, tabla-driven, biblioteca estándar.
2. **Vectores de spec**, generados por el código y guardados como golden files versionados: ronda (frontera, un segundo antes y después, fracción de segundo tras frontera, 2030-01-01, cercanos al genesis), `dk1_` (objeto, JSON canónico, base64url, cadena), `profile_hash` de Quicknet.
3. **Fixtures `.dkc` y `.dkk`** (secciones 67 y 68): generados una vez con `internal/testkit` sobre una **ronda ya publicada**, con la firma BLS embebida en el fixture. Los tests verifican la firma contra la clave pinneada y descifran **sin red**. Se comparan todos los valores intermedios: cabecera, prelude, binding, control, `I_PAYLOAD`, plaintext y el error esperado en cada etapa.
4. **Corpus de mutaciones** (sección 64): las veinte mutaciones como funciones sobre un fixture válido; cada una afirma su sentinel error concreto.
5. **Escritor de cabeceras age malformadas** en `testkit`: añade stanzas o cambia tipos manteniendo el MAC válido, porque en el test se conoce la file key. Demuestra que la comprobación estructural rechaza lo que el MAC aceptaría. Es la prueba directa de la amenaza del creador. Implementación: según la especificación C2SP, el MAC de cabecera es HMAC-SHA-256 con clave HKDF-SHA-256 de la file key e info `header`, sobre el texto de la cabecera; `testkit` lo recalcula con `golang.org/x/crypto/hkdf`, ya presente en el grafo por `age`. Para abrir ficheros de test con una file key conocida se usa `age.NewInjectedFileKeyIdentity`, también API pública.
6. **Propiedades:** `Encode(Decode(x)) == x` para todo fixture; toda reordenación de claves o ensanchamiento de enteros se rechaza como no canónico; `Parse(Compact(d)) == d`.
7. **Fuzzing** nativo de Go: prelude, PUBLIC_HEADER, CONTROL_CBOR, `.dkk`, `dk1_`, cabecera age vía sonda. Corpus sembrado con fixtures y mutaciones. Presupuesto corto en cada PR, largo en nightly.
8. **Integración en vivo** con build tag: cifrar hacia ahora más treinta segundos, esperar, abrir por relays reales. Nightly, no en cada PR.
9. **Interoperabilidad con herramientas ajenas:** extraer SEALED_CONTROL de un fixture `time_only` y abrirlo con la CLI `tle` oficial; extraer PAYLOAD_AGE y abrirlo con la CLI `age` usando `I_PAYLOAD`. Si ambas pasan, la afirmación "son ficheros age estándar" queda demostrada por terceros.
10. **Cobertura:** mínimo 90 % en `codec`, `capsule`, `accesskey`, `datekey`, `agewrap`; `-race` siempre.
11. **CDDL:** `spec/datekeys.cddl` valida los fixtures en un job opcional de CI con la herramienta `cddl`; si no se quiere otra toolchain, se mantiene como documento normativo y se comprueba a mano en cada cambio de schema.
---
## 8. CI, releases y cadena de suministro
- Gitea Actions, con la misma sintaxis que GitHub Actions: `test` en Linux y Windows con la versión estable de Go y la anterior, macOS cuando haya runner; `lint`; `vuln` con `govulncheck`; `fuzz-short`; `integration` nightly por cron; `sbom` con `cyclonedx-gomod`.
- Releases con `goreleaser`, que publica en Gitea: `-trimpath`, `CGO_ENABLED=0`, checksums publicados, firma con `cosign` con clave propia, ya que la firma sin clave depende de un proveedor OIDC que Gitea no ofrece.
- `SECURITY.md` con canal de reporte, versiones soportadas y la dependencia de `kilic/bls12-381` declarada como riesgo conocido y vigilado.
- `TRADEMARKS.md`: "DateKeys" reservado; "implements the DateKey protocol" permitido.
---
## 9. Hitos y criterios de aceptación
**M0. Cimientos.** Esqueleto, `go.mod` pinneado, CI con lint y `govulncheck`, `codec` con canonicidad por reencodificación y límites, `spec/datekeys.cddl` inicial, `profile` con Quicknet, su CBOR y su hash como primer vector oficial.
Hecho cuando: el hash del perfil está congelado en un golden file y CI está verde en tres sistemas.
**M1. Objetos.** `datekey` copiado y ampliado; framing DKC1 y DKK1; codecs de PUBLIC_HEADER, CONTROL_CBOR y `.dkk`; `header_binding`; `extension`; catálogo de errores; fuzzing de todos los parsers.
Hecho cuando: los vectores de ronda y `dk1_` están generados y versionados y el fuzzing lleva una noche sin fallos.
**M2. `time_only`.** `agewrap` con recipient e identity tlock estrictos, sonda de inspección, PAYLOAD_AGE, `Encrypt`, `Inspect`, `Open` con los 18 pasos; `provider/drand` copiado.
Hecho cuando: un fixture `time_only` sobre ronda pasada se abre offline, la prueba con `tle` y `age` externas pasa, y las mutaciones aplicables fallan con su error exacto.
**M3. `time_and_key`.** INNER_ACCESS_AGE con varios recipients, `.dkk` portable de un solo uso, `Identities` y `AccessKey` en `Open`.
Hecho cuando: fixtures `time_and_key` con uno y varios recipients se abren offline, la reutilización de `I_ACCESS` está prohibida en `Encrypt` y probada, y las veinte mutaciones están cubiertas.
**M4. Conformidad.** Suite de fixtures oficial, golden files, `docs/traceability.md` completo, integración nightly, SBOM y release firmada `v0.1.0`.
Hecho cuando: cada sección normativa de la 14 a la 69 apunta a al menos un test, y `v0.1.0` se construye de forma reproducible.
**M5. CLI.** `datekeys encrypt`, `decrypt`, `inspect`, `datekey resolve`, `profile hash`. `inspect` ejecuta solo los pasos 1 a 8 y nunca pide un release ni usa secretos.
Hecho cuando: la CLI abre los fixtures y reproduce la ergonomía del prototipo con salida atómica.
Fuera de estos hitos: SDK TypeScript, migración del cliente web, servidor de Release API sobre la librería, segundo perfil `evmnet`.
---
## 10. Trazabilidad
`docs/traceability.md` mantiene una tabla sección → paquete → función → test. Se actualiza en el mismo PR que cualquier cambio de código normativo. Es el documento que se entrega al revisor externo junto con el spec, los fixtures y el corpus de mutaciones.
---
## 11. Decisiones a revisar
1. Decidida: ruta `g.activething.com/go/DateKeys`. Queda abierto si se pasa a una ruta en `datekeys.com` antes de publicar. Nota: el servidor ejecuta Gitea 1.18.3, sin Actions; los workflows de `.gitea/workflows` quedan listos para Gitea 1.21 o superior con un `act_runner`, y hasta entonces `scripts/check.sh` es el control obligatorio antes de cada push.
2. Inglés para código, errores y commits.
3. Licencia Apache-2.0 para el código, CC-BY-4.0 para el spec.
4. Copiar el Bech32 interno de `age` frente a reimplementarlo.
5. Depender del módulo `drand/v2` completo o extraer solo la verificación BLS a un paquete propio sobre `kyber-bls12381`. La primera opción es más simple; la segunda reduce el grafo y el ruido de `govulncheck`.
6. Incluir en la librería un cliente de la Release API de DateKeys además del de relays drand, o dejarlo para el servidor.
7. Validación CDDL en CI con toolchain externa, o solo como documento.
8. Si `Open` exige `io.ReadSeeker` o acepta `io.Reader` y degrada el SHOULD.
---
## 12. Riesgos conocidos
- `kilic/bls12-381` archivado bajo `drand` y `tlock`. Mitigación: pinneado, vigilancia, plan de fork o de migración documentado en `SECURITY.md`.
- `tlock` sin etiqueta desde agosto de 2024. Mitigación: pinneado por versión; solo se usa su núcleo exportado.
- Fixtures sobre rondas pasadas dependen de que la firma embebida sea auténtica. Mitigación: se verifica BLS en cada ejecución contra la clave pinneada.
- Desviación spec ↔ código. Mitigación: trazabilidad, política de cambios de la sección 76, y una segunda implementación en TypeScript como prueba de interoperabilidad.

20
package.json
Unescape View File

@ -0,0 +1,20 @@
{
"name": "datekeys-app",
"version": "0.0.0",
"private": true,
"description": "DateKeys in TypeScript: canonical CBOR codec, DKC1/DKK1 parsers, capsule inspector and, later, browser encryption and decryption.",
"type": "module",
"engines": {
"node": ">=20"
},
"scripts": {
"test": "vitest run",
"typecheck": "tsc --noEmit",
"testdata:sync": "node scripts/sync-testdata.mjs sync",
"testdata:check": "node scripts/sync-testdata.mjs check --against ../datekeys-go"
},
"devDependencies": {
"typescript": "5.9.3",
"vitest": "5.0.1"
}
}

124
scripts/sync-testdata.mjs
Unescape View File

@ -0,0 +1,124 @@
#!/usr/bin/env node
// Vendors testdata/ from the Go reference implementation (g.activething.com/go/DateKeys)
// at one pinned commit and verifies it. The Go fixtures and vectors are the source of
// truth: this project never generates its own.
//
// node scripts/sync-testdata.mjs sync [--repo ../datekeys-go] [--commit HEAD]
// node scripts/sync-testdata.mjs check [--against ../datekeys-go]
//
// sync copies every blob under testdata/ at the commit (read with git, so uncommitted
// changes in the Go checkout are never picked up) and writes testdata/SOURCE.json with
// the full commit id and the SHA-256 of each file. check verifies that the files on disk
// match SOURCE.json exactly, with no missing or extra files; with --against it also
// re-reads every blob from the Go repository at the recorded commit.
// No dependencies: Node and git only.
import { execFileSync } from 'node:child_process';
import { createHash } from 'node:crypto';
import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { dirname, join, relative, resolve, sep } from 'node:path';
import { fileURLToPath } from 'node:url';
const MODULE = 'g.activething.com/go/DateKeys';
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const TESTDATA = join(ROOT, 'testdata');
const SOURCE = join(TESTDATA, 'SOURCE.json');
const DEFAULT_REPO = resolve(ROOT, '..', 'datekeys-go');
function git(repo, args) {
return execFileSync('git', ['-C', repo, ...args], { encoding: 'buffer', maxBuffer: 1 << 30 });
}
function sha256(buf) {
return createHash('sha256').update(buf).digest('hex');
}
// Files under testdata/ at commit, as paths relative to testdata/ with forward slashes.
function listBlobs(repo, commit) {
const out = git(repo, ['ls-tree', '-r', '-z', '--full-tree', commit, '--', 'testdata']).toString('utf8');
return out.split('\0').filter(Boolean).map(line => {
const [meta, path] = line.split('\t');
const [mode, type] = meta.split(' ');
if (type !== 'blob' || mode === '120000') throw new Error(`unsupported entry ${path} (${mode} ${type})`);
return path.slice('testdata/'.length);
}).sort();
}
function readBlob(repo, commit, path) {
return git(repo, ['cat-file', 'blob', `${commit}:testdata/${path}`]);
}
// Files on disk under testdata/, excluding SOURCE.json.
function listLocal(dir = TESTDATA) {
let files = [];
for (const entry of readdirSync(dir, { withFileTypes: true })) {
const full = join(dir, entry.name);
if (entry.isDirectory()) files = files.concat(listLocal(full));
else if (full !== SOURCE) files.push(relative(TESTDATA, full).split(sep).join('/'));
}
return files.sort();
}
function sync(repo, rev) {
const commit = git(repo, ['rev-parse', '--verify', `${rev}^{commit}`]).toString('utf8').trim();
const paths = listBlobs(repo, commit);
if (paths.length === 0) throw new Error(`no testdata/ at ${commit}`);
// Read everything before touching the local copy, so a failed read leaves it intact.
const blobs = paths.map(path => [path, readBlob(repo, commit, path)]);
rmSync(TESTDATA, { recursive: true, force: true });
const files = {};
for (const [path, data] of blobs) {
const target = join(TESTDATA, ...path.split('/'));
mkdirSync(dirname(target), { recursive: true });
writeFileSync(target, data);
files[path] = sha256(data);
}
writeFileSync(SOURCE, JSON.stringify({ module: MODULE, commit, files }, null, 2) + '\n');
console.log(`testdata: ${paths.length} files from ${MODULE} at ${commit}`);
}
function check(against) {
const source = JSON.parse(readFileSync(SOURCE, 'utf8'));
const expected = Object.keys(source.files).sort();
const actual = listLocal();
const errors = [];
for (const path of expected) {
if (!actual.includes(path)) { errors.push(`missing ${path}`); continue; }
if (sha256(readFileSync(join(TESTDATA, ...path.split('/')))) !== source.files[path]) errors.push(`modified ${path}`);
}
for (const path of actual) if (!(path in source.files)) errors.push(`extra ${path}`);
if (against) {
const upstream = listBlobs(against, source.commit);
if (upstream.join('\n') !== expected.join('\n')) errors.push(`file list differs from ${source.commit}`);
for (const path of upstream) {
if (sha256(readBlob(against, source.commit, path)) !== source.files[path]) errors.push(`differs from upstream ${path}`);
}
}
if (errors.length) {
for (const e of errors) console.error(`testdata: ${e}`);
process.exit(1);
}
console.log(`testdata: ${expected.length} files match ${source.module} at ${source.commit}${against ? ' (verified against the repository)' : ''}`);
}
function option(args, name, fallback) {
const i = args.indexOf(name);
if (i === -1) return fallback;
if (i + 1 >= args.length) throw new Error(`${name} needs a value`);
return args[i + 1];
}
const [command, ...args] = process.argv.slice(2);
try {
if (command === 'sync') sync(resolve(option(args, '--repo', DEFAULT_REPO)), option(args, '--commit', 'HEAD'));
else if (command === 'check') {
const against = option(args, '--against', null);
check(against && resolve(against));
} else {
console.error('usage: sync-testdata.mjs sync [--repo PATH] [--commit REV] | check [--against PATH]');
process.exit(2);
}
} catch (err) {
console.error(`testdata: ${err.message}`);
process.exit(1);
}

28
testdata/SOURCE.json vendored
Unescape View File

@ -0,0 +1,28 @@
{
"module": "g.activething.com/go/DateKeys",
"commit": "5719f6a4b3654f608091e32290d9fcfbc7e38062",
"files": {
"fixtures/empty_payload.dkc": "871e9bf05b52bbae17f3adfbbf97b46e7f0e53aa8f57bcaa506e43f36f53a9d4",
"fixtures/empty_payload.json": "584f7a5a8982d5a9184ee6a4699fa39ad82c92a3d01d573c3e94e603db9b0956",
"fixtures/empty_payload.plaintext": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"fixtures/time_and_key_portable.dkc": "2e97878078bae6358037a9c264f379a3cbe839f767d69836b0343f35657b2972",
"fixtures/time_and_key_portable.dkk": "e528fa2c832c91119f0684bb9d6fb3c4c2d0d55183482890e7c4fe92f668426a",
"fixtures/time_and_key_portable.dkk.json": "6f940bc94f4eb13e41ccbbb76c69098ec9c5bc32cb86963e57b839c56ebf9534",
"fixtures/time_and_key_portable.json": "74936213a5d481dc216ad36115523bebc6973823cf89782b50a96eb4649ffcbe",
"fixtures/time_and_key_portable.plaintext": "937492203d207d6fe36161b8696bf1f05b8b4cc56d855c44853f4b76aad3a05b",
"fixtures/time_and_key_recipients.dkc": "69ac110380f5d768b5b6afaa157a50ed17d8ceccfbd4604ffa5b6da38539b635",
"fixtures/time_and_key_recipients.dkk": "19f6c47150c3194712d454f43c7392b7344e6b4e7b074d83e9ca5f563a8e072f",
"fixtures/time_and_key_recipients.dkk.json": "e2f8adde5da559be559647951d95b949c7eec6bffb1fea8e477a5b5521971f3a",
"fixtures/time_and_key_recipients.json": "446815de9bff62e6dcc00a106ba7ab05a3601c748b6de8c53a0c3ef5ce7ce843",
"fixtures/time_and_key_recipients.plaintext": "0e9fd50e98a85953aa9cf07a11ee3c62bb3d7622f344f1c6ce744d1ed111659f",
"fixtures/time_only.dkc": "99e915810d595f1092700b728f5e5081d78efe83f5343e76325b1bcc2c33ccf2",
"fixtures/time_only.json": "a38a6287b10ad944669f07b3327cd7405e9f76778240ec935a408580261d0e84",
"fixtures/time_only.plaintext": "53b8ee821fb7b678e89d4f93da1812339f6cc1ab83aac6ed1432db99df784be5",
"fixtures/time_only_extensions.dkc": "1e7effd58016d9447f9a2e7c9645c658604979c4e35af675d1dc6c4ae12ac444",
"fixtures/time_only_extensions.json": "c70ead5b8e196b942f89dc6c105e651d2ed2acc4289d1fd2dca98bd9eeb83293",
"fixtures/time_only_extensions.plaintext": "1129768e195e2f1e50b7a6f926b6eebef120212c29b5642c8a662c503b2a9131",
"vectors/dk1.json": "5127b8015b93c8f2b7cc92b75cbbad0a22073b39381901851a79656383d83426",
"vectors/profile_quicknet.json": "caa840b2ae49b2c220fb31c0a71ade98d170c1d5ab2e2210e980b98c88d58bec",
"vectors/quicknet_rounds.json": "fb9fb27671e5c1db2a80a2492e82fe3a702a5ddbf7afffe95c64f842d07bc54f"
}
}

BIN
testdata/fixtures/empty_payload.dkc vendored
View File

Binary file not shown.

121
testdata/fixtures/empty_payload.json vendored
Unescape View File

@ -0,0 +1,121 @@
{
"description": "time_only capsule with an empty payload",
"spec": "0.8.1",
"file": "empty_payload.dkc",
"sha256": "871e9bf05b52bbae17f3adfbbf97b46e7f0e53aa8f57bcaa506e43f36f53a9d4",
"release": {
"round": 1001,
"signature": "b33bf3667cbd5a82de3a24b4e0e9fe5513cc1a0e840368c6e31f5fcfa79bea03f73896b25883abf2853d10337fb8fa41"
},
"prelude": "444b43310100000000000079000001be",
"public_header": "a5006a646174656b657963617001010250ab10174561a9a19a6d9dc9ab1ef59c66037853646b315f65794a325a584a7a61573975496a6f784c434a755a58523362334a72496a6f695a4746305a57746c65584d3663585670593274755a585136646a45694c434a79623356755a4349364d5441774d58300400",
"datekey": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMX0",
"capsule_id": "ab10174561a9a19a6d9dc9ab1ef59c66",
"access_policy": "time_only",
"structure": "time_only",
"unlock_at": "2023-08-23T15:59:27Z",
"header_binding": "33186a4f03d79eb8e28dbb82d2538ada45b68cd4f2ed6d17fa87b211e54f4d58",
"outer_stanzas": [
{
"type": "tlock",
"args": [
"1001",
"52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"
]
}
],
"payload_stanzas": [
{
"type": "X25519",
"args": [
"kT/xASH7NSOUvlk9XfIAh37JzSq6kWxPKVkSzflygjY"
]
}
],
"control_cbor": "a40070646174656b6579732d636f6e74726f6c010102582033186a4f03d79eb8e28dbb82d2538ada45b68cd4f2ed6d17fa87b211e54f4d58035820cd5ca142d51386860bf4ae4ae16740d498ef70ff534084acf5f4005b74f278c3",
"payload_identity": "cd5ca142d51386860bf4ae4ae16740d498ef70ff534084acf5f4005b74f278c3",
"plaintext_file": "empty_payload.plaintext",
"plaintext_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"stages": [
{
"step": 1,
"name": "parse DKC1",
"ok": true
},
{
"step": 2,
"name": "prelude",
"ok": true
},
{
"step": 3,
"name": "public header",
"ok": true
},
{
"step": 4,
"name": "header validation",
"ok": true
},
{
"step": 5,
"name": "sealed control structure",
"ok": true
},
{
"step": 6,
"name": "payload structure",
"ok": true
},
{
"step": 7,
"name": "condition",
"ok": true
},
{
"step": 8,
"name": "tlock stanza",
"ok": true
},
{
"step": 9,
"name": "release",
"ok": true
},
{
"step": 10,
"name": "release verification",
"ok": true
},
{
"step": 11,
"name": "open sealed control",
"ok": true
},
{
"step": 12,
"name": "policy structure",
"ok": true
},
{
"step": 14,
"name": "control",
"ok": true
},
{
"step": 15,
"name": "header binding",
"ok": true
},
{
"step": 16,
"name": "payload identity",
"ok": true
},
{
"step": 18,
"name": "commit",
"ok": true
}
]
}

0
testdata/fixtures/empty_payload.plaintext vendored
Unescape View File

BIN
testdata/fixtures/time_and_key_portable.dkc vendored
View File

Binary file not shown.

BIN
testdata/fixtures/time_and_key_portable.dkk vendored
View File

Binary file not shown.

13
testdata/fixtures/time_and_key_portable.dkk.json vendored
Unescape View File

@ -0,0 +1,13 @@
{
"description": "portable X25519 .dkk of time_and_key_portable.dkc",
"spec": "0.8.1",
"file": "time_and_key_portable.dkk",
"sha256": "e528fa2c832c91119f0684bb9d6fb3c4c2d0d55183482890e7c4fe92f668426a",
"credential_id": "3955e944a3c60cfa1fd6485e9693c77d",
"capsule_id": "448e134a13457c319cab7fceaf7ffa1f",
"access_type": "x25519",
"access_material": "3d5e4d51f21236ecff40d89c0adcf9aa325a24b91b46fd9d1afa482f54b2d2c6",
"capsule_digest": "2e97878078bae6358037a9c264f379a3cbe839f767d69836b0343f35657b2972",
"capsule": "time_and_key_portable.dkc",
"expected_result": "opens INNER_ACCESS_AGE of time_and_key_portable.dkc and yields its CONTROL_CBOR"
}

140
testdata/fixtures/time_and_key_portable.json vendored
Unescape View File

@ -0,0 +1,140 @@
{
"description": "time_and_key capsule whose only recipient is a portable .dkk",
"spec": "0.8.1",
"file": "time_and_key_portable.dkc",
"sha256": "2e97878078bae6358037a9c264f379a3cbe839f767d69836b0343f35657b2972",
"release": {
"round": 1000,
"signature": "b44679b9a59af2ec876b1a6b1ad52ea9b1615fc3982b19576350f93447cb1125e342b73a8dd2bacbe47e4b6b63ed5e39"
},
"prelude": "444b4331010000000000007900000286",
"public_header": "a5006a646174656b657963617001010250448e134a13457c319cab7fceaf7ffa1f037853646b315f65794a325a584a7a61573975496a6f784c434a755a58523362334a72496a6f695a4746305a57746c65584d3663585670593274755a585136646a45694c434a79623356755a4349364d5441774d48300401",
"datekey": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH0",
"capsule_id": "448e134a13457c319cab7fceaf7ffa1f",
"access_policy": "time_and_key",
"structure": "time_and_key",
"unlock_at": "2023-08-23T15:59:24Z",
"header_binding": "841fe789895abdd0ffecb0eb7562f4c4b4dfd0d1f8ec6fd251adbe1a89d5ab5f",
"outer_stanzas": [
{
"type": "tlock",
"args": [
"1000",
"52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"
]
}
],
"payload_stanzas": [
{
"type": "X25519",
"args": [
"/g3xW+kK9u65qfWLzS5huoFB/JIc9EqG3QBOfuO9PVQ"
]
}
],
"inner_stanzas": [
{
"type": "X25519",
"args": [
"FyePxd/IAO/2FpE3kQgiidbDsxRVuNM/eEI3SDbbamc"
]
}
],
"access_key_file": "time_and_key_portable.dkk",
"control_cbor": "a40070646174656b6579732d636f6e74726f6c0101025820841fe789895abdd0ffecb0eb7562f4c4b4dfd0d1f8ec6fd251adbe1a89d5ab5f0358202536e99b16373ca8d118695c600fd652541367b0198dbfaba9362a98f9fa70cb",
"payload_identity": "2536e99b16373ca8d118695c600fd652541367b0198dbfaba9362a98f9fa70cb",
"plaintext_file": "time_and_key_portable.plaintext",
"plaintext_sha256": "937492203d207d6fe36161b8696bf1f05b8b4cc56d855c44853f4b76aad3a05b",
"stages": [
{
"step": 1,
"name": "parse DKC1",
"ok": true
},
{
"step": 2,
"name": "prelude",
"ok": true
},
{
"step": 3,
"name": "public header",
"ok": true
},
{
"step": 4,
"name": "header validation",
"ok": true
},
{
"step": 5,
"name": "sealed control structure",
"ok": true
},
{
"step": 6,
"name": "payload structure",
"ok": true
},
{
"step": 7,
"name": "condition",
"ok": true
},
{
"step": 8,
"name": "tlock stanza",
"ok": true
},
{
"step": 9,
"name": "access credential",
"ok": true
},
{
"step": 9,
"name": "release",
"ok": true
},
{
"step": 10,
"name": "release verification",
"ok": true
},
{
"step": 11,
"name": "open sealed control",
"ok": true
},
{
"step": 12,
"name": "policy structure",
"ok": true
},
{
"step": 13,
"name": "open access layer",
"ok": true
},
{
"step": 14,
"name": "control",
"ok": true
},
{
"step": 15,
"name": "header binding",
"ok": true
},
{
"step": 16,
"name": "payload identity",
"ok": true
},
{
"step": 18,
"name": "commit",
"ok": true
}
]
}

1
testdata/fixtures/time_and_key_portable.plaintext vendored
Unescape View File

@ -0,0 +1 @@
DateKeys fixture opened with a portable .dkk.

BIN
testdata/fixtures/time_and_key_recipients.dkc vendored
View File

Binary file not shown.

BIN
testdata/fixtures/time_and_key_recipients.dkk vendored
View File

Binary file not shown.

13
testdata/fixtures/time_and_key_recipients.dkk.json vendored
Unescape View File

@ -0,0 +1,13 @@
{
"description": "portable X25519 .dkk of time_and_key_recipients.dkc",
"spec": "0.8.1",
"file": "time_and_key_recipients.dkk",
"sha256": "19f6c47150c3194712d454f43c7392b7344e6b4e7b074d83e9ca5f563a8e072f",
"credential_id": "b89292aedf6d05d584cec9a871ce8735",
"capsule_id": "c75dfc8e9c576d1369910664df93693a",
"access_type": "x25519",
"access_material": "42d6d897097fd5af2772e058db17920afe1390e2856139bc2f800294564dd7ac",
"capsule_digest": "69ac110380f5d768b5b6afaa157a50ed17d8ceccfbd4604ffa5b6da38539b635",
"capsule": "time_and_key_recipients.dkc",
"expected_result": "opens INNER_ACCESS_AGE of time_and_key_recipients.dkc and yields its CONTROL_CBOR"
}

156
testdata/fixtures/time_and_key_recipients.json vendored
Unescape View File

@ -0,0 +1,156 @@
{
"description": "time_and_key capsule for two known X25519 recipients and a portable .dkk",
"spec": "0.8.1",
"file": "time_and_key_recipients.dkc",
"sha256": "69ac110380f5d768b5b6afaa157a50ed17d8ceccfbd4604ffa5b6da38539b635",
"release": {
"round": 1001,
"signature": "b33bf3667cbd5a82de3a24b4e0e9fe5513cc1a0e840368c6e31f5fcfa79bea03f73896b25883abf2853d10337fb8fa41"
},
"prelude": "444b433101000000000000790000034a",
"public_header": "a5006a646174656b657963617001010250c75dfc8e9c576d1369910664df93693a037853646b315f65794a325a584a7a61573975496a6f784c434a755a58523362334a72496a6f695a4746305a57746c65584d3663585670593274755a585136646a45694c434a79623356755a4349364d5441774d58300401",
"datekey": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMX0",
"capsule_id": "c75dfc8e9c576d1369910664df93693a",
"access_policy": "time_and_key",
"structure": "time_and_key",
"unlock_at": "2023-08-23T15:59:27Z",
"header_binding": "5d789b4bde52beecbad4b80e9b0a8fec8b59b6a84263af6d022cd1eccfded0e2",
"outer_stanzas": [
{
"type": "tlock",
"args": [
"1001",
"52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"
]
}
],
"payload_stanzas": [
{
"type": "X25519",
"args": [
"ew9JpO0AGTGmWXpZCEHsSrN0Ey2kSjzphbokfjCMoF4"
]
}
],
"inner_stanzas": [
{
"type": "X25519",
"args": [
"sOnq+vJxTJVHlPwhfXd2LovGNqRMuyS3e7qJQm8at0E"
]
},
{
"type": "X25519",
"args": [
"T8NHQ9xo+IaBvEoqirkEgwdbFzOUt19moVhfvkebdUY"
]
},
{
"type": "X25519",
"args": [
"tIu+bu/q+z3ACTYdwpolbaSwA7PXv4QVjXbcrgOXAAM"
]
}
],
"access_key_file": "time_and_key_recipients.dkk",
"identities": [
"AGE-SECRET-KEY-1DPM6CQMQV3665FK762HTVC37XAY6X99MM4YLJ9J0J2DQD7K63GCSG5TMCK",
"AGE-SECRET-KEY-15MEM79HAM2XQ79HN5QVCLECUDM4JQQKWEE9JWR3VV2FWK033AXPQQ2422Y"
],
"control_cbor": "a40070646174656b6579732d636f6e74726f6c01010258205d789b4bde52beecbad4b80e9b0a8fec8b59b6a84263af6d022cd1eccfded0e20358205d3f4172eca48e5d5b2570208cfe3298c4735f1d77ceaed958bcccb8eec18a12",
"payload_identity": "5d3f4172eca48e5d5b2570208cfe3298c4735f1d77ceaed958bcccb8eec18a12",
"plaintext_file": "time_and_key_recipients.plaintext",
"plaintext_sha256": "0e9fd50e98a85953aa9cf07a11ee3c62bb3d7622f344f1c6ce744d1ed111659f",
"stages": [
{
"step": 1,
"name": "parse DKC1",
"ok": true
},
{
"step": 2,
"name": "prelude",
"ok": true
},
{
"step": 3,
"name": "public header",
"ok": true
},
{
"step": 4,
"name": "header validation",
"ok": true
},
{
"step": 5,
"name": "sealed control structure",
"ok": true
},
{
"step": 6,
"name": "payload structure",
"ok": true
},
{
"step": 7,
"name": "condition",
"ok": true
},
{
"step": 8,
"name": "tlock stanza",
"ok": true
},
{
"step": 9,
"name": "access credential",
"ok": true
},
{
"step": 9,
"name": "release",
"ok": true
},
{
"step": 10,
"name": "release verification",
"ok": true
},
{
"step": 11,
"name": "open sealed control",
"ok": true
},
{
"step": 12,
"name": "policy structure",
"ok": true
},
{
"step": 13,
"name": "open access layer",
"ok": true
},
{
"step": 14,
"name": "control",
"ok": true
},
{
"step": 15,
"name": "header binding",
"ok": true
},
{
"step": 16,
"name": "payload identity",
"ok": true
},
{
"step": 18,
"name": "commit",
"ok": true
}
]
}

1
testdata/fixtures/time_and_key_recipients.plaintext vendored
Unescape View File

@ -0,0 +1 @@
DateKeys fixture for several recipients.

BIN
testdata/fixtures/time_only.dkc vendored
View File

Binary file not shown.

121
testdata/fixtures/time_only.json vendored
Unescape View File

@ -0,0 +1,121 @@
{
"description": "time_only capsule, two STREAM chunks, no extensions",
"spec": "0.8.1",
"file": "time_only.dkc",
"sha256": "99e915810d595f1092700b728f5e5081d78efe83f5343e76325b1bcc2c33ccf2",
"release": {
"round": 1000,
"signature": "b44679b9a59af2ec876b1a6b1ad52ea9b1615fc3982b19576350f93447cb1125e342b73a8dd2bacbe47e4b6b63ed5e39"
},
"prelude": "444b43310100000000000079000001be",
"public_header": "a5006a646174656b657963617001010250ad4d676812b134ff8a3de263f77018b4037853646b315f65794a325a584a7a61573975496a6f784c434a755a58523362334a72496a6f695a4746305a57746c65584d3663585670593274755a585136646a45694c434a79623356755a4349364d5441774d48300400",
"datekey": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH0",
"capsule_id": "ad4d676812b134ff8a3de263f77018b4",
"access_policy": "time_only",
"structure": "time_only",
"unlock_at": "2023-08-23T15:59:24Z",
"header_binding": "8e1d05df55bc626a579759d54d436b512b7bfc71039d3c12c1875a5b475f2417",
"outer_stanzas": [
{
"type": "tlock",
"args": [
"1000",
"52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"
]
}
],
"payload_stanzas": [
{
"type": "X25519",
"args": [
"LvR2+5baviJPeIiyw96VfTW1GnzTw3DbWIPGuq9amEw"
]
}
],
"control_cbor": "a40070646174656b6579732d636f6e74726f6c01010258208e1d05df55bc626a579759d54d436b512b7bfc71039d3c12c1875a5b475f2417035820e63d28ff1a6d1975263db49ff80c3bf949737d20aeedcc9539e648ffd330082b",
"payload_identity": "e63d28ff1a6d1975263db49ff80c3bf949737d20aeedcc9539e648ffd330082b",
"plaintext_file": "time_only.plaintext",
"plaintext_sha256": "53b8ee821fb7b678e89d4f93da1812339f6cc1ab83aac6ed1432db99df784be5",
"stages": [
{
"step": 1,
"name": "parse DKC1",
"ok": true
},
{
"step": 2,
"name": "prelude",
"ok": true
},
{
"step": 3,
"name": "public header",
"ok": true
},
{
"step": 4,
"name": "header validation",
"ok": true
},
{
"step": 5,
"name": "sealed control structure",
"ok": true
},
{
"step": 6,
"name": "payload structure",
"ok": true
},
{
"step": 7,
"name": "condition",
"ok": true
},
{
"step": 8,
"name": "tlock stanza",
"ok": true
},
{
"step": 9,
"name": "release",
"ok": true
},
{
"step": 10,
"name": "release verification",
"ok": true
},
{
"step": 11,
"name": "open sealed control",
"ok": true
},
{
"step": 12,
"name": "policy structure",
"ok": true
},
{
"step": 14,
"name": "control",
"ok": true
},
{
"step": 15,
"name": "header binding",
"ok": true
},
{
"step": 16,
"name": "payload identity",
"ok": true
},
{
"step": 18,
"name": "commit",
"ok": true
}
]
}

1000
testdata/fixtures/time_only.plaintext vendored
View File

File diff suppressed because it is too large Load Diff

BIN
testdata/fixtures/time_only_extensions.dkc vendored
View File

Binary file not shown.

137
testdata/fixtures/time_only_extensions.json vendored
Unescape View File

@ -0,0 +1,137 @@
{
"description": "time_only capsule with a noncritical PUBLIC_HEADER extension and a noncritical CONTROL_CBOR extension",
"spec": "0.8.1",
"file": "time_only_extensions.dkc",
"sha256": "1e7effd58016d9447f9a2e7c9645c658604979c4e35af675d1dc6c4ae12ac444",
"release": {
"round": 2000,
"signature": "b6cb8f482a0b15d45936a4c4ea08e98a087e71787caee3f4d07a8a9843b1bc5423c6b3c22f446488b3137eaca799c77e"
},
"prelude": "444b4331010000000000009f000001e2",
"public_header": "a6006a646174656b657963617001010250d2fd9af55dc0253132fb36b8dc0d016b037853646b315f65794a325a584a7a61573975496a6f784c434a755a58523362334a72496a6f695a4746305a57746c65584d3663585670593274755a585136646a45694c434a79623356755a4349364d6a41774d483004000681a300716f72672e6578616d706c652e6c6162656c0101026c7075626c6963206c6162656c",
"datekey": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MjAwMH0",
"capsule_id": "d2fd9af55dc0253132fb36b8dc0d016b",
"access_policy": "time_only",
"structure": "time_only",
"unlock_at": "2023-08-23T16:49:24Z",
"header_binding": "a4fa1e3c5a47a01313173cdf23df157ff8c949011df95dde8f092ff6749dc154",
"outer_stanzas": [
{
"type": "tlock",
"args": [
"2000",
"52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"
]
}
],
"payload_stanzas": [
{
"type": "X25519",
"args": [
"pUUIuCTHAZ3+kpMwJQQ9dc3EJO1zPagucu+VdFovSy0"
]
}
],
"control_cbor": "a50070646174656b6579732d636f6e74726f6c0101025820a4fa1e3c5a47a01313173cdf23df157ff8c949011df95dde8f092ff6749dc1540358201b27d7029c50dc20ef1f9269a1a944a1384f526f9ea76cdc9c76a6456bb1fbb80581a300706f72672e6578616d706c652e6e6f7465010202a2616e07667365616c6564f5",
"payload_identity": "1b27d7029c50dc20ef1f9269a1a944a1384f526f9ea76cdc9c76a6456bb1fbb8",
"plaintext_file": "time_only_extensions.plaintext",
"plaintext_sha256": "1129768e195e2f1e50b7a6f926b6eebef120212c29b5642c8a662c503b2a9131",
"header_extensions": [
{
"critical": false,
"id": "org.example.label",
"version": 1,
"data": "6c7075626c6963206c6162656c"
}
],
"control_extensions": [
{
"critical": false,
"id": "org.example.note",
"version": 2,
"data": "a2616e07667365616c6564f5"
}
],
"stages": [
{
"step": 1,
"name": "parse DKC1",
"ok": true
},
{
"step": 2,
"name": "prelude",
"ok": true
},
{
"step": 3,
"name": "public header",
"ok": true
},
{
"step": 4,
"name": "header validation",
"ok": true
},
{
"step": 5,
"name": "sealed control structure",
"ok": true
},
{
"step": 6,
"name": "payload structure",
"ok": true
},
{
"step": 7,
"name": "condition",
"ok": true
},
{
"step": 8,
"name": "tlock stanza",
"ok": true
},
{
"step": 9,
"name": "release",
"ok": true
},
{
"step": 10,
"name": "release verification",
"ok": true
},
{
"step": 11,
"name": "open sealed control",
"ok": true
},
{
"step": 12,
"name": "policy structure",
"ok": true
},
{
"step": 14,
"name": "control",
"ok": true
},
{
"step": 15,
"name": "header binding",
"ok": true
},
{
"step": 16,
"name": "payload identity",
"ok": true
},
{
"step": 18,
"name": "commit",
"ok": true
}
]
}

1
testdata/fixtures/time_only_extensions.plaintext vendored
Unescape View File

@ -0,0 +1 @@
DateKeys fixture with extensions.

153
testdata/vectors/dk1.json vendored
Unescape View File

@ -0,0 +1,153 @@
{
"spec": "0.8.1",
"description": "Canonical dk1_ strings and rejected encodings (spec §18, §19, §66), generated by the reference implementation.",
"vectors": [
{
"name": "round 1",
"network": "datekeys:quicknet:v1",
"round": 1,
"canonical_json": "{\"version\":1,\"network\":\"datekeys:quicknet:v1\",\"round\":1}",
"base64url": "eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MX0",
"dk1": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MX0"
},
{
"name": "round 1000",
"network": "datekeys:quicknet:v1",
"round": 1000,
"canonical_json": "{\"version\":1,\"network\":\"datekeys:quicknet:v1\",\"round\":1000}",
"base64url": "eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH0",
"dk1": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH0"
},
{
"name": "normative 2030-01-01 round",
"network": "datekeys:quicknet:v1",
"round": 66884212,
"canonical_json": "{\"version\":1,\"network\":\"datekeys:quicknet:v1\",\"round\":66884212}",
"base64url": "eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"dk1": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9"
},
{
"name": "last Quicknet round",
"network": "datekeys:quicknet:v1",
"round": 83903165811,
"canonical_json": "{\"version\":1,\"network\":\"datekeys:quicknet:v1\",\"round\":83903165811}",
"base64url": "eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6ODM5MDMxNjU4MTF9",
"dk1": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6ODM5MDMxNjU4MTF9"
},
{
"name": "whitespace in JSON",
"input": "dk1_eyJ2ZXJzaW9uIjogMSwgIm5ldHdvcmsiOiAiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCAicm91bmQiOiA2Njg4NDIxMn0",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "keys reordered",
"input": "dk1_eyJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJ2ZXJzaW9uIjoxLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "trailing whitespace",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9Cg",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "exponent notation",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6Ni42ODg0MjEyZTd9",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "fraction notation",
"input": "dk1_eyJ2ZXJzaW9uIjoxLjAsIm5ldHdvcmsiOiJkYXRla2V5czpxdWlja25ldDp2MSIsInJvdW5kIjo2Njg4NDIxMn0",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "escaped character",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXNcdTAwM2FxdWlja25ldDp2MSIsInJvdW5kIjo2Njg4NDIxMn0",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "duplicate key",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MSwicm91bmQiOjY2ODg0MjEyfQ",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "padded Base64URL",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH0=",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "non-zero trailing bits",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MTAwMH1",
"error": "ERR_DATEKEY_NON_CANONICAL"
},
{
"name": "extra field",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTIsInB1YmxpY19rZXkiOiIwMCJ9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "missing field",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEifQ",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "version 2",
"input": "dk1_eyJ2ZXJzaW9uIjoyLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "round 0",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MH0",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "negative round",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6LTF9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "fractional round",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6MS41fQ",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "round above 2^53-1",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6OTAwNzE5OTI1NDc0MDk5Mn0",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "round as string",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6IjY2ODg0MjEyIn0",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "uppercase network",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiREFURUtFWVM6UVVJQ0tORVQ6VjEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "trailing data",
"input": "dk1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9eA",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "byte order mark",
"input": "dk1_77u_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "not Base64",
"input": "dk1_!!!",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "missing prefix",
"input": "eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "uppercase prefix",
"input": "DK1_eyJ2ZXJzaW9uIjoxLCJuZXR3b3JrIjoiZGF0ZWtleXM6cXVpY2tuZXQ6djEiLCJyb3VuZCI6NjY4ODQyMTJ9",
"error": "ERR_DATEKEY_INVALID"
}
]
}

15
testdata/vectors/profile_quicknet.json vendored
Unescape View File

@ -0,0 +1,15 @@
{
"spec": "0.8.1",
"description": "Quicknet Provider Profile V1: exact Deterministic CBOR and profile_hash (spec §11, §12, §75 item 2), generated by the reference implementation.",
"profile_id": "datekeys:quicknet:v1",
"provider": "drand",
"network": "quicknet",
"chain_hash": "52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971",
"public_key": "83cf0f2896adee7eb8b5f01fcad3912212c437e0073e911fb90022d3e760183c8c4b450b6a0a6c3ac6a5776a2d1064510d1fec758c921cc22b0e17e63aaf4bcb5ed66304de9cf809bd274ca73bab4af5a6e9c76a4bc09e76eae8991ef5ece45a",
"period_seconds": 3,
"genesis_time": 1692803367,
"genesis_seed": "f477d5c89f21a17c863a7f937c6a6d15859414d2be09cd448d4279af331c5d3e",
"scheme": "bls-unchained-g1-rfc9380",
"canonical_cbor": "ab007819646174656b6579732d70726f76696465722d70726f66696c6501010274646174656b6579733a717569636b6e65743a763103656472616e640468717569636b6e657405582052db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e97106586083cf0f2896adee7eb8b5f01fcad3912212c437e0073e911fb90022d3e760183c8c4b450b6a0a6c3ac6a5776a2d1064510d1fec758c921cc22b0e17e63aaf4bcb5ed66304de9cf809bd274ca73bab4af5a6e9c76a4bc09e76eae8991ef5ece45a0703081a64e62127097818626c732d756e636861696e65642d67312d726663393338300a5820f477d5c89f21a17c863a7f937c6a6d15859414d2be09cd448d4279af331c5d3e",
"profile_hash": "4147645109798ecbc9f630c2f709835bb5846fe7911a6bd5c5755e25ade2ada4"
}

107
testdata/vectors/quicknet_rounds.json vendored
Unescape View File

@ -0,0 +1,107 @@
{
"spec": "0.8.1",
"profile": "datekeys:quicknet:v1",
"description": "Quicknet date to round resolution (spec §15, §16, §65), generated by the reference implementation.",
"vectors": [
{
"name": "genesis exactly: round 1",
"requested": "2023-08-23T15:09:27Z",
"round": 1,
"effective": "2023-08-23T15:09:27Z"
},
{
"name": "genesis + 1ns: next round",
"requested": "2023-08-23T15:09:27.000000001Z",
"round": 2,
"effective": "2023-08-23T15:09:30Z"
},
{
"name": "genesis + 1s",
"requested": "2023-08-23T15:09:28Z",
"round": 2,
"effective": "2023-08-23T15:09:30Z"
},
{
"name": "genesis + one period: round 2",
"requested": "2023-08-23T15:09:30Z",
"round": 2,
"effective": "2023-08-23T15:09:30Z"
},
{
"name": "genesis + one period + 1ns: round 3",
"requested": "2023-08-23T15:09:30.000000001Z",
"round": 3,
"effective": "2023-08-23T15:09:33Z"
},
{
"name": "genesis - 1s: before the profile",
"requested": "2023-08-23T15:09:26Z",
"error": "ERR_DATEKEY_INVALID"
},
{
"name": "round 1000 boundary exactly",
"requested": "2023-08-23T15:59:24Z",
"round": 1000,
"effective": "2023-08-23T15:59:24Z"
},
{
"name": "one second before the round 1000 boundary",
"requested": "2023-08-23T15:59:23Z",
"round": 1000,
"effective": "2023-08-23T15:59:24Z"
},
{
"name": "one second after the round 1000 boundary",
"requested": "2023-08-23T15:59:25Z",
"round": 1001,
"effective": "2023-08-23T15:59:27Z"
},
{
"name": "1ns after the round 1000 boundary",
"requested": "2023-08-23T15:59:24.000000001Z",
"round": 1001,
"effective": "2023-08-23T15:59:27Z"
},
{
"name": "half a second after the round 1000 boundary",
"requested": "2023-08-23T15:59:24.5Z",
"round": 1001,
"effective": "2023-08-23T15:59:27Z"
},
{
"name": "normative vector 2030-01-01 (spec §16)",
"requested": "2030-01-01T00:00:00Z",
"round": 66884212,
"effective": "2030-01-01T00:00:00Z"
},
{
"name": "1ns after 2030-01-01",
"requested": "2030-01-01T00:00:00.000000001Z",
"round": 66884213,
"effective": "2030-01-01T00:00:03Z"
},
{
"name": "normative vector round 66432123 (spec §16)",
"requested": "2029-12-16T07:15:33Z",
"round": 66432123,
"effective": "2029-12-16T07:15:33Z"
},
{
"name": "offset timezone equals UTC instant",
"requested": "2026-10-22T19:00:00.001+02:00",
"round": 33295013,
"effective": "2026-10-22T17:00:03Z"
},
{
"name": "last representable round time",
"requested": "9999-12-31T23:59:57Z",
"round": 83903165811,
"effective": "9999-12-31T23:59:57Z"
},
{
"name": "after the last representable round",
"requested": "9999-12-31T23:59:59Z",
"error": "ERR_DATEKEY_INVALID"
}
]
}

18
tsconfig.json
Unescape View File

@ -0,0 +1,18 @@
{
"compilerOptions": {
"target": "ES2022",
"lib": ["ES2024", "DOM"],
"module": "ESNext",
"moduleResolution": "Bundler",
"strict": true,
"noUncheckedIndexedAccess": true,
"exactOptionalPropertyTypes": true,
"noImplicitOverride": true,
"noFallthroughCasesInSwitch": true,
"verbatimModuleSyntax": true,
"isolatedModules": true,
"skipLibCheck": true,
"noEmit": true
},
"include": ["src/**/*.ts", "tests/**/*.ts"]
}
Write Preview
Loading…
Cancel
Save

Powered by TurnKey Linux.