Preguntas frecuentes

Respuestas cortas sobre Qanum. El whitepaper y la documentación tienen los detalles.

Qué es Qanum

¿Qué es Qanum?

Qanum es una base monetaria de capa 1 poscuántica: un libro de UTXO protegido por prueba de trabajo, con siete plantillas de gasto nativas y firmas poscuánticas desde el bloque génesis. Su implementación de referencia, qanum-core, es un nodo completo en Rust (qanumd y qanum-cli) publicado con licencia MIT o Apache-2.0.

¿Cuál es el tiempo de bloque y la política monetaria?

El tiempo objetivo de bloque es de 75 segundos. La recompensa empieza en 8 QAN por bloque y baja un 10 % en cada época anual (420.480 bloques) hasta una cola permanente de 0,2 QAN por bloque. No hay límite máximo: al llegar a la cola (época 36) habrá unos 32,9 millones de QAN, y desde entonces la cola añade unos 84.096 QAN al año. 1 QAN = 100.000.000 jomas.

¿Qanum tiene contratos inteligentes?

No tiene una máquina virtual de propósito general. La capa base tiene siete plantillas de gasto nativas: clave única, clave principal con recuperación diferida, multifirma (hasta 16 claves), HTLC, bóveda, bóveda pendiente y quema. El escalado, la privacidad avanzada y la ejecución compleja corresponden a capas superiores.

¿Cómo ayuda Qanum a custodiar tus propias monedas?

Las herramientas de autocustodia forman parte de las reglas de consenso, no son convenciones de cada monedero: bóvedas con un retraso en la clave de uso diario y recuperación inmediata con la clave en frío, claves principales con una vía de recuperación diferida y multifirma (hasta 16 claves) en la que cada firmante firma sin conexión en su propio equipo.

Seguridad

¿Qué firmas poscuánticas usa Qanum?

Nivel 5 del NIST desde el génesis de la testnet: ML-DSA-87 (FIPS 204) para firmar y SLH-DSA-SHAKE-256s (FIPS 205) para la recuperación en frío, ambas verificadas con liboqs. Al arrancar, el nodo comprueba cada algoritmo de firma con vectores de prueba conocidos y no arranca si alguno falla.

¿La red entre nodos también es poscuántica?

Sí. Cada conexión entre nodos usa un saludo Noise híbrido (X25519 + ML-KEM-1024, ChaCha20-Poly1305) autenticado con una identidad de nodo ML-DSA-87, fijada en la primera conexión. No hay tráfico P2P sin cifrar en ninguna red.

¿La prueba de trabajo de Qanum resiste a los ordenadores cuánticos?

No, y ninguna prueba de trabajo lo hace, sea cual sea la función hash. El algoritmo de Grover acelera de forma cuadrática la búsqueda del nonce, igual con SHA3-256 que con SHA-256. Las firmas poscuánticas protegen el gasto, no la minería. El ajuste de dificultad ASERT, bloque a bloque, absorbe en horas los saltos de potencia; el whitepaper (sección 9.9) explica los límites.

¿Cómo protejo y hago copia de seguridad de mi monedero?

Cífralo con encryptwallet <contraseña> (Argon2id) y haz copias con backupwallet <destino>. Guarda las copias en un soporte cifrado, nunca en un equipo compartido o conectado a la red, y prueba a restaurarlas en regtest antes de confiar en ellas. La guía de usuario (en inglés) tiene los detalles.

¿Qanum está auditado?

Todavía no. Las revisiones previas a la publicación son internas, no auditorías independientes. Una auditoría de seguridad externa es condición para la mainnet; la hoja de ruta indica su estado.

¿Cómo informo de una vulnerabilidad?

Escribe a security@qanum.org, cifrado con la clave PGP 8013 E1BF F91C A30E E6A5 F273 01D9 6226 80BA FCA9 si puedes. Por favor, no abras una incidencia pública antes de que se publique la corrección. Los detalles están en la política de seguridad (en inglés).

Nodos y almacenamiento

¿Cómo monto un nodo?

qanum-core se distribuye como código fuente y se compila con Cargo en plataformas de 64 bits (x86_64 y aarch64); no hay binarios precompilados. En la página de descarga tienes los requisitos, los pasos de compilación y cómo verificar una versión.

¿Un móvil puede ejecutar un nodo completo?

Sí. La biblioteca qanum-embed ejecuta un nodo completo de Qanum dentro de una aplicación móvil: se arranca con una sola llamada, se detiene en alrededor de un segundo y sincroniza, mina y gestiona monederos. Con el arranque opcional desde una instantánea, un móvil llega a la punta de la cadena en segundos por la misma vía verificada que qanumd.

¿Hay clientes ligeros?

Un nodo puede generar filtros compactos de bloques (-blockfilterindex=1, desactivado por defecto) y servirlos a monederos ligeros, que así encuentran sus transacciones sin descargar todos los bloques. Los filtros también funcionan en nodos con poda.

¿Un nodo nuevo puede sincronizar sin descargar todo el historial?

