> For the complete documentation index, see [llms.txt](https://luckystar-1.gitbook.io/luckystar.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://luckystar-1.gitbook.io/luckystar.asia/testnet/cosmos-eco/fairblock-network/fairyport.md).

# Fairyport

`Fairyport` is an off-chain service for sending aggregated keyshares to destination chains from `fairyring`. This tutorial explains how to setup and run `fairyport`. Ensure you have followed the prerequisites and installed the `fairyring` binary prior to following the instructions below.

### Install fairyport

Cloning the repository:

```
cd $HOME
git clone https://github.com/Fairblock/fairyport.git
cd fairyport
```

Install fairyport binary:

```
go mod tidy
go install
```

Setup fairyport Initialize fairyport config:

```
fairyport init
```

`init` command create a default config `config.yml` in the default directory `$HOME/.fairyport` . The config looks like this:

```
FairyRingNode:
    grpcport: 9090
    ip: 127.0.0.1
    port: 26657
    protocol: rpc
DestinationNode:
    grpcport: 9090
    ip: 127.0.0.1
    port: 26657
    protocol: rpc
Mnemonic: '# mnemonic'
```

### Detailed explanation on the config:

**FairyRingNode**

Option: Description

ip: The IP address that Fairy Ring Node will use.

port: The port that Fairy Ring Node will use for TendermintRPC

protocol: The protocol used for communication via the TendermintRPC

grpcport: The port that Fairy Ring Node will use for gRPC communication with other nodes.

**DestinationNode**

Option: Description

ip: The IP address that Destination Node will use.

port: The port that Destination Node will use for TendermintRPC

protocol: The protocol used for communication via the TendermintRPC

grpcport: The port that Destination Node will use for gRPC communication with other nodes.

**Mnemonic**

Option: Description

Mnemonic The seed phrase used to generate the private key for the account responsible for making transactions to the Destination Chain

Update the node ip and ports for `fairyport` to connect to and `Mnemonic` to your mnemonic phase. Note that fairyport derives your address with path `m/44'/118'/0'/0/0` by default.

The updated config should looks like this:

```
FairyRingNode:
  ip: "127.0.0.1"
  port: 26657
  protocol: "tcp"
  grpcport: 9090

DestinationNode:
  ip: "127.0.0.1"
  port: 26659
  protocol: "tcp"
  grpcport: 9092

Mnemonic: "banana unusual correct orange dwarf fortune tennis sell primary giggle canal ask fish movie loud elite region glory session wonder frozen clap mountain barrel"
```

### Start fairyport

After you setup fairyport, you can start running fairyport by:

```
fairyport start --config $HOME/.fairyport/config.yml
```