https://github.com/kompendium-ano/fae

Factom <> Ethereum bi-directional bridge system
https://github.com/kompendium-ano/fae

Last synced: about 1 month ago
JSON representation

Factom <> Ethereum bi-directional bridge system

• Host: GitHub
• URL: https://github.com/kompendium-ano/fae
• Owner: kompendium-ano
• Created: 2020-11-06T21:57:47.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-22T15:05:36.000Z (almost 4 years ago)
• Last Synced: 2023-03-05T11:12:07.936Z (almost 2 years ago)
• Language: Solidity
• Homepage:
• Size: 848 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# FAE

__NOTE: currently in a process of merging from several other repos and branches that used for experiments.__

Factom-2-Ethereum bidirectional bridge. Main idea is to re-use smart-contracts functionality from Ethereum and Factom platforms and allow calling contracts and data from one system to another. For the current setup, we forsee following cases:

- transferring ERC20, ERC-721, ERC-1155 from Ethereum to Factom via FAT

- storing data of Factom, calling it from Ethereum side

- calling Ethereum contract from Factom via FAT

## Description

**Factom-2-Ethereum** decentralized bridge

The Ethereum to Factom bridge should be implemented as mutual smart-contract based solution, thus would provide full security of respective networks for the bridge. Currentlty, building Factom smart contract and relayer for Etheruem blockchain light verification.

## Repository Structure

- `docs`     - additional documentation for the project

- `factom`   - everything related to the Factom side of the system

- `ethereum` - everything related to the Ethereum side of the system

- `test`     - example scripts for ERC20 token transfer

### Ethereum Side

- **FactomBridge**: Solidity smart contract for Ethereum blockchain, Factom light client storing hashes of blocks

- **FactomRelay**: an application, streaming Factom block headers to **FactomBridge** smart contract in Ethereum blockchain.

- **FactomProver**: Solidity smart contract for Ethereum blockchain, helps verify `tx` outcome was included in in block

### Factom side

- **EthBridge**: WASM smart contract for Factom blockchain, Ethereum light client storing hashes of blocks

- **EthRelay**: application, streaming Ethereum block headers to **EthBridge** smart contract in Factom blockchain.

- **EthProver**: WASM smart contract for Factom blockchain, helps verify log entry was included in tx receipt, which was included in block

## Running

You can run full operational setup with `docker` and `docker-compose`

```

# service docker start

# docker-compose up -d

```

compose will start all required service on both sides and connect to hosted blokchain nodes. If you want to connect to local or special remote nodes, you'll need to change configuation. By default, system links to infrastructure blockchain nodes, Ethereum at `infura.io`, Factom at `factomd.net`, FAT courtesy node provided by Kompendium.