PLT-6847 withdraw by payout

[jhbertra]

• Withdraw now accepts payout tx out refs instead of contact ID + token name
• all tests and clients updated
• REST API updated
• Payout schema changed to align with other entities and provide more consistent interface (thanks @nhenin)
  • PayoutRef renamed to PayoutHeader
  • Consistent use of payoutId vs payout
  • use AssetId for role field instead of two fields
  • use more clear terminology and an explicit status field for withdrawn / available payout filtering.

Pre-submit checklist:

• Branch
  • Tests are provided (if possible)
  • Test report is updated (if relevant)
  • Commit sequence broadly makes sense
  • Key commits have useful messages
  • Relevant tickets are mentioned in commit messages
  • Formatting, PNG optimization, etc. are updated
• PR
  • Self-reviewed the diff
  • Useful pull request description
    • Review required
    • Substantial changes to code, test, or documentation
    • Change made to Marlowe validator (@bwbush and @palas must be included as reviewers)
    • Review not required
    • Minor changes to non-critical code, documentation, nix derivations, configuration files, or scripts
    • Formatting, spelling, grammar, or reorganization
  • Reviewer requested

[bwbush]

Doesn't this change make error reporting less expressive? The error reports were already too terse.

[jhbertra]

It doesn't make it less expressive, it actually makes it more expressive:

-- before on "PayoutInputNotFound"
ApiError "Internal error" "PayoutInputNotFound" Null 500

-- after
ApiError "PayoutNotFound <payout tx in>" "ConstraintError" 500

[bwbush]

We'll have to revise some starter-kit lessons prior to releasing this.

[bwbush]

Looks good, but I haven't done ad-hoc testing on chain. I assume that @nhenin will do that as he uses the new API.

[nhenin]

@jhbertra @bwbush , I have finished the integration on the ts-sdk and added a couple of fixes at the end of your commits @jhbertra.

We can merge it imo.