# ethereum(Geth)
## Ethereum Geth (go-ethereum) 教學
## 簡介
Geth 為 ethereum的Go語言實現
## 安裝
\[2024/2 更新]
查看此連結：
```
git clone https://github.com/ethereum/go-ethereum
sudo apt-get update
sudo apt-get install -y build-essential golang
cd go-ethereum
make geth
```
Mac
```
brew tap ethereum/ethereum
brew install ethereum
```
Arm embeded system
## 使用
如果是從source安裝(或可加入環境變數)
```
~/go-ethereum/build/bin/geth
```
如果是從安裝檔可直接輸入
```
geth help
```
可用命令\
### 1.創建創世區塊(genesis block)
custom\_genesis.json
```
{
"config": {
"chainId": 123,
"homesteadBlock": 0,
"eip155Block": 0,
"eip158Block": 0
},
"difficulty": "0x40",
"gasLimit": "4712388",
"alloc": {
}
}
```
然後輸入
```
geth --datadir "./privatechain" --networkid 123 init custom_genesis.json
```
> 上面將會創建一個privatechain資料夾，裡面存放我們private chain的資訊，genesis blcok會放在/privatechain資料夾/geth/chaindata/...ldb，而account會放在keystore裡面
(如果是1.6之前版本要改為如下)
> 如果出現Fatal: invalid genesis file: json: cannot unmarshal hex string of odd length into Go struct field Genesis.extraData of type hexutil.Bytes 為版本>1.6 請參考上面
```
{
"nonce": "0x0000000000000042",
"timestamp": "0x0",
"parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"extraData": "0x0",
"gasLimit": "0x8000000",
"difficulty": "0x400",
"mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"coinbase": "0x3333333333333333333333333333333333333333",
"alloc": {
}
}
```
然後輸入以下，之後開啟Mist wallet就會進入private network
```
geth --datadir "./privatechain" init ./custom_genesis.json
geth --ipcpath ~/Library/Ethereum/geth.ipc --datadir "./privatechain" --networkid 123
```
> 上面要寫上--ipcpath原因是我們指定了datadir
>
> 以下為各os路徑 後面記得加geth.ipc
>
> Mac
>
> `~/Library/Ethereum/`
>
> **Linux**
>
> `~/.ethereum/`
>
> **Windows**
>
> `~/AppData/Roaming/Ethereum`
方法2
也可使用下面產生private network
```
geth init custom_genesis.json
geth networkid=5
```
這樣打開錢包也可進入private network
> 如果出現錯誤:Fatal: Failed to write genesis block: database already contains an incompatible genesis block
>
> 把路徑下的chaindata資料夾刪除即可 \~/Library/Ethereum/geth/chaindata
### 2.預先分配ether給account
> 先把剛才的節點啟動
>
> ```
> geth --ipcpath ~/Library/Ethereum/geth.ipc --datadir "./privatechain" --networkid 123
> ```
然後打開Mist錢包後先創建帳戶，然後把帳戶號碼複製，之後貼到剛才genesis的alloc下面的一串hash，然後重新init 即可
```
"alloc": { "0x66A2e289b35147188876c2007f9a810Dd20e480d": {
"balance": "1337000000000000000000"}
}
```
```
geth --datadir "./privatechain" --networkid 123 init custom_genesis.json
```
> 每次init genesis chaindata資料夾下都會多一個ldb但他會去讀取最新的
>
> 有時上面訊息有Success 但下面又有Fatal可以不用理會
之後再次啟動
```
geth --ipcpath ~/Library/Ethereum/geth.ipc --datadir "./privatechain" --networkid 123
```
點選Mist圖案打開錢包即可看到帳戶餘額增加
### 試著挖礦
打開另一個termianl輸入以下，進入console
```
geth attach
```
> 或是可在剛才啟動ethereum後面加上console字樣，而geth attach預設只會找ipc不會找rpc
>
> 可在mist新增地址或是在console輸入`personal.newAccount("密碼")`\
> 加入挖礦要放錢的地址
>
> ```
> web3.miner.setEtherbase('0xB4eb9148CD0Aa801215f0e62A354F55A7E1AA67A')
> // 上面為剛才新增的地址
> // 也可以直接寫如下 會去讀取剛才創建得地址
> web3.miner.setEtherbase(personal.listAccounts[0])
> ```
>
> 開始挖礦(需稍等)
>
> (目前新版1.6有可能卡在dag產生完後)
>
> ```
> miner.start(1)
> ```
>
> 停止
>
> ```
> miner.stop()
> ```
### 3.加入其他節點
1.用RPC，記得要使用`--rpc`
2.每個節點要使用同一個創世區塊，才能找到彼此，我們先輸入如下指令，分別創建兩個節點的資料夾，並且用同一個genesis.json個別於兩資料夾產生相同創世區塊
先把剛privatechain資料夾刪除，重新創建一個./privatechain/src 然後裡面放入剛才的custom\_genesis.json
```
sudo rm -rf ./privatechain ; mkdir ./privatechain ; mkdir ./privatechain/src ; mv ./custom_genesis.json ./privatechain/src/custom_genesis.json
```
```
geth --datadir "./privatechain/01" init ./privatechain/src/custom_genesis.json
geth --datadir "./privatechain/02" init ./privatechain/src/custom_genesis.json
```
3.再來分別啟動兩個節點(networkid要相同，而`--rpcport`與`--port`要不同)
```
geth --ipcdisable --rpc --rpcport 8104 --datadir "./privatechain/01" --networkid 123 --rpcapi="db,eth,net,web3,personal" --nodiscover --port=30310 console
geth --ipcdisable --rpc --rpcport 8103 --datadir "./privatechain/02" --networkid 123 --rpcapi="db,eth,net,web3,personal" --nodiscover --port=30308 console
```
4.之後於01節點的console輸入
```
admin.nodeInfo
```
把`enode`部分複製
5.於02節點輸入
```
admin.addPeer("貼上剛才複製的enode")
```
6.之後於兩個節點分別輸入`admin.peers`即可找到彼此
> 注意\
> 1.\
> 我們沒有設預設bootnode所以要手動加入\
> 2.\
> 如果有三個節點ABC，A加入B之後，A再加入C\
> 這時B仍然找不到C要B主動加入C才可\
> 3.\
> 一開始沒有加入peers時會發現有時輸入admin.peers會出現有時沒有，原因是在連線到任何peers時他會試著去連接其他網路上的節點\
> 4.\
> 節點互相找不到的原因通常為你沒有輸入init genesis.json，所以兩個節點間的genesis.json不相同以及沒有輸入--nodiscover 所以他會加上網路上其他相同genesis和networkid的陌生人\
> 5.\
> 重新啟動某節點該節點的peer會斷掉，要重新加入
7.測試RPC-JSON server
> 之後錢包連線會使用
>
> ```
> 我們可以先輸入 curl http://localhost:8104
> 8104是該RPC的port，來看一下有沒有啟動
> ```
>
> 成功會出現下圖\
> 
8.這時開啟Mist要設定錢包要連線到哪個位置，所以這次我們不能直接點選圖案開啟，要使用命令列開啟，並加上`--rpc `
> (你可能直接從圖案開啟應用程式，也看到他有開啟時有顯示private net，但其實他還是連到MainNet)
>
> OSX
>
> ```
> /Applications/Ethereum\ Wallet.app/Contents/MacOS/Ethereum\ Wallet --rpc http://localhost:8104
> ```
>
> Windows
>
> ```
> start <加上程式路徑> --rpc
> ```
## # 1.6新增之puppeth CLI可用來產生genesis\_block
1.記得先產生account
```
geth --datadir ./privatechain account new
```
2.直接在terminal輸入 \`puppeth\` 之後會出現如下圖
然後造著步驟走即可，最後會產生一個創世.json
但要記得如果共識方法選的是Poa，之後其他節點要挖礦會產生
```
Block sealing failed err=unauthorized
```
記得要
```
clique.propose("帳號", true)
```
clique指令只有POA才有
## 注意事項
1\.
> 注意:每次從terminal啟動其他ethereum程序後開啟錢包，如果你沒有指定RPC 或IPC port，錢包都只會去讀取最新開啟的terminal的程序
2\.
> 如果進入到錢包，但是testnet與main都無法點選，表示你嘗試進入到private network但是參數沒有下成功
3\.
> 每個 `--` 參數都要和前面空一格，否則無效
4
> windows作業系統的terminal如果不好複製，可以使用git bash
5\.
> 節點互相找不到的原因通常為你沒有輸入init genesis.json，所以兩個節點間的genesis.json不相同以及沒有輸入--nodiscover 所以他會加上網路上其他相同genesis和networkid的陌生人
6\.
> 32位元版本的geth無法挖礦，需下載64位元
>
>
1. 兩節點加入後新加入節點不用挖礦就會自動同步，但如果有產生合約或是廣播交易網路上的其中一個節點必須挖礦
## 使用DEV Chain
> 不用自己init genesis block 和指定datadir 以及自動幫你配好一些參數 可直接啟動私有鏈
```
geth --dev --rpc --rpcport 8104 --datadir ./Ethtest --rpccorsdomain="*" console
```
## 開放Remote 連線
## 設定Bootnode
```
因為homebrew的安裝沒有bootnode executable
所以要build from source
```
以為步驟
```
git clone
https://github.com/ethereum/go-ethereum.git
make all
cd ./build/bin
./bootnode -genkey bootnode.key
```
之後資料夾下會產一個bootnode.key檔案
然後輸入
```
./bootnode -nodekey bootnode.key
```
會產生如下
之後我們開啟terminal輸入以下啟動節點
\> 記得--nodiscover要拿掉 然後--bootnodes後面填上剛才出現的enode:
並且把enode\[::]換成ip地址
bootnode本身不算是節點 只啟動下面一個時在admin.peers還是空的
```
geth --ipcdisable --rpc --rpcport 8106 --datadir "./privatechain/01" --networkid 123 --rpcapi="db,eth,net,web3,personal" --bootnodes "enode://92d7f28e8ca3bd1e1fa43959bb1cf37b9d284a81d17bcaee9cf233a773f3da0ce60b2351c3b29b07eb78229e6a84731d36065506f6ad972ed3203c5d18bef313@[127.0.0.1]:30301" --port=30310 console
geth --ipcdisable --rpc --rpcport 8107 --datadir "./privatechain/02" --networkid 123 --rpcapi="db,eth,net,web3,personal" --bootnodes "enode://92d7f28e8ca3bd1e1fa43959bb1cf37b9d284a81d17bcaee9cf233a773f3da0ce60b2351c3b29b07eb78229e6a84731d36065506f6ad972ed3203c5d18bef313@[127.0.0.1]:30301" --port=30311 console
```
之後在其中一個terminal輸入\`admin.peers\`
即可看到如下
## Geth版本升級
```
where geth
```
之後會顯示geth安裝路徑
然後下載 最新版本後在安裝時覆蓋原本路徑即可。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://easonwang.gitbook.io/blockchain/ethereumgeth.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.