ViCoin (VIC) - Master Plan & Implementation

🚀 Проектна Визия

ViCoin (VIC) е хибриден utility + governance токен, проектиран да бъде валутата на цялата дигитална екосистема Vi-Lab / Vi Team Security Group.

📋 Структура на Проекта

vicoin/
├── docs/                    # Документация
│   ├── whitepaper.md       # Пълен whitepaper
│   ├── tokenomics.md       # Детайлна токеномика
│   ├── roadmap.md          # 5-годишен roadmap
│   └── technical-spec.md   # Техническа спецификация
├── contracts/              # Smart contracts
│   ├── token/              # ERC-20/собствен стандарт
│   ├── staking/            # Staking контракти
│   ├── governance/         # Governance контракти
│   └── bridges/            # Bridge контракти
├── chain/                  # Blockchain implementation
│   └── cosmos/             # Cosmos SDK вариант
│       ├── app/            # Application logic
│       │   ├── app.go      # Main app wiring
│       │   └── params/     # Encoding configuration
│       ├── cmd/            # CLI commands
│       │   └── vicoind/     # Main daemon binary
│       ├── x/              # Custom modules
│       │   └── vicoin/     # ViCoin custom module
│       │       ├── keeper/ # State management
│       │       ├── module/ # Module implementation
│       │       └── types/  # Type definitions
│       └── scripts/        # Setup scripts
├── infrastructure/         # Infrastructure код
│   └── monitoring/         # Prometheus/Grafana
├── wallets/                # Wallet implementations
│   ├── web/                # Web wallet (React)
│   ├── mobile/             # Mobile SDK
│   └── cli/                # CLI wallet
├── sdk/                    # SDK за разработчици
│   └── javascript/         # Node.js SDK
├── website/                # Официален сайт
│   └── src/                # React + TypeScript
├── integrations/           # Интеграции с Vi-Lab проекти
│   ├── zhar/               # ЖАР интеграция
│   ├── shivik/             # Shivik интеграция
│   ├── littlenet/          # Littlenet интеграция
│   └── feder-os/           # Feder OS интеграция
└── tools/                  # Инструменти
    └── faucet/             # Testnet faucet

🎯 Основни Цели

1. Техническа Основа: Създаване на стабилна, мащабируема блокчейн мрежа
2. Токеномика: Фиксирана емисия от 1B VIC с ясно разпределение
3. Екосистемна Интеграция: Свързване на всички Vi-Lab платформи
4. Governance: DAO структура за децентрализирано управление
5. Безопасност: Множество аудити и формална верификация

📚 Документация

• Whitepaper - Пълна визия и техническа спецификация
• Tokenomics - Детайлна токеномика и разпределение
• Roadmap - 5-годишен план за развитие
• Technical Spec - Техническа архитектура

🚀 Бърз Старт

Web Wallet

cd wallets/web
npm install
npm run dev
# Отвори http://localhost:1111

Website

cd website
npm install
npm run dev
# Отвори http://localhost:1112

Smart Contracts

cd contracts
npm install
npx hardhat test

Cosmos SDK Chain

cd chain/cosmos

# Build (✅ Миграция към v0.50 завършена)
go mod tidy
go build -o build/vicoind ./cmd/vicoind

# Initialize testnet
./scripts/create-genesis.sh

# Start local dev network
./scripts/start-dev.sh

✅ Статус: Миграцията към Cosmos SDK v0.50 е завършена успешно! Blockchain node (vicoind) компилира без грешки и е готов за използване.

💰 Как да Получиш VIC Токени

Testnet / Development

1. Faucet (Testnet)

За testnet мрежата има автоматичен faucet, който предоставя безплатни токени за тестване:

# Стартиране на faucet service
cd tools/faucet
npm install
npm run dev

# Заявка за токени (чрез API)
curl -X POST http://localhost:3001/request \
  -H "Content-Type: application/json" \
  -d '{"address": "vicoin1..."}'

# Или използвай web wallet за автоматично заявяване
# Отвори http://localhost:1111 и използвай "Request Testnet Tokens"

Лимити:

• 100 VIC на адрес на ден
• Само за testnet/devnet адреси
• Автоматично rate limiting

2. Genesis Distribution

При стартиране на локална devnet мрежа, genesis файлът съдържа предварително разпределени токени:

cd chain/cosmos
./scripts/create-genesis.sh

# Genesis съдържа:
# - 3 валидатора (10M VIC всеки)
# - Treasury account (200M VIC)
# - Faucet account (10M VIC)
# - 2 test потребители (1M VIC всеки)

Mainnet (След Launch)

1. Public Sale

