IPNS: clarify serialization and the type of ValidityType, TTL and Seq fields
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 35/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Estancado
- Stack tecnológico
- go
- Área
- documentation, networking
Línea de trabajo
Comienza con las secciones de la especificación de registros IPNS sobre TTL, secuencia y validez; después, compara los antecedentes de v1 y v2 en #319 y #376 con el código referenciado de boxo/ipns record.go y go-ipld-prime. Se considera terminado cuando la especificación utiliza una terminología de enteros independiente del lenguaje y documenta claramente la representación protobuf uint64 para v1 frente a la representación DAG-CBOR int64 para v2.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
IPNS Record spec lists Validity, TTL and Seq as uint64:
- https://specs.ipfs.tech/ipns/ipns-record/#ttl-uint64
- https://specs.ipfs.tech/ipns/ipns-record/#sequence-uint64
- https://specs.ipfs.tech/ipns/ipns-record/#validity-type-uint64
..but this only applies to the protobuf fields from IPNS v1.
For wider background, documentation and cleanup of v1 vs v2 was done in #319, #376.
In IPNS v2 we store values in DAG-CBOR map in Data field, and fields like the TTL read from v2 Data field (DAG-CBOR) is represented as int64 (see boxo/ipns code).
In other words, in GO impl. time.Duration is represented as int64, and that is how "uint64" fields like TTL are stored in v2 Data field (CBOR). This is also confirmed by the way IPLD data model impl. at go-ipld-prime/node/basic works.
Solution
Ideas welcome. My initial idea is to move away from go specific.
Clarify this in the IPFS specification and mark these fields as language-agnostic integer and then add bullet points in their respective section that when represented in legacy v1, the type for protobuf is uint64, and when represented in v2 (dag-cbor) it is int64.
cc @2color as you've been working with TTL in JS recently.
- Lenguaje dominante
- HTML
- Estrellas
- 1.2k
- Forks
- 250
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de ipfs/specs
-
Simplify Spec StatusesAbiertoneed/triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
Revise steward and editor rolesAbiertoneed/triage
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
-
dnslink:// URIsAbiertoneed/triage
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
need/triage
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
Todos los issues de ipfs/specs
Issues similares
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
openclaw/openclaw#199885 · 2 comentarios · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
docs ready
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
schuyler/corvidae#999 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
proposal
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
j3ko/agent-plugins#29 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
area:docs bug good first issue priority:low
Dificultad 2/5 1-3 horas Aptitud para principiantes 80/100
rtk-ai/rtk#5126 · 1 comentario ·
Los mantenedores suelen responder en 1 día