clboss/Boss/Mod/all.cpp
Ken Sedgwick 584e8ee3b9
XRebalancer: add the autonomous flow-mode rebalancer driver
XRebalancer is the autonomous driver of the xrebalance track. It runs
only when clboss-rebalance-mode is "xrebalance" (self-gating via
RebalanceModeProxy, the same way the classic rebalancers gate on
"classic"), and drives liquidity using the clboss-xmovefunds primitive.

Each cycle:
  - Fetch listpeerchannels live (not cached).
  - Classify channels into fill / drain tiers over dynamically
    configurable balance bands.
  - Derive the cycle's transfers from the joint-flow curve and a derived
    geometric route-cost-floor ladder (the same algorithm the
    clboss-xrebalance-view tool visualizes; the view is the reference,
    the driver ports it).
  - Execute each transfer by calling clboss-xmovefunds, then log a
    per-transfer summary plus one line per part (delivered vs failed,
    with the closest-to-delivery part as the failure reason).

Dynamic options, runtime-tunable via setconfig (on the dynamic-option
infra):
  - clboss-xrebalance-size-factor: scales the requested transfer size;
    >1 deliberately over-fills (recoverable), <=0 rejected.  Also accepts
    a "lo:hi" range (e.g. 0.5:3.0): in range mode each cycle draws a fresh
    uniform-random multiplier in [lo,hi], so the request size sweeps
    continuously instead of sitting at one value -- a fixed factor
    eventually stales askrene's route state into repeated 205/206
    refusals, which the sweep relieves.  The cycle line logs the drawn
    value and active range.
  - clboss-xrebalance-maxparts: the MCF flow cap (raise alongside
    size-factor so big requests are not rejected with 205).
  - route-cost-floor sweep: floor=auto picks a random rung over the
    derived ladder each cycle, logged per cycle.

Like the underlying clboss-xmovefunds, this requires patched CLN
(circular askrene) at runtime. It is deliberate / non-JIT.
2026-08-14 13:33:14 -07:00

237 lines
7.8 KiB
C++

