Skip to main content

Introduction to the EVVM Core Contract

The EVVM (Ethereum Virtual Virtual Machine) Core Contract serves as the central payment processing and token management hub for the EVVM ecosystem. This smart contract implements core functionalities including payment systems, staker rewards, cross-chain operations, and administrative tools.

Core Contract Functions​

Payment Processing​

The EVVM Core Contract implements a unified payment system with automatic staker detection:

  • Unified Payment Function (pay): Single payment function that automatically detects executor staker status
  • Automatic Staker Benefits: Staker executors receive priority fees and MATE token rewards automatically
  • Nonce Management: Synchronous and asynchronous processing options via priorityFlag parameter
  • Batch Operations: Multi-payment processing through payMultiple and dispersePay functions
  • Contract Payments: Administrative payment functions (caPay, disperseCaPay)

Token Management​

  • Token Abstractions: Internal token representations using EIP-191 signatures
  • Balance Management: Principal balances, reward balances, and cross-chain reserves
  • Transfer Authorization: Signature-based validation for all token operations

System Integration​

  • Name Service: Identity resolution for username-based payments
  • Staking Coordination: Principal token staking and reward distribution
  • Fisher Bridge: Cross-chain withdrawal and deposit operations

Administrative Functions​

  • Governance System: Time-delayed administrative changes
  • Security Controls: Multi-layer validation and replay protection
  • Proxy Architecture: Upgradeable contract design with implementation changes

Payment System Architecture​

Unified Payment Processing​

The pay Function​

  • Automatic Staker Detection: Determines executor staker status during execution without requiring separate functions
  • Conditional Rewards: Staker executors automatically receive MATE token rewards and priority fees
  • Universal Access: Available to all users - staker benefits are applied automatically based on executor status
  • Simplified Integration: Single function handles all payment scenarios, reducing complexity for developers

Nonce Management System​

Synchronous Processing (priorityFlag = false)​

  • Automatic nonce increment for ordered transactions
  • Guaranteed transaction sequence
  • Simplified transaction management

Asynchronous Processing (priorityFlag = true)​

  • Custom nonce management for transaction ordering
  • Multiple transactions can be prepared simultaneously
  • Replay protection prevents duplicate transaction execution

Advanced Payment Features​

Batch Payment Processing​

Multiple Payments (payMultiple)​

  • Execute multiple individual payments in one transaction
  • Partial success handling with detailed result reporting
  • Individual validation for each payment

Distribution Payments (dispersePay)​

  • Distribute from one sender to multiple recipients
  • All-or-nothing execution for consistency
  • Support for both direct addresses and Name Service identities

Contract-to-Address Payments​

Administrative Payments (caPay)​

  • Smart contracts can execute payments without token approvals
  • Direct integration for contract-based operations
  • Automated distributions for system-level operations

Contract Distribution (disperseCaPay)​

  • Multi-recipient distributions from contracts
  • Designed for protocol-level operations
  • Parameter validation for token amounts

Economic Model and Tokenomics​

Principal Token System​

The principal token drives the contract's economic model:

  • Era Transitions: Reward halving when supply thresholds are reached
  • Base Rewards: Fixed principal token amounts for transaction processing
  • Staker Incentives: Additional rewards for principal token holders who stake
  • Random Bonuses: Era transition triggers provide lottery-style rewards (1-5083x)

Fee Structure​

  • Priority Fees: Optional fees for faster processing
  • Staker Distribution: Priority fees distributed to transaction processors
  • Cross-Chain Fees: Fees for Fisher Bridge withdrawal and deposit operations
  • Dynamic Limits: Withdrawal limits adjustable through governance

Security Architecture​

Signature Verification​

  • EIP-191 Standard: All transactions require cryptographic signatures
  • Replay Protection: Nonce-based system prevents duplicate transactions
  • Parameter Integrity: Signatures cover all critical transaction parameters

Governance System​

  • Time-Delayed Changes: 30-day delay for proxy implementation changes, 1-day for administrative updates
  • Community Protection: All changes visible before execution
  • Emergency Controls: Admin can reject problematic proposals

Token Architecture​

Token Abstraction System​

EVVM implements internal token abstractions instead of traditional ERC-20 contracts:

  • Internal Representations: Tokens exist as abstractions within EVVM
  • Signature-Based Authorization: All transfers authorized through EIP-191 signatures
  • Input Validation: Signatures validated against exact function parameters

Balance Management​

  • Principal Balances: Direct token holdings managed by core contract
  • Reward Balances: Accumulated principal token rewards from staking and system participation
  • Cross-Chain Reserves: Tokens locked for Fisher Bridge operations
  • Pending Withdrawals: Balances reserved for cross-chain withdrawal processing

Integration Capabilities​

Name Service Integration​

  • Username Payments: Convert usernames to wallet addresses automatically
  • Identity Resolution: Support both direct addresses and Name Service identities
  • Validation Layer: Verification of identity ownership and validity

Cross-Chain Bridge Integration​

  • Withdrawal System: Multi-chain support for token withdrawals
  • Security Limits: Configurable withdrawal limits for different tokens
  • Operator Incentives: Bridge operators receive fees and rewards

Execution Methods​

The EVVM supports two execution approaches:

Direct Execution​

  • User-Initiated: Users interact directly with the EVVM contract
  • Immediate Processing: Transactions submitted directly to the blockchain
  • Full Control: Complete autonomy over transaction timing and parameters

Fisher Execution​

  • Fishing Spot Integration: Users submit transactions through the fishing spot system
  • Fisher Processing: Specialized fisher nodes capture and execute transactions
  • Optimized Routing: Fishers handle transaction optimization and gas management

The EVVM Core Contract provides comprehensive payment processing, token management, and administrative functionality as the central infrastructure component of the EVVM ecosystem.