• Seed Round: 20M VIC @ $0.01
• Private Sale: 30M VIC @ $0.02
• Public Sale: 50M VIC @ $0.03
• Минимална покупка: $100
• Максимална покупка: $10,000

2. DEX/CEX Listings

След launch, VIC ще бъде достъпен на:

• Uniswap, PancakeSwap (DEX)
• MEXC, Gate.io, KuCoin (CEX)
• Други партньорски борси

3. Екосистемни Награди

• Участие в Vi-Lab проекти (ЖАР, Shivik, Littlenet)
• Governance участие
• Staking rewards

⛏️ Копаене / Staking при Старта

Staking (Delegating)

Staking е основният начин да "копаеш" VIC токени. Чрез staking (делегиране) на валидатори, получаваш награди от staking pool.

Как да Stake-неш

Чрез Web Wallet:

# Стартирай web wallet
cd wallets/web
npm run dev
# Отвори http://localhost:1111
# Избери валидатор и stake-ни токени

Чрез CLI:

# Създай wallet
vicoind keys add my-wallet

# Stake към валидатор
vicoind tx staking delegate \
  vicoinvaloper1... \
  1000000uvic \
  --from my-wallet \
  --chain-id vicoin-testnet

Чрез SDK:

import { createSDK } from '@vicoin/sdk';

const sdk = await createSDK({
  rpcUrl: 'http://localhost:26657',
  chainId: 'vicoin-testnet'
});

// Stake токени
await sdk.stake({
  validatorAddress: 'vicoinvaloper1...',
  amount: '1000000', // 1 VIC (в uvic)
  duration: 'flexible' // или 'locked-30d', 'locked-90d', 'locked-365d'
});

Staking Rewards

• APY: 3-8% (зависи от lock периода)
  • Flexible: 3.0% APY (без lock)
  • 1 Month: 4.0% APY
  • 3 Months: 5.0% APY
  • 6 Months: 6.0% APY
  • 12 Months: 8.0% APY
• Locked Staking: По-високи награди за по-дълги периоди
• Flexible Staking: По-ниски награди, но с възможност за незабавно unstake
• Награди: Изплащат се автоматично всеки блок

Staking Pool

• Общо за staking: 200,000,000 VIC (20% от общата емисия)
• Разпределение: 10 години
  • Година 1: 30M VIC (~6% APY при 50% staked)
  • Година 2: 25M VIC (~5% APY)
  • Години 3-5: 20-18M VIC годишно (~4-3.6% APY)
  • Години 6-10: ~17M VIC годишно (~2.8% APY)
• Източник: От treasury и transaction fees

📊 Общ баланс: 1,000,000,000 VIC (1 милиард). Виж TOKENOMICS_SUMMARY.md за детайлно разпределение.

Валидиране (Validator)

Ако искаш да станеш валидатор и да получаваш допълнителни награди:

Изисквания

• Минимален stake: 1,000,000 VIC
• Self-delegation: Минимум 10% от твоя stake
• Технически: VPS/Server с минимум 4 CPU, 8GB RAM, 100GB storage
• Uptime: Минимум 95% uptime (иначе slashing)

Настройка на Validator

cd chain/cosmos

# Инициализирай validator node
vicoind init my-validator --chain-id vicoin-testnet

# Създай validator ключове
vicoind keys add validator-key

# Създай validator
vicoind tx staking create-validator \
  --amount=1000000000uvic \
  --pubkey=$(vicoind tendermint show-validator) \
  --moniker="My Validator" \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --min-self-delegation="1000000" \
  --from validator-key \
  --chain-id vicoin-testnet

# Стартирай validator node
vicoind start

Validator Rewards

• Transaction Fees: 50% от всички transaction fees
• Staking Rewards: Допълнителна комисионна от delegators (10-20%)
• Block Rewards: От staking pool

Mining (Proof of Stake)

ViCoin използва Proof of Stake (PoS) консенсус, не традиционен mining. Вместо да "копаеш" с изчислителна мощ, ти:

1. Stake-ваш токени (делегираш към валидатор)
2. Валидираш (ако имаш достатъчно stake)
3. Получаваш награди базирани на твоя stake

Предимства на PoS:

• Няма нужда от скъп хардуер
• Енергийно ефективно
• По-бързо и по-евтино
• По-безопасно (slashing за злонамерено поведение)

🐳 Docker

Web Wallet

docker build -t vicoin-wallet-web -f Dockerfile.wallet-web .
docker run -d -p 1111:1111 --name vicoin-wallet-web vicoin-wallet-web

Website

docker build -t vicoin-website -f website/Dockerfile website/
docker run -d -p 1112:3000 --name vicoin-website vicoin-website

