登录
当前位置： 首页 > 文档资料 > MOAC 链中文文档 >

FileStorm Dapp开发指南

优质
小牛编辑
135浏览
2023-12-01

FileStorm是在墨客子链上实现的基于IPFS的去中心化存储平台。详细介绍可参看这篇 html/appchain/FileStorm.html 在墨客子链上实现的IPFS存储平台。这个平台的用户有三类。

存储提供方： 存储提供方将会提供用于存储的硬件设备，如带大容量硬盘的电脑，或者订制的硬件盒子。设备需要安装FileStorm程序，用来链接墨客FileStorm子链，和IPFS网络。为FileStorm提供存储可以得到收益，就是俗称的存储挖矿。

应用部署方：应用部署方为FileStorm子链的创建者。他们可以搭建一个专门的子链为自己的应用做存储。应用部署方需要承担运营FileStorm子链的费用（墨客也会做为应用部署方部署一条FileStorm子链供用户使用。）

存储使用者：存储的使用者通过使用应用部署方部署的应用来存储和读取文件。存储使用者无需为使用FileStorm付费。但是可能要承担使用应用的费用。

我们的用户指南将根据用户的不同，，分成三部分。

存储提供方 运行FileStorm子链需要安装下面四个模块

redis - 本地数据库，用于缓存文件调用的请求。 IPFS Daemon - 文件以IPFS的方式存储的主要平台。 SCSServer - 墨客子链节点程序。 stormcatcher - 墨客子链节点对IPFS的调用。 这些模块可以用以下的方式一个一个下载安装，也可以用Docker的方式安装。先介绍一个一个下载安装流程。

redis：

Ubuntu

sudo apt update
sudo apt full-upgrade
sudo apt install build-essential tcl
curl -O http://download.redis.io/redis-stable.tar.gz
tar xzvf redis-stable.tar.gz
sudo apt install redis-server

CentOs

sudo yum install epel-release
sudo yum update
sudo yum install redis

ipfs 可以用下面的方法安装与filestorm的ipfs软件包。

Ubuntu

curl https://dist.ipfs.io/go-ipfs/v0.4.18/go-ipfs_v0.4.18_linux-amd64.tar.gz > go-ipfs.tar.gz
tar xvfz go-ipfs.tar.gz
sudo mv go-ipfs/ipfs /usr/local/bin/ipfs
CentOs
curl https://dist.ipfs.io/go-ipfs/v0.4.17/go-ipfs_v0.4.17_linux-amd64.tar.gz > go-ipfs.tar.gz
tar xvfz go-ipfs.tar.gz
sudo mv go-ipfs/ipfs /usr/local/bin/ipfs

scsserver 和 stormcatcher 可以从这个链接下载最新版本。

下载后，下载的文件包会在服务器端生成filestorm工作文件夹。将文件夹内解压出如下文件：

scsserver stormcatcher userconfig.json run_filestorm_scs.sh stop_filestorm_scs.sh

也可以从这里下载Docker版本。关于Docker的安装和使用，可以看着里：Get Started with Docker.

设置 设置文件是userconfig.json

VnodeServiceCfg的设置是从 Node info - Testnet上，找到Vnode Protocol Pool下面的任何一个Vnode/Port组合加上。 Beneficiary设置成SCS节点收益的受益人钱包地址。

服务器上必须把下面的端口打开:

4001 5001 8080 如果节点做为子链监控节点，还需要打开run_filestorm_scs.sh中定义的rpc端口，缺省是50068.

运行 第一次使用必须先生成IPFS文件库

ipfs init 然后还需要生成一个节点ID。用如下指令

cd filestorm
./scsserver

生成的ID可以通过ll scskeystore看到。ID就是一个地址，是scskeystore下的文件名-后面的哪一部分在前面加上0x。 如文件名是UTC--2018-09-23T05-52-26.554142261Z--e09f56c0c8c528b14ea594764c09c7ede73f88c0 ID就是0xe09f56c0c8c528b14ea594764c09c7ede73f88c0

我们必须往这个ID里打一定的MOAC，0.05个即可，让这个ID记录到墨客区块链的主链上去。（可以用任何墨客钱包，如wallet.moac.io来做。）

然后就可以运行FileStorm了。FileStorm可以调用下面的脚本运行。

./run_filestorm_scs.sh 脚本代码如下，在后台调用四个模块

#!/bin/bash
echo "Starting FileStorm SCS--"

#IPFS_PATH=~/.ipfs
nohup ipfs daemon > ipfs.out 2>&1 &
echo "IPFS Daemon started."

nohup redis-server --port 6373 > ipfs.out 2>&1 &
echo "Redis Server started. "

nohup ./stormcatcher-linux-amd64 --listen-host-port 127.0.0.1:18083 --redis-host-port 127.0.0.1:6373 --ipfs-host-port 127.0.0.1:5001 --subChain-contract-address 0x13512e62c8Cb1De316F7C442d767d0365350720c --subChain-address 127.0.0.1:50068/rpc > ipfs.out 2>&1 &
echo "Storm Catcher started."

nohup ./scsserver-linux-amd64 --rpc --rpcaddr 127.0.0.1 --rpcport 50068 --verbosity 4 > scs.out 2>&1 &
echo "SCS started."

