Protobuf Compatibility

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x25e8245f07d5e4873987293dad666afbe56a9608",
      "amount": "220000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 60
    }
  ],
  "resource": {
    "url": "https://api.zfinia.com/x402/v1/protobuf-schema-compatibility",
    "tags": [
      "protobuf",
      "grpc",
      "wire compatibility",
      "contract testing",
      "release gate"
    ],
    "mimeType": "application/json",
    "description": "Decide whether two .proto sources are compatible, treating the field number as the identity it is. Reports a number freed without a reserved entry, which arms a future field to reinterpret old bytes; a number taken from a reserved range; a wire type change, which stops old messages decoding; a same-wire-type change that alters the decoded value, such as signed to unsigned; a rename, which is wire-safe and breaks generated code; cardinality and oneof moves; and enum number changes.",
    "serviceName": "Protobuf Compatibility"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "after": "syntax = \"proto3\";\npackage shop.v1;\n\nenum Status {\n  UNKNOWN = 0;\n  OPEN = 1;\n  CLOSED = 2;\n}\n\nmessage Order {\n  string order_id = 1;\n  uint64 total_cents = 2;\n  Status status = 3;\n  string tags = 4;\n  int32 discount_cents = 5;\n}\n",
            "before": "syntax = \"proto3\";\npackage shop.v1;\n\nenum Status {\n  STATUS_UNSPECIFIED = 0;\n  OPEN = 1;\n  CLOSED = 2;\n}\n\nmessage Order {\n  string order_id = 1;\n  int64 total_cents = 2;\n  Status status = 3;\n  repeated string tags = 4;\n  string note = 5;\n}\n"
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "example": {
            "limits": {
              "maxFindings": 500,
              "maxSdlBytes": 262144,
              "maxVersions": 25,
              "maxAvroBytes": 262144,
              "maxConsumers": 50,
              "maxProtoBytes": 262144,
              "maxPathsPerConsumer": 200
            },
            "passed": false,
            "complete": true,
            "findings": [
              {
                "code": "VALUE_SEMANTICS_CHANGED",
                "field": "total_cents",
                "detail": "shop.v1.Order.total_cents = 2 went from int64 to uint64, which share the varint wire type, so old bytes decode without error and a value above the signed maximum reads as negative, or a negative value...",
                "number": 2,
                "message": "shop.v1.Order"
              },
              {
                "code": "CARDINALITY_CHANGED",
                "field": "tags",
                "detail": "shop.v1.Order.tags = 4 went from repeated to singular. The bytes still parse and the decoded shape changes, so a reader keeps only the last value or sees a one-element list.",
                "number": 4,
                "message": "shop.v1.Order"
              },
              {
                "code": "FIELD_RENAMED",
                "field": "discount_cents",
                "detail": "shop.v1.Order field 5 went from note to discount_cents. The wire format is unchanged because the number is the identity, and every generated accessor, JSON name and text-format name changes.",
                "number": 5,
                "message": "shop.v1.Order"
              }
            ],
            "compatible": false,
            "request_id": "example-request",
            "service_id": "protobuf_schema_compatibility",
            "assumptions": [
              "The field number is the identity, as protobuf defines it, and the name is not. A rename is therefore reported as wire-compatible and a source break, and reusing a number is reported as a silent reinte...",
              "Removing a field is only safe when the number cannot come back, so a removal without a matching reserved entry is a finding even though the removal itself parses.",
              "A type this file does not define, typically an imported one, is reported as not compared rather than assumed compatible. Services, extensions and groups are recognised and listed as not modelled."
            ],
            "limitations": [
              "The two .proto sources supplied, as a documented subset: messages, enums, fields, oneofs, maps and reserved ranges. Imports are recorded and not followed.",
              "compatible is true only when everything was compared and nothing changed in a way that affects a reader, a writer or generated code."
            ],
            "observed_at": "2026-10-02T00:00:00.000Z",
            "after_syntax": "proto3",
            "not_examined": [],
            "before_syntax": "proto3",
            "finding_count": 6,
            "service_version": "1.0.0",
            "after_enum_count": 1,
            "findings_by_code": {
              "FIELD_RENAMED": 1,
              "WIRE_TYPE_CHANGED": 1,
              "ENUM_VALUE_RENAMED": 1,
              "CARDINALITY_CHANGED": 1,
              "ENUM_ZERO_VALUE_CHANGED": 1,
              "VALUE_SEMANTICS_CHANGED": 1
            },
            "before_enum_count": 1,
            "after_message_count": 1,
            "before_message_count": 1
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "properties": {
              "body": {
                "type": "object",
                "required": [
                  "before",
                  "after"
                ],
                "properties": {
                  "after": {
                    "type": "string",
                    "maxLength": 262144
                  },
                  "before": {
                    "type": "string",
                    "maxLength": 262144
                  }
                },
                "additionalProperties": false
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x25e8245f07d5e4873987293dad666afbe56a9608",
    "amount": "220000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 60
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "after": "syntax = \"proto3\";\npackage shop.v1;\n\nenum Status {\n  UNKNOWN = 0;\n  OPEN = 1;\n  CLOSED = 2;\n}\n\nmessage Order {\n  string order_id = 1;\n  uint64 total_cents = 2;\n  Status status = 3;\n  string tags = 4;\n  int32 discount_cents = 5;\n}\n",
          "before": "syntax = \"proto3\";\npackage shop.v1;\n\nenum Status {\n  STATUS_UNSPECIFIED = 0;\n  OPEN = 1;\n  CLOSED = 2;\n}\n\nmessage Order {\n  string order_id = 1;\n  int64 total_cents = 2;\n  Status status = 3;\n  repeated string tags = 4;\n  string note = 5;\n}\n"
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "limits": {
            "maxFindings": 500,
            "maxSdlBytes": 262144,
            "maxVersions": 25,
            "maxAvroBytes": 262144,
            "maxConsumers": 50,
            "maxProtoBytes": 262144,
            "maxPathsPerConsumer": 200
          },
          "passed": false,
          "complete": true,
          "findings": [
            {
              "code": "VALUE_SEMANTICS_CHANGED",
              "field": "total_cents",
              "detail": "shop.v1.Order.total_cents = 2 went from int64 to uint64, which share the varint wire type, so old bytes decode without error and a value above the signed maximum reads as negative, or a negative value...",
              "number": 2,
              "message": "shop.v1.Order"
            },
            {
              "code": "CARDINALITY_CHANGED",
              "field": "tags",
              "detail": "shop.v1.Order.tags = 4 went from repeated to singular. The bytes still parse and the decoded shape changes, so a reader keeps only the last value or sees a one-element list.",
              "number": 4,
              "message": "shop.v1.Order"
            },
            {
              "code": "FIELD_RENAMED",
              "field": "discount_cents",
              "detail": "shop.v1.Order field 5 went from note to discount_cents. The wire format is unchanged because the number is the identity, and every generated accessor, JSON name and text-format name changes.",
              "number": 5,
              "message": "shop.v1.Order"
            }
          ],
          "compatible": false,
          "request_id": "example-request",
          "service_id": "protobuf_schema_compatibility",
          "assumptions": [
            "The field number is the identity, as protobuf defines it, and the name is not. A rename is therefore reported as wire-compatible and a source break, and reusing a number is reported as a silent reinte...",
            "Removing a field is only safe when the number cannot come back, so a removal without a matching reserved entry is a finding even though the removal itself parses.",
            "A type this file does not define, typically an imported one, is reported as not compared rather than assumed compatible. Services, extensions and groups are recognised and listed as not modelled."
          ],
          "limitations": [
            "The two .proto sources supplied, as a documented subset: messages, enums, fields, oneofs, maps and reserved ranges. Imports are recorded and not followed.",
            "compatible is true only when everything was compared and nothing changed in a way that affects a reader, a writer or generated code."
          ],
          "observed_at": "2026-10-02T00:00:00.000Z",
          "after_syntax": "proto3",
          "not_examined": [],
          "before_syntax": "proto3",
          "finding_count": 6,
          "service_version": "1.0.0",
          "after_enum_count": 1,
          "findings_by_code": {
            "FIELD_RENAMED": 1,
            "WIRE_TYPE_CHANGED": 1,
            "ENUM_VALUE_RENAMED": 1,
            "CARDINALITY_CHANGED": 1,
            "ENUM_ZERO_VALUE_CHANGED": 1,
            "VALUE_SEMANTICS_CHANGED": 1
          },
          "before_enum_count": 1,
          "after_message_count": 1,
          "before_message_count": 1
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "required": [
                "before",
                "after"
              ],
              "properties": {
                "after": {
                  "type": "string",
                  "maxLength": 262144
                },
                "before": {
                  "type": "string",
                  "maxLength": 262144
                }
              },
              "additionalProperties": false
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-10-04 08:19Z

Last indexed by Roundhouse

2026-10-05 00:20Z

Last enriched (probe, favicon, geo)

2026-10-05 17:46Z

x402 version

2

Max timeout

60s

Liveness probe

HTTP 402