【比特币】BIP-0021 详细说明

简介:

BIP-0021 详细说明

  BIP: 21
  Layer: Applications
  Title: URI方案
  Author: Nils Schneider <nils.schneider@gmail.com>
          Matt Corallo <bip21@bluematt.me>
  Comments-Summary: No comments yet.
  Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0021
  Status: Final
  Type: Standards Track
  Created: 2012-01-29

这个BIP是Luke Dashjr早期BIP 0020的一个修改。 BIP 0020基于Nils Schneider早期的文件。 BIP 0020中的替代支付金额已被删除。

摘要

这个BIP提出了一个用于支付比特币的URI方案。

动机

这个URI方案的目的是让用户只需点击网页上的链接或扫描QR码即可轻松付款。

规范

处理的一般规则(重要!)

比特币客户端不得在未获得用户授权的情况下对URI进行操作。 他们应该要求用户手动批准每个付款,但在某些情况下,他们可能会允许用户自动做出这个决定。

操作系统集成

图形比特币客户端应该注册自己作为默认的“比特币:”URI方案的处理程序,如果没有其他处理程序已经注册。 如果已经有一个注册处理程序,它们可能会提示用户在第一次运行客户程序时更改一次。

一般格式

比特币URI遵循RFC 3986中规定的URI的通用格式。路径组件由比特币地址组成,查询组件提供额外的支付选项。

查询组件的元素可能包含有效范围之外的字符。 这些必须首先根据UTF-8进行编码,然后按照RFC 3986中所述,相应的UTF-8序列的每个八位字节必须进行百分比编码。

ABNF语法

 bitcoinurn     = "bitcoin:" bitcoinaddress [ "?" bitcoinparams ]
 bitcoinaddress = *base58
 bitcoinparams  = bitcoinparam [ "&" bitcoinparams ]
 bitcoinparam   = [ amountparam / labelparam / messageparam / otherparam / reqparam ]
 amountparam    = "amount=" *digit [ "." *digit ]
 labelparam     = "label=" *qchar
 messageparam   = "message=" *qchar
 otherparam     = qchar *qchar [ "=" *qchar ]
 reqparam       = "req-" qchar *qchar [ "=" *qchar ]

这里,“qchar”对应于RFC 3986 URI查询组件的有效字符,不包括此BIP作为分隔符的“=”和“&”字符。

计划组件(“比特币:”)不区分大小写,实现必须接受大写和小写字母的任意组合。 其余的URI区分大小写,包括查询参数键。

查询键

  • 标签:该地址的标签(例如,接收者的姓名)
  • 地址:比特币地址
  • 消息:向用户描述交易的消息(请参阅下面的示例)
  • 大小:基础比特币单位数量(见下文)
  • (其他):可选,用于将来的扩展

转账金额/大小

如果提供金额,则必须用十进制BTC指定。 所有金额必须不包含逗号,并使用句点(。)作为分隔符来分隔整数和小数部分。即 金额= 50.00或金额= 50被视为50 BTC,金额= 50,000.00无效。

比特币客户端可以以任何形式来显示金额,而不是用来欺骗用户的。 他们应该选择一种最容易混淆的格式,只有在最合理的情况下才能提供所要求的金额。 例如,只要大多数用户以BTC为单位工作,即使mBTC或TBC会对数量进行更合理的解释,也应始终在BTC中显示值。

原理

付款标识符,而不是个人标识符

目前的最佳做法是每个交易都应该使用一个独特的地址。 因此,URI方案不应该代表个人信息的交换,而应该是一次性支付。

可访问性(URI方案名称)

如果外部的人碰巧看到这样的URI,那么URI方案名称就已经给出了描述。 然后快速搜索,以帮助他们找到支付所需的资源。 其他提出的名字听起来更加神秘; 有人因为好奇而谷歌浏览器的机会要小得多。 另外,很可能,他会发现大部分技术规格 - 而不是比特币的最佳介绍。

向前兼容

被认为需要前缀的变量被认为是必需的。 如果一个客户没有实现任何以req-为前缀的变量,它必须考虑整个URI是无效的。 任何其他没有实现的变量,但是没有以req-开头的前缀,都可以被安全的忽略。

向后兼容

在写这个BIP时,有几个客户已经实现了一个类似于这个的比特币:URI方案,但是通常没有额外的“req-”前缀要求。 因此,为了让客户开发人员能够发布新的版本,建议在完成本BIP的6个月的宽限期之后,以任务关键的方式使用前缀的附加变量,以及 老客户升级。

附录

简单的语法

本部分是非规范性的,并不涵盖所有可能的语法。 请参阅上面的BNF语法的规范语法。

[foo]表示可选,是占位符

 bitcoin:<address>[?amount=<amount>][?label=<label>][?message=<message>]

例子

只有地址:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W

带着名字:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?label=Luke-Jr

请求20.30 BTC到“Luke-Jr”:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?amount=20.3&label=Luke-Jr

