本篇文章會(huì)從最基礎(chǔ)的概念開(kāi)始講如何進(jìn)行ens合約調(diào)用編程

以太坊系統(tǒng)

剛接觸以太坊時(shí)摊腋，我們會(huì)頻繁看到geth锦秒，web3.js, contract等概念旋炒。

1. geth
   geth是以太坊的golang節(jié)點(diǎn)尤泽。這是以太坊中最核心的部分，大量的節(jié)點(diǎn)組成了以太坊網(wǎng)絡(luò)巾钉，geth負(fù)責(zé)與其他節(jié)點(diǎn)進(jìn)行通信翘狱，獲取和更新全網(wǎng)賬單。我們對(duì)鏈上合約的調(diào)用睛琳，最后都需要通過(guò)geth節(jié)點(diǎn)提交到區(qū)塊鏈上盒蟆。

2. web3.js
   geth啟動(dòng)后會(huì)對(duì)外暴露出一個(gè)rpc接口，通過(guò)http的方式接收消息师骗。
   web3.js就是一個(gè)處理與geth通信解析的庫(kù)，當(dāng)我們啟動(dòng)一個(gè)geth節(jié)點(diǎn)讨惩，并將一個(gè)web3實(shí)例連接上該geth節(jié)點(diǎn)后辟癌。我們可以調(diào)用web3的函數(shù)，web3會(huì)將請(qǐng)求編碼然后發(fā)送給geth荐捻，再有g(shù)eth將交易提交到鏈上黍少。

geth里默認(rèn)集成了web3.js，如果已經(jīng)有一個(gè)運(yùn)行中的geth實(shí)例处面，我們可以通過(guò)

    geth attach

去連接厂置，然后我們會(huì)看到一個(gè)js命令行，這里面就已經(jīng)有一個(gè)連接上geth的web3實(shí)例了魂角。

我們可以簡(jiǎn)單的call一些web3的api看看效果昵济。

image.png

合約的調(diào)用

調(diào)用合約時(shí)，我們經(jīng)常需要知道合約的地址和合約的ABI野揪，那么這兩個(gè)東西有什么用访忿？要了解這個(gè)，必須先了解以太坊合約調(diào)用編碼斯稳。

1. 以太坊合約調(diào)用標(biāo)準(zhǔn)
   每一個(gè)已經(jīng)部署的合約都是鏈上的一個(gè)block里的二進(jìn)制代碼海铆。我們調(diào)用合約的代碼時(shí)，也要給出一個(gè)符合標(biāo)準(zhǔn)的二進(jìn)制代碼挣惰。
   調(diào)用某一個(gè)contract的函數(shù)需要提供（合約地址卧斟，函數(shù)簽名，參數(shù)）憎茂。每個(gè)部分都要按照標(biāo)準(zhǔn)格式編碼珍语，這個(gè)過(guò)程普通用戶(hù)掌握起來(lái)很困難，而且容易出錯(cuò)唇辨。
   為了方便用戶(hù)廊酣，web3.js封裝了這個(gè)編碼過(guò)程，只要我們給出合約地址和合約ABI文件赏枚，在我們通過(guò)web3調(diào)用合約時(shí)亡驰，web3會(huì)根據(jù)ABI文件將我們的調(diào)用編碼成正確格式發(fā)送給geth晓猛。

2. ABI

合約的ABI其實(shí)就是這個(gè)合約的接口的json表示，最終目的是方便web3這樣的庫(kù)函數(shù)對(duì)我們的調(diào)用進(jìn)行編碼凡辱。
以ENS合約的abi為例：

    {
      "constant": false,
      "inputs": [
        {
          "name": "_hashes",
          "type": "bytes32[]"
        }
      ],
      "name": "startAuctions",
      "outputs": [],
      "payable": false,
      "type": "function"
    },

這段代碼是官網(wǎng)ens里的ensutils.js里的ensRegistra合約ABI的一部分戒职。我們可以看到，ensRegistra合約里有這個(gè)函數(shù)透乾。

function startAuction(bytes32 _hash) registryOpen() {
    var mode = state(_hash);
    if (mode == Mode.Auction) return;
    if (mode != Mode.Open) throw;

    entry newAuction = _entries[_hash];
    newAuction.registrationDate = now + totalAuctionLength;
    newAuction.value = 0;
    newAuction.highestBid = 0;
    AuctionStarted(_hash, newAuction.registrationDate);
}

