一、簡介
ConfluxStudio是一個幫助開發者快速開發Conflux智能合約的集成化開發環境。ConfluxDApp開發教程將使用ConfluxStudio在Oceanus網絡下開發一個簡單的代幣應用Coin。
通過這個開發教程,你將會學習到如何進行Conflux智能合約的編寫、調用,配置智能合約的代付以及如何使用Web前端項目與智能合約進行交互,從而實現一個包含前端和智能合約的完整的DApp。
二、準備工作
2.1安裝IDE
請在GitHub的下載頁面
(github.com/ObsidianLabs/ConfluxStudio/releases)下載ConfluxStudio。目前ConfluxStudio支持macOS和Linux系統,請根據系統下載對應的版本。
正確安裝ConfluxStudio并初次啟動后,ConfluxStudio將顯示歡迎頁面,根據提示完成Docker,ConfluxNode以及ConfluxTruffle的下載、安裝及啟動。
2.2創建錢包
完成所有的安裝步驟后,首先需要創建鑰匙對來完成后續的合約部署以及調用。
在ConfluxStudio的任意界面,點擊應用左下?的鑰匙圖標,打開密鑰管理器。點擊Create按鈕打開新鑰匙對彈窗,輸入鑰匙對的名字并點擊Save按鈕。完成后將在密鑰管理器中看到剛剛生成的鑰匙對的地址。鑰匙對由私鑰和公鑰組成,公鑰在智能合約中也常被稱作地址。
導出私鑰可以通過點擊每個地址后面的眼睛按鈕打開查看私鑰彈窗,彈窗顯示地址以及私鑰。后續教程中會需要通過管理器導出私鑰。
為了順利完成教程,首先需要創建三個鑰匙對:
·minter_key用于Coin合約部署時的簽名,是這個教程中最常使用的鑰匙對
·receiver_key用于Coin合約接收轉賬,將在后文中介紹轉賬時用到
·sponsor_key用于Coin合約代付功能,將在后文中介紹代付功能時用到
2.3連接Conflux網絡
教程將在Oceanus網絡進行合約的部署以及合約的調用。點擊頂部Network標簽的倒三角打開下拉菜單,點擊選擇Oceanus網絡進行切換。
切換完成后,可以在主頁面中看到當前網絡為oceanus。頁面左邊包括了當前網絡的節點URL,ChainID,TPS信息,頁面右邊包含了當前網絡區塊的信息。
2.4申請測試CFX
點擊頂部Explorer標簽打開區塊瀏覽器,并在地址欄粘貼鑰匙對地址,可以在左邊看到當前地址的CFX余額信息。
Conflux與加密支付網關Alchemy Pay達成合作:2月25日消息,據官方消息,Conflux宣布與加密支付網關Alchemy Pay達成合作,將提供一個簡單的法幣入金支付解決方案,使用戶能夠使用當地法定貨幣購買加密貨幣。[2023/2/25 12:29:19]
在區塊鏈的世界中,大家通常將申請測試Token的方式稱為faucet,目前在Oceanus網絡下每次faucet申請到的Token為100CFX。
獲取CFX的方式有兩種方式:
·輸入地址后點擊地址欄右邊的水龍頭按鈕,ConfluxStudio將為地址自動申請CFX;
·你也可以直接在瀏覽器中輸入wallet.confluxscan.io/faucet/dev/ask?address={address}來申請CFX;
使用上述方法在ConfluxStudio中為minter_key和sponsor_key申請CFXToken。完成申請后,這兩個賬戶上的余額將會從0CFX更新為100CFX。
目前余額信息為:
·minter_key余額100CFX
·receiver_key余額0CFX
·sponsor_key余額100CFX
三、智能合約創建項目
3.1創建項目
點擊頂部左邊的Project標簽切換至項目列表頁面,點擊頁面中的New按鈕打開項目創建窗口,輸入項目的名稱并選擇coin模版,點擊CreateProject完成項目的創建。
3.2合約代碼
Coin合約是一個簡單的代幣合約,其中:
·通過mint方法可以增發代幣數量
·通過send方法可以將一定數量的代幣轉賬給別的用戶,同時會在事件中記錄下這筆轉賬的信息
·通過balanceOf方法可以查詢到指定賬戶地址的代幣余額
·通過add_privilege方法可以為合約添加代付白名單
·通過remove_privilege方法可以為合約移除代付白名單
Conflux智能合約使用Solidity語言進行開發,打開目錄下的contracts/Coin.sol文件,這個是本項目的核心代碼:
Metahood完成300萬美元種子輪融資,1confirmation領投:1月18日消息,Metahood完成300萬美元種子輪融資,1confirmation領投,Volt Capital、Flamingo DAO和Neon DAO、The Sandbox聯合創始人Sébastien Borget、SuperRare聯合創始人John Crain、Sorare成長負責人Brian O’Hagan以及風投和博客/播客主持人Packy McCormick等參投。
Metahood的平臺旨在為元宇宙土地買家提供比通用NFT市場更多的環境。(Decrypt)[2023/1/19 11:19:49]
3.3編譯及部署合約點擊工具欄的Build按鈕進行合約的編譯,編譯的結果將會保存在build/Coin.json文件中。
在部署合約前,首先需要確認在Explorer中選擇合約部署所使用的地址,ConfluxStudio會使用這個地址將部署合約這筆交易進行簽名。在合約代碼的constructor中,minter被賦值為msg.sender,這個msg.sender就是Explorer所選擇的地址。
在此我們選擇minter_key作為部署合約的簽名者。
點擊工具欄的部署按鈕進行部署,部署完成后,部署結果會在deploys的JSON文件中,在這個文件中可以在contractCreated中找到當前合約部署的地址,后文中使用contract_addr來代表這個合約地址。
四、調用合約
點擊頂部的Contract標簽切換至合約頁面,在地址欄輸入contract_addr地址并加載合約。
合約頁面由三個部分組成:
·左邊為合約調用區域
·中間為合約數據查詢區域
·右邊為事件查詢區域
4.1合約調用及查詢
4.1.1增發代幣
點擊合約調用的下拉菜單中選擇mint方法,在下方的參數區域分別填入以下信息:
·receiver接收代幣的地址。填入minter_key地址
·amount發行的代幣總數。填入整數1000
·Value選填項,具體可查看Value詳解。填0或者不填
·Signer這筆交易的簽名地址,如果沒有開通代付功能,交易手續費將在這個賬戶地址中扣除,在合約代碼中通過msg.sender獲取到這個地址。填入minter_key地址
填寫完成后點擊執行按鈕,ConfluxStudio將自動構造交易并推送到網絡中。成功執行后可以在下方Result中看到這筆成功的交易。
ConsenSys推出Web3社交應用及NFT賀卡平臺Soulflake:金色財經報道,ConsenSys宣布在Polygon鏈上推出Web3社交應用及NFT賀卡平臺“Soulflake”。該平臺允許用戶連接MetaMask錢包以創建、發送和接收靈魂綁定NFT賀卡,同時也支持在平臺上贈送價值1美元、10美元、50美元或100美元的MATIC代幣。(Cryptoflies)[2022/12/23 22:02:55]
4.1.2查詢代幣余額
點擊查詢區域的下拉菜單并且選擇balanceOf方法,這是在代碼中定義的查詢方法。在下方的tokenOwner填入minter_key地址并點擊執行,就可以在下方的Result中看到minter_key賬戶的Coin代幣的余額信息為1000。使用同樣方法可以查詢到receiver_key賬戶的代幣余額為0。
4.1.3轉賬代幣
在合約調用區域選擇send方法,在Parameters中分別填入:
·receiver收款人地址。填入receiver_key地址
·amount轉賬的代幣數量。填入整數200
·Signer這筆交易的簽名地址,代幣轉出的數量將會在這個賬戶中扣除。填入minter_key地址,
點擊執行完成轉賬,再次查詢代幣余額可以看到minter_key賬戶只剩下800代幣,而receiver_key賬戶則從0變成了200代幣。
五、代付功能
ConfluxStudio支持Conflux系統合約提供的代付功能。
通過系統合約可以為別的合約設置代付功能,系統合約提供給了四個方法:
·add_privilege添加合約代付白名單,在代付白名單中的地址調用該合約的方法時不需要付手續費,費用由代付賬戶支付。其中添加特殊地址0x0000000000000000000000000000000000000000代表為所有調用該合約的地址代付費用
·remove_privilege移除合約代付白名單
·set_sponsor_for_collateral設置合約儲存費(collateralforstorage)的代付賬戶及代付金額
·set_sponsor_for_gas設置合約手續費(gasfee)的代付賬戶、代付金額及每筆交易代付金額上限
啟用一個合約的代付需要設置代付的賬戶、代付金額及代付白名單。教程將會使用ConfluxStudio通過系統合約設置代付賬戶及代付金額,通過Coin合約添加代付白名單。設置完成后,minter_key賬戶調用Coin合約的方法時將不會被扣除手續費,手續費由sponsor_key賬戶代付。
5.1設置代付賬戶及代付金額
在ConfluxStudio中訪問系統合約地址
0x0888000000000000000000000000000000000001,在合約調用區域能看到前文中提及的四個設置代付的方法。
Celo與ConsenSys達成合作,將集成Infura基礎設施:11月21日消息,Celo與以太坊基礎設施開發公司ConsenSys達成合作,將集成ConsenSys旗下區塊鏈開發平臺Infura的基礎設施。Celo開發者將能夠使用Infura進行構建,這將有助于使其區塊鏈更具可擴展性。開發者還將能夠部署使用Truffle構建、基于以太坊的DApp。
此外,本次合作還將使得ConsenSys旗下瀏覽器錢包MetaMask提高對Celo的兼容性。(CoinDesk)[2022/11/21 7:52:55]
選擇set_sponsor_for_collateral方法,該方法有三個參數:
·contract_addr設置代付的合約地址。填入contract_addr
·Value設置代付金額。填入整數40
·Signer代付賬戶地址。填入sponsor_key地址
填好以上參數并執行運行,系統合約將為Coin合約設置好儲存費代付賬戶,此時sponsor_key賬戶將會被扣除40CFX。
選擇set_sponsor_for_gas方法,該方法有四個參數:
·contract_addr設置代付的合約地址。填入contract_addr
·upper_bound設置每筆交易代付的上限。填入1000000000000
·Value設置代付金額。填入整數40
·Signer代付賬戶地址。填入sponsor_key地址
填好以上參數并再次執行運行,系統合約將為Coin合約設置好手續費代付賬戶,此時sponsor_key賬戶將會再次被扣除40CFX。
完成這兩個方法的調用后Coin合約代付賬戶便設置好了,sponsor_key賬戶將為Coin合約的手續費和儲存費各提供為40CFXToken的代付服務。由于目前代付白名單中并沒有賬戶地址,因此還需要添加白名單地址才能完成代付設置。
5.2添加代付白名單
在Coin合約中集成了設置代付白名單的方法,通過調用此方法可以添加或刪除代付白名單。
在ConfluxStudio中訪問contract_addr合約,選擇add_privilege方法:
·account添加白名單的地址。填入minter_key地址
·Value不填
·Signer這筆交易的簽名地址。填入minter_key地址
運行后就成功設置了代付白名單了,至此Coin合約的代付功能設置好了。
5.3代付測試
在進行代付測試前,先查詢并記錄下minter_key賬戶的CFX余額。例如本教程中,minter_key的初始余額為97.6210937497093952CFX。
Kakao旗下公鏈Klaytn與ConsenSys達成戰略合作,以提高Klaytn性能:韓國互聯網巨頭Kakao的公共區塊鏈項目Klaytn宣布,將與以太坊軟件公司ConsenSys建立戰略合作伙伴關系,以推進Klaytn平臺集成數字貨幣。Klaytn和ConsenSys將努力提高Klaytn的性能,并開發具有以下特定功能的隱私版本:隱私反映了金融機構對數據保護的日益關注;可擴展性第2層解決方案,可在不影響速度的情況下為大量用戶提供服務;跨多個區塊鏈的互操作性。(PRNewsWire)[2021/4/23 20:50:48]
回到Coin合約調用頁面,再次調用mint方法并使用minter_key地址增發代幣1000,完成代幣增發后再次查詢minter_key的余額,仍然為97.6210937497093952CFX。
可以看到增發代幣的這筆交易,原本應該由minter_key賬戶支付的手續費,變成了由sponsor_key賬戶支付。
六、前端項目
前端項目源碼可以前往Conflux前端。
6.1預備
6.1.1下載項目并安裝依賴
·下載前端項目:gitclonegithub.com/ObsidianLabs/conflux-frontend-react
·使用npminstall或者yarn進行項目依賴安裝
6.1.2ConfluxPortal的安裝及配置
ConfluxPortal是由Conflux提供的瀏覽器插件,目前提供了Chrome及Firefox的支持,用戶可以使用ConfluxPortal進行私鑰的管理以及交易簽名。
前往ConfluxPortalGitHub下載安裝。項目的源代碼在GitHub中可以找到。
在這里需要將ConfluxStudio中生成的地址導入到ConfluxPortal中。完成插件安裝后,在ConfluxPortal的頁面中選擇Import,將ConfluxStudio中的minter_key的私鑰粘貼到輸入框中,點擊Import按鈕完成私鑰導入。
6.2運行前端項目
在運行項目之前,需要修改一些默認的環境變量。
在前面的教程中部署合約后會生成一個contractCreated,這個值便是部署在網絡中智能合約的地址。打開項目根目錄并找到.env文件,這個文件提供了項目的環境變量,將REACT_APP_CONFLUX_COIN_ADDRESS的值修改為contract_addr。
使用yarnstart啟動前端項目,開發服務器運行起來后會在瀏覽器中打開前端頁面。
項目運行起來后,頁面將顯示四個卡片信息,分別為:
·左上角Conflux網絡信息模塊
·右上角ConfluxPortal模塊
·左下角Coin合約模塊
·右下角SponsorWhitelistControl合約模塊
6.2.1連接ConfluxPortal
點擊右上角組件中的ConnecttoConfluxPortal按鈕,ConfluxPortal頁面將被打開,輸入密碼和選擇賬戶后完成連接。連接成功后,將會在按鈕下看到當前連接的賬戶地址以及賬戶中的CFX余額。
6.2.2運行Coin合約代幣增發和代幣轉賬操作
左下角的組件為Coin合約組件,可以通過這個組件調用代幣增發和代幣轉賬功能。
·代幣增發:選擇mint方法并在receiver中填入增發地址minter_key地址和在amount中填入增發代幣的數量100,點擊PushTransaction,在彈出的ConfluxPortalNotification窗口中點擊Confirm按鈕來確認交易。
·代幣轉賬:選擇send方法并在receiver中填入收款人地址receiver_key地址和在amount中轉賬代幣的數量20,點擊PushTransaction,在彈出的ConfluxPortalNotification窗口中點擊Confirm按鈕來確認交易。
6.2.3查看Coin合約中的余額
選擇balanceOf方法并在tokenOwner輸入框中填入查詢的地址,點擊QueryData按鈕可以查詢到賬戶的余額。
6.2.4查看Sent事件
選擇Sent事件并點擊QueryData可以查詢到轉賬操作所觸發的轉賬事件的記錄。
6.3前端項目解析
項目使用React進行開發。主要由三大部分組成:視圖組件、js-conflux-sdk以及ConfluxPortal。
項目根目錄下的.env環境變量,在這里定義了兩個環境變量,分別為:
·REACT_APP_CONFLUX_NODE_RPC:Conflux的網絡節點地址,目前默認為Oceanus網絡的地址
·REACT_APP_CONFLUX_COIN_ADDRESS:已部署的Coin智能合約地址
6.3.1視圖組件
視圖組件在項目的src/components中,其中App.js為頁面的主入口,負責頁面的排列及合約信息的讀取。
ConfluxNetwork.js
負責渲染Conflux網絡信息,NodeURL的值為.env環境變量文件下的REACT_APP_CONFLUX_NODE_RPC設置的值。
ConfluxPortal.js
負責渲染ConfluxPortal的連接信息,并提供了連接ConfluxPortal的交互按鈕。
·connectConfluxPortal調用ConfluxPortal的enable方法啟用conflux,完成enable后調用getAccount方法獲取到Portal中的賬戶。
·refreshBalance調用ConfluxSDK的getBalance方法來更新賬戶余額信息
·renderPortalButton根據當前不同的狀態,渲染連接Portal的按鈕
ConfluxContract.js
負責渲染Conflux合約信息,本項目中提供了Coin和SponsorWhitelistControl兩個合約。
ConfluxContract.js由三個組件組成,分別為:
·ConfluxContract負責根據傳入的合約abi來渲染合約的信息,包括合約地址、合約方法和事件,合約提交的交互邏輯及顯示執行后的結果
·ContractMethods負責渲染合約abi中的方法和事件的表單及相對應的按鈕
·ConfluxForm負責根據方法或事件的abi來渲染輸入表單
lib
lib在項目的src/lib中,這里的文件主要是為視圖提供包括連接網絡、構造交易、獲取賬戶、讀取合約等服務。
七、總結
在本開發教程中,我們學習了如何使用ConfluxStudio來完成一個完整的CoinDApp開發,其中包括了:
·使用鑰匙對管理器創建賬戶及導出賬戶私鑰
·切換Oceanus網絡,查看網絡信息
·賬戶申請CFXToken
·創建、編譯并部署項目
·解析Coin合約代碼,學習如何編寫合約的讀寫方法及事件
·使用合約瀏覽器調用Coin合約的代幣增發、轉賬、查詢余額及查詢事件
·設置并使用智能合約的代付功能
·將私鑰導入ConfluxPortal并連接前端項目
·在前端項目中調用Coin合約的代幣增發、轉賬、查詢余額及查詢事件
·解析前端項目代碼,學習如何通過ConfluxPortal和ConfluxJavaScriptSDK連接網絡并實現交易
八、關于ConfluxBounty
Conflux基金會為了鼓勵用戶參與生態建設,提供了ConfluxBounty賞金平臺。通過完成Bounty賞金平臺發布的各項任務,參與者可以獲得FC(FansToken)作為獎勵。
8.1FC的價值
FC,全稱FansCoin,是由Conflux基金會與社區成員共同研發的生態代幣,用于記錄和感謝對Conflux生態建設做出貢獻的社區成員。FC目前在Oceanus上運行,Conflux基金會承諾,在主網上線后,鎖定和未鎖定的FC都可以與主網CFX進行1:1承兌,以此保障所有社區成員的勞動成果都可以獲得獎勵。
FC賞金分配方案會展示在賞金任務詳情頁中,包括最高獎金數量、獎金分配人數、獎金數量分布、排行名次確定方式等信息。賬號余額中的賞金獎勵可以隨時申請提現至Conflux錢包。Conflux團隊會對所有的提現申請進行審核。
對于已經通過的提現申請,Conflux團隊會在每周二中午12點進行提幣操作。完成提幣操作后,您的Conflux錢包將會收到您提現的賞金獎勵。
8.2Bounty的價值
ConfluxBounty(bounty.conflux-chain.org)的宗旨是為每一個通證找到價值。Bounty分為幾個板塊:技術、品牌、社群、資源、其他等。
·技術板塊:分為產品、SDK、教程、開發、測試等;主要是獎勵社區的一些技術資源貢獻者。
·品牌板塊:分為文案、設計、視頻、媒體、推廣等;主要是獎勵在各大網絡平臺分享Conflux的各種最新動態,擴大Conflux的生態影響力的活躍貢獻者;
·社群板塊:分為活動、推廣等;主要是獎勵舉辦各種Conflux相關線上線下活動,幫助解答社群問題,活躍日常氣氛等。
·資源板塊:分為政務、商務、人力等;主要是獎勵為生態中引進企業資源,擴建Conflux生態等。
·其他板塊:分為周邊、采購等;主要是獎勵一些其他的零散任務。
ConfluxStudio下載地址和更新日志:
https://github.com/ObsidianLabs/ConfluxStudio/releases
ConfluxdApp開發教程:
https://github.com/ObsidianLabs/conflux-dapp-tutorial
ConfluxdApp教程相關建議:
https://github.com/ObsidianLabs/conflux-dapp-tutorial/issues
幣圈的特色是未知,在選擇產品時,要多思考,投資者需要在風險與收益中總結經驗,制定策略,合理的設置目標與期望.
1900/1/1 0:00:002020年6月17日,中國技術積累最深的公鏈項目QTUM做客BiYong大咖直播,進行了《公鏈生死局》主題分享,為中韓用戶帶來了公鏈的競爭全貌分享.
1900/1/1 0:00:002020年7月19日周日農歷五月廿九 易天說 昨日BTC收取的是一根帶有上下影線的陽柱形態,昨日行情開盤在9146.7一線,清晨先是在開盤價一線附近盤整,在下午4點鐘的時候來了一波拉升.
1900/1/1 0:00:00比特幣目前四小時走的非常強勢,這里的話是直接突破了下方的小區間。 而昨天說的逢低接多的策略顯然就失敗了,這里并沒有給我們一個低點,我自己的話是在突破區間的位置追了一點多.
1900/1/1 0:00:002020年6月20日周六農歷四月廿九 易天說我們再來看一下大餅昨日的行情波動,易天老師昨天早間給出了一個9400-9450進空和9200附近進多的策略.
1900/1/1 0:00:00行情回顧及行情走勢 1.BTC行情回顧 昨日比特幣早間先是受阻9500位置,但隨著一波回調之后,價格進一步上行,高點觸及9584,行情進入震蕩節奏.
1900/1/1 0:00:00