Aptos Moveflow SDK 使用指南 | Move dApp 极速入门（贰拾）

2023-06-2213:18

Leeduckgo

2023-06-22 13:18

Leeduckgo

2023-06-22 13:18

收藏文章

订阅专栏

1 什么是 Moveflow

MoveFlow 是建立在 Move 生态系统之上的加密资产流支付协议，它可以实现即时、无缝和不间断的支付流。

1.1 赋能加密支付

MoveFlow 有广泛的应用领域，包括实时工资支付、代币空投和解锁、订阅和按使用量付费模式等。

实时工资支付：流支付可以帮助公司更顺畅地管理现金流，使员工能够实时收到他们的工资。
代币空投和解锁：在解锁项目代币的过程中，可以使用流支付来设置分期释放计划，让投资者可以持续地收到代币。一旦流支付创建，就不可以更改，这减少了投资者遭遇突然撤退的风险。
订阅和按使用量付费模式：用户不再需要支付月费，而是在使用服务时进行付款，并在不再使用时停止付款，避免不必要的损失。

1.2 DeFi 基础设施

流支付还可以作为 DeFi 开发的基础设施，为 DeFi 带来更多有趣的产品和应用。基于 Move 生态系统，接收权和发送权的 Resource 可以 NFT 化，作为有价值资产应用于更多的 DeFi 领域。

2 Moveflow SDK 的介绍和安装

2.1 Moveflow SDK 介绍

Moveflow SDK 主要服务于第三方 Dapp 应用开发，独立开发者，前端等多个对象。用户对象可以方便快捷地跟合约进行交互操作，而无需考虑底层合约的实现方式。

Moveflow SDK 提供有流支付的交互接口和查询接口，两种类型接口相互配合完成所有流支付的相关操作。

交互接口列表如下：

create
withdraw
pause
resume
close
extend

查询接口列表如下：

getStreamById
withdrawable
incoming
outgoing

2.2 Moveflow SDK 的安装

使用 yarn 安装 Moveflow SDK。

yarn add @moveflow/sdk.js

在代码中导入文件后，可以创建sdk实例。

import { SDK,TESTNET_CONFIG } from '@moveflow/sdk.js';
    
const sdk = new SDK(TESTNET_CONFIG);

3 流支付的交互接口解析和使用

3.1 创建流

该接口可以创建一条支付流，并且返回交易结果。

const payload = sdk.stream.create({
  name : 'test',
  remark : 'test',
  recipientAddr: '0x20f0cbe21cb340fe56500e0889cad03f8a9e54a33e3c4acfc24ce2bdfabc4180',
  depositAmount: 1,
  startTime: start_time,
  stopTime: stop_time,
  coinType: CoinsMapping.APTOS,
  interval: 1,
  canPause: true,
  closeable: true,
  recipientModifiable: true,

})

const txid = await SignAndSubmitTransaction(payload)

需要输入的参数有：

name: 支付流名称。
remark: 支付流描述。
recipientAddr: 支付流接收者地址。
depositAmount: 总共存入的 Coin 数量。
startTime: 支付流开始时间，单位为秒。
stopTime: 支付流结束时间，单位为秒。
coinType: 支付流的币种，默认为 APT。
interval: 支付周期间隔，默认为 1 秒。
canPause: 支付流是否支持暂停，默认为 true。
closeable: 支付流是否支持关闭，默认为 true。
recipientModifiable: 支付流是否支持修改接收者地址, 默认为 false。

3.2 从支付流中提取 Coin

支付流的接收者从一条支付流中提取 Coin。可提取的 Coin 数量从上次提取时间起算到当前时间，每满一个提取周期获得相应数量的 coin 提取权限。

const payload = sdk.stream.withdraw({
  id：30，
  coinType: AptosCoin,
})

const response = await SignAndSubmitTransaction(payload)

需要输入的参数有：

id: 支付流的 Id。
coinType: 支付流的币种，默认为 APT。

获取支付流的 Id

接收者从支付流中提取 Coin 时需要指定支付流的 id，支付流 id 是一条支付流的唯一标识。Moveflow SDK 有单独的接口帮助获取所需要支付流 id。

查询接收者的所有输入支付流：通过地址参数，查询该地址作为接收者的所有支付流 Id。（详见 4.3）

查询发送者的所有输出支付流：通过地址参数，查询该地址作为发送者的所有支付流 Id。（详见 4.4）

3.3 关闭支付流

该接口会审核接口调用权限，只有支付流的发送者才能关闭这条支付流。关闭支付流后，接收者将受到其可提取的 Coin，剩余 Coin 会退回给发送者。

