Package Exports

bvc-eth
bvc-eth/bin/bvc.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bvc-eth) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🔗 Blockchain Version Control (BVC)

A decentralized version control system inspired by Git, but powered by blockchain and IPFS.

✨ Features

🚀 Decentralized: No central server required
⛓️ Blockchain-powered: Immutable commit history on Ethereum
🌐 IPFS storage: Decentralized file storage
🔐 Cryptographically secure: SHA256 file hashing
💻 Git-like CLI: Familiar commands and workflows

📦 Installation

Global Installation (Recommended)

npm install -g bvc-eth

Local Installation

npm install bvc-eth

Manual Installation

git clone https://github.com/Lviffy/BVC.git
cd BVC
npm install
npm link  # or use: node bin/bvc.js

🚀 Quick Start

1. Configure BVC

bvc-eth config --setup

2. Create a Repository

bvc-eth init my-project
cd my-project

3. Add Files and Commit

echo "console.log('Hello BVC!');" > index.js
bvc-eth add index.js
bvc-eth commit -m "Initial commit"

4. Push to Blockchain

bvc-eth push

5. View History

bvc-eth log

6. Collaborate

# Share your repository ID with others
bvc-eth list --mine

# Others can clone your repository
bvc-eth clone <your-repo-id>

# Pull latest changes
bvc-eth pull

📋 Commands

Command	Description	Status
`bvc-eth init [name]`	Create new repository	✅ Working
`bvc-eth config`	Configure wallet/blockchain	✅ Working
`bvc-eth add <files>`	Stage files for commit	✅ Working
`bvc-eth commit -m "msg"`	Create commit with IPFS upload	✅ Working
`bvc-eth status`	Show repository status	✅ Working
`bvc-eth log`	View commit history	✅ Working
`bvc-eth push`	Push commits to blockchain	✅ Working
`bvc-eth pull`	Pull commits from blockchain	✅ Working
`bvc-eth clone <id>`	Clone repository from blockchain	✅ Working
`bvc-eth checkpoint`	Create commit batches	✅ Working
`bvc-eth list`	List all repositories	✅ Working

⚙️ Configuration

BVC requires configuration for blockchain and IPFS integration:

bvc config --setup

Required settings:

Private Key: Your wallet private key
RPC URL: Blockchain RPC endpoint (Sepolia, Mainnet, etc.)
IPFS Endpoint: IPFS node URL

🏗️ Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   BVC CLI       │───▶│  Smart Contract  │───▶│   Blockchain    │
│   (Commander)   │    │   (Solidity)     │    │   (Ethereum)    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Local Storage  │    │  File Hashing    │    │      IPFS       │
│   (.bvc/)       │    │   (SHA256)       │    │  (Distributed)  │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🧪 Testing

npm test

📜 License

MIT © Lviffy

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📞 Support

📧 Issues: GitHub Issues
📖 Documentation: Command Guide
🌐 Website: GitHub Repository

⚠️ Note: This is an early-stage project. Use at your own risk and test thoroughly before production use.