您当前的位置:首页 > 电脑百科 > 程序开发 > 语言 > php

Polygon区块链PHP开发包

时间:2022-04-06 09:40:20  来源:  作者:新缸中之脑

Polygon php开发包适用于为PHP应用快速增加对Polygon区块链数字资产的支持能力, 即支持使用自有Polygon区块链节点的应用场景,也支持基于Polygon区块链官方节点API服务的 轻量级部署场景。官方下载地址:
http://sc.hubwiz.com/codebag/polygon-php/

Polygon PHP开发包主要包含以下特性:

  • 支持Polygon区块链原生PHP转账交易及余额查询
  • 支持Polygon链上智能合约的部署与交互,支持ERC20/ERC721/ERC1155转账交易及到账跟踪
  • 支持Polygon链上交易的离线签名,避免泄露私钥
  • 支持使用自有节点或第三方节点,例如Polygon官方提供的公共节点

Polygon PHP软件包运行在 Php 7.1+ 环境下,当前版本1.0.0,主要类/接口及关系如下图所示:

Polygon区块链PHP开发包

 

Polygon PHP开发包的主要代码文件清单如下:

代码文件

说明

polygon.php/src/Kit.php

Polygon PHP开发包入口类

polygon.php/src/Erc20.php

ERC20智能合约封装类

polygon.php/src/Erc721.php

ERC721智能合约封装类

polygon.php/src/Erc1155.php

ERC1155智能合约封装类

polygon.php/src/SmartContract.php

Polygon智能合约封装类

polygon.php/src/Credential.php

Polygon区链上身份标识类,用于交易签名

polygon.php/src/NodeClient.php

Polygon节点协议封装类

polygon.php/src/Callback.php

Php回调辅助类

polygon.php/src/Helper.php

杂项辅助函数集

contracts/WizToken.sol

示例ERC20合约

contracts/WizNFT.sol

示例ERC721合约

contracts/WizMT.sol

示例ERC1155合约

bin/build-contracts.sh

合约编译脚本工具

demo/credential-demo.php

演示如何创建新的Polygon账号或导入已有私钥

demo/matic-demo.php

演示MATIC转账及查询

demo/erc20-demo.php

演示ERC20转账及查询

demo/erc20-event-demo.php

演示ERC20到账监听

demo/erc721-demo.php

演示ERC721转账及查询

demo/erc721-event-demo.php

演示ERC721到账监听

demo/erc1155-demo.php

演示ERC1155转账及查询

demo/erc1155-event-demo.php

演示ERC1155到账监听

demo/deploy-contracts-demo.php

演示代码,智能合约的部署

vendor

第三方依赖包目录

composer.json

composer配置文件

2、使用示例代码

在使用示例代码之前,请按照实际情况设置demo/config.php中的以下配置信息:

  • NETWORK:要接入的区块链网络,可选:mainNet - Polygon主链, testNet - Polygon测试链
  • ALICE_ADDR:demo程序使用的主测试账号,该账号将用于部署代币合约、执行MATIC及ERC20/ERC721/ERC1155转账交易等操作,因此 需要有一定数量的MATIC余额。
  • ALICE_SK:主测试账号对应的私钥

2.1 Polygon链上地址创建与回复

demo/credential-demo.php演示了如何使用Polygon PHP开发包创建新的Polygon链上地址,或者导入已有私钥重建账号。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php credential-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.2 MATIC转账及余额查询

demo/matic-demo.php演示了如何使用Polygon PHP开发包实现MATIC转账和余额查询。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php matic-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.3 Polygon智能合约部署


demo/deploy-contracts-demo.php演示了如何使用Polygon PHP开发包部署ERC20/ERC721/ERC1155智能合约。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php deploy-contracts-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.4 ERC20转账及查询

demo/erc20-demo.php演示了如何使用Polygon PHP开发包实现ERC20转账和余额查询等操作。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc20-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.5 ERC20到账跟踪

demo/erc20-event-demo.php演示了如何使用Polygon PHP开发包的合约事件查询功能 实现ERC20通证的到账跟踪。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc20-event-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.6 ERC721 NFT转让及查询

demo/erc721-demo.php演示了如何使用Polygon PHP开发包实现ERC721 NFT转让和查询等操作。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc721-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.7 ERC721 NFT到账跟踪


