Glossary
Rendezvous Server
This server is located on the internet and is operated by the Magic Wormhole project. It is used to find peers to share files with. When starting a transmission, both parties will contact the rendezvous server to find each other.
The rendezvous server also helps the transmitting client to generate a Transmit Code
They will use this server to exchange cryptographic information for secure communication. Afterwards they will exchange information about how to contact each other for file transfer.
No files are transferred via the rendezvous server. See Transmit Relay and Direct Transfer
Transmit Code
This code will be generated by the client in cooperation with the Rendezvous Server. It is used to identify and encrypt the transmission of messages and files.
To start a transmission you need a transmit code. The transmit code then needs to be communicated to the receiver (preferably via an encrypted or otherwise secure channel). After entering the transmit code at the receiver side the file transmission can begin.
Every transmit code can only be entered once for security reasons.
Transmit Link
It is also possible to encode the Transmit Code as a link. Clicking the link will automatically open Warp and start the file transmission. A Copy Transmit Link button is available in the send screen. A transmit link looks like this:
wormhole-transfer:{code}Transmit Relay
The transmit relay is also operated by the Magic Wormhole project
It is used if no direct communication between two peers can be established. This is most commonly a problem when both parties are located in different home networks with NAT or restrictive firewalls.
The files are transmitted via the transmit relay in an encrypted fashion. The relay will only know about the file size.
Transfers via the transmit relay may be slower than direct transfer, depending on relay congestion.
Direct Transfer
If both peers can find a direct networking path between each other they will send the file directly. This is often referred to as a Peer-to-Peer connection. This type of connection is typically faster than a connection via the Transmit Relay