BTC-VM - Minimal Bitcoin Script VM

A simple, stack-based Bitcoin Script interpreter written in x86-64 Assembly. This is a basic implementation for learning and experimentation.

Project Structure

btc-vm/
├── README.md           # Basic project overview
├── btc_vm.asm          # Main assembly code for the VM
├── scripts/
│   ├── simple_test.hex # Simple test script for validation
│   └── sample_scripts/ # Directory for more example scripts
├── tests/
│   └── test_runner.sh  # Simple test runner script
├── docs/
│   └── ARCHITECTURE.md # Notes about the VM architecture
└── LICENSE             # MIT License file

Getting Started

Build the VM

nasm -f elf64 btc_vm.asm -o btc_vm.o
ld btc_vm.o -o btc_vm

Run the VM

./btc_vm

Test the VM

bash tests/test_runner.sh

File Descriptions

btc_vm.asm

Main assembly code for the Bitcoin Script VM. This is where the interpreter logic lives.

simple_test.hex

A very basic test script to verify the VM is working.