Skip to main content

Hacker Quickstart

Ready to hack? Connect to our public testnet or deploy your own EVVM in minutes. Build the future of abstract blockchain infrastructure!

What is EVVM?​

Abstract Blockchain: Your own blockchain without managing validators or nodes. Virtual blockchains live securely on host blockchains (Ethereum, Arbitrum, etc.).

Revolutionary Features:

  • Gasless Communication through "fishing spots" (APIs, mempools, radio waves, any data transmission)
  • Virtual Scalability - multiple EVVMs on one host blockchain
  • Zero Infrastructure - just deploy smart contracts
  • Fisher Network - stakers execute transactions and earn MATE rewards
  • Token Abstractions - internal tokens using EIP-191 signatures, not separate ERC-20 contracts

Quick Deploy Your EVVM​

# Clone & Setup
git clone https://github.com/EVVM-org/Testnet-Contracts
cd Testnet-Contracts
make install

# Configure environment
cp .env.example .env
# Add your RPC URLs and API keys

# Import private key securely
cast wallet import defaultKey --interactive

# Auto-deploy with wizard
./evvm-init.sh

What gets deployed: 5 core contracts

  • EVVM Core - Payment processing, token management & fisher rewards
  • NameService - Username system with gasless registration
  • Staking - MATE token staking & enhanced rewards for fishers
  • Estimator - Reward calculations & epoch management
  • Treasury - Host blockchain ↔ EVVM bridge for deposits/withdrawals

How Transactions Work​

1. Sign Transaction (EIP-191)​

Users create transactions with dual signatures: one for service authorization and another for EVVM payment processing. These EIP-191 signed transactions are then broadcast to fishing spots (APIs, mempools, or any data transmission medium) where fishers can capture them.

2. Fisher Validation & Capture​

Fishers (MATE token stakers) continuously monitor fishing spots for new transactions. When they detect a transaction, they validate the signatures and nonces to ensure authenticity, then execute the transaction on the host blockchain while bearing the gas costs.

3. Execution & Rewards​

Once validated, EVVM processes the transaction and automatically distributes rewards. Fishers receive base MATE token rewards plus any priority fees paid by users. This incentive system ensures sustainable transaction processing while enabling gasless user experiences.

Key Insight: Fishers = Stakers who execute transactions. Users can pay zero main fees + optional priority fees for gasless UX.

Public EVVM Testnet Addresses​

Ethereum Sepolia Testnet​

Arbitrum Sepolia Testnet​

Build Your First EVVM Service​

1. Smart Contract Integration​

import {SignatureRecover} from "@EVVM/testnet/lib/SignatureRecover.sol";

contract MyService {
    // Dual signature pattern: service authorization + EVVM payment
    function myFunction(
        address user,
        uint256 serviceNonce,           // Your service nonce (async)
        bytes memory serviceSignature,  // Your EIP-191 signature
        uint256 priorityFee,           // Optional fee for fishers (can be 0)
        uint256 evvmNonce,             // EVVM payment nonce  
        bool useAsync,                 // EVVM sync/async flag
        bytes memory evvmSignature     // EVVM payment signature
    ) public verifyNonce(user, serviceNonce) {
        // 1. Validate YOUR service signature (EIP-191)
        require(validateServiceSignature(...), "Invalid service sig");
        
        // 2. Process payment through EVVM (user pays only optional priority fee)
        if (priorityFee > 0) {
            evvm.payStaker_async( // or payStaker_sync
                user, 
                address(this),    // Service receives priority fee
                "", 
                principalToken, 
                priorityFee,      // Amount = priority fee only
                0,                // No additional priority fee
                evvmNonce, 
                useAsync, 
                evvmSignature
            );
        }
        
        // 3. Execute your logic (gasless for user!)
        // Service covers costs through staking rewards
        // Fisher earns base MATE reward + priority fee
    }
}

2. Key EVVM Patterns​

  • Dual Signatures: Service authorization + EVVM payment (separate nonce systems)
  • Fisher Incentive Model: Zero main amount + optional priority fees = gasless UX
  • EIP-191 Standard: All signature validation uses this standard
  • Staker Privileges: Only stakers can use payStaker_* functions and earn enhanced rewards
  • Token Abstractions: No separate ERC-20 contracts, uses internal EVVM representations

3. Development Approaches​

  • Deploy Your Own EVVM: Complete isolation, custom blockchain rules
  • Build Within an EVVM: Connect to existing ecosystem (use our public testnet addresses)
  • EIP Laboratory: Test future Ethereum features in controlled environment

EVVM Economics Deep Dive​

Fisher Network​

  • Who: MATE token stakers who execute transactions
  • Role: Monitor fishing spots, validate transactions, bear host blockchain gas costs
  • Rewards: Base MATE rewards + user priority fees + service-specific rewards

Gasless Architecture​

  • User Experience: Pay zero main fees, optional priority fees for speed
  • Service Model: Services stake MATE tokens → earn rewards → cover operation costs
  • Fisher Incentives: Base rewards ensure fisher participation even with zero priority fees

Token System​

  • Principal Token: MATE - core ecosystem token for rewards and staking
  • Multi-Token Support: Services can accept any token, not just MATE
  • Abstractions: Internal token representations, not separate smart contracts

Advanced Concepts​

Fishing Spots​

  • Public Mempools: Broadcast to Ethereum/Arbitrum mempools with low gas
  • Private APIs: Direct submission to fisher-operated endpoints
  • Any Medium: Radio waves, messaging systems, any data transmission channel

Nonce Management​

  • Sync Nonces: Sequential, automatic increment (like traditional Ethereum)
  • Async Nonces: User-defined, flexible ordering, replay protection
  • Dual Systems: Service nonces + EVVM payment nonces operate independently

Treasury Bridge​

  • Deposits: Move ERC-20 tokens from host blockchain → EVVM virtual blockchain
  • Withdrawals: Move tokens from EVVM → host blockchain (except principal token)
  • Direct Execution: No fishers needed, users interact directly with Treasury

Hack Ideas​

DeFi & Finance​

  • Gasless DEX with zero trading fees (fishers earn from staking)
  • Prediction Markets with username integration
  • Lending Protocols with automatic liquidation rewards
  • Yield Farming with MATE token incentives

Gaming & Social​

  • On-Chain Games with gasless transactions
  • Social Networks with username-based identities
  • NFT Marketplaces with abstract blockchain benefits
  • Reputation Systems leveraging staking mechanisms

Infrastructure & Tools​

  • Cross-Chain Bridges using Fisher Bridge architecture
  • DAO Governance with time-delayed staking proposals
  • Identity Verification extending NameService functionality
  • EIP Testing Ground for experimental Ethereum features

Novel Use Cases​

  • IoT Payments using radio wave fishing spots
  • Micropayment Channels with zero-amount transactions
  • Decentralized APIs with fisher-based execution
  • Virtual Machine Hosting on abstract blockchain infrastructure

Quick Resources​