1、开发包概述

AaveTool开发包适用于为PHP应用快速增加对AAVE协议的支持能力，主要包含以下特性：

支持以太币/ERC20代币的存入、生息、赎回等完整功能
支持资产数据与协议事件查询
支持AAVE市场和UNISWAP市场

AaveTool开发包支持PHP 7.1+，当前版本1.0.0，主要类型及关系如下图所示：

AaveTool的主要代码文件清单见官网说明：

2.1 向Aave存入资产

示例程序demo/deposit-eth.php演示了如何向Aave协议存入资产。在终端执行如下命令启动示例程序：

 php deposit-eth.php

输出结果如下：

2.2 从Aave借出资产

实例程序demo/borrow-dai.php演示了如何从Aave协议借出资产。在终端执行如下命令启动示例程序：

 php borrow-dai.php

输出结果如下：

2.3 查看Aave协议总体统计信息

实例程序demo/general-info.php演示了如何查询Aave协议的总体统计数据。在终端执行如下命令启动示例程序：

 php general-info.php

输出结果如下：

2.4 查询账户在Aave协议中的数据

示例程序demo/user-info.php演示了如何查询以太坊账户在Aave协议中的统计数据。在终端执行如下命令启动示例程序：

 php user-info.php

输出结果如下：

2 Credential类使用方法

AaveTool使用Credential类来表示一个特定的以太坊账号，是访问Aave协议的主体。

2.1 实例化 Credential

使用静态方法new()创建一个新的以太坊账户，例如：

 //use AaveTool\Credential;

$credential = Credential::new();

也可以使用静态方法fromKey()导入已有的私钥来实例化Credential对象，例如：

 $credential = Credential::fromKey('0x4f3edf983ac6......b113bce9c46');

2.2 查看账户的密钥和地址

Credential类提供了如下方法获取当前账户的私钥、公钥和地址：

getPrivateKey()：返回私钥16进制字符串
getPublicKey()：返回公钥16进制字符串
getAddress()：返回地址16进制字符串

例如，下面的代码创建一个新的以太坊账户并显示其地址：

 $credential = Credential::new();
echo 'address => ' . $credential.getAddress() . PHP_EOL;

3、MoneyMarket类使用说明

MoneyMarket类提供了一组便捷方法用于访问Aave协议。

3.1 MoneyMarket实例化

实例化MoneyMarket需要传入两个参数：用于交互的账户对象，以及必要的市场配置信息。例如：

 //use AaveTool\Credential;
//use AaveTool\MoneyMarket;
//use AaveTool\Enums\Network;
//use AaveTool\Enums\Market;

$credential = Credential::fromKey('0x7878......7878');
$ config  = [
  'url' => '#39;,        // 以太坊节点URL
  'timeout' => 60,                         // 节点超时设置，单位：秒
  'network' => Network::MAIN,              // 接入以太坊主网
  'market' => Market::AAVE                 // 接入AAVE市场
];
$moneyMarket = new MoneyMarket($credential, $config);

Network 枚举类型目前支持以下选项：

Network::MAIN：以太坊主链
Network::ROPSTEN：以太坊Ropsten测试链
Network::RINKEBY：以太坊Rinkeby测试链

Market枚举类型目前支持以下选项：

Market::AAVE：Aave市场
Market::UNISWAP：Uniswap市场

3.2 将资产存入Aave协议

使用MoneyMarket对象的 deposit ()向Aave协议存入以太币或代币。例如向Aave协议存入100个Ether：

 //use AaveTool\Enums\Asset;

$txid = $moneyMarket->deposit(
  Asset::ETH,                         // 存入资产名称        
  '100000000000000000000'             // 存入资产数量
);

或者向Aave协议存入100个USDT：

 $txid = $moneyMarket->deposit(
  Asset::USDT,                         // 存入资产名称        
  '100000000'                          // 存入资产数量
);

注意，存入资产数量应以相应资产的最小单位计，例如：

100 ether = 100000000000000000000 wei
100 usdt = 100000000 unit

Asset枚举类型目前支持以下选项：

Aave市场：ETH / DAI / USDT / SUSD / TUSD / USDT / BAT / ENJKNC / LEND / LINK / MANA / MKR / REN / REP / SNX / WBTC / ZRX
Uniswap市场：ETH / DAI / USDC / USDTUNI_USDC_ETH / UNI_LINK_ETH / UNI_DAI_ETHUNI_LENT_ETH / UNI_MKR_ETH / UNI_SETH_ETH

默认情况下deposit()方法会自动估算交易的gasPrice和gasLimit，也可以使用方法的最后两个参数指定这两个值，例如：

 $txid = $moneyMarket->deposit(
  Asset::USDT,                         // 存入资产名称        
  '100000000',                         // 存入资产数量
  '20000000000',                       // gasPrice：20 gwei
  '100000'                             // gasLimit: 100k
);
echo 'deposit txid => ' . $txid . PHP_EOL;

MoneyMarket的其他交易方法与deposit()方法类似，默认情况下均自动估算gasPrice和gasLimit，同时也支持手工指定这两个参数值，后续不再赘述。

3.3 抵押/解抵押存入资产

存入Aave的资产可以设置为抵押物以便后续借贷。使用如下两个方法设置指定的存入资产的可抵押状态：

enableUseAsCollateral()：设置为抵押物
disableUseAsCollateral()：取消抵押物设置

例如，下面的代码将之前存入的ETH资产设置为抵押物：

 an$txid = $moneyMarket->enableUseAsCollateral(Asset::ETH);
echo 'enable collateral txid => ' . $txid . PHP_EOL;

3.4 从Aave协议借出资产