请求50 BTC的消息:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?amount=50&label=Luke-Jr&message=Donation%20for%20project%20xyz

一些未来版本的变量是(当前)不了解和要求,因此是无效的:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?req-somethingyoudontunderstand=50&req-somethingelseyoudontget=999

一些未来版本的变量,(当前)不明白,但不是必需的,因此是有效的:

 bitcoin:175tWpb8K1S7NmH4Zx6rewF9WQrcZv245W?somethingyoudontunderstand=50&somethingelseyoudontget=999

字符必须是正确的URI编码。

参考实现

比特币客户端

  • Bitcoin-Qt支持旧版本的比特币URI(即没有req-前缀),与Windows和KDE集成为70f55355e29c8e45b607e782c5d76609d23cc858。

参考资料

目录
相关文章
|
JavaScript 定位技术 API
百度离线地图API v3.0开发解决方案
百度离线地图API v3.0开发解决方案
971 0
|
编解码
Blender视图渲染知识
Blender视图渲染知识
Blender视图渲染知识
|
3月前
|
人工智能 分布式计算 大数据
大数据≠大样本:基于Spark的特征降维实战(提升10倍训练效率)
本文探讨了大数据场景下降维的核心问题与解决方案,重点分析了“维度灾难”对模型性能的影响及特征冗余的陷阱。通过数学证明与实际案例,揭示高维空间中样本稀疏性问题,并提出基于Spark的分布式降维技术选型与优化策略。文章详细展示了PCA在亿级用户画像中的应用,包括数据准备、核心实现与效果评估,同时深入探讨了协方差矩阵计算与特征值分解的并行优化方法。此外,还介绍了动态维度调整、非线性特征处理及降维与其他AI技术的协同效应,为生产环境提供了最佳实践指南。最终总结出降维的本质与工程实践原则,展望未来发展方向。
201 0
|
2月前
|
监控 安全 调度
如何开发ERP系统中的计划管理板块(附架构图+流程图+代码参考)
本文介绍了ERP系统中计划管理模块的重要性及开发方法,涵盖生产计划、物料需求、调度优化等功能,并提供代码示例与落地建议,帮助企业提升生产效率、优化资源配置。
|
存储 数据可视化 安全
一张图的七十二变——阿里云OSS图片处理实践
      小张是某视频网站的新入职的UED,日常工作就是创作各式各样的海报banner。踌躇满志的小张,上了三天班就蔫了。因为他在完成一张图的创作后,还需要考虑:• 同一张图会以不同的形式应用于网站各处:有时候需裁剪成不同形状,有时需要加水印,有时需转换格式....• 为了风格统一,不同的图需要保持样式统一:不同图片排列组成成一组,每组图片风格(
2705 0
|
关系型数据库 MySQL
mysql配置文件的使用
mysql配置文件的使用
327 1
mysql配置文件的使用
|
6月前
|
JSON 前端开发 测试技术
2025年 5 个好用的 Socket.IO 调试工具推荐
在实时通信应用开发中,Socket.IO 是一个非常流行的框架,但调试其应用可能较为棘手。为此,推荐5个好用的 Socket.IO 调试工具:Apifox、WebSocket King、Socket.IO Test Client、Socket.IO Inspector 和 Postman。其中,Apifox 集成设计、调试、测试和文档生成于一体,支持多种版本的 Socket.IO 客户端,提供强大的接口管理和团队协作功能;
|
机器学习/深度学习 人工智能 芯片
AI芯片设计与优化:算力提升、能耗降低与硬件加速器的发展趋势
AI芯片设计与优化:算力提升、能耗降低与硬件加速器的发展趋势
1628 0
有哪些元宇宙的已知成功案例可以借鉴
**元宇宙成功案例摘要:** - 韩国国民银行开拓元宇宙金融,设立虚拟分行,探索数字资产服务。 - Meta&#39;s &quot;Horizon Worlds&quot;月活用户达30万,显示元宇宙在社交娱乐的潜力。 - Second Life作为早期在线世界,提供沉浸式体验,预示元宇宙可能性。 - 工商银行河北雄安分行创建虚拟分行,推动金融服务数字化。 - 首钢一高炉·SoReal乐园结合XR技术,展现元宇宙在文旅的创新应用。 - 中兴、天下秀、网易等企业通过元宇宙技术赋能社交、工业和服务平台。 这些案例揭示元宇宙在多领域广泛应用及广阔前景。
有哪些元宇宙的已知成功案例可以借鉴
|
安全 Java 编译器
JDK11 介绍讲解,语法改进,API增强
JDK 11进一步完善了JDK 9引入的模块化系统。模块化系统允许开发人员将代码和依赖项组织成模块,以提高可维护性、安全性和性能。开发人员可以使用`module`关键字定义模块,并使用`requires`和`exports`语句来声明模块之间的依赖关系和对外暴露的API。模块化系统还提供了更细粒度的访问控制,可以限制对模块中的内部API的访问。
415 0