孟巖：ERC-3525 開發入門指南_ART:Bitcrystals

ERC-3525標準是以太坊社區批準通過的半勻質化通證標準，由SolvProtocol提出。

ERC-3525標準定義了一類新型的數字資產，具有以下突出優勢：

與ERC-721標準兼容，具有唯一ID和可視化外觀，可復用現有的大量NFT基礎設施；可拆分、可合并、可計算；具有賬戶特征，可以容納其他數字資產，如ERC-20通證、NFT等，并支持在若干SFT之間的轉賬操作；可以對外觀、功能、資產存儲、鎖定、轉賬等各方面進行編程，并且為元數據的結構化進行了特別的優化，以支持動態變化、復雜金融邏輯等高級功能的開發。由于具有以上的優勢，ERC-3525特別適合用來描述金融工具、數字票證、數字合同等高級數字資產，同時也正在被試用于Web3虛擬物品、動態NFT藝術品、虛擬裝備、真實世界資產通證化等領域，得到了非常廣泛的關注。

SolvProtocol已經將ERC-3525參考實現開源，為有興趣了解和快速嘗試這一全新通證技術的開發者提供有力的支持。這一參考實現同時以開源代碼庫和NPM模塊包的形式提供，開發者可以以此為起點，在這個參考實現代碼的基礎之上通過改寫和擴展，開發自己的ERC-3525應用。

本文檔引導讀者安裝、配置和部署ERC-3525官方參考實現，并引導讀者在此基礎上開發一個簡單的ERC-3525通證合約。這個合約沒有任何特別的功能，但開發、測試和部署這個合約的過程卻是通用的。開發者如果了解和熟練掌握了這個開發過程，就能夠在此基礎上開發復雜的、具有業務功能的ERC-3525通證合約了。

本文檔內容基于ERC-3525參考實現?1.1.0版。

預備知識和技能

ERC-3525參考實現是基于Hardhat框架、以Solidity語言為主開發的。我們推薦讀者在學習ERC-3525開發之前，首先掌握以下知識和技能：

Solidity語言和EVM智能合約開發的基本知識Hardhat智能合約開發框架的基本實用技能當然，要使用Hardhat框架，也必須對于JavaScript或者TypeScript語言有基本的了解。本文檔使用TypeScript進行介紹，但對于有經驗的開發者來說，基于本文檔介紹的內容，很容易可以用JavaScript完成相同的工作。

