Skip to content

Latest commit

 

History

History
158 lines (129 loc) · 3.8 KB

README.md

File metadata and controls

158 lines (129 loc) · 3.8 KB
Raw

ENS Domain Rental Contract

A smart contract system that enables ENS domain owners to rent out their domains for a specified duration. This contract supports both wrapped (ERC1155) and unwrapped (ERC721) ENS names.

Features

Domain Listing

  • Owners can list their ENS domains for rent
  • Set a price per second in ETH
  • Define a maximum end date for rentals
  • Supports both wrapped and unwrapped ENS domains
  • Automatic handling of domain custody during rental period

Domain Renting

  • Renters can lease domains for any period up to the maximum end date
  • Pay-per-second pricing model
  • Automatic refund of excess payments
  • Instant transfer of ENS name control to renter
  • Protection against rental period overlaps

Safety Features

  • Automatic validation of domain expiry
  • Protection against zero prices
  • Validation of rental end dates
  • Checks for active rental periods
  • Safe handling of both ERC721 and ERC1155 tokens
  • Proper ETH transfer safety checks

Domain Management

  • Lenders can reclaim domains after rental period
  • Recovery mechanism for expired rentals
  • Automatic return of domain control
  • Clear rental terms tracking

Ideas

  • Rental ownership through NFT
  • Protocol fees
  • Dynamic auction parameters

Technical Details

Contract Architecture

The system consists of three main components:

  1. Base Registrar Interface (ERC721)
  2. Name Wrapper Interface (ERC1155)
  3. ENS Registry Interface

Commands

Lend and Borrow

Change the domain name in the script to the desired domain and set the private key in the .env file.

forge script script/lendAndBorrow.s.sol \
    --rpc-url sepolia \
    -vvvvv \
    --chain 11155111 \
    --verify \
    --broadcast \
    --slow

Key Structs

struct RentalTerms {
    address lender;          // Domain owner
    uint256 pricePerSecond;  // Rental price in wei/second
    uint256 maxEndTimestamp; // Maximum rental end date
    address currentBorrower; // Current renter
    uint256 rentalEnd;      // Current rental end time
    bytes32 nameNode;       // ENS node hash
}

Main Functions

List Domain

function listDomain(
    uint256 tokenId,
    uint256 pricePerSecond,
    uint256 maxEndTimestamp,
    bytes32 nameNode
) external

Rent Domain

function rentDomain(
    uint256 tokenId,
    uint256 desiredEndTimestamp
) external payable

Reclaim Domain

function reclaimDomain(
    uint256 tokenId
) external

Events

event DomainListed(uint256 indexed tokenId, address indexed lender, uint256 pricePerSecond, uint256 maxEndTimestamp, bytes32 nameNode);
event DomainRented(uint256 indexed tokenId, address indexed borrower, uint256 rentalEnd, uint256 totalPrice);
event DomainReclaimed(uint256 indexed tokenId, address indexed lender);

Error Handling

The contract includes custom errors for better gas efficiency and clearer error messages:

  • ZeroPriceNotAllowed()
  • MaxEndTimeMustBeFuture()
  • MaxEndTimeExceedsExpiry()
  • DomainNotListed()
  • ExceedsMaxEndTime()
  • And more...

Usage Examples

List a Domain for Rent

// List domain for 0.0001 ETH per second until Dec 31, 2024
contract.listDomain(
    tokenId,
    100000000000000, // 0.0001 ETH in wei
    1735689600,      // Dec 31, 2024
    nameNode
);

Rent a Domain

// Rent domain until Nov 1, 2024
contract.rentDomain{value: 1 ether}(
    tokenId,
    1698796800  // Nov 1, 2024
);

Security Considerations

  • Contract holds ENS domains during rental periods
  • Implements reentrancy protection
  • Safe ETH transfer handling
  • Proper access control for domain operations
  • Validation of all time-based parameters
  • Protection against rental overlap

Dependencies

  • OpenZeppelin Contracts
    • ERC721Holder
    • ERC1155Holder

License

MIT License