How do I move funds between federations?

Moving funds from one federation to another simply involves paying yourself from one federation wallet to another in the same way you would pay anyone else. Since you cannot send a chat payment to yourself, you can do this either via on-chain or Lightning (LNURL or invoice).

Fedi recommends on-chain for reliability, as on-chain transfers settle directly on the Bitcoin network and don't depend on Lightning routing. Lightning transfers arrive faster and carry lower fees, which can make them a better fit for smaller transaction amounts.

On-Chain

1. From the Wallet tab, choose the federation where you'd like to receive funds to; tap ↓ Receive on your bitcoin balance.
2. Toggle to On-chain at the top of the Receive Bitcoin screen; tap Copy to copy the Bitcoin address.
3. Back on the Wallet tab, navigate to the federation you'd like to send funds from; tap ↑ Send on your bitcoin balance; tap Paste at the bottom of the screen.
4. Enter the amount to be sent in sats or fiat, confirm the wallet you'd like to pay from, & tap Continue.
5. Once you've reviewed the details and fees of the transaction, tap Send.

Note – There is no "Max Send" button. If you enter more than you can send once fees are taken into account, the app shows The max you can send is X sats in red. Tap the amount in that message to autofill the amount that will allow you to move your entire balance. Proceed with the transaction.

Keep in mind the following when moving funds on-chain:

• On-chain sends carry a 0.5% Fedi app fee, a variable network fee, and any fees charged by the guardians of the original federation.
• Receiving on-chain carries a deposit fee of 100 sats & a network fee of several hundred to a couple thousand sats (subject to network conditions); both are deducted from the tx amount before it lands in the new federation. 
• You should send your funds within 24 hours of generating the on-chain address; never send more than one transaction to any address you generate.
• Deposits need 11 confirmations before they're credited to your balance, which may take up to several hours. You can follow the status of your transfer in your transaction history.

Note that fees make up a larger share of smaller transaction amounts. On-chain sends also have a minimum tx amount the app will show if you enter an amount below it. For small transfers, or if on-chain txs are unavailable in either federation, you can send funds over Lightning instead.

LNURL

1. From the Wallet tab, choose the federation you'd like to receive funds to; tap ↓ Receive on your bitcoin balance; and toggle to LNURL. You will see a LNURL QR code.
2. Tap Copy and then tap back at the top left.
3. Tap the Scan/Paste button; Paste the LNURL; and tap Continue.
4. On the next screen, enter the amount to be sent, choose the federation wallet you'd like to pay from, and add a note if you want.
5. Once you've reviewed the details of the transaction, tap Send.

Note that if the payment fails due to insufficient funds, the resulting error shows the true maximum number of sats you can send net of fees. Repeat the process using this number to ensure the payment is successful and zero out your balance in the wallet you're moving funds from.

Lightning Invoice

If the federation you'd like to receive to does not support LNURL, you can still receive the funds via a Lightning invoice.

1. If you'd like to transfer your entire balance, first navigate to the federation you'd like to send from, tap ↑ Send on your bitcoin balance, select Ecash/Offline, and enter your exact current balance in sats. The actual maximum amount you can send when accounting for fees will be shown in red. This is the amount to enter in the next step.
2. Select the federation wallet you'd like to receive to, tap ↓ Receive, toggle to Lightning, and enter the amount you'd like to receive in sats or fiat.
3. Add a note to the transaction if you'd like, then tap Request X SATS. You will see a Lightning invoice QR code. Tap Copy, then tap back at the top left.
4. Tap the Scan/Paste button, Paste the Lightning invoice, and tap Continue. On the next screen, choose the federation you'd like to pay from. As you are using a Lightning invoice instead of an LNURL, the sats/fiat amount is populated automatically and can't be changed.
5. Once you've reviewed the details of the transaction, tap Send.