{"id":18794449,"url":"https://github.com/chainstacklabs/evm-blockchain-bridge","last_synced_at":"2025-06-18T10:41:42.716Z","repository":{"id":40122413,"uuid":"467168238","full_name":"chainstacklabs/evm-blockchain-bridge","owner":"chainstacklabs","description":"A simplified blockchain bridge between two EVM compatible networks","archived":false,"fork":false,"pushed_at":"2024-04-10T10:17:54.000Z","size":1283,"stargazers_count":43,"open_issues_count":9,"forks_count":48,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-12-29T16:33:06.297Z","etag":null,"topics":["blockchain","bridge"],"latest_commit_sha":null,"homepage":"https://chainstack.com/how-to-create-blockchain-bridge/","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chainstacklabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-03-07T16:15:36.000Z","updated_at":"2024-12-16T19:09:45.000Z","dependencies_parsed_at":"2024-12-29T16:40:31.396Z","dependency_job_id":null,"html_url":"https://github.com/chainstacklabs/evm-blockchain-bridge","commit_stats":null,"previous_names":["chainstacklabs/evm-blockchain-bridge","chainstacklabs/blockchain-bridge-simplified"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Fevm-blockchain-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Fevm-blockchain-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Fevm-blockchain-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Fevm-blockchain-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chainstacklabs","download_url":"https://codeload.github.com/chainstacklabs/evm-blockchain-bridge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239718478,"owners_count":19685751,"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","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":["blockchain","bridge"],"created_at":"2024-11-07T21:29:28.024Z","updated_at":"2025-02-19T19:21:54.099Z","avatar_url":"https://github.com/chainstacklabs.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1200\" alt=\"Labs\" src=\"https://user-images.githubusercontent.com/99700157/213291931-5a822628-5b8a-4768-980d-65f324985d32.png\"\u003e\n\n\u003cp\u003e\n \u003ch3 align=\"center\"\u003eChainstack is the leading suite of services connecting developers with Web3 infrastructure\u003c/h3\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/build-better-with-ethereum/\"\u003e\u003cimg src=\"https://github.com/soos3d/blockchain-badges/blob/main/protocols_badges/Ethereum.svg\" /\u003e\u003c/a\u003e\u0026nbsp;  \n  \u003ca target=\"_blank\" href=\"https://chainstack.com/build-better-with-bnb-smart-chain/\"\u003e\u003cimg src=\"https://github.com/soos3d/blockchain-badges/blob/main/protocols_badges/BNB.svg\" /\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/build-better-with-polygon/\"\u003e\u003cimg src=\"https://github.com/soos3d/blockchain-badges/blob/main/protocols_badges/Polygon.svg\" /\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/build-better-with-avalanche/\"\u003e\u003cimg src=\"https://github.com/soos3d/blockchain-badges/blob/main/protocols_badges/Avalanche.svg\" /\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/build-better-with-fantom/\"\u003e\u003cimg src=\"https://github.com/soos3d/blockchain-badges/blob/main/protocols_badges/Fantom.svg\" /\u003e\u003c/a\u003e\u0026nbsp;\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  • \u003ca target=\"_blank\" href=\"https://chainstack.com/\"\u003eHomepage\u003c/a\u003e •\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/protocols/\"\u003eSupported protocols\u003c/a\u003e •\n  \u003ca target=\"_blank\" href=\"https://chainstack.com/blog/\"\u003eChainstack blog\u003c/a\u003e •\n  \u003ca target=\"_blank\" href=\"https://docs.chainstack.com/quickstart/\"\u003eChainstack docs\u003c/a\u003e •\n  \u003ca target=\"_blank\" href=\"https://docs.chainstack.com/quickstart/\"\u003eBlockchain API reference\u003c/a\u003e • \u003cbr\u003e \n  • \u003ca target=\"_blank\" href=\"https://console.chainstack.com/user/account/create\"\u003eStart for free\u003c/a\u003e •\n\u003c/p\u003e\n\n# EVM Blockchain bridge simplified\n\n**[You can read the full article for this project in the Chainstack blog](https://chainstack.com/how-to-create-blockchain-bridge/)**\n\nThis project contains multiple pieces to create a functional (although **not production ready**) ERC20 blockchain bridge between two EVM-compatible chains.\n\nIt uses a wallet as an escrow and leverages the events triggered by the ERC20 tokens to burn and mint tokens on each side of the bridge\n\n## Requirements\n\n- Node.js at least v18.15.0— [Install Node](https://nodejs.org/en)\n- You'll need access to nodes in different chains to use this bridge. [Check out the Chainstack docs to learn how to deploy nodes](https://docs.chainstack.com/docs/platform-introduction).\n\n## Build \u0026 Compile\n\nCreate a Metamask wallet and get some tokens for your target networks. This code was tested with Sepolia and BNB testnet. You can get testnet tokens using the [Chainstack Faucet](https://faucet.chainstack.com/sepolia-faucet).\n\nClone the repository.\n\n```sh\ngit clone https://github.com/chainstacklabs/evm-blockchain-bridge.git\n```\n\n### Deploy smart contracts\n\n```sh\ncd solidity\n```\n\nClean install dependencies.\n\n```sh\nnpm ci\n```\n\nRename `/solidity/.env.example` to `/solidity/.env` and fill in the details with your wallet address and the RPC endpoints from your Chainstack dashboard.\n\nTo deploy your contracts, run `npm run deploy:ori` and `npm run deploy:dest`.\n\nYou'll get the contract address in the console.\n\n\u003e You can test the contracts running `npm run test`.\n\n### Front-end\n\nNavigate to the `web` directory.\n\n```sh\ncd .. \u0026\u0026 cd web\n```\n\nClean install dependencies\n\n```sh\nnpm ci\n```\n\nRename `/web/.env.example` to `/web/.env` and fill in the details with your wallet address, RPC endpoints, and token addresses from the deployed smart contracts.\n\nTo build the front end, run `npm run build` inside the `web` directory. You can run the front end locally with `npm run dev` or deploy the generated `dist` folder to any static site hosting.\n\n### Back-end\n\nThe back-end service is required to run the bridge.\n\nNavigate to the `backend` directory.\n\n```sh\ncd .. \u0026\u0026 cd backend\n```\n\nClean install dependencies\n\n```sh\nnpm ci\n```\n\nRename `/backend/.env.example` to `/backend/.env` and fill in the details with your wallet address, RPC endpoints, and token addresses from the deployed smart contracts.\n\nTo start the back-end service, run `npm start`.\n\nOnce the back-end service runs, you can use the front end to send tokens through the bridge.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainstacklabs%2Fevm-blockchain-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainstacklabs%2Fevm-blockchain-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainstacklabs%2Fevm-blockchain-bridge/lists"}