How balena/elixir-sippet works
Sippet is an Elixir SIP middleware stack. The principal workflow is: a SIP peer sends a datagram, UDP delivers it to the router, the message parser constructs a structured SIP message, and a client/server transaction drives callbacks into the registered application core. Outbound requests follow the reverse path through transaction state machines and UDP. Digest authentication is an optional application-facing capability. The graph reflects sampled Elixir and C++ paths; some router dispatch details are inferred only where documented.
Main entry points: router.ex SIP Router · udp.ex UDP Transport · message.ex SIP Message · sippet.ex Sippet API
Components 14
Stack API
- Sippet API
lib/sippet.ex - SIP Router
lib/sippet/router.ex - Core Callbacks
lib/sippet/core.ex
Message Processing
- SIP Message
lib/sippet/message.ex - Message Parser
lib/sippet/parser.ex - C++ NIF Parser
c_src/parser.cc
Transaction State
- Client INVITE FSM
lib/sippet/transactions/client/invite.ex - Client Non-INVITE FSM
lib/sippet/transactions/client/non_invite.ex - Server INVITE FSM
lib/sippet/transactions/server/invite.ex - Server Non-INVITE FSM
lib/sippet/transactions/server/non_invite.ex
Network Transport
- UDP Transport
lib/sippet/transports/udp.ex
Authentication
- Digest Authentication
lib/sippet/digest_auth.ex
Other components
- SIP Peer
- Middleware App
Connections 20
- Middleware App → Sippet API: calls API
- Sippet API → SIP Router: dispatches
- SIP Peer → UDP Transport: sends datagrams
- UDP Transport → SIP Router: delivers datagrams
- SIP Router → SIP Message: parses messages
- SIP Message → Message Parser: calls parser
- Message Parser → C++ NIF Parser: loads NIF
- SIP Router → Client INVITE FSM: starts transaction
- SIP Router → Client Non-INVITE FSM: starts transaction
- SIP Router → Server INVITE FSM: starts transaction
- SIP Router → Server Non-INVITE FSM: starts transaction
- Client INVITE FSM → SIP Router: sends transport
- Client Non-INVITE FSM → SIP Router: sends transport
- Server INVITE FSM → SIP Router: sends response
- Server Non-INVITE FSM → SIP Router: sends response
- SIP Router → UDP Transport: sends messages
- UDP Transport → SIP Message: serializes messages
- SIP Router → Core Callbacks: delivers callbacks
- Middleware App → Digest Authentication: uses authentication
- Digest Authentication → SIP Message: updates headers