Metadata-Version: 2.1
Name: beamer-bridge
Version: 0.1.0
Summary: Bridging rollups with L1 guaranteed security
Home-page: https://www.beamerbridge.com/
License: MIT
Author: Beamer Bridge Team
Author-email: contact@beamerbridge.com
Requires-Python: >=3.9,<3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: click (>=8.0.3,<9.0.0)
Requires-Dist: prometheus-client (>=0.14.1,<0.15.0)
Requires-Dist: python-statemachine (>=0.8.0,<0.9.0)
Requires-Dist: structlog (>=21.5.0,<22.0.0)
Requires-Dist: web3 (>=5.24.0,<6.0.0)
Project-URL: Documentation, https://docs.beamerbridge.com/
Project-URL: Repository, https://github.com/beamer-bridge/beamer
Description-Content-Type: text/markdown

[![Agent CI](https://github.com/beamer-bridge/beamer/actions/workflows/backend.yml/badge.svg)](https://github.com/beamer-bridge/beamer/actions/workflows/backend.yml)
[![Frontend CI](https://github.com/beamer-bridge/beamer/actions/workflows/frontend.yml/badge.svg)](https://github.com/beamer-bridge/beamer/actions/workflows/frontend.yml)

# Beamer Bridge
*Transfer ERC20 assets directly between EVM compatible rollups - with a world class user experience*

Beamer is a protocol to enable users to move tokens from one rollup to another.
The user requests a transfer by providing tokens on the source rollup.
Liquidity providers then fill the request and directly send tokens to the user
on the target rollup.

Documentation: https://docs.beamerbridge.com
Testnet frontend: https://testnet.beamerbridge.com


## Running an agent from source

Prerequisites: Python 3.9.x and Poetry

Clone this repository and enter the virtual environment:
```
    poetry shell
```

Install the necessary dependencies:
```
    poetry install
```

Finally, still within the virtual environment, run:
```
    beamer-agent --keystore-file <keyfile> \
                 --password <keyfile-password> \
                 --l1-rpc-url <l1-rpc-url> \
                 --l2a-rpc-url <source-l2-rpc-url> \
                 --l2b-rpc-url <target-l2-rpc-url> \
                 --deployment-dir <contract-deployment-dir> \
                 --token-match-file <token-match-file>
```

For more comprehensive documentation go to [Beamer documenation](https://docs.beamerbridge.com).

