# 月言錢包 Scan Api

[TOC]

## 圖例

| ❓ | ❌ | ✅ |
| ------- | ------ | ---- |
| 缺少api | 不正常 | 正常 |

## Block 類
### ❌查詢 全部的 Block 資訊，顯示於Datatable 上

`/blocks-table?page={index}`

**輸入:**
- int, 目前頁碼

**輸出:**
- double, network Utilization 值。**此頁**資料的平均使用 gas 佔 gas limit 的百分比
- String, total burnt fee。自 EIP-1559 開始至今已銷毀的MNC。格式為hex，單位為wei
- int, block 總數
- List, 查詢結果
#### 每個查詢結果
- int, block 高度
- int, transaction 的時間戳記。格式為 unix timestamp in milliseconds
- int, block 所含的交易數
- String, 驗證者 (validator) 的地址
- int, gas used
- int, gas limit
- String, base fee。格式為 hex，單位為wei
- String, gas fee。格式為 hex，單位為wei
- String, reward。格式為 hex，單位為wei
- double, burnt fee。單位為MNC

---

## Transaction 類
### ✅查詢 全部的 Transaction 資訊，顯示於Datatable 上

`/transactions?page={index}`

**輸入:**
- int, 目前頁碼

**輸出:**
- List, 查詢結果
#### 每個查詢結果
- String, transaction hash 值
- String, method 名稱。如果是未知的 function，則回傳method id
- int, transaction 的時間戳記。格式為 unix timestamp in milliseconds
- String, transaction 的發起地址
- String, transation 的目標地址
- boolean, 目標地址是否為合約。true 則為合約，false 則為錢包
- String, transation 的交易值。格式為 hex，單位為wei
- String, transaction fee。格式為 hex，單位為wei

---

### ✅查詢 address 中的 Transaction 資訊，顯示於Datatable 上

`/transactions/by-addr/{addr}`

**輸入:**
- String, 地址
- int, 目前頁碼

**輸出:**
- List, 查詢結果
#### 每個查詢結果
- String, transaction hash 值
- String, method 名稱。如果是未知的 function，則回傳method id
- int, transaction 的時間戳記。格式為 unix timestamp in milliseconds
- String, transaction 的發起地址
- String, transaction 的目標地址
- boolean, 目標地址是否為合約。true 則為合約，false 則為錢包
- String, 交易量。格式為 hex，單位為wei
- String, transation fee。格式為 hex，單位為wei

---

### ✅查詢 Block 中的 Transaction 資訊，顯示於Datatable 上

`/transactions/by-height/{height}`

**輸入:**

- String, block 的高度
- int, 目前頁碼

**輸出:**
- List, 查詢結果
#### 每個查詢結果
- String, transaction hash 值
- String, method 名稱。如果是未知的 function，則回傳method id
- int, transaction 的時間戳記。格式為 unix timestamp in milliseconds
- String, transaction 的發起地址
- String, transation 的目標地址
- boolean, 目標地址是否為合約。true 則為合約，false 則為錢包
- double, transation 的交易值。單位為MNC
- String, transaction fee。格式為 hex，單位為wei

## Address 類

### ❓查詢 Address 資訊

<!-- :::warning
先暫停因為還不確定幣別有哪些
::: -->

**輸入:**
- String, 查詢的Address

**輸出:**
- double, 可動用餘額。單位為MNC
- double, 當前MNC對美金匯率
- List, 總持有的Token
#### 每個持有Token
- String, Token 名稱
- String, Token 名稱縮寫或是符號
- String, 幣合約地址
- double, 當前MNC對美金價格
- String, Token 的類型。格式為 hex
- double, Token 的持有量。

## Token 類

### ❓查詢 Token 的資訊

<!-- :::warning
先暫停因為還不確定幣別有哪些
::: -->

**輸入:**
- String, 幣合約地址

**輸出:**
- String, Token 的類型。格式為 hex;
- String, Token 名稱;
- String, Token 名稱縮寫或是符號;
- String, 幣合約地址;
- String, Token 圖片 url。若無則傳入空字串;
- double, 當前Token兌美金價格。若無則傳入-1;
- double, 總供應量;
- double, 24小時內的價格變化。若無則傳入-1
- int, Token 的持有人數量;
- int, 轉移次數。若無則傳入-1;
- int, Token 最小會有幾個位數;
- String, 網站。若無則傳入空字串;
- List, 幣合約互動紀錄
#### 每個幣合約互動紀錄：
- String, transaction hash 值
- String, 方法名稱。如果是未知的 function，則回傳method id
- int, transaction 的時間戳記。格式為 unix timestamp in milliseconds
- String, transaction 的發起地址
- String, transation 的目標地址
- double, 交易數量

### ❓查詢錢包中的 Token 的資訊，顯示於 Datatable 上

<!-- :::warning
先暫停因為還不確定幣別有哪些
::: -->

**輸入:**
- String, 錢包地址

**輸出:**
- List, 查詢結果
#### 每個查詢結果
- String, Token 的類型。格式為 hex;
- String, Token 名稱;
- String, Token 名稱縮寫或是符號;
- String, 幣合約地址;
- String, Token 圖片 url。若無則傳入空字串;
- double, 當前Token兌美金價格。若無則傳入-1;
- double, 總供應量;
- double, 24小時內的價格變化。若無則傳入-1。
- int, 轉移次數。若無則傳入-1;
- int, Token 最小會有幾個位數;
- String, 網站。若無則傳入空字串;