TABConf 2025 - Fedimint: Solving p2p Connectivity with Iroh

Getting Started

In this workshop, we are going to be setting up Mutinynet federations using Iroh. Below are relevant links to get setup:

Choose an out of band communication method with your peers

Signal is great. Feel free to use this discord: https://chat.fedimint.org/

Android Users

https://github.com/m1sterc001guy/fedimintd-mobile/releases/download/latest/fedimintd-0d0bfa2a.apk

Docker Compose

Use the below docker compose to start a Fedimintd guardian https://github.com/m1sterc001guy/fedimint/blob/tabconf/docker/docker-compose.yaml

Then run docker compose up -d from the same directory you downloaded the docker compose file. Guardian dashboard is available at http://localhost:8175

Setup Instructions

1. Choose "Mutinynet" for the network type
2. Choose "Esplora" for the blockchain source
3. Click Test Connection then Save Connection Info to use the above settings.
4. Set a Password: When starting fedimintd for the first time, each guardian must create a secure password.
5. Generate Setup Code: After entering the password, a unique setup code is generated for each guardian.
6. Exchange Setup Codes: All guardians must share their setup codes with each other (every guardian needs every other guardian’s code). Use out-of-band communication method to distribute each code.
7. Distributed Key Generation (DKG): Once all setup codes are entered, the DKG process begins. This is where the federation’s cryptographic keys are jointly created. This step may take some time while all guardians connect. Please be patient.
8. Federation Complete!: Once DKG finishes, your federation is live. Your guardian dashboard will be available for monitoring. You now have a functioning Fedimint!

Add Lightning Support

1. DM m1sterc001guy#7632 on Discord so I can add your federation to an existing gateway.
2. Each guardian should add https://mutinynet.ecash.love using their guardian dashboard.

Download a Fedimint wallet

• https://ecash.love
• https://fedi.xyz
• https://harbor.cash

Send and Receive Payments

Can use onchain, lightning, or ecash to transact. Use https://faucet.mutinynet.com/ to get Mutinynet coins.

For the Lazy

If anyone wants to skip the above federation setup, but still play with Fedimint, you can use this demo Mutinynet Iroh Federation:

fed11qgqyj3mfwfhksw309umrjen9vscnwefhx4jkve3j893rsvmpv56rzvpjxcexxvtp8p3rjvnrxsmr2vmxxv6n2wtzxv6rwv3cv9nxvefexumrscekx3jryvpeqqqjqypmpgq9qacctdj9s0sumnfwxq3lqzsku29wtlx8nlluz44rdmmp7a7xm3