filecoin技术架构分析三:filecoin开发网络使用

我是先河系统CTO杨尉,欢迎大加关注的的Github: waynewyang,本文是filecoin技术架构分析系列文章第三章filecoin开发网络使用。

filecoin开发网络使用

辅助资源

使用

接入filecoin开发网络

  • 初始化filecoin资源目录

如果之前有运行过filecoin,想重新开始,需要删除filecoin资源,同时重新初始化是需要重新花时间同步开发网区块信息的。

1
rm -rf ~/.filecoin

初始化资源目录,使用—devnet-user表示连接至开发网

1
2
3
waynewyang:Downloads waynewyang$ go-filecoin init --devnet-user --genesisfile=http://user.kittyhawk.wtf:8020/genesis.car
initializing filecoin node at ~/.filecoin
waynewyang:Downloads waynewyang$
  • 启动filecoin进程,接入开发网

    1
    2
    3
    4
    go-filecoin daemon

    //如果开发者,需要接入nightly devnet,请设置环境变量后启动filecoin
    env FIL_USE_SMALL_SECTORS=true go-filecoin daemon
  • 检查连接性

go-filecoin swarm peers 查看已经连接的节点

1
2
3
4
5
6
7
8
9
10
11
waynewyang:filecoin waynewyang$ go-filecoin swarm peers
/ip4/115.238.154.84/tcp/19109/ipfs/Qmb6ZYi7GLFAje3UekGZ2LZymck7RVHKSKb1bhPzzPTQkm
/ip4/115.238.154.84/tcp/41187/ipfs/QmZ9UHdU2fwDN7emWW8AeaUdkF9fT7RwJrnbbdcQFUq9X6
/ip4/123.134.67.81/tcp/6000/ipfs/QmccrEQsauwge4BZQeN1jBtFyd7dnTi4pSDvkikMWaFccw
/ip4/123.134.67.82/tcp/6000/ipfs/QmWuA1AW4qDqztDrwo2pBgT2au67BJbGtEzWRufbc8isgn
/ip4/123.134.67.83/tcp/6000/ipfs/QmbPCabGcngs3bCgMK8dC3w9pjoyPd1NFyDhbkgLyT2eJ7
/ip4/123.134.67.85/tcp/6000/ipfs/QmUqSSZrwfSUU3vfw7D1UyKaLvEv1Ykcvx3ntvSXWaA7kj
/ip4/123.134.67.86/tcp/6000/ipfs/QmPrz2z764AVaHivM7iX2JqRw5EdE3jcZTrjwVxS4VukyK
/ip4/123.134.67.87/tcp/6000/ipfs/QmTxVFq3u7qPxsXFQdoyqPrdh6meW6JBGkSJ8HJXAiMUfh
/ip4/123.134.67.88/tcp/6000/ipfs/QmXAVRPYu57XDwJHszn9U9x1KtTwPsJBaS1mTdNZzAQVyQ
/ip4/123.134.67.89/tcp/6000/ipfs/Qmc5umx9R3bpD5VxvUmfyLoDz5wtVT43p5xjSEmTe26qTD

go-filecoin ping peerID 确认连通性

1
2
3
4
5
6
7
waynewyang:filecoin waynewyang$ go-filecoin ping QmW4Z8p7FCspLV1FeTRW6uCNApUXqkm8xYYw4yuBnqBGeB
PING <peer.ID Qm*nqBGeB>
Pong received: time=245.12 ms
Pong received: time=245.61 ms
Pong received: time=251.98 ms
Pong received: time=245.69 ms
Pong received: time=255.64 ms
  • 给你的filecoin Node设置昵称

    1
    2
    3
    4
    waynewyang:filecoin waynewyang$ go-filecoin config heartbeat.nickname "wwwarsyuncom"
    "wwwarsyuncom"
    waynewyang:filecoin waynewyang$ go-filecoin config heartbeat.nickname
    "wwwarsyuncom"
  • 激活节点

