Vocrom Developer & Operator Guide.
Comprehensive deployment, configuration, and architectural specification for Vocrom: Laravel 13.x multi-asset trading terminal, BaseBlockchain 17-chain custody, 12 algorithmic bots, and turnkey single-domain operations.
Executive Overview, Platform Architecture & Operator Sovereignty
1.1. System Overview
Vocrom is an institutional multi-asset financial terminal, algorithmic trading venue, and cryptocurrency exchange script engineered on the Laravel 13.x framework and optimized for PHP 8.4 (with full backward compatibility for PHP 8.2 and PHP 8.3). Engineered by Vocrom for financial operators, brokerage founders, quantitative funds, and fintech software developers, Vocrom delivers complete self-hosted source code ownership. Deploying Vocrom grants complete platform sovereignty: zero recurring seat taxes, zero basis-point revenue skimming, zero SaaS software dependencies, and total operational authority over ledgers, custody, risk intervention, and user accounts.
Vocrom unifies disparate asset classes under a single administrative terminal and customer interface:
- Perpetual Futures: Crypto derivatives up to 100x
- Margin Trading: Spot crypto margin up to 10x
- Interbank Forex: 40+ fiat currency pairs with micro-lots
- 145 US Equities: Wall Street blue chips with Asset Pods
- 12 Quant Bots: Grid, DCA, Arbitrage & Momentum
- BaseBlockchain: 17 native chains, 4 drivers, zero SaaS
1.2. Architecture Stack Specifications
| Layer | Technology | Purpose & Architectural Standard |
|---|---|---|
| Core Framework | Laravel 13.x | Streamlined kernel in vocrom/bootstrap/app.php |
| Runtime Engine | PHP 8.4 (8.2+ supported) | OPcache JIT enabled, strict type declarations |
| Database Engine | MySQL 8.0+ / MariaDB 10.5+ | InnoDB engine, utf8mb4 collation, ACID compliant |
| Blockchain Engine | BaseBlockchain (In-Tree PHP) | 17 native chains, 4 drivers, zero third-party custody fees |
| Task Automation | Web cURL / Artisan Daemon | cPanel web cron trigger or high-throughput CLI queue |
| Frontend Assets | Blade + Vanilla JS + CSS Tokens | Pre-compiled in vocrom/public/build/; 0s server build |
Vocrom software runs 100% on your independent server. Private keys and master wallet seeds stored in your environment are encrypted using AES-256-CBC with keys anchored in your vocrom/.env file. Vocrom maintains zero access to your master keys, cold storage vaults, or user databases. Loss of your vocrom/.env file or APP_KEY renders encrypted database keys unrecoverable. Operators maintain sole responsibility for jurisdictional licensing and compliance.
Pre-Installation Environment Audit & Infrastructure Requirements
2.1. Hardware Sizing & Capacity Matrix
Shared Hosting Verified
Vocrom is intentionally engineered with a lightweight, highly optimized PHP core. All frontend assets (Tailwind CSS, vanilla JavaScript, SVG icons) are pre-compiled in vocrom/public/build/. Running Vocrom requires zero Node.js processes, zero Docker containers, and zero background terminal daemons in production. Because of this architectural efficiency, Vocrom installs and operates smoothly on standard entry-level Shared Hosting as easily as it scales on high-capacity cloud VPS or dedicated bare-metal servers.
| Deployment Tier | Infrastructure Type | Min CPU | Min RAM | Storage | Target Concurrency | Example Providers |
|---|---|---|---|---|---|---|
| Shared Hosting | Standard cPanel / HPanel | 1 Shared vCPU | 1 GB RAM | 10 GB SSD | Up to 1,000 active users | Namecheap Stellar, Hostinger Shared, GoDaddy, Bluehost |
| Cloud VPS | Virtual Private Server | 2 - 4 vCPU | 4 - 8 GB RAM | 50 GB NVMe | 1,000 to 25,000 users | DigitalOcean, Linode, Hetzner Cloud, AWS Lightsail |
| Institutional Tier | Dedicated Bare-Metal | 8+ vCPU | 16 - 32 GB RAM | 250 GB NVMe | 25,000+ active users | Hetzner Dedicated, OVHcloud, AWS EC2 c6i |
- ✓ Zero Root Access Required: Installation, database provisioning, and daily administration execute entirely via the browser wizard and admin back-office.
- ✓ Pre-Compiled Assets: No server-side build steps. Shared hosting environments with no Node.js or SSH access run the application immediately.
- ✓ Web-Driven Cron Automation: Yield accrual, bot rebalancing, and deposit monitoring execute via lightweight cURL web triggers in cPanel Cron Jobs.
- ✓ Low Memory Footprint: Core request execution uses under 64 MB of RAM, staying well within standard shared hosting memory caps.
2.3. Web Server Configurations
Configure your web server document root to point to the vocrom/public/ directory.
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /var/www/vocrom/public;
index index.php index.html;
client_max_body_size 64M;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.4-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}
2.4. PHP 8.4 Runtime Directives & Mandatory Extensions
The 16 mandatory PHP extensions: bcmath, curl, fileinfo, gd, gmp, intl, json, mbstring, openssl, pdo, pdo_mysql, sodium, tokenizer, xml, zip, filter.
sudo apt update && sudo apt install -y php8.4 php8.4-cli php8.4-fpm php8.4-mysql \
php8.4-bcmath php8.4-curl php8.4-gd php8.4-gmp php8.4-mbstring php8.4-xml \
php8.4-zip php8.4-intl php8.4-soap php8.4-sodium
memory_limit = 512M
max_execution_time = 300
max_input_time = 300
post_max_size = 256M
upload_max_filesize = 256M
date.timezone = UTC
2.6. Dedicated MySQL / MariaDB Creation
CREATE DATABASE vocrom_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'vocrom_user'@'localhost' IDENTIFIED BY 'YourSuperSecurePassword123!';
GRANT ALL PRIVILEGES ON vocrom_db.* TO 'vocrom_user'@'localhost';
FLUSH PRIVILEGES;
Step-by-Step Installation Wizard Walkthrough
Vocrom features a standalone, browser-based deployment wizard located at vocrom/public/install/index.php. Navigating to https://yourdomain.com/install launches the automated setup pipeline:
Accept single-domain commercial terms granting unencrypted source ownership and operational rights on one production hostname.
Live automated audit verifying PHP 8.4 runtime and all 16 cryptographic extensions with instant green status badges.
Checks memory_limit (≥512M), max_execution_time (≥300s), and file upload sizing for uninterrupted processing.
Verifies recursive 775 write permissions across vocrom/storage/ and vocrom/bootstrap/cache/.
Confirms symlink(), proc_open(), putenv(), and fsockopen() execution permissions.
Direct cURL activation with https://vocrom.com/api/v1/license/activate binding purchase code to your hostname.
Connection verification with built-in table collision detection and safety reset before unbuffered schema ingestion.
Root operator account provisioning, APP_KEY generation, license key encryption, and permanent installation lockdown.
- Boots Laravel 13 kernel with database credentials and runs
php artisan migrate --force. - Regenerates public storage symlink with
php artisan storage:link --force. - Flushes view, route, and config cache with
php artisan optimize:clear. - Generates production encryption key with
php artisan key:generate --force. - Encrypts temporary purchase license into
vocrom/.envunderPRODUCT_KEYvia AES-256-CBC. - Creates permanent lockdown file:
vocrom/storage/installed.json.
Background Automation & Master Cron Scheduling
Vocrom manages algorithmic bot cycles, interest accrual, copy trading signal execution, deposit sweeps, and yield settlements through automated background dispatching.
Option A: cURL Web Transport (Recommended for cPanel / Shared Hosting)
Zero Root RequiredConfigure this single command in your cPanel Cron Jobs or external uptime monitor to trigger every minute:
* * * * * curl -s -o /dev/null https://yourdomain.com/utils/cronjob
When triggered via cURL or WGET, https://yourdomain.com/utils/cronjob executes fastcgi_finish_request() to return an instant JSON success payload ({"status":"success"}) in under 50 milliseconds. The client connection closes immediately, and execution continues asynchronously in the background. Your cURL job terminates instantly without timeouts.
Continuous Queue Worker Setup (Supervisor for VPS / Dedicated)
On dedicated Linux servers, run high-frequency queues and blockchain monitoring via Supervisor:
[program:vocrom-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/vocrom/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data
numprocs=4
redirect_stderr=true
stdout_logfile=/var/www/vocrom/storage/logs/worker.log
BaseBlockchain Native Multi-Chain Engine Setup
5.1. In-Tree BaseBlockchain vs Third-Party Custody APIs
Commercial crypto custody APIs (Fireblocks, BitGo, Tatum) charge $1,000 to $5,000 monthly plus basis-point taxes on deposit volume. Vocrom's native BaseBlockchain engine operates 100% inside your standard PHP runtime. It derives sub-addresses deterministically, monitors on-chain confirmations, sponsors gas, and sweeps customer funds into cold vaults with zero recurring fees.
5.2. Supported 17 Native Chains & 4 Cryptographic Drivers
| # | Network | Driver | Chain ID | Gas Asset | Primary Token Standards |
|---|---|---|---|---|---|
| 01 | Ethereum | EVM | 1 | ETH | ERC-20 (USDT, USDC, DAI, WBTC) |
| 02 | BNB Smart Chain | EVM | 56 | BNB | BEP-20 (USDT, USDC, BTCB, CAKE) |
| 03 | Polygon | EVM | 137 | POL | ERC-20 (USDT, USDC, WETH) |
| 04 | Arbitrum One | EVM | 42161 | ETH | ERC-20 (USDT, USDC, ARB) |
| 05 | Base | EVM | 8453 | ETH | ERC-20 (USDC, DAI) |
| 15 | Solana | Solana | Mainnet | SOL | SPL Tokens (USDT, USDC, RAY) |
| 16 | Tron | Tron | 728126428 | TRX | TRC-20 (USDT, USDC) |
| 17 | Bitcoin | BTC | Mainnet | BTC | UTXO Native (SegWit & Legacy) |
5.4. Master Wallet Generation & Key Encryption
Automatically provision master receiving addresses and AES-256 encrypted hot gas station keys:
php artisan base:blockchain-master-wallets --force
Gas Station Funding Requirements & Sweeping Daemon
Vocrom automatically sponsors gas fees into dry user sub-addresses before sweeping tokens into central cold vaults. Maintain native gas balances above warning thresholds:
| Network | Native Asset | Min Recommended | Critical Warning Alert |
|---|---|---|---|
| Ethereum | ETH | 0.25 ETH | < 0.05 ETH |
| BNB Smart Chain | BNB | 0.50 BNB | < 0.10 BNB |
| Polygon | POL | 50 POL | < 10 POL |
| Solana | SOL | 2.0 SOL | < 0.50 SOL |
| Tron | TRX | 1,000 TRX | < 200 TRX |
Autonomous Background Sweeping (Zero Manual Commands Required)
Token consolidation and gas sponsorship operate 100% autonomously in the background via the deposit worker daemon and system scheduler:
- Zero Terminal Commands: Platform operators never need to execute manual terminal sweep commands. The background daemon handles all gas sponsorship and consolidation routines continuously.
- Instant Event-Driven Sweeps: Once an on-chain deposit confirms and credits to the customer balance, the platform automatically queues the gas fueling and vault sweep sequence.
- Routine Background Passes: The background deposit worker systematically cycles through every active network, scans for un-swept token balances, funds gas when necessary, and transfers customer funds into your designated master cold vaults.
Perpetual Futures, Margin & Operator Risk Intervention
Up to 100x leverage on BTC, ETH, SOL, BNB with dynamic funding rates every 8 hours.
10x leverage with automated hourly borrow rate deductions and collateral liquidation corridors.
40+ fiat pairs with micro-lots (0.01), pip spread controls, and overnight rollover swaps.
Operator Risk Intervention Center (/admin/trading/positions)
The operator maintains real-time administrative sovereignty over open customer trades:
- • Live Monitor: Inspect entry price, mark price, leverage, and unrealized PnL.
- • Shuffle PnL: Override unrealized profit or loss values for specific accounts.
- • Force Close: Terminate open positions instantly at market or custom price.
- • Order Cancellation: Cancel pending limit, stop-loss, or take-profit orders.
Algorithmic Trading Bot Fleet Operations (12 Models)
Vocrom ships with 12 pre-configured quantitative trading bot strategies:
| # | Bot Model | Trading Logic | Market Application |
|---|---|---|---|
| 01 | Grid Master Pro | Geometric Grid Orders | Range-bound, consolidating sideways markets |
| 02 | Momentum Alpha | RSI + MACD Breakout | High-volatility directional trending market |
| 03 | Cross-Exchange Arb | Multi-Market Spread | Cross-venue liquidity price discrepancies |
| 04 | DCA Accumulator | Martingale Scaling | Long-term structural asset accumulation |
Master Copy Trading Desks & Strategy Access Codes
Retail investors can mirror verified lead traders automatically. Master traders generate private encrypted Strategy Access Codes to restrict copying to exclusive syndicates.
- • Lead Trader Commission: 10% automatically deducted from profitable closed trades.
- • Platform Operator Cut: 10% retained by platform as revenue.
- • Investor Net Retained: 80% credited directly into retail follower balances.
145 US Blue-Chip Equities, ETFs & Asset Pods
Vocrom integrates 145 premier US stocks (AAPL, MSFT, NVDA, TSLA, AMZN, JPM, BRK.B, LLY) into responsive 3-column Asset Pods featuring allocation sliders, 52-week pricing corridors, ETF index baskets (SPY, QQQ), and sovereign bond coupon countdowns.
Blockchain Deposit & Withdrawal Administration
Vocrom operates as a pure, non-custodial cryptocurrency trading terminal. All client deposits and withdrawals execute directly through native blockchain smart contracts and transfer rails. Conventional fiat processors, credit card gateways, and manual bank wires are deliberately bypassed in favor of transparent, self-hosted on-chain settlement.
11.1. Navigating the Admin Blockchain Control Center
All blockchain settings, wallet management, RPC node routing, and payout rules are managed under the Treasury Navigation suite in the admin panel:
/admin/deposit
- • Master Cold Vault addresses (EVM, SOL, TRX, BTC)
- • Hot Gas Station Wallets & balance monitors
- • RPC Node Management & Alchemy integration
- • Token Activation & Decimal Overlays
- • Gas Alert Thresholds & Sweeper configuration
- • Automated 8-Point Readiness Checklist
/admin/withdrawal
- • Minimum & Maximum single withdrawal limits
- • Platform Withdrawal Processing Fee schedule (%)
- • Automated On-Chain Payout Dispatcher toggle
- • Instant Broadcast vs Admin Manual Review corridor
- • Hot wallet payout gas balance reserve checks
11.2. Step-by-Step Initial Blockchain Setup Guide
Navigate to Settings -> Deposit Settings (/admin/deposit), open the Master Wallets tab, and click the red Reset / Generate All Wallets button. The platform generates a unified 0x... EVM address for all 14 EVM chains, alongside Solana Ed25519, Tron Base58Check, and Bitcoin SegWit addresses. Private keys for hot gas stations are encrypted with AES-256-CBC and stored in vocrom/.env.
For token deposits (USDT, USDC) to sweep into cold vaults, and for automated withdrawals to broadcast, the hot gas station wallet must hold native gas tokens:
In Deposit Settings, open the RPC Nodes tab:
- Alchemy API Key (Recommended): Input your Alchemy Key. BaseBlockchain automatically derives premium endpoints for Ethereum, Polygon, Arbitrum, Base, and Optimism.
- TronGrid Pro API Key: Input your TronGrid key to prevent rate-limiting on high-frequency TRC-20 token sweeps.
- Custom RPC Node Overrides: Enter private HTTPS RPC endpoints for any network and click Test Connection to benchmark millisecond response latency in real time.
Under the Limits and Fees tab in Deposit Settings, establish platform boundary constraints:
- • Min / Max Deposit: e.g. $10 min, $50,000 max.
- • Deposit Fee (%): Set to 0% for zero-fee deposits.
- • Session Lifetime: 1440 min (24 hours).
- • Default Chain: Recommended:
bsc(low gas).
Under Settings -> Withdrawal Settings (/admin/withdrawal), administrators have full sovereignty to toggle between Automatic Payout and Manual Payout depending on corporate risk tolerance and compliance procedures:
- • Instant Dispatch: When a verified user requests a withdrawal, the system validates balance, KYC tier limits, and pre-flight gas checks.
- • Automated Signing: The hot gas station wallet (
MASTER_WALLET_KEY) signs and broadcasts the on-chain transfer immediately without human intervention. - • Real-Time Logging: The blockchain transaction hash (TXID) is logged to the user's ledger and sent via automated email.
- • Ideal For: High-velocity exchange operations, low-friction trading desks, and automated VIP payouts.
- • Held Balance: Funds are locked from user balances immediately to prevent double-spending, but on-chain broadcast is halted.
- • Pending Queue Review: Requests appear in Treasury -> Withdrawals for administrative inspection (trading history, KYC, destination address).
- • Approve Action: Clicking Approve triggers the hot wallet on-chain broadcast, or allows manual TX hash entry if dispatched from cold storage.
- • Reject Action: Clicking Reject prompts for a reason, instantly refunds the user's locked balance, and dispatches a notification.
- • Ideal For: Strict risk management, large institutional transfers, and safeguarding treasury reserves against fraud.
11.3. Automated 8-Point Blockchain Readiness Checklist
In the admin panel, the System Checklist audits operational health before accepting live customer capital:
- Phase 1 (Deposit Detection): On-chain receipt triggers balance credit.
- Phase 2 (Automated Gas Fueling): Hot gas station sponsors fee into dry sub-address.
- Phase 3 (Vault Consolidation): Sub-address sweeps tokens directly to Master Cold Vault.
Under Deposit Settings -> Master Wallets, click Export Private Keys and verify your administrator password. Exported keys can be imported into MetaMask (EVM), TronLink (Tron), Phantom (Solana), or Electrum (Bitcoin) for independent emergency verification.
White-Label Branding, Currencies & Multilingual Locales
Under Settings -> General Settings, customize your exchange identity. The platform name resolves dynamically across all templates via getSetting('name', 'Vocrom'). Upload rectangle logos (360x80px), square mobile icons (120x120px), and browser favicons. Supports full RTL layout flipping for Arabic/Hebrew.
In-Browser Web IDE & Server-Side File Manager
Vocrom includes a built-in server-side file browser and in-browser code editor with full IDE syntax highlighting. Operators can edit Blade views in vocrom/resources/views/ or CSS styles in vocrom/public/assets/ directly in the browser without FTP or SSH terminals.
User Management & Tiered KYC Security Fortress
| KYC Tier | Verification Required | 24h Withdrawal Limit | Trading Permissions |
|---|---|---|---|
| Tier 0 | Unverified Email | $0 (Blocked) | View-only; deposits disabled |
| Tier 1 | Email + SMS OTP | $2,000 / day | Spot trading, automated crypto deposits |
| Tier 2 | Government ID + Selfie | $50,000 / day | Perpetual futures 100x, margin, bots |
| Tier 3 | Proof of Address (POA) | Unlimited | Full institutional access & OTC desks |
Maintenance, Cache Rebuilds & Troubleshooting Guide
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan storage:link --force
Common Operational Resolutions:
sudo ufw allow out 443/tcp).* * * * * curl -s -o /dev/null https://yourdomain.com/utils/cronjob is active in crontab.