可以用调用下面的脚本停止 ./stop_filestorm_scs.sh

脚本代码如下，关闭四个模块

#!/bin/bash
echo "Stoping FileStorm SCS--"
pkill ipfs_monkey
pkill redis-server
pkill ipfs
pkill scsserver
echo "FileStorm SCS Stopped."

为了让子链节点正常使用，我们还需要给每个子链节点地址打0.5个Moac。

监测 可以用下面的指令检测墨客子链运行进程

tail -f scs.out

可以用下面的指令检测IPFS成勋运行进程

tail -f scs.out

应用部署方 本地必须开一个vnode连接到Moac testnet上。在 https://github.com/MOACChain/moac-core/releases 下载Nuwa1.0.7 用下面的指令开启vnode ./moac --testnet --rpc --rpccorsdomain "http://wallet.moac.io" console 打开 http://wallet.moac.io 发合约 DeploySubChainBase.sol 从 Node info - Testnet 上找SubChainProtocolBase pool地址和 Vnodeproxy pool地址 发子链合约 FileStormMicroChain.sol 注册检测子链 子链浏览器检测 存储使用者 存储使用者一般都是通过应用来存储文件。应用部署方则通过部署子链合约 FileStormMicroChain.sol把文件存到FileStorm上，或者读出来。

我们可以用如下的步骤演示文件读写的流程。方便应用方了解熟悉后集成到应用中。

本地必须开一个vnode连接到Moac testnet上。在 https://github.com/MOACChain/moac-core/releases 下载Nuwa1.0.2。（希望将来应用开发者会把这个模块） 用下面的指令开启vnode

./moac --testnet console

在本地安装IPFS（希望将来应用开发者会把这个模块集成到应用中。） 可以从这个链接下载最新版本ipfs软件包。我们以ubuntu版本为例

wget https://dist.ipfs.io/go-ipfs/v0.4.17/go-ipfs_v0.4.17_linux-amd64.tar.gz
tar xvfz go-ipfs_v0.4.17_linux-amd64.tar.gz
sudo mv go-ipfs/ipfs /usr/local/bin/ipfs

我们本地生成一个测试文件。vi newtestfile.txt 我们将测试文件放到IPFS中：ifps add newtestfile.txt 我们将拿到的文件hash生成16进制代码。可以在这个网站实现：https://codebeautify.org/string-hex-converter。 也可以用下面这段代码得到。

npm install --save ethereumjs-abi

var abi = require('ethereumjs-abi');
var original = 'QmQNe96LqV5TcRQyBz12iQXPZQjemBqkgnpHki3wmKjtd6';
var encoded = abi.simpleEncode('write(string)', original);

console.log('original', original);

console.log('encoded', encoded.toString('hex'));

得到的字节数是46位的16进制数（因为每一位两个数字，一共92个数字）。因为solidty参数的存储空间是32位，46位的16进制数需要两个存储空间才行，然后我们要把得到的16进制数后面补上足够多的0，变成一个64位的16进制数（一共128个数字）。 调用函数处理文件有如下三个函数，分别可以对文件进行写，读，删。 from: 这必须是本机keystore里存在的一个账号。如果是vnode里第一次生成的就是chain3.mc.accounts[0]，必须先进行一下personal.unlockAccount(mc.accounts[0])解锁使用。 to: subchainbaseaddress是SubChainBase合约地址，必须由应用项目方提供，我们可以用前面测试得到的地址。 data: 把第7步得到的数字加到data的数值里2e的后面。 每次调用要把nonce手动加1。（下一个版本会有更好的方法拿到nonce） via必须跟moac同文件夹下的vnodeproxy.json文件里

// write(fileHash)
chain3.mc.sendTransaction(
{
  from: chain3.mc.accounts[0],
  value:chain3.toSha('0','mc'),
  to: subchainbaseaddress,
  gas: "200000",
  gasPrice: chain3.mc.gasPrice,
  shardingflag: 1,
  data: '0xba3835ba00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002e'
  nonce: 1,
  via: chain3.mc.accounts[0]
});

// read(fileHash)
chain3.mc.sendTransaction(
{
  from: mc.accounts[0],
  value:chain3.toSha('0','mc'),
  to: subchainbaseaddress,
  gas: "200000",
  gasPrice: chain3.mc.gasPrice,
  shardingflag: 1,
  data: '0x616ffe830000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002e'
  nonce: 2,
  via: mc.accounts[0]
});

// remove(fileHash)
chain3.mc.sendTransaction(
{
  from: mc.accounts[0],
  value:chain3.toSha('0','mc'),
  to: subchainbaseaddress,
  gas: "200000",
  gasPrice: chain3.mc.gasPrice,
  shardingflag: 1,
  data: '0x80599e4b0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002e'
  nonce: 3,
  via: mc.accounts[0]
});

调用结果：

Write：IPFS文件被存到FileStorm子链的每一个节点上，文件Hash值被改变。 Read：FileStorm子链的每一个节点上都会出现原始Hash值的原文件。（会在24小时后自动删除。） Remove：IPFS文件会从FileStorm子链的每一个节点上被删除。

免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn