---
title: "使用 ethers.js 發送代幣"
description: "適合初學者的使用 ethers.js 發送代幣指南。"
author: "金容俊"
tags: ["ETHERS.JS", "ERC-20", "代幣"]
skill: beginner
breadcrumb: "發送代幣"
lang: zh-tw
published: 2021-04-06
---

## 使用 ethers.js (5.0) 發送代幣 {#send-token}

### 在本教學中，您將學到如何 {#you-learn-about}

- 匯入 ethers.js
- 轉帳代幣
- 根據網路流量狀況設定 Gas 價格

### 開始使用 {#to-get-started}

要開始使用，我們必須先將 ethers.js 函式庫匯入到我們的 JavaScript 中
引入 ethers.js v5
### 安裝 {#install-ethersjs}

```shell
/home/ricmoo> npm install --save ethers
```

瀏覽器中的 ES6

```html
<script type="module">
  import { ethers } from "https://cdn.ethers.io/lib/ethers-5.0.esm.min.js"
  // 在此輸入您的程式碼...
</script>
```

瀏覽器中的 ES3 (UMD)

```html
<script
  src="https://cdn.ethers.io/lib/ethers-5.0.umd.min.js"
  type="application/javascript"
></script>
```

### 參數 {#param}

1. **`contract_address`**：代幣合約地址（當您想要轉帳的代幣不是以太幣時，需要合約地址）
2. **`send_token_amount`**：您想要發送給接收者的金額
3. **`to_address`**：接收者的地址
4. **`send_account`**：發送者的地址
5. **`private_key`**：發送者的私鑰，用於簽署交易並實際轉帳代幣

## 注意 {#notice}

已移除 `signTransaction(tx)`，因為 `sendTransaction()` 會在內部執行此操作。

## 發送程序 {#procedure}

### 1. 連接到網路（測試網） {#connect-to-network}

#### 設定提供者 (Infura) {#set-provider}

連接到 Ropsten 測試網

```javascript
window.ethersProvider = new ethers.providers.InfuraProvider("ropsten")
```

### 2. 建立錢包 {#create-wallet}

```javascript
let wallet = new ethers.Wallet(private_key)
```

### 3. 將錢包連接到網路 {#connect-wallet-to-net}

```javascript
let walletSigner = wallet.connect(window.ethersProvider)
```

### 4. 取得當前 Gas 價格 {#get-gas}

```javascript
window.ethersProvider.getGasPrice() // Gas 價格
```

### 5. 定義交易 {#define-transaction}

以下定義的這些變數取決於 `send_token()`

### 交易參數 {#transaction-params}

1. **`send_account`**：代幣發送者的地址
2. **`to_address`**：代幣接收者的地址
3. **`send_token_amount`**：要發送的代幣數量
4. **`gas_limit`**：Gas 限制
5. **`gas_price`**：Gas 價格

[有關如何使用，請參閱下文](#how-to-use)

```javascript
const tx = {
  from: send_account,
  to: to_address,
  value: ethers.utils.parseEther(send_token_amount),
  nonce: window.ethersProvider.getTransactionCount(send_account, "latest"),
  gasLimit: ethers.utils.hexlify(gas_limit), // 100000
  gasPrice: gas_price,
}
```

### 6. 轉帳 {#transfer}

```javascript
walletSigner.sendTransaction(tx).then((transaction) => {
  console.dir(transaction)
  alert("Send finished!")
})
```

## 如何使用 {#how-to-use}

```javascript
let private_key =
  "41559d28e936dc92104ff30691519693fc753ffbee6251a611b9aa1878f12a4d"
let send_token_amount = "1"
let to_address = "0x4c10D2734Fb76D3236E522509181CC3Ba8DE0e80"
let send_address = "0xda27a282B5B6c5229699891CfA6b900A716539E6"
let gas_limit = "0x100000"
let wallet = new ethers.Wallet(private_key)
let walletSigner = wallet.connect(window.ethersProvider)
let contract_address = ""
window.ethersProvider = new ethers.providers.InfuraProvider("ropsten")

send_token(
  contract_address,
  send_token_amount,
  to_address,
  send_address,
  private_key
)
```

### 成功！ {#success}

![image of transaction done successfully](./successful-transaction.png)

## send_token() {#send-token-method}

```javascript
function send_token(
  contract_address,
  send_token_amount,
  to_address,
  send_account,
  private_key
) {
  let wallet = new ethers.Wallet(private_key)
  let walletSigner = wallet.connect(window.ethersProvider)

  window.ethersProvider.getGasPrice().then((currentGasPrice) => {
    let gas_price = ethers.utils.hexlify(parseInt(currentGasPrice))
    console.log(`gas_price: ${gas_price}`)

    if (contract_address) {
      // 一般代幣發送
      let contract = new ethers.Contract(
        contract_address,
        send_abi,
        walletSigner
      )

      // 多少代幣？
      let numberOfTokens = ethers.utils.parseUnits(send_token_amount, 18)
      console.log(`numberOfTokens: ${numberOfTokens}`)

      // 發送代幣
      contract.transfer(to_address, numberOfTokens).then((transferResult) => {
        console.dir(transferResult)
        alert("sent token")
      })
    } // 以太幣發送
    else {
      const tx = {
        from: send_account,
        to: to_address,
        value: ethers.utils.parseEther(send_token_amount),
        nonce: window.ethersProvider.getTransactionCount(
          send_account,
          "latest"
        ),
        gasLimit: ethers.utils.hexlify(gas_limit), // 100000
        gasPrice: gas_price,
      }
      console.dir(tx)
      try {
        walletSigner.sendTransaction(tx).then((transaction) => {
          console.dir(transaction)
          alert("Send finished!")
        })
      } catch (error) {
        alert("failed to send!!")
      }
    }
  })
}
```