在加密貨幣的幾乎每個領域,支付都是一個反復出現的話題,特別是向多個質押者提供支付。例如,DAO希望為多個計劃提供資金,DEX希望合并向某些參與者分配交易費用,或者團隊希望將代幣作為月薪分發給團隊成員。
智能合約使我們能夠自動化這些類型的支付功能,這就限制了人工管理支付所導致的潛在錯誤,并允許我們將寶貴的時間花在其他生產性任務上。
今天,我們將學習如何創建自己的ERC20代幣支付拆分器,它可以合并到任何項目中!
先決條件和設置
下面的內容要求你對Solidity有點熟悉,不過任何人都可以學習。
項目架構
我們將創建兩個合約。第一個將是ERC20代幣支付拆分智能合約,第二個將是模擬池智能合約。ERC20代幣支付拆分器智能合約將是抽象的,并持有用于管理收付方及其各自支付部分的邏輯和數據。模擬池將繼承ERC20代幣支付拆分器,以便我們可以自動將支付分發給多個質押者。在兩個合約中拆分支付功能的原因有兩個:
展示在真實世界的用例中代幣支付拆分合約的使用
確保代幣支付拆分合約足夠靈活,任何人都可以選擇并集成到自己的項目中
OpenZeppelin已有一個名為PaymentSplitter
SafeERC20
paymentToken是我們用于支付的ERC20代幣的地址。
_totalShares提供來自所有收款人的份額相加。
_totalTokenReleased是已支付給所有收款人的支付代幣總額。
_payees提供了當前所有收款人地址的數組。
_shares是收款人地址與分配給他們的份額數量的映射。
_tokenReleased是收款人地址到支付代幣數量的映射。
現在放置一個接受三個參數的構造函數。第一個參數是我們希望在合約部署中初始化的收款人的數組。第二個參數是每個收款人的份額數組。第三個是將用于支付的ERC20代幣的地址。
pragmasolidity0
構造函數包含一個require語句,以確保兩個數組具有相同的長度,以便每個收款人都有分配給他們的份額。還有另一個require語句,以確保合約初始化與至少有一個收款人。
還有一個for循環,它將每個收款人及其份額分配我們上面創建的變量。這是通過一個名為_addPayee的函數完成的,我們將很快創建這個函數。
Arbitrum鏈上已創建賬戶總量突破400萬,過去4個月增長一倍:金色財經報道,據Dune Analytics最新數據顯示,以太坊Layer 2網絡Arbitrum鏈上已創建賬戶總量突破400萬,本文撰寫時達到408.6萬個,其中活躍賬戶總量為332.7萬個。 此外,當前Arbitrum鏈上ERC-20累計鎖倉量達到80.81億美元,鎖定總價值為50.96億美元,鏈上智能合約創建總量為1,862,092個。歷史數據顯示,Arbitrum鏈上賬戶總量在去年11月突破200萬,這意味著該指標在過去4個月已增長一倍。[2023/3/26 13:26:58]
構造函數就緒后,再添加幾個函數來調用和獲取合約變量。
pragmasolidity0
functionshares(addressaccount)publicviewreturns(uint256){??return_shares;}functionpayee(uint256index)publicviewreturns(address){??return_payees;}
現在我們將創建用于添加收款人的函數。
pragmasolidity0
_addPayee是我們在構造函數中調用的用于設置收款人數組的函數。這個函數有兩個參數,收款人的帳戶和與其相關的份額數量。然后它會檢查賬戶是否為零地址,份額是否大于零,以及該賬戶是否已經注冊為收款人。如果所有檢查都通過,那么我們將數據添加到各自的變量中。
現在讓我們添加一個函數來支持將代幣分發給收款人。
pragmasolidity0
Release是一個任何人都可以調用的函數,它接受一個現有收款人帳戶的參數。來分析一下這個函數中發生了什么。首先,它檢查帳戶是否有分配給它的份額。然后,它創建一個名為tokenTotalReceived的變量,該變量將合約的當前代幣余額與之前釋放的代幣總數相加。創建另一個稱為payment的變量,該變量確定收到的代幣總額中有多少是欠賬戶的,然后減去多少已經釋放到賬戶。然后,一個require語句檢查當前支付金額是否大于零(即,當前是否欠下了更多代幣)。如果該檢查通過,則更新賬戶的tokenReleased,并更新totalTokenReleased。最后,支付給賬戶的代幣金額被轉賬。
現在函數已經就位了!但是這個合約還有一件事要做....事件!
我們將在合約中添加兩個事件,將事件添加到合約頂部是一個良好的實踐。
pragmasolidity0
開放元宇宙內容創建工具開發公司OAV完成25萬美元pre-seed輪融資:金色財經報道,開放元宇宙內容創建工具開發公司 OAV 宣布完成 25 萬美元 pre-seed 輪融資,Ascent Ventures 參投。OAV 公司開發的元宇宙內容創建工具“StellarX”可以幫助企業和個人通過人工智能訪問元宇宙并在其中創建可訪問和協作的虛擬工作空間,該工具的協作方包括META、戴爾、NVIDIA、Microsoft for Startups、VIVEX 和 ScaleAI。(雅虎財經)[2023/2/8 11:54:51]
functionrelease(addressaccount)publicvirtual{??///existingFunctionCode??emitPaymentReleased(account,payment);}
現在代幣支付拆分合約已經建立!為了理解這在真實場景中是如何工作的,讓我們創建一個模擬池合約,它將導入代幣支付拆分器。
創建模擬池合約
這個合約不會很復雜,因為我們只是想演示如何集成代幣支付拆分器。這個合約定期收到我們想分發給收款人列表的特定ERC20代幣。這個ERC20代幣可以通過不同的場景到達,比如用戶存款或來自另一個智能合約的重定向費用。在現實生活中,根據不同的項目,可能會有一個更復雜的合約,包含更多的功能來滿足用戶的用例。
在合約文件夾中,創建一個名為MockPool.sol的新文件。然后添加以下代碼。
pragmasolidity^0.8.0;import"??functiondrainTo(address_transferTo,address_token)publiconlyOwner{????require(????_token!=paymentToken,????"MockPool:TokentodrainisPaymentToken"????);????uint256balance=IERC20(_token).balanceOf(address(this));????require(balance>0,"MockPool:Tokentodrainbalanceis0");????IERC20(_token).safeTransfer(_transferTo,balance);??}}
在這份合約中,導入三樣東西。首先是OpenZeppelin的Ownable實用程序,它在某些函數上使用唯一的onlyOwner修飾符。第二個是SafeERC20,它允許安全的ERC20代幣轉賬,正如將在合約中看到。第三個是我們的TokenPaymentSplitter合約。
IOTA基金會在Selv上創建可重復使用的KYC PoC:IOTA基金會與荷蘭銀行de Volksbank合作,在IOTA的開源自主權身份(SSI)示范應用Selv上創建了一個可重復使用的了解客戶(KYC)概念驗證(PoC)。使用此技術的演示旨在展示如何使用 SSI 來創建符合通用數據保護條例 (GDPR) 的安全且可重復使用的 KYC。該演示可在 Selv 應用程序上使用,允許用戶創建唯一 ID 并完成隨機 KYC。(cryptonewsflash)[2021/8/22 22:29:26]
在MockPool構造函數中,我們需要TokenPaymentSplitter提供相同的三個參數,我們只是將它們傳遞給我們繼承的合約。
在這個合約中添加了另一個函數,drainTo。它實際上與TokenPaymentSplitter合約沒有任何關系。它只是在另一個沒有設置為支付代幣的ERC20代幣被發送到池時的一種安全機制,然后有一種方法讓合約所有者釋放該代幣。
測試合約
測試智能合約與創建它們同樣重要。這些合約處理的資產通常是屬于其他人的,所以作為開發人員,我們有責任確保這些資產按照他們應該的方式工作,并且我們的測試可以覆蓋幾乎所有的邊緣情況。
將在這里進行的測試是一些示例,以顯示TokenPaymentSplitter智能合約按照我們的預期工作。在處理自己的項目時,可能希望創建專門適合自己的用例的測試。
為了支持我們的測試,我們希望包含一個ERC20代幣,為此,我們將創建一個新的solididity文件,該文件導入OpenZepplinERC20模板以供我們的測試使用。在合約文件夾中,創建一個名為Imports.sol的新文件,并包括以下代碼:
pragmasolidity^0.8.0;import"
現在,在test文件夾中創建一個名為test.js的文件。在這個文件的頂部,我們將導入支持我們的測試的包。
const{expect}=require('chai')const{ethers}=require('hardhat')
現在,為了設置測試,我們將首先創建必要的變量,創建beforeEach函數,該函數在每次測試之前調用,并創建一個空的describe函數,該函數將很快包含我們的測試。
describe('TokenPaymentSplitterTests',()=>{letdeployerletaccount1letaccount2letaccount3letaccount4lettestPaymentTokenletmockPoolbeforeEach(async()=>{??=awaitethers.getSigners()??constTestPaymentToken=awaitethers.getContractFactory('ERC20PresetMinterPauser')??testPaymentToken=awaitTestPaymentToken.deploy('TestPaymentToken','TPT')??awaittestPaymentToken.deployed(。)describe('Addpayeeswithvaryingamountsanddistributepayments',async()=>{}}
西班牙經濟部提議為加密相關事宜創建金融客戶申訴專員:西班牙經濟部部長NadiaCalvi?o試圖將其監護范圍擴大到金融機構,創建金融客戶申訴專員,以涵蓋諸如保護加密貨幣服務中的消費者等主題。(Bitcoin.com)[2021/3/13 18:41:58]
在這些部分就位后,讓我們進入這些測試的核心部分!
支付代幣平均分配給多個收款人
在我們的第一個測試中,我們想看看當我們部署一個包含平均分配份額的收款人列表的合約時會發生什么。下面是測試代碼。
it('paymenttokenisdistributedevenlytomultiplepayees',async()=>{??payeeAddressArray=??payeeShareArray=??constMockPool=awaitethers.getContractFactory('MockPool')??mockPool=awaitMockPool.deploy(????payeeAddressArray,????payeeShareArray,????testPaymentToken.address??)??awaitmockPool.deployed()??awaittestPaymentToken.mint(mockPool.address,100000)??awaitmockPool????.connect(account1)????.release(account1.address)??awaitmockPool????.connect(account2)????.release(account2.address)??awaitmockPool????.connect(account3)????.release(account3.address)??awaitmockPool????.connect(account4)????.release(account4.address)??constaccount1TokenBalance=awaittestPaymentToken.balanceOf(account1.address)??constaccount2TokenBalance=awaittestPaymentToken.balanceOf(account2.address)??constaccount3TokenBalance=awaittestPaymentToken.balanceOf(account3.address)??constaccount4TokenBalance=awaittestPaymentToken.balanceOf(account4.address)??expect(account1TokenBalance).to.equal(25000)??expect(account2TokenBalance).to.equal(25000)??expect(account3TokenBalance).to.equal(25000)??expect(account4TokenBalance).to.equal(25000。)
鉆石巨頭戴比爾斯利用區塊鏈 創建鉆石銷售的虛擬分類帳:世界上最大的鉆石生產商戴比爾斯(De Beers)目前在運行一個試點計劃,該計劃使用區塊鏈技術來創建鉆石銷售的虛擬分類帳。這將使戴比爾斯能夠向所有參與者展示其交易的同時,將參與者的身份和交易的價值隱藏。這一舉措可以讓購買者放心,他們所購買的鉆石既不是合成的,也不是真正的所謂的“沖突鉆石”(用于資助戰爭,專制主義或恐怖主義)。這也可以使銀行們放心,因為這些銀行經常會遇到隱秘的商業欺詐,而且貸款通常以可操縱的紙質發票為基礎。[2018/1/17]
在這個測試中,我們將合約分配給4個收款人,每個人都有10個相同的份額。然后我們向合約發送100000單位的testPaymentToken,并向每個收款人發放付款。在測試中可以注意到,每個收款人都在調用函數來向自己釋放代幣。
支付代幣不均勻地分配給多個收款人
在第二個測試中,我們希望確保即使每個收款人的份額分配不均,數學計算仍然有效。
it('paymenttokenisdistributedunevenlytomultiplepayees',async()=>{??payeeAddressArray=??payeeShareArray=??constMockPool=awaitethers.getContractFactory('MockPool')??mockPool=awaitMockPool.deploy(????payeeAddressArray,????payeeShareArray,????testPaymentToken.address??)??awaitmockPool.deployed()??awaittestPaymentToken.mint(mockPool.address,100000)??awaitmockPool????.connect(account1)????.release(account1.address)??awaitmockPool????.connect(account2)????.release(account2.address)??awaitmockPool????.connect(account3)????.release(account3.address)??awaitmockPool????.connect(account4)????.release(account4.address)??constmockPoolTestPaymentTokenBalance=awaittestPaymentToken.balanceOf(????mockPool.address??)??constaccount1TokenBalance=awaittestPaymentToken.balanceOf(account1.address)??constaccount2TokenBalance=awaittestPaymentToken.balanceOf(account2.address)??constaccount3TokenBalance=awaittestPaymentToken.balanceOf(account3.address)??constaccount4TokenBalance=awaittestPaymentToken.balanceOf(account4.address)??expect(mockPoolTestPaymentTokenBalance).to.equal(1)??expect(account1TokenBalance).to.equal(30303)??expect(account2TokenBalance).to.equal(15151)??expect(account3TokenBalance).to.equal(33333)??expect(account4TokenBalance).to.equal(21212。)
看起來收款人還能拿到錢,但注意到什么了嗎?合約中還剩下一個單位的支付代幣!由于Solidity沒有小數,當它達到最低單位時,它通常會四舍五入,這可能會導致合約塵埃飛揚,就像我們在這里看到的。不過不用擔心,因為我們預計未來會有支付代幣流入合約,所以它將繼續分發。
支付代幣不均勻地分配給多個收款人,并將額外的支付代幣發送到池中
這與之前的測試類似,不過在資金被釋放給收款人之間增加了更多支付代幣發送到池中。這表明,隨著支付代幣不斷流入模擬池合約,數學仍然可以確保收款人收到正確的金額。
it('paymenttokenisdistributedunevenlytomultiplepayeeswithadditionalpaymenttokensenttopool',async()=>{??payeeAddressArray=??payeeShareArray=??constMockPool=awaitethers.getContractFactory('MockPool')??mockPool=awaitMockPool.deploy(????payeeAddressArray,????payeeShareArray,????testPaymentToken.address??)??awaitmockPool.deployed()??awaittestPaymentToken.mint(mockPool.address,100000)??awaitmockPool????.connect(account1)????.release(account1.address)??awaitmockPool????.connect(account2)????.release(account2.address)??awaittestPaymentToken.mint(mockPool.address,100000)??awaitmockPool????.connect(account3)????.release(account3.address)??awaitmockPool????.connect(account4)????.release(account4.address)??awaitmockPool????.connect(account1)????.release(account1.address)??awaitmockPool????.connect(account2)????.release(account2.address)??constmockPoolTestPaymentTokenBalance=awaittestPaymentToken.balanceOf(????mockPool.address??????)??constaccount1TokenBalance=awaittestPaymentToken.balanceOf(account1.address)??constaccount2TokenBalance=awaittestPaymentToken.balanceOf(account2.address)??constaccount3TokenBalance=awaittestPaymentToken.balanceOf(account3.address)??constaccount4TokenBalance=awaittestPaymentToken.balanceOf(account4.address)??expect(mockPoolTestPaymentTokenBalance).to.equal(1)??expect(account1TokenBalance).to.equal(60606)??expect(account2TokenBalance).to.equal(30303)??expect(account3TokenBalance).to.equal(66666)??expect(account4TokenBalance).to.equal(42424。)
現在所有的測試都就緒了,是時候運行它們了,看看它們是否工作!在項目根文件夾中,使用npxhardhattest啟動測試。如果一切都是正確的,那么你應該看到如下圖所示的所有綠色格子。
如上所述,我們需要做更多的測試,以確保整個項目/協議按照預期工作,支付拆分器是它的集成部分。這將意味著更多的單元測試來覆蓋所有可用的功能,以及更復雜的集成測試,這取決于具體用例。
總結
支付是許多加密協議的一個常見方面,有幾種方法可以解決它們。今天我們學習了一種管理支付的方法,盡管用戶甚至可以在此合約的基礎上構建以滿足您的特定需求,如跨多個代幣啟用支付,添加額外的收款人或移除收款人,或在一個函數調用中同時分發所有支付。
Source:https://medium.com/coinmonks/create-an-erc20-token-payment-splitting-smart-contract-c79436470ccc
Tags:TOKETOKKENTOKENBillion TokenCrystal Tokenitoken翻譯COVID-19 Recovery Token
9月23日,推特宣布已在iOS版本的App中上線支持比特幣支付的小費打賞功能,并將在未來幾周內向Android用戶推出.
1900/1/1 0:00:00開源軟件和社區捐助平臺?Gitcoin?正式開啟了第11輪捐助活動,鏈聞為你梳理一些值得關注的種子選手.
1900/1/1 0:00:00MechanismCapital聯合創始人Andrewkang近日發推公布MechanismCapital建倉CELR的消息并闡述原因,他表示Layer2不是一個贏家通吃的領域.
1900/1/1 0:00:00美國證券交易委員會是世界上最強大的金融監管機構之一,也是政府推動加密貨幣行業監管的關鍵參與機構.
1900/1/1 0:00:00金色周刊是金色財經推出的一檔每周區塊鏈行業總結欄目,內容涵蓋一周重點新聞、礦業信息、項目動態、技術進展等行業動態。本文是其中的新聞周刊,帶您一覽本周區塊鏈行業大事.
1900/1/1 0:00:00金色財經報道,根據美國眾議院籌款委員會(HouseCommitteeonWaysandMeans)周一發布的一份文件,該提議將把“某些高收入個人”的長期資本利得稅率從現有的20%提高到25%.
1900/1/1 0:00:00