PancakeSwap PHP对接开发包

概述Pancake.php开发包适用于为PHP应用快速增加对PancakeSwap协议的支持能力。即支持使用自有部署BSC区块链节点的应用场景，也支持使用第三方节点的轻量级部署场景。官方下载地址：PancakeSwapPHP开发包。1、开发包概述Pancake.php开发包主要包含以下特性：一键部署PancakeSwap协

Pancake.PHP 开发包适用于为PHP应用快速增加对PancakeSwap协议的支持能力。即支持使用自有部署BSC区块链节点的应用场景，也支持使用第三方节点的轻量级部署场景。官方下载地址：PancakeSwap PHP开发包。

1、开发包概述

Pancake.PHP开发包主要包含以下特性：

一键部署PancakeSwap协议，便于快速开发与测试支持PancakeSwap协议的全部接口，并提供开发人员友好的API支持BEP20/BEP20、BNB/BEP20等各种交易对的流动性添加、移除与兑换交易支持自动做市价格计算与滑点计算支持BSC交易gas用量与gas价格的自动估算与手动设定支持EIP712签名授权，单一交易内完成流动性维护

Pancake.PHP开发包运行在 PHP 7.1+ 环境下，当前版本1.0.0，主要类/接口及关系如下图所示：

Pancake.PHP开发包的主要代码文件清单如下：

代码文件	说明
pancake.PHP/src/SwapKit.PHP	pancake.PHP开发包入口类
pancake.PHP/src/OrderBuilder.PHP	流动性维护订单构造器
pancake.PHP/src/Order.PHP	流动性维护订单类
pancake.PHP/src/TradeBuilder.PHP	兑换交易构造器
pancake.PHP/src/Trade.PHP	兑换交易类
pancake.PHP/src/PermitSigner.PHP	EIP712签名实现类
pancake.PHP/src/SmartContract.PHP	智能合约封装类
pancake.PHP/src/Transactor.PHP	BSC交易执行器
pancake.PHP/src/Credential.PHP	BSC身份标识类
pancake.PHP/src/Callback.PHP	回调执行辅助类
pancake.PHP/src/helper.PHP	其他辅助函数
demo/config.PHP	演示程序参数配置文件
deploy-contracts.PHP	PancakeSwap及测试Token合约部署工具，可用于快速开发与测试
demo/add-liquIDity.PHP	BEP20/BEP20交易对流动性添加演示
demo/add-liquIDity.PHP	BEP20/BEP20交易对流动性添加演示
demo/add-liquIDity-bnb.PHP	BEP20/BNB交易对流动性添加演示
demo/remove-liquIDity.PHP	BEP20/BEP20交易对流动性移除演示
demo/remove-liquIDity-bnb.PHP	BEP20/BNB交易对流动性移除演示
demo/swap-exact-tokens-for-tokens.PHP	BEP20/BEP20兑换演示，以输入token数量为基准
demo/swap-tokens-for-exact-tokens.PHP	BEP20/BEP20兑换演示，以输出token数量为基准
demo/swap-exact-bnb-for-tokens.PHP	BNB/BEP20兑换演示，以输入bnb数量为基准
demo/swap-bnb-for-exact-tokens.PHP	BNB/BEP20兑换演示，以输出token数量为基准
demo/swap-exact-tokens-for-bnb.PHP	BEP20/BNB兑换演示，以输入token数量为基准
demo/swap-tokens-for-exact-bnb.PHP	BEP20/BNB兑换演示，以输出bnb数量为基准
contract/HappyToken.sol	标准BEP20 token实现，开发测试用
contract/BEP20USDT.sol	Tether/USDT实现，开发测试用
contract/PancakeFactory.sol	PancakeSwap工厂合约实现
contract/PancakeRouter.sol	PancakeSwap路由合约实现
contract/WBNB.sol	WBNB合约实现
bin/	solc编译器目录
bin/build-contracts	合约编译脚本
vendor	第三方依赖包目录
composer.Json	composer配置文件

2、使用示例代码2.1 编译合约

在终端进入项目目录，执行如下命令编译PancakeSwap及开发包提供的测试Token合约：

~$ cd ~/pancake.PHP~/pancake.PHP$ bin/build-contracts

执行结果如下：

2.2 部署合约

首先在另一个终端启动开发私链：

~$ ganache-cli -d

然后进入项目demo目录，执行如下命令部署合约：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP deploy-contracts.PHP

执行结果如下：

注意 ：如果需要在BSC测试链或主链部署上述合约，或者使用其他参数 启动ganache-cli，需要修改demo/config.PHP中的账号配置。

2.3 Token授权

