https://github.com/complexlity/arb-bridge
https://github.com/complexlity/arb-bridge
Last synced: 27 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/complexlity/arb-bridge
- Owner: Complexlity
- Created: 2024-06-10T21:15:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-03T09:57:12.000Z (about 1 year ago)
- Last Synced: 2025-04-03T10:37:20.487Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://arb-bridge.vercel.app
- Size: 74.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Farcaster Arb-Bridger
A Farcaster frame application that enables users to bridge ETH between Ethereum, Base, and Arbitrum networks directly from their Farcaster client. Powered by [Across prococol](https://across.to/)
## Features
- Bridge ETH between Ethereum, Base, and Arbitrum networks
- Simple and intuitive interface within Farcaster
- Secure transaction handling using viem
- Real-time transaction status updates
## Architecture
```
├── api/
│ └── index.tsx # Main application entry point
├── public/ # Static assets
├── utils/
│ ├── across.ts # Across Protocol integration
│ └── lib.ts # Shared utilities and constants
├── package.json
└── tsconfig.json
```
### Tech Stack
- **Framework**: [Frog](https://frog.fm/) - Framework for building Farcaster frames
- **Blockchain**: [viem](https://viem.sh/) - TypeScript interface for Ethereum
- **Deployment**: Vercel
- **Language**: TypeScript
## Getting Started
### Prerequisites
- Node.js 18+
- Bun (recommended) or npm
- Farcaster account
### Installation
1. Clone the repository:
```bash
git clone https://github.com/Complexlity/arb-bridger.git
cd arb-bridger
```
2. Install dependencies:
```bash
bun install
# or
npm install
```
3. Start the development server:
```bash
bun dev
# or
npm run dev
```
4. Open your browser to: http://localhost:5173/api/dev
## Deployment
Deploy to Vercel:
```bash
bun deploy
# or
npm run deploy
```
## Usage
1. Share the frame URL in a Farcaster cast
2. Users can interact with the frame to:
- Enter the amount of ETH to bridge
- Select the source network (Ethereum, Base, or Optimism)
- Approve and sign the transaction
- View transaction status
## Security Considerations
- Never expose private keys in client-side code
- Always verify transaction details before signing
- Use environment variables for sensitive configuration
- Regularly update dependencies
## Contributing
Contributions are welcome! Please open an issue or submit a pull request.
## License
MIT