# EVVM Documentation

> Complete technical documentation for EVVM (Ethereum Virtual Virtual Machine) - Infraless EVM Virtualization solving Scalability and Chain Fragmentation

EVVM enables virtual blockchains on top of host blockchains without physical infrastructure management.

Key concepts:
- Virtual Blockchain Infrastructure: Deploy blockchains without managing validators or nodes
- Gasless Transactions: Users sign messages, Fishers execute on-chain
- Fisher Network: Operators who execute transactions and earn MATE token rewards
- EIP-191 Signatures: All operations use cryptographic signatures for authorization

Production URL: https://www.evvm.info
Full documentation for AI agents: https://www.evvm.info/agent.md

## Table of Contents

- [EVVM Core Contract Overview](https://evvm.info/docs/Contracts/EVVM/Overview): Overview of the EVVM Core Contract's payment processing, signature verification, nonce management, and treasury operations
- [Nonce Types in EVVM](https://evvm.info/docs/Contracts/EVVM/NonceTypes): Detailed explanation of the centralized sync and async nonce mechanisms managed by Core.sol for the entire EVVM ecosystem.
- [Signature & Nonce Management](https://evvm.info/docs/Contracts/EVVM/SignatureAndNonceManagement): Centralized signature verification and nonce management system for EVVM services
- [pay Function](https://evvm.info/docs/Contracts/EVVM/PaymentFunctions/pay): Detailed documentation of the EVVM Core Contract's primary single payment processing function.
- [batchPay Function](https://evvm.info/docs/Contracts/EVVM/PaymentFunctions/batchPay): Detailed documentation of the EVVM Core Contract's batch payment processing function with individual success/failure tracking.
- [dispersePay Function](https://evvm.info/docs/Contracts/EVVM/PaymentFunctions/dispersePay): Detailed documentation of the EVVM Core Contract's multi-recipient payment distribution function with staker rewards.
- [caPay Function](https://evvm.info/docs/Contracts/EVVM/PaymentFunctions/caPay): Detailed documentation of the EVVM Core Contract's contract-to-address payment function for authorized smart contracts.
- [disperseCaPay Function](https://evvm.info/docs/Contracts/EVVM/PaymentFunctions/disperseCaPay): Detailed documentation of the EVVM Core Contract's contract-to-multiple-addresses payment distribution function for authorized smart contracts.
- [Getter Functions](https://evvm.info/docs/Contracts/EVVM/Getters): Comprehensive documentation of all getter functions available in the EVVM Core Contract for retrieving system state and configuration.
- [Administrative Functions](https://evvm.info/docs/Contracts/EVVM/AdminFunctions): Detailed documentation of the EVVM Core Contract's administrative functions for system configuration, governance, and access control.
- [Identity Resolution Functions](https://evvm.info/docs/Contracts/EVVM/IdentityResolution): Detailed documentation of the EVVM Core Contract's identity resolution system and NameService integration.
- [Economic System Functions](https://evvm.info/docs/Contracts/EVVM/EconomicSystem): Comprehensive documentation of the EVVM Core Contract's economic system, including tokenomics, reward distribution, and era transition mechanisms.
- [Staking Integration Functions](https://evvm.info/docs/Contracts/EVVM/StakingIntegration): Comprehensive documentation of the EVVM Core Contract's staking integration functions for managing staker status, privileges, and rewards.
- [Proxy Management Functions](https://evvm.info/docs/Contracts/EVVM/ProxyManagement): Detailed documentation of the EVVM Core Contract's proxy management functions for implementation upgrades and proxy operations.
- [Treasury Functions](https://evvm.info/docs/Contracts/EVVM/TreasuryFunctions): Detailed documentation of the EVVM Core Contract's treasury functions for authorized balance management operations.
- [Name Service Overview](https://evvm.info/docs/Contracts/NameService/Overview): Decentralized username management system providing human-readable identities across the EVVM ecosystem with built-in marketplace functionality
- [preRegistrationUsername](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/preRegistrationUsername): Username pre-registration using centralized verification via Core.sol
- [registrationUsername](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/registrationUsername): Username registration completion using centralized Core.sol verification
- [makeOffer](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/makeOffer): Create a time-bound marketplace offer to purchase a registered username with locked principal tokens
- [withdrawOffer](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/withdrawOffer): Cancel a marketplace offer and retrieve locked principal tokens back to offeror
- [acceptOffer](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/acceptOffer): Accept a marketplace offer to transfer username ownership and complete the sale
- [renewUsername](https://evvm.info/docs/Contracts/NameService/UsernameFunctions/renewUsername): Extend username registration by 366 days with dynamic pricing based on timing and marketplace demand
- [addCustomMetadata](https://evvm.info/docs/Contracts/NameService/CustomMetadataFunctions/AddCustomMetadata): Add structured custom metadata to usernames using schema-based format for social profiles, contact info, and more
- [removeCustomMetadata](https://evvm.info/docs/Contracts/NameService/CustomMetadataFunctions/RemoveCustomMetadata): Remove a specific custom metadata entry by slot index with automatic array shifting
- [flushCustomMetadata](https://evvm.info/docs/Contracts/NameService/CustomMetadataFunctions/FlushCustomMetadata): Delete all custom metadata entries in a single transaction with batch pricing
- [flushUsername](https://evvm.info/docs/Contracts/NameService/CustomMetadataFunctions/FlushUsername): Permanently delete username and all data, making it available for re-registration
- [Admin Functions](https://evvm.info/docs/Contracts/NameService/AdminFunctions): Detailed documentation of the Name Service Contract's administrative functions for managing admin role transfers, fee withdrawals, and Core contrac...
- [Getter Functions](https://evvm.info/docs/Contracts/NameService/GetterFunctions): View functions for querying Name Service state, user information, pricing details, and administrative data
- [Staking Service Overview](https://evvm.info/docs/Contracts/Staking/Overview): Overview of the EVVM Staking Service architecture and reward system
- [goldenStaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/goldenStaking): Detailed documentation of the EVVM Staking Contract's goldenStaking function for privileged staking operations.
- [presaleStaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/presaleStaking): Detailed documentation of the EVVM Staking Contract's presaleStaking function for presale participant staking operations.
- [publicStaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/publicStaking): Detailed documentation of the EVVM Staking Contract's publicStaking function for universal staking operations.
- [Service Staking Introduction](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/serviceStaking/Introduction): Comprehensive introduction to service staking in the EVVM Staking system, including processes, integration methods, and best practices for smart co...
- [prepareServiceStaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/serviceStaking/prepareServiceStaking): Detailed documentation of the EVVM Staking Contract's prepareServiceStaking function for service staking operations.
- [confirmServiceStaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/serviceStaking/confirmServiceStaking): Detailed documentation of the EVVM Staking Contract's confirmServiceStaking function for service staking operations.
- [serviceUnstaking](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/serviceStaking/serviceUnstaking): Detailed documentation of the EVVM Staking Contract's serviceUnstaking function for service unstaking operations.
- [gimmeYiel](https://evvm.info/docs/Contracts/Staking/StakingContract/StakingFunctions/gimmeYiel): Claim staking rewards (note exact function name spelled `gimmeYiel` in contract).
- [stakingBaseProcess](https://evvm.info/docs/Contracts/Staking/StakingContract/InternalStakingFunctions/stakingBaseProcess): Detailed documentation of the EVVM Staking Contract's internal stakingBaseProcess function for core staking logic.
- [Administrative Functions](https://evvm.info/docs/Contracts/Staking/StakingContract/AdminFunctions): Staking contract administrative functions with time-delayed governance for managing critical contract parameters and roles
- [makeCaPay](https://evvm.info/docs/Contracts/Staking/StakingContract/makeCaPay): Internal function providing a streamlined interface for contract-to-contract payment operations through the EVVM contract's caPay function
- [requestPay](https://evvm.info/docs/Contracts/Staking/StakingContract/makePay): Internal function facilitating payment processing through EVVM with automatic routing to synchronous or asynchronous execution paths
- [Getter Functions](https://evvm.info/docs/Contracts/Staking/StakingContract/Getters): View functions for querying staking contract state, user history, and configuration
- [History and Time Lock System](https://evvm.info/docs/Contracts/Staking/StakingContract/HistoryAndTimeLocks): Comprehensive history tracking system and time-based restrictions ensuring fair and secure staking operations
- [notifyNewEpoch](https://evvm.info/docs/Contracts/Staking/Estimator/notifyNewEpoch): Detailed documentation of the EVVM Staking Contract's notifyNewEpoch function for initializing new reward distribution epochs.
- [makeEstimation](https://evvm.info/docs/Contracts/Staking/Estimator/makeEstimation): Detailed documentation of the EVVM Staking Contract's makeEstimation function for calculating and distributing epoch-based staking rewards.
- [Admin Functions](https://evvm.info/docs/Contracts/Staking/Estimator/AdminFunctions): Detailed documentation of the EVVM Estimator Contract's administrative functions for managing critical contract addresses with time-delayed governa...
- [simulteEstimation](https://evvm.info/docs/Contracts/Staking/Estimator/simulteEstimation): Detailed documentation of the EVVM Estimator Contract's simulteEstimation function for previewing epoch rewards before claiming.
- [Getters](https://evvm.info/docs/Contracts/Staking/Estimator/Getters): Documentation of all getter functions in the EVVM Estimator Contract for retrieving epoch and administrative metadata.
- [Treasury System Overview](https://evvm.info/docs/Contracts/Treasury/Overview): Overview of the Treasury system enabling secure asset movement between external blockchains and the EVVM ecosystem
- [Simple Treasury Overview](https://evvm.info/docs/Contracts/Treasury/TreasurySimple/Overview): Single-chain treasury for direct asset deposit and withdrawal within the EVVM ecosystem using standard blockchain transactions
- [Deposit Function](https://evvm.info/docs/Contracts/Treasury/TreasurySimple/deposit): Detailed documentation of the Treasury Contract's deposit function for transferring host chain coins or ERC20 tokens into the EVVM virtual blockchain.
- [Withdraw Function](https://evvm.info/docs/Contracts/Treasury/TreasurySimple/withdraw): Detailed documentation of the Treasury Contract's withdraw function for transferring host chain coins or ERC20 tokens from the EVVM virtual blockch...
- [Crosschain Treasury Overview](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/Overview): Overview of the Crosschain Treasury architecture enabling secure asset transfers between EVVM and external blockchains
- [withdraw](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/HostChainStation/withdraw): Withdraw tokens from EVVM balance and bridge them to external chains via cross-chain protocols
- [fisherBridgeReceive](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/HostChainStation/fisherBridgeReceive): Receives Fisher bridge transactions from external chains and credits EVVM balances
- [fisherBridgeSend](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/HostChainStation/fisherBridgeSend): Processes Fisher bridge token transfers from host chain to external chains
- [External Chain Address Management](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/HostChainStation/setExternalChainAddress): Time-delayed proposal system for configuring external chain station addresses across cross-chain protocols
- [Admin Functions](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/HostChainStation/AdminFunctions): Administrative functions for Treasury Host Chain Station with time-delayed governance
- [depositERC20](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/depositERC20): Deposit ERC20 tokens to host chain via cross-chain protocols
- [depositCoin](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/depositCoin): Deposit native coins to host chain via selected cross-chain protocol with fee coverage
- [fisherBridgeReceive](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/fisherBridgeReceive): Receives and validates Fisher bridge transactions from host chain on external chains
- [fisherBridgeSendERC20](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/fisherBridgeSendERC20): Processes Fisher bridge ERC20 token transfers from external chain to host chain
- [fisherBridgeSendCoin](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/fisherBridgeSendCoin): Facilitates native coin transfers from external chain to EVVM through Fisher bridge
- [Admin Functions](https://evvm.info/docs/Contracts/Treasury/TreasuryCrosschain/ExternalChainStation/AdminFunctions): Administrative functions for Treasury External Chain Station with time-delayed governance
- [P2P Swap Contract Overview](https://evvm.info/docs/Contracts/P2PSwap/Overview): Decentralized peer-to-peer token exchange with order book functionality and proportional fee model
- [makeOrder Function](https://evvm.info/docs/Contracts/P2PSwap/OrderFunctions/makeOrder): Create P2P swap orders offering one token in exchange for another
- [cancelOrder Function](https://evvm.info/docs/Contracts/P2PSwap/OrderFunctions/cancelOrder): Cancel P2P swap orders and reclaim locked tokens
- [dispatchOrder Function](https://evvm.info/docs/Contracts/P2PSwap/OrderFunctions/dispatchOrder): Fill P2P swap orders with proportional fee model (partial or full fill)
- [Getter Functions](https://evvm.info/docs/Contracts/P2PSwap/GetterFunctions): Query and information retrieval functions for P2P Swap contract state
- [Administrative Functions](https://evvm.info/docs/Contracts/P2PSwap/AdminFunctions): Time-delayed governance functions for P2P Swap contract administration
- [Testnet Exclusive Functions](https://evvm.info/docs/Contracts/TestnetExclusiveFunctions): Development faucet functions exclusively available in testnet deployments for testing and demonstration purposes
- [EIP-191 Signed Data Standard](https://evvm.info/docs/SignatureStructures/EIP191Specification): Complete specification of EIP-191 Signed Data Standard used for all EVVM signature operations
- [Single Payment Signature Structure](https://evvm.info/docs/SignatureStructures/EVVM/SinglePaymentSignatureStructure): EIP-191 signature format for single payment operations verified by Core.sol
- [Disperse Payment Signature Structure](https://evvm.info/docs/SignatureStructures/EVVM/DispersePaySignatureStructure): EIP-191 signature format for disperse payment operations splitting tokens to multiple recipients
- [Withdrawal Signature Structure](https://evvm.info/docs/SignatureStructures/EVVM/WithdrawalPaymentSignatureStructure): Planned EIP-191 signature format for withdrawal operations from Core.sol balance to external addresses
- [Username Pre-Registration Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/preRegistrationUsernameStructure): EIP-191 signature format for the commit phase of username registration using commit-reveal scheme
- [Registration of username Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/registrationUsernameStructure): EIP-191 signature structure for authorizing the registrationUsername operation, the reveal phase following pre-registration
- [Make Offer Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/makeOfferStructure): EIP-191 signature structure for authorizing makeOffer operations to place offers on registered usernames
- [Withdraw Offer Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/withdrawOfferStructure): EIP-191 signature structure for authorizing withdrawOffer operations to cancel previously placed username offers
- [Accept Offer Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/acceptOfferStructure): EIP-191 signature structure for username owners to authorize acceptOffer operations, transferring ownership
- [Renew Username Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/renewUsernameStructure): EIP-191 signature structure for username owners to authorize renewUsername operations extending registration validity
- [Add Custom Metadata Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/addCustomMetadataStructure): EIP-191 signature structure for username owners to authorize adding custom metadata fields to their identity
- [Remove Custom Metadata Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/removeCustomMetadataStructure): EIP-191 signature structure for username owners to authorize removal of specific custom metadata entries
- [Flush Custom Metadata Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/flushCustomMetadataStructure): EIP-191 signature structure for username owners to authorize removal of all custom metadata entries
- [Flush Username Signature Structure](https://evvm.info/docs/SignatureStructures/NameService/flushUsernameStructure): EIP-191 signature structure for username owners to authorize complete removal of their username registration
- [Standard Staking/Unstaking Signature Structure](https://evvm.info/docs/SignatureStructures/Staking/StandardStakingStructure): EIP-191 signature format for standard staking and unstaking operations verified by Core.sol
- [Fisher Bridge Signature Structure](https://evvm.info/docs/SignatureStructures/Treasury/FisherBridgeSignatureStructure): EIP-191 signature structure for authorizing cross-chain treasury operations through the Fisher Bridge system
- [Make Order Signature Structure](https://evvm.info/docs/SignatureStructures/P2PSwap/MakeOrderSignatureStructure): EIP-191 signature structure for authorizing order creation operations in the P2P swap system
- [Cancel Order Signature Structure](https://evvm.info/docs/SignatureStructures/P2PSwap/CancelOrderSignatureStructure): EIP-191 signature structure for authorizing order cancellation operations in the P2P swap system
- [Dispatch Order Signature Structure](https://evvm.info/docs/SignatureStructures/P2PSwap/DispatchOrderSignatureStructure): EIP-191 signature structure for authorizing order fulfillment operations in the P2P swap system
- [EVVM Signature Structures Overview](https://evvm.info/docs/SignatureStructures/Overview): Centralized signature architecture for all EVVM operations
- [Overview](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/introduction): JavaScript/TypeScript client library for EVVM
- [Custom Services](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/custom): Documentation for creating custom services
- [Core Service](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/evvm): Documentation for the Core service in evvm-js.
- [Services Overview](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/): How to use services in evvm-js
- [NameService](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/nameService): Documentation for the NameService in evvm-js.
- [P2PSwap Service](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/p2pswap): Documentation for the P2PSwap service in evvm-js.
- [Staking Service](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/services/staking): Documentation for the Staking service in evvm-js.
- [Signers](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/signers): How to create and use signers with evvm-js
- [Utilities](https://evvm.info/docs/LibrariesAndTools/npmLibraries/evvmJs/utils): Utility helpers included in evvm-js
- [@evvm/testnet-contracts](https://evvm.info/docs/LibrariesAndTools/npmLibraries/testnetContracts): Smart contract interfaces and implementations for EVVM ecosystem integration.
- [Library Overview](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Overview): Complete reference for EVVM utility libraries and service helper contracts
- [EvvmService](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/EvvmService): Complete base contract for building EVVM services with built-in payment processing, service staking, and Core.sol integration
- [Math Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Primitives/Math): Standard mathematical operations with overflow protection based on OpenZeppelin
- [SignatureRecover Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Primitives/SignatureRecover): EIP-191 signature recovery and validation primitives for EVVM message verification
- [IdentityValidation Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Primitives/IdentityValidation): Byte-level validation for usernames, phone numbers, and emails in NameService
- [AdvancedStrings Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/AdvancedStrings): Type conversion utilities for uint256, address, bytes, and bytes32 to string conversions
- [SignatureUtil Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/SignatureUtil): High-level signature verification for EVVM-formatted messages
- [CoreExecution](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/Service/CoreExecution): Abstract contract providing Core.sol payment processing interface
- [StakingServiceUtils](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/Service/StakingServiceUtils): Abstract contract for simplified service staking integration
- [Governance (Admin & ProposalStructs)](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/GovernanceUtils): Time-delayed governance helpers and admin-controlled patterns
- [CoreHashUtils Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/CoreHashUtils): Generates deterministic hashes for Core.sol payment operations in the signature system
- [CAUtils Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/CAUtils): Contract Address verification utilities for distinguishing smart contracts from EOAs
- [PayloadUtils Library](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Utils/PayloadUtils): ABI encoding/decoding utility for cross-chain transfer payloads
- [Erc191TestBuilder](https://evvm.info/docs/LibrariesAndTools/SolidityLibraries/Erc191TestBuilder): Testing utility library for building ERC-191 compliant message hashes for Foundry tests with EVVM's centralized signature architecture
- [EVVM Frontend Tooling](https://evvm.info/docs/LibrariesAndTools/EVVMFrontendTooling): Next.js web application for constructing, signing, and executing EVVM transactions with EIP-191 signature support
- [Overview](https://evvm.info/docs/LibrariesAndTools/EvvmDocker/introduction): Containerized environment for deploying and managing EVVM Testnet Contracts without installing dependencies locally.
- [Quick Start](https://evvm.info/docs/LibrariesAndTools/EvvmDocker/quickstart): Deploy EVVM using Docker in four steps — no local Foundry or Bun installation required.
- [Overview](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/Overview): Local development environment for battle-testing EVVM services before paying testnet or mainnet gas — drop a Solidity file, run one command, get a ...
- [Installation](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/getting-started/installation): Prerequisites (Node, Foundry, Git), the one-time npm install, and how to verify a working scaffold-evvm install.
- [Quickstart](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/getting-started/quickstart): Run the wizard to install dependencies, deploy the protocol contracts, and launch the frontend in a single interactive flow.
- [Troubleshooting](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/getting-started/troubleshooting): Common scaffold-evvm errors — nonce mismatch, port conflicts, deployment failures — and the cli flush reset command.
- [Two-terminal workflow](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/getting-started/two-terminal): Split deployment and frontend across separate terminals for iterative contract development without restarting the UI.
- [Wizard walkthrough](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/getting-started/wizard): Phase-by-phase walkthrough of the wizard — framework choice, source selection, deploy, custom services, frontend launch.
- [Auto-UI](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/custom-services/auto-ui): How the auto-generated service UI renders read panels, write forms (admin, publicAction, publicPay), and a live event tail from your ABI and manifest.
- [Examples](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/custom-services/examples): Bundled Counter (plain contract) and full Tipjar walkthrough (EvvmService with dual-signature flow and the four invariants every service must honor).
- [Folder convention](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/custom-services/folder-convention): Directory layout the wizard expects under services/, constructor-resolution rules, and the optional Deploy.s.sol escape hatch.
- [Manifest](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/custom-services/manifest): Annotate your service functions as admin, publicPay, publicAction, or hidden so the auto-UI groups them and signs the right things.
- [Overview](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/custom-services/overview): The iteration loop for shipping an EVVM service — drop your .sol file, run the wizard, get an auto-deployed contract and auto-generated UI.
- [Config](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/config): Runtime configuration page — change RPC URL, WalletConnect project ID, and display preferences without a redeploy.
- [Faucet](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/faucet): One-click MATE top-up for local development; hidden in non-local environments because it bypasses the standard balance flow.
- [NameService](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/nameservice): Tab-by-tab reference for the username lifecycle — pre-register, register, renew, marketplace offers, custom metadata.
- [Overview](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/overview): Tour of the scaffold-evvm Next.js frontend — one page per EVVM operation, plus the in-browser EVVMScan block explorer.
- [P2P Swap](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/p2pswap): Maker and taker flows for the peer-to-peer order book — post orders, fill them, and read the live order list.
- [Payments](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/payments): Send EVVM tokens between users via pay or dispersePay — pick recipient by address or username, customize executor and nonce.
- [Register](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/register): Bootstrap a fresh EVVM user with an initial balance via Core.addBalance — the alternative to the faucet for local setups.
- [Staking](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/staking): Three staking modes (Golden, Presale, Public) with live estimated-rewards and total-staked tiles per address.
- [Status](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/status): Read-only dashboard for the deployed EVVM stack — contract addresses, admin role, pending proposals, current era, system metadata.
- [Treasury](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/frontend/treasury): Deposit and withdraw ERC-20 tokens between an external chain and the EVVM ledger — no signatures, direct caller balance ops.
- [CLI commands](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/cli/commands): Every cli command — start, init, deploy, chain, config, flush, sources, monitor — and what each one does.
- [npm scripts](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/cli/scripts): Top-level npm scripts the CLI exposes (wizard, frontend, monitor, flush, lint, build) and the environment variables they consume.
- [Address details](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/explorer/address-details): EVVMScan address page — type detection, balances (ETH, MATE, staked), and recent transactions with EVVM-aware direction tagging.
- [Block details](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/explorer/block-details): EVVMScan block page — header (hash, miner, gas, timestamp) plus the full transaction list for that block.
- [Overview](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/explorer/overview): EVVMScan is the in-browser block explorer at /evvmscan — no backend, no indexer, decodes core EVVM contracts and your custom services.
- [Transaction details](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/explorer/transaction-details): EVVMScan transaction page — Overview, Logs, and Input Data tabs with EVVM-aware action descriptions for every standard call.
- [Contract sources](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/architecture/contract-sources): Bundled snapshots of EVVM contracts (testnet and playground) under packages/foundry — what they are, where they come from, when to use which.
- [Monorepo layout](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/architecture/monorepo): Workspace layout (cli, services, foundry, hardhat, nextjs) and how the services directory connects the foundry and nextjs packages.
- [Overview](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/architecture/overview): How scaffold-evvm fits together — the wizard phases, what runs on which port, and the canonical configuration files.
- [FAQ](https://evvm.info/docs/LibrariesAndTools/ScaffoldEvvm/faq): Common questions about scaffold-evvm — framework choice, deployment targets, configuration, custom services, and known limitations.
- [Registry EVVM Contract Overview](https://evvm.info/docs/RegistryEvvm/Overview): Central registry for EVVM deployments across testnets with dual-tier registration and time-delayed governance
- [registerEvvm Function](https://evvm.info/docs/RegistryEvvm/RegistrationFunctions/registerEvvm): Public registration function for registering EVVM deployments on whitelisted testnet chains with automatic ID assignment
- [sudoRegisterEvvm Function](https://evvm.info/docs/RegistryEvvm/RegistrationFunctions/sudoRegisterEvvm): SuperUser registration function for assigning whitelisted EVVM IDs in the reserved range (1-999)
- [proposeSuperUser Function](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/SuperUserGovernance/proposeSuperUser): Initiates time-delayed governance for changing the superUser role with a mandatory 7-day delay
- [rejectProposalSuperUser](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/SuperUserGovernance/rejectProposalSuperUser): Cancels pending superUser change proposals during the governance period
- [acceptSuperUser](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/SuperUserGovernance/acceptSuperUser): Completes the superUser transition after the 7-day acceptance period has elapsed
- [proposeUpgrade](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/UpgradeGovernance/proposeUpgrade): Initiates contract upgrade proposals with a mandatory 7-day time delay before execution
- [rejectProposalUpgrade](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/UpgradeGovernance/rejectProposalUpgrade): Cancels pending upgrade proposals at any time during the governance period
- [acceptProposalUpgrade](https://evvm.info/docs/RegistryEvvm/GovernanceFunctions/UpgradeGovernance/acceptProposalUpgrade): Executes pending upgrade proposals after the 7-day waiting period has elapsed
- [registerChainId](https://evvm.info/docs/RegistryEvvm/AdminFunctions/registerChainId): SuperUser function to register chain IDs to the whitelist, enabling EVVM registration on specific blockchain networks
- [_authorizeUpgrade](https://evvm.info/docs/RegistryEvvm/AdminFunctions/authorizeUpgrade): Internal UUPS authorization function ensuring only authorized parties can upgrade the contract implementation
- [getEvvmIdMetadata](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getEvvmIdMetadata): View function retrieving complete metadata for a specific EVVM ID including chain ID and contract address
- [getWhiteListedEvvmIdActive](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getWhiteListedEvvmIdActive): View function retrieving all active whitelisted EVVM IDs in the reserved range (1-999)
- [getPublicEvvmIdActive](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getPublicEvvmIdActive): View function retrieving all active public EVVM IDs in the public range (1000+)
- [getSuperUserData](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getSuperUserData): View function retrieving complete superUser governance data including current and proposed addresses
- [getSuperUser](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getSuperUser): View function retrieving the current superUser address for the Registry EVVM contract
- [isChainIdRegistered](https://evvm.info/docs/RegistryEvvm/GetterFunctions/isChainIdRegistered): View function checking if a specific chain ID is whitelisted for EVVM registration
- [isAddressRegistered](https://evvm.info/docs/RegistryEvvm/GetterFunctions/isAddressRegistered): View function checking if a specific EVVM address is already registered on a given chain
- [getUpgradeProposalData](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getUpgradeProposalData): View function retrieving complete upgrade proposal governance data including proposed implementation and timeline
- [getVersion](https://evvm.info/docs/RegistryEvvm/GetterFunctions/getVersion): Pure function returning the current version number of the Registry EVVM contract
- [Overview](https://evvm.info/docs/evvmCli/Overview): Overview of the EVVM CLI for deploying, registering, and managing EVVM instances with automated configuration
- [Deploy Command](https://evvm.info/docs/evvmCli/Deploy): Interactive wizard for deploying complete EVVM instances to supported blockchain networks
- [Register Command](https://evvm.info/docs/evvmCli/Register): Register an existing EVVM instance in the official EVVM Registry to receive a unique EVVM ID
- [Help and Version Commands](https://evvm.info/docs/evvmCli/HelpAndVersion): Display CLI information, usage instructions, available commands, and version details
- [SetUp Cross-Chain Treasuries Command](https://evvm.info/docs/evvmCli/SetUpCrossChainTreasuries): Configure bidirectional connections between Host and External treasury stations for cross-chain EVVM instances
- [Developer Command](https://evvm.info/docs/evvmCli/Developer): Developer utilities for generating interfaces, running tests, and other EVVM contract development workflows
- [Install Command](https://evvm.info/docs/evvmCli/Install): Install all EVVM CLI dependencies including contracts, Bun packages, and Foundry libraries
- [Introduction](https://evvm.info/docs/intro): Introduction to EVVM (Ethereum Virtual Virtual Machine), a virtual blockchain system that runs on existing blockchains without requiring infrastruc...
- [QuickStart](https://evvm.info/docs/QuickStart): Step-by-step guide to deploy your EVVM virtual blockchain in minutes using the EVVM CLI
- [Process of a Transaction in EVVM](https://evvm.info/docs/ProcessOfATransaction): Detailed explanation of how transactions are created, signed, broadcast, validated by fishers, and executed in the EVVM ecosystem
- [How to Create an EVVM Service](https://evvm.info/docs/HowToMakeAEVVMService): Tutorial on building gasless smart contract services using EVVM, demonstrated through a coffee shop example
- [EVVM Noncommercial License v1.0](https://evvm.info/docs/EVVMNoncommercialLicense): EVVM software license terms based on PolyForm Noncommercial 1.0.0 with share-alike requirements for noncommercial use