nak 0.21.0 lee listas de relays y resuelve rutas de petnames

Un comando para las listas de relays NIP-65

55707c26 añade relays.go, un archivo de 58 líneas que registra un subcomando nuevo de primer nivel. Su cadena de uso declara el alcance: prints the nip65 relays for a given pubkey, one relay per line.

Toma una clave pública como argumento o por entrada estándar y escribe una URL de relay por línea. Dos banderas restringen la salida, cada una con un alias que nombra la otra mitad del vocabulario de NIP-65:

--inbox, --read     only print relays marked as inbox/read
--outbox, --write   only print relays marked as outbox/write

Conviene leer la lógica del filtro de forma literal, porque el caso combinado no es una unión. Pasar ambas banderas exige ambas marcas en el mismo relay:

if wantInbox && wantOutbox {
    if !(rl.Inbox && rl.Outbox) {
        continue
    }
}

Así que --inbox --outbox imprime solo los relays que sirven ambas direcciones, que bajo NIP-65 es lo que produce una etiqueta r sin marcar, mientras que no pasar ninguna imprime la lista completa. Juntas, las dos banderas estrechan el conjunto en lugar de ampliarlo, lo que importa cuando la salida alimenta un paso de publicación.

Los nombres de dirección se corresponden con los roles descritos en la guía de enrutamiento NIP-65 publicada hoy mismo: los relays de salida de un autor son de donde se obtienen sus eventos, y los relays de entrada de un destinatario son donde se entregan los eventos que lo mencionan. El comando vuelve scriptables ambos destinos sin analizar a mano un evento de kind 10002.

Rutas de petnames, en el analizador compartido

Las rutas de petnames de NIP-02 llegan en dos etapas, y la segunda corrige la primera. Es la funcionalidad añadida a NIP-02 en la revisión reportada el 20 de septiembre y restringida a ASCII en el seguimiento tres días después.

4011cba5 no añade un comando. Cambia el analizador compartido: parsePubKey recibe un segundo argumento, una clave pública desde la que resolver, y despacha cualquier valor que empiece por una virgulilla a un nuevo resolvePetnamePath.

func parsePubKey(value string, from nostr.PubKey) (nostr.PubKey, error) {
	value = strings.TrimPrefix(value, "nostr:")

	if strings.HasPrefix(value, "~") {
		return resolvePetnamePath(value, from)
	}

Ese ayudante llama a sys.ResolvePetnamePath con un tiempo límite de cinco segundos. Su comentario de documentación declara el mecanismo y da la forma mixta que NIP-02 permite: la ruta ~erin/david/frank recorre la lista de seguidos de cada nombre de la cadena, y el primer nombre puede ser en su lugar un identificador NIP-05, como en [email protected]/david/frank. Como la búsqueda de perfil subyacente oculta los errores de NIP-05, una resolución fallida se vuelve a comprobar contra nip05.QueryIdentifier, de modo que un problema de DNS o HTTP se reporta como tal y no como un petname irresoluble. El commit actualiza todos los puntos de llamada y añade 239 líneas de pruebas.

Lo que esa etapa no resuelve es desde qué clave arranca una ruta relativa. La pull request #220, fusionada el 25 de septiembre, añade petname_cli.go y un envoltorio parsePubKeyForCommand que clasifica la raíz:

absolute := hexErr == nil || nip05.IsValidIdentifier(parts[0]) ||
    (nip19Err == nil && (prefix == "npub" || prefix == "nprofile"))

Una ruta enraizada en una clave pública hexadecimal, un identificador NIP-05 válido o un npub o nprofile es absoluta, y un comentario registra por qué se separa el caso: Absolute roots must also work without access to a signing key. Solo una ruta relativa llama a gatherKeyerFromArguments y toma la clave pública de ese firmante como punto de partida. Leer hacia afuera desde alguien a quien se puede nombrar no necesita clave, mientras que una ruta que arranca de tus propios seguidos sí.

La misma pull request corrige un problema de orden de argumentos. Una llamada en init aplica deferPetnameFlags a todo el árbol de comandos y reemplaza cada bandera portadora de claves públicas por un envoltorio que guarda la cadena cruda y la resuelve solo cuando todas las banderas están analizadas. El comentario da la razón: una bandera de firmante como --sec puede aparecer después de la bandera de petname en la línea de comandos, y la resolución necesita al firmante. Añade 169 líneas más de pruebas.

Autocompletado y tres correcciones menores

5f28b21c establece EnableShellCompletion: true en el comando raíz, lo que expone nak completion bash, zsh y fish. El README gana las tres rutas de instalación para las shells cuyo paquete no lo configura.

Tres correcciones de comportamiento son estrechas, pero cada una cierra un caso en el que la herramienta hacía algo inútil en lugar de reportar un problema:

• 30551476 añade --github a nak event, y su línea de uso da el motivo: treat empty stdin as no stdin at all, as GitHub Actions always opens it. En ese entorno, una entrada estándar siempre abierta pero vacía era indistinguible de una entrada por tubería.
• nak key encrypt con un solo argumento ahora falla con no password given or key piped on stdin cuando la entrada estándar no es una tubería, en lugar de leer ese único argumento como contraseña sin clave a la que aplicarla.
• blossom quita Required: true de su bandera --server, así que el servidor puede darse por subcomando, y su ausencia produce ahora no server specified. blossom upload gana --auto, que resuelve los servidores de medios anunciados por el usuario actual. nsite download acepta un puntero nevent1 o naddr1 además de una URL de sitio, y obtiene los datos desde los relays de escritura del autor y las pistas que lleve el puntero.

Qué significa en la práctica

Ambos añadidos eliminan un paso hecho a mano para quien escriba scripts contra Nostr. Responder dónde publicar o dónde leer ya no implica obtener y analizar un evento de kind 10002, y una ruta de seguidos puede escribirse donde antes iba una cadena hexadecimal de 64 caracteres. Ninguno cambia ninguna especificación: es una herramienta poniéndose al día con NIP-02 y NIP-65 tal como ya están. La regla de la raíz absoluta es el detalle que conviene retener, porque una ruta de petname que arranca de tus propios seguidos pedirá una clave.