Verifiable PayID structure inconsistency

[molowny]

The structure of the Verifiable PayID seems to be wrong according to the current interface description at https://docs.payid.org/payid-interfaces

This is Verifiable PayID from docs (https://docs.payid.org/verifiable-payid-tutorial):

{
  "payId": "verifiabledemo$127.0.0.1",
  "addresses": [],
  "verifiedAddresses": [
    {
      "payload": "{\"payId\":\"test$example.com\",\"payIdAddress\":{\"paymentNetwork\":\"XRPL\",\"environment\":\"TESTNET\",\"addressDetailsType\":\"CryptoAddressDetails\",\"addressDetails\":{\"address\":\"rDk7FQvkQxQQNGTtfM2Fr66s7Nm3k87vdS\"}}}",
      "signatures": [
        {
          "protected": "eyJuYW1lIjoiaWRlbnRpdHlLZXkiLCJhbGciOiJFUzI1NksiLCJ0eXAiOiJKT1NFK0pTT04iLCJiNjQiOmZhbHNlLCJjcml0IjpbImI2NCIsIm5hbWUiXSwiandrIjp7ImNydiI6InNlY3AyNTZrMSIsIngiOiI2S0dtcEF6WUhWUm9qVmU5UEpfWTVyZHltQ21kTy1xaVRHem1Edl9waUlvIiwieSI6ImhxS3Vnc1g3Vjk3eFRNLThCMTBONUQxcW44MUZWMjItM1p0TURXaXZfSnciLCJrdHkiOiJFQyIsImtpZCI6Im4zNlhTc0M1TjRnNUtCVzRBWXJ5d1ZtRE1kUWNEV1BJX0RfNUR1UlNhNDAifX0",
          "signature": "rsoKeVLzwg2PpGRK0S10fpmh5WNtttF9dyJgSv3USEr4aN3bUBzp5ImRQo8wlh3E00GtZ2cse-lhoQ4zJKj0Jw"
        }
      ]
    }
  ]
}

so the payload of the verified address contains:

{
  "payId": "test$example.com",
  "payIdAddress": {
    "paymentNetwork": "XRPL",
    "environment": "TESTNET",
    "addressDetailsType": "CryptoAddressDetails",
    "addressDetails": {
        "address": "rDk7FQvkQxQQNGTtfM2Fr66s7Nm3k87vdS"
    }
  }
}

This structure doesn't exist in the specification, furthermore, it seems to be incorrect because if we POST this data to admin API and then try to GET it from public API, the test$example.com is omitted (this information isn't written to the database) and replaced with the top-level pay id verifiabledemo$127.0.0.1. And as long as, the JWS verification requires the original payload, it will be failed.

It leads to the conclusion that verifiedAddresses should be created from Address interface and signed without additional wrapping into an unknown structure.

please correct me if I'm wrong