{
  "tool_id": "art-349-fedwire-structured-address-linter",
  "note": "Fedwire/CHIPS Nov-2026 structured-address lint. Vector 1: valid fully-structured. Vector 2: valid hybrid (TwnNm+Ctry+AdrLine, no duplication). Vector 3: rejected unstructured (AdrLine-only). Vector 4: empty-input finite.",
  "vectors": [
    {
      "name": "valid_fully_structured",
      "description": "Fully-structured Fedwire address with all ISO fields populated, no AdrLine. Compliant with the 2026-11-16 mandate.",
      "policy_parameters": {
        "network": "fedwire",
        "street_name": "400 South Hope Street",
        "building_number": "",
        "post_code": "90071",
        "town_name": "Los Angeles",
        "country": "US",
        "country_subdivision": "CA",
        "address_lines": []
      },
      "output_payload": {
        "network": "fedwire",
        "structure_type": "FULLY_STRUCTURED",
        "compliant": true,
        "readiness_pct": 100,
        "error_count": 0,
        "violations": [],
        "fedwire_chips_deadline": "2026-11-16",
        "disambiguation": "lint_fedwire_structured_address checks per-message Fedwire/CHIPS Nov-2026 hybrid/fully-structured rule lint (network param selects fedwire or chips; rules are byte-identical on both as of build-time verification, so one kernel covers both networks). For the SWIFT CBPR+ cross-border equivalent use lint_cbpr_structured_address (art-241).",
        "pii_note": "All fields operate on STRUCTURAL address components only. No real party PII enters this kernel -- use synthetic or anonymised address data.",
        "table_version": "FEDWIRE-CHIPS-STRUCTURED-ADDRESS-NOV2026-V1",
        "table_source": "Federal Reserve Financial Services, Fedwire Funds Service ISO 20022 November 2026 Release FAQ (frbservices.org/resources/financial-services/wires/iso-20022-implementation-center/november-release-faq); The Clearing House CHIPS ISO 20022 address rules (aligned to Fedwire)",
        "regulatory_basis": "Federal Reserve Financial Services Fedwire Funds Service ISO 20022 November 2026 Release; The Clearing House CHIPS ISO 20022 implementation (aligned to Fedwire address rules)"
      },
      "golden_hash": "5ffc3e4b22e19570bd49e007cd20210a469654db2fc2921a034dec25af7bc39f"
    },
    {
      "name": "valid_hybrid_chips",
      "description": "Hybrid CHIPS address (TwnNm+Ctry required, structured Street/PostCode plus 1 supplemental AdrLine that does not duplicate structured values). Compliant.",
      "policy_parameters": {
        "network": "chips",
        "street_name": "1 Chase Manhattan Plaza",
        "post_code": "10005",
        "town_name": "New York",
        "country": "US",
        "country_subdivision": "NY",
        "address_lines": [
          "Attn: Wire Operations, 4th Floor"
        ]
      },
      "output_payload": {
        "network": "chips",
        "structure_type": "HYBRID",
        "compliant": true,
        "readiness_pct": 100,
        "error_count": 0,
        "violations": [],
        "fedwire_chips_deadline": "2026-11-16",
        "disambiguation": "lint_fedwire_structured_address checks per-message Fedwire/CHIPS Nov-2026 hybrid/fully-structured rule lint (network param selects fedwire or chips; rules are byte-identical on both as of build-time verification, so one kernel covers both networks). For the SWIFT CBPR+ cross-border equivalent use lint_cbpr_structured_address (art-241).",
        "pii_note": "All fields operate on STRUCTURAL address components only. No real party PII enters this kernel -- use synthetic or anonymised address data.",
        "table_version": "FEDWIRE-CHIPS-STRUCTURED-ADDRESS-NOV2026-V1",
        "table_source": "Federal Reserve Financial Services, Fedwire Funds Service ISO 20022 November 2026 Release FAQ (frbservices.org/resources/financial-services/wires/iso-20022-implementation-center/november-release-faq); The Clearing House CHIPS ISO 20022 address rules (aligned to Fedwire)",
        "regulatory_basis": "Federal Reserve Financial Services Fedwire Funds Service ISO 20022 November 2026 Release; The Clearing House CHIPS ISO 20022 implementation (aligned to Fedwire address rules)"
      },
      "golden_hash": "e4933bcd8560e92e216c30c8434683e3e26e43a6e208f8cdcd11b82b31eb0695"
    },
    {
      "name": "rejected_unstructured",
      "description": "Fully unstructured AdrLine-only address, no structured fields at all. Prohibited after 2026-11-16 on both Fedwire and CHIPS.",
      "policy_parameters": {
        "network": "fedwire",
        "address_lines": [
          "123 Main Street",
          "Anytown USA 12345"
        ]
      },
      "output_payload": {
        "network": "fedwire",
        "structure_type": "UNSTRUCTURED",
        "compliant": false,
        "readiness_pct": 80,
        "error_count": 1,
        "violations": [
          {
            "code": "UNSTRUCTURED_ADDRESS",
            "severity": "ERROR",
            "field": "AdrLine",
            "message": "Unstructured AdrLine-only addresses are prohibited after 16 Nov 2026 (FEDWIRE mandate). Migrate to fully-structured or hybrid format."
          }
        ],
        "fedwire_chips_deadline": "2026-11-16",
        "disambiguation": "lint_fedwire_structured_address checks per-message Fedwire/CHIPS Nov-2026 hybrid/fully-structured rule lint (network param selects fedwire or chips; rules are byte-identical on both as of build-time verification, so one kernel covers both networks). For the SWIFT CBPR+ cross-border equivalent use lint_cbpr_structured_address (art-241).",
        "pii_note": "All fields operate on STRUCTURAL address components only. No real party PII enters this kernel -- use synthetic or anonymised address data.",
        "table_version": "FEDWIRE-CHIPS-STRUCTURED-ADDRESS-NOV2026-V1",
        "table_source": "Federal Reserve Financial Services, Fedwire Funds Service ISO 20022 November 2026 Release FAQ (frbservices.org/resources/financial-services/wires/iso-20022-implementation-center/november-release-faq); The Clearing House CHIPS ISO 20022 address rules (aligned to Fedwire)",
        "regulatory_basis": "Federal Reserve Financial Services Fedwire Funds Service ISO 20022 November 2026 Release; The Clearing House CHIPS ISO 20022 implementation (aligned to Fedwire address rules)"
      },
      "golden_hash": "1fb114c9007f2ed22af061dd43490c0e3acece577fd207ebd777607848e46616"
    },
    {
      "name": "empty_input_finite",
      "description": "Empty input -- all address fields absent. Verifies finite output (no NaN/Infinity) and EMPTY structure type detection.",
      "policy_parameters": {},
      "output_payload": {
        "network": "fedwire",
        "structure_type": "EMPTY",
        "compliant": false,
        "readiness_pct": 80,
        "error_count": 1,
        "violations": [
          {
            "code": "EMPTY_ADDRESS",
            "severity": "ERROR",
            "field": "PostalAddress24",
            "message": "No address fields populated. FEDWIRE ISO 20022 messages require a populated PostalAddress24 block."
          }
        ],
        "fedwire_chips_deadline": "2026-11-16",
        "disambiguation": "lint_fedwire_structured_address checks per-message Fedwire/CHIPS Nov-2026 hybrid/fully-structured rule lint (network param selects fedwire or chips; rules are byte-identical on both as of build-time verification, so one kernel covers both networks). For the SWIFT CBPR+ cross-border equivalent use lint_cbpr_structured_address (art-241).",
        "pii_note": "All fields operate on STRUCTURAL address components only. No real party PII enters this kernel -- use synthetic or anonymised address data.",
        "table_version": "FEDWIRE-CHIPS-STRUCTURED-ADDRESS-NOV2026-V1",
        "table_source": "Federal Reserve Financial Services, Fedwire Funds Service ISO 20022 November 2026 Release FAQ (frbservices.org/resources/financial-services/wires/iso-20022-implementation-center/november-release-faq); The Clearing House CHIPS ISO 20022 address rules (aligned to Fedwire)",
        "regulatory_basis": "Federal Reserve Financial Services Fedwire Funds Service ISO 20022 November 2026 Release; The Clearing House CHIPS ISO 20022 implementation (aligned to Fedwire address rules)"
      },
      "golden_hash": "1adf358857d71dceefe10911f969429a5ba6fe70345bee418a73853dbcd37770"
    }
  ]
}