1
go-filecoin config heartbeat.beatTarget "/dns4/stats-infra.kittyhawk.wtf/tcp/8080/ipfs/QmUWmZnpZb6xFryNDeNU7KcJ1Af5oHy7fB9npU67sseEjR"

https://stats.kittyhawk.wtf/ 查看filecoin网络,节点已经激活

获取Mock FIL用于测试

FIL用于矿工抵押;或者作为客户进行交易需要

  • 注意:开发网目前运行的都是全节点,获取mock FIL需要建立在本地区块数据同步完成的基础上进行,必须同步完区块之后才能生效,根据个人机器配置情况,这需要较长一段时间。
  • go-filecoin message wait ${MESSAGE_CID} 本质上是转账交易,wiki上说明的是等待30s,但是这是在本地区块数据同步完成的基础上才行的。
  • 笔者已提交建议给官方,在wiki上更为清晰地表述。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
waynewyang:filecoin waynewyang$ go-filecoin wallet addrs ls
fcq09qtmrxgq5sdr95gs93tx79u9uymdwfdsaphpa

waynewyang:filecoin waynewyang$ export WALLET_ADDR=`go-filecoin wallet addrs ls`

waynewyang:filecoin waynewyang$ MESSAGE_CID=`curl -X POST -F "target=${WALLET_ADDR}" "http://user.kittyhawk.wtf:9797/tap" | cut -d" " -f4`
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 232 100 50 100 182 48 177 0:00:01 0:00:01 --:--:-- 177

waynewyang:go-filecoin waynewyang$ go-filecoin message wait ${MESSAGE_CID}
{
"meteredMessage": {
"message": {
"to": "fcqm0u932ja5thlsy4dgpz5urlapk8qhtd0clqv5e",
"from": "fcq09sqhrd4gls86muuenzvqdc37mzscagapjveal",
"nonce": "rQQ=",
"value": "1000",
"method": "",
"params": null
},
"gasPrice": "0",
"gasLimit": "AA=="
},
"signature": "WKA+eRY7XCQlSmallzoFu8Tps7NZ2AOAKLRFo21rTERFYJqXJT2qEWZ8sFvm6ZShR5syb7RSAJnDp4Am2Vzp0gE="
}
{
"exitCode": 0,
"return": null,
"gasAttoFIL": "0"
}
waynewyang:filecoin waynewyang$ go-filecoin wallet balance fcq09qtmrxgq5sdr95gs93tx79u9uymdwfdsaphpa
1000
waynewyang:filecoin waynewyang$ go-filecoin wallet balance ${WALLET_ADDR}
1000

矿工操作

存储矿工

  • 创建存储矿工示例,需要等待1分钟左右
    • 抵押10个扇区的存储空间(当前默认每个扇区256MiB)
    • 支付100个FIL为担保
    • gas价格为0
    • 限制gas消耗最大为1000个FIL
1
2
waynewyang:filecoin waynewyang$ go-filecoin miner create 10 100 --price=0 --limit=1000 --peerid `go-filecoin id | jq -r '.ID'`
fcqjge872spqrgtm8dhlndjgfhhuxzx0y3ujvxxsl //所返回的就是矿工地址minerAddress
  • 启动挖矿

    1
    2
    waynewyang:filecoin waynewyang$ go-filecoin mining start
    Started mining
  • 收益之一: 启动挖矿之后就可以参与挖区块奖励

    查询区块头

1
2
waynewyang:go-filecoin waynewyang$ go-filecoin chain head
[{"/":"zDPWYqFD2mBqLx7bwQNdeVoMxj6SC5HxzorZAoXpT6xjaythnENw"}]

查询具体区块信息

1
2
3
4
5
6
7
8
go-filecoin show block <blockID>

