fabric tendermint cross demo

This is an example application for an atomic swap through Cross-chain transaction using Cross Framework between Hyperledger Fabric and Tendermint.

As Atomic commit protocol, Simple commit protocol is used.

Requirements

Go 1.16+
Docker
jq

Install required tools

The below command installs Relayer, Fabric tools, Fabric CLI, Tendermint CLI

# install fabric tools and build Fabric/Tendermint CLI, Relayer
make -C demo build -j5

Chains

Chain	Node	Role	Application
Tendermint	1 Node	Coordinator/Participant	ERC-20 based on CDT Module
Fabric	1 Orderer, 3 Peers	Participant	ERC-20 based on CDT Module

Refer to CDT

Directory structure

cmds
- alpha ... Tendermint CLI
- beta ... Fabric CLI
contracts
- erc20 ... contract modules for Tendermint/Fabric
demo ... demo environment including
- chains
  - fabric ... fabric-related files including docker-compose.yaml for network
    - chaincode
      - fabibc ... fabric chaincode application
  - tendermint ... tendermint simapp working as CLI and tendermint application including docker-compose.yaml for network
- configs ... config files for alpha cli, beta cli, fabric app, relayer
- scripts ... shell scripts for alpha cli, beta cli, relayer, scenario
relayer ... Relayer CLI

How tools work

Relayer
- relaying packets between different chains
Fabric tools
- genesis block generation
- configuration of a channel
- cryptographic generation
- deployment of chaincode
Fabric CLI
- creating tx, submitting tx, querying tx on Fabric node
Tendermint CLI
- creating tx, submitting tx, querying tx on Tendermint node

Startup fabric and tendermint network

# prepare fabric network and tendermint network using docker containers
make -C demo network

Testing the demo

# initialize relayer, fabric CLI, tendermint CLI, and run handshake for IBC between fabric and tendermint by creating transactions.
make -C demo run-init
# run ./scripts/scenario/sample-scenario. See the `About sample-scenario` section for more detail.
make -C demo run

End network

# down related containers, remove volumes
make -C demo network-down
# remove any generated data
make -C demo clean

Restart network if needed

make -C demo network-down
make -C demo clean
make -C demo network

About sample-scenario

See About sample-scenario

READMEs

Additional information can be found below.

About

Inter-Blockchain Communication between Tendermint Blockchain and Hyperledger Fabric Blockchains using Cross Framework

Apache License 2.0

Languages

Language:Go 97.3%Language:Makefile 1.7%Language:Shell 1.0%