Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mujeebsulayman/cross-chain-bridge-explorer-with-across-protocol
https://github.com/mujeebsulayman/cross-chain-bridge-explorer-with-across-protocol
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/mujeebsulayman/cross-chain-bridge-explorer-with-across-protocol
- Owner: MujeebSulayman
- Created: 2024-12-11T19:23:00.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-12T14:25:41.000Z (about 1 month ago)
- Last Synced: 2024-12-12T15:32:22.344Z (about 1 month ago)
- Language: Solidity
- Size: 66.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hemswap Cross-Chain Bridge
## Overview
A secure, efficient cross-chain token bridge built on Across Protocol's infrastructure, enabling seamless asset transfers across multiple blockchain networks.
## Key Features
- 🌉 Multi-Chain Token Transfers
- 🔒 Advanced Security Mechanisms
- 📊 Comprehensive Transfer Tracking
- 💸 Dynamic Fee Calculation
## Architecture Components
### Core Infrastructure
- **Across Protocol Integration**
- Leverages Across Protocol's V3 Core Router
- Seamless cross-chain transfer execution
- Automatic liquidity management
### Transfer Mechanism
- Unique transfer ID generation
- Detailed transfer metadata tracking
- Cross-chain transfer execution with status tracking
## Transfer Tracking
Transfer statuses:
- `INITIATED`: Transfer started
- `COMPLETED`: Transfer successful
- `FAILED`: Transfer unsuccessful
### Key Methods
- `getUserTransfers()`: Retrieve user's recent transfers
- `getTransferDetails()`: Get specific transfer details
- `getTotalTransfers()`: Get total number of bridge transfers
## Security Features
- SafeERC20 token handling
- ReentrancyGuard protection
- Ownership-based access control
- Comprehensive input validation
## Fee Management
- Dynamic fee calculation via Across Protocol Core Router
- Estimated fee calculation through `getEstimatedBridgeFee()`
## Deployment Requirements
- Solidity 0.8.19
- OpenZeppelin Contracts
- Across Protocol Interfaces
### Required Environment Variables
- `PRIVATE_KEY`: Deployment wallet private key
- `ACROSS_CORE_ROUTER`: Across Protocol Core Router address
- `ACROSS_SPOKE_POOL`: Spoke Pool contract address
## Deployment
```bash
npx hardhat deploy --network [target_network]
```
## Testing
```bash
npx hardhat test
```
## Supported Networks
- Ethereum Mainnet
- Arbitrum
- Optimism
## Disclaimer
Experimental implementation. Use at your own risk.
## License
MIT License
## Author
[Mujeeb Sulayman](https://x.com/thehemjay)