我們推薦對于Hardhat不熟悉的讀者首先通過Hardhat的官方文檔(https://hardhat.org/docs)來熟悉這一流行的智能合約開發框架。

快速入門

1.開發環境

建議讀者在macOS或Linux的命令行環境下進行ERC-3525開發。如果讀者使用Windows，我們強烈建議讀者首先安裝WindowsSubsystemforLinux，然后在WSL環境中進行如下操作。

讀者可以選擇自己喜歡的任何一種代碼編輯工具來編寫代碼，但我們推薦使用VisualStudioCode，因為Hardhat的開發者NomicFoundation為VisualStudioCode開發了一款Solidity插件，可以幫助提升Solidity和Hardhat開發效率。

此外，Hardhat開發中大量使用JavaScript或者TypeScript編寫測試用例，VisualStudioCode本身對于JavaScript和TypeScript就提供了良好的支持。

Celo基金會宣布與谷歌云合作支持可持續發展的Web3初創公司:金色財經報道，Celo 基金會已與谷歌云合作，以支持 Celo 區塊鏈生態系統中與任務一致的項目，并推動谷歌云服務的早期采用。此次合作將允許在 Celo 上構建的創始人獲得 Google Cloud 和 Firebase 使用的積分，從而增強 Celo 的移動優先基礎設施和去中心化應用程序（Dapps）。根據公告，谷歌云團隊還將為 Celo 基金會的 Founders in Residence 計劃提供指導和指導，并參與虛擬 Celo Camp 加速器計劃，該計劃支持企業家發展以可持續發展為重點的初創公司。此外，這兩個組織旨在共同舉辦以 Web3 可持續性和創新為重點的有針對性的研討會和活動。[2023/4/5 13:45:06]

2.創建HardhatTypeScript項目

首先在命令行環境下通過如下命令準備項目目錄。本示例項目名稱為erc3525-getting-started。kdirec352

在命令行輸入以下命令

將看到以下界面

選擇“CreateaTypeScriptproject”后，Hardhat會提示若干問題，讀者直接通過回車選擇缺省選項即可。

全部選擇完畢后，系統自動執行一系列安裝和準備工作。結束后，使用VisualStudioCode打開目錄，你可以看到如下項目結構：

3.引入和安裝ERC-3525參考實現模塊包

下面，通過npm命令在當前目錄安裝ERC-3525參考實現

npminstallfrom"from"chai";

import{ethers}from"hardhat";

describe("ERC3525GettingStarted",function(){

?//Wedefineafixturetoreusethesamesetupineverytest.

?//WeuseloadFixturetorunthissetuponce,snapshotthatstate,

?//andresetHardhatNetworktothatsnapshotineverytest.

?asyncfunctiondeployGettingStartedFixture(){

??//Contractsaredeployedusingthefirstsigner/accountbydefault

??const=awaitethers.getSigners();

加密做市商GSR將啟動GSR基金會，并認捐1000萬美元:金色財經報道，加密貨幣做市商GSR 將啟動 GSR 基金會，并認捐 1000 萬美元，該公司表示將用于解決邊緣化社區遇到的技術障礙。GSR 基金會將支持全球的非營利組織，旨在糾正慈善生態系統中可以通過新興技術克服的根深蒂固的問題。[2023/2/16 12:11:14]

??constGettingStarted=awaitethers.getContractFactory(

??????"ERC3525GettingStarted");

??constgettingStarted=awaitGettingStarted.deploy(owner.address);

??return{gettingStarted,owner,otherAccount};

?}

?describe("Deployment",function(){

??it("Shouldsettherightowner",asyncfunction(){

???const{gettingStarted,owner}=awaitloadFixture(

????????deployGettingStartedFixture);

???expect(awaitgettingStarted.owner()).to.equal(owner.address);

??});

?});

?describe("Mintable",function(){

??describe("Validations",function(){

???it("Shouldrevertwithnotowner",asyncfunction(){

????const{gettingStarted,owner,otherAccount}=?

??????????awaitloadFixture(deployGettingStartedFixture);

????constslot=3525

????constvalue=ethers.utils.parseEther("9.5");

????awaitexpect(

??????????gettingStarted.connect(otherAccount)

????????????????????????.mint(owner.address,slot,value))

????????????????????????.to.be.revertedWith(

?????"ERC3525GettingStarted:onlyownercanmint"

????);

???});

??});

??describe("Mint",function(){

???it("Shouldminttootheraccount",asyncfunction(){

????const{gettingStarted,owner,otherAccount}=?

美國財政部：央行數字貨幣具有提供顯著效益的潛力:9月16日消息，美國財政部公布數字資產報告。報告稱，美國財政部在數字資產報告中建議美國政府在確定符合國家利益的情況下，推進潛在的央行數字貨幣方面的工作，央行數字貨幣具有提供顯著效益的潛力，但需要對支持央行數字貨幣的技術進行進一步的研究和開發，可能需要數年時間。[2022/9/16 7:01:53]

??????????awaitloadFixture(deployGettingStartedFixture);

????constslot=3525

????constvalue=awaitethers.utils.parseEther("9.5");

????awaitgettingStarted.mint(otherAccount.address,slot,value);

????expect(awaitgettingStarted(1)).to.eq(value);

????expect(awaitgettingStarted.slotOf(1)).to.eq(slot);

????expect(awaitgettingStarted.ownerOf(1))

???????????????????????????????????.to.eq(otherAccount.address);

???});

??});

?});

});

在上面的測試代碼中，我們編寫了一個測試夾具和三個測試用例，分別測試了owner的正確性、mint的操作權限和mint操作的功能。這些用例遵循了Hardhat中編寫智能合約測試代碼的標準方式，讀者可通過Hardhat官方文檔學習，此處不再贅述。

6.運行測試

下面實際運行測試。方法是在項目主目錄執行如下命令：

npxhardhattest

執行結果如下：

這表明我們的智能合約成功通過了所有三個測試用例。

7.添加SVG圖像

ERC-3525最初的設計目標是表達復雜的金融資產，特別是數字票據。既然是數字資產，就必須支持可拆分、可合并，能夠像ERC-20通證一樣進行各種數學計算。另一方面，ERC-3525超越ERC-20的重要一點，就是具有可視化的外在形象，唯有如此才能夠向用戶傳達豐富的信息，使復雜數字資產的復雜性能夠被表達出來。這是ERC-3525選擇兼容ERC-721的主要動機。因此，ERC-3525支持元數據，并且通過從IERC721Metadata接口繼承而來的tokenURI函數返回資源的URL，或者直接返回圖片的內容數據。在NFT當中，普遍的做法是將圖片放在鏈外的存儲上，然后讓tokenURI函數返回其URL。這種設計其實有一個非常大的風險，就是在NFT出售以后，控制存儲的人可以更換URL上的圖片，這樣買家手里的NFT實際上就被篡改了。為了解決這個問題，大多數NFT采用了IPFS存儲，通過哈希值來確保圖片資源的唯一性。即使如此，也難以防范一些破壞，比如將IPFS上存儲的圖片資源刪除。

ERC-3525的設計初衷是為了表達金融資產，金融資產的信息非常敏感和重要，決不能被更換和刪除。因此，Solv建議直接將展現層用SVG表達，并直接放在鏈上。具體方法就是讓tokenURI函數直接返回SVG代碼片段，而不是指向圖像資源的鏈接。

Solana生態自動化網絡Clockwork完成400萬美元融資:8月30日消息，據外媒報道，Solana生態去中心化自動化網絡Clockwork完成400萬美元種子輪融資，Multicoin Capital和Asymmetric領投，參投方包括Solana Ventures和ElCap Ventures。本輪融資將用于擴大團隊、建立社區和支持與合作伙伴項目的集成。

Clockwork的創始人兼首席執行官NickGarfield在表示，Clockwork可以使開發人員能夠使用Solana驗證器網絡安排重復性任務并自動化鏈上工作流程。（TheBlock）[2022/8/31 12:58:45]

在ERC3525GettingStarted合約中加入以下函數：

??functiontokenURI(uint256tokenId_)publicviewvirtualoverridereturns(stringmemory){

????returnstring(

??????abi.encodePacked(

????????'<svgwidth="600"height="600"xmlns="http://www.w3.org/2000/svg">',

????????'<g><title>Layer1</title>',

????????'?<rectid="svg_1-ubxx"height="600"width="600"y="0"x="0"stroke="#000"fill="#000000"/>',

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_2-ubxx"y="340"x="200"stroke-width="0"stroke="#000"fill="#ffffff">TokenId:',

????????tokenId_.toString(),

????????'</text>',

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_3-ubxx"y="410"x="200"stroke-width="0"stroke="#000"fill="#ffffff">Balance:',

????????balanceOf(tokenId_).toString(),

????????'</text>',

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_3-ubxx"y="270"x="200"stroke-width="0"stroke="#000"fill="#ffffff">Slot:',

????????slotOf(tokenId_).toString(),

????????'</text>',

Celsius已向Compound Finance償還1000萬美元的DAI:6月21日消息，Celsius 已向 Compound Finance 償還 1000 萬美元的 DAI，這可能是 Celsius 朝著償付能力邁出了一步。

據悉，Celsius 于 6 月 13 日禁用了提款、交易等服務，目前仍然沒有重新啟用。在過去一周里 Celsius 還進行了許多其他還款，包括向 Oasis Protocol 金庫支付了 5360 萬美元的 DAI。（Cryptobriefing）[2022/6/21 4:42:16]

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_4-ubxx"y="160"x="150"stroke-width="0"stroke="#000"fill="#ffffff">ERC3525GETTINGSTARTED</text>',

????????'</g></svg>'

??????)

????);

??}

這將生成一張黑色背景的SVG圖像，顯示如下：

注意，其中Slot、TokenId和Balance的數值都是直接從ERC-3525通證的當前狀態中提取的。

8.部署到本地節點

Hardhat框架自帶一個以太坊本地節點的實現，特別針對開發過程中的需求做了不少優化。我們推薦在開發調試過程中將合約部署到這個節點上。

在deploy目錄修改deploy.ts如以下內容：

import{ethers}from"hardhat";

asyncfunctionmain(){

?constGettingStarted=awaitethers.getContractFactory("ERC3525GettingStarted");

?constgettingStarted=awaitGettingStarted.deploy();

?gettingStarted.deployed();

?console.log(`GettingStarteddeployedto${gettingStarted.address}`);

}

//Werecommendthispatterntobeabletouseasync/awaiteverywhere

//andproperlyhandleerrors.

main().catch((error)=>{

?console.error(error);

?process.exitCode=1;

});

打開一個新的Terminal，運行hardhat內建節點

npxhardhatnode

運行結果如下：

在項目主目錄執行以下命令：

npxhardhatrun--networklocalhostscripts/deploy.ts

執行成功后將看到如下結果。注意紅框的地址部分，后面的交互會用到。

智能合約部署之后，可以通過hardhatconsole命令與之進行交互，這是Hardhat節點的一個重要優勢，能夠大大簡化測試和調試階段的工作。輸入以下命令：

npxhardhatconsole--networklocalhost

交互指令及結果如下：

~/Sources/erc3525-getting-started$npxhardhatconsole--networklocalhost

WelcometoNode.jsv16.18.1.

Type".help"formoreinformation.

>constGettingStarted=awaitethers.getContractFactory("ERC3525GettingStarted")

undefined

>constgettingStarted=awaitGettingStarted.attach('<此處替換成你部署的地址，也就是上一圖的紅框處的地址>')

undefined

>const=awaitethers.getSigners()

undefined

>awaitgettingStarted.mint(otherAccount.address,3525,10000)

{

?hash:'0x94d428b32da7e66e8f0e2d48a37ddb9072dca54013130d95779495e1e443df2c',

...

}

讀者可以自行輸入一些TypeScript代碼來嘗試與智能合約進行交互。

9.在Sepolia測試網絡上部署

在開發環境下測試和調試完畢之后，就需要部署到測試鏈上了。測試鏈提供了基本等同于主鏈的運行環境，但在上面進行測試和調試無需繳納高昂的gas費用。另一方面，有些智能合約的功能必須在測試鏈上才能運行，比如與Oracle的交互，在開發用的虛擬節點上是不支持的。我們這個案例非常簡單，用不到Oracle，但是作為一個原則，一個智能合約在上主鏈之前，一定是要在測試鏈上運行測試無誤才可以。

以太坊已經于2022年9月15日升級到POS，因此之前幾個流行的測試鏈，如Ropsten,Rinkeby,Kovan等已經被廢棄。現在主要的兩個測試鏈是Goerli和Sepolia。其中Goerli歷史較長，完全開放，比較適合于測試復雜的智能合約，而Sepolia較新，由一組確定的驗證者節點組成，不能隨意加入，是當前進行DApp開發測試的首選測試鏈。在這個例子中，我們選擇Sepolia測試鏈。

為了部署在Sepolia測試鏈，讀者需要通過https://www.infura.io/申請infuraAPIKEY。我們假定讀者已經完成這項工作，下面直接介紹部署的過程。

修改hardhat.config.ts如下：

import{HardhatUserConfig}from"hardhat/config";

import"`,

???accounts:

????process.env.PRIVATE_KEY!==undefined?:,

??},

