合约的元数据——Solidity中文文档(6)

solidity-doc-cn:以太坊Solidity语言中文文档 团结中文文档 工作指南 Github使用基础 看到廖雪峰的 RST文档基础 RST文档格式的一个 工作流 参见当前目录下文档: translation_process.md 工作进度 参见当前目录下文档: status.md 常见问题 fork出的仓库如何同步源的内容: : 如何检查文件(参考)的提交哈希: git log filename.rst 文档如何合并: ://solidity-cn.rtfd.io是我们的托管地址,readthedocument这个网站是免费的,可以关联多个仓库,并且可以由git push触发自动构建,以达到文档更新的目的。 原中文文档更新怎么办:我们需要人去 立即下载

image

写在前面:HiBlock区块链社区成立了翻译小组,翻译区块链相关的技术文档及资料,本文为Solidity文档翻译的第六部分《合约的元数据》,特发布出来邀请solidity爱好者、开发者做公开的审校,您可以添加微信baobaotalk_com,验证输入“solidity”,然后将您的意见和建议发送给我们,也可以在文末“留言”区留言,有效的建议我们会采纳及合并进下一版本,同时将送一份小礼物给您以示感谢。

Solidity编译器自动生成JSON文件,即合约的元数据,其中包含了当前合约的相关信息。 它可以用于查询编译器版本,所使用的源代码,应用二进制接口-Application Binary Interface(ABI) 和 以太坊标准说明格式-Ethereum Nature Specification Format(natspec) 文档,以便更安全地与合约进行交互并验证其源代码。

编译器会将元数据文件的 Swarm 哈希值附加到每个合约的字节码末尾(详情请参阅下文), 以便你可以以认证的方式获取该文件,而不必求助于中心化的数据提供者。

当然,你必须将元数据文件发布到 Swarm (或其他服务),以便其他人可以访问它。 该文件可以通过使用 solc –metadata 来生成,并被命名为 ContractName_meta.json 。 它将包含源代码的在 Swarm 上的引用,因此你必须上传所有源文件和元数据文件。

元数据文件具有以下格式。 下面的例子将以人类可读的方式呈现。 正确格式化的元数据应正确使用引号,将空白减少到最小,并对所有对象的键值进行排序以得到唯一的格式。 代码注释当然也是不允许的,这里仅用于解释目的。

{
 // 必选:元数据格式的版本
 version: "1",
 // 必选:源代码的编程语言,一般会选择规范的“子版本”
 language: "Solidity",
 // 必选:编译器的细节,内容视语言而定。
 compiler: {
   // 对 Solidity 来说是必须的:编译器的版本
   version: "0.4.6+commit.2dabbdf0.Emscripten.clang",
   // 可选: 生成此输出的编译器二进制文件的哈希值
   keccak256: "0x123..."
 },
 // 必选:编译的源文件/源单位,键值为文件名
 sources:
 {
   "myFile.sol": {
     // 必选:源文件的 keccak256 哈希值
     "keccak256": "0x123...",
     // 必选(除非定义了“content”,详见下文):
     // 已排序的源文件的URL,URL的协议可以是任意的,但建议使用 Swarm 的URL
     "urls": [ "bzzr://56ab..." ]
   },
   "mortal": {
     // 必选:源文件的 keccak256 哈希值
     "keccak256": "0x234...",
     // 必选(除非定义了“urls”): 源文件的字面内容
     "content": "contract mortal is owned { function kill() { if (msg.sender == owner) selfdestruct(owner); } }"
   }
 },
 // 必选:编译器的设置
 settings:
 {
   // 对 Solidity 来说是必须的: 已排序的重定向列表
   remappings: [ ":g/dir" ],
   // 可选: 优化器的设置( enabled 默认设为 false )
   optimizer: {
     enabled: true,
     runs: 500
   },
   // 对 Solidity 来说是必须的:用以生成该元数据的文件名和合约名或库名
   compilationTarget: {
     "myFile.sol": "MyContract"
   },
   // 对 Solidity 来说是必须的:所使用的库的地址
   libraries: {
     "MyLib": "0x123123..."
   }
 },
 // 必选:合约的生成信息
 output:
 {
   // 必选:合约的 ABI 定义
   abi: [ ... ],
   // 必选:合约的 NatSpec 用户文档
   userdoc: [ ... ],
   // 必选:合约的 NatSpec 开发者文档
   devdoc: [ ... ],
 }
}

image

2

元数据哈希字节码的编码

由于在将来我们可能会支持其他方式来获取元数据文件, 类似 {“bzzr0”:} 的键值对,将会以 CBOR 编码来存储。 由于这种编码的起始位不容易找到,因此添加两个字节来表述其长度,以大端方式编码。 所以,当前版本的Solidity编译器,将以下内容添加到部署的字节码的末尾:

0xa1 0x65 'b' 'z' 'z' 'r' '0' 0x58 0x20 <32 **bytes**swarm hash> 0x00 0x29

因此,为了获取数据,可以检查部署的字节码的末尾以匹配该模式,并使用 Swarm 哈希来获取元数据文件。

3

自动化接口生成和以太坊标准说明格式 的使用方法

元数据以下列方式被使用:想要与合约交互的组件(例如,Mist)读取合约的字节码, 从中获取元数据文件的 Swarm 哈希,然后从 Swarm 获取该文件。该文件被解码为上面的 JSON 结构。

然后该组件可以使用ABI自动生成合约的基本用户接口。

此外,Mist可以使用 userdoc 在用户与合约进行交互时向用户显示确认消息。

有关 以太坊标准说明格式-Ethereum Nature Specification Format(natspec) 的其他信息可以在 这里 (https://github.com/ethereum/wiki/wiki/Ethereum-Natural-Specification-Format)找到。

4

源代码验证的使用方法

为了验证编译,可以通过元数据文件中的链接从 Swarm 中获取源代码。 获取到的源码,会根据元数据中指定的设置,被正确版本的编译器(应该为“官方”编译器之一)所处理。 处理得到的字节码会与创建交易的数据或者 CREATE 操作码使用的数据进行比较。 这会自动验证元数据,因为它的哈希值是字节码的一部分。 而额外的数据,则是与基于接口进行编码并展示给用户的构造输入数据相符的。

延伸阅读:智能合约-Solidity官方文档(1)

安装Solidity编译器-Solidity官方文档(2)

根据例子学习Solidity-Solidity官方文档(3)

深入理解Solidity之源文件及合约结构——Solidity中文文档(4)

安全考量——Solidity中文文档(5)

本文内容来源于HiBlock区块链社区翻译小组,感谢全体译者的辛苦工作。

注:本文为solidity翻译的第六部分《合约的元数据》,特发布出来邀请solidity爱好者、开发者做公开的审校,您可以添加微信baobaotalk_com,验证输入“solidity”,然后将您的意见和建议发送给我们,也可在文末“留言”区留言,或通过原文链接访问我们的Github。有效的建议我们会收纳并及时改进,同时将送一份小礼物给您以示感谢。

以下是我们的社区介绍,欢迎各种合作、交流、学习:)

image

STM32-printf重定向串口输出 声明 本文内容转载至https://www.mculover666.cn/posts/2251182441/ 1.printf与fputc printf 定义在 <stdio.h> 头文件中,如下: int printf(const char *format, ...); printf 函数根据 format 字符串给出的格式打印输出到 stdout(标准输出)中,当然,printf 函数是不会一个字符一个字符去输出,它会调用更底层的 I/O 函数:fputc去逐个字符打印。 fputc 也定 阅读详情

相关推荐

SBM与超效率SBM模型实战:从原始面板数据到MATLAB高效实现

本文详细介绍了SBM模型与超效率SBM模型的核心原理,并提供了从原始面板数据预处理到MATLAB高效实现的完整实战指南。通过具体代码解析,帮助研究者掌握如何利用MATLAB进行数据标准化、模型构建、效率求解及结果可视化,从而精准评估决策单元的相对效率,尤其适用于在高效单元中进一步精细排名的场景。

weixin_29100399的博客 481

快速入门solidity

开发语言 solidity高级语言,专门用于开发智能合约,使用solc进行编译。 docs:深入理解Solidity — Solidity develop 文档 官方在线编译器:Remix - Ethereum IDE solidity-GitHub:GitHub - ethereum/solidity: Solidity, the Smart Contract Programming Language 本地编译需要在本地安装solc,然后使用命令进行编译 bin 和 abi即可。so..

胖子ღ牛逼 8885

从Maya到Unity:3D模型导入全流程避坑指南(含FBX导出设置)

本文详细解析了从Maya导出3D模型至Unity的全流程,重点剖析了FBX格式作为跨软件协作“中间人”的优劣与核心设置。指南涵盖了Maya端模型清理、FBX导出关键配置(如嵌入媒体、轴转换),以及Unity端的模型、材质、动画导入优化与常见问题(如材质丢失、UV法线错误、骨骼动画错乱)的实战解决方案,旨在帮助3D美术师与技术美术建立稳定、高效的工作流。

lg888的博客 795

044.Solidity入门——31哈希运算

Solidity——哈希运算

qq_35369459的博客 650

金蝶云星空核心数据表解析与高效关联查询指南

本文深入解析金蝶云星空核心数据表结构,提供高效关联查询的实战指南。文章详细介绍了基础资料、业务单据和财务模块的关键表及其关联逻辑,重点阐述了如何利用关联表(_LK表)进行跨单据溯源,并分享了编写高性能SQL的实用技巧与避坑建议,帮助开发者、实施顾问和数据分析师快速掌握数据查询方法,提升工作效率。

