Skip to content

SUIBE-Blockchain/WeDPR-Lab-Core-Web-Version

Repository files navigation

WeDPR Lab Core Web Version

WeDPR 的 Web 版本,基于 Rocket 框架。

进度:[|||______ 10.0% ]

接口文档

1 生成credit

url: /vcl/make_credit

method: post

params: {value: 33}

return:

{ "result": { "credit": "Ln+bmZ50zCF5E2RfNKx0sHlFxiov1SMcQDqJfNDZv24=", "owner_secret": { "credit_value": 33, "secret_blinding": "9GYl7egoXsQ5p4qkYJSqwQl0ggVs+4rEAiVmXTwvMgk=" } }, "status": "ok" }

2 非负证明

url: /vcl/prove_range

method: post

params:

{ "credit_value": 33, "secret_blinding": "9GYl7egoXsQ5p4qkYJSqwQl0ggVs+4rEAiVmXTwvMgk="}

return:

{ "result": "MiU07ex8d29HRGM7UneuM8PuWRytgnQ3EsrILmarOAfgYKCN6lBeQYBEUe1Q+YXaoIMeXmW0uNSpzEndAsIVTS6iip2zPOzDRsKdXoFDAssO47rINcoPpofw6Nyy7vxOiE3F5iKzdhYiu8iTY+S/ZspALNuawnls3uG0VPouCQ/zjCnySH1GjstCi/JfpDdRghDchEz5e0ukKX2LhuueA10Vn2577H2bXIQeLTjvL4KbClOOMpA6seDCSScls34NdULbByQnmC2BHGhs/zZdF1ay67PWLGkVdjx9xLyiYAn8us9zsHs12nJEI9ntnYdPSxhPVM+szDICcPZr8OQCSGYvYRQQl28h1Og2HHc3ElMRJJoGAmX67zujHT7oecpZth2kTjV48LF/BhpDspC8WcZu4NqAKxYY9ww8dXcjGEsONCEtMwU28dTUaTAskWF7LdsUoE3ZGXYPlZjx5X7kX5SVT+UvZuTYv7Co6+ix9U4ZXXM2cecIvirUCLvvTh1iOpbUjiH1SxQm2zaZ1jKp91EUosuwZAD8cQUWiw8/JGn4TkMrqDqNdBUh9eTGy6Vg2rL5GM/09FCzh6q/Ukl1e+ynHYJPKuVEFvAQOoxX1ZyM0H94lyZAF29kX4QvXNwQ4vmyPGanFW1zcd0oiqbycCodETOyFhlSYeqp7yzbaAMWvOnBZ+j7ox4CYp53o8Fp8nYx9PrH5CVyIx4Kqz3pHwcN6kTsMDhHificj6krMfIgi6D8RGKX/820JzjenAwJ6NRhdh0JtMBrJBauVu0Ankhkv6GWgA1glWXiwAowbAY=", "status": "ok" }

url: /vcl/verify_range

method: post

params:

{"credit": "aBHKbyCIImB2SwzRS6Tu7oEVQ5hVEg7RAzwlMyG3kjs=", "proof": "JJEBVu2fduiHFkVuv18/ZHDPvlf+rw17HAo0c8Hr9g98LXZygLZvVbrlZTf1mjKj3Wvqv0XIiyzZ3wU7fO/NF0RF/aDnl0XPFJABWsDceZXrOiTFsgDnYCFPCNPBugMuyimFf6fDnErUhj4/HaK/YcN/yHTV+5BD/o0szMY/0XD8CXda5s2Hgs0tp+YxPrBZlC5GOFubRxVOT+cDtwNLAZC+lScUcoJ1U98qVEDZu54bIeOU/H54uwxjgB5WHUgGyBKZmLehT6m+qTYdSRErEi1cFX60hhutnzGARTaVLAY0OmuIoC/Ttq5dxmNPRFly1d/tZp/holbqoUNGzv76Iyo2hqLTdofTISDVir4i88I8H+sdRFnlJANeUqvw430lbhJCFECPUkZkVqHr2h4ooJoaMZOb688wamge45IVIAFM+lxQUxkeididDvOLXVzFwxsv8gUDT76XxjkOPg6EcNJy4iY2pCnFlqWW3NiRELcJKPZlWv3a5iAOcJwFgBNATkIVzSKfYOaBXQtd3JXAguQxzyj7V52o9j7U0ZfoCG7IvXd7IMKAJehcpKmMR8aE0AGyCzk7ZIrEXU8sNrI3FTjByZSYFYM0IJi9Ms9LDqiFiNTwZ6I+9Uxn+oLvcrNUiJtbcRX6q/mJl+1UXpAlg3fIBie0Wjo/p82gpMQHXiNGtLBS/1VYBN4ByyY2iFS9AX8aDwQAzLMY2D1hCsw0Lp6J4GXBgEOzNfysfEzPEK45wseh6FpJuHD+ByhWvycHbZwToTghL5FxFaOg1xIkhRXM6I64gwymzhh0fK0JFQQ="}

