历经三年后，Filecoin历经磨难，终于剥开云雾迎来主网上线。

Filecoin主网上线被认为是2020年加密行业内影响力与比特币减半和以太坊2.0相当的重要事件。为了迎接这一大事件，10月15日币圈注意力几乎都集中在Filecoin身上，共同迎接高光时刻！

多家知名媒体还推出不同形式的直播，旨在第一时间播报事件进展及细节。多名行业领袖和大佬，深度解读Filecoin。

北京时间10月15日22时44分 (GMT 8) ，Filecoin达到主网上线区块高度148888 。万众瞩目的加密项目Filecoin终于主网上线，火币、OKEX等各大交易所纷纷上线FIL，优盾钱包也在第一时间支持FIL充值业务，这些表现足以看出Filecoin的影响力。

作为区块链行业最有前景且叙事规模最为宏大的分布式存储赛道项目，Filecoin一直是这一板块的标杆，而它的主网上线必定会是一件期待已久的重大事件，因为此前描绘的伟大构想现在终于有了一个落地的“证据”。

分布式存储是一种数据存储技术，通过网络使用企业中的每台机器上的磁盘空间，并将这些分散的存储资源构成一个虚拟的存储设备，数据分散的存储在企业的各个角落。去中心化存储具有隐私保护、低存储成本、数据冗余备份存储、开源的应用程序和算法等优势，有利于数据的价值传递和规避单点故障。

星际文件系统IPFS（InterPlanetary File System）是是一个去中心化分布式存储网络，是IPFS的唯一激励层。Filecoin采用了区块链通证体系发行了Token，Token简称FIL，发行总量20亿。

Filecoin生态有矿工、投资者和使用者等多种角色，他们在不同场景下需要购买或者出售FIL。

这种热情反馈于市场，表现的也是非常火爆。昨日刚上线的几个交易所，像火币、币安等平台上FIL的表现，虽然短期内彼此的差价也比较大，但共同点在于价格在被推高后便开始下滑，但这并不影响上线FIL的交易所平台数量的增长。

作为加密资产存储、管理工具的区块链钱包作为区块链流量入口，一直是一种刚需的存在，而区块链钱包细分领域为交易所、项目方等企业量身定制的区块链钱包备受关注。

交易所钱包要解决的就是交易所用户充提币问题，对于运营一个交易所来说，最重要的地方就是安全，其一是交易安全；二是钱包安全。值得注意的是，加密资产安全问题是交易所运营中的重中之重。一些需要业务发展以及加密资产管理的交易所，特别是需要FIL资产充提币、转账、支付的企业对于接入FIL钱包是运营首要解决的问题。那么FIL钱包对接交易所主要流程有哪些？

如何对接FIL钱包？FIL充提币、支付、转账接口文档：

原文链接：https://www.uduncloud.com/gateway-interface

1、目录

1.1、生成地址

1.2、提币

1.3、代付

1.4、交易回调

1.5、校验地址合法性

1.6、获取商户支持币种信息

2、接口明细

1、生成地址

1.1 场景说明

请求指定币种地址,如要成功获取地址,需先存在钱包,且钱包支持该币种, 详情参看

1.2 接口详情

1.2.1 接口地址

1.2.2 参数

1.2.2.1 参数说明

[

    {

     “merchantId”:”300015″,

     “coinType”:520,

     “callUrl”:”http://localhost:8080/callBack”

    }

]

1.2.2.2 body参数字段

1.2.2.3 示例