waynewyang:go-filecoin waynewyang$ go-filecoin show block zDPWYqFD2mBqLx7bwQNdeVoMxj6SC5HxzorZAoXpT6xjaythnENw
Block Details
Miner: fcq0y72meekgwnvchwml0uzx759q25nk0rqc47ret
Weight: 293567.552
Height: 10787
Nonce: 0
  • 收益之二:创建报价单ask
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
1) 获取矿工地址
export MINER_ADDR=`go-filecoin config mining.minerAddress | tr -d \"`

2) 设置矿机Owner
export MINER_OWNER_ADDR=`go-filecoin miner owner $MINER_ADDR`

3) 创建报价单,价格0.000000001 FIL/byte/block, 交易费0,gas限制1000,提供2880个block空间存储

go-filecoin miner set-price --from=$MINER_OWNER_ADDR --miner=$MINER_ADDR --price=0 --limit=1000 0.000000001 2880 # output: CID of the ask

发布报价单,需要打包进去区块

waynewyang:filecoin waynewyang$ go-filecoin miner set-price --from=$MINER_OWNER_ADDR --miner=$MINER_ADDR --price=0 --limit=1000 0.000000001 15315
Set price for miner fcqjge872spqrgtm8dhlndjgfhhuxzx0y3ujvxxsl to 0.000000001.
Published ask, cid: zDPWYqFCxL3VW3xzmHhCBqPTvhoQa53pn6DzV3uY23jNL76za1Vt.
Ask confirmed on chain in block: zDPWYqFD7wjnj74sdB9HqupDmWmpPPEvygB14Pbo6rQC7ho2687D.

4) 查询区块信息(第三步中是zDPWYqFD7wjnj74sdB9HqupDmWmpPPEvygB14Pbo6rQC7ho2687D)可以找到对应报价单信息

