拒绝任务

在 V2 代理中处理作业拒绝场景

ACP 合约 不 支持 原生 ETH 直接。SDK 和 Butler 会在执行过程中自动将 ETH → WETH 进行转换，以保持所有操作与 ERC-20 兼容。由于原生 ETH 不是 ERC-20，因此不能直接用于兑换、存款或支付。这样做可能会导致交易或编码错误。

对于任何 兑换为 ETH 的流程， 代理应当要么 在继续之前将其包装为 WETH 要么 以明确的信息拒绝该作业。 始终在作业要求和应付项中引用已包装代币的合约地址。

要理解何时使用 job.reject() 以及何时使用 job.rejectPayable()，你可以参考说明 此处. 它解析了两者的差异以及各自应何时应用。

作业拒绝能力的重要性

在真实的交易工作流中，并非所有作业请求都可以或应该被执行。代理必须具备 验证传入的作业请求 并拒绝那些未通过执行前检查的请求。这可防止无效或有风险的交易在流程中传播，并为买方或协调者提供更清晰的反馈。

拒绝机制对于以下方面至关重要：

• 维护买卖双方交互中的数据完整性。

• 确保代理不执行无效交易。

• 提供即时的理由或反馈以提高自动化的准确性。

---

示例：拒绝无效的平仓请求

下面的代码片段演示了卖方代理如何根据交易者当前持仓决定是否接受或拒绝 平仓 作业：

TypeScript 示例：

case JobName.CLOSE_POSITION: {
    const wallet = getClientWallet(job.clientAddress);
    const closePositionPayload = job.requirement as V2DemoClosePositionPayload;

    const symbol = closePositionPayload.symbol;
    const position = wallet.positions.find((p) => p.symbol === symbol);
    const positionIsValid = !!position && position.amount > 0;

    console.log(`${positionIsValid ? "Accepts" : "Rejects"} position closing`);

    const response = positionIsValid
        ? `Accepts position closing. Please make payment to close ${symbol} position.`
        : "Rejects position closing. Position is invalid.";

    if (!positionIsValid) {
        return await job.reject(response);
    }

    await job.accept(response);
    return await job.createRequirement(response);
}

Python 示例：

if job_name == JobName.CLOSE_POSITION:
        wallet = get_client_wallet(job.client_address)
        symbol = job.requirement.get("symbol")
        position = next((p for p in wallet.positions if p.symbol == symbol), None)
        position_is_valid = position is not None and position.amount > 0
        logger.info(f'{"Accepts" if position_is_valid else "Rejects"} position closing request | requirement={job.requirement}')
        if position_is_valid:
            response = f"Accepts position closing. Please make payment to close {symbol} position."
            job.accept(response)
            return job.create_requirement(response)
        net_capital = swap_token_payload.amount
            response = "Rejects position closing. Position is invalid."
            return job.reject(response)

集成说明

• 此逻辑可以直接放置在代理的作业处理器中，针对 CLOSE_POSITION 分支。

• 当 positionIsValid 返回 false时，代理将触发 job.reject(response)，自动将作业状态更新为 REJECTED 并将原因返回给买方。

• 构建者可以根据其使用场景自定义拒绝条件或消息（例如，余额不足、订单已过期或不支持的交易对）。

---

其他可能适用拒绝的交易场景

1. 无效的订单参数

   • 请求的交易标的或杠杆超出支持的限制。

   • 使用以下方式拒绝 job.reject("不支持的交易对或杠杆设置。").

2. 保证金或余额不足

   • 用户的保证金余额低于所需的最低阈值。

   • 使用以下方式拒绝 job.reject("保证金不足，无法开仓。").

3. 订单过期或已陈旧

   • 订单请求时间戳早于配置的有效窗口。

   • 使用以下方式拒绝 job.reject("订单请求已过期。请重新提交。").

4. 未验证的风险设置

   • 用户的账户存在与新订单冲突的未平仓仓位。

   • 使用以下方式拒绝 job.reject("风险上限已达，无法执行新交易。").

---

最佳实践

每个代理都应实现 防御性验证逻辑 在将作业移至下一阶段之前。 通过集成拒绝机制（job.reject()），构建者可以确保其代理保持可靠、易用，并符合操作安全要求，这在与 DeFi 相关的应用中尤为重要。