const payload = sdk.stream.close({ id: 29 })

const txid = await SignAndSubmitTransaction(payload)

需要输入的参数有：

id: 支付流的 Id。

3.4 暂停支付流

该接口可以暂停一条支付流，暂停期间接收者不会累积可提取 Coin。

const payload = sdk.stream.pause({
    id: 29,
    coinType: AptosCoin,
})

const txid = await SignAndSubmitTransaction(payload)

需要输入的参数有：

id: 支付流的 Id。
coinType: 支付流的币种，默认为 APT。

3.5 恢复支付流

该接口对应于暂停支付流，可以将一条暂停状态的支付流恢复。恢复后接收者可以正常累积可提取 Coin。

 const payload = sdk.stream.resume({
    id: 29,
    coinType: AptosCoin,
})

const txid = await SignAndSubmitTransaction(payload)

需要输入的参数有：

id: 支付流的 Id。
coinType: 支付流的币种，默认为 APT。

3.6 扩展支付流

如果支付流的发送者需要以原有支付参数增加新的代币数量，可以通过此接口延长原有支付流的结束时间，无需创建一个新的支付流。

const payload = sdk.stream.extend({
    id: 30,
    extraAmount: 300,
    stopTime: '1635724800',
    coinType: AptosCoin,
})

const txid = await SignAndSubmitTransaction(payload)

需要输入的参数有：

id: 支付流的 Id。
extraAmount: 需要额外支持的代币数量。
stopTime: 支付流新的结束时间，需要存入一定代币数量来延续支付流的支付时间。
coinType: 支付流的币种，默认为 APT。

4 流支付的查询接口的解析和使用

4.1 查询支付流信息

通过指定的支付流 id 获取支付流的信息。

const id = 30

const streams = await sdk.stream.getStreamById(id)

console.log("streams:", streams)

支付流的信息包括：

status: 状态用于支付流的过滤，分为以下七种：Scheduled/Canceled/Streaming/Completed/Paused/Unknown/All
createTime: 支付流的创建时间
depositAmount: 支付流中存入的 Coin 数量
streamId: 支付流的 id
interval: 支付周期，单位为 s
lastWithdrawTime: 上次提取 Coin 时间
ratePerInterval: 每周期支付的 Coin 数量
recipientId: 接收者地址
remainingAmount: 支付流中还剩下的 Coin 数量，其与 depositAmount 的差额就是已被提取的 Coin 数量
senderId: 发送者地址
startTime: 开始时间
stopTime: 结束时间
withdrawnAmount: 以及接收的金额
pauseInfo: 支付流的暂停信息，包括暂停状态，暂停开始时间，已暂停时间。
name: 支付流的名称
streamedAmount: 已经 streamed 的金额，从支付流开始到现在可以提取的代币数量
withdrawableAmount: 接收者当前时间点可以提取的金额，等于 streamedAmount 减去 withdrawnAmount
escrowAddress: 代理金库地址

支付流信息结构体定义如下：

interface StreamInfo {
    status: StreamStatus,
    createTime: string,
    depositAmount: string, 
    streamId: string, 
    interval: string,
    lastWithdrawTime: string, 
    ratePerInterval: string,
    recipientId: string,
    remainingAmount: string, 
    senderId: string, 
    startTime: string, 
    stopTime: string,  
    withdrawnAmount: string, 
    pauseInfo: {
        accPausedTime: string,
        pauseAt: string,
        paused: boolean,
    },
    name: string, // stream's name
    streamedAmount: string,
    withdrawableAmount: string,
    escrowAddress: string,
}

4.2 查询支付流的可提取 Coin 数量

查询支付流的可提取 Coin 数量，也就是到当前时间点支付流已发送的 Coin 数量减去接收者已提取的 Coin 数量。

const id = 30

const res = await sdk.stream.withdrawable(_id)

console.log("withdrawable res:", res)

4.3 查询某地址的输入流

以某地址为入参，查询该地址作为接收者的所有支付流的信息。

const address = `0x20f0cbe21cb340fe56500e0889cad03f8a9e54a33e3c4acfc24ce2bdfabc4180`

const res = await sdk.stream.getIncomingStreams(address)

console.log("getIncomingStreams res:", res)

4.4 查询某地址的输出流

以某地址为入参，查询该地址作为发送者的所有支付流的信息。

const address = `0x20f0cbe21cb340fe56500e0889cad03f8a9e54a33e3c4acfc24ce2bdfabc4180`

const res = await sdk.stream.getOutgoingStreams(address)

console.log("getOutgoingStreams res:", res)