#module #channel #run-time #interaction #substrate #peer #celer-pay

celer-pay-module-rpc

特定于节点与合约交互的 RPC 方法

1 个不稳定版本

0.8.8 2020 年 10 月 17 日

#112#peer

MIT 许可证

30KB
463

cChannel-substrate

概述

CelerPay 是一个通用的支付网络,支持高效的链下代币转账,并具有解决链上可验证状态任意条件依赖的能力。此仓库实现了使用 substrate 的 CelerPay 运行时模块。它包括一组作为 CelerPay 核心抽象和支撑模块绑定作用的运行时模块。CelerPay 运行时模块仅指定两个节点之间的交互逻辑。可以使用这些单跳原语和协议构建支付通道网络。

要了解更多关于 Celer 状态通道网络的信息,请参阅 CelerCore 技术文档。更具体地说,此页面 详细介绍了我们的智能合约设计、结构和 API 流程。

Celer 状态通道网络由 Celer-pay 链上运行时模块和 Celer-pay 链下协议组成。此存储库是 Celer-pay 链上运行时模块。Celer-pay 链下协议尚未实现。

警告:这是一个概念验证原型。此实现尚未准备好用于生产使用。

核心概念

  • 节点:通道参与者(目前仅支持双节点通道)。
  • 单工通道:从一个节点到另一个节点的单向支付通道。
  • 双工通道:节点之间的双向支付通道,包括两个独立的单工通道。
  • 单工状态:描述单工通道状态的一块数据。
  • 签名单工状态:由通道参与者签名的单工状态,充当链上运行时模块和链下通信协议之间的桥梁数据结构。
  • 条件:表示条件依赖基本单元的数据结构。
  • 转移函数:一组条件上通用状态依赖的高级抽象。
  • 条件支付:表示从支付源到支付目的地的物理支付的数据结构。
  • 支付源:发送支付的地址,即该支付路径的源头。
  • 支付目的地:接收支付的地址,即该支付路径的目的地。
  • 已验证的条件支付结果:支付源和支付目的地达成一致的条件支付结果。
  • PayRegistry:一个全局注册表,用于更新和记录所有支付结果。
  • PayIdList:包含支付ID列表和指向下一个PayIdList的哈希指针的数据结构,用于批量多支付清算。
  • Pool:Pool使CelerPay的单次交易通道开启功能成为可能。

发布特性

  • 原生代币支持:用户可以选择polkadot原生代币来开启基于Substrate的通道。
  • 通用状态通道:通过依赖虚拟通道来解决条件状态依赖。
  • 全双工通道:在双工通道中支持两个独立的单向通道,这使得链外通信更加简单和高效。
  • 布尔条件接口:定义返回布尔值的条件。
  • 布尔AND解析逻辑:根据布尔AND逻辑解析一组条件。
  • 布尔OR解析逻辑:根据布尔OR逻辑解析一组条件。
  • 数值条件接口:定义返回数值值的条件。
  • 数值ADD解析逻辑:根据数值ADD逻辑解析一组条件。
  • 数值MAX解析逻辑:根据数值MAX逻辑解析一组条件。
  • 数值MIN解析逻辑:根据数值MIN逻辑解析一组条件。
  • 单次交易通道开启:通过原生代币的资金批准,通过单次链上交易打开通道。
  • 动态提取:在通道最终确定之前提取资金,只要在挑战期内没有同伴反对。
  • 合作动态提取:当双方达成协议时,跳过挑战期并在通道最终确定之前提取资金。
  • 轻量级合作链上检查点:支持在链上快照共同签署的状态的转移映射。
  • 批量多通道结算:旨在通过单次链上交易批量结算多个通道。
  • 批量多支付清算:使用PayIdList在一个批次中通过单次链上交易清算N次支付,这只需要O(1)的链上存储和O(n/N)的链上验证来清算n次支付。
  • 合作结算:当双方达成协议时,跳过挑战期并结算通道。

在 Docker 中运行 Celer 本地测试网

docker run -p 9944:9944 -p 9615:9615 thashimoto19980924/celer-network:0.8.8

从源代码构建和测试 celer-pay 运行时模块

  1. 快速安装

Mac OS,Arch,或类似Ubuntu的基于Debian的OS

curl https://getsubstrate.io -sSf | bash -s -- --fast

Debian

sudo apt install -y cmake pkg-config libssl-dev git gcc build-essential clang libclang-dev

MacOS

brew install openssl cmake llvm
  1. Rust开发者环境
curl https://sh.rustup.rs -sSf | sh
rustup default stable
  1. Wasm编译
rustup install nightly
rustup target add wasm32-unknown-unknown --toolchain nightly
rustup default stable
  1. 安装 celer-pay 运行时模块
git clone [email protected]:celer-network/cChannel-substrate.git
  1. 转到 cChannel-substrate 的根目录

  2. 构建 celer-pay 运行时模块

cd ./pallets/celer-pay
cargo build --release
  1. 测试 celer-pay 运行时模块
cargo test -p celer-pay-module

project supported by web3 foundation grants program


lib.rs:

交易支付模块的RPC接口。

依赖项

~27–42MB
~702K SLoC