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 dual-track payment system:

  • Non-Staker Payments (payNoStaker_*): Payment functions available to all users
  • Staker Payments (payStaker_*): Payment functions exclusive to principal token stakers
  • Nonce Management: Synchronous (_sync) and asynchronous (_async) processing options
  • 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​

Dual-Track Payment Processing​

Non-Staker Payments (payNoStaker_*)​

  • Available to all users regardless of staking status
  • Standard payments without additional rewards
  • Optimized for minimal transaction costs

Staker Payments (payStaker_*)​

  • Exclusive to registered principal token stakers
  • Automatic principal token rewards for transaction processing
  • Priority processing capabilities

Nonce Management System​

Synchronous Processing (_sync)​

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

Asynchronous Processing (_async)​

  • User-defined nonce values for flexible 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.