Skip to main content

Introduction to the Name Service

The Name Service is a comprehensive decentralized identity and username management system built on the EVVM ecosystem. It provides users with human-readable usernames that can be used across the entire platform, along with rich metadata capabilities and a built-in marketplace for username trading.

Core Features​

Username Registration System​

  • Pre-registration Protection: Commit-reveal scheme prevents front-running attacks during registration
  • Dynamic Pricing: Registration costs scale with network activity (100x current EVVM reward amount)
  • Expiration Management: Usernames have expiration dates and can be renewed to maintain ownership

Custom Metadata Management​

  • Schema-Based Storage: Structured metadata follows standardized formats for interoperability
  • Flexible Data Types: Support for social media links, contact information, organization memberships, and custom fields
  • Individual Management: Add, remove, or flush all metadata entries independently

Username Marketplace​

  • Offer System: Users can make offers on existing usernames with time-based expiration
  • Direct Trading: Username owners can accept offers to transfer ownership
  • Fee Structure: 0.5% marketplace fee on successful transactions

Time-Delayed Governance​

  • Administrative Security: All admin functions require 1-day time delays for execution
  • Proposal System: Changes must be proposed, then accepted after the waiting period
  • Cancellation Rights: Pending proposals can be cancelled before execution

Registration Process​

The registration system uses a secure three-step process to prevent front-running and ensure fair access:

1. Pre-Registration Phase​

preRegistrationUsername(user, hashedUsername, nonce, signature, ...)
  • Commit to a username by submitting its hash
  • Prevents others from seeing your intended username
  • 30-minute window to complete full registration
  • Costs the full registration fee upfront

2. Registration Phase​

registrationUsername(user, username, salt, nonce, signature, ...)
  • Reveal the actual username and salt used in hashing
  • Must be completed within 30 minutes of pre-registration
  • Username becomes active and owned by the registrant
  • Any unused funds from pre-registration are refunded

3. Management Phase​

Once registered, users can:

  • Add custom metadata to their username
  • Manage incoming offers from other users
  • Renew their username before expiration
  • Transfer ownership through the marketplace

Security Architecture​

Signature Verification​

All operations require cryptographic signatures using EIP-191 standard:

  • User Authorization: Each action must be signed by the username owner
  • Replay Protection: Nonce-based system prevents transaction replay attacks
  • Message Integrity: Signatures cover all critical parameters

Payment Integration​

Secure integration with the EVVM core contract:

  • Principal Token Payments: All fees paid in the network's primary token
  • Priority Fees: Optional fees for faster transaction processing
  • Reward Distribution: Executors receive rewards for processing transactions

Execution Methods​

The Name Service supports two distinct methods for executing functions:

Direct Execution​

  • User-Initiated: Users interact directly with the Name Service contract
  • Immediate Processing: Transactions are submitted directly to the blockchain
  • Self-Service: Users manage their own transaction timing and gas costs
  • Full Control: Complete autonomy over transaction 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 timing
  • Reward Sharing: Fishers receive portions of fees for their execution services
  • Enhanced Efficiency: Potential for better gas optimization and batching

Time-Lock Security​

Administrative functions use time-delayed execution:

  • Proposal Period: 1-day waiting period for all administrative changes
  • Transparency: All changes are visible before execution
  • Emergency Controls: Proposals can be cancelled during the waiting period

Economic Model​

Registration Costs​

  • Base Fee: 100x current EVVM reward amount
  • Dynamic Pricing: Scales with network reward structure
  • Market Responsive: Adjusts to network conditions automatically

Metadata Operations​

  • Add Metadata: 10x current EVVM reward amount per entry
  • Remove Metadata: 10x current EVVM reward amount per entry
  • Flush All Metadata: 10x reward amount per existing entry

Renewal Pricing​

  • Time-Based: Earlier renewals cost less than last-minute renewals
  • Market Demand: Pricing adapts based on network activity
  • Expiration Protection: Grace periods and renewal incentives

Marketplace Economics​

  • Trading Fee: 0.5% of transaction value
  • Offer Management: Small fees for offer creation and withdrawal
  • Revenue Sharing: Executors receive portions of fees as rewards

Integration with EVVM​

Payment Processing​

  • Unified Token System: All payments use principal tokens through EVVM
  • Staker Rewards: sMATE stakers receive priority and reward distributions
  • Fee Collection: Automatic routing of fees to appropriate recipients

Reward Distribution​

  • Executor Incentives: Transaction processors receive reward payments
  • Proportional Rewards: Rewards scale with work performed
  • Priority Processing: Higher fees enable faster transaction execution

Cross-Contract Security​

  • Shared Nonce System: Prevents replay attacks across the ecosystem
  • Address Validation: Ensures compatibility with EVVM address formats
  • State Synchronization: Maintains consistency with core EVVM operations

Use Cases​

Individual Users​

  • Digital Identity: Establish a recognizable username across the platform
  • Profile Management: Add social media links, contact info, and credentials
  • Asset Trading: Buy, sell, or trade valuable usernames

Organizations​

  • Brand Protection: Register and protect organizational usernames
  • Team Management: Assign usernames to team members or departments
  • Public Presence: Maintain verified organizational identity

Developers​

  • Integration APIs: Build applications using Name Service identities
  • Metadata Standards: Implement standardized user profile systems
  • Marketplace Tools: Create trading interfaces and analytical tools

Technical Architecture​

Smart Contract Design​

  • Modular Functions: Separate contracts for different functionality areas
  • Upgrade Safety: Time-locked governance prevents immediate changes
  • Gas Optimization: Efficient operations for common use cases

Data Storage​

  • On-Chain Metadata: All usernames and metadata stored on blockchain
  • Efficient Indexing: Optimized data structures for quick lookups
  • Scalable Design: Architecture supports growing user base

Event System​

  • Comprehensive Logging: All operations emit detailed events
  • Integration Support: Events enable external system integration
  • Audit Trail: Complete history of all username operations

The Name Service represents a foundational layer for decentralized identity within the EVVM ecosystem, providing the infrastructure for human-readable addresses, rich profile information, and secure username trading.