Instalación del Wallet
Requisitos de Hardware
Para ejecutar Zikuani, asegúrese de que su sistema cumpla al menos con los siguientes requisitos:
Componente | Especificación |
---|---|
CPU | 2 Núcleos + 2 Hilos por Núcleo |
RAM | 16 GB |
Instalación
Windows
Descargue el instalador:
Instalador de WindowsVerifique el hash sha256:
certutil -hashfile "C:\file\path\zikuani-0.8.1.exe" SHA256
El resultado debe coincidir con:
20feed43e22531a87e06cfbc35cbb69b346a251ed1c2c8127e260b29577f68f1 zikuani-0.8.1.exe
Ejecute el instalador si el hash coincide.
Nota: El instalador de Windows incluye un par de dependencias de Javascript, Nodejs y Snarkjs. También incluye el zkey necesario para generar pruebas ZK válidas, lo que lo hace un poco pesado.
Inicie el programa:
- Inserte su tarjeta inteligente en un puerto USB.
- Ejecute:
"C:\Program Files\zk-firma-digital\zk-firma-digital.exe"
- O bien, busque zk-firma-digital en el menú Inicio.
Linux (Debian)
- Descargue el instalador:
wget https://app.sakundi.io:9090/zikuani_0.8.1_amd64.deb
- Verifique el hash sha256:El resultado debe coincidir con:
sha256sum zikuani_0.8.1_amd64.deb
b02232886d0d130ff19d82f2bc6e58471f412a30671cacd28663f1f25c3e9217 zikuani_0.8.1_amd64.deb
- Instale el paquete Debian:
sudo dpkg -i zikuani_0.8.1_amd64.deb
- Inicie el programa:
- Inserte su tarjeta inteligente en un puerto USB.
- Ejecute:
/usr/share/zk-firma-digital/zk-firma-digital.bin
- O bien, busque la aplicación en su lanzador de aplicaciones.
MacOS
Descargue el instalador:
Instalador de MacOSVerifique el hash sha256:
sha256sum zikuani-0.8.1.pkg
El resultado debe coincidir con:
d35bf1dc5a176adcfb521a2ff6007a83a4908ae76a55c59b3ae279f41232962b zikuani-0.8.1.pkg
Ejecute el instalador si el hash coincide.
Nota: El instalador de MacOS incluye un par de dependencias de Javascript, Nodejs y Snarkjs. También incluye el zkey necesario para generar pruebas ZK válidas, lo que lo hace un poco pesado.
Inicie el programa:
- Inserte su tarjeta inteligente en un puerto USB.
- Ejecute:
"open /Applications/zk-firma-digital/Contents/MacOS/zk-firma-digital"
- O bien, busque zk-firma-digital en el menú Finder.
Compilación
Linux
- Clone el repositorio:
git clone https://github.com/kuronosec/Zikuani
cd Zikuani - Ejecute el script de compilación:
./builder/build_linux.sh
Windows
Instale los prerrequisitos:
- Git for Windows
- Python 3.10+
- Instale PyInstaller:
pip install pyinstaller
- Inno Setup
- Configure su antivirus para excluir los directorios de compilación y release.
Clone el repositorio:
git clone https://github.com/kuronosec/Zikuani.git
cd ZikuaniEjecute el script de compilación:
./builder/build_windows.sh
Ubique los archivos generados:
- Ejecutable: directorio
build
. - Instalador: directorio
release
.
- Ejecutable: directorio
Solución de problemas:
- Antivirus o problemas de seguridad: durante la compilación, su antivirus (incluido Windows Defender) puede marcar el
.exe
generado como amenaza. Esto es común con ejecutables autogenerados. Para resolverlo:- Agregue exclusiones: configure su antivirus para excluir los directorios
build
yrelease
.- Para Windows Defender:
- Abra Seguridad de Windows.
- Vaya a Protección contra virus y amenazas.
- Haga clic en Administrar configuración bajo Configuración de protección contra virus y amenazas.
- Desactive temporalmente Protección en tiempo real (si es necesario).
- Vaya a Exclusiones y haga clic en Agregar o quitar exclusiones.
- Agregue las rutas de
build
yrelease
.
- Para Windows Defender:
- Valide el ejecutable: después de agregar las exclusiones, vuelva a compilar y verifique que el
.exe
se ejecute correctamente.
- Agregue exclusiones: configure su antivirus para excluir los directorios
- Herramientas faltantes o errores de comandos: si aparece
command not found
, puede deberse a herramientas faltantes o rutas mal configuradas.- Revise el script de compilación en busca de dependencias faltantes.
- Consulte la documentación o la sección de issues del repositorio.
- Antivirus o problemas de seguridad: durante la compilación, su antivirus (incluido Windows Defender) puede marcar el