PHP与以太坊钱包交易,实现与指南

• Infura：提供可靠的远程节点服务，无需自行搭建，适合开发和大多数生产场景，你需要注册Infura并获取一个项目ID。
• Alchemy：与Infura类似，提供高质量的以太坊节点服务。
• 本地节点：使用Geth或Parity等客户端搭建本地私有测试网或连接到主网，这种方式更灵活，但对服务器资源要求较高。

安装与配置Web3php

通过Composer可以轻松安装web3php：

composer require sc0vu/web3php

安装完成后,你可以在PHP代码中引入它：

require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Contract;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpManager;

核心步骤：发送以太坊（ETH）交易

下面我们以通过PHP发送一笔ETH交易为例,说明核心步骤。

连接到以太坊节点

$nodeUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID'; // 替换为你的Infura URL或其他节点URL
$web3 = new Web3(new HttpProvider(new HttpManager($nodeUrl)));
// 或者连接到本地节点
// $web3 = new Web3(new HttpProvider(new HttpManager('http://localhost:8545')));

准备交易参数

发送ETH交易需要以下关键信息：

• from：发送方地址（钱包地址）。
• to：接收方地址。
• value：发送的ETH数量，单位是wei（1 ETH = 10^18 wei）。
• gas：交易预计消耗的gas上限。
• gasPrice：gas价格，单位是wei。
• nonce：发送方账户的nonce值，用于防止交易重放，必须递增。

$fromAddress = '0xSenderAddress...'; // 发送方地址
$toAddress = '0xReceiverAddress...'; // 接收方地址
$privateKey = 'YOUR_SENDER_PRIVATE_KEY'; // 发送方私钥，**极度敏感，切勿泄露！**
$value = '1000000000000000000'; // 1 ETH in wei
$gas = '21000'; // 转账ETH的典型gas消耗
// 获取当前gas price
$web3->eth->gasPrice(function ($err, $gasPrice) use ($web3, $fromAddress, $toAddress, $value, $gas, $privateKey) {
    if ($err !== null) {
        echo "Error getting gas price: " . $err->getMessage();
        return;
    }
    $gasPrice = $gasPrice->toString();
    // 获取nonce
    $web3->eth->getTransactionCount($fromAddress, 'latest', function ($err, $nonce) use ($web3, $fromAddress, $toAddress, $value, $gas, $gasPrice, $privateKey) {
        if ($err !== null) {
            echo "Error getting nonce: " . $err->getMessage();
            return;
        }
        $nonce = $nonce->toString();
        // 构建交易数组
        $transaction = [
            'from' => $fromAddress,
            'to' => $toAddress,
            'value' => $value,
            'gas' => $gas,
            'gasPrice' => $gasPrice,
            'nonce' => $nonce,
        ];
        // 签名并发送交易
        $web3->eth->sendTransaction($transaction, $privateKey, function ($err, $txHash) {
            if ($err !== null) {
                echo "Error sending transaction: " . $err->getMessage();
                return;
            }
            echo "Transaction sent! Hash: " . $txHash . "\n";
        });
    });
});

签名与发送交易

在上面的代码中,我们使用了$web3->eth->sendTransaction($transaction, $privateKey, $callback)方法，这个方法会使用提供的私钥对交易进行签名，然后发送到以太坊网络。

检查交易状态

发送交易后,你可以通过交易哈希（txHash）在以太坊浏览器（如Etherscan）上查看交易状态，也可以使用web3php的eth_getTransactionReceipt方法来查询交易收据，确认交易是否被矿工打包。

$txHash = '0xYourTransactionHash...';
$web3->eth->getTransactionReceipt($txHash, function ($err, $receipt) {
    if ($err !== null) {
        echo "Error getting receipt: " . $err->getMessage();
        return;
    }
    if ($receipt) {
        echo "Transaction receipt: " . json_encode($receipt, JSON_PRETTY_PRINT) . "\n";
        if ($receipt->status === '0x1') {
            echo "Transaction successful!\n";
        } else {
            echo "Transaction failed.\n";
        }
    } else {
        echo "Transaction not yet mined.\n";
    }
});

发送ERC-20代币交易

发送ERC-20代币比发送ETH稍微复杂，因为它需要调用智能合约，web3php的Contract功能可以帮助我们完成。

1. 获取ERC-20代币合约ABI：ABI是应用程序二进制接口，定义了合约的函数和事件，你可以在Etherscan上找到代币合约的ABI。

2. 实例化合约：

   $tokenContractAddress = '0xTokenContractAddress...'; // ERC-20代币合约地址
   $tokenAbi = '[...你的ERC-20代币合约ABI...]'; // JSON格式的ABI字符串
   $contract = new Contract($web3->provider, $tokenAbi);
   $contract->at($tokenContractAddress);

3. 调用transfer函数： ERC-20代币的transfer函数通常需要两个参数：to（接收地址）和value（转账数量，单位是代币的最小单位，通常为18位小数）。

   $recipientAddress = '0xRecipientAddress...';
   $tokenAmount = '500000000000000000000'; // 例如500代币，假设18位小数
   // 构建调用数据
   $transferData = $contract->transfer($recipientAddress, $tokenAmount)->encodeParameters();
   // 发送交易（与ETH交易类似，但目标是代币合约）
   $transaction = [
       'from' => $fromAddress,
       'to' => $tokenContractAddress,
       'value' => '0x0', // 代币转账，value为0
       'gas' => '200000', // ERC-20 transfer通常需要更多gas
       'gasPrice' => $gasPrice, // 同样需要获取gasPrice
       'nonce' => $