waynewyang:filecoin waynewyang$ go-filecoin show block zDPWYqFD7wjnj74sdB9HqupDmWmpPPEvygB14Pbo6rQC7ho2687D --enc=json
{"miner":"fcqnam6n2qml2eyngws25srzvhcdf0t8gcgrsvnrk","ticket":"AM0p5IC9ph+o9dTwd/MXYdeOJW25PfDwhTgonNRkSP4=","parents":[{"/":"zDPWYqFCwNWHJXdeXcjx7ipUvRKFq5WhLbtSm6ESuNufkLuGiAgW"}],"parentWeight":"kujBrQE=","height":"2Hc=","nonce":"AA==","messages":[{"meteredMessage":{"message":{"to":"fcqp606qfk5gwmq6ac24g4mhv3cr8zzf67vqkpulh","from":"fcqr89lj0lvduj475zw002j6q5yrl30ks7uep2p5e","nonce":"Ag==","value":"215.6046624","method":"createChannel","params":"glYAABXMs4C0hXqcW94YGyVKxii6SLQhQ6HoAg=="},"gasPrice":"0","gasLimit":"rAI="},"signature":"vHzwO73TvM8MW1FKg8Qgfy/IP+wfJIQkEK0ExBB75gBbPMhv6GiU4aBq1T2Gb2OeMfrch8Zg3EFOJd0uUJltwAE="},{"meteredMessage":{"message":{"to":"fcqafmqgvzkzpvc6wjxecm7gsweuawjv8t6falk6r","from":"fcqr89lj0lvduj475zw002j6q5yrl30ks7uep2p5e","nonce":"Aw==","value":"100","method":"createMiner","params":"g0EKWEEEiA8ArEoyzhjWwijpTWYqDsOFfwxa2F0pUfOyRI/6yY28OD4QHcwUdb3a9omX9DNxVzdS2a8pWgiLNowe9wYVcFgiEiD3rKfg/NyDnrLF9IGxfp6U72jZxuniXlPcv5SG5OZHrA=="},"gasPrice":"0","gasLimit":"6Ac="},"signature":"/X/87zil8InOeLeQ6kqkqnpg7mP/e5jMaaVS4LRMIdYN84HTbABBpvt6quRqVQsadJnqOW7mn+6NA+2d9FDjPAA="},{"meteredMessage":{"message":{"to":"fcqp606qfk5gwmq6ac24g4mhv3cr8zzf67vqkpulh","from":"fcqmqr5f2a5qnwnvftpuzd6sjfy5tcq5dd0k24h85","nonce":"Ug==","value":"0.008596","method":"createChannel","params":"glYAAIVV3axUhfe7OGwwSH/IIONRcbinQ/OWAQ=="},"gasPrice":"0","gasLimit":"rAI="},"signature":"dxhSaVRvFBtdrbnEByza7a5JqLzm6n6rVZYGuFN6zegCTMDKbGGh++EvVmWo0WSbdcUo2vB/jFTgqzATh9+1NQA="},{"meteredMessage":{"message":{"to":"fcqugc6nql2eqglfwq0dw7ep7l9a07jacqgstely7","from":"fcq0nmdcq7updgwc3uh2lz2rnjms7gprdggcvxjqj","nonce":"BA==","value":null,"method":"commitSector","params":"hUECWCCFzRGqHyJ3VWk3GueHzfkcWF218hOqRGtLxsJ0oJ3pXVgg6qrxCGo6SSjyUSbJWVKPKGaY/wrymC21t5LSScCNpQBYIOeZkdzp7lPt8Fh/Sdl9YqJ8BCaJ7etWEnDnLzRnV/geWQGAlTMp95t1Hh61eFBmzy6Ex/Ee1cso7Cethz+Z2EHCfhi5UzOMeLqeA/Wfypcnrw15mF4OrYR8648RXx6jp8svbgZ6Jg9fP/q0RukszZ/SD9f0pCMg2N/xt5hVIPG7jowSCfkj//CpdRj1GRPLzXvzyWmW4SgKR4lNpJNnmuiXSe8nYLsZgY2v8xy4NB448e/slxh7D4NQPanCoN3WO10oBR42ZxeCZY6stq+JfwucGr5OajgXSK2rGwz/Sj+GYpMbtgpfxSd4Z+jZ6mnoY03NaIHvwnDKchRz797lFL3so6AQRRnctN3Pl7LSn52YA0EOkmhJLMev6DKBWEqSfjXTY4AJSJ7RmGq88BXoHzwGjndRj0QHFtSTjHIoxF9uN86zB6gfSS+A7ZviuTvfturtKee243b9OIojIf2ne2hF8+7PSIwCp5FPLXEqR/UtXnJ6pxjBKhF36k3FRdzsxo52DMImgPhluGWI3xRhpIMmFNDMNynOBQ9F6mnR8fRBdPKB"},"gasPrice":"0","gasLimit":"rAI="},"signature":"hEluqbFG8TTSeeJyfOs10fZD/gOsrnFV8QgRAb4mhSFlzYpcijT9ye1yUYam5hcsW1eq1MFRfVGHhqYYUZ4LYwA="},{"meteredMessage":{"message":{"to":"fcqjge872spqrgtm8dhlndjgfhhuxzx0y3ujvxxsl","from":"fcqm0u932ja5thlsy4dgpz5urlapk8qhtd0clqv5e","nonce":"AQ==","value":"0","method":"addAsk","params":"gkWAlOvcA0I70w=="},"gasPrice":"0","gasLimit":"6Ac="},"signature":"IGUvf7CZ8lKDSTyzbg5kyArIPv8TIoFEWpA3ihRC7I86NFvgebCdEKQ6PqYhTJj1GQK/+JF28kCinXFN/9G8FgE="},{"meteredMessage":{"message":{"to":"fcqp606qfk5gwmq6ac24g4mhv3cr8zzf67vqkpulh","from":"fcqsvmdzpy5mjc9m0cuh6uhmprr6gk5w2zcrnjy02","nonce":"Aw==","value":"0.0000301989888","method":"createChannel","params":"glYAAGsLRe4dsJwsvfE2+dkEh1DPX11jQ+OdAQ=="},"gasPrice":"0","gasLimit":"rAI="},"signature":"Zg5kUOtEZ9Um+mGKicHaqTCaORppGv5KAaSlTpN/qTcoTptRUP3ZbQ5YOL7zjTG6aF7Y4r0Ck0NsnG0J/i2B0AA="},{"meteredMessage":{"message":{"to":"fcqp606qfk5gwmq6ac24g4mhv3cr8zzf67vqkpulh","from":"fcqrqtfcug5hlx7gugvwj0f2dyx6j9cxdn0ynmpu3","nonce":"Ag==","value":"0","method":"createChannel","params":"glYAAJsQ6e5i/M0X04YZwzl3VWckPu4RQ62HAQ=="},"gasPrice":"0","gasLimit":"rAI="},"signature":"oisXV83sTFkJw7y5KbO5fLhx2oa48qZKAVwX+1fIvWUDgm5PQNDddPeCkklPg2L+fmp4wL2fLF9R2qPRciLUfAA="}],"stateRoot":{"/":"zdpuAvwpuqNR4J6PJDqGfF5GbyjWarD1BhujTUfyREMHSY1eF"},"messageReceipts":[{"exitCode":0,"return":["Ag=="],"gasAttoFIL":"0"},{"exitCode":0,"return":["AAA2Qrupiubk6ljOMnMUrnnHKaVXmQ=="],"gasAttoFIL":"0"},{"exitCode":0,"return":["0gA="],"gasAttoFIL":"0"},{"exitCode":0,"return":null,"gasAttoFIL":"0"},{"exitCode":0,"return":[""],"gasAttoFIL":"0"},{"exitCode":0,"return":["Aw=="],"gasAttoFIL":"0"},{"exitCode":0,"return":["Ag=="],"gasAttoFIL":"0"}],"proof":[177,165,90,219,1,18,240,190,113,56,243,22,16
7,201,232,75,124,152,130,111,74,132,5,192,33,191,102,220,102,9,99,109,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}

//查询最新区块信息
waynewyang:go-filecoin waynewyang$ go-filecoin show block `go-filecoin chain head --repodir=~/.filecoin2/ |jq -r '.[0]'|jq -r '.["/"]'`
Block Details
Miner: fcq973y2y7hvcce8zkwds7r2847xmfjvdecn98lws
Weight: 134386.836
Height: 5013
Nonce: 0

5) 获取所有矿工的报价信息
go-filecoin client list-asks --enc=json | jq

