DocsWallet Guide
Post-Quantum Secure

FractalAI Wallet Guide

Create, manage, and secure your FRAC wallet. All wallets use post-quantum cryptography (CRYSTALS-Dilithium2) for future-proof security.

Wallet Options

FractalAI Web Wallet

Available at the FractalAI dashboard. Creates wallet in your browser with encrypted localStorage storage.

No installation
Password-protected
Export keyfile
Open Web Wallet

App Wallets

FincAI, KpitApp, and EngagedNet each have built-in wallet creation. Create a wallet when you sign up for any app.

Integrated in each app
Same address everywhere
Earn app tokens

CLI Wallet

For developers and miners. Generate keys from the command line and use them with the node binary.

Full control
Scriptable
For mining coinbase

Create a Web Wallet (Step by Step)

1
Go to the Wallet Page

Navigate to /wallet in the FractalAI dashboard. You can also access it from any page via the "Wallet" button in the top navigation.

2
Click "Create New Wallet"

Enter a strong password. This password encrypts your private key using PBKDF2 (600,000 iterations) + AES-256-GCM. The encrypted wallet is stored in your browser's localStorage.

Remember your password! There is no recovery mechanism.

3
Save Your Address & Keyfile

Your wallet address will be displayed (format: 0x + 40 hex characters). Download the keyfile JSON as a backup.

Example address:
0x7a3b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b

4
Get Testnet FRAC

Use the faucet to get free testnet FRAC tokens for testing:

Request testnet FRAC
curl -s http://159.223.197.61:9545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"fractal_faucet","params":["YOUR_ADDRESS",100],"id":1}'

Or visit the Faucet page for a web-based interface.

Security Architecture

Encryption Stack

Key Derivation
PBKDF2 with SHA-256, 600,000 iterations
Encryption
AES-256-GCM authenticated encryption
Signatures
CRYSTALS-Dilithium2 (post-quantum, NIST standard)
Key Exchange
CRYSTALS-Kyber768 (post-quantum KEM)

Key Sizes

Dilithium Public Key1,312 bytes
Dilithium Signature2,420 bytes
Kyber768 Ciphertext1,088 bytes
Address20 bytes (0x + 40 hex)

Send a Transaction

Send FRAC to another address via the web wallet or JSON-RPC:

Send FRAC via RPC
curl -s http://159.223.197.61:9545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": [{
      "from": "0xYOUR_ADDRESS",
      "to": "0xRECIPIENT_ADDRESS",
      "value": "1000000000000000000",
      "nonce": 0,
      "gas_limit": 21000,
      "gas_price": 1000000000,
      "signature": "SIGNED_HEX",
      "public_key": "YOUR_PUBKEY_HEX"
    }],
    "id": 1
  }'

Value is in wei (10^18 wei = 1 FRAC). Gas price is in wei per gas unit. Standard transfer costs 21,000 gas.

Import & Export

Export Keyfile

From the wallet page, click "Export Keyfile" to download a JSON file containing your encrypted private key. This file can be imported on another browser or device.

{ "address": "0x7a3b...", "publicKey": "a1b2c3...", "encrypted": "encrypted_hex...", "salt": "random_salt_hex", "iv": "random_iv_hex" }

Import Keyfile

On the wallet page, click "Import Wallet" and select your keyfile JSON. Enter your password to decrypt and access the wallet.

The same password used during creation is required to import.
Getting StartedNode Setup