{"id":26048927,"url":"https://github.com/exploring-solver/enobridge","last_synced_at":"2025-03-08T00:53:50.917Z","repository":{"id":278703194,"uuid":"936485265","full_name":"exploring-solver/EnoBridge","owner":"exploring-solver","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-21T07:40:32.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-21T08:29:12.654Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/exploring-solver.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":"2025-02-21T07:00:52.000Z","updated_at":"2025-02-21T07:40:36.000Z","dependencies_parsed_at":"2025-02-21T08:41:27.122Z","dependency_job_id":null,"html_url":"https://github.com/exploring-solver/EnoBridge","commit_stats":null,"previous_names":["exploring-solver/enobridge"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exploring-solver%2FEnoBridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exploring-solver%2FEnoBridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exploring-solver%2FEnoBridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exploring-solver%2FEnoBridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exploring-solver","download_url":"https://codeload.github.com/exploring-solver/EnoBridge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242483356,"owners_count":20135788,"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":[],"created_at":"2025-03-08T00:53:50.308Z","updated_at":"2025-03-08T00:53:50.898Z","avatar_url":"https://github.com/exploring-solver.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cross-Chain Asset Transfer System\n\n## Overview\nThis project implements a **Cross-Chain Asset Transfer System** where assets can be locked on one blockchain and minted as a representation on another. The system consists of smart contracts deployed on two test networks (**LocalAmoy** and **LocalSepolia**) that enable the secure transfer of ERC20 tokens and NFTs between chains.\n\nThe system ensures:\n- **Security**: Assets are locked before being minted on the other chain.\n- **Transparency**: Users can verify all transactions on the blockchain.\n- **Proof-of-Transfer**: The transfer process is traceable on both chains.\n\n## Project Setup and Installation\n\n### Prerequisites\n- **Node.js** (\u003e=16.x)\n- **Hardhat** (Ethereum development framework)\n- **Metamask** (for interacting with test networks)\n- **Ganache** (optional for local blockchain simulation)\n\n### Installation\n```sh\n# Clone the repository\ngit clone https://github.com/exploring-solver/iitkcyberhack.git\ncd cross-chain-transfer\n\n# Install dependencies\nnpm install\n```\n\n### Hardhat Local Blockchain Setup\nRun two separate local blockchain nodes on different ports:\n```sh\nnpx hardhat node --port 8545 # LocalAmoy\nnpx hardhat node --port 8546 # LocalSepolia\n```\n\n## Deploy Smart Contracts\n### Deploy on LocalAmoy\n```sh\nnpx hardhat run scripts/deployAmoy.js --network localAmoy\n```\n### Deploy on LocalSepolia\n```sh\nnpx hardhat run scripts/deploySepolia.js --network localSepolia\n```\n\n## ERC20 Token Transfer Steps\n### Step 1: Lock Tokens on LocalAmoy\n```sh\nnpx hardhat console --network localAmoy\n```\n```js\nconst token = await ethers.getContractAt(\"ERC20\", \"\u003clocalAmoy token address\u003e\");\nconst bridge = await ethers.getContractAt(\"BridgeAmoy\", \"\u003clocalAmoy bridge address\u003e\");\nawait token.approve(bridge.target, ethers.parseEther(\"10\"));  \nawait bridge.lock(ethers.parseEther(\"10\"));\nconst balance = await token.balanceOf(\"\u003cyour_address\u003e\");\nconsole.log(`Sender's balance on LocalAmoy: ${ethers.formatEther(balance)}`);\n```\n\n### Step 2: Release Tokens on LocalSepolia\n```sh\nnpx hardhat console --network localSepolia\n```\n```js\nconst bridge = await ethers.getContractAt(\"BridgeSepolia\", \"\u003clocalSepolia bridge address\u003e\");\nawait bridge.release(\"\u003cyour_address\u003e\", ethers.parseEther(\"10\"));\nconst token = await ethers.getContractAt(\"ERC20\", \"\u003clocalSepolia token address\u003e\");\nconst balance = await token.balanceOf(\"\u003cyour_address\u003e\");\nconsole.log(`Receiver's balance on LocalSepolia: ${ethers.formatEther(balance)}`);\n```\n\n### Step 3: Burn Tokens on LocalSepolia\n```sh\nnpx hardhat console --network localSepolia\n```\n```js\nawait token.approve(bridge.target, ethers.parseEther(\"10\"));\nawait bridge.burn(ethers.parseEther(\"10\"));\nconst balance = await token.balanceOf(\"\u003cyour_address\u003e\");\nconsole.log(`Sender's balance on LocalSepolia: ${ethers.formatEther(balance)}`);\n```\n\n### Step 4: Unlock Tokens on LocalAmoy\n```sh\nnpx hardhat console --network localAmoy\n```\n```js\nawait bridge.unlock(\"\u003cyour_address\u003e\", ethers.parseEther(\"10\"));\nconst balance = await token.balanceOf(\"\u003cyour_address\u003e\");\nconsole.log(`Receiver's balance on LocalAmoy: ${ethers.formatEther(balance)}`);\n```\n\n## NFT Transfer Steps\n### Step 1: Deploy NFT Contracts\n#### Deploy on LocalAmoy\n```sh\nnpx hardhat run scripts/deployAmoyNFT.js --network localAmoy\n```\n#### Deploy on LocalSepolia\n```sh\nnpx hardhat run scripts/deploySepoliaNFT.js --network localSepolia\n```\n\n### Step 2: Mint and Lock NFT on LocalAmoy\n```sh\nnpx hardhat console --network localAmoy\n```\n```js\nconst nft = await ethers.getContractAt(\"NativeNFT\", \"\u003clocalAmoy NFT address\u003e\");\nconst bridge = await ethers.getContractAt(\"BridgeAmoyNFT\", \"\u003clocalAmoy bridge address\u003e\");\nconst [signer] = await ethers.getSigners();\nconst userAddress = await signer.getAddress();\nawait bridge.mint(userAddress); // Mint NFT with ID 1\nconst tokenId = 1;\nawait nft.approve(bridge.target, tokenId);\nawait bridge.lock(tokenId);\nconst owner = await nft.ownerOf(tokenId);\nconsole.log(`NFT ${tokenId} owner on LocalAmoy: ${owner}`);\n```\n\n### Step 3: Release Wrapped NFT on LocalSepolia\n```sh\nnpx hardhat console --network localSepolia\n```\n```js\nconst bridge = await ethers.getContractAt(\"BridgeSepoliaNFT\", \"\u003clocalSepolia bridge address\u003e\");\nawait bridge.release(userAddress, tokenId);\nconst wrappedNFT = await ethers.getContractAt(\"WrappedNFT\", \"\u003clocalSepolia Wrapped NFT address\u003e\");\nconst newOwner = await wrappedNFT.ownerOf(tokenId);\nconsole.log(`Wrapped NFT ${tokenId} owner on LocalSepolia: ${newOwner}`);\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexploring-solver%2Fenobridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexploring-solver%2Fenobridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexploring-solver%2Fenobridge/lists"}