PHPackages                             furqansiddiqui/erc20-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. furqansiddiqui/erc20-php

ActiveLibrary[API Development](/categories/api)

furqansiddiqui/erc20-php
========================

Interact with any ERC20 standard/backward-compatible Ethereum token

0.4.0(4mo ago)16467.4k↓40.9%954MITPHPCI passing

Since May 9Pushed 4mo ago20 watchersCompare

[ Source](https://github.com/furqansiddiqui/erc20-php)[ Packagist](https://packagist.org/packages/furqansiddiqui/erc20-php)[ RSS](/packages/furqansiddiqui-erc20-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (15)Used By (4)

ERC-20 Token Library for PHP
============================

[](#erc-20-token-library-for-php)

[![Tests](https://github.com/furqansiddiqui/erc20-php/actions/workflows/tests.yml/badge.svg)](https://github.com/furqansiddiqui/erc20-php/actions/workflows/tests.yml)[![MIT License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

A PHP library for interacting with ERC-20 smart contracts on the Ethereum blockchain. This library uses the [ethereum-php](https://github.com/furqansiddiqui/ethereum-php) package for RPC communication and EVM interactions.

Features
--------

[](#features)

- Fetch token metadata (name, symbol, decimals, total supply).
- Retrieve account balances and allowances.
- Encode data for standard ERC-20 transactions (`transfer`, `transferFrom`, `approve`).
- Support for custom/extended ERC-20 ABIs.
- Fully compatible with PHP 8.5+.

Requirements
------------

[](#requirements)

- **PHP:** ^8.5
- **Extensions:** `openssl`, `gmp`, `bcmath`

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require furqansiddiqui/erc20-php
```

Usage
-----

[](#usage)

### Initialization

[](#initialization)

To start, you need an Ethereum RPC client (e.g., Geth or an Infura/Alchemy endpoint) and the `Erc20` handler.

```
use FurqanSiddiqui\Ethereum\Rpc\GethRpc;
use FurqanSiddiqui\Ethereum\Erc20\Erc20;
use FurqanSiddiqui\Ethereum\Keypair\EthereumAddress;

$rpc = new GethRpc("https://mainnet.infura.io/v3/YOUR_PROJECT_ID");
$erc20 = new Erc20($rpc);

// USDC Token Address
$usdcAddress = new EthereumAddress("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48");
$token = $erc20->deployedAt($usdcAddress);
```

### Token Metadata

[](#token-metadata)

```
echo "Name: " . $token->name() . PHP_EOL;
echo "Symbol: " . $token->symbol() . PHP_EOL;
echo "Decimals: " . $token->decimals() . PHP_EOL;
echo "Total Supply: " . $token->totalSupply() . PHP_EOL;
```

### Balances and Allowances

[](#balances-and-allowances)

```
$userAddress = new EthereumAddress("0x...");

// Get raw balance (uint256)
$balance = $token->balanceOf($userAddress);
echo "Raw Balance: " . $balance . PHP_EOL;

// Get allowance
$spender = new EthereumAddress("0x...");
$allowance = $token->allowance($userAddress, $spender);
```

### Encoding Transactions

[](#encoding-transactions)

This library helps you encode the `data` field for Ethereum transactions.

```
// Encode a transfer of 100 USDC (USDC has 6 decimals)
$toAddress = "0x...";
$amount = 100 * (10 ** 6);
$data = $token->encodeTransfer($toAddress, $amount);

// You can now use this $data in an 'eth_sendTransaction' or 'eth_sendRawTransaction' call
```

Extending for Custom ABIs
-------------------------

[](#extending-for-custom-abis)

If you are dealing with a contract that follows ERC-20 but has additional methods, you can extend `Erc20ContractBase`.

```
use FurqanSiddiqui\Ethereum\Erc20\Erc20ContractBase;
use FurqanSiddiqui\Ethereum\Evm\ContractMethod;
use FurqanSiddiqui\Ethereum\Evm\ContractMethodType;
use FurqanSiddiqui\Ethereum\Evm\AbiParam;

class MyCustomTokenAbi extends Erc20ContractBase
{
    public function __construct()
    {
        parent::__construct();

        // Add a custom method: burn(uint256)
        $burn = new ContractMethod(ContractMethodType::Function, "burn", false, false);
        $burn->appendInput(new AbiParam("uint256", null));
        $this->append($burn);
    }
}

// Usage
$erc20 = new Erc20($rpc, new MyCustomTokenAbi());
```

Testing
-------

[](#testing)

The library includes a PHPUnit test suite. To run the tests, ensure you have dependencies installed:

```
composer install
./vendor/bin/phpunit
```

License
-------

[](#license)

This package is open-source software licensed under the [MIT license](LICENSE).

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance75

Regular maintenance activity

Popularity49

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 97.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~258 days

Recently: every ~482 days

Total

12

Last Release

136d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11485189?v=4)[M. Furqan Siddiqui](/maintainers/furqansiddiqui)[@furqansiddiqui](https://github.com/furqansiddiqui)

---

Top Contributors

[![furqansiddiqui](https://avatars.githubusercontent.com/u/11485189?v=4)](https://github.com/furqansiddiqui "furqansiddiqui (37 commits)")[![survivordj](https://avatars.githubusercontent.com/u/6272137?v=4)](https://github.com/survivordj "survivordj (1 commits)")

---

Tags

ethereumethgethethereum-goerc20erc223

### Embed Badge

![Health badge](/badges/furqansiddiqui-erc20-php/health.svg)

```
[![Health](https://phpackages.com/badges/furqansiddiqui-erc20-php/health.svg)](https://phpackages.com/packages/furqansiddiqui-erc20-php)
```

###  Alternatives

[furqansiddiqui/ethereum-rpc

Ethereum (geth) RPC client

2551.9k4](/packages/furqansiddiqui-ethereum-rpc)[drlecks/simple-web3-php

Web3 library in PHP

7744.0k2](/packages/drlecks-simple-web3-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)