代码token-approve.PHP演示了如何授权PancakeSwap路由合约代理 *** 作当前账号的HAPY token和USDT token。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP token-approve.PHP

执行结果如下：

2.4 BEP20/BEP20交易对添加流动性

代码add-liquIDity.PHP演示了如何为BEP20/BEP20交易对添加流动性。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP add-liquIDity.PHP

执行结果如下：

PancakeSwap协议约定，第一次添加流动性将自动创建交易对 ，之后再次添加流动性时，演示代码将首先显示当前的仓位信息。例如再次执行如下命令：

~/pancake.PHP/demo$ PHP add-liquIDity.PHP

执行结果如下：

2.5 BEP20/BEP20交易对移除流动性

代码remove-liquIDity.PHP演示了如何移除指定的BEP20/BEP20交易对的流动性。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP remove-liquIDity.PHP

执行结果如下：

2.6 BEP20/BEP20兑换：以输入token数量为基准

代码swap-exact-tokens-for-tokens.PHP演示了如何实现以输入token数量为基准的BEP20/BEP20兑换。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-exact-tokens-for-tokens.PHP

执行结果如下：

2.7 BEP20/BEP20兑换：以输出token数量为基准

代码swap-tokens-for-exact-tokens.PHP演示了如何实现以输出token数量为基准的BEP20/BEP20兑换。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-tokens-for-exact-tokens.PHP

执行结果如下：

2.8 BNB/BEP20交易对添加流动性

代码add-liquIDty-bnb.PHP演示了如何为BNB/BEP20或BEP20/BNB交易对添加流动性。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP add-liquIDity-bnb.PHP

执行结果如下：

第一次添加流动性将自动创建交易对，之后再次添加将首先显示当前的持仓信息。例如再次执行如下命令：

~/pancake.PHP/demo$ PHP add-liquIDity-bnb.PHP

执行结果如下：

2.9 BNB/BEP20交易对移除流动性

代码remove-liquIDity-bnb.PHP演示了如何移除BNB/BEP20或BEP20/BNB交易对的流动性。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP remove-liquIDity-bnb.PHP

执行结果如下：

2.10 BNB/BEP20兑换：以输入BNB数量为基准

代码swap-exact-bnb-for-tokens.PHP演示和如何将指定数量的BNB兑换为BEP20 token。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-exact-bnb-for-tokens.PHP

执行结果如下：

2.11 BNB/BEP20兑换：以输出token数量为基准

代码swap-bnb-for-exact-tokens.PHP演示了如何将BNB兑换为指定数量的BEP20 token。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-bnb-for-exact-tokens.PHP

执行结果如下：

2.12 BEP20/BNB兑换：以输入token数量为基准

代码swap-exact-tokens-for-bnb.PHP演示了如何将指定数量的BEP20 token兑换为BNB。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-exact-tokens-for-bnb.PHP

执行结果如下：

2.13 BEP20/BNB兑换：以输出BNB数量为基准

代码swap-tokens-for-exact-bnb.PHP演示了如何将BEP20token兑换为指定数量的BNB。

在终端进入项目demo目录，执行如下命令：

~$ cd ~/pancake.PHP/demo~/pancake.PHP/demo$ PHP swap-tokens-for-exact-bnb.PHP

执行结果如下：

3、使用pancake.PHP开发包

SwapKit 是开发包的入口，使用这个类可以快速实现如下功能：

流动性添加与移除：支持BEP20/BEP20、BEP20/BNB、BNB/BEP20等各种交易对兑换交易的创建与执行：支持BEP20/BEP20、BEP20/BNB、BNB/BEP20等各种交易对，支持以输入或输出价格为准用户仓位查询：查询指定账号在指定交易对的持仓情况，例如持仓数量、占比等。3.1 实例化SwapKit

SwapKit实例化需要传入三个参数：

BSC节点URLPancakeSwap路由合约地址用于执行合约交互的BSC账号，即一个Credential对象。

例如，下面的代码创建一个接入BSC主网PancakeSwap协议的SwapKit实例：

//use Pancake\SwapKit;//use Pancake\Credential;$kit = new SwapKit(  'https://bsc-dataseed.binance.org',               //BSC节点URL  '0x05fF2B0DB69458A0750badebc4f9e13aDd608C7F',     //PancakeSwap路由合约地址  Credential::fromKey('0x4f3e...3b1d')              //默认执行账号，指定私钥                                 );

有关Credential的使用说明，详见本文第3.2部分。

3.2 Credential：BSC身份与地址表示

在pancake.PHP开发包中，使用 Credential 表征BSC区块链中的一个用户身份，与BSC地址相比，Credential对象中包含了用户的私钥信息，可以用来签名交易，因此需要保护其不会泄露。