#include"Boss/Mod/ActiveProber.hpp"
#include"Boss/Mod/AmountSettingsHandler.hpp"
#include"Boss/Mod/AskreneUpdates.hpp"
#include"Boss/Mod/AutoDisconnector.hpp"
#include"Boss/Mod/AvailableRpcCommandsAnnouncer.hpp"
#include"Boss/Mod/BlockTracker.hpp"
#include"Boss/Mod/BoltzSwapper/Main.hpp"
#include"Boss/Mod/ChannelCandidateInvestigator/Main.hpp"
#include"Boss/Mod/ChannelCandidateMatchmaker.hpp"
#include"Boss/Mod/ChannelCandidatePreinvestigator.hpp"
#include"Boss/Mod/ChannelCreateDestroyMonitor.hpp"
#include"Boss/Mod/ChannelCreationDecider.hpp"
#include"Boss/Mod/ChannelCreator/Main.hpp"
#include"Boss/Mod/ChannelFeeManager.hpp"
#include"Boss/Mod/ChannelFeeSetter.hpp"
#include"Boss/Mod/ChannelFinderByDistance.hpp"
#include"Boss/Mod/ChannelFinderByEarnedFee.hpp"
#include"Boss/Mod/ChannelFinderByListpays.hpp"
#include"Boss/Mod/ChannelFinderByPopularity.hpp"
#include"Boss/Mod/ChannelFundsComputer.hpp"
#include"Boss/Mod/ComplainerByLowConnectRate.hpp"
#include"Boss/Mod/ComplainerByLowSuccessPerDay.hpp"
#include"Boss/Mod/ConnectFinderByDns.hpp"
#include"Boss/Mod/ConnectFinderByHardcode.hpp"
#include"Boss/Mod/Connector.hpp"
#include"Boss/Mod/CommandReceiver.hpp"
#include"Boss/Mod/Dowser.hpp"
#include"Boss/Mod/EarningsRebalancer.hpp"
#include"Boss/Mod/EarningsTracker.hpp"
#include"Boss/Mod/FeeModderByBalance.hpp"
#include"Boss/Mod/FeeMonitor.hpp"
#include"Boss/Mod/FeeModderByPriceTheory.hpp"
#include"Boss/Mod/FeeModderBySize.hpp"
#include"Boss/Mod/ForwardFeeMonitor.hpp"
#include"Boss/Mod/FundsMover/Main.hpp"
#include"Boss/Mod/HtlcAcceptor.hpp"
#include"Boss/Mod/InitialConnect.hpp"
#include"Boss/Mod/InitialRebalancer.hpp"
#include"Boss/Mod/Initiator.hpp"
#include"Boss/Mod/InternetConnectionMonitor.hpp"
#include"Boss/Mod/InvoicePayer.hpp"
#include"Boss/Mod/JitRebalancer.hpp"
#include"Boss/Mod/JsonOutputter.hpp"
#include"Boss/Mod/ListfundsAnalyzer.hpp"
#include"Boss/Mod/ListfundsAnnouncer.hpp"
#include"Boss/Mod/ListpaysHandler.hpp"
#include"Boss/Mod/ListpeersAnalyzer.hpp"
#include"Boss/Mod/ListpeersAnnouncer.hpp"
#include"Boss/Mod/Manifester.hpp"
#include"Boss/Mod/MoveFundsCommand.hpp"
#include"Boss/Mod/NeedsConnectSolicitor.hpp"
#include"Boss/Mod/NeedsOnchainFundsSwapper.hpp"
#include"Boss/Mod/NewaddrHandler.hpp"
#include"Boss/Mod/NodeBalanceSwapper.hpp"
#include"Boss/Mod/OnchainFeeMonitor.hpp"
#include"Boss/Mod/OnchainFundsAnnouncer.hpp"
#include"Boss/Mod/OnchainFundsIgnorer.hpp"
#include"Boss/Mod/PaymentDeleter.hpp"
#include"Boss/Mod/PeerCompetitorFeeMonitor/Main.hpp"
#include"Boss/Mod/PeerComplaintsDesk/Main.hpp"
#include"Boss/Mod/PeerFromScidMapper.hpp"
#include"Boss/Mod/PeerMetrician.hpp"
#include"Boss/Mod/PeerStatistician.hpp"
#include"Boss/Mod/RebalanceModeManager.hpp"
#include"Boss/Mod/RebalanceUnmanager.hpp"
#include"Boss/Mod/Reconnector.hpp"
#include"Boss/Mod/RegularActiveProbe.hpp"
#include"Boss/Mod/RpcWrapper.hpp"
#include"Boss/Mod/SelfUptimeMonitor.hpp"
#include"Boss/Mod/SendpayResultMonitor.hpp"
#include"Boss/Mod/SetConfigHandler.hpp"
#include"Boss/Mod/StatusCommand.hpp"
#include"Boss/Mod/SwapManager.hpp"
#include"Boss/Mod/SwapReporter.hpp"
#include"Boss/Mod/TimerTwiceDailyAnnouncer.hpp"
#include"Boss/Mod/Timers.hpp"
#include"Boss/Mod/UnmanagedManager.hpp"
#include"Boss/Mod/Waiter.hpp"
#include"Boss/Mod/XMoveFunds/Main.hpp"
#include"Boss/Mod/XRebalancer.hpp"
#include"Boss/Mod/all.hpp"
#include<vector>
namespace {
class All {
private:
std::vector<std::shared_ptr<void>> modules;
public:
template<typename M, typename... As>
std::shared_ptr<M> install(As&&... as) {
auto ptr = std::make_shared<M>(as...);
modules.push_back(std::shared_ptr<void>(ptr));
return ptr;
}
};
}
namespace Boss { namespace Mod {
std::shared_ptr<void> all( std::ostream& cout
, S::Bus& bus
, Ev::ThreadPool& threadpool
, std::function< Net::Fd( std::string const&
, std::string const&
)
> open_rpc_socket
) {
auto all = std::make_shared<All>();
/* Basic. */
auto waiter = all->install<Waiter>(bus);
auto imon = all->install<InternetConnectionMonitor>( bus
, threadpool
, *waiter
);
all->install<JsonOutputter>(cout, bus);
all->install<CommandReceiver>(bus);
all->install<RpcWrapper>(bus);
all->install<AvailableRpcCommandsAnnouncer>(bus);
/* Startup. */
all->install<Manifester>(bus);
all->install<Initiator>(bus, threadpool, std::move(open_rpc_socket));
all->install<SetConfigHandler>(bus);
/* General settings. */
all->install<AmountSettingsHandler>(bus);
/* Regular timers. */
all->install<BlockTracker>(bus);
all->install<Timers>(bus, *waiter);
all->install<TimerTwiceDailyAnnouncer>(bus);
/* Connection wrangling. */
all->install<InitialConnect>(bus);
all->install<Connector>(bus);
all->install<NeedsConnectSolicitor>(bus);
all->install<ConnectFinderByDns>(bus);
all->install<ConnectFinderByHardcode>(bus);
all->install<Reconnector>(bus);
all->install<AutoDisconnector>(bus);
/* Status monitors. */
all->install<ChannelFundsComputer>(bus);
all->install<ListpeersAnnouncer>(bus);
all->install<ListpeersAnalyzer>(bus);
all->install<OnchainFeeMonitor>(bus, *waiter);
all->install<ListfundsAnnouncer>(bus);
all->install<ListfundsAnalyzer>(bus);
all->install<OnchainFundsAnnouncer>(bus);
all->install<OnchainFundsIgnorer>(bus);
all->install<ChannelCreateDestroyMonitor>(bus);
all->install<SelfUptimeMonitor>(bus);
/* Channel creation wrangling. */
all->install<ChannelFinderByDistance>(bus, *waiter);
all->install<ChannelFinderByEarnedFee>(bus);
all->install<ChannelFinderByListpays>(bus);
all->install<ChannelFinderByPopularity>(bus, *waiter);
all->install<ChannelCandidatePreinvestigator>(bus);
auto investigator = all->install< ChannelCandidateInvestigator::Main
>(bus, *imon);
all->install<ChannelCreationDecider>(bus);
all->install<ChannelCreator::Main>(bus, *waiter, *investigator);
all->install<ChannelCandidateMatchmaker>(bus);
all->install<Dowser>(bus);
/* Status. */
all->install<StatusCommand>(bus);
/* Offchain-to-onchain swap. */
all->install<NewaddrHandler>(bus);
all->install<BoltzSwapper::Main>(bus, threadpool);
all->install<SwapManager>(bus);
all->install<NeedsOnchainFundsSwapper>(bus);
all->install<NodeBalanceSwapper>(bus);
all->install<SwapReporter>(bus);
/* Invoice wrangling. */
all->install<InvoicePayer>(bus);
all->install<ListpaysHandler>(bus);
all->install<PaymentDeleter>(bus);
/* Channel fees. */
all->install<FeeMonitor>(bus);
all->install<PeerCompetitorFeeMonitor::Main>(bus);
all->install<ChannelFeeSetter>(bus);
all->install<ChannelFeeManager>(bus);
all->install<FeeModderBySize>(bus);
all->install<FeeModderByBalance>(bus);
all->install<FeeModderByPriceTheory>(bus);
/* HTLC manipulation. */
all->install<HtlcAcceptor>(bus, *waiter);
/* Bad peer monitoring. */
all->install<SendpayResultMonitor>(bus);
all->install<ForwardFeeMonitor>(bus);
all->install<PeerStatistician>(bus);
all->install<PeerMetrician>(bus);
all->install<ActiveProber>(bus, *investigator);
all->install<RegularActiveProbe>(bus);
/* Peer complaints. */
all->install<PeerComplaintsDesk::Main>(bus);
all->install<ComplainerByLowConnectRate>(bus);
#ifdef ENABLE_COMPLAINER_BY_LOW_SUCCESS_PER_DAY
all->install<ComplainerByLowSuccessPerDay>(bus);
#endif /* ENABLE_COMPLAINER_BY_LOW_SUCCESS_PER_DAY */
/* Channel balancing. */
all->install<RebalanceModeManager>(bus);
all->install<AskreneUpdates>(bus);
all->install<FundsMover::Main>(bus);
all->install<XMoveFunds::Main>(bus);
all->install<XRebalancer>(bus, *waiter);
all->install<MoveFundsCommand>(bus);
all->install<EarningsTracker>(bus);
all->install<JitRebalancer>(bus);
#ifdef ENABLE_INITIAL_REBALANCER
all->install<InitialRebalancer>(bus);
#endif /* ENABLE_INITIAL_REBALANCER */
all->install<EarningsRebalancer>(bus);
all->install<RebalanceUnmanager>(bus);
/* Unmanaged nodes. */
all->install<UnmanagedManager>(bus);
/* Utility. */
all->install<PeerFromScidMapper>(bus);
return all;
}
}}