V2 - SettlementResponse contains "requirements"

[straumat]

i'm implement x402 V2 in Mogami

Using my client to call https://www.x402.org/protected, the SettlementResponse i Iget contains a requirements.

{
  "success": true,
  "transaction": "0x367b2be69eca8086e1cae68f6fc0704e7bb6af5fa1ae876d05b450641c455e4f",
  "network": "eip155:84532",
  "payer": "0xf6b42050A71Ca13f842eDa53C7d31B7C1BD94F6E",
  "requirements": {
    "scheme": "exact",
    "network": "eip155:84532",
    "amount": "10000",
    "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "payTo": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C",
    "maxTimeoutSeconds": 300,
    "extra": {
      "name": "USDC",
      "version": "2"
    }
  }
}

There is nothing about it in the specifications at 5.3 SettlementResponse Schema

[0x402ai]

Hi @straumat

SettlementResponse is the response type of the facilitator's /settle endpoint.
The endpoint https://www.x402.org/protected is a seller endpoint. When a request succeeds, the response includes a PAYMENT-RESPONSE header. The documentation does not describe the data type of the decoded PAYMENT-RESPONSE.
From the source code, the decoded PAYMENT-RESPONSE data type is SettleResponse & { requirements: PaymentRequirements }

Additional details can be found in:
typescript\packages\core\src\http

[straumat]

Hi @0x402ai
The specification does describe the data type of decoded payment-response, it's under 5.3 SettlementResponse Schema and there is no "requirements". Here is copy paste from the specification:

The SettleResponse schema contains the following fields:

Field Name	Type	Required	Description
success	boolean	Required	Indicates whether the payment settlement was successful
errorReason	string	Optional	Error reason if settlement failed (omitted if successful)
payer	string	Optional	Address of the payer's wallet
transaction	string	Required	Blockchain transaction hash (empty string if settlement failed)
network	string	Required	Blockchain network identifier in CAIP-2 format

[0x402ai]

Perhaps the requirements field should be removed; I'm not sure why it was added, and it did not exist in v1.

For v2, PaymentResponse and SettleResponse are not the same and should not be equated.

It looks like the requirements field was possibly introduced by mistake and seems unnecessary.

[phdargen]

Hi @straumat, thanks for reporting! Thats indeed inconsistent with the specs and the go v2 implementation.
Opened a PR to remove requirements here: #844

[straumat]

@phdargen sorry to ask this in here. But I have questions on the v2 specs. How to get replies ? should I open issues or is there another way?

[phdargen]

Hi @straumat, yes opening an issue should work. I am monitoring those more actively than it used to be the case.
Alternatively, you might ask in our telegram group or on discord. Replies might be slower during the holidays

[phdargen]

Found your question on discord and replied there