使用Credential类的静态方法new()创建新账户。例如，下面的代码创建一个新的账户并显示其私钥、公钥和地址：

//use Pancake\Credential;$alice = Credential::new();                                  //创建新账号echo 'private key => ' . $alice->getPrivateKey() . PHP_Eol;  //显示私钥echo 'public key => ' . $alice->getPublicKey() . PHP_Eol;    //显示公钥echo 'address => ' . $alice->getAddress() . PHP_Eol;         //显示地址

可以使用静态方法fromKey()导入已有的私钥来实例化Credential。例如下面的代码导入已有私钥并显示地址：

//use Pancake\Credential;$alice = Credential::fromKey('0x7889...023a');              //导入已有私钥echo 'address => ' . $alice->getAddress() . PHP_Eol;        //显示相应地址

3.4 生成流动性添加/移除委托单

由于PancakeSwap协议中涉及到交易滑点处理以及价格预计算，因此pancake.PHP提供了一个专门的类 OrderBuilder 用于生成流动性添加/移除委托单。OrderBuilder的实现内置了自动价格计算与滑点计算，因此调用者只需要指定基本的数据即可生成可提交给PancakeSwap合约的流动性添加/移除委托单。

使用SwapKit对象的getorderBuilder()方法获取预创建
的OrderBuilder对象，并调用OrderBuilder的build()
方法生成委托单。例如：

$order = $kit->getorderBuilder()           //返回OrderBuilder对象              ->....                        //参数设置             ->build();                    //生成并返回委托单

OrderBuilder对象提供了以下方法用于调整生成器的行为：

orderType($type) ：设置委托单类型，目前支持两种： Order::liQUIDITY_ADD - 流动性添加委托单Order::liQUIDITY_REMOVE - 流动性移除委托单 tokenA( a d d r ) ∗ ∗ / ∗ ∗ t o k e n B ( addr)** / **tokenB( addr)∗∗/∗∗tokenB(addr) ：交易对的两个Token地址
表示交易对之一为以太币amountA( b n ) ∗ ∗ / ∗ ∗ a m o u n t B ( bn)** / **amountB( bn)∗∗/∗∗amountB(bn) ：两个token的添加数量，仅在添加流动时需要设置liquIDity($bn) ：LP token数量，仅在移除流动性时需要设置slippage($bn) ：交易滑点设置，默认值为5， 表示0.5%的滑点容忍区间to($addr) ：委托单执行结果接收地址

例如，下面的代码生成一个流动性添加委托单：

use Pancake\Order;$order = $kit->getorderBuilder()                         //获取委托单生成器对象             ->orderType(Order::liQUIDITY_ADD)           //添加流动性             ->tokenA('0x...')                           //交易对TokenA             ->tokenB('0x...')                           //交易对TokenB             ->amountA(bn('100000000000000000000'))      //以TokenA数量为基准按市价自动计算TokenB数量             ->slippage(bn('10'))                        //滑点容忍范围1%             ->to($kit->getCredential())                 //设置LP Token的接收地址             ->build();                                  //生成委托单              echo 'amountA => ' . $order->amountA . PHP_Eol;          //TokenA设置数量  echo 'amountB => ' . $order->amountB . PHP_Eol;          //TokenB计算数量 echo 'amountAMin => ' . $order->amountAMin . PHP_Eol;    //滑点处理后的TokenA最小可接受数量 echo 'amountBMin => ' . $order->amountAMin . PHP_Eol;    //滑点处理后的TokenB最小可接受数量

注意：

使用特殊的 SwapKit::ETH_TOKEN 表示交易对中的BNB，值为：0x00000000000000000000000000000000000eeeeebn($numstr) 是PancakeSwap提供的一个创建 BigInteger 对象 的快捷函数，其参数为10进制字符串。token数量均按最小单位指定

类似的，下面的代码生成一个流动性移除委托单：

$order = $kit->getorderBuilder()                         //获取委托单生成器对象             ->orderType(Order::liQUIDITY_REMOVE)        //移除流动性               ->tokenA('0x...')                           //交易对TokenA地址              ->tokenB('0x...')                           //交易对TokenB地址              ->liquIDity(bn('10000000000000000000'))     //要移除的流动性数量             ->slippage(bn('10'))                        //滑点容忍范围1%             ->to($kit->getCredential())                 //token接收地址             ->build();                                  //生成委托单 echo 'amountAMin => ' . $order->amountAMin . PHP_Eol;    //滑点处理后最少应收到的TokenA数量 echo 'amountBMin => ' . $order->amountAMin . PHP_Eol;    //滑点处理后最少应收到的TokenB数量

