#channel #module #payment #run-time #on-chain #state #celer-pay

no-std celer-pay-module

Celer Pay 链上运行时模块

1 个不稳定版本

0.8.8 2020年10月17日

#33#on-chain

MIT 许可证

450KB
9K SLoC

cChannel-substrate

概述

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

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

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

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

核心概念

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

发布特性

  • 原生代币支持:用户可以指定polkadot原生代币来开启基于Substrate的通道。
  • 通用状态通道:通过依赖虚拟通道解决条件状态依赖。
  • 全双工通道:在双工通道中支持两个独立的单工(单向)通道,这使得链下通信更加简单和高效。
  • 布尔条件接口:定义返回布尔值的条件。
  • 布尔AND解析逻辑:根据布尔AND逻辑解析一组条件。
  • 布尔OR解析逻辑:根据布尔OR逻辑解析一组条件。
  • 数字条件接口:定义返回数字值的条件。
  • 数字ADD解析逻辑:根据数字ADD逻辑解析一组条件。
  • 数字MAX解析逻辑:根据数字MAX逻辑解析一组条件。
  • 数字MIN解析逻辑:根据数字MIN逻辑解析一组条件。
  • 单笔交易通道开启:通过原生代币的资金批准,使用单笔链上交易开启通道。
  • 动态提款:在通道最终确定之前提款,只要在挑战期间没有对等方不同意。
  • 合作动态提款:当双方达成协议时,跳过挑战期并在通道最终确定之前提款。
  • 轻量级合作链上检查点:支持在链上快照签署状态的转账映射。
  • 批量多通道结算:旨在使用单笔链上交易批量结算多个通道。
  • 批量多支付清算:使用支付ID列表,通过单笔链上交易批量清算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-based 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

依赖项

~7.5MB
~140K SLoC