demo/erc721-event-demo.php演示了如何使用Polygon PHP开发包的合约事件查询功能 实现ERC721 NFT的到账跟踪。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc721-event-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.8 ERC1155转让及查询

demo/erc1155-demo.php演示了如何使用Polygon PHP开发包实现ERC1155转让和查询等操作。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc1155-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

2.8 ERC1155到账跟踪


demo/erc1155-event-demo.php演示了如何使用Polygon PHP开发包的合约事件查询功能 实现ERC1155的到账跟踪。

在终端进入演示代码目录,执行如下命令:

~$ cd ~/polygon-php/demo
~/polygon-php/demo$ php erc1155-event-demo.php

执行结果如下:

Polygon区块链PHP开发包

 

3、使用Polygon PHP开发包

Kit类是Polygon PHP开发包的入口,使用这个类可以快速实现如下功能:

  • MATIC转账与余额查询
  • ERC20代币转账、授权、余额查询等

3.1 Kit的实例化

Kit实例化需要传入NodeClient对象和Credential对象,这两个 参数分别封装了Polygon节点提供的API、以及进行交易签名的用户身份信息。

例如,下面的代码创建一个接入Polygon主链的Kit实例,并使用 指定的私钥进行交易签名:

//use polygonKit;
//use polygonNodeClient;
//use polygonCredential;

$kit = new Kit(
  NodeClient::mainNet(),                                    //接入主链
  Credential::fromKey('0x87c12d....d435')                   //使用指定私钥
);

3.2 MATIC转账及余额查询

使用Kit对象的transfer()方法进行MATIC转账,例如发送0.1 MATIC:

//use polygonKit;

$to = '0x90F8bf6...0e7944Ea8c9C1';                          //转账目标地址
$amount = bn('100000000000000000');                         //转账金额,按最小单位
$txid = $kit->transfer($to,$amount);                        //提交MATIC转账交易
echo 'txid => ' . $txid .  PHP_EOL;                         //显示交易ID

注意:需要将金额转换为最小单位,由于MATIC的小数位数是18, 因此 0.1 MATIC = 100000000000000000 最小单位。

使用balanceOf()方法查询指定地址的MATIC余额,例如:

$addr = '0x90F8bf6...0e7944Ea8c9C1';                  //要查询的Polygon链上地址
$balance = $kit->balanceOf($addr);                    //查询MATIC余额,按最小单位
echo 'balance => ' . $balance . PHP_EOL;              //显示MATIC余额

3.3 ERC20转账

使用Kit对象的erc20()方法获取指定ERC20合约实例,然后调用合约 的transfer()方法进行ERC20转账。例如,下面的代码 指定地址间转账123.4567 USDT(合约地址:
0xc2132D05D31c914a87C6611C10748AEb04B58e8F):

//use polygonKit;

$to = '0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1';           //转账目标地址
$amount = bn('123456700');                                    //转账ERC20数量
$contractAddr = '0xc2132D05D31c914a87C6611C10748AEb04B58e8F'  //USDT合约的部署地址
$txid = $kit->erc20($contractAddr)
            ->transfer($to,$amount);                          //转账ERC20
echo 'txid => ' . $txid .  PHP_EOL;                           //显示转账交易ID

3.4 ERC20余额查询

使用erc20()方法获取指定的ERC20合约实例,然后调用合约 的balanceOf()方法查询ERC20余额。例如,下面的代码查询指定地址 的USDT余额:

//use polygonKit;

$contractAddr = '0xc2132D05D31c914a87C6611C10748AEb04B58e8F'  //USDT合约的部署地址
$balance = $kit->erc20($contractAddr)
               ->balanceOf('0x90F8bf6...0e7944Ea8c9C1');      //查询地址0x90F8...的USDT余额
echo 'balance => ' . $balance . PHP_EOL;                      //显示余额

3.5 ERC20到账跟踪

使用erc20()方法获取指定ERC20合约实例,然后调用 合约实例的getTransferEvents()方法查询指定条件的转账事件。

可以使用getTransferEvents()方法跟踪指定地址的到账状态。 例如查询地址0x90F8...在最近1000个区块的USDT代币到账事件:

//use polygonKit;

