turn only as fallback - try first with only stun

[neonphog]

---
title: Check for known cases where STUN likely won't work.
---
graph TD;

stunCheck("STUN Check")
udpCheck("UDP Check")
natCheck("NAT Check")
stunOkay("STUN Okay")
turnOnly("TURN Only")

stunCheck-->udpCheck
udpCheck-->|If UDP Blocked|turnOnly
udpCheck-->|If UDP Okay|natCheck
natCheck-->|If Bad NAT|turnOnly
natCheck-->|If NAT Okay|stunOkay

Loading

---
title: Message flow and acceptance.
---
graph LR;

subgraph a [" "]
  send("Send with No Open Connection")
  inOffer("Incoming Offer")
  inRestart("Incoming Restart Offer")
  ignore("Ignore")
end

subgraph b [" "]
  outRestart("Outgoing Restart Offer")
  outOffer("Outgoing Offer")
end

subgraph c [" "]
  tryStun("Try Connecting STUN Only")
  tryTurn("Try Connecting STUN+TURN")
end

send-->outOffer
send-->|If STUN Okay|tryStun
send-->|If TURN Only|tryTurn
tryStun-->|If Error|tryTurn
tryStun-->|If Error + Impolite|outRestart
inOffer-->|If Impolite|ignore
inOffer-->|If Polite + STUN Okay|tryStun
inOffer-->|If Polite + TURN Only|tryTurn
inRestart-->|If Impolite|ignore
inRestart-->|If Polite|tryTurn

Loading

classDiagram

class SigConn {
  Cli sig_conn
  send()
}

class SigConnFut {
  SigConn sig_conn
}
SigConn *-- SigConnFut

class SigConnMap {
  Map~SigConnFut~ sig_map
  assert_sig() SigConnFut
}
SigConnFut *-- SigConnMap

class PeerConn {
  FFIPeerCon peer_conn
  Option~SigConn~ tmp_sig_conn
  send()
}
SigConn *-- PeerConn
note for PeerConn "PeerConn holds a temp ref to SigConn\nwhile still iceGathering, then drops it"

class PeerConnFut {
  PeerConn peer_conn
  in_offer(offer)
  in_restart_offer(restartOffer)
}
PeerConn *-- PeerConnFut
note for PeerConnFut "Restarting on offers *within* the future\nprevents race conditions."

class PeerConnMap {
  Map~PeerConnFut~ peer_map
  assert_peer(url) PeerConnFut
  in_offer(url, offer)
  in_restart_offer(url, restartOffer)
}
PeerConnFut *-- PeerConnMap
note for PeerConnMap "PeerConnMap is no longer under SigConn.\nInstead PeerConn itself now holds\na temporary dependency"

Loading

[neonphog]

closing in favor of holochain/sbd#20