SEER流量众筹模块开发测试网络及使用文档发布

时间 2019-11-20

原文原文链接

SEER利用区块链奖励机制，可解决传统体育赛事痛点，提升行业运转效率。好比提升赛事方收入，让观众自由选择想看的比赛，给予赛事众筹的参与者贡献影响力，使其得到由智能合约量化的激励等。此功能可普遍应用于包括但不限于演出、赛事等文体产业中的各类场景。前端

只有资产发行者可以建立新众筹。在SEER开发者网页钱包中，可在资产发行者的资产页，看到资产功能中有“众筹列表”按钮，进入可查看当前用户已有众筹列表或建立新的众筹。json

在建立众筹时，可设置众筹开始结束时间、代理人等。代理人的设计初衷，是出于安全考虑，资产拥有者帐号/DAPP官方帐号不能够长期在线，众筹建立后由代理者行使后续权力，同时，代理人也能够做为水龙头，负责推广和注册帐号。windows

建立众筹时，还须要设置各类激励的名称及每份奖励数量。例如每次助力奖励10ABC，朋友助力奖励5ABC。安全

建立众筹时须要添加受益人角色，例如合做媒体、明星、举办方等，在建立时为这些角色设定众筹成功后，资金池的分配比例，而且能够单独为每位角色设置线性解锁、不锁定、到期解锁等锁定方式和锁定天数。服务器

众筹进行中时，须要配合相应的前端程序和活动程序使用，在链上解决的主要是经过智能合约进行筹得资产的增发、销毁、分配、锁定等步骤。而用户贡献流量这一步，则须要特定的活动程序向区块链提供数据，由建立人或代理人权限根据活动数据为本场众筹注入新资产。微信

例如，一场活动在某一周期内有10000人经过微信受权登录进行助力，另外这些用户产生了5000人次的邀请朋友助力数据，根据每次助力奖励10ABC，朋友助力奖励5ABC的设定，该周期共计为资金池注入10000 * 10 + 5000 * 5 = 125000 ABC，同时，另有 150 位用户经过参与众筹的形式，捐赠或打赏了 50000 ABC，该周期可供受益人各方分配的资产为175000 ABC，这些资产将在活动成功后将根据预先设定的比例进行分配，若失败，捐赠部分将退回给用户。根据活动数据，发起方可根据用户的捐赠和助力贡献或排名，给与大到冠名、广告露出，小到明星签名周边之类的各类名誉奖励。网络

如有问题，欢迎在开发者论坛参与讨论：https://forum.seerchain.org/t/topic/610区块链

体验流程

开发者可首先在本地下载配置命令行钱包，链接到此测试网络。导入测试帐号tester的私钥，生成多个密钥对，注册多个测试帐号。使用tester向自行注册的帐号转帐测试的SEER，以后使用自行注册的帐号建立资产，随后建立众筹，开启众筹。而后使用建立的多个其它帐号向自行建立的众筹捐赠资产，使用代理帐号或众筹发起帐号模拟流量价值进行的增发，众筹到期后输入众筹成功或失败的结果，使用建立或更新时设置的受益人帐号领取收益等。测试

接口说明

流量众筹模块须要配合链上原有的资产发行、销毁等功能使用，主要包含六个新的接口：competition_create、competition_update、competition_participate、competition_input、competition_claim、competition_result。其中建立众筹competition_create、更新众筹competition_update参数较复杂、连同收益领取competition_claim、输入结果competition_result，通常使用网页钱包操做便可。ui

如下介绍参与众筹competition_participate和注入新资产competition_input接口。

competition_participate

格式：competition_participate(string account,competition_id_type competition,asset amount,bool broadcast = false);

参数：account：发起者、competition：众筹ID、amount：参与的数额（带精度）以及资产类型、broadcast：是否广播；

做用：普通用户参与众筹（向本次众筹资金池捐赠资产）。

命令行钱包示例：competition_participate 1.2.13 1.18.7 {"amount":10000000,"asset_id":"1.3.3"} true

RPC示例：{"jsonrpc": "2.0", "method": "competition_participate", "params": ["1.2.13","1.18.7",{"amount":10000000,"asset_id":"1.3.3"},true], "id": 1}

参数说明（RPC形式）：

{

    "jsonrpc": "2.0",

    "method": "competition_participate",

    "params": [

      "1.2.13",//发起者

        "1.18.7", {//众筹ID

            "amount": 10000000,//参与的数额

            "asset_id": "1.3.3"//资产类型

        },

        true

    ],

    "id": 1

}

返回信息示例：

{

    "id": 1,

    "jsonrpc": "2.0",

    "result": {

        "ref_block_num": 3404,

        "ref_block_prefix": 135777280,

        "expiration": "2019-10-16T15:32:36",

        "operations": [

            [65, {

                "fee": {//手续费

                    "amount": 500000,

                    "asset_id": "1.3.0"

                },

                "issuer": "1.2.13",//发起者

                "competition": "1.18.7",//众筹ID

                "amount": {

                    "amount": 10000000,//参与的数额

                    "asset_id": "1.3.3"//资产类型

                }

            }]

        ],

        "extensions": [],

        "signatures": ["2071d05......2e491"]

    }

}