weixin_29254673的博客 527

【gridsample】地平线征程6芯片中gridsample算子的优化与部署实践

本文详细介绍了地平线征程6芯片中gridsample算子的优化与部署实践,重点探讨了PTQ和QAT量化方案在BEV感知任务中的应用。通过双线性插值优化、内存布局调整和混合精度配置等关键技术,显著提升了算子在自动驾驶场景下的性能和精度,为开发者提供了实用的部署指南和调优建议。

zero1的博客 1021

Solidity 官方文档中文版(一)

中文翻译文档:http://www.tryblockchain.org/Solidity-%E8%AF%AD%E8%A8%80%E4%BB%8B%E7%BB%8D.html英文官方文档:http://solidity.readthedocs.io/en/develop/Solidity是一种智能合约高级语言,运行在Ethereum虚拟机(EVM)之上。Solidity与其它语言相关的特点?它的语法...

xiatiancc的专栏 1万+

MagicDraw-用例图

MagicDraw-用例图

木头征的博客 3135

Optimizer 参数设置,gas如何变化?

-via-ir 是 Solidity 编译器的另一个选项,用于指定编译器是否应该使用中间代码(IR)来编译 Solidity 代码。使用 IR 可以提高编译器的效率,并且可以生成更高效的代码。如果指定了 --via-ir 选项,则编译器将使用 IR 来编译 Solidity 代码。optimizer-runs 200 是 Solidity 编译器的一个选项,用于指定优化器的运行次数。优化器是 Solidity 编译器的一部分,它可以对编译后的代码进行优化,以提高代码的执行效率。

sc_cs2011的博客 460

时序异常检测汇总

时序异常检测

Mark_Australia的博客 1万+

10、硬件工程师笔试面试——继电器(2025版本)

在设计电路时,应综合考虑SSR的优势和局限性,确保选择合适的型号,并采取适当的设计措施来优化性能和可靠性。继电器的主要功能是利用较小的电流或电压来控制较大电流或电压的电路,实现信号的放大和隔离。在处理继电器故障时,应综合考虑电源、线圈、触点和负载等因素,及时进行故障诊断和处理,以确保电路系统的稳定性和安全性。由于汽车电子系统的复杂性,继电器的设计和选择必须考虑到系统的特定要求,包括电流容量、电压等级、环境条件(如温度、湿度、振动)以及所需的保护和隔离功能。确定线圈的工作电压或电流,以及吸合电压或电流。

XU157303764的博客 3734

Solidity官方文档:合约的元数据

最近加入了Solidity的官方文档的中文翻译小组,以下是我们翻译的文章,可到我们的官网查看最新的更新:https://solidity-cn.readthedocs.io/zh/develop合约的元数据Solidity编译器自动生成JSON文件,即合约的元数据,其中包含了当前合约的相关信息。 它可以用于查询编译器版本,所使用的源代码,应用二进制接口Application Binary Inte

点火三周的专栏 1413

基于OpenCV和Dlib的头部姿态估计详细教程

本文详细介绍了基于OpenCV和Dlib的头部姿态估计方法。通过分析2D人脸特征点与3D头部模型的对应关系,利用PnP(Perspective-n-Point)算法求解头部在三维空间中的姿态。文章首先阐述了坐标系统转换原理,包括世界坐标系、相机坐标系和图像坐标系的转换关系,随后深入讲解了PnP问题的数学表述及求解步骤,并提供了使用Dlib检测68个面部特征点的代码示例。最后介绍了3D通用头部模型的构建方法,包括6点和14点模型的选择,为计算机视觉中的头部姿态估计提供了完整的技术实现方案。

FJN110的博客 338

Solidity学习教程

为了方便广大区块链技术学习者和爱好者研究智能合约与Solidity语言,博主开始整理和翻译Solidity官方文档,并将本文作为索引页方便研究者针对性学习。

黄嘉成的博客 5481

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

11M 以太坊 ethereum OpenZeppelin : 开发智能合约

区块链 blockchain 以太坊 ethereum OpenZeppelin

wx468116118的博客 1510

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

使用编译器——Solidity中文文档(8)

写在前面:HiBlock区块链社区成立了翻译小组,翻译区块链相关的技术文档及资料,本文为Solidity文档翻译的第八部分《使用编译器》,特发布出来邀请solidity爱好者、开发者做公开的审校,您可以添加微信baobaotalk_com,验证输入“solidity”,然后将您的意见和建议发送给我们,也可以在文末“留言”区留言,有效的建议我们会采纳及合并进下一版本,同时将送一份小礼物给您以示感谢...

weixin_34130269的博客 307

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

开源项目:OpenZeppelin Foundry Upgrades 指南

开源项目:OpenZeppelin Foundry Upgrades 指南 1. 项目目录结构及介绍 OpenZeppelin 的 Foundry Upgrades 库是为了方便部署和管理可升级智能合约而设计的。以下是该项目的基本目录结构及其简要说明: .gitignore: 控制哪些文件或目录不应被Git版本控制。 .gitmodules: 若项目中嵌套了其他Git仓库作为子模块,则该文件定义...

gitblog_00731的博客 1232

区块链创新:用LongCat-Image-Edit生成NFT宠物艺术品

本文介绍了如何在星图GPU平台上自动化部署LongCat-Image-Edit 动物百变秀镜像,高效生成具备生物特征唯一性的NFT宠物艺术品。用户上传宠物照片并输入中文指令(如“柴犬穿宇航服”),即可一键完成图像编辑、特征锚定与ERC-721标准NFT封装,适用于数字藏品创作、宠物IP孵化及公益领养等典型场景。

weixin_36173034的博客 386

链上可信公示系统设计:从Gas验证到Merkle存证

在Web3社区运营中,'可信公示'已超越传统榜单展示,成为基于链上原生经济指标(如Gas消耗)构建信任基础设施的核心能力。其原理在于利用不可篡改的链上数据(交易哈希、时间戳、gasUsed)、可复验的加权算法(含时间衰减与行为质量系数)及密码学存证(Merkle Tree+keccak256),实现用户自主验证。技术价值在于以最小信任假设替代中心化背书,显著降低机器人灌水与人工干预风险;典型应用场景包括DAO激励排名、空投资格核验、社区贡献确权等。本文聚焦‘百虾大战’实践,深度解析如何通过账单结构化、前端零

weixin_34320159的博客 530

【Solidity】8. 杂项 - 深入理解Solidity

索引 【Solidity】1.一个Solidity源文件的布局 【Solidity】2.合约的结构体 【Solidity】3.类型 【Solidity】4.单位和全局可变量 【Solidity】5.表达式和控制结构 【Solidity】6. 合约 【Solidity】7. 部件 【Solidity】8. 杂项 ...

weixin_33762130的博客 558

Solidity语言学习笔记————44、合约的元数据

合约的元数据Solidity编译器自动生成JSON文件,即合约的元数据,其中包含了当前合约的相关信息。 它可以用于查询编译器版本,所使用的源代码,应用二进制接口Application Binary Interface(ABI) 和 以太坊标准说明格式Ethereum Nature Specification Format(natspec) 文档,以便更安全地与合约进行交互并验证其源代码。编译器会将...

Fly_鹏程万里 611

智能合约-Solidity官方文档(1)

写在前面:HiBlock区块链社区成立了翻译小组(以太坊中文社区),翻译区块链相关的技术文档及资料,本文为solidity官方文档翻译的第一部分《智能合约概述》,特发布出来邀请solidity爱好者、开发者做公开的审校,您可以添加微信baobaotalk_com,验证输入“solidity”,然后将您的意见和建议发送给我们,也可以在文末“留言”区留言,有效的建议我们会采纳及合并进下一版本,同时将...

weixin_34013044的博客 598

【Solidity】合约的元数据

合约的元数据 Solidity编译器自动生成JSON文件,即合约的元数据,其中包含了当前合约的相关信息。 它可以用于查询编译器版本,所使用的源代码,应用二进制接口Application Binary Interface(ABI) 和 以太坊标准说明格式Ethereum Nature Specification Format(natspec) 文档,以便更安全地与合约进行交互并验证其源代码。 编...

黄嘉成的博客 1039

死磕solidity之如何有效的节省gas.md

为什么要强调优化gas的重要性 DAPP中收取的费用取决于功能逻辑的复杂程度,越复杂消耗的计算资源越多。并且需要用户承担一部分gas,所以solidity 的优化显得非常的重要。同时注重优化gas的合约开发人员写出来的合约代码更安全,质量更高。 1. 封装结构 以uint 为例,如果我们的程序中包含多个类似的变量,可以将其封装在一起,因为不管uint8 ,uint32 ,uint16,solidity都会为其保留256位。即使你使用uint8也不会节省gas. 2. 最小化读写链上数据 首先明确一点在读写

mindcarver 2377

深入了解以太坊虚拟机第3部分——动态数据类型的表示方法

本文由币乎社区(bihu.com)内容支持计划赞助。Solidity提供了在其他编程语言常见的数据类型。除了简单的值类型比如数字和结构体,还有一些其他数据类型,随着数据的增加可以进行动态扩展的动态类型。动态类型的3大类:映射(Mappings):mapping(bytes32 =&gt; uint256), mapping(address =&gt; string)等等数组(Arrays):[]u...

omnispace的博客 938
上一篇: 一起学习EOS|EOS的命令行程序和工具超详细实战演习(附代码)
下一篇: 智慧合约:智能合约安全问题的AI解决方案
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值