Qstamp / 开发者
使用 Qstamp 进行开发

安装 SDK、存证、验证。

Qstamp SDK 依据 Apache License 2.0 或 MIT 许可证开源。它运行于 Node 20 或更高版本,仅依赖 QCore,即 Quantova 用于后量子签名的客户端库。

GitHub开源

Qstamp SDK 源代码

完整源代码、已公开的构造及发布历史,开放供独立安全审查。

git clone https://github.com/Quantova/QStamp.git
npmv0.1.4

@quantovainc/qstamp

适用于 Node 20 或更高版本的命令行工具与库,仅有一个依赖 QCore,用于后量子签名。

npm install @quantovainc/qstamp
Quanta示例

合约模板

开放、签发方及理事会 Quanta 智能合约。在生产部署前须经独立第三方审计。

git clone https://github.com/Quantova/Qstamp-Quanta-Smart-contract-example-.git
测试网络Q-test-net-1

端点与测试单位

Quantova 测试网络的公共端点。可领取免费 TQTOV 测试单位以支付锚定费用。

https://rpc-testnet.quantova.org
terminalcommand line
npm install @quantovainc/qstamp fingerprint files npx qstamp hash report.pdf ledger.csv stamp them in one transaction npx qstamp stamp report.pdf ledger.csv \ --seed-file ./signer.key --index 0 --kind financial_record verify a receipt against its file npx qstamp verify report.pdf.qstamp.json --file report.pdf recover an interrupted stamp npx qstamp complete qstamp-pending-1760000000000-a1b2c3d4.json
app.jsprogrammatic
const qstamp = require('@quantovainc/qstamp'); const digest = await qstamp.digestFile('report.pdf'); const [receipt] = await qstamp.stamp({ seed, index: 0, kind: 'financial_record', records: [{ digest }], }); const result = await qstamp.verify(receipt, { file: 'report.pdf', }); result.status · result.checks · result.endpoints
API

函数与保证。

函数用途行为
stamp(options)在一笔交易中锚定最多 1048576 条记录,并为每条记录返回一份凭证种子仅以 32 个可擦除字节的形式接受,并在签名后擦除。签名前强制执行费用上限。
verify(receipt, options)对照记录内容及网络验证凭证未提供内容时绝不返回有效。无法查询网络时返回无法确定。
complete(pending)在中断后完成已提交批次的凭证拒绝与已锚定承诺值不符的待处理批次。
digestFile, digestBytes使用 256 位 SHA3 或 SHA2 计算内容指纹采用流式处理,因此支持任意大小的文件。
leafHash, tree, rootFromPath, commitment供独立验证方使用的原语精确实现已公开的构造。
validateReceipt严格的模式校验精确的键集、规范编码及有界取值。
网络

测试网络参数。

链名称
Q-test-net-1
创世哈希
ca91e093bb8de33e90db52d7c89876597d14760703793ea7211929e73e613062
Qstamp 合约
Q1D6TZFRL203P3DFAFVUPZUHGUCM4EWGH6063XNS42VA5235RNQWXS7FXEWX
端点
https://rpc-testnet.quantova.org
每次锚定费用
0.005 TQTOV,与批次大小无关

测试网络凭证不具有任何证据效力。Quantova 主网络上线后,生产用途将在该网络上进行。

独立验证

不使用 SDK 进行验证。

使用凭证中指明的算法重新计算记录摘要。

由 0x00、QSTAMP/LEAF/V1、算法标识符、摘要及盐值计算叶节点。

按照 RFC 9162 第 2.1.3.2 节重新计算根。

由 0x02、QSTAMP/ROOT/V1、创世哈希、合约、签名者、记录类型、批次大小及根计算承诺值。

确认交易已具有最终性、由所述地址签名并携带该承诺值。

确认官方合约已发出事件 5a110849,且其中包含签名者、承诺值及记录类型。

确认区块标识符与区块时间。