Skip to content

Added complete EVM smart contract for Seifylabs#3

Open
an-ordinary-dev wants to merge 1 commit intosaas98:mainfrom
an-ordinary-dev:add-evm-smart-contract
Open

Added complete EVM smart contract for Seifylabs#3
an-ordinary-dev wants to merge 1 commit intosaas98:mainfrom
an-ordinary-dev:add-evm-smart-contract

Conversation

@an-ordinary-dev
Copy link
Copy Markdown

This PR includes a full EVM-based smart contract implementation for Seifylabs.

Developed by Byteory – a Web3 development agency focused on building secure, scalable, and audited smart contracts for blockchain products.

The contract handles following features and is written with modularity and security best practices in mind.

Ethereum Escrow Contract Documentation

Deployment Details

  • Contract Address: 0x6d595ea477ed54e98C73bF97deDCEB34d187bF11
  • Network: Holesky Testnet
  • Deployer Address: 0xa719931d7A0e50428Be28240A09f053e14f1371F
  • Solidity Version: 0.8.19

Initial Parameters

  • Fee Percentage: 1% (100 basis points)
  • Minimum Escrow Amount: 0.01 ETH
  • Maximum Escrow Amount: 100 ETH
  • Maximum Disputes per Escrow: 3
  • Dispute Cooldown Period: 1 day (86400 seconds)
  • Maximum Arbitrators: 5
  • Insurance Fee Percentage: 1% (100 basis points)

Contract Features

Core Escrow Functionality

  1. Project Escrow Creation

    • Create escrow agreements with multiple milestones
    • Set buyer, seller, and project details
    • Define milestone amounts and due dates
    • Assign arbitrators for dispute resolution
  2. Milestone Management

    • Track milestone completion status
    • Release milestone payments
    • Update milestone progress
    • Verify milestone completion
  3. Payment Handling

    • Secure fund storage
    • Automatic fee calculation
    • Milestone-based payment release
    • Support for partial payments

Security Features

  1. Access Control

    • OpenZeppelin's Ownable for ownership management
    • Role-based access control for different functions
    • Blacklisting system for malicious users
  2. Safety Mechanisms

    • ReentrancyGuard for preventing reentrancy attacks
    • Pausable functionality for emergency stops
    • Minimum and maximum amount limits
    • Cooldown periods for disputes

Quality Assurance System

  1. Progress Tracking

    • Percentage-based progress updates
    • Progress verification by buyer
    • Detailed progress descriptions
    • Timestamp tracking for updates
  2. Quality Verification

    • QA period after project completion
    • Buyer verification process
    • Pass/fail status tracking
    • Verification time windows

Insurance System

  1. Insurance Pool

    • Deposit and withdrawal functionality
    • Maximum coverage limits
    • Minimum deposit requirements
    • Total deposits and claims tracking
  2. Claim Processing

    • Claim submission system
    • Arbitrator verification
    • Processing time windows
    • Automated claim payments

Dispute Resolution

  1. Dispute Management

    • Multiple arbitrator support
    • Dispute initiation and resolution
    • Cooldown periods
    • Maximum dispute limits
  2. Arbitration System

    • Arbitrator assignment
    • Voting mechanism
    • Resolution tracking
    • Fee distribution

Additional Features

  1. Extension Requests

    • Timeline modification requests
    • Approval/rejection system
    • New deadline setting
    • Request tracking
  2. Revision System

    • Work revision requests
    • Cost adjustment handling
    • Timeline modifications
    • Approval workflow
  3. Cancellation System

    • Cancellation requests
    • Fee calculation
    • Fund distribution
    • Approval process

Contract Events

  1. Project Management Events

    • ProjectEscrowCreated
    • MilestoneCompleted
    • MilestonePaid
  2. Dispute Events

    • DisputeInitiated
    • DisputeResolved
  3. Arbitrator Events

    • ArbitratorAdded
    • ArbitratorRemoved
  4. User Management Events

    • UserBlacklisted
  5. Extension and Revision Events

    • ExtensionRequested
    • ExtensionApproved
    • ExtensionRejected
    • RevisionRequested
    • RevisionApproved
    • RevisionRejected
  6. Quality Assurance Events

    • QualityAssuranceStarted
    • QualityAssurancePassed
    • QualityAssuranceFailed
  7. Insurance Events

    • InsuranceDeposited
    • InsuranceClaimed
    • InsuranceClaimProcessed

Function Modifiers

  • notBlacklisted: Prevents blacklisted users from accessing functions
  • onlyArbitrator: Restricts access to arbitrator functions
  • onlyParties: Limits access to escrow parties
  • nonReentrant: Prevents reentrancy attacks
  • whenNotPaused: Ensures contract is not paused

Dependencies

  • OpenZeppelin Contracts v4.x
    • @openzeppelin/contracts/security/ReentrancyGuard.sol
    • @openzeppelin/contracts/access/Ownable.sol
    • @openzeppelin/contracts/security/Pausable.sol
    • @openzeppelin/contracts/token/ERC20/IERC20.sol

Etherscan Verification

Development Tools

  • Hardhat Development Environment
  • Solidity v0.8.19
  • Ethers.js Library
  • OpenZeppelin Contracts

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 25, 2025

@Byteory is attempting to deploy a commit to the Pavlo's projects Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant