https://github.com/ffimnsr/lumos-svm-rs
A simple SVM test validator.
https://github.com/ffimnsr/lumos-svm-rs
eclipse solana svm testing-tools validator-node
Last synced: 21 days ago
JSON representation
A simple SVM test validator.
- Host: GitHub
- URL: https://github.com/ffimnsr/lumos-svm-rs
- Owner: ffimnsr
- License: other
- Created: 2025-02-03T05:12:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T09:53:43.000Z (3 months ago)
- Last Synced: 2025-03-12T10:37:41.778Z (3 months ago)
- Topics: eclipse, solana, svm, testing-tools, validator-node
- Language: Rust
- Homepage:
- Size: 52.7 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Lumos SVM 🚀
A Solana Test Validator Manager (SVM) that simplifies local development and testing of Solana programs.
## Features
- 🚀 Quick setup of local Solana test validator
- 📦 Automatic account and program state cloning
- 🔍 Token analysis and management
- 🛠 Configurable via TOML
- 🔄 Port management and validator configuration
## Installation
```bash
cargo install lumos-svm
```
## Quick Start
1. Create a configuration file (`lumos.toml`):
```toml
[general]
rpc_endpoint = "https://eclipse.lgns.net/"
ledger_dir = ".lumos-ledger" # Optional, defaults to .lumos-ledger
[account.usdc]
address = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
[program.orca_whirlpool]
address = "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc"
```
2. Start the validator:
```bash
lumos-svm start
```
## Advanced Features
### Modify Token Mint Authority
You can modify the mint authority for cloned token accounts:
```toml
[general]
rpc_endpoint = "https://eclipse.lgns.net/"
mint_authority = ""
[account.usdc]
address = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
mint = true # Set this token as mintable
update = true # Update if previously cloned
```
This configuration:
- Sets your public key as the mint authority
- Makes the USDC token mintable locally
- Updates existing cloned accounts when specified
## Commands
- `lumos-svm run`: Start the test validator
- `lumos-svm analyze
`: Analyze token or program details
- `lumos-svm clone`: Clone accounts and programs from config
## Development
```bash
# Clone the repository
git clone https://github.com/ffimnsr/lumos-svm-rs
cd lumos-svm-rs
# Build
cargo build
# Run tests
cargo test
```
## Requirements
- Rust 1.70+
- Solana CLI tools with `solana-test-validator`
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the Apache and MIT License - see the [COPYING](COPYING) file for details.