› async-matrix › Source › Async › Matrix › Endpoint

class Endpoint

Extends Async::HTTP::Endpoint with Matrix well-known discovery. spec.matrix.org/v1.9/client-server-api/#well-known-uri

A server at example.com may serve clients from a completely different origin — e.g. https://matrix.example.com:8448. #discover resolves that indirection as a proper async I/O operation before constructing the Endpoint, so every downstream caller gets a correctly-pointed connection pool for free.

Definitions

def self.discover(domain, **options)

Resolves homeserver base URL, falls back to https://domain. Must be called inside an Async block — uses the running scheduler.

Implementation

 
def self.discover(domain, **options)
  internet = Async::HTTP::Internet.new
  data     = JSON.parse(internet.get("https://#{domain}#{WELL_KNOWN}").read)
  base_url = data.dig("m.homeserver", "base_url") || "https://#{domain}"
  parse(base_url, **options)
rescue StandardError
  # Well-known is optional per spec — fall back gracefully
  parse("https://#{domain}", **options)
ensure
  internet&.close
end