在抵押物有效的情况下，可以使用borrow()方法从Aave协议借出其他资产。例如借出20个LINK：

 an//use AaveTool\Enums\Asset;
//use AaveTool\Enums\InterestRateMode;

$txid = $moneyMarket->borrow(
  Asset::LINK,                       // 资产名称
  '20000000000000000000',            // 资产数量
  InterestRateMode::STABLE           // 计息模式
);
echo 'borrow txid => ' . $txid . PHP_EOL;

Aave对借出的资产支持两种计息模式：

InterestRateMode::STABLE：稳定利率，基于算法保持利率较小的变化
InterestRateMode::VARIABLE：变动利率，即利率随资产供需关系动态调整

3.5 切换借出资产的计息模式

使用swapBorrowRateMode()方法可以切换借出资产的计息模式。例如：

 $txid = $moneyMarket->swapBorrowRateMode();
echo 'swap rate mode txid => ' . $txid . PHP_EOL;

3.6 偿还借出资产

使用repay()方法偿还从Aave借出的资产。例如偿还一部分借出的 LINK资产：

 $txid = $moneyMarket->repay(
  Asset::LINK,                          // 资产名称
  '10000000000000000000'                // 资产数量
);
echo 'repay txid => ' . $txid . PHP_EOL;

默认情况下，repay()方法偿还当前账户的借出资产，也可以为他人偿还借出资产，例如替mary偿还借款：

 $mary = '0x9F7C50......D3e3bd';    
$txid = $moneyMarket->repay(
  Asset::LINK,                          // 资产名称
  '10000000000000000000',               // 资产数量
  $mary                                 // 偿还该地址名下借款 
);
echo 'repay txid => ' . $txid . PHP_EOL;

3.7 从Aave协议取出存款

使用redeem()方法取回存在Aave协议中的资产。例如取出一部分之前存入的ETH：

 $txid = $moneyMarket->redeem(
  Asset::ETH,                            // 资产名称
  '10000000000000000000'                 // 资产数量
);
echo 'redeem txid => ' . $txid . PHP_EOL;

3.8 查询账户在Aave协议中的基本信息

使用getUserAccountData()方法查询当前账户在Aave协议中的基本信息。例如：

 $data = $moneyMarket->getUserAccountData();
 foreach ($data as $name => $value){
  echo $name . ': ' . $value . PHP_EOL;
}

getUserAccountData()方法返回一个关联数组，主要包含以下字段：

totalLiquidityETH：存入资产总额，单位：WEI
totalCollateralETH：抵押资产总额，单位：WEI
totalBorrowsETH：借出资产总额，单位：WEI
totalFeesETH：手续费总额，单位：WEI
availableBorrowsETH：有效借款额度，单位：WEI
currentLiquidationThreshold：抵押资产平均清算阈值
ltv：Loan-to-Value平均值
healthFactor：账户健康系数

3.9 查询账户在Aave协议中的资产情况

使用getUserReserveData()方法查询当前账户在Aave协议中的资产状况。例如下面的代码查询用户在Aave协议中ETH资产的借贷情况：

 $data = $moneyMarket->getUserReserveData(
  Asset::ETH
);
foreach($data as $name => $value){
  echo $name . ': ' . $value . PHP_EOL;
}

getUserReserveData()方法返回一个关联数组，各字段说明如下:

currentATokenBalance：存入资产计息余额
currentBorrowBalance：借出资产计息余额
pincipalBorrowBalance：借出资产本金
borrowRateMode：借出计息模式
borrowRate：借出资产的年化利率
liquidityRate：存入资产的年化利率
originationFee：借出资产的初始费
variableBorrowIndex：变动累积指数
lastUpdateTimestamp：最后更新时间戳
usageAsCollateralEnabled：是否可作为抵押物

AaveTool官方下载地址：

智云一二三科技

Aave协议Php开发包「DeFi」

1、开发包概述

2.1 向Aave存入资产

2.2 从Aave借出资产

2.3 查看Aave协议总体统计信息

2.4 查询账户在Aave协议中的数据

2 Credential类使用方法

2.1 实例化 Credential

2.2 查看账户的密钥和地址

3、MoneyMarket类使用说明

3.1 MoneyMarket实例化

3.2 将资产存入Aave协议

3.3 抵押/解抵押存入资产

3.4 从Aave协议借出资产

3.5 切换借出资产的计息模式

3.6 偿还借出资产

3.7 从Aave协议取出存款

3.8 查询账户在Aave协议中的基本信息

3.9 查询账户在Aave协议中的资产情况

关于作者: 智云科技

1、开发包概述

2.1 向Aave存入资产

2.2 从Aave借出资产

2.3 查看Aave协议总体统计信息

2.4 查询账户在Aave协议中的数据

2 Credential类使用方法

2.1 实例化 Credential

2.2 查看账户的密钥和 地址

3、MoneyMarket类使用说明

3.1 MoneyMarket实例化

3.2 将资产存入Aave协议

3.3 抵押/解抵押存入资产

3.4 从Aave协议借出资产

3.5 切换借出资产的计息模式

3.6 偿还借出资产

3.7 从Aave协议取出存款

3.8 查询账户在Aave协议中的基本信息

3.9 查询账户在Aave协议中的资产情况

给这篇文章的作者打赏

关于作者: 智云科技

相关文章

阿里云免费虚拟主机安装WordPress博客图文教程

PHP框架yaf的优点和缺点

PHP垃圾回收机制的一些浅薄理解

热门文章

1分享新浪图床上传接口源码

2PHP简单实现路由Route功能

3Tideways、xhprof 和 xhgui 打造 PHP 非侵入式监控平台

4centos系统如何查看是否安装了mysql

5curl 工具简述

2.2 查看账户的密钥和地址