The fees of the steps below are not quoted up front, so a balance that
moved is checked against its expected value with this much slack. The
balances that must not move are checked exactly.
The duplicate-payment assertions for gateways that claim the payment image
only after paying and forfeit the duplicates: one settles, two are refunded.
The duplicate-payment assertions for gateways that claim the payment image
at intake: one send settles, the gateway refuses the other two without
paying or forfeiting anything, so they stay unresolved until their contracts
expire, and the gateway is reimbursed exactly once.
Fund an HTLC of one thousand sats locked to claim_pk, wait for the
funding transaction to be accepted and return the funding txid and the
contract JSON as the claimer receives them out of band.
Creates a fresh client and joins it to the federation identified by
invite_code, unlike Federation::new_joined_client which always joins
whichever federation last wrote the shared invite-code file.
Every module runs against the real mintv2 here, so money bound to a
non-primary account has to stay in it across a Lightning refund and claim,
an on-chain deposit and withdrawal, and a recovery from seed. The gateways
must not be funded when this starts: the refund relies on it.
Exercise the direct HTLC CLI between two clients of the same federation,
with the full out-of-band handoff as strings: the claimerβs key, the
funderβs funding txid and contract JSON, and the forfeit signature. The
claimerβs secret key and preimage are passed through files and stdin.
Three independent clients β two in the primary federation and one in a
second federation, all served by the same gateway β race to pay the same
invoice. The gateway pays the invoice only once, so it may claim only one of
the three outgoing contracts regardless of which federation funded them.
Exactly one payment settles; how the other two end depends on the gateway
version, see assert_duplicates_refunded and
assert_duplicates_refused.
Stops enough guardians that no threshold of them can answer, checks that
a receive is refused without the gateway funding anything, then checks
that receives work again once the guardians are back.