Implement Fidelity Bonds [released in JoinMarket v0.9.0]

[openoms]

Part of JoinMarket v0.9.0: https://github.com/JoinMarket-Org/joinmarket-clientserver/blob/master/docs/release-notes/release-notes-0.9.0.md

More info: https://github.com/JoinMarket-Org/joinmarket-clientserver/blob/master/docs/fidelity-bonds.md

To test on signet switch to SIGNET in CONFIG - used the signet addresses below. The procedure is the same on mainnet.

Update to the JoinMarket release v0.9.0 by updating he JoininBox scripts first. menu - UPDATE - ADVANCED - JBCOMMIT then menu - UPDATE - JOINMARKET.

As a Taker

no input needed to use Fidelity Bonds after updating to v0.9.0

For Makers

• Generate a new wallet or to convert wallets to have fidelity bonds use the seed backup or the wallet-tool.py method:

  (showseed) Shows the wallet recovery seed and hex seed.

  It is to be implemented in the menu. Until then the CLI is simple: (jmvenv):~/joinmarket-clientserver/scripts$ ./wallet-tool.py WALLET.jmdat showseed

• take note of the seed and use menu - WALLET - RECOVER:

  same as:

  (jmvenv):~/joinmarket-clientserver/scripts$ ./wallet-tool.py recover

  input the seed (+ optional passphrase if there was one used).

• Next on the second run of the DISPLAY menu option can check that m0 now shows the fbonds-mpk- prefix:

  

• if after the first sync funds are missing consider increasing the gap limit: ./wallet-tool.py --recoversync -g 200 WALLET.jmdat

• Create a Fidelity Bond Address in the CLI:

  (jmvenv):~/joinmarket-clientserver/scripts$ ./wallet-tool.py WALLET.jmdat gettimelockaddress 2021-8

  

• Fund it: (if using signet can use signetfaucet.com) or send with a sweeping coinjoin, consider using an already mixed coin.

• Check the DISPLAY or m0 again (highlighted the locked coin):

  

  Important: need to wait for a confirmation to have the bond active: https://explorer.bc-2.jp/tx/6fce4174113a762d18a4550147d8c7d1e271832e0ff040aa18949406627bac6a

• To run the Order Book locally to display the Fidelity bonds only need to start it from the menu - OFFERS and see like on:

  http://gopnmsknawlntb4qpyav3q5ejvvk6p74a7y5xotmph4v64wl3wicscad.onion/

• After starting the Yield Generator from the MAKER menu option as usual (using he fidelity bond enabled wallet) it appears in the Order Book with the Fidelity Bond:

  

  

• Try the new tabs in the obwatcher for some interesting metrics:

  http://gopnmsknawlntb4qpyav3q5ejvvk6p74a7y5xotmph4v64wl3wicscad.onion/sybilresistance

  

[openoms]

Idea re recovery from IRC:

Maybe just a warning when using recover? "If funds appear to be missing after the recovery, try running WHATEVER with a gap limit higher than the default 6. This can be done by editing blah blah"

[openoms]

closing as SHOWSEED and TIMELOCK options are in the menu now.