nostr-wot-sdk
Perfiles, notas, conexiones a relays, clientes de firma, archivos y almacenamiento.
Instalación
Usa los imports mantenidos para nuevas integraciones. Declara como dependencias los paquetes que importas directamente. Añade React solo para sus puntos de entrada.
Temas
Configuración del proveedor
NostrSdkProvider combina la configuración de datos, el estado de sesión y el contexto WoT opcional. Indica myPubkey explícitamente para las consultas al Oracle; iniciar sesión no configura automáticamente la raíz de consulta WoT.
Capa de datos
Las funciones independientes obtienen perfiles, notas, hilos, seguimientos e interacciones. Los hooks de React añaden una caché que devuelve datos almacenados mientras los revalida. Las funciones de datos comparten su propio grupo de conexiones.
Gestión de relés
RelayPool envuelve un transporte PoolLike compatible proporcionado por tu aplicación. Configura urls, utiliza subscribe con onEvent/onEose y cierra las suscripciones al terminar. Un envoltorio de relés creado por separado no se conecta automáticamente al proveedor de datos.
Firmar con una extensión o cuenta remota
Usa nostr-wot-sdk/signers para obtener identidad y firmas. Nip07Signer utiliza la extensión instalada; Nip46Signer conecta un firmante remoto. Conserva un firmante por sesión y pásalo a las demás herramientas del SDK.
Subir archivos con Blossom
Usa nostr-wot-sdk/blossom para subir un archivo elegido por el usuario a un servidor seleccionado explícitamente. La herramienta firma la autorización y devuelve URL, hash y tamaño validados. Usa esa URL en un perfil o nota firmado por separado.
Adaptadores de almacenamiento
Implementa KeyValueStore, separa espacios de nombres y elige almacenamiento persistente.
Caché de datos y colecciones
Actualiza perfiles en caché, invalida estado y usa colecciones de eventos.
Hooks de datos para React
Lee datos en vivo y comparte el firmante mediante el contexto React.
Conexiones compartidas a relays
Reutiliza conexiones con RelayHub y controla las suscripciones.
Consultas y estado de relays
Agrupa consultas, revisa el estado de los relays y libera suscripciones.
Archivos cifrados y gestión de blobs
Sube archivos cifrados, cancela tareas, replica y elimina blobs.