$height = $kit->getBlockHeight();
$contractAddr = '0xc2132D05D31c914a87C6611C10748AEb04B58e8F'  //USDT合约的部署地址
$events = $kit->erc20($contractAddr)
              ->getTransferEvents(                           //查询到账事件
                [],                                          //转出账号,空数组表示不要求特定的转出账号 
                ['0x90F8bf6...0e7944Ea8c9C1'],               //接收账号,仅查询地址0x90F8...的到账事件
                $height-1000,                                //查询起始区块号
                $height                                      //查询结束区块号
              );                              

foreach($events as $event){                                   
  echo 'block => ' . $event->blockNumber . PHP_EOL;            //事件发生区块号
  echo 'from => ' . $event->params['from'] . PHP_EOL;          //转出账号
  echo 'to => ' . $event->params['to'] . PHP_EOL;              //转入账号
  echo 'value => ' . $event->params['value'] . PHP_EOL;        //转账金额
}

getTransferEvents()方法返回的结果是一个事件对象数组,每个成员对象的主要字段 说明如下:

  • blockHash:事件触发的区块哈希
  • blockNumber:事件触发的区块号
  • transactionHash:触发事件的交易ID
  • address:事件触发的合约地址
  • name:事件名称,例如转账事件的名称为:Transfer
  • params:事件参数数组,例如转账事件包含以下三个参数:from:转出账号to:转入账号value:转账数量

3.6 ERC721 NFT转让

使用Kit对象的erc721()方法获取指定ERC721合约实例,然后调用合约 的transferFrom()方法进行ERC721 NFT转账。例如,下面的代码 指定地址间转让编号为1278的ERC721 NFT(合约地址:
0xc2132D05D31c914a87C6611C10748AEb04B58e8F):

//use polygonKit;

$to = '0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1';           //目标地址
$tokenId = 1278;                                              //转让的NFT编号
$contractAddr = '0xcc739b569624f82f9d7a4f614e47133f37482fed'; //ERC721合约的部署地址
$txid = $kit->erc721($contractAddr)
            ->transfer($to,$tokenId);                         //转让指定的ERC721 NFT
echo 'txid => ' . $txid .  PHP_EOL;                           //显示交易ID

3.7 ERC721 NFT查询

使用Kit对象的erc721()方法获取指定的ERC721合约实例后,可以调用合约的方法查询NFT的 基本信息以及特定编号的NFT的持有人信息等。例如:

//use PolygonKit;

$contractAddr = '0xcc739b569624f82f9d7a4f614e47133f37482fed'; //ERC721合约的部署地址
$nft = $kit->erc721($contractAddr);                           //返回ERC721合约实例

echo 'name => ' . $nft->name() . PHP_EOL;
echo 'symbol => ' . $nft->symbol() . PHP_EOL;
echo 'total supply =>' . $nft->totalSupply() . PHP_EOL;

$tokenId = 1278;                                              //NFT编号
echo 'owner => ' . $nft->ownerOf($tokenId);                   //返回指定NFT的持有人
echo 'token uri => ' . $nft->tokenURI($tokenId) . PHP_EOL;    //返回指定NFT的元信息URI

$user = '0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1';         //用户地址
echo 'total nfts => ' . $nft->balanceOf($user) . PHP_EOL;     //用户持有的NFT总数

3.8 ERC721 NFT到账跟踪

使用erc721()方法获取指定ERC721合约实例,然后调用 合约实例的getTransferEvents()方法查询指定条件的转账事件。

可以使用getTransferEvents()方法跟踪指定地址的到账状态。 例如查询地址0x90F8...在最近1000个区块的指定NFT合约到账事件:

//use polygonKit;

$height = $kit->getBlockHeight();
$contractAddr = '0xcc739b569624f82f9d7a4f614e47133f37482fed';  //ERC721合约的部署地址
$events = $kit->erc721($contractAddr)
              ->getTransferEvents(                           //查询到账事件
                [],                                          //转出账号,空数组表示不要求特定的转出账号 
                ['0x90F8bf6...0e7944Ea8c9C1'],               //接收账号,仅查询地址0x90F8...的到账事件
                $height-1000,                                //查询起始区块号
                $height                                      //查询结束区块号
              );                              

foreach($events as $event){                                   
  echo 'block => ' . $event->blockNumber . PHP_EOL;            //事件发生区块号
  echo 'from => ' . $event->params['from'] . PHP_EOL;          //转出账号
  echo 'to => ' . $event->params['to'] . PHP_EOL;              //转入账号
  echo 'tokenId => ' . $event->params['tokenId'] . PHP_EOL;    //转让的NFT编号
}