现在默认是只要客户出价高于矿工报价,默认接受交易。

  • 停止挖矿
1
2
go-filecoin mining stop
rm -rf ~/.filecoin //删除filecoin矿工实例,区块同步也被删除,再次实例化,需要再次同步区块

检索矿工

暂未发现支持,目前可以自己的供应商(具体矿工)处获取;后面通过更深入的分析之后另行补充。

修复矿工

修复矿工的概念是白皮书之后提出的,后面继续深入分析之后再另行补充。

客户操作

存储客户

  • filecoin 与IPFS数据结构是兼容的
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
//创建测试文件
waynewyang:test waynewyang$ echo "Hi my name is $USER"> hello.txt
waynewyang:test waynewyang$ cat hello.txt
Hi my name is waynewyang

//导入filecoin本地资源库
waynewyang:test waynewyang$ export CID=`go-filecoin client import ./hello.txt`
waynewyang:test waynewyang$ echo $CID
Qmchgh3N3kxWiaZ2cp9PbV93i77H3K8KtQCBTeVR5Q7wzs

//这里会发现用IPFS上传得到的CID也是一样
waynewyang:test waynewyang$ ipfs add hello.txt
added Qmchgh3N3kxWiaZ2cp9PbV93i77H3K8KtQCBTeVR5Q7wzs hello.txt
25 B / 25 B [========================================================================] 100.00%

