Rex

Proof of Concept Elixir implementation of Cardano's Ouroboros networking mini-protocols.

Running

Via local UNIX socket

Run the following command using your own Cardano node's socket path:

CARDANO_NODE_SOCKET_PATH=/your/cardano/node.socket mix query_current_era

🚨 The N2C protocol on the Haskell cardano-node only works via Unix socket. It does not allow connection through an IP or hostname.

Setting up Unix socket mapping

1. Run socat on the remote server with the following command:

socat TCP-LISTEN:3002,reuseaddr,fork UNIX-CONNECT:/home/cardano_node/socket/node.socket

2. Run socat on the local machine with the following command:

socat UNIX-LISTEN:/tmp/cardano_node.socket,reuseaddr,fork TCP:localhost:3002

3. Start an SSH tunnel from the local machine to the remote server with the following command:

ssh -N -L 3002:localhost:3002 user@remote-server-ip

Via TLS to a URL

To connect to a node at a URL like demeter.run, set the CARDANO_NODE_URL to the URL of the node. Make sure the CARDANO_NODE_SOCKET_PATH is not set, or it will override the URL configuration.

Catalyst Proposal

F13 proposal for further development of this project: https://cardano.ideascale.com/c/cardano/idea/131598