return:

{ "result": true, "status": "ok" }

项目背景

WeDPR

WeDPR是一系列即时可用场景式隐私保护高效解决方案套件和服务(参见WeDPR白皮书),由微众银行区块链团队自主研发。方案致力于解决业务数字化中隐私不“隐”、共享协作不可控等隐私保护风险痛点,消除隐私主体的隐私顾虑和业务创新的合规壁垒,助力基于隐私数据的核心价值互联和新兴商业探索,营造公平、对等、共赢的多方数据协作环境,达成数据价值跨主体融合和数据治理的可控平衡。

WeDPR具备以下特色和优势:

  • 场景式解决方案:已基于具有共性的场景需求,提炼出公开可验证密文账本、多方密文决策、多方密文排名、多方密文计算、多方安全随机数生成、选择性密文披露等高效技术方案框架模板,可应用于支付、供应链金融、跨境金融、投票、选举、榜单、竞拍、招标、摇号、抽检、审计、隐私数据聚合分析、数字化身份、数字化资质凭证、智慧城市、智慧医疗等广泛业务场景。
  • 即时可用:高性能、高易用、跨平台跨语言实现、不依赖中心化可信服务、不依赖可信硬件、支持国密算法标准、隐私效果公开可验证,5分钟一键构建示例应用。
  • 透明可控:隐私控制回归属主,杜绝数据未授权使用,在『数据可用而不可见』的基础上,进一步实现数据使用全程可监管、可追溯、可验证。

WeDPR全面拥抱开放,将陆续开源一系列核心算法组件,进一步提升系统安全性的透明度,提供更透明、更可信的隐私保护效果。WeDPR-Lab就是这一系列开源的核心算法组件的集合。

首组开源的核心算法组件将围绕公开可验证密文账本(Verifiable Confidential Ledger, VCL)解决方案进行,在数字化资产流通场景(如支付、清算)、涉及多方之间共享账本信息的场景(如供应链金融、跨境金融服务)等均可广泛应用。

本次开源(v1.0.0版本)包含的主要内容如下:

  • 公开可验证密文账本的一个交互式样例,实现密文金额发行、密文金额四则运算关系验证、密文金额范围验证等功能;
  • Rust SDK,封装底层算法,提供易用、易扩展、跨语言的编程接口;
  • 三类零知识证明算法的高效稳定实现,包括密文加和关系证明、密文乘积关系证明、密文范围证明;
  • 其他基础工具代码。

我们期望能够通过代码开源的方式:

  • 有效降低使用隐私保护算法组件的技术门槛;
  • 减少业务系统集成隐私保护特性的开发成本;
  • 助力全行业伙伴安全、合规地开展数据业务。

欢迎社区伙伴参与WeDPR-Lab的共建,一起为可信开放数字新生态的构建打造坚实、可靠的技术底座。

安装

安装Rust环境

  1. 安装nightly版本的Rust开发环境,可参考示例安装指引
  2. 若有疑问,可进一步参考Rust官方文档

下载WeDPR-Lab源代码

使用git命令行工具,执行如下命令。

git clone https://github.com/WeBankBlockchain/WeDPR-Lab-Core.git

运行Demo

运行公开可验证密文账本Demo

cd WeDPR-Lab-Core/solution/verifiable_confidential_ledger
cargo run

在VCL解决方案子目录(即verifiable_confidential_ledger目录)中,运行cargo run之后,按照demo指引,选择演示的语言,按步骤输入即可进行体验。

接口文档

生成并查看Rust SDK接口文档

在本项目的根目录(即WeDPR-Lab-Core目录)中,运行如下命令。

cargo doc

以上命令将根据代码中的注释,在target/doc子目录中,生成的SDK接口文档。

进入target/doc文档目录后,会看到所有SDK相关的包名(包含WeDPR-Lab和其他依赖包),进入以下任意一个包名的目录,用网页浏览器打开其中的index.html文件,便可查看WeDPR-Lab相关的接口说明。

  • verifiable_confidential_ledger
  • wedpr_crypto
  • wedpr_macros
  • wedpr_protos
  • wedpr_utils

其他相关文档

项目贡献