1. Introduction to dvScripts Developer Platform

dvScripts is not just an SMM panel engine—it is a full-scale development environment designed for automation companies, SaaS providers, resellers, and enterprise engineering teams who demand flexibility and performance at every layer.

The platform processes millions of automated API requests each month, powering high-traffic providers across more than 40 countries. Every function inside dvScripts is designed to be modular, upgradable, and extensible without ever touching core files.

What Makes dvScripts a Developer-First System?

• Clean, predictable folder structure for fast development.
• Universal provider API wrapper supporting 35+ standards.
• Non-blocking routing engine designed for high throughput.
• Addon framework that allows developers to patch, extend, or enhance functionality.
• Dedicated event hooks for every critical lifecycle moment (orders, payments, API sync, cron).
• Enterprise-level security & automatic sanitization.

dvScripts evolves with your business. Small teams scale into enterprise operations using the same codebase—no rewrites, no migrations, no spaghetti architecture.

2. Core Architecture Overview

dvScripts uses a layered micro-modular architecture built to separate logic, presentation, and processing. This ensures zero code conflicts, smooth upgrades, and maximum developer freedom.

/app
  /controllers      → User, Admin, API, Services
  /models           → Database ORM-like models
  /views            → Twig templates & UI components
/core
  /engine           → Router, dispatcher, kernel
  /providers        → Provider integration drivers
  /security         → Sanitization, tokens, hashing
/public
  index.php         → Entry point
/config
  config.php        → Global settings
  database.php      → DB credentials
        

The core never mixes business logic with display or API handling—giving you full control to replace, extend, or build new modules without breaking system integrity.

Key Architecture Advantages

• Strict separation of logic & UI.
• Faster debugging with clean module boundaries.
• Automated routing & controller mapping.
• High compatibility with custom addons.
• Zero-dependency upgrades (plug-and-play updates).

3. Provider API Integration Framework

The dvScripts API Engine standardizes communication to any provider—no matter their format, error style, or endpoint logic. Developers can integrate new providers in minutes using the universal request builder and parser.

// Standardized dvScripts API Request
{
  "key": "API_KEY",
  "action": "add",
  "service": 101,
  "link": "https://example.com",
  "quantity": 500
}
        

Supported Data Formats

• JSON
• XML
• URL-encoded
• Custom provider formats

Built-in Reliability Features

• Provider failover & retry strategy.
• Automatic request validation & cleanup.
• Response normalization (avoids random provider formats).
• Rate-limiting to protect against throttling.

4. Developer Hooks (Event System)

Hooks allow developers to execute custom code without editing core files.

• before_order_created — Modify or validate data before order creation.
• after_order_created — Sync logs, analytics, CRM.
• before_payment_processed — Anti-fraud filters & metadata rules.
• after_payment_processed — Deliver credits, emails, notifications.
• order_status_synced — Trigger actions on provider updates.
• daily_cron_event — Schedule daily automated tasks.

add_hook("after_payment_processed", function($payment) {
    externalBillingAPI($payment);
});
        

5. Addon Development Framework

The addon system allows developers to build powerful new features without touching core files.

Addon Structure

addon.json      → Metadata
controller.php  → Logic
view.twig       → UI template
hooks.php       → Hooks & events
        

Real-World Addon Examples

• Custom payment gateways
• Data analytics modules
• Caching & performance addons
• Admin automation tools

6. Webhooks (Inbound & Outbound)

dvScripts supports secure inbound & outbound webhooks for payment systems, providers, and automation tools.

Outbound

• Order created
• Order updated
• Payment received
• User registered

Inbound

• Crypto payment callback
• Card payment processors
• Provider delivery updates

7. Scaling & Performance Optimization

• Database indexing
• Connection pooling
• Caching layers
• Load-balancing logic
• Advanced segmentation for enterprise DB size

8. Security Standards

• Input sanitization
• Escaped SQL queries
• Encrypted API keys
• Locked permissions
• Cron token security
• Brute-force protection

9. CLI Tools & Automation

Used for server tasks, cron, maintenance, and bulk operations.

10. Testing Framework

Testing guidelines, mock provider responses, and automation tools.