结论：您描述的情况是否违法，需结合具体细节来判断，但存在一定法律风险，可能涉及“居间合同纠纷”或“以合法形式掩盖非法目的”等法律问题。以下从不同角度为您详细分析：

1. 若债主仅作为中介，收取合理费用，且工程真实存在

• 法律背景：根据《民法典》第九百六十一条，中介合同是中介人向委托人报告订立合同的机会或者提供订立合同的媒介服务，委托人支付报酬的合同。若债主仅作为中介，为您介绍工程，并收取合理中介费，且工程真实存在、合法合规，则该行为通常不违法。
• 关键点：
  • 费用合理性：中介费应符合市场行情，不得过高或显失公平。
  • 工程合法性：工程需具备合法手续，如规划许可、施工许可等。
  • 债务抵消协议：若您与朋友、债主三方达成书面协议，明确以工程中介费抵消朋友债务，且该协议不违反法律强制性规定，则具有法律效力。

2. 若债主以介绍工程为名，实际收取高额费用或虚构工程

• 法律风险：
  • 欺诈：若债主虚构工程或隐瞒工程真实情况，诱使您支付费用，可能构成欺诈，需承担民事赔偿责任，甚至刑事责任（《刑法》第二百六十六条）。
  • 以合法形式掩盖非法目的：若债主与朋友串通，以介绍工程为名，实际为转移债务或逃避债务，可能被认定为“以合法形式掩盖非法目的”，导致相关协议无效。
• 关键点：
  • 工程真实性：需核实工程是否存在、是否合法。
  • 费用合理性：若费用明显高于市场行情，需警惕欺诈风险。
  • 协议内容：需审查协议是否明确约定费用性质、债务抵消方式等，避免模糊条款。

3. 若您未核实工程真实性即参与，可能承担的风险

• 合同风险：若您与债主或工程方签订合同，但工程实际不存在或违法，您可能面临合同无效、无法追回已支付费用等风险。
• 债务风险：若债务抵消协议因违法或无效被撤销，您仍需承担对朋友的债务。

法律建议

1. 核实工程真实性：在参与前，务必核实工程是否存在、是否合法，要求债主或工程方提供相关手续。
2. 签订书面协议：与朋友、债主三方签订书面协议，明确费用性质、债务抵消方式、违约责任等，避免口头约定。
3. 咨询专业律师：若涉及金额较大或情况复杂，建议咨询专业律师，审查协议内容，评估法律风险。

总结：您描述的情况是否违法，需结合工程真实性、费用合理性、协议内容等具体细节判断。为避免法律风险，建议您在参与前充分核实信息，签订书面协议，并在必要时咨询专业律师。如有进一步疑问，可直接向我咨询。