{"id":30621364,"url":"https://github.com/syscoin/sysethereum-contracts","last_synced_at":"2025-08-30T14:28:55.795Z","repository":{"id":38793590,"uuid":"172771295","full_name":"syscoin/sysethereum-contracts","owner":"syscoin","description":"Syscoin \u003c=\u003e Ethereum bridge smart contracts","archived":false,"fork":false,"pushed_at":"2025-03-13T18:47:01.000Z","size":23446,"stargazers_count":17,"open_issues_count":17,"forks_count":19,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-13T19:42:07.137Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://bridge.syscoin.org","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/syscoin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-26T18:58:30.000Z","updated_at":"2024-08-29T01:24:23.000Z","dependencies_parsed_at":"2023-02-06T11:46:04.491Z","dependency_job_id":"f235fcd4-d166-4133-9192-d1cc7c7c35fa","html_url":"https://github.com/syscoin/sysethereum-contracts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/syscoin/sysethereum-contracts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syscoin%2Fsysethereum-contracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syscoin%2Fsysethereum-contracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syscoin%2Fsysethereum-contracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syscoin%2Fsysethereum-contracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/syscoin","download_url":"https://codeload.github.com/syscoin/sysethereum-contracts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syscoin%2Fsysethereum-contracts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272860688,"owners_count":25005476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-30T14:28:08.247Z","updated_at":"2025-08-30T14:28:55.790Z","avatar_url":"https://github.com/syscoin.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"**Sysethereum** – NEVM Contracts for the Syscoin \u003c=\u003e NEVM Bridge\n\n[![Build Status](https://travis-ci.com/syscoin/sysethereum-contracts.svg?branch=master)](https://travis-ci.com/syscoin/sysethereum-contracts)\n\n---\n\n## Table of Contents\n\n1. [Introduction](#introduction)\n2. [Architecture \u0026 Core Components](#architecture--core-components)\n3. [Prerequisites \u0026 Installation](#prerequisites--installation)\n4. [Running the Tests](#running-the-tests)\n5. [Deployment](#deployment)\n\n---\n\n## Introduction\n\n**Sysethereum** is a set of smart contracts on the [NEVM (Syscoin’s EVM layer)](https://syscoin.org) that implements a _decentralized_ bridge between the **Syscoin UTXO blockchain** and the **NEVM**. It allows assets (Syscoin Platform Tokens or plain SYS) to move seamlessly between the two worlds.\n\n---\n\n## Architecture \u0026 Core Components\n\n### SyscoinRelay\n\n- `SyscoinRelay.sol` is responsible for:\n  - Verifying Syscoin blocks, transactions, and **Merkle proofs** on the NEVM side.\n  - Informing the Vault Manager (`SyscoinVaultManager.sol`) when a Syscoin transaction has locked or unlocked funds on the UTXO chain.\n\n### SyscoinVaultManager\n\n- `SyscoinVaultManager.sol` is responsible for:\n  - **Holding deposits** or transferring tokens on the NEVM side.\n  - Minting or transferring tokens when coins are locked on Syscoin UTXO side (UTXO -\u003e NEVM).\n  - Burning or locking tokens on NEVM when coins move back to Syscoin (NEVM -\u003e UTXO).\n  - Potential bridging for **ERC20**, **ERC721**, **ERC1155**, or native SYS.\n\n### SyscoinMessageLibrary / SyscoinParser\n\n- A library used to parse and handle Syscoin transaction bytes, block headers, merkle proofs, etc.\n- Provides functions like `parseVarInt`, `parseCompactSize`, and big-endian / little-endian conversions.\n\n### Additional Contracts\n\n- **Test Mocks** (e.g., `MockERC20.sol`, `MockERC721.sol`, `MockERC1155.sol`) – used to test bridging flows in local test environments.\n- **MaliciousReentrant** – a test contract that verifies the bridge’s `nonReentrant` safety.\n\n---\n\n## Prerequisites \u0026 Installation\n\n### 1. System Requirements\n\n- **Node.js** v16 or later\n- **NPM** or **Yarn** – for installing JavaScript dependencies\n- **Hardhat** - for development, testing, and deployment\n\n### 2. Cloning the Repository\n\n```bash\ngit clone https://github.com/syscoin/sysethereum-contracts.git\ncd sysethereum-contracts\n```\n\n### 3. Install Dependencies\n\n```bash\nnpm install\n```\n\n## Development\n\n### 1. Compile Contracts\n\n```bash\nnpx hardhat clean\nnpx hardhat compile\n```\n\n### 2. Running a Local Node\n\n```bash\n# Start a local Hardhat node\nnpx hardhat node\n```\n\n### 3. Run Tests (must deploy local node first)\n\n```bash\n# Run all tests\nnpx hardhat test\n\n```\n\n## Deployment\n\n### 1. Local Deployment\n\n```bash\n# Deploy to local Hardhat network\nnpx hardhat run scripts/deploy.ts --network localhost\n```\n\n### 2. Syscoin Mainnet Deployment\n\n```bash\n# Set your seed in .env file first\n# MNEMONIC=your_seed_phrase_here\n\n# Deploy and verify Syscoin mainnet\nnpx hardhat run scripts/deploy.ts --network syscoin\nnpx hardhat verify scripts/verify.ts --network syscoin\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyscoin%2Fsysethereum-contracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyscoin%2Fsysethereum-contracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyscoin%2Fsysethereum-contracts/lists"}