Update "Receive Payjoin V2" tutorial to current API

[va-an]

The tutorial at https://payjoin.org/docs/tutorials/receive-payjoin-v2 appears to be outdated.

Following the "Setting Up the Project" step verbatim (copying the Cargo.toml snippet from the page) fails immediately on cargo check:

$ cargo check
    Updating crates.io index
error: failed to select a version for the requirement `payjoin = "^0.18.0"`
  version 0.18.0 is yanked

The other pinned dependencies are likely also outdated.

---

Suggested scope

• bump all dependencies in the tutorial's Cargo.toml to current versions
• update the code snippets if necessary
• walk through the tutorial end-to-end on signet to confirm every step still works as written

[DanGould]

Really this thing should have a run check in github CI. I I haven't thought of how to do that exactly, but anything code post on the website really should stay tagged to a specific commit and be reliable basically indefinitely. even better if it's somehow updates in lockstep with the underlying library because it compiles as part of rust-payjoin.

I am sure we are not the first to run into this problem and there are probably 10 solutions available

[va-an]

Really this thing should have a run check in github CI. I I haven't thought of how to do that exactly, but anything code post on the website really should stay tagged to a specific commit and be reliable basically indefinitely. even better if it's somehow updates in lockstep with the underlying library because it compiles as part of rust-payjoin.

I am sure we are not the first to run into this problem and there are probably 10 solutions available

Thanks @DanGould, opening that as #140 since it's site-wide and outlives this tutorial.

This issue stays focused on getting receive-payjoin-v2 working again:

1. PR in https://github.com/payjoin/receive-payjoin-v2: update code to the current rust-payjoin release.
2. PR here: rewrite the tutorial with updated code.

Waiting for a cACK on this plan before starting.

[xstoicunicornx]

This tutorial seems to have been created prior to payjoin-cli existing, is there anything that this tutorial was trying to accomplish that is still not covered by payjoin-cli? Maybe would be better to find some way to point this to the payjoin-cli README.md somehow?

[va-an]

This tutorial seems to have been created prior to payjoin-cli existing, is there anything that this tutorial was trying to accomplish that is still not covered by payjoin-cli? Maybe would be better to find some way to point this to the payjoin-cli README.md somehow?

The tutorial covers library-level receive (using the payjoin crate directly), targeted at developers integrating payjoin rather than CLI users, so not really overlapping with payjoin-cli.

Also, since it's the only tutorial on the site, might be better to move it to payjoindevkit.org, then drop the section here or redirect.

[xstoicunicornx]

The tutorial covers library-level receive (using the payjoin crate directly), targeted at developers integrating payjoin

Seems like payjoin-cli code would cover this no?

[va-an]

Seems like payjoin-cli code would cover this no?

It does cover the integration, but wrapped in a lot of CLI scaffolding (arg parsing, config, persistence). The tutorial strips that down to a guided minimal flow, and already points readers to payjoin-cli source for the parts it skips. The two are designed to complement each other, so leaning toward keeping the tutorial.