Confam Wallet
A production-grade, non-custodial multi-chain CLI wallet for Ethereum and Solana built in Python.
Keys are generated directly on your machine using the operating system's cryptographic random number generator (CSPRNG), encrypted inside password-protected keystores (scrypt KDF), and every signature is produced locally in-memory. The network is only contacted for public reads (nonces, balances, blockhashes, gas estimates) and to broadcast pre-signed raw transactions. No private key material or unencrypted secrets ever leave your machine.
Supported Ecosystems
| Network | Cryptography | Native Asset | Token Standard | Default Keystore |
|---|---|---|---|---|
| Solana | Ed25519 (RFC 8032) / SHA-512 |
SOL (Lamports) | SPL Tokens (USDC, USDT, etc.) | ~/.confam/solana.json |
| Ethereum & EVM | secp256k1 / Keccak-256 |
ETH (or native gas) | ERC-20 (USDT, USDC, DAI, etc.) | ~/.confam/ethereum.json |
Key Features & Production Hardening
- Multi-Chain Architecture: Seamlessly manage both Ethereum (EVM) and Solana (Ed25519) from a single CLI.
- Zero-Friction Default Keystores: Simply run
confam solana createorconfam create—no need to type--keyfilepaths on every command! Keystores default cleanly to~/.confam/solana.jsonand~/.confam/ethereum.json. - Non-Custodial & Air-Gapped Capable: Offline transaction signing (
sign-tx) decoupled from network broadcast (broadcast-tx). - Lossless Financial Precision: Powered by Python's
Decimalarithmetic—avoids binary float truncation bugs (e.g.0.29 ETHor0.05 SOL). - Keystore Overwrite Guards: Prevents accidental wallet destruction and permanent fund loss; requires explicit
--forceto overwrite. - Cross-Platform Security Hardening: Restrictive file permissions (
0o600on POSIX and NTFS inheritance lockdown on Windows). - EIP-1559 & Legacy Gas Market: Automatic fee estimation with congestion buffer, priority fee floors, and fallback to legacy
gasPrice. - Pre-Flight Balance Validations: Checks sender balance before signing to prevent stuck or rejected transactions.
- Token Engines: Full support for ERC-20 tokens on EVM and SPL tokens on Solana.
- Transaction Receipt Polling:
--waitflag on transfers to inspect execution status, block inclusion, and confirmation. - Flexible Credential Ingestion: Pass passwords via hidden interactive prompt,
CONFAM_PASSWORDenvironment variable,--password-stdin, or--passwordCLI flag.
Installation
From PyPI (Recommended)
pip install confam-wallet
Or install globally as an isolated CLI via pipx:
pipx install confam-wallet
From Source
git clone https://github.com/Chekwube-Manuel/Comfam-Wallet.git
cd Comfam-Wallet
python -m venv .venv
# Windows:
.\.venv\Scripts\activate
# Linux / macOS:
source .venv/bin/activate
pip install -e .
Verify installation:
confam --version
# Output: confam 1.2.0
Configuration
| Environment Variable | Default Option | Description |
|---|---|---|
CONFAM_SOLANA_KEYFILE |
~/.confam/solana.json |
Default Solana keystore path |
CONFAM_KEYFILE |
~/.confam/ethereum.json |
Default Ethereum keystore path |
CONFAM_RPC_URL |
http://127.0.0.1:8545 |
Ethereum / EVM JSON-RPC endpoint |
CONFAM_SOLANA_RPC_URL |
https://api.mainnet-beta.solana.com |
Solana JSON-RPC endpoint |
CONFAM_PASSWORD |
(None) | Keystore decryption password (avoids prompts) |
You can also pass --keyfile or --rpc-url directly to any command to use custom locations.
Solana (SOL & SPL Token) CLI Reference
All Solana commands are namespaced under confam solana.
Note:
--keyfileis completely optional. If omitted, Confam automatically uses~/.confam/solana.json(or$CONFAM_SOLANA_KEYFILE).
1. Create a Solana Wallet
Generates a fresh Ed25519 keypair locally via OS CSPRNG and saves an encrypted keystore directly to ~/.confam/solana.json:
# That's it! No path needed:
confam solana create
# Or specify a custom path if you want:
confam solana create --keyfile my_wallet.json
2. Import an Existing Solana Key
Accepts Base58-encoded secret keys or standard Solana CLI JSON arrays ([1, 2, ...], Phantom / Solflare compatible):
# Saves into default ~/.confam/solana.json
confam solana import-key
# Or specify custom keyfile:
confam solana import-key --keyfile my_wallet.json --private-key "5VERv8..."
3. Show Solana Address
confam solana address
4. Check SOL Balance
# Check your default wallet balance
confam solana balance
# Or check any arbitrary Solana address
confam solana balance --address 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
5. Check Solana Cluster Status
confam solana status --rpc-url https://api.mainnet-beta.solana.com
6. Send Native SOL Transfer
confam solana send \
--keyfile .keys/sol_wallet.json \
--to 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM \
--amount "0.5 sol" \
--wait
(Amounts accept sol or lamports. Bare numbers default to sol.)
7. Query SPL Token Balance
# Query USDC balance on Solana (Mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)
confam solana token-balance \
--keyfile .keys/sol_wallet.json \
--mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
8. List All SPL Tokens in Wallet
confam solana tokens --keyfile .keys/sol_wallet.json
9. Transfer SPL Tokens
confam solana transfer-token \
--keyfile .keys/sol_wallet.json \
--source SourceTokenAccountAddress \
--to DestinationTokenAccountAddress \
--amount "25.5" \
--decimals 6 \
--wait
10. Sign & Verify Messages with Ed25519
# Sign text locally
confam solana sign-message --keyfile .keys/sol_wallet.json -m "Authenticate with Confam"
# Verify signature
confam solana verify-message \
--address 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM \
--signature Base58SignatureHex \
--message "Authenticate with Confam"
11. Export Solana Private Key
# Export in standard Base58
confam solana export-key --keyfile .keys/sol_wallet.json
# Export as Solana CLI JSON array [1,2,...]
confam solana export-key --keyfile .keys/sol_wallet.json --json
Ethereum / EVM CLI Reference
Note:
--keyfileis completely optional. If omitted, Confam automatically uses~/.confam/ethereum.json(or$CONFAM_KEYFILE).
1. Create Wallet
# Creates default wallet at ~/.confam/ethereum.json
confam create
# Or specify a custom path:
confam create --keyfile .keys/eth_wallet.json
2. Check Balance & Network Status
# Checks default wallet balance
confam balance
# Or specify address or custom keyfile:
confam balance --address 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
confam chain-info --rpc-url https://rpc.sepolia.org
confam gas-price
3. Send ETH Transfer
confam send-tx \
--to 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 \
--amount "0.05 ether" \
--wait
4. ERC-20 Tokens (USDT, USDC, DAI)
# Check balance
confam token-balance --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
# Transfer tokens
confam transfer-token \
--token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
--to 0xRecipientAddress \
--amount "50" \
--wait
5. Air-Gapped / Offline Signing
# Sign offline
confam sign-tx \
--keyfile .keys/cold.json \
--to 0xRecipient \
--amount "1.0 ether" \
--nonce 0 \
--chain-id 1 \
--max-fee 30000000000 \
--priority-fee 1500000000 > raw_tx.hex
# Broadcast online
confam broadcast-tx --raw-tx $(cat raw_tx.hex) --wait
Testing
Run the full automated test suite with pytest:
pytest -v
All 29 tests pass covering:
- Base58 encoding, decoding, and checksum verification.
- Ed25519 keypair generation, address derivation, signing, and verification.
- Solana encrypted keystore creation, unlocking, and overwrite guards.
- Lossless SOL, Lamport, and SPL token unit conversions.
- Wire transaction binary compilation and compact-u16 serialization.
- SPL token transfer instruction construction.
- Ethereum EIP-1559 and legacy transaction signing and receipt polling.
- Lossless Decimal financial arithmetic.
License
This project is licensed under the MIT License.
Metadata
Release files for confam-wallet 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| confam_wallet-1.2.0.tar.gz | 38.5 kB | Without provenance | Details for confam_wallet-1.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| confam_wallet-1.2.0-py3-none-any.whl | Python 3 | none | any | Details for confam_wallet-1.2.0-py3-none-any.whl |
Total release size: 72.3 kB
Release files / confam_wallet-1.2.0.tar.gz
| Download URL | confam_wallet-1.2.0.tar.gz |
|---|---|
| Size | 38.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1dc5f5c33b4168dfda185d02663fde4172464b775a003d19354d106c1a1ffee9
|
|
BLAKE2b-256 checksum How to use checksums |
5b9dc74afe0ba6f4b8e4e70413f2c35a75dae4fd916a51c1b82af14d8d16eb63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Release files / confam_wallet-1.2.0-py3-none-any.whl
| Download URL | confam_wallet-1.2.0-py3-none-any.whl |
|---|---|
| Size | 33.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
56db8fe6620bf41a32fb25e4ab060e39fd79625bc0326e425f262f3545a4f9c9
|
|
BLAKE2b-256 checksum How to use checksums |
d78450513f160a502d6acb3a6fc7364812a3f86427724273e147974915dda5dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.2
|
Security for confam-wallet 1.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.