3.9 ERC1155转帐

使用Kit对象的erc1155()方法获取指定ERC1155合约实例,然后调用合约 的safeTransferFrom()方法进行ERC1155转账。例如,下面的代码 指定地址间转帐编号为1的ERC1155 NFT(合约地址:
0xafefbbab1038a4fd475d685c11b07bd697e20e38):

//use polygonKit;

$from = $kit->getSender();                                    //转出地址                                    
$to = '0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1';           //目标地址
$tokenId = 1;                                                 //转让的通证编号
$value = 1000000;                                             //转让数量
$contractAddr = '0xafefbbab1038a4fd475d685c11b07bd697e20e38'; //ERC1155合约的部署地址
$txid = $kit->erc1155($contractAddr)
            ->safeTransferFrom($from, $to,$tokenId, $value);  //转让指定的ERC1155通证
echo 'txid => ' . $txid .  PHP_EOL;                           //显示交易ID

3.10 ERC1155查询

使用Kit对象的erc1155()方法获取指定ERC1155合约实例后,可以调用合约的balanceOf()方法 查询用户持有的ERC1155通证数量。例如:

//use PolygonKit;

$contractAddr = '0xafefbbab1038a4fd475d685c11b07bd697e20e38';  //ERC1155合约的部署地址
$mt = $kit->erc1155($contractAddr);                            //返回合约实例 

$user = '0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1';          //用户地址
$tokenId = 1;                                                  //通证编号
echo 'banalce => ' . $mt->balanceOf($user, $tokenId);          //用户持有的指定编号通证的数量

3.11 ERC1155到账跟踪

使用Kit对象的erc1155()方法获取指定的ERC1155合约实例,然后调用 合约实例的getTransferEvents()方法查询指定条件的转账事件。

可以使用getTransferEvents()方法跟踪指定地址的到账状态。 例如查询地址0x90F8...在最近1000个区块的指定ERC1155通证到账事件:

//use polygonKit;

$height = $kit->getBlockHeight();
$contractAddr = '0xafefbbab1038a4fd475d685c11b07bd697e20e38';  //ERC1155合约的部署地址
$events = $kit->erc1155($contractAddr)
              ->getTransferEvents(                           //查询到账事件
                [],                                          //转出账号,空数组表示不要求特定的转出账号 
                ['0x90F8bf6...0e7944Ea8c9C1'],               //接收账号,仅查询地址0x90F8...的到账事件
                $height-1000,                                //查询起始区块号
                $height                                      //查询结束区块号
              );                              

foreach($events as $event){                                   
  echo 'block => ' . $event->blockNumber . PHP_EOL;            //事件发生区块号
  echo 'from => ' . $event->params['from'] . PHP_EOL;          //转出账号
  echo 'to => ' . $event->params['to'] . PHP_EOL;              //转入账号
  echo 'id => ' . $event->params['id'] . PHP_EOL;              //转让的通证编号
  echo 'value => ' . $event->params['value'] . PHP_EOL;        //转让的通证数量
}

4、Polygon区块链身份与地址表示

在Polygon PHP开发包中,使用Credential对象表征区块链上的一个用户身份,使用普通的 字符串表征区块链上的一个地址,这两者的区别在于Credential包含了用户 的私钥信息,可以用来签名交易,因此需要保护。

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

//use polygonCredential;

$credential = Credential::create();                              //创建新账号
echo 'private key => ' . $credential->getPrivateKey() . PHP_EOL; //显示私钥
echo 'public key => ' . $credential->getPublicKey() . PHP_EOL;   //显示公钥
echo 'address => ' . $credential->getAddress() . PHP_EOL;        //显示地址

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

//use polygonCredential;

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

5、使用NodeClient

NodeClient类封装了Polygon节点的RPC访问协议。实例化NodeClient时,需要指定要连接 的节点URL,例如使用本地的全节点:

//use polygonNodeClient;

$client = new NodeClient('http://localhost:8545');

当使用Polygon官方节点时,NodeClient类也提供列两个静态函数mainNet()和testNet(),分别 用于接入官方提供的主链节点和测试链节点。

例如,下面的代码是等效的:

//use polygonNodeClient;

$client = new NodeClient('https://rpc-mainnet.maticvigil.com');
$tc = NodeClient::mainNet();                       //与上面等效