//用go-filecoin或者IPFS命令获取数据,结果一致
waynewyang:test waynewyang$ go-filecoin client cat $CID
Hi my name is waynewyang
waynewyang:test waynewyang$ ipfs block get $CID
Hi my name is waynewyang
  • 导入测试数据

    1
    2
    3
    4
    waynewyang:sample-data waynewyang$ export CID=`go-filecoin client import camel.jpg`
    waynewyang:sample-data waynewyang$ go-filecoin client cat $CID > image.png && open image.png
    waynewyang:sample-data waynewyang$ echo $CID
    QmeubcGKFXpafFT4xRFGf3NqDRzJUVoAqe5sh1ugbRPZ7u
  • 查询矿工的报价单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
waynewyang:sample-data waynewyang$ go-filecoin client list-asks --enc=json | jq
{
"Miner": "fcqvnwlanfu7ecflnp3rc5gm0ecdamvxgvlawref4",
"Price": "0.000000001",
"Expiry": 7079,
"ID": 0,
"Error": null
}
{
"Miner": "fcqsmut6jnwchq0qlc3t6v44pzgf8l49lg6r8wl4a",
"Price": "0.000000001",
"Expiry": 16522,
"ID": 0,
"Error": null
}
{
"Miner": "fcqsmut6jnwchq0qlc3t6v44pzgf8l49lg6r8wl4a",
"Price": "0.000000000000000001",
"Expiry": 18753,
"ID": 1,
"Error": null
}
{
"Miner": "fcqghrce7vaf6czj54x5qke0mn2uzzg8ckvgvcjpe",
"Price": "0.000000001",
"Expiry": 14404,
"ID": 0,
"Error": null
}
......
  • 下单
1
2
3
4
5
6
go-filecoin client propose-storage-deal <miner> <data> <ask> <duration>

<miner> address of the miner from list-asks
<data> CID of the imported data that you want to store
<ask> ID of the ask, also from list-asks (usually 0)
<duration> how long you want to store (in # of ~30sec blocks). For example, storing for 1 day (2 blocks/min * 60 min/hr * 24 hr/day) = 2880 blocks.
  • 发送数据和支付
1
2
3
4
5
6
7
8
9
1 支付

1)支付到paych中
2)定期向矿工付款

2 数据

1)未密封完的数据称之为暂存区
2)密封完成后阶段性支付

检索客户

现在是指定所对应的存储矿工进行检索,暂未发现更多支持,在后面的深入分析中会继续跟进。

  • 查询订单状态,必须是密封,posted交易结束后才能查询
1
go-filecoin client query-storage-deal < dealID >
  • 检索
1
go-filecoin retrieval-client retrieve-piece < minerAddress >  < CID >

filecoin合约

文件合约

其实现在的创建存储矿工,以及矿工创建报价、存储客户提交订单存储,这些笔者认为属于filecoin文件合约的范畴。

以太坊类似,以太坊抽象出了代币合约以及通用智能合约; 而filecoin则是抽象出了文件合约和通用智能合约。

智能合约

暂未发现支持,在后面的深入分析中会继续跟进。

单机运行多个filecoin节点

修改资源目录和服务端口的方式

  • go-filecoin init的时候,通过 ‘—repodir=所指定资源目录路径’ 命令进行初始化目录资源,后面的其他命令同样需要所指定资源目录路径进行操作。

  • 修改资源目录下的config.json文件,将默认的端口予以修改,避免与另外的本机实例相冲突。

容器部署方式

  • 可以打包成docker镜像,有兴趣的朋友可以自行尝试。

深入浅出区块链 - 系统学习区块链,打造最好的区块链技术博客

LBC-Team wechat
欢迎订阅公众号:深入浅出区块链技术
0%