competition_input

格式：competition_input(string account,competition_id_type competition,map<uint8_t,uint32_t> input,bool broadcast = false);

参数：account：发起者、competition：众筹ID、input：每种激励新增的数额、broadcast：是否广播；

做用：由于用户贡献了关注度，增发新的资产注入众筹资金池

命令行钱包示例：competition_input 1.2.13 1.18.7 [[0,100],[1, 200]] true

RPC示例：{"jsonrpc": "2.0", "method": "competition_input", "params": ["1.2.13","1.18.7",[[0,100],[1, 200]],true], "id": 1}

参数说明（RPC形式）：

{

    "jsonrpc": "2.0",

    "method": "competition_input",

    "params": [

        "1.2.13",//发起者

         "1.18.7", //众筹ID

         [

            [0, 100],//第一种激励新增的数额

            [1, 200]//第二种激励新增的数额

        ], 

        true],

    "id": 1

}

返回信息示例：

{

    "id": 1,

    "jsonrpc": "2.0",

    "result": {

        "ref_block_num": 3370,

        "ref_block_prefix": 1021658047,

        "expiration": "2019-10-16T15:30:54",

        "operations": [

            [66, {

                "fee": {//手续费

                    "amount": 500000,

                    "asset_id": "1.3.0"

                },

                "issuer": "1.2.13",//发起者

                "competition": "1.18.7", //众筹ID

                "input": [

                    [0, 100],//第一种激励新增的数额

                    [1, 200]//第二种激励新增的数额

                ]

            }]

        ],

        "extensions": [],

        "signatures": ["2054f3......f765c15"]

    }

}

SEER开发测试网络

目前，SEER流量众筹模块开发中，开发者架设了测试网络，节点API以下：ws://192.144.171.138:8003

若需使用测试网络网页钱包http://192.144.171.138 ，须要添加并切换到上面的API。

测试网络帐号：tester

私钥：5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP

win wallet：https://cdn.jsdelivr.net/gh/akirasen/W1@master/cli_test.zip

此测试网络可能会随时销毁或重置，请勿保存重要数据。

新手指南

考虑到有的小伙伴是第一次接触SEER，因此咱们从头补一下课，如何使用开发者网络钱包和命令行钱包，此处命令行钱包以windows为例。

首先，下载钱包https://cdn.jsdelivr.net/gh/akirasen/W1@master/cli_test.zip

解压后新建一个文本文档，输入cli_wallet.exe -s ws://192.144.171.138:8003 -r 127.0.0.1:9991 -H 127.0.0.1:9992，另存为run.cmd，点击run.cmd。

成功运行后，会显示new >>

输入set_password 123设置钱包密码；

https://docs.seerchain.org/#/zh-Hans/cli?id=_1-set_password

输入unlock 123解锁钱包；

*** 记得每次看到locked>>的时候就解锁 ***

https://docs.seerchain.org/#/zh-Hans/cli?id=_2-unlock

输入import_key tester 5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP导入测试帐号的私钥；

https://docs.seerchain.org/#/zh-Hans/cli?id=_5-import_key

输入suggest_brain_key生成几对秘钥对，复制下来；

https://docs.seerchain.org/#/zh-Hans/cli?id=_4-suggest_brain_key

用生成秘钥对中的公钥（SEER开头的一串数字字母字符），替换掉模板中的公钥SEER......yVgnQ，修改模板中的新帐号用户名name，输入register_account name SEER4xBLW....yVgnQ SEER4....yVgnQ tester tester 20 true，注册帐号，多个帐号屡次注册；

https://docs.seerchain.org/#/zh-Hans/cli?id=_1-register_account

输入transfer tester name 1000000 SEER "" true为你建立的帐号name（需替换）转帐 100万SEER 测试币，多个帐号屡次转帐；

https://docs.seerchain.org/#/zh-Hans/cli?id=_2-transfer

输入import_key name 5Kb1...Rci导入你刚刚注册的测试帐号的私钥，多个帐号屡次导入；
在测试网络网页钱包http://192.144.171.138 设置-接入点中，添加 API 服务器节点 ws://192.144.171.138:8003 并切换；
设置-恢复/导入 - 导入私钥，粘贴 5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP 提交，能够导入测试帐号 tester，固然你也能够导入本身建立的其它帐号；
菜单 - 资产页建立资产，填入资产代码，建立一个资产；
点击新建立资产后方的“众筹列表”按钮，进入列表页，建立众筹。在建立页面根据提示添加各类参；
建立好后开启众筹，开启后的众筹，能够在网页钱包中进行输入、参与操做，但由于这些操做在实际操做中须要程序控制，所以使用命令行钱包和RPC接口来模拟操做；
命令行钱包中输入competition_participate 1.2.N 1.18.N {"amount":N,"asset_id":"1.3.N"} true参与众筹（捐赠打赏），详细参数说明参考上面的文档；
输入competition_input 1.2.N 1.18.N [[0,100],[1, 200]] true向本次众筹资产池输入各个激励名目的新增数量，注入新的资产，详细参数说明参考上面的文档。

用户名的object_ID可经过get_account_id name查询。

https://docs.seerchain.org/#/zh-Hans/cli?id=_13-get_account_id