SEER流量衆籌模塊開發測試網絡及使用文檔發佈

時間  2019-11-20
標籤 seer 流量 模塊 開發 測試 網絡 使用 文檔 發佈 欄目 系統網絡 简体版
原文   原文鏈接

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 >>

  1. 輸入set_password 123設置錢包密碼；

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

  1. 輸入unlock 123解鎖錢包；

*** 記得每次看到locked>>的時候就解鎖 ***

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

  1. 輸入import_key tester 5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP導入測試帳號的私鑰；

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

  1. 輸入suggest_brain_key生成幾對祕鑰對，複製下來；

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

  1. 用生成祕鑰對中的公鑰（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

  1. 輸入transfer tester name 1000000 SEER "" true爲你建立的帳號name（需替換）轉帳 100萬SEER 測試幣，多個帳號屢次轉帳；

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

  1. 輸入import_key name 5Kb1...Rci導入你剛剛註冊的測試帳號的私鑰，多個帳號屢次導入；

  2. 在測試網絡網頁錢包http://192.144.171.138 設置-接入點中，添加 API 服務器節點 ws://192.144.171.138:8003 並切換；

  3. 設置-恢復/導入 - 導入私鑰，粘貼 5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP 提交，能夠導入測試帳號 tester，固然你也能夠導入本身建立的其它帳號；

  4. 菜單 - 資產 頁 建立資產，填入資產代碼，建立一個資產；

  5. 點擊新建立資產後方的「衆籌列表」按鈕，進入列表頁，建立衆籌。在建立頁面根據提示添加各類參；

  6. 建立好後開啓衆籌，開啓後的衆籌，能夠在網頁錢包中進行輸入、參與操做，但由於這些操做在實際操做中須要程序控制，所以使用命令行錢包和RPC接口來模擬操做；

  7. 命令行錢包中輸入competition_participate 1.2.N 1.18.N {"amount":N,"asset_id":"1.3.N"} true參與衆籌（捐贈打賞），詳細參數說明參考上面的文檔；

  8. 輸入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

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程