@spec decode(String.t()) :: {:ok, map()} | {:error, decode_error()}

Decodes a Base64 PAYMENT-RESPONSE value to a map.

Returns {:error, :payload_too_large} when the encoded value exceeds 8 KB. Returns {:error, :invalid_base64} when the value cannot be Base64-decoded. Returns {:error, :invalid_json} when JSON cannot be decoded to a map.

Examples

iex> response = %{"success" => true, "transaction" => "0xabc", "network" => "eip155:8453"}
iex> {:ok, value} = X402.PaymentResponse.encode(response)
iex> X402.PaymentResponse.decode(value)
{:ok, response}

iex> X402.PaymentResponse.decode("%%%")
{:error, :invalid_base64}

@spec encode(map()) :: {:ok, String.t()} | {:error, encode_error()}

Encodes a settlement response payload to a Base64 header value.

Examples

iex> response = %{"success" => true, "transaction" => "0xabc", "network" => "eip155:8453"}
iex> {:ok, value} = X402.PaymentResponse.encode(response)
iex> X402.PaymentResponse.decode(value)
{:ok, response}

@spec header_name() :: String.t()

Returns the canonical x402 header name.

Examples

iex> X402.PaymentResponse.header_name()
"PAYMENT-RESPONSE"