孟岩：ERC-3525 开发入门指南

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

2.创建HardhatTypeScript项目

首先在命令行环境下通过如下命令准备项目目录。本示例项目名称为erc3525-getting-started。kdirec352

CZ：Binance不是稳定币发行商，BUSD对我们来说不是好生意:金色财经报道，CZ在Binance官方推特Space上发言表示，在美国监管打击之后，加密货币行业可能会远离与美元挂钩的稳定币，甚至重新审视算法等价物。?目前对稳定币施加的压力很大，这将缩小美元稳定币市场，因此该行业正在探索其它选择。我们会看到更多以欧元、日元、新加坡元为基础的稳定币出现。监管机构围绕稳定币的监管打击部分原因是由 Terra Luna 算法稳定币在 5 月份的崩溃引发的。

CZ表示，BUSD不是他或他的团队的想法，而是源自Paxos，Binance不是稳定币发行商，BUSD对我们来说从来都不是什么好生意。

CoinGecko数据显示，在过去24小时内，约有5.4亿美元的 BUSD 被赎回。[2023/2/15 12:08:38]

在命令行输入以下命令

将看到以下界面

选择“CreateaTypeScriptproject”后，Hardhat会提示若干问题，读者直接通过回车选择缺省选项即可。

全部选择完毕后，系统自动执行一系列安装和准备工作。结束后，使用VisualStudioCode打开目录，你可以看到如下项目结构：

3.引入和安装ERC-3525参考实现模块包

下面，通过npm命令在当前目录安装ERC-3525参考实现

npminstall/img/20230515145903723818/6.jpg "/>

4.编写智能合约

为了简单起见，我们规避复杂的业务逻辑，以一个最简单的应用案例来讲解ERC-3525的代码开发过程。这个案例中，我们创建一个最简单的ERC-3525通证，它只具备ERC-3525的基本功能，没有额外的功能。不过我们将为它创建一个“外表”，使它可以用SVG动态图像来显示内部的状态。

在Hardhat项目创建过程中，自动添加了一个实例代码文件Lock.sol。本范例中不需要这文件，因此首先请删除contracts/Lock.sol，并在contracts目录中新建文件ERC3525GettingStarted.sol，代码如下：

美元指数DXY短线下挫近30点，报101.59，日内跌0.31%:金色财经报道，美元指数DXY短线下挫近30点，报101.59，日内跌0.31%。[2023/1/26 11:30:20]

在以上代码中，我们创建了一个新的合约ERC3525GettingStarted。这个合约从ERC3525参考实现合约中派生，其构造函数直接调用ERC3525合约的构造函数，传入合约的全名、符号和小数位数，并为owner赋值。我们并且添加了一个mint()函数，确保只有owner能够铸造这个ERC-3525通证。具体的铸造过程，是通过调用ERC3525合约当中的_mint()实现的，这样我们就复用了ERC3525合约的参考实现，得到了一个最简单的ERC-3525通证合约。

有了ERC-3525的参考实现，很多基本功能都可以直接调用相应的函数实现，开发者可以只聚焦于业务逻辑和创新功能，这样就大大简化了相关的开发。

代码编写完毕之后，在命令行执行以下命令进行编译：

npxhardhatcompile

编译成功结果如下：

5.编写测试用例

使用Hardhat框架开发智能合约的主要好处之一是可以进行自动化测试。下面我们介绍如何使用Hardhat的测试框架对ERC3525GettingStarted合约进行自动化测试。

测试代码集中在test目录下。同样，我们首先删除test/Lock.ts，然后在test目录下新建ERC3525GettingStarted.ts，代码如下：

import{loadFixture}from"from"chai";

import{ethers}from"hardhat";

describe("ERC3525GettingStarted",function(){

?//Wedefineafixturetoreusethesamesetupineverytest.

?//WeuseloadFixturetorunthissetuponce,snapshotthatstate,

?//andresetHardhatNetworktothatsnapshotineverytest.

?asyncfunctiondeployGettingStartedFixture(){

??//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);

Bitpanda获德国联邦金融监管局颁发的许可证:金色财经报道，奥地利加密货币交易所Bitpanda获得来自德国联邦金融监管局（BaFin）颁发的许可证，允许为德国居民提供加密货币托管以及加密资产的自营交易。（CoinDesk）[2022/11/22 7:56:50]

???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}=?

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

执行结果如下：

Y Combinator W23孵化计划于今日截止申请:9月13日，据Y Combinator官方消息，W23孵化计划申请的截止时间将是太平洋时间9月12日晚8点（北京时间9月13日早11点），相关申请审核和批准工作预计在2023年1-3月进行。

此前报道，在上一期Y CombinatorS22孵化计划中，最终有30家加密初创公司入围。[2022/9/13 13:25:39]

这表明我们的智能合约成功通过了所有三个测试用例。

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代码片段，而不是指向图像资源的链接。

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

Hector Network与多特蒙德足球俱乐部达成合作:金色财经消息，近日，Hector Network宣布与德甲球队BVB（多特蒙德足球俱乐部）达成合作。据介绍，BVB成立于1909年，在德国国内拥有超过1000万名球迷，此外，还在全球范围内拥有快速增长的球迷群体。（AMBCrypto）[2022/8/7 12:07:38]

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

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

????????'?<textxml:space="preserve"text-anchor="start"font-family="NotoSansJP"font-size="24"id="svg_4-kcwr"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

标签：INGGETSTATARTSingularityNETtogetherbnb按t打不开了STABLEXPolkastarter

ADA热门资讯