Chris Impey is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/chris-impey).

Chris Impey

Emma Hazel is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/emma-hazel).

Emma Hazel

Frank, 居住在香港, 從事 IT 行業，並為這個行業投身了大半生的精力。 沒事喜歡寫寫程式，看看書，玩 Instagram，玩貓。可他並不是一個『宅男』，他很喜歡旅行，遠的去過約旦，近的去過深水埗，每到一個地方，都讓他對這個世界有不同的認識。他也很喜歡寫網誌，認為寫作不僅能夠加深對知識的積累和認知，亦能夠讓人靜下心，坦誠面對自己。

Frank

Thomas Macaulay is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/thomas-macaulay).

Thomas Macaulay






之前有寫過一篇文章教大家<Link href="/blog/nft-smart-contract">自己15分鐘寫 ERC721 智能合約</Link>，這篇文章則說一說 ERC721 的升級版，ERC1155 智能合約。建議大家先看看關於 <Link href="/blog/nft-smart-contract">ERC721</Link> 的那篇文章。

### ERC1155 和 ERC721 有什麼區別

開始介紹 ERC1155 智能合約的寫法之前，我覺得先要說說 ERC1155 和 ERC721 到底有什麼區別。
簡單來說，ERC1155 是 ERC721 的升級版，ERC1155 在 ERC721 的基礎上，主要增加或改善了如下功能：

- 同時支持可替換代幣(同質化代幣)和不可替換代幣(非同質化代幣)；
- 批量轉賬: 僅需要一次智能合約調用，就可以轉賬多種代幣資產；
- 批量查詢餘額：一次智能合約調用可以查詢多種代幣餘額資料；
- 批量授權：一次智能合約調用可以向指定地址授權多種代幣的使用權；

