孟巖：ERC-3525 開發入門指南_STA

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就提供了良好的支持。

21e6 Capital：一些基金可能很快會向加密貨幣領域注入更多現金:金色財經報道，據瑞士投資顧問21e6 Capital AG的數據，2023年上半年加密貨幣基金的平均回報率為15.2%，但BTC的漲幅約為 84%，買入并持有比特幣方法在2023年上半年的表現高于大多數加密貨幣基金68.8%。在報告中，21e6 Capital AG的營銷主管Maximilian Bruckner表示，加密基金在之前的牛市中經常能夠顯著優于比特幣。

Bruckner將2023年加密貨幣基金表現不佳的大部分原因歸咎于充滿挑戰的市場條件以及 2022 年底他們手頭有大量現金。該報告表明，在 2022 年FTX 和其他加密項目崩潰之后許多加密基金選擇規避風險并開發現金緩沖，因此錯過了 2023 年上半年 BTC 價格的大幅上漲。

此外，該報告強調，投資者情緒較2023年上半年略有改善，這表明一些基金可能很快就會開始向加密貨幣領域注入更多現金。[2023/8/5 16:20:33]

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(){

glassnode：最近熱潮并沒有引發Uniswap交易活動的明顯增加:金色財經報道，glassnode發推稱，以太坊上的Uniswap交易量目前為55.7億美元/周，仍明顯低于往年水平。2023年初，人們對LiquidStake代幣的興趣出現了交易量激增，“meme代幣”也出現了短暫的上升，但后來逐漸消失。從這個角度看，我們可以發現，最近圍繞BTC ETF申請和瑞波幣對SEC判決的熱潮并沒有引發Uniswap交易活動的明顯增加。[2023/8/2 16:13:09]

??//Contractsaredeployedusingthefirstsigner/accountbydefault

??const=awaitethers.getSigners();

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

????);

UniSat網站將從UTC 03:30-06:00進行維護:5月9日消息，UniSat Wallet 發推稱，UniSat 網站進行維護 150 分鐘，將從世界標準時間 03:30-06:00 進行維護。在此期間，將執行必要的升級和修復以改善用戶的體驗。[2023/5/13 15:01:06]

???});

??});

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

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

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

??????????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上存儲的圖片資源刪除。

Terra Builder Alliance發布Terra 2.0提案:5月18日消息，Terra Builder Alliance（建設者聯盟）發布Terra 2.0鏈愿景統一提案。稱本提案的目標是： 1. 確保建設者得到適當的激勵 2. 盡可能多地保留當前的LUNAtics 3. 將盡可能多的新LUNAtics帶入網絡。參與起草本提案的主要利益相關者有：建設者生態系統；驗證者；基礎設施團隊；做市商；風險投資和其他各種重要利益相關者。均已表示支持該計劃。該提案已得到 TBA 和 TFL 的認可。并計劃于5月27日啟動Terra 2.0網絡。[2022/5/18 3:25:26]

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

在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-qobx"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-qobx"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-qobx"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-qobx"y="270"x="200"stroke-width="0"stroke="#000"fill="#ffffff">Slot:',

V神：不認同主架構師假設，比特幣也是由人類設計出的社會系統:5月18日消息，Vitalik Buterin 在回復 Blockstream 首席執行官 Adam Back 的一條帖子中表示，并不認同一個所謂的“大師級架構師的假設”，最初的加密貨幣（比特幣）也是一個由人設計的社會系統。加密貨幣的支持者認為 Satoshi Nakamoto 的協議是完美的這一事實證明，他們實際上并沒有拒絕主架構師假設。 此前，V神表示，盡管他熱愛權力下放和民主，但在許多政策問題上，他比普通人更傾向于與知識精英達成一致。[2022/5/18 3:25:06]

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

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

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_4-qobx"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：GETSTAINGSTAROnegetcoinstake幣2023年會不會暴漲Kingaru星鏈幣starl未來價格

比特幣交易所