Wallet Installation
Hardware Requirements
To run Zikuani, ensure your system meets at least the following hardware requirements:
Component | Specification |
---|---|
CPU | 2 Cores + 2 Threads per Core |
RAM | 16 GB |
Installation
Windows
Download the installer: Windows Installer
Verify the sha256 hash:
certutil -hashfile "C:\file\path\zikuani-0.8.1.exe" SHA256
The result should match:
20feed43e22531a87e06cfbc35cbb69b346a251ed1c2c8127e260b29577f68f1 zikuani-0.8.1.exe
Run the installer if the hash matches.
Note: The Windows installer includes a couple of Javascript dependencies, Nodejs and Snarkjs. The installer also includes the zkey necessary for generating valid ZK proofs, which makes it a bit heavy.
Launch the program:
- Insert your smart card into a USB port.
- Run:
"C:\Program Files\zk-firma-digital\zk-firma-digital.exe"
- Alternatively, search for zk-firma-digital in the Start menu.
Linux (Debian)
- Download the installer:
wget https://app.sakundi.io:9090/zikuani_0.8.1_amd64.deb
- Verify the sha256 hash:The result should match:
sha256sum zikuani_0.8.1_amd64.deb
b02232886d0d130ff19d82f2bc6e58471f412a30671cacd28663f1f25c3e9217 zikuani_0.8.1_amd64.deb
- Install the Debian package:
sudo dpkg -i zikuani_0.8.1_amd64.deb
- Launch the program:
- Insert your smart card into a USB port.
- Run:
/usr/share/zk-firma-digital/zk-firma-digital.bin
- Alternatively, search for the app in your application launcher.
MacOS
Download the installer: MacOs Installer
Verify the sha256 hash:
sha256sum zikuani-0.8.1.pkg
The result should match:
d35bf1dc5a176adcfb521a2ff6007a83a4908ae76a55c59b3ae279f41232962b zikuani-0.8.1.pkg
Run the installer if the hash matches.
Note: The MacOS installer includes a couple of Javascript dependencies, Nodejs and Snarkjs. The installer also includes the zkey necessary for generating valid ZK proofs, which makes it a bit heavy.
Launch the program:
- Insert your smart card into a USB port.
- Run:
"open /Applications/zk-firma-digital/Contents/MacOS/zk-firma-digital"
- Alternatively, search for zk-firma-digital in the Finder menu.
Build
Linux
- Clone the repository:
git clone https://github.com/kuronosec/Zikuani
cd Zikuani - Run the build script:
./builder/build_linux.sh
Windows
Install the prerequisites:
- Git for Windows
- Python 3.10+
- Install PyInstaller:
pip install pyinstaller
- Inno Setup
- Configure antivirus to exclude the build and release directories.
Clone the Repository:
git clone https://github.com/kuronosec/Zikuani.git
cd ZikuaniRun the build script:
./builder/build_windows.sh
Locate the output files:
- Executable:
build
directory. - Installer:
release
directory.
- Executable:
Troubleshooting:
- Antivirus or Security Issues: During the build process, your antivirus software (including Windows Defender) may flag the generated
.exe
file as a potential threat. This is a common issue with self-built executables. To resolve it:- Add Exclusions: Configure your antivirus or security software to exclude the build and release directories.
- For Windows Defender:
- Open Windows Security.
- Navigate to Virus & threat protection.
- Click on Manage settings under Virus & threat protection settings.
- Toggle Real Time Protection off temporarily (if necessary).
- Scroll down to Exclusions and click on Add or remove exclusions.
- Add the paths for both the
build
andrelease
directories to the exclusion list.
- For Windows Defender:
- Validate the Executable: After adding exclusions, rerun the build process and verify that the executable runs without being flagged.
- Add Exclusions: Configure your antivirus or security software to exclude the build and release directories.
- Missing Tools or Command Errors: If you encounter errors like
command not found
when running the build script, it may indicate missing tools or misconfigured system paths. Follow these steps:- Review the build script for errors or missing dependencies.
- Consult the repository's issues page or documentation for additional support.
- Antivirus or Security Issues: During the build process, your antivirus software (including Windows Defender) may flag the generated