digitaldonkey/ethereum-php

A library integrating Ethereum with typed PHP.

Ethereum-PHP

is a typed PHP-7.1+ interface to Ethereum JSON-RPC API., _(*1)

Check out the latest API documentation., _(*2)

Add library in a composer.json file

{
  "minimum-stability":"dev",
  "autoload": {
    "psr-4": {
      "Ethereum\\": "src/"
    }
  },
  "repositories": [
    {
      "type": "git",
      "url": "https://github.com/digitaldonkey/ethereum-php.git"
    }
  ],
  "require": {
    "digitaldonkey/ethereum-php": "dev-master"
  }
}

Usage

composer require digitaldonkey/ethereum-php

This is the important part of composer.json in Drupal Ethereum Module., _(*3)

require __DIR__ . '/vendor/autoload.php';
use Ethereum\Ethereum;

try {
    // Connect to Ganache
    $eth = new Ethereum('http://127.0.0.1:7545');
    // Should return Int 63
    echo $eth->eth_protocolVersion()->val();
}
catch (\Exception $exception) {
    die ("Unable to connect.");
}

Calling Contracts, _(*4)

You can call (unpayed) functions in smart contracts easily., _(*5)

The json file "$fileName" used is what you get when you compile a contract with Truffle., _(*6)

$ContractMeta = json_decode(file_get_contents($fileName));
$contract = new SmartContract(
  $ContractMeta->abi,
  $ContractMeta->networks->{NETWORK_ID}->address,
  new Ethereum(SERVER_URL)
);
$someBytes = new EthBytes('34537ce3a455db6b')
$x = $contract->myContractMethod();
echo $x->val()

You can also run tests at smart contracts, check out EthTestClient., _(*7)

Event listening and handling

You can use Ethereum-PHP to watch changed on your smart contracts or index a Blockchain block by block. gs, _(*8)

See UsingFilters and ethereum-php-eventlistener., _(*9)

Limitations

Currently not all datatypes are supported., _(*10)

This library is read-only for now. This means you can retrieve information stored in Ethereum Blockchain., _(*11)

To write to the blockchain you need a to sign transactions with a private key which is not supported yet., _(*12)

, _(*13)

Documentation

The API documentation is available at ethereum-php.org., _(*14)

For reference see the Ethereum RPC documentation and for data encoding RLP dcumentation in Ethereum Wiki., _(*15)

There is also a more readable Ethereum Frontier Guide version., _(*16)