Sí. Un nodo nuevo puede arrancar desde una instantánea (snapshot) del conjunto de UTXO que le sirven otros nodos (-snapshotibd=1) y después sincronizar solo los bloques posteriores. La instantánea se verifica, no se confía en ella: incluye la cadena completa de cabeceras y el nodo recalcula el compromiso con el conjunto de UTXO (utxo_root) que registra cada cabecera de bloque. Antes de instalarla, su último bloque debe alcanzar el trabajo mínimo de cadena de la red y un nodo independiente debe confirmarlo. Los bloques antiguos pueden descargarse en segundo plano (-backfillbodies=1) y, si alguna comprobación falla, el nodo vuelve solo a la sincronización completa.

¿Puedo tener un nodo con poco espacio en disco?

Sí. Con -prune=1 el nodo guarda completos solo los bloques más recientes (2.000 por defecto, unas 42 horas; mínimo 288) y borra los bloques antiguos y sus datos de deshacer. Sigue validando cada bloque y conserva el conjunto completo de UTXO, así que los saldos siguen completos; las cabeceras de bloque ocupan unos 127 MB al año. El historial del monedero solo cubre los bloques que siguen en disco. Otro modo, -auth-prune-depth, borra solo las firmas antiguas y conserva los bloques, los datos de deshacer y los índices.

¿Qué diferencia hay entre una instantánea (snapshot) y la poda (prune)?

Resuelven problemas distintos. La instantánea decide cómo arranca un nodo nuevo: en lugar de descargar y comprobar primero todos los bloques pasados, instala una copia verificada del conjunto de UTXO y sincroniza desde ahí. La poda decide qué guarda el nodo en disco después: borra los bloques antiguos y conserva solo los más recientes. Una ahorra tiempo al empezar; la otra ahorra espacio en disco mientras el nodo funcione.

¿Puedo combinar instantánea y poda?

Sí. Arranca un nodo nuevo con -snapshotibd=1 -prune=1: empieza desde una instantánea verificada y después guarda solo los bloques más recientes. Es la forma más ligera de tener un nodo que sigue validando cada bloque nuevo. A cambio, no puede dar bloques antiguos ni instantáneas a otros nodos; eso lo hacen los nodos de archivo.

¿Qué configuración conviene a mi dispositivo?

Móvil: una aplicación con la biblioteca qanum-embed y el arranque desde instantánea, la opción recomendada para aplicaciones móviles; en testnet se instaló una instantánea de unos 12 MB en unos 25 segundos. La poda es opcional. Raspberry Pi u ordenador pequeño de casa: qanumd con -prune=1, un sistema operativo de 64 bits y un disco SSD mejor que una tarjeta SD; la Raspberry Pi 4 es la placa de referencia verificada. Ordenador o servidor que ayuda a la red: sin poda, para poder servir el historial completo e instantáneas a los nodos nuevos. Explorador o servicio que consulta transacciones: sin -prune y con -txindex; -auth-prune-depth ahorra espacio y conserva los índices.

¿Un nodo que arranca desde una instantánea es tan seguro como uno que sincroniza desde el principio?

Desde la instantánea en adelante comprueba cada bloque exactamente igual que cualquier otro nodo. Para el historial anterior no vuelve a ejecutar las transacciones antiguas: comprueba que el conjunto de UTXO coincide con el compromiso registrado en una cabecera de bloque respaldada por prueba de trabajo, que la cadena alcanza el trabajo mínimo de la red y que un nodo independiente lo confirma. Hay un límite propio de cualquier instantánea: el nodo no puede reorganizar la cadena por debajo de la altura de la instantánea. Si la red siguiera alguna vez una bifurcación así, el nodo lo avisa en su registro y hay que volver a sincronizarlo.

¿Un nodo con poda o arrancado desde una instantánea ayuda a la red?

Sí. Valida y retransmite bloques y transacciones nuevos como cualquier nodo. Lo que no puede hacer es dar bloques antiguos o instantáneas a nodos nuevos, así que se anuncia solo como nodo normal de la red. Los nodos con todo el historial en disco se anuncian como nodos de archivo y sirven ambas cosas.

¿Puedo volver a convertir un nodo con poda en un nodo completo?

No sobre el mismo directorio: los bloques borrados no vuelven y un directorio con poda no se puede reindexar desde el disco. Para volver a tener el historial completo, sincroniza un directorio nuevo sin -prune.

¿Puedo usar un índice de transacciones en un nodo con poda?

No. -prune no se puede combinar con -txindex ni con -addressindex, y el nodo no arranca si lo intentas. Si necesitas los índices con menos disco, usa -auth-prune-depth, que borra solo las firmas antiguas y conserva los índices. Los filtros compactos de bloques (-blockfilterindex=1) funcionan con los dos modos.

Testnet

¿Qanum está en marcha? ¿Hay mainnet?

Qanum funciona en una testnet pública desde la versión v0.9.0 (17 de octubre de 2026). No existe génesis de mainnet: la mainnet solo se lanzará después de una auditoría de seguridad externa. Las monedas de testnet (tQAN) no tienen valor.

¿Cómo consigo monedas de testnet?

Usa el faucet con una dirección de testnet (empieza por tqn1). Puedes seguir las transacciones y los bloques en el explorador de testnet.

¿Puedo minar en la testnet?

Sí. qanumd incluye un minero por CPU: arráncalo con qanumd -testnet -gen=1 --reward-address=tqn1... (una dirección obtenida con getnewaddress), o actívalo y desactívalo con qanum-cli -testnet setgenerate 1 y setgenerate 0. Los mineros externos pueden usar getblocktemplate y submitblock. Las monedas de testnet no tienen valor.