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

SEER利用區塊鏈獎勵機制,可解決傳統體育賽事痛點,提高行業運轉效率。比如提高賽事方收入,讓觀衆自由選擇想看的比賽,給予賽事衆籌的參與者貢獻影響力,使其獲得由智能合約量化的激勵等。此功能可廣泛應用於包括但不限於演出、賽事等文體產業中的各種場景。

只有資產發行者能夠創建新衆籌。在SEER開發者網頁錢包中,可在資產發行者的資產頁,看到資產功能中有“衆籌列表”按鈕,進入可查看當前用戶已有衆籌列表或創建新的衆籌。

在創建衆籌時,可設置衆籌開始結束時間、代理人等。代理人的設計初衷,是出於安全考慮,資產擁有者賬號/DAPP官方賬號不可以長期在線,衆籌創建後由代理者行使後續權力,同時,代理人也可以作爲水龍頭,負責推廣和註冊賬號。

創建衆籌時,還需要設置各種激勵的名稱及每份獎勵數量。例如每次助力獎勵10ABC,朋友助力獎勵5ABC。

創建衆籌時需要添加受益人角色,例如合作媒體、明星、舉辦方等,在創建時爲這些角色設定衆籌成功後,資金池的分配比例,並且可以單獨爲每位角色設置線性解鎖、不鎖定、到期解鎖等鎖定方式和鎖定天數。

衆籌進行中時,需要配合相應的前端程序和活動程序使用,在鏈上解決的主要是通過智能合約進行籌得資產的增發、銷燬、分配、鎖定等步驟。而用戶貢獻流量這一步,則需要特定的活動程序向區塊鏈提供數據,由創建人或代理人權限根據活動數據爲本場衆籌注入新資產。

例如,一場活動在某一週期內有10000人通過微信授權登陸進行助力,另外這些用戶產生了5000人次的邀請朋友助力數據,根據每次助力獎勵10ABC,朋友助力獎勵5ABC的設定,該週期共計爲資金池注入10000 10 + 5000 5 = 125000 ABC,同時,另有 150 位用戶通過參與衆籌的形式,捐贈或打賞了 50000 ABC,該週期可供受益人各方分配的資產爲175000 ABC,這些資產將在活動成功後將根據預先設定的比例進行分配,若失敗,捐贈部分將退回給用戶。根據活動數據,發起方可根據用戶的捐贈和助力貢獻或排名,給與大到冠名、廣告露出,小到明星簽名周邊之類的各種名譽獎勵。

若有問題,歡迎在開發者論壇參與討論:https://forum.seerchain.org/t...

體驗流程

開發者可首先在本地下載配置命令行錢包,連接到此測試網絡。導入測試賬號tester的私鑰,生成多個密鑰對,註冊多個測試賬號。使用tester向自行註冊的賬號轉賬測試的SEER,之後使用自行註冊的賬號創建資產,隨後創建衆籌,開啓衆籌。然後使用創建的多個其它賬號向自行創建的衆籌捐贈資產,使用代理賬號或衆籌發起賬號模擬流量價值進行的增發,衆籌到期後輸入衆籌成功或失敗的結果,使用創建或更新時設置的受益人賬號領取收益等。

接口說明

流量衆籌模塊需要配合鏈上原有的資產發行、銷燬等功能使用,主要包含六個新的接口:competition_create、competition_update、competition_participate、competition_input、competition_claim、competition_result。其中創建衆籌competition_create、更新衆籌competition_update參數較複雜、連同收益領取competition_claim、輸入結果competition_result,一般使用網頁錢包操作即可。

以下介紹參與衆籌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/a...

此測試網絡可能會隨時銷燬或重置,請勿保存重要數據。

新手指南

考慮到有的小夥伴是第一次接觸SEER,所以我們從頭補一下課,如何使用開發者網絡錢包和命令行錢包,此處命令行錢包以windows爲例。

首先,下載錢包https://cdn.jsdelivr.net/gh/a...

解壓後新建一個文本文檔,輸入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/#/...

  1. 輸入unlock 123解鎖錢包;

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

https://docs.seerchain.org/#/...

  1. 輸入import_key tester 5HxSqrcNu6nZ5xaLK9f6RTVKghJsVGZejz8CnC8e3qnPc14LUdP導入測試賬號的私鑰;

https://docs.seerchain.org/#/...

  1. 輸入suggest_brain_key生成幾對祕鑰對,複製下來;

https://docs.seerchain.org/#/...

  1. 用生成祕鑰對中的公鑰(SEER開頭的一串數字字母字符),替換掉模板中的公鑰SEER......yVgnQ,修改模板中的新賬號用戶名name,輸入register_account name SEER4xBLW....yVgnQ SEER4....yVgnQ tester tester 20 true,註冊賬號,多個賬號多次註冊;

https://docs.seerchain.org/#/...

  1. 輸入transfer tester name 1000000 SEER "" true爲你創建的賬號name(需替換)轉賬 100萬SEER 測試幣,多個賬號多次轉賬;

https://docs.seerchain.org/#/...

  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/#/...

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章