README

A php interface for interacting with the Ethereum blockchain and ecosystem.

Install

Set minimum stability to dev

"minimum-stability": "dev"

Then

composer require ethereum/web3p dev-master

Or you can add this line in composer.json

"ethereum/web3p": "dev-master"

Usage

New instance

use Ethereum\Web3\Web3;

$web3 = new Web3('http://localhost:8545');

Using provider

use Ethereum\Web3\Web3;
use Ethereum\Web3\Providers\HttpProvider;

$web3 = new Web3(new HttpProvider('http://localhost:8545'));

// timeout
$web3 = new Web3(new HttpProvider('http://localhost:8545', 0.1));

You can use callback to each rpc call:

$web3->clientVersion(function ($err, $version) {
    if ($err !== null) {
        // do something
        return;
    }
    if (isset($version)) {
        echo 'Client version: ' . $version;
    }
});

Async

use Ethereum\Web3\Web3;
use Ethereum\Web3\Providers\HttpAsyncProvider;

$web3 = new Web3(new HttpAsyncProvider('http://localhost:8545'));

// timeout
$web3 = new Web3(new HttpAsyncProvider('http://localhost:8545', 0.1));

// await
$promise = $web3->clientVersion(function ($err, $version) {
    // do somthing
});
Async\await($promise);

Websocket

use Ethereum\Web3\Web3;
use Ethereum\Web3\Providers\WsProvider;

$web3 = new Web3(new WsProvider('ws://localhost:8545'));

// timeout
$web3 = new Web3(new WsProvider('ws://localhost:8545', 0.1));

// await
$promise = $web3->clientVersion(function ($err, $version) {
    // do somthing
});
Async\await($promise);

// close connection
$web3->provider->close();

Eth

use Ethereum\Web3\Web3;

$web3 = new Web3('http://localhost:8545');
$eth = $web3->eth;

use Ethereum\Web3\Eth;

$eth = new Eth('http://localhost:8545');

Net

use Ethereum\Web3\Web3;

$web3 = new Web3('http://localhost:8545');
$net = $web3->net;

use Ethereum\Web3\Net;

$net = new Net('http://localhost:8545');

Batch

web3

$web3->batch(true);
$web3->clientVersion();
$web3->hash('0x1234');
$web3->execute(function ($err, $data) {
    if ($err !== null) {
        // do something
        // it may throw exception or array of exception depends on error type
        // connection error: throw exception
        // json rpc error: array of exception
        return;
    }
    // do something
});

eth

$eth->batch(true);
$eth->protocolVersion();
$eth->syncing();

$eth->provider->execute(function ($err, $data) {
    if ($err !== null) {
        // do something
        return;
    }
    // do something
});

net

$net->batch(true);
$net->version();
$net->listening();

$net->provider->execute(function ($err, $data) {
    if ($err !== null) {
        // do something
        return;
    }
    // do something
});

personal

$personal->batch(true);
$personal->listAccounts();
$personal->newAccount('123456');

$personal->provider->execute(function ($err, $data) {
    if ($err !== null) {
        // do something
        return;
    }
    // do something
});

Contract

use Ethereum\Web3\Contract;

$contract = new Contract('http://localhost:8545', $abi);

// deploy contract
$contract->bytecode($bytecode)->new($params, $callback);

// call contract function
$contract->at($contractAddress)->call($functionName, $params, $callback);

// change function state
$contract->at($contractAddress)->send($functionName, $params, $callback);

// estimate deploy contract gas
$contract->bytecode($bytecode)->estimateGas($params, $callback);

// estimate function gas
$contract->at($contractAddress)->estimateGas($functionName, $params, $callback);

// get constructor data
$constructorData = $contract->bytecode($bytecode)->getData($params);

// get function data
$functionData = $contract->at($contractAddress)->getData($functionName, $params);

Assign value to outside scope(from callback scope to outside scope)

Due to callback is not like javascript callback, if we need to assign value to outside scope, we need to assign reference to callback.

$newAccount = '';

$web3->personal->newAccount('123456', function ($err, $account) use (&$newAccount) {
    if ($err !== null) {
        echo 'Error: ' . $err->getMessage();
        return;
    }
    $newAccount = $account;
    echo 'New account: ' . $account . PHP_EOL;
});

Examples

To run examples, you need to run ethereum blockchain local (testrpc).

If you are using docker as development machain, you can try ethdock to run local ethereum blockchain, just simply run docker-compose up -d testrpc and expose the 8545 port.

Develop

Local php cli installed

Clone the repo and install packages.

git clone https://github.com/nizerin/web3p.git && cd web3p && composer install

Run test script.

vendor/bin/phpunit

Docker container

Clone the repo and run docker container.

git clone https://github.com/nizerin/web3p.git

Copy web3p to web3p/docker/app directory and start container.

cp files docker/app && docker-compose up -d php ganache

Enter php container and install packages.

docker-compose exec php ash

Change testHost in TestCase.php

/**
 * testHost
 * 
 * @var string
 */
protected $testHost = 'http://ganache:8545';

Run test script

vendor/bin/phpunit

Install packages

Enter container first

docker-compose exec php ash

apk add gmp-dev
docker-php-ext-install gmp

bcmath

docker-php-ext-install bcmath

Remove extension

Move the extension config from /usr/local/etc/php/conf.d/

mv /usr/local/etc/php/conf.d/extension-config-name to/directory

API

Todo.

Contribution

Thank you to all the people who already contributed to web3p!

License

MIT

ethereum / web3p

Maintainers

Details