docs(README): update installation instructions and add usage examples

Author: Akagi201

README.md

@@ -11,17 +11,35 @@
 
 `hpsvm` is a fast and lightweight library for testing Solana programs. It works by creating an in-process Solana VM optimized for program developers. This makes it much faster to run and compile than alternatives like `solana-program-test` and `solana-test-validator`. In a further break from tradition, it has an ergonomic API with sane defaults and extensive configurability for those who want it.
 
-This is a pure Rust library with no Node.js dependencies.
+This is a pure Rust library, making it ideal for Rust-native Solana development workflows.
+
+## ✨ Features
+
+- 🚀 **High Performance**: In-process VM runs tests significantly faster than external validators
+- 🛠️ **Easy to Use**: Simple API with sensible defaults and comprehensive configuration options
+- 🔧 **Pure Rust**: No external dependencies or runtime requirements beyond Rust
+- 📊 **Comprehensive Testing**: Supports transactions, account management, and program execution
+- 🔄 **Configurable**: Extensive options for customizing the test environment
+- 📚 **Well Documented**: Full API documentation and examples
 
 ## 🚀 Getting Started
 
+### Prerequisites
+
+- Rust
+- Solana CLI (for building test programs)
+
 ### 🔧 Installation
 
+Add `hpsvm` as a development dependency to your Solana program project:
+
 ```sh
 cargo add --dev hpsvm
 ```
 
-### 🤖 Minimal Example
+### 🤖 Quick Example
+
+Here's a minimal example that demonstrates creating a test environment, airdropping SOL, and executing a transfer transaction:
 
 ```rust
 use hpsvm::HPSVM;
@@ -32,33 +50,83 @@ use solana_signer::Signer;
 use solana_system_interface::instruction::transfer;
 use solana_transaction::Transaction;
 
+// Create keypairs for testing
 let from_keypair = Keypair::new();
 let from = from_keypair.pubkey();
 let to = Address::new_unique();
 
+// Initialize the SVM with default configuration
 let mut svm = HPSVM::new();
+
+// Airdrop SOL to the sender account
 svm.airdrop(&from, 10_000).unwrap();
 
+// Create a transfer instruction
 let instruction = transfer(&from, &to, 64);
+
+// Build and sign the transaction
 let tx = Transaction::new(
     &[&from_keypair],
     Message::new(&[instruction], Some(&from)),
     svm.latest_blockhash(),
 );
-let tx_res = svm.send_transaction(tx).unwrap();
 
-let from_account = svm.get_account(&from);
-let to_account = svm.get_account(&to);
-assert_eq!(from_account.unwrap().lamports, 4936);
-assert_eq!(to_account.unwrap().lamports, 64);
+// Execute the transaction
+let tx_result = svm.send_transaction(tx).unwrap();
+
+// Verify the results
+let from_account = svm.get_account(&from).unwrap();
+let to_account = svm.get_account(&to).unwrap();
+assert_eq!(from_account.lamports, 4936);  // 10000 - 64 - fee
+assert_eq!(to_account.lamports, 64);
 ```
 
-### 🛠️ Developing hpsvm
+### 📖 Usage
+
+For more advanced usage, including custom configurations, program deployment, and complex transaction scenarios, see the [full documentation](https://docs.rs/hpsvm).
+
+## 🛠️ Developing hpsvm
 
-#### Run the tests
+### Building Test Programs
+
+The test suite uses Solana programs that need to be built first:
+
+```bash
+cd crates/hpsvm/test_programs
+cargo build-sbf
+```
 
-The tests in this repo use some test programs you need to build first (Solana CLI >= 1.18.8 required):
+### Running Tests
+
+Run the full test suite:
+
+```bash
+cargo test
+```
+
+### Running Benchmarks
+
+```bash
+cargo bench
+```
+
+### Code Quality
+
+Format code:
+
+```bash
+cargo fmt
+```
+
+Lint code:
+
+```bash
+cargo clippy
+```
 
-```cd crates/hpsvm/test_programs && cargo build-sbf```
+## 🙏 Acknowledgments
 
-Then just run `cargo test`.
+- Initially forked from [litesvm](https://github.com/LiteSVM/litesvm)
+- Built for the Solana ecosystem
+- Inspired by the need for faster, more ergonomic testing tools
+- Thanks to the Solana community for their contributions and feedback