3. 如果調(diào)用合約

這里我們繼續(xù)以ensutils.js為例洪燥，看下如何通過(guò)js來(lái)調(diào)用合約。

• 首先它直接給出了ens相關(guān)合約的ABI json數(shù)據(jù)

• 然后它調(diào)用web3的contract乳乌，直接指向已經(jīng)部署的ens合約的地址

  var ens = ensContract.at('0x314159265dd8dbb310642f98f50c066173c1259b');
  //注意捧韵，這里需要使用者先提供一個(gè)已經(jīng)連接上節(jié)點(diǎn)的web3對(duì)象
  //然后以合約abi為參數(shù)創(chuàng)建一個(gè)contract對(duì)象，最后將該對(duì)象指向mainnet上的合約地址
  //ens對(duì)象現(xiàn)在就成為指向mainnet上已經(jīng)部署的ens合約的一個(gè)引用汉操。
  

• 接下來(lái)我們就可以直接call這個(gè)contract引用的函數(shù)

• web3會(huì)將調(diào)用編碼后發(fā)送給geth

• geth將交易提交到網(wǎng)絡(luò)再来，礦工會(huì)在EVM里執(zhí)行調(diào)用，將結(jié)果寫(xiě)入鏈上

附錄

其實(shí)磷瘤，如果我們知道函數(shù)簽名芒篷，不需要ABI文件，我們自己也能夠生成交易數(shù)據(jù)采缚。
以太坊有一個(gè)調(diào)用函數(shù)的標(biāo)準(zhǔn)格式针炉，當(dāng)我們發(fā)出一個(gè)合約調(diào)用時(shí)，交易里其實(shí)包括：

1. Keccak編碼函數(shù)簽名
2. 對(duì)于定長(zhǎng)參數(shù)扳抽，直接編碼值
3. 變長(zhǎng)參數(shù)一律放在最后篡帕，原位置只放一個(gè)偏移量

舉一個(gè)列子，當(dāng)我們call一個(gè)函數(shù)f摔蓝，其簽名為

  f(uint256,uint32[],bytes10,bytes)

我們發(fā)出的調(diào)用是：

  f(a, b, c, d)

最終提交的交易數(shù)據(jù)是：

0x8be65246
0000000000000000000000000000000000000000000000000000000000000123
0000000000000000000000000000000000000000000000000000000000000080
3132333435363738393000000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000e0
0000000000000000000000000000000000000000000000000000000000000002
0000000000000000000000000000000000000000000000000000000000000456
0000000000000000000000000000000000000000000000000000000000000789
000000000000000000000000000000000000000000000000000000000000000d
48656c6c6f2c20776f726c642100000000000000000000000000000000000000

• 首先是函數(shù)名稱(chēng)的哈希值取前4個(gè)byte

  
  
  image.png

• 第一位是個(gè)定長(zhǎng)參數(shù)(uint245)赂苗，直接寫(xiě)的參數(shù)值0x123

• 第二位是個(gè)變長(zhǎng)參數(shù)(uint32[])，放在后面贮尉，只填寫(xiě)了偏移量80拌滋，就是128bytes，注意上圖每一行是32bytes猜谚，所以該參數(shù)實(shí)際放在第五行(從0開(kāi)始算）

• 第三位是定長(zhǎng)參數(shù)bytes10败砂，直接寫(xiě)了它的ASCII編碼

• 第四位又是變長(zhǎng)參數(shù)(bytes)，放在e0魏铅，也就是224bytes昌犹，第八行

• 第五行之后是之前第一個(gè)變長(zhǎng)參數(shù)的表示，首先第五行記錄了2览芳，表示該參數(shù)長(zhǎng)度為2斜姥，兩個(gè)uint32

• 第六，七行就是這兩個(gè)uint32的值

• 第八行是第二個(gè)變長(zhǎng)參數(shù)的長(zhǎng)度，13铸敏，表示13個(gè)字節(jié)缚忧，也就是第九行從左往右13個(gè)字節(jié)

這里有該規(guī)則的示例解釋。