?}

};

exportdefaultconfig;

然后在Terminal命令行環境中執行以下命令，設置?infuraapikey和privatekey：

exportINFURA_KEY=<YOUR_INFURA_KEY>;exportPRIVATE_KEY=<YOUR_PRIVATE_KEY>;

請注意，將<YOUR_INFURA_KEY>替換成你申請的infuraAPIKEY，將<YOUR_PRIVATE_KEY>替換成私鑰。強烈建議測試網和主網的私鑰隔離，不要使用已有的主網私鑰。

在Sepolia測試網中進行測試需要準備一些測試幣，即SepoliaFaucETH。讀者可以到https://faucet.sepolia.dev/去申領一些FaucETH以供測試之用。

這些準備工作做好之后，就可以執行腳本進行部署了：

npxhardhatrun--networksepoliascripts/deploy.ts

執行成功后，結果如下。請注意紅框中的地址，我們將在下一步中使用到。

10.鑄造ERC3525GettingStarted通證

下面我們來鑄造一個ERC3525GettingStarted通證。我們采用的方法是使用TypeScript調用合約功能進行通證鑄造，這與在Web3DApp開發中的模式是一致的。

首先在scripts目錄下新建文件mint.ts，代碼如下：

import{ethers}from"hardhat";

asyncfunctionmain(){

?const=awaitethers.getSigners();

?constGettingStarted=awaitethers.getContractFactory("ERC3525GettingStarted");

?constgettingStarted=awaitGettingStarted.attach('<部署合約地址>');

?consttx=awaitgettingStarted.mint(owner.address,3525,20220905);

?awaittx.wait();

?consturi=awaitgettingStarted.tokenURI(1);

?console.log(uri);

}