Order对象提供的以下值，有助于在执行委托单之前向用户提供更好的反馈信息：

amountA/amountB ：市价计算的tokenA或tokenB理想值amountAMin/amountAMax ：滑点处理后的tokenA最小值/最大值amountBMin/amountBMax ：滑点处理后的tokenB最小值/最大值3.5 执行流动性委托单

使用SwapKit的 executeOrder() 方法即可执行生成的流动性委托单，最终完成流动性添加/移除交易。例如：

$txID = $kit->executeOrder($Trade);                      //执行委托单echo 'txID => ' . $txID . PHP_Eol;                       //显示交易ID 

默认情况下，executeOrder()方法自动估算交易所需的gas限额与gas价格，但可以传入额外的参数手动设置这两个值。

例如，下面的代码以指定的gas参数执行流动性维护单：

$opts = [  'gaslimit' => bn('4000000'),                          //4 million  'gasPrice' => bn('200000000000')                      //200 gwei];$txID = $kit->executeOrder($order, $opts);              //执行委托单

3.6 查询仓位信息

使用SwapKit的 getliquIDityInfo() 方法可以查询指定账号在指定交易对的仓位信息。例如查询某地址的持仓情况：

$info = $kit->getliquIDityInfo('0x90F8...c9C1');       //查询持仓信息echo 'total => ' . $info->totalSupply . PHP_Eol;       //LP总量 echo 'balance => ' . $info->balance . PHP_Eol;         //持仓数量echo 'share % => ' . $info->share . PHP_Eol;           //持仓比例

3.7 生成兑换交易对象

类似于流动性的添加与移除，在PancakeSwap中的交易对兑换也存在价格自动计算与滑点处理问题。为此，pancake.PHP开发包提供了一个专门的类 TradeBuilder用来简化这一 *** 作。TradeBuilder内置了价格自动计算与滑点处理，因此调用者只需要设置基本的参数即可。

使用SwapKit对象的getTradeBuilder()方法获取预创建的TradeBuilder对象，例如：

$tb = $kit->getTradeBuilder()              //获取预创建的兑换交易生成器          ->...                            //参数设置          ->build();                       //生成兑换交易对象

TradeBuilder提供了以下方法用于调整生成器的行为：

TradeType($type) ：兑换类型，可选值为： Trade::EXACT_input - 以tokenIn的数量为基准Trade::EXACT_OUTPUT - 以tokenOut的数量为基准 tokenIn($addr) - 输入Token的地址tokenOut($addr) - 输出Token的地址amountIn($bn) - 输入数量，仅在兑换类型为EXACT_input时需要设置amountOut($bn) - 输出数量，仅在兑换类型为EXACT_OUTPUT时需要设置slippage($bn) - 交易滑点设置，默认值5， 表示允许0.5%的滑点to($addr) - 输出token接收地址

例如，下面的代码以输入token数量为基准生成一个兑换交易对象：

$Trade = $kit->getTradeBuilder()                     //获取兑换交易生成器             ->TradeType(Trade::EXACT_input)         //以输入token数量为基准             ->tokenIn('0x...')                      //输入token             ->tokenOut('0x...')                     //输出token             ->amountIn(bn('10000000000000000000'))  //输入token的数量             ->slippage(bn('10'))                    //滑点容忍范围1%             ->to($kit->getCredential())             //输出token的接收地址             ->build();                              //生成兑换交易对象             echo 'amountIn => ' . $Trade->amountIn . PHP_Eol;          //输入token的设置数量echo 'amountOut => ' . $Trade->amountOut . PHP_Eol;        //自动做市算法得到的输出token的数量echo 'amountOutMin => ' . $Trade->amountOutMin . PHP_Eol;  //滑点处理后的应收到的输出token最少数量

3.8 执行兑换交易

使用SwapKit对象的 executeTrade() 方法执行指定的兑换交易对象。例如：

$txID = $kit->executeTrade($Trade);                       //执行兑换交易echo 'txID => ' . $txID . PHP_Eol;                        //显示交易ID

默认情况下，executeTrade()方法自动估算交易所需的gas限额与gas价格，但可以传入额外的参数手动设置这两个值。

例如，下面的代码使用设定的gas参数执行兑换交易：

$opts = [  'gaslimit' => bn('4000000'),                            //4 million  'gasPrice' => bn('200000000000')                        //200 gwei];$txID = $kit->executeTrade($Trade, $opts);                //执行交易

---

PancakeSwap PHP开发包下载链接：http://sc.hubwiz.com/codebag/pancakeswap-PHP/

总结

以上是内存溢出为你收集整理的PancakeSwap PHP对接开发包全部内容，希望文章能够帮你解决PancakeSwap PHP对接开发包所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。