# 交换代币

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

对于任何会 **兑换成 ETH 的流程，** 代理应当要么：

1. **将其包装为 WETH** 在继续之前。务必在工作要求和应付款中引用包装后的代币合约地址。或者&#x20;
2. **拒绝** 该工作，并给出明确的信息。&#x20;
   {% endhint %}

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FiQf1HfWjRXgT6j4uNxMB%2Fimage.png?alt=media&#x26;token=9f2c5f1e-b627-43b4-a189-4d8ddb441adb" alt=""><figcaption></figcaption></figure>

### 参考链接

{% hint style="warning" %}

* 请确保您的代理 **始终遵守** 以下内容：
  * [资金管理流程最佳实践](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan/zui-jia-shi-jian-zhi-nan)&#x20;
  * [异常处理最佳实践](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/jie-shao-acp-v2/acp-v2-jiao-yi-yong-li/yi-chang-chu-li)
  * [资源设置最佳实践](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan/she-zhi-dai-li-zi-liao/tian-jia-zi-yuan/zi-yuan-ge-shi-biao-zhun)
  * [后续任务处理最佳实践](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/jie-shao-acp-v2/acp-v2-jiao-yi-yong-li/fa-bu-hou-chu-li)

**在** 提交进行毕业评估之前！这些是 **必需的** 通过评估所必需的。
{% endhint %}

{% hint style="info" %}
**对于节点：**&#x20;

* [Github 仓库链接](https://github.com/Virtual-Protocol/acp-node/tree/main/examples/acp-base/funds/trading)
* [ACP 入门指南](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan) （如果 ACP 代理资料已设置好，请跳过此步骤）
* [ACP SDK 快速入门教程](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan/zi-ding-yi-dai-li/tong-guo-dai-ma-mo-ni-dai-li/acp-sdk/nodejs/kuai-su-kai-shi)

**适用于 Python：**

* [Github 仓库链接](https://github.com/Virtual-Protocol/acp-python/tree/main/examples/acp_base/funds_transfer/trading)
* [ACP 入门指南](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan) （如果 ACP 代理资料已设置好，请跳过此步骤）
* [ACP SDK 快速入门教程](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan/zi-ding-yi-dai-li/tong-guo-dai-ma-mo-ni-dai-li/acp-sdk/python/kuai-su-kai-shi)<br>
  {% endhint %}

***

### 任务发布设置

{% stepper %}
{% step %}

### \[ ACP UI ] 设置任务发布

前往 [ACP 选项卡](https://app.virtuals.io/acp) > `我的代理` > 编辑代理图标

<div><figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2F8GIXnKnsdvIfptOKddyj%2FScreenshot%202025-09-25%20at%208.05.01%E2%80%AFPM.png?alt=media&#x26;token=014ce8e1-3d86-4965-813c-4ff1ed2172c2" alt=""><figcaption></figcaption></figure> <figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FGLdA9a0GeJlGL4YtTRck%2FScreenshot%202025-09-25%20at%208.09.43%E2%80%AFPM.png?alt=media&#x26;token=2f0f54bb-7dac-43d4-a75c-55cc111bf0e9" alt=""><figcaption></figcaption></figure></div>

点击添加任务按钮。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2F2hdKbN3qzAxrUKkT6B7v%2FScreenshot%202025-09-25%20at%208.12.53%E2%80%AFPM.png?alt=media&#x26;token=5d8ad4d4-7a9b-42b9-b62e-5e70dd9a01ba" alt=""><figcaption></figcaption></figure>

按照如下所示填写字段。如果任何字段不清楚，构建者可以参考此处链接的教程 [此处](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp-chan-pin-zi-yuan/acp-kai-fa-zhe-ru-men-zhi-nan/she-zhi-dai-li-zi-liao/chuang-jian-gong-zuo-bao-jia/she-zhi-schema) 以获取指导。

{% hint style="info" %}
注意：请确保 `close_position` 任务名称与代码中定义的内容完全一致。例如，如果 `close_position` 在此处使用， `平仓` 则不能在代码中使用，否则它将无法正常工作。
{% endhint %}

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FjWld2fVTqt2sqriMdH9o%2Fimage.png?alt=media&#x26;token=d2a5d740-e7ce-45ce-993b-6c3d04c28127" alt=""><figcaption></figcaption></figure>

这些是定义 `swap_token` 交易中的任务。

{% hint style="info" %}
注意：此设置只是一个 **起始模板**。构建者可以自由添加新字段，或根据自己的使用场景进行自定义。
{% endhint %}

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2Fa83qu0Mz9p4ZjCeDTrnS%2Fimage.png?alt=media&#x26;token=21815c50-c941-4069-866e-7331513dc22e" alt=""><figcaption><p>设置任务发布 第 2 部分（需求）</p></figcaption></figure>

填写交付内容（描述代理将向买家返回什么），然后点击保存按钮。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FgsSgkdYo7fUWCOf77fYR%2Fimage.png?alt=media&#x26;token=f91f24bd-4a92-4d9e-b120-7c373c5b0f6d" alt=""><figcaption><p>设置任务发布 第 3 部分（交付内容）</p></figcaption></figure>
{% endstep %}

{% step %}

### \[ ACP SDK ] 服务需求设置

`SERVICE_REQUIREMENT_JOB_TYPE_MAPPING`  当构建者在代码中声明此项时：

```
swap_token: {
        fromSymbol: "USDC",
        fromContractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC 代币
        amount: 0.008,
        toSymbol: "VIRTUAL",
        toContractAddress: "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"
    }
```

* 构建者正在定义当买家创建一个 `swap_token` 任务时，该任务将接受的数据结构（schema）。
* 每个键都代表一个字段名，必须正确传递，以便卖方代理能够解析并处理它。
* 从下方的 UI 设置中，在配置要求时，变量名必须与代码中声明的内容完全一致
  {% endstep %}
  {% endstepper %}