{

    “timestamp”: 1535005047,

    “nonce”: 10000,

    “sign”: “a230def43c1a12b14393880a28d4e005”,

    “body”: “[{\”merchantId\”:\”300015\”,\”coinType\”:520,\”callUrl\”:\”http://localhost:8080/callBack\”}]” 

}

1.2.3 返回状态码表

1.3 调取示例

1.3.1 成功

{

    “data”:{

        “coinType”:520,

        “address”:”0xbe4e3699cb870bc95365fe04a187dd279a651a58″

    },

    “message”:”SUCCESS”,

    “code”:200

}

1.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

2、发送提币申请

2.1 场景说明

提币申请

2.2 接口详情

2.2.1 接口地址

2.2.2 参数

2.2.2.1 参数说明

[

    {

        “address”:”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s”,

        “amount”:”0.11″,

        “merchantId”:”100109″,

        “mainCoinType”:”144″,

        “coinType”:”144″,

        “callUrl”:”http://localhost:8080/mch/callBack”,

        “businessId”:”15″,

        “memo”:”10112″

    }

]

2.2.2.2 body参数字段

body参数名称	是否必填	类型	说明
address	是	String	提币地址
amount	是	String	提币数量
merchantId	是	String	商户号
mainCoinType	是	String	主币种编号 （见 附录一 ）
coinType	是	String	子币种编号 （见 附录一 ）
callUrl	是	String	回调地址，通过该callUrl告知您该笔提币交易的状态,具体示例见 交易回调接口
businessId	是	String	业务id，必须保证该字段在系统内唯一，如果重复，则该笔审核钱包不会接收。
memo	否	String	备注,XRP和EOS，这两种币的提币申请该字段可选，起他类型币种不填

2.2.2.3 示例

{

  “timestamp”: 1535005047,

  “nonce”: 100000,

  “sign”: “6df1512ee650431632ce1541a6b064e1”,

  “body”: “[{\”address\”:\”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\”,\”amount\”:\”0.11\”,\”merchantId\”:\”100109\”,\”mainCoinType\”:\”144\”,\”coinType\”:\”144\”,\”callUrl\”:\”http://localhost:8080/callBack\”,\”businessId\”:\”15\”,\”memo\”:\”10112\”}]” 

}

2.2.3 返回状态码表

2.3.1 成功

{

    “message”:”SUCCESS”,

    “code”:200

}

2.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

3、代付

3.1 场景说明

代付,发送自动付款申请，未设置代付信息或代付失败则进入审核状态。

3.2 接口详情

3.2.1 接口地址

3.2.2 参数

3.2.2.1 参数说明

[

  {

      “address”:”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s”,

      “amount”:”0.1″,

      “merchantId”:”100146″,

      “mainCoinType”:”144″,

      “coinType”:”144″,

      “callUrl”:”http://localhost:8080/callBack”,

      “businessId”:”571001″,

      “memo”:”10112″

  }

]

3.2.2.2 body参数说明

3.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “[{\”address\”:\”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\”,\”amount\”:\”0.1\”,\”merchantId\”:\”100146\”,\”mainCoinType\”:\”144\”,\”coinType\”:\”144\”,\”callUrl\”:\”http://localhost:8080/callBack\”,\”businessId\”:\”571001\”,\”memo\”:\”10112\”}]”

}

3.2.3 返回状态码表

3.3 调取示例

3.3.1 成功

{

    “message”:”SUCCESS”,

    “code”:200

}

3.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

4、交易回调接口

4.1 场景说明

网关收到交易处理结果，调用商户提供的回调接口，通知商户具体变化信息。该接口网关发送给您指定的回调地址的内容，处理您的业务信息。 分充值回调和提币回调，其中提币最多会进行两次回调（审核回调+交易结果回调）

4.2 接口详情

4.2.1 接口地址

4.2.2 参数

4.2.2.1 参数说明

{

    “address”:”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW”,

    “amount”:”12345678″,

    “blockHigh”:”102419″,

    “coinType”:”206″,

    “decimals”:”8″,

    “fee”:”452000″,

    “mainCoinType”:”206″,

    “status”:3,

    “tradeId”:”20181024175416907″,

    “tradeType”:1,

    “txId”:”31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0″,

    “businessId”:””,// 提币回调为提币接口传入的businessId，充币无值

    “memo”:””

}

4.2.2.2 body参数说明

body参数名称	类型	说明
address	String	地址
amount	String	交易数量，根据币种精度获取实际金额，实际金额=amount/pow(10,decimals)，即实际金额等于amount除以10的decimals次方
fee	String	矿工费，根据币种精度获取实际金额，实际金额获取同上
decimals	String	币种精度
coinType	String	子币种编号,见 附录一
mainCoinType	String	主币种编号,见 附录一
businessId	String	业务编号，提币回调时为提币请求时传入的，充币回调无值
blockHigh	String	区块高度
status	Integer	状态，见 回调接口状态说明
tradeId	String	交易流水号
tradeType	Integer	交易类型,见 回调接口交易类型说明
txid	String	区块链交易哈希
memo	String	备注，XRP和EOS（见 附录一 ），这2种类型币的充提币可能有值

4.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “{\”address\”:\”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\”,\”amount\”:\”12345678\”,\”blockHigh\”:\”102419\”,\”coinType\”:\”206\”,\”decimals\”:\”8\”,\”fee\”:\”452000\”,\”mainCoinType\”:\”206\”,\”status\”:3,\”tradeId\”:\”20181024175416907\”,\”tradeType\”:1,\”txId\”:\”31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0\”}”

}

5、校验地址合法性

5.1 场景说明

校验地址的合法性,添加地址、提币申请等场景时可先校验地址合法性，参看 校验规则

5.2 接口详情

5.2.1 接口地址

5.2.2 参数

5.2.2.1 参数说明

{

    “merchantId”:200000,

    “mainCoinType”:”206″,

    “address”:”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW”

}

5.2.2.2 body参数说明

5.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “[{\”merchantId\”:200000,\”mainCoinType\”:\”206\”,\”address\”:\”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\”}]”

5.2.3 返回状态码表

5.3 调取示例

5.3.1 成功

{

    “code”:200,

    “message”:”SUCCESS”

}

5.3.2 失败

{

    “code”:4005,

    “message”:”PARAM_ERROR”

}

6、获取商户支持的币种信息

6.1 场景说明

获取商户支持的币种,以及余额

6.2 接口详情

6.2.1 接口地址

6.2.2 参数

6.2.2.1 参数说明

6.2.2.2 body参数说明

body参数名称	类型	是否必填	说明
merchantId	Long	是	商户号
showBalance	Boolean	是	是否查询余额，false不获取，true获取

6.2.2.3 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “{\”merchantId\”:\”200032\”,\”showBalance\”:true}”

}

6.2.3 返回状态码表

6.3 调取示例

6.3.1 成功

{

    “code”: 200,

    “message”: “SUCCESS”,

    “data”:[

        {

            “name”: “BTC”, // 币种别名

            “coinName”:”Bitcoin”, // 币种全称

            “symbol”:”BTC”, // 币种单位

            “mainCoinType”:”0″, //主币种类型

            “coinType”:”0″, // 币种类型

            “decimals”:”8″, // 币种精度

            “tokenStatus”:”0″, // 0： 主币 1：代币

            “mainSymbol”:”BTC”, //主币种单位

            “balance”:”0″, // 币种余额

            “logo”:”http://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/BTC.png” // 币种log地址

        },

        {

            “name”: “ETH”, // 币种别名

            “coinName”:”Ethereum”, // 币种全称

            “symbol”:”ETH”, // 币种单位

            “mainCoinType”:”60″, //主币种类型

            “coinType”:”60″, // 币种类型

            “decimals”:”18″, // 币种精度

            “tokenStatus”:”0″, // 0： 主币 1：代币

            “mainSymbol”:”ETH”, //主币种单位

            “balance”:”0″, // 币种余额

            “logo”:”https://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/ETH.png” // 币种log地址

        }

    ]

}

6.3.2 失败

{

    “code”:4005,

    “message”:”BGS_ILLEGAL_PARAMETER”

}

附录一

回调接口状态说明

回调接口交易类型说明

验签说明

为了保证商户传送到优盾的参数信息不被恶意篡改，网关为商户接口提供Md5加密摘要认证。商户可用基础加密参数：时间戳、随机数、签名密钥(商户唯一的APIKEY)、请求明文参数按指定顺序排列进行Md5加密，产生一个验签串sign，商户请求网关接口时，带上参数时间戳、随机数、请求明文参数、sign作为参数。网关拿到相应的参数以同样的方式进行签名验签。同理，网关请求商户也以同样的方式进行身份验证。

sign=md5(body + key + nonce + timestamp)

key为接口授权码APIKEY，由网关分配给商户，加密字段顺序不能错误

币种地址校验规则

主币种类型	币种简称	币种英文名称	币种中文名称	地址前缀	地址长度限制区间
0	BTC	Bitcoin	比特币	1或者3	[26,36]
60	ETH	Ethereum	以太坊	0x	[42]
145	BCH	Bitcoincash	比特币现金	1	[26,36]
61	ETC	EthereumClassic	以太坊经典	0x	[42]
2	LTC	Litecoin	莱特币	L或者M	[26,36]
508	GX	GX		G	[26,36]
503	NBTC	NBTC		N	不限制
99	STO	STO	证券型通证发行	S	不限制
5	DASH	DASH	达世币	X	[26,36]
2301	QTUM	QTUM	量子链币	Q	[26,36]
133	ZEC	ZCash	大零币	t1	不限制
144	XRP	Ripple	瑞波币	r	[34]

资产安全是生态发展的重要前提和根本保证，此次Filecoin主网上线具有划时代的里程碑意义。FIL的未来，让我们更加期待。