//Werecommendthispatterntobeabletouseasync/awaiteverywhere

//andproperlyhandleerrors.

main().catch((error)=>{

?console.error(error);

?process.exitCode=1;

});

請注意，將代碼中<部署合約地址>替換成上一節紅框中的地址。

最后，執行以下命令：

npxhardhatrun--networksepoliascripts/mint.ts

這樣，我們就成功的鑄造了一張ERC3525GettingStarted通證。

怎么確認這一點呢？可以到SepoliaEtherscan(https://sepolia.etherscan.io/)上去查看鑄造出來的token。在瀏覽器地址欄里輸入：

https://sepolia.etherscan.io/address/<部署合約地址>

請注意，將<部署合約地址>替換成上一節紅框中的地址。

恭喜你！如果一切順利，你就成功的開發和部署第一個ERC-3525通證了，可以對它進行各種新的操作了，比如拆分、合并、在兩個通證之間轉賬，等等，趕快嘗試一下吧！

本文完整的示例代碼參見GitHub。

進階學習

本教程對于ERC-3525半勻質化通證應用開發的過程進行了簡明扼要的闡述。讀者可以由此出發，開發具有豐富功能和高級外觀的SFT。當然，如果想要深入學習ERC-3525的知識和開發技術，這只是一個起點，我們推薦您從以下幾個方面入手深入學習：

閱讀ERC-3525白皮書研究ERC-3525參考實現研究SFTLabs官方提供的Showroom案例研究ERC-3525技術專家開發的以太幣現金鈔案例CryptoNotes?(https://cryptonotes.fun/)我們也將繼續發表一系列文章和教程來幫助開發者掌握ERC-3525技術。

責任編輯：Kate

Tags：INGGETSTAARTRoyal Kingdom CoinBitGet中國用戶Bitcrystals1ART幣

BNB價格