Channel on_close docs and examples

How does it work?

Generell kann ein payment (buyer) / paying (seller) channel jederzeit explizit von einem der beiden channel seiten geschlossen werden bzw das schliessen des channels angefordert werden.

Die 2 seiten eines channels sind dabei das jeweilige delegate und der market maker. Für das (kooperative) schliessen sind am ende des tages immer die unterschriften von beiden seiten notwendig.

Daher gibt es "close_channel" (eigentlich besser "request_to_close_channel") als procedure sowohl im delegate als auch im market maker.

Ein buyer delegate kann das schliessen durch aufruf von

https://crossbario.com/docs/crossbarfx/xbr/api-reference.html#crossbarfx.edge.worker.xbr._marketmaker.MarketMaker.close_channel

anfordern.

Im SimpleBuyer ist dies komplett automatisiert und "versteckt":

https://github.com/crossbario/autobahn-python/blob/9eb36ffa9de75572c3d26af9612753d4060b1b7e/autobahn/xbr/_buyer.py#L316

https://github.com/crossbario/autobahn-python/blob/9eb36ffa9de75572c3d26af9612753d4060b1b7e/autobahn/xbr/_buyer.py#L345

Der market maker kann das schliessen ebenso anfordern: beim seller delegate, durch aufruf der durch das seller delegate bereitgestellten "close_channel" procedure.

Im SimpleSeller ist dies komplett automatisiert und "versteckt":

https://github.com/crossbario/autobahn-python/blob/9eb36ffa9de75572c3d26af9612753d4060b1b7e/autobahn/xbr/_seller.py#L481

SimpleBuyer und SimpleSeller sind mitgelieferte Implementierungen von Delegates welche einfach zu verwenden sind und "Standardverhalten" bieten. zB auch was Pricing angeht (nämlich hier statisch), oder eben auch "channel auto-close".

Start with the referenced CrossbarFX API documentation and the linked close-channel handling in autobahn/xbr/_buyer.py and autobahn/xbr/_seller.py. Document how delegates and market makers request cooperative channel closure, including the SimpleBuyer and SimpleSeller behavior, and add examples showing the relevant calls.