📦 Компоненти

✅ Завършени

• ✅ Документация (Whitepaper, Tokenomics, Roadmap)
• ✅ Smart Contracts (Token, Staking, Governance, Treasury, Vesting, FeeEngine)
• ✅ Web Wallet (React + TypeScript) - Build успешен
• ✅ Официален Website
• ✅ JavaScript SDK
• ✅ CLI Wallet
• ✅ Faucet Service
• ✅ Docker конфигурации
• ✅ Cosmos SDK x/vicoin модул (types, keeper, module)
• ✅ app/params encoding configuration
• ✅ Cosmos SDK v0.50 миграция - ЗАВЪРШЕНА 🎉
• ✅ Blockchain Node (vicoind) - Компилиран успешно (135MB)
• ✅ Tokenomics анализ и документация

🔄 В Разработка

• 🔄 Mobile Wallet
• 🔄 Explorer
• 🔄 Mint модул конфигурация за staking rewards

🆕 Последни Добавки

Cosmos SDK Implementation

x/vicoin модул - Създаден минимален custom модул за ViCoin:

• Types (x/vicoin/types/):

  • keys.go - Store keys и module constants
  • params.go - Module parameters (denom: uvic)
  • params_keytable.go - Parameter key table
  • genesis.go - Genesis state definition
  • expected_keepers.go - Keeper interfaces (AccountKeeper, BankKeeper)

• Keeper (x/vicoin/keeper/):

  • keeper.go - State management и parameter handling
  • Интегриран с Cosmos SDK AccountKeeper и BankKeeper

• Module (x/vicoin/module/):

  • module.go - AppModule и AppModuleBasic имплементация
  • genesis.go - Genesis export functionality
  • Поддръжка за InitGenesis и ExportGenesis

app/params пакет - Encoding configuration:

• encoding.go - EncodingConfig за ProtoCodec, Amino, и TxConfig
• Използва се за сериализация на транзакции и съобщения

app.go промени:

• Интегриран x/vicoin модул в ModuleBasics
• Добавен ViCoinKeeper в App struct
• Поправени импорти за cosmossdk.io пътища
• Добавени липсващи зависимости (log, dbm, version, authsims, appparams)

Cosmos SDK v0.50 Миграция - ЗАВЪРШЕНА ✅:

• ✅ Logger и DB типове обновени (cosmossdk.io/log, cosmos-db)
• ✅ Store keys обновени (storetypes.NewKVStoreKeys)
• ✅ BeginBlock/EndBlock сигнатури поправени
• ✅ ExportAppStateAndValidators обновен с трети параметър
• ✅ RegisterNodeService метод добавен
• ✅ Всички keepers API обновени (NewAccountKeeper, NewBaseKeeper, и др.)
• ✅ KVStoreService интегриран във всички keepers
• ✅ Address codecs конфигурирани правилно
• ✅ GenesisBalancesIterator поправен
• ✅ TxCommand и QueryCommand обновени
• ✅ Всички compilation грешки поправени
• ✅ Code formatting и vet проверки преминати
• ✅ Blockchain node компилира успешно без грешки

Резултат: vicoind binary (135MB) е готов за използване. Виж VERIFICATION_REPORT.md за пълни детайли.

📊 Текущ Статус

✅ Готови Компоненти

1. Blockchain Node (vicoind)

   • ✅ Компилиран успешно (135MB)
   • ✅ Cosmos SDK v0.50 миграция завършена
   • ✅ Всички compilation грешки поправени
   • ✅ Code quality проверки преминати

2. Web Wallet

   • ✅ Build успешен
   • ✅ TypeScript компилира без грешки
   • ✅ Готов за deployment

3. Tokenomics & Mining

   • ✅ Документиран (TOKENOMICS_SUMMARY.md)
   • ✅ Обща емисия: 1,000,000,000 VIC
   • ✅ Staking механизъм: Validator-based PoS
   • ✅ Staking rewards: 200M VIC за 10 години

📝 Документация

• TOKENOMICS_SUMMARY.md - Детайлен анализ на tokenomics и mining
• VERIFICATION_REPORT.md - Пълен отчет за проверка и тестване
• chain/cosmos/MIGRATION_NOTES.md - Cosmos SDK миграция детайли

🔗 Връзки

• Website: https://vicoin.vi-lab.eu
• Web Wallet: http://localhost:1111 (local dev)
• Repository: https://git.vi-lab.eu/orion/vicoin

📝 Лиценз

Част от Vi-Lab / Vi Team Security Group проекта.

---

Разработено от: Vi Team Security Group
Версия: 1.0.0