$tc = new NodeClient('https://rpc-mumbai.maticvigil.com');
$tc = NodeClient::testNet();                       //与上面等效

原文链接:
http://sc.hubwiz.com/codebag/polygon-php/



Tags:PHP开发包   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,如有任何标注错误或版权侵犯请与我们联系(Email:2595517585@qq.com),我们将及时更正、删除,谢谢。
▌相关推荐
Polygon PHP开发包适用于为PHP应用快速增加对Polygon区块链数字资产的支持能力, 即支持使用自有Polygon区块链节点的应用场景,也支持基于Polygon区块链官方节点API服务的 轻量...【详细内容】
2022-04-06  Tags: PHP开发包  点击:(0)  评论:(0)  加入收藏
▌简易百科推荐
Polygon PHP开发包适用于为PHP应用快速增加对Polygon区块链数字资产的支持能力, 即支持使用自有Polygon区块链节点的应用场景,也支持基于Polygon区块链官方节点API服务的 轻量...【详细内容】
2022-04-06  新缸中之脑    Tags:PHP开发包   点击:(0)  评论:(0)  加入收藏
php脚本执行定时任务的流程1:swoole框架tick一个定时任务2:shell脚本来操作操作这个任务的启动,暂停,关闭,伪代码:sh shell文件3:web中利用PHP来执行shell命令整个闭环形成,可以在ph...【详细内容】
2022-03-11  老孟编程    Tags:PHP   点击:(27)  评论:(0)  加入收藏
回答本书的几个问题吧。你到底,为什么要学习PHP? 全国都缺PHP人才,非常好就业,PHP现在的工资水平很高,刚毕业可以拿到5000-9000每个月,特别优秀还可以破万。并且有非常多的就业机...【详细内容】
2022-03-04  anan40000    Tags:PHP   点击:(34)  评论:(0)  加入收藏
环境Thinkphp6.0.12LTS(目前最新版本);PHP7.3.4。安装composer create-project topthink/think tp6测试代码 漏洞分析漏洞起点不是__desturct就是__wakeup全局搜索下,起点在ve...【详细内容】
2022-02-28  KaliMa    Tags:Thinkphp   点击:(50)  评论:(0)  加入收藏
前端代码```<!doctype html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport"content="width=device-width, user-scalable=no, initial-scale=1.0, max...【详细内容】
2022-02-22  It健身    Tags:php   点击:(47)  评论:(0)  加入收藏
Php是不是彻底凉了?我相信有很多人是图着这句话来的,虽然一直不明白那群人为什么要唱衰php,实在是没搞定深层次的利益关系,不过本文不是探讨此问题的,本文为伊凡向一颗优雅草科技...【详细内容】
2022-01-24  一颗优雅草科技    Tags:php框架   点击:(58)  评论:(0)  加入收藏
PHP作为Web界第一大语言近年来热度不够,但是这几年的进步和成长却没有中断。在2022伊始,我们来一起学习一下目前PHP的现状以及最新版本带来的特性。 PHP 8.1PHP最新的8.0版本...【详细内容】
2022-01-14  虫虫安全    Tags:PHP   点击:(174)  评论:(0)  加入收藏
欢迎使用 Tpflow V6.0 工作流引擎 TpFlow工作流引擎是一套规范化的流程管理系统,基于业务而驱动系统生命力的一套引擎。彻底释放整个信息管理系统的的活力,让系统更具可用性,...【详细内容】
2021-12-31  Phpchina    Tags:PHP   点击:(95)  评论:(0)  加入收藏
序言:前段时间织梦因为版权的问题在网上闹得沸沸扬扬,也提醒了众多开发者选择cms上应该谨慎使用,今天给大家展示一款自己搭建的内容管理系统,不用担心版权的问题,而且非常容易维...【详细内容】
2021-11-30  小程序软件开发    Tags:管理系统   点击:(107)  评论:(0)  加入收藏
准备安装包(PHP: Hypertext Preprocessor)下载安装包以及组件wget https://www.php.net/distributions/php-8.0.0.tar.bz2wget https://github.com/phpredis/phpredis/archive...【详细内容】
2021-11-09  mimic96    Tags:PHP   点击:(1688)  评论:(0)  加入收藏
相关文章
    无相关信息
最新更新
栏目热门
栏目头条