---

Chainvoice

Chainvoice is a decentralized invoicing platform that enables secure, transparent, and tamper‑proof invoice creation, management, and payments on blockchain. Powered by Ethereum-compatible smart contracts, Chainvoice automates payment flows and reduces reliance on intermediaries.

Table of Contents

• Overview
• Features
• Project Structure
• Getting Started
• Frontend Setup
• Smart Contract Testing
• Deploy to Ethereum Classic
• Environment Variables
• Community and Support

Overview

Chainvoice transforms traditional invoicing by leveraging blockchain technology to create a trustless, automated payment system. Users can create invoices, manage payments, and track transaction history with complete transparency and security.

Features

• Decentralized Invoice Creation - Create and manage invoices on-chain
• Multi-Token Support - Pay using native currency or ERC-20 tokens
• Immutable Records - Verifiable transaction history and status tracking
• Treasury Management - Built-in fee management for platform sustainability
• Privacy Protection - Encrypted invoice data with access control
• User-Friendly Interface - Intuitive web application with wallet integration

Project Structure

Chainvoice/
├── frontend/ # Web application (UI/UX, wallet integration)
├── contracts/ # Solidity smart contracts (core invoicing logic)
├── docs/ # Documentation and guides
└── README.md # This file

Getting Started

1. Fork the repository
2. Clone your fork

git clone https://github.com/yourusername/Chainvoice.git
cd Chainvoice

Frontend Setup

1. Navigate to frontend directory
   cd frontend

2. Install dependencies
   npm install

3. Start development server
   npm run dev

4. Open application Navigate to http://localhost:5173 in your browser

Smart Contract Testing

Prerequisites: Foundry must be installed

1. Navigate to contracts directory
   cd contracts

2. Run test suite
   forge test

3. Run tests with verbosity (optional)
   forge test -vvv

Deploy to Ethereum Classic

Prerequisites

• Foundry installed
• Wallet funded with ETC
• ETC RPC URL (e.g., Rivet, Ankr, Chainstack)

Deployment Steps

1. Configure environment variables
   cp contracts/.env.example contracts/.env
   Edit contracts/.env with your actual values

2. Compile contracts
   cd contracts
   forge build

3. Load environment variables
   source .env

4. Deploy to Ethereum Classic
   forge create contracts/src/Chainvoice.sol:Chainvoice --rpc-url $ETC_RPC_URL --private-key $PRIVATE_KEY --broadcast

5. Configure frontend
   cp frontend/.env.example frontend/.env
   Edit frontend/.env and set:
   VITE_CONTRACT_ADDRESS=your_deployed_contract_address_here

6. Restart frontend development server
   cd frontend
   npm run dev

Environment Variables

Frontend Configuration (frontend/.env)

VITE_CONTRACT_ADDRESS=your_deployed_contract_address_here
VITE_CHAIN_ID=61
VITE_RPC_URL=your_etc_rpc_url_here

Contracts Configuration (contracts/.env)

PRIVATE_KEY=your_private_key_here
ETC_RPC_URL=your_etc_rpc_endpoint_here
ETHERSCAN_API_KEY=your_etherscan_api_key_here

⚠️ Security Note: Never commit .env files to version control. Keep your private keys secure.

Community and Support

Join our community for support, updates, and discussions:

• Telegram - t.me/StabilityNexus
• Discord - discord.gg/YzDKeEfWtS
• X (Twitter) - @StabilityNexus
• Medium - news.stability.nexus
• LinkedIn - linkedin.com/company/stability-nexus
• YouTube - youtube.com/@StabilityNexus

Contributing

We welcome contributions! Please read our contributing guidelines and submit pull requests for any improvements.

Built with ❤️ by Stability Nexus

(back to top)