salvium-rs

Rust implementation of Salvium cryptocurrency tooling — wallet management, transaction construction, blockchain consensus, cryptographic operations, mining, and multisig support.

Workspace Crates

Crate	Description
salvium-crypto	Core cryptographic primitives: Ed25519/Curve25519, CLSAG/TCLSAG signatures, Bulletproofs+ range proofs, key images, CryptoNote + CARROT output scanning, SQLCipher wallet storage, WASM compilation target
salvium-types	Shared types: network IDs, address prefixes, consensus constants, hardfork table, fee calculation, transaction types
salvium-consensus	Blockchain consensus: chain state, difficulty, block weight limits, alternative chain management, miner TX creation, block/transaction validation
salvium-wallet	Wallet functionality: key derivation, mnemonic seeds (12 languages), address generation (18 types), sync engine, encrypted storage (AES-256-GCM + Argon2id), UTXO selection, stake lifecycle tracking, subaddress generation
salvium-tx	Transaction construction: builder, signing, decoy selection, fee estimation, offline signing (cold wallet support), serialization
salvium-rpc	Async RPC clients for Salvium daemon (block/tx/output queries, submission) and wallet service
salvium-miner	RandomX proof-of-work mining: large pages, pipelined hashing, Blake2 generator, difficulty checking
salvium-multisig	M-of-N multisig: key exchange protocol (KEX), partial signatures, transaction sets, CARROT-aware multisig accounts and addresses
salvium-cli	Command-line wallet: create/restore, sync, transfer, stake, balance, history, status

Building

cargo build --workspace
cargo build --workspace --release

Testing

# Run all 703 unit + integration tests
cargo test --workspace

# Run tests for a specific crate
cargo test -p salvium-crypto
cargo test -p salvium-wallet
cargo test -p salvium-consensus

# Run testnet integration tests (requires live daemon)
# Default daemon: http://node12.whiskymine.io:29081
cargo test --workspace -- --ignored --nocapture

# Specific testnet tests
cargo test -p salvium-wallet --test testnet_transfer -- --ignored --nocapture
cargo test -p salvium-wallet --test testnet_stake -- --ignored --nocapture
cargo test -p salvium-wallet --test testnet_burn -- --ignored --nocapture
cargo test -p salvium-rpc --test testnet -- --ignored --nocapture

Testnet Environment

Testnet integration tests use:

Variable	Default	Description
TESTNET_DAEMON_URL	http://node12.whiskymine.io:29081	Testnet daemon RPC endpoint

Wallet files expected at ~/testnet-wallet/:

• wallet-a.json + wallet-a.pin (sender)
• wallet-b.json + wallet-b.pin (receiver)

Legacy JS integration tests (burn-in, stress, full hardfork validation) remain in test/legacy-js/ and can be run with bun.

CLI Usage

# Build the CLI
cargo build -p salvium-cli --release

# Testnet operations
salvium-cli --network testnet sync
salvium-cli --network testnet balance
salvium-cli --network testnet transfer --address SaLvT... --amount 1.0
salvium-cli --network testnet stake --amount 100.0
salvium-cli --network testnet history
salvium-cli --network testnet stakes
salvium-cli --network testnet status

# Custom daemon
salvium-cli --network testnet --daemon http://127.0.0.1:29081 sync

Default Daemon Ports

Network	RPC Port
Mainnet	19081
Testnet	29081
Stagenet	39081

Address Types

Network	Format	Standard	Integrated	Subaddress
Mainnet	Legacy	SaLv...	SaLvi...	SaLvs...
Mainnet	CARROT	SC1...	SC1i...	SC1s...
Testnet	Legacy	SaLvT...	SaLvTi...	SaLvTs...
Testnet	CARROT	SC1T...	SC1Ti...	SC1Ts...
Stagenet	Legacy	SaLvS...	SaLvSi...	SaLvSs...
Stagenet	CARROT	SC1S...	SC1Si...	SC1Ss...

Key Constants

Parameter	Mainnet	Testnet
Ring size	16	16
Stake lock period	21,600 blocks	20 blocks
Coinbase lock	60 blocks	60 blocks
Block target time	120 seconds	120 seconds
Full reward zone (v5)	300,000 bytes	300,000 bytes

WASM Support

The salvium-crypto crate compiles to wasm32-unknown-unknown for browser/JS integration:

cd crates/salvium-crypto
RUSTFLAGS="-Ctarget-feature=+simd128" \
  wasm-pack build --target web --out-dir ../../src/crypto/wasm

CI/CD

• CI (push/PR to main): formatting, clippy, workspace compile, WASM target check, per-crate test matrix, doc tests
• Release (on v* tags): pre-release tests, cross-platform miner binaries (Linux x86_64/aarch64, macOS x86_64/aarch64, Windows x86_64), WASM artifacts, GitHub Release with checksums

Contributing

Contributions welcome. Reference implementation: https://github.com/salvium/salvium

License

Apache 2.0 + Commercial