用再簡單一些的人話來講，就是一張 ERC1155 智能合約，裡面可以同時包含類似 USDT 這種代幣，和類似 [MekaVerse](https://opensea.io/collection/mekaverse) ，[無聊猿](https://opensea.io/collection/boredapeyachtclub)等這種獨一無二的 NFT 代幣。 另外，傳統的 ERC721 合約，如果要轉移 NFT，必須一個一個操作，沒有辦法做到批量轉賬。而 ERC1155，則宛如加入了類似「購物車」的概念，可以一堆代幣一次過轉移。不要小看這個「批量」功能，要知道每次和區塊鏈交互，都要消耗 gas，如果有某些應用場景需要大量，頻繁轉移資產，那 ERC1155 相比 ERC721 則能節約大量的 gas 成本。

我們可以試想一下，假如現在想要創作一款區塊鏈遊戲，裡面有類似 USDT 的可替換同質化代幣以進行金融操作，也需要有各種遊戲裝備，英雄角色等獨一無二不可替換代幣來進行遊戲，這兩種代幣也需要透過一定的機制進行交易互換，這個場景，使用 ERC1155 則可以完美實現。

我們不妨對比一下 ERC721 和 ERC1155 合約的規範接口：  
  
ERC721
```js

function balanceOf(address _owner) external view returns (uint256);
function ownerOf(uint256 _tokenId) external view returns (address);
function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;
function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;
function transferFrom(address _from, address _to, uint256 _tokenId) external payable;
function approve(address _approved, uint256 _tokenId) external payable;
function setApprovalForAll(address _operator, bool _approved) external;
function getApproved(uint256 _tokenId) external view returns (address);
function isApprovedForAll(address _owner, address _operator) external view returns (bool);
```

ERC1155
```js
function safeTransferFrom(address _from, address _to, uint256 _id, uint256 _value, bytes calldata _data) external;
function safeBatchTransferFrom(address _from, address _to, uint256[] calldata _ids, uint256[] calldata _values, bytes calldata _data) external;
function balanceOf(address _owner, uint256 _id) external view returns (uint256);
function balanceOfBatch(address[] calldata _owners, uint256[] calldata _ids) external view returns (uint256[] memory);
function setApprovalForAll(address _operator, bool _approved) external;
function isApprovedForAll(address _owner, address _operator) external view returns (bool);
```

可以明顯看到，ERC1155 在原有 ERC721 基礎上增加了很多 batch 的接口。再看看 OpenZeppelin 中的 ERC1155 實現，其中的 mint function 增加了 `amount` 參數， 不難想象，如果 `amount = 1`， 則代表這個代幣總共只發行一個，那這個代幣就是類似 ERC721 的 NFT 了。 

```js
function _mint(
    address account,
    uint256 id,
    uint256 amount,
    bytes memory data
) internal virtual {
    require(account != address(0), "ERC1155: mint to the zero address");
    address operator = _msgSender();
    _beforeTokenTransfer(operator, address(0), account, _asSingletonArray(id), _asSingletonArray(amount), data);
    _balances[id][account] += amount;
    emit TransferSingle(operator, address(0), account, id, amount);
    _doSafeTransferAcceptanceCheck(operator, address(0), account, id, amount, data);
}
```

說完了基本概念，下面我們就來 get your hands dirty，親手嘗試一下寫一個 ERC1155 智能合約，你會發現，其實遠比你想象的簡單。
 

### 15分鐘快速建立 ERC1155 智能合約

#### OpenZeppelin 
我們這個示例，依舊使用 OpenZeppelin 的合約為範本。[OpenZeppelin](https://openzeppelin.com/) 是一個開源的智能合約倉庫，上面已經有許許多多各種各樣的智能合約範本，包括 ERC721，ERC1155 等智能合約。因此我們只需要基於 OpenZeppelin 的現有合約，擴展我們自己特定的功能即可。

#### 安裝 OpenZeppelin Contracts

確保已經安裝最新版的 NodeJS，運行下面的指令：

```bash
npm install @openzeppelin/contracts
```

之後在當前目錄下就會安裝好 OpenZeppelin Contracts 的檔案。

#### 使用 Remix IDE

[Remix](https://remix.ethereum.org/) 是 Ethereum 官方提供的 IDE 。包含完整的編譯器、執行合約、發布合約等等的功能。無須安裝，只要用瀏覽器開啟 [https://remix.ethereum.org/](https://remix.ethereum.org/) 即可。

Remix 默認情況下會將所有資料存儲在瀏覽器的 Local Storage 中，所以當你清除瀏覽器緩存快取，或者在另外一台電腦打開 Remix，你的資料便會丟失。 Remix 也提供了使用本地文件系統來進行存儲的功能，但需要安裝一個 remixd 本地程式，具體方法可以[參考這裡](https://remix-ide.readthedocs.io/en/latest/remixd.html)。

當你安裝好 remixd 後，便可以透過運行下面的指令來建立 Remix 和本地檔案的連結：

```bash
remixd -s <absolute-path-to-the-shared-folder> --remix-ide <your-remix-ide-URL-instance>
```

#### 撰寫智能合約

完成上面的步驟後，我們便可以開始建立自己的 ERC1155 合約了。

![](/image/blog/qy2tu.png)


```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/token/ERC1155/presets/ERC1155PresetMinterPauser.sol";


contract Marvel1155 is ERC1155PresetMinterPauser {
    
    uint256 public constant CAPTAIN_AMERICA = 0;
    uint256 public constant THOR = 1;
    uint256 public constant IRON_MAN = 2;
    uint256 public constant SPIDER_MAN = 3;
    
    constructor() ERC1155PresetMinterPauser( "https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json") {
        _mint(msg.sender, CAPTAIN_AMERICA, 10**18, "");
        _mint(msg.sender, THOR, 1, "");
        _mint(msg.sender, IRON_MAN, 5, "");
        _mint(msg.sender, SPIDER_MAN, 10, "");
    }
    
}

```

以上的代碼便是利用 OpenZeppelin 的 ERC1155 合約建立，我們只需要非常簡單的幾行代碼，便可以完成一個 ERC1155 智能合約。

簡單解釋一下以上代碼的意思：  

```js
uint256 public constant CAPTAIN_AMERICA = 0;
uint256 public constant THOR = 1;
uint256 public constant IRON_MAN = 2;
uint256 public constant SPIDER_MAN = 3;
```

上面這段代碼，是定義了這個合約中有幾種「類型」的代幣。（當然，直接在 mint 的時候傳入自定義類型也是可以的😂)

```js
constructor() ERC1155PresetMinterPauser( "https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json") {
    _mint(msg.sender, CAPTAIN_AMERICA, 10**18, "");
    _mint(msg.sender, THOR, 1, "");
    _mint(msg.sender, IRON_MAN, 5, "");
    _mint(msg.sender, SPIDER_MAN, 10, "");
}
```

上面這段代碼，則是「構造器」，在智能合約發佈的時候會被調用，挖掘了4款不同的代幣，每個代幣的發行總量分別是 10 <sup>18</sup>，1，5，10。因此可以理解為，THOR 這個代幣，就是一個 NFT，而其他的代幣，則是類似 ERC20 的同質化代幣。

「構造器」中傳入的 `https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json` 是代幣對應的 URI，這個和 ERC721 的概念是一樣的，OpenSea， Rarible 等 NFT 市場，會訪問這個 URI，去取得代幣的 metadata，下面我們會再講到。


#### 編譯，發布智能合約

編輯完成後， 就可以切換到 Compile 面板進行編譯。留意要選擇正確的編譯器版本，編譯器版本要和你合約中聲明的版本相符合，否則無法編譯。

![](/image/blog/cjoqp.png)

編譯完成後，便可以準備發布（deploy）了。切換到 Deploy 面板。此時我們要在左上角的 Environment 中選擇【Injected Web 3】，此時便會彈出 MetaMask 進行連結。如果還沒有安裝 MetaMask，可以先在 [Chrome Web Store](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn) 中安裝。

我們開始嘗試時一般都會選擇在測試網路（testnet）中進行，測試網絡和 Ethereum 主網在技術上沒有區別，但在測試網路中不需要花費真實的 ETH ，而是使用測試網路中的 ETH。一般我們開發的 Blockchain 程式，都要先在測試網路上做全面測試，之後才在主網中上線。要知道 Ethereum 主網的 Gas Fee 可高的驚人。

Ethereum 的測試網路有很多，例如 Ropsten， Rinkeby，Goerli 等等。為了能在 OpenSea 上測試，我們選擇 Rinkeby 測試網路（OpenSea 的testnet 預設為 Rinkeby 測試網路）。

使用測試網路，記得要在 MetaMask 中選擇 Rinkeby Test Network。

![](/image/blog/dmybz.png)

在 Ethereum 網路上任何導致更改數據的動作都需要花費 ETH，因此發布智能合約自然需要 ETH。如果沒有 testnet 的 ETH 可以在網上找到很多 testnet faucet 可以免費獲得 testnet 的 ETH ，例如[這裡](https://faucet.rinkeby.io/)。一切就緒後，就可以按下 【Deploy】，開始發布你的智能合約，中間會彈出 MetaMask 進行付款確認。

發布完成後，Remix 會顯示對應的 Transaction Hash，例如我自己上面的例子，對應的 Transaction 可以在 [https://rinkeby.etherscan.io](https://rinkeby.etherscan.io) 上看到，裡面亦可以看到我們建立的 ERC1155 智能合約地址。

![](/image/blog/vnoyw.png)

因為我們的示例合約中在構造器( constructor ) 中已經 mint 了4 種代幣，因此當合約發佈後，[在 OpenSea 中已經可以即時看到](https://testnets.opensea.io/collection/unidentified-contract-73ffvqbzsk)。

![](/image/blog/rcv3n.png)

#### Mint NFT

回到 Remix，可以看到 Deployed Contracts 中已經有我們剛才發布的智能合約，點開他之後可以看到裡面有一個 mint 的 Function，現在我們就可以調用這個 Function 來 Mint NFT 了。這個 mint function 需要傳入四個參數，分別是`擁有者地址`，`token id`，`發行數量`和`附加數據`。附加數據在 ERC1155 規範中並沒有指定用途，因此這個參數可以根據自己的需要來傳遞任何數據，如果沒有的話傳遞空值即可。

![](/image/blog/5bytu.png)

![](/image/blog/kkkmu.png)

當 mint 完成後，稍等一段時間便可以在 [OpenSea 中看到對應的 NFT](https://testnets.opensea.io/collection/unidentified-contract-73ffvqbzsk) 已經誕生了！

![](/image/blog/jzair.png)
 
到這裡其實我們已經完成了一個最基本的 NFT 的建立。

如果你是照抄我上面的例子😏，你 mint 出的 NFT 應該已經有圖案，名稱了。但你可能會問假如我要改 token 的名稱，圖像，屬性要怎麼做呢？

原來 NFT 對應的圖像以及其他屬性是由 NFT 的 Metadata 決定，要想 NFT 在 OpenSea 等平台 中顯示圖像和其他屬性，還需要指定該 NFT 的 Metadata。

我上面的例子之所以會有圖像，因為  `https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json` 這個地址會對應傳入的 `token id` 返回該 token 的 metadata，  而裡面則包括了 token 的圖像，名稱，描述等資料。

#### ERC721 Metadata

根據 OpenSea 上的 [Metadata 標準](https://docs.opensea.io/docs/metadata-standards)，OpenSea 會調用我們智能合約中的 `uri`  function，並傳入 tokenID，而這個 function 需要返回一個 HTTP 或 IPFS URL，這個 URL 則必須返回一個 JSON 格式的數據，例如[我例子中的這個](https://api.frank.hk/api/nft/demo/1155/marvel/1.json)，而這個 JSON 則定義了我們 NFT 的各種屬性。

![](/image/blog/uiaaw.png)

![](/image/blog/df4uq.png)

用我們上面寫的智能合約為例，留意我們在 constructor 中有如下寫法：

```js
constructor() ERC1155PresetMinterPauser( "https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json") {
    ...
}
```

其中 `https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json` 便是指定了我們 token 的 URI，當調用 `uri`  function 時，我們的合約就會 return `https://api.frank.hk/api/nft/demo/1155/marvel/{id}.json`。`{id}` 是一個「變數」， NFT 市場會將這個變數替換為對應的 token id 。

當這個 Metadata 設置好後，再 mint 出的 NFT 就會帶有圖像等屬性了。

![](/image/blog/nhhyf.png)


上面說過， ERC1155 和 ERC721 最大的不同，就是 ERC1155 可同時支援可替換代幣(同質化代幣)和不可替換代幣(非同質化代幣)，這點我們可以在 OpenSea 中清楚的看到。

![](/image/blog/zg8rf.png)

上面這個例子，因為 Iron Man 這個 token ， mint 時發行量輸入了 5 ， 而 Thor 這個 token 發行量僅為 1，所以我們看到 OpenSea 上的顯示會有不同。Thor 的顯示，則和 ERC721 的 NFT 類似。

在出售的時候，也會多出了數量選擇。

![](/image/blog/gatdv.png)


以上就是一個超級簡單的自己寫代碼製作 ERC1155 NFT 的教學了。如果有任何討論，或是錯誤指正，歡迎聯絡我不吝賜教。

感謝閱讀。



ERC1155 是 ERC721 的升級版，ERC721 和 ERC1155有什麼不同？如何用代碼快速寫一個屬於你自己的 ERC1155 NFT 智能合約並發佈到 OpenSea 上？進來看一看吧。

使用 Remix，OpenZeppelin 15 分鐘建立 NFT ERC 1155 智能合約



最近有留意一些 NFT 的項目專案，發現絕大多數都是採用了「盲盒模式」來玩，即購買的時候並不知道裡面是什麼，等到了一定的時間後，盲盒會開啟，才會知道你買的 NFT 具體的屬性，是否稀有等。

![MekaVerse 盲盒](/image/blog/xzyot.png)

這裏我們不討論 Marketing 的做法，純粹從技術角度探討一下「盲盒模式」要怎麼做到。

我<Link href="/blog/nft-smart-contract">之前寫過一篇文章</Link>講怎樣輕鬆編寫 ERC 721 智能合約，裡面有說過 NFT 在 OpenSea 等市場中顯示的名稱，圖像，屬性等資料，完全是由 NFT 的 metadata 決定，而 metadata 則是靠調用 NFT 智能合約中的 `tokenURI` function 而得到。因此，這個 metadata 並不是像大家想像的一樣不可更改，只要能夠讓智能合約返回不同的 `tokenURI`, 則在市場中顯示的圖像以及屬性就會隨之更改。

聰明的你可能想到，如果 `tokenURI` 是一個 http 連接，即 metadata 是存放在傳統伺服器中，則非常容易做到這個效果。只要修改伺服器程式，返回完全不同的 metadata 即可。沒錯，但如果 `tokenURI` 是一條 IPFS 連結，那要如何處理？ IPFS 不是不可更改嗎？ 哈哈，是的 IPFS 連結是不能更改，但是 `tokenURI` 可以呀。只要對智能合約的代碼做一點更改，便可以輕鬆做到效果。

我們的大概思路是，有一個開關參數控制盲盒開啟與否，如果 true，則 `tokenURI` 將返回一條盲盒專用的 metadata IPFS 連結，裡面的 name，image 等都是固定的名稱和圖像。另外我們還需要有兩個 function ，供授權的地址調用，一個用以改變上述開關參數的狀態，另一個用以設定盲盒開啟後新的 `baseURI`。等到開啟盲盒的神聖日子來臨，被授權的地址調用這兩個 function，即可揭開盲盒的神秘面紗。

(當然，聰明的你也應該想到，不使用開關參數，完全依靠更改`baseURI` 也是可以的。只是我覺得有個開關更容易操作一些)

以下是參考的代碼：

```bash
abstract contract BaseERC721BlindBox is BaseERC721 {
    using Strings for uint256;
    bool private _blindBoxOpened = false;
    string private _blindTokenURI =
        "ipfs://QmexqcLDvoP6HCTtSGumG3yzhZdH8guvV3z3kReCvf2QKn";

    function _isBlindBoxOpened() internal view returns (bool) {
        return _blindBoxOpened;
    }

    function setBlindBoxOpened(bool _status) public {
        require(
            hasRole(DEFAULT_ADMIN_ROLE, _msgSender()),
            "BaseERC721BlindBox: only admin can do this action"
        );
        _blindBoxOpened = _status;
    }

    // this function controls how the token URI is constructed
    function tokenURI(uint256 tokenId)
        public
        view
        virtual
        override
        returns (string memory)
    {
        require(
            _exists(tokenId),
            "ERC721Metadata: URI query for nonexistent token"
        );

        if (_blindBoxOpened) {
            string memory baseURI = _baseURI();
            return
                bytes(baseURI).length > 0
                    ? string(
                        abi.encodePacked(baseURI, tokenId.toString(), ".json")
                    )
                    : "";
        } else {
            return _blindTokenURI;
        }
    }
}
```

當盲盒沒有開啟時，進入 OpenSea 看到的會是[這樣](https://testnets.opensea.io/collection/cute-marvel-characters-v3)：
![](/image/blog/1wyst.png)

當盲盒開啟後，進入 OpenSea 看到的會是[這樣](https://testnets.opensea.io/collection/cute-marvel-characters-v4)：
![](/image/blog/gqqyq.png)


最近 NFT 很火爆，留意到絕大多數 NFT 項目專案都是採用了「盲盒模式」來玩，即購買的時候並不知道裡面是什麼，等到了一定的時間後，盲盒會開啟，才會知道你買的 NFT 具體的屬性，是否稀有等。本文純粹從技術角度探討一下「盲盒模式」要怎麼做到。

Smart Contract 智能合約玩轉 NFT 盲盒模式


OpenSea 是目前最大的 NFT 交易平台，就宛如現實世界中的 Amazon ， 淘寶網一樣。如果嘗試過在 OpenSea 中出售自己擁有的 NFT，估計你都會有印象，前後要經歷 3 次和 MetaMask 的「互動」， 可是你究竟是否了解這三次「互動」究竟是在做什麼？


## 上架 NFT

下面的影片，展示了在 OpenSea 上架的過程：



<div class="video-container" style={{paddingTop: "58%"}}>
<iframe
  src="https://player.cloudinary.com/embed/?cloud_name=dxuoive6n&public_id=UD/sell-nft-from-opensea_u7lljb&fluid=true&controls=true&source_types%5B0%5D=mp4"
  allow="autoplay; fullscreen; encrypted-media; picture-in-picture"
  allowfullscreen
  frameborder="0"
></iframe>
</div>

 
我們可以看到，過程中前後需要經歷 Initialize Wallet ，Approve Token，Confirm Listing 三個步驟，這三個步驟分別是在做什麼呢？


### Initialize Wallet


![](/image/blog/8ppkh.png)

我們可以從 MetaMask 中看到，所謂 Initialize Wallet， 其實是調用 OpenSea 上的「Proxy Registry」裡的一個 「Register Proxy」的 function。 從 [Etherscan](https://rinkeby.etherscan.io/tx/0x8c1563f458fc484d76e7e0b1926752c8d187ddad526f1711f5b886be18936233#internal) 上可以看到，這個 function 建立並部署了一個新的智能合約 `0x...548c`，也就是所謂的 Proxy 合約。

根據 OpenSea 的說明：「On OpenSea, each user has a "proxy" account that they control, and is ultimately called by the marketplace contracts to trade their items.」得知，每一個 OpenSea 賬戶， 都會有一個 Proxy 合約與之對應，因此如果是一個全新的賬戶，就必須要經過這個「部署 Proxy 合約」的步驟，但如果已經擁有了 Proxy 合約，則下次上架 NFT 就不需要再次部署了。

因為這個操作需要改寫區塊鏈的數據，因此需要支付礦工費。另外因為需要進行合約部署，礦工費用也會相較其他操作更貴。


### Approve Token

![](/image/blog/ynwsz.png)

Approve Token 則比較容易理解。有沒有想過你擁有的 NFT，為什麼 OpenSea 能夠代你賣給別人？它哪裡來的權力呢？答案就是這個步驟，我們看到這個 Approve Token 其實是調用了「Set Approval For All」function， 透過查看ERC721原始碼發現，這個 Set Approval For All ， 其實就是一個授權操作，一旦授權，被授權的地址將可以調用 transferFrom 將 NFT 的擁有權轉移到另一個地址。

![](/image/blog/nkspk.png)

從 [Etherscan](https://rinkeby.etherscan.io/tx/0x9cf04947041e4b081aa2edcab3cfc8cba9cbdaf48d2bcfb0d3ed787b73fbf2f1) 上看到，這個授權操作傳入了一個被授權地址，`0x...548c` ，而這個地址，正正是上面第一步「Initialize Wallet」時新建立的合約地址，也就是說，這一部完成後，你作為 NFT 的擁有者，便授權了`0x...548c` 這個合約可以轉移你的 NFT 資產。

因為這個操作也需要改寫區塊鏈的數據，因此也是需要支付礦工費的。

### Confirm Listing

![](/image/blog/mkhge.png)

最後一步 Confirm Listing， 則最為簡單，這個操作並沒有改寫任何區塊鏈的內容，因此不需要支付任何費用。這個操作是使用你的私鑰簽名一段信息，用以讓 OpenSea 認證你的身份，確認「你是你」，認證成功後才會代你進行上架操作。


## 購買 NFT

對比上架 NFT， 購買 NFT 則相對簡單。即便是新的帳戶，亦不需要太多的步驟。

![](/image/blog/kpjli.png)

購買的操作，調用了 OpenSea 交易所合約中的 「atomic match」function，這個 function 最後會做幾件事：

1. 轉帳該筆金額的 97.5% 給NFT 原擁有者；
2. 轉帳該筆金額的 2.5% 給 OpenSea；
3. 透過上面的 proxy 合約，調用 NFT 合約的 `transferFrom` function，轉移 NFT；

![](/image/blog/uiwpy.png)

至此，一個 NFT 的交易便完成了。 

透過查看 Etherscan 不難發現，OpenSea 背後使用的是 [Wyvern Protocol](https://wyvernprotocol.com/)  ， 這是一個基於以太坊的開放協議，用以交易虛擬資產。網上似乎並沒有太多的關於這個協議的資料。以後有時間再研究一下。

![](/image/blog/nqtrw.png)

 


OpenSea 是目前最大的 NFT 交易平台，就宛如現實世界中的 Amazon ， 淘寶網一樣。如果嘗試過在 OpenSea 中出售自己擁有的 NFT，估計你都會有印象，前後要經歷 3 次和 MetaMask 的「互動」， 可是你究竟是否了解這三次「互動」究竟是在做什麼？

OpenSea 簡易運作原理



以太坊的智能合約程式一旦發佈便無法更改，因此程式的安全性尤為重要。因此，使用檢測工具對程式碼進行檢測，可以發現一些常見的安全隱患，避免因程式漏洞引致的各種損失。

![Slither](/image/blog/ps5gm.png)

Slither 是一個用 Python 編寫的 Solidity 的「靜態」檢測工具，可以偵測常見的 Solidity 程式漏洞。其功能包括：

- 檢測 Solidity的常見程式漏洞，誤報率低；
- 標識錯誤在源程式中發生的位置；
- 可以集成到 CICD 中使用；
- 正確解析 99.9% 的所有公共 Solidity 程式；
- 掃描速度快，每個智能合約平均執行時間少於 1 秒；

### 安裝

[官網](https://github.com/crytic/slither#how-to-install)提供了多種安裝方式，因為考慮到有太多的依賴和開發環境設定，作為一個懶人，本人認為用 docker 方式安裝會最方便，因此本文就以 docker 安裝來舉例，其他安裝方式可以查閱[官網](https://github.com/crytic/slither#how-to-install)的說明。

安裝 docker image：

```bash
docker pull trailofbits/eth-security-toolbox
```

安裝 docker image 之後就可以運行 slither 了，但要記得指定 docker 共享 volume，這樣才可以在 docker 容器內訪問到電腦中的檔案：

```bash
docker run -it -v /your/share/folder:/share trailofbits/eth-security-toolbox
```

執行上述指令後便進入了 slither 的 container 中：

![](/image/blog/e69g4.png)

###  檢查 solc 版本

這裡要注意，因為 solidity 有很多不同的版本，掃描時最好根據要掃描的 solidity 檔案指定對應版本的 solc 編譯器。而預設的 image 中未必有你想要的 solc 編譯器版本，你可以在 container 內運行以下指令，可以查看已經安裝的 `solc`  編譯器：

```bash
solc-select -l
```

如果發現沒有安裝對應的 solc 版本，則需要先安裝 solc 後再繼續。

```bash
# 將下面的 v0.4.15 更改為你所需要的版本

curl -L https://github.com/ethereum/solidity/releases/download/v0.4.15/solc-static-linux --output solc-v0.4.15

sudo mv ./solc-v0.4.15 /usr/bin/

chmod +x /usr/bin/solc-v0.4.15
```

### 掃描本地 sol 檔案

因為共享了共享目錄，我們在 container 就可以直接運行 slither 指令：

```bash
slither path_to_your_contract.sol --solc /usr/bin/solc-v0.4.15 
```

其中 `path_to_your_contract.sol` 是你要掃描的 solidity 檔案， `--solc /usr/bin/solc-v0.4.15` 則是指定 solc 編譯器的版本。

![](/image/blog/mwo8l.png)

如上圖所示， slither 會在熒幕上顯示出掃描結果。根據問題的嚴重程度，會有不同的顏色表示。同時亦會給出問題的解釋，可以點開相應的連結查看。

如果想要將掃描結果以 json 形式輸出到檔案中，可以執行：

```bash
slither path_to_your_contract.sol --solc /usr/bin/solc-v0.4.15 --json result.json
```


如果你的智能合約中使用了類似 `import @openzeppelin/xxx` 等的以 “@” 開頭的 import 語句，可能會出現  File not found 的錯誤：

```bash
Error: Source "@openzeppelin/contracts/utils/Counters.sol" not found: File not found.
  --> /src/contracts/BaseERC721.sol:12:1:
   |
12 | import "@openzeppelin/contracts/utils/Counters.sol";
   | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
```

解決方法是需要指定 `--solc-remaps` 來告訴編譯器 openzeppelin 的具體位置：

```bash

slither path_to_your_contract.sol --solc /usr/bin/solc-v0.4.15 --solc-remaps @openzeppelin/=/src/node_modules/@openzeppelin/

```


### 掃描已經發佈的合約

slither 亦支援掃描已經將原始碼發佈到 etherscan 上的合約， 運行：

```bash
# 0x7F37f78cBD74481E593F9C737776F7113d76B315 是合約地址。
slither 0x7F37f78cBD74481E593F9C737776F7113d76B315

# 若是 testnet 網絡，地址前加上網絡名稱
slither rinkeby:0x7F37f78cBD74481E593F9C737776F7113d76B315
```

如果運行出現錯誤，可能是 solc 版本不相符， 使用 `solc-select` 切換到對應版本後再運行即可。如果對應版本沒有安裝，請參考上一節的做法安裝即可。







以太坊的智能合約程式一旦發佈便無法更改，因此程式的安全性尤為重要。因此，使用檢測工具對程式碼進行檢測，可以發現一些常見的安全隱患，避免因程式漏洞引致的各種損失。本文介紹使用 Slither 這個工具來進行 Solidity 檢測。

使用 Slither 來檢測你的 Solidity 智能合約程式碼

當我們逐漸邁向 Web3.0 的今天，原本的網站登入需要透過用戶名密碼的方式，現在又多了一個選擇。只要有一個數字貨幣錢包，便可以使用這個錢包作為身分認證的方式，完全不需要記住複雜的用戶名和密碼。本文將介紹和示範整個使用 MetaMask 錢包登入系統的流程。

使用 MetaMask 登入第三方網站

NTF 最近是街頭巷尾都在討論。本文將站在技術角度，教一教大家怎樣用代碼寫一個屬於你自己的 NFT 智能合約。

使用 Remix，OpenZeppelin 15 分鐘建立 NFT 智能合約

IPFS 是最近討論非常多的話題，經過自己嘗試，加上資料整理，本文用問答的形式來簡單介紹一下 IFPS 這個東西。

IPFS 問與答




IPFS 是一個非常科幻的檔案存儲系統。 如果想了解什麼是 IPFS，可參考這篇文章：<Link href="/blog/ipfs-q-and-a">IPFS 問與答</Link>

如果你有一台裝有 Docker 的伺服器，可以很方便的安裝 IPFS ，使你的伺服器變為 IPFS 中的一個節點。

IPFS 官方有提供 Docker 的[安裝指引](https://hub.docker.com/r/ipfs/go-ipfs/)， 我這裡將它變為 docker-compose 更容易操作一些。
### 步驟一
建立一個 docker-compose.yml 檔案，內容如下：
```bash
version: '3'
services:
  ipfs:
    image: ipfs/go-ipfs:latest
    container_name: ipfs_host
    volumes:
      - ./export:/export
      - ./ipfs_data:/data/ipfs
    ports:
      - '4001:4001'
      - '4001:4001/udp'
      - '127.0.0.1:8080:8080'
      - '127.0.0.1:5001:5001'
```
其中 5001 port 為 API 以及 WEB UI，8080 為 Proxy Gateway。 具體內容可以參閱官方網站詳細了解。
### 步驟二
確認伺服器已經安裝 docker， docker-compose ，在相同路徑下執行：
```bash
docker-compose up
```
即可。
### 步驟三
當 docker-compose up 成功啟動後，訪問瀏覽器 `localhost:5001/webui` 
即可開啟 WEB 界面：
![IFPS Web 管理界面](/image/blog/qsy1f.png)
在 WebUI 界面中可以看到你當前的節點的狀態，連接到了多少 peers，你也可以方便的在 WebUI 中添加檔案到 IPFS 中。

![](/image/blog/s09nn.png) 

### 可能遇到的問題 1
我第一次安裝時遇到了 WebUI 無響應的情況，即 127.0.0.1:5001/webui 無法開啟，半天沒有反應。查看 log 後發現因為我們使用 Docker 的形式安裝，而我的Docker Network 設定使得位於 Docker Container 內的 IPFS Deamon 無法連接 peers 導致。 解決這個問題，需要查看 Docker Container 的網絡設定：

```bash
docker inspect < your docker container id or name>
```

你會看到 Container 位於  172.19.0.0 subnet：

```bash
"IPAM": {
            "Driver": "default",
            "Options": null,
            "Config": [
                {
                    "Subnet": "172.19.0.0/16",
                    "Gateway": "172.19.0.1"
                }
            ]
        },
```

因此需要添加 firewall rules 允許網絡連接：

```bash
firewall-cmd --permanent --zone=public --add-rich-rule='rule family=ipv4 source address=172.19.0.0/16 accept'

firewall-cmd --zone=public --add-masquerade --permanent

firewall-cmd --reload
```

### 可能遇到的問題 2

打開 WebUI 界面後，可能出現無法連接 API 的情況：
![](/image/blog/l8f0t.png)

這個是因為 API 跨域訪問限制導致，按照界面提示添加對應的 rules 即可：

```bash
docker exec ipfs_host ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["http://www.yourdomain.com:5001","https://www.yourdomain.com","https://www.yourdomain.com","http://localhost:3000", "http://127.0.0.1:5001", "https://webui.ipfs.io"]'
[root@LS-820311-4279 ipfs]# docker exec ipfs_host ipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '["PUT", "POST"]'
```



IPFS 一個嶄新，自由，分佈式的檔案系統，安裝一個 IPFS 節點其實非常簡單，本文介紹用 Docker 的方式安裝 IPFS 節點，在 15 分鐘內即可完成。