quasar-svm\n\n In-process Solana execution for Rust, Node.js, and Python.\n
\n\n## Overview\n\nQuasarSVM is a lightweight Solana virtual machine that executes transactions locally without an RPC connection or validator. Provide program ELFs, account state, and instructions — get back logs, compute units, return data, byte-level account diffs, and resulting accounts.\n\n`Account` is the universal account type across all layers.\n\n```toml\n[dependencies]\nquasar-svm = \"0.1\"\n```\n\n```bash\nnpm install @blueshift-gg/quasar-svm\n```\n\n```bash\npip install quasar-svm\n```\n\n## Quick Start\n\n### Rust\n\n```rust\nuse quasar_svm::{QuasarSvm, Pubkey, SPL_TOKEN_PROGRAM_ID};\nuse quasar_svm::token::*;\nuse spl_token::state::Account as SplTokenAccount;\nuse solana_program_pack::Pack;\n\nlet authority = Pubkey::new_unique();\n\nlet mint = create_keyed_mint_account(&Pubkey::new_unique(), &Mint { decimals: 6, supply: 10_000, ..Default::default() });\nlet alice = create_keyed_associated_token_account(&authority, &mint.address, 5_000);\nlet bob = create_keyed_associated_token_account(&Pubkey::new_unique(), &mint.address, 0);\n\nlet ix = spl_token::instruction::transfer(\n &SPL_TOKEN_PROGRAM_ID,\n &alice.address,\n &bob.address,\n &authority,\n &[],\n 1_000,\n).unwrap();\n\nlet mut svm = QuasarSvm::new(); // Token program loaded by default\n\nlet result = svm.process_instruction(&ix, &[mint, alice, bob]);\n\nresult.assert_success();\n\n// Verify by unpacking account data\nlet bob_account = result.account(&bob.address).unwrap();\nlet bob_token = SplTokenAccount::unpack(&bob_account.data).unwrap();\nassert_eq!(bob_token.amount, 1_000);\n```\n\n### TypeScript (web3.js)\n\n```ts\nimport { QuasarSvm, createKeyedMintAccount, createKeyedAssociatedTokenAccount } from \"@blueshift-gg/quasar-svm/web3.js\";\nimport { Address } from \"@solana/web3.js\";\nimport { getTransferInstruction } from \"@solana/spl-token\";\nimport { getTokenDecoder } from \"@solana-program/token\";\n\nconst vm = new QuasarSvm(); // Token program loaded by default\n\nconst authority = new Address(\"11111111111111111111111111111112\"); // Example address\nconst recipient = new Address(\"11111111111111111111111111111113\");\n\nconst mint = createKeyedMintAccount(new Address(\"TokenMint111111111111111111111111111\"), { decimals: 6, supply: 10_000n });\nconst alice = createKeyedAssociatedTokenAccount(authority, mint.accountId, 5_000n);\nconst bob = createKeyedAssociatedTokenAccount(recipient, mint.accountId, 0n);\n\nconst ix = getTransferInstruction({\n source: alice.accountId,\n destination: bob.accountId,\n owner: authority,\n amount: 1_000n,\n});\n\nconst result = vm.processInstruction(ix, [mint, alice, bob]);\n\nresult.assertSuccess();\nconsole.log(result.account(bob.accountId, getTokenDecoder())?.amount); // 1000n\n```\n\n### TypeScript (kit)\n\n```ts\nimport { QuasarSvm, createKeyedMintAccount, createKeyedAssociatedTokenAccount } from \"@blueshift-gg/quasar-svm/kit\";\nimport { address } from \"@solana/addresses\";\nimport { getTransferInstruction, getTokenDecoder } from \"@solana-program/token\";\n\nconst vm = new QuasarSvm(); // Token program loaded by default\n\nconst authority = address(\"11111111111111111111111111111112\"); // Example address\nconst recipient = address(\"11111111111111111111111111111113\");\n\nconst mint = createKeyedMintAccount(address(\"TokenMint111111111111111111111111111\"), { decimals: 6, supply: 10_000n });\nconst alice = await createKeyedAssociatedTokenAccount(authority, mint.address, 5_000n);\nconst bob = await createKeyedAssociatedTokenAccount(recipient, mint.address, 0n);\n\nconst ix = getTransferInstruction({\n source: alice.address,\n destination: bob.address,\n owner: authority,\n amount: 1_000n,\n});\n\nconst result = vm.processInstruction(ix, [mint, alice, bob]);\n\nresult.assertSuccess();\nconsole.log(result.account(bob.address, getTokenDecoder())?.amount); // 1000n\n```\n\n### Python\n\n```python\nfrom quasar_svm import QuasarSvm, create_keyed_mint_account, create_keyed_associated_token_account\nfrom solders.pubkey import Pubkey\nfrom spl.token.instructions import transfer, TransferParams\n\n# Token program loaded by default\nwith QuasarSvm() as svm:\n authority = Pubkey.new_unique()\n recipient = Pubkey.new_unique()\n\n # Create mint and token accounts\n mint = create_keyed_mint_account(\n Pubkey.new_unique(),\n mint_authority=authority,\n decimals=6,\n supply=10_000,\n )\n alice = create_keyed_associated_token_account(authority, mint.address, 5_000)\n bob = create_keyed_associated_token_account(recipient, mint.address, 0)\n\n # Transfer tokens\n ix = transfer(\n TransferParams(\n program_id=mint.owner,\n source=alice.address,\n dest=bob.address,\n owner=authority,\n amount=1_000,\n )\n )\n\n result = svm.process_instruction(ix, [mint, alice, bob])\n result.assert_success()\n\n # Verify transfer\n bob_account = result.account(bob.address)\n print(f\"Bob's balance: {bob_account.data[64:72]}\") # Token amount at offset 64\n```\n\n> **TypeScript:** Native memory is freed automatically by the GC. For deterministic cleanup in tight loops, use `using vm = new QuasarSvm()` or call `vm.free()`.\n>\n> **Python:** Use context manager (`with QuasarSvm() as svm:`) for automatic cleanup.\n\n## Documentation\n\n| Layer | README | Description |\n|-------|--------|-------------|\n| **Rust** | [svm/README.md](svm/README.md) | Core SVM engine: `QuasarSvm`, `ExecutionResult`, `Account`, token helpers |\n| **Python** | [bindings/python/README.md](bindings/python/README.md) | Python API using `solders` types (`Pubkey`, `Instruction`, `AccountMeta`) |\n| **web3.js** | [bindings/node/src/web3.js/README.md](bindings/node/src/web3.js/README.md) | TypeScript API using `@solana/web3.js` types (`PublicKey`, `KeyedAccountInfo`) |\n| **kit** | [bindings/node/src/kit/README.md](bindings/node/src/kit/README.md) | TypeScript API using `@solana/kit` types (`Address`, `Account