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

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 - Framework for building Farcaster frames
• Blockchain: viem - 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:

   git clone https://github.com/Complexlity/arb-bridger.git
   cd arb-bridger

2. Install dependencies:

   bun install
   # or
   npm install

3. Start the development server:

   bun dev
   # or
   npm run dev

4. Open your browser to: http://localhost:5173/api/dev

Deployment

Deploy to Vercel:

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