539 lines
16 KiB
PHP
539 lines
16 KiB
PHP
<?php
|
|
|
|
/**
|
|
* This file is part of web3.php package.
|
|
*
|
|
* (c) Kuan-Cheng,Lai <alk03073135@gmail.com>
|
|
*
|
|
* @author Peter Lai <alk03073135@gmail.com>
|
|
* @license MIT
|
|
*/
|
|
|
|
namespace Web3;
|
|
|
|
use RuntimeException;
|
|
use InvalidArgumentException;
|
|
use stdClass;
|
|
use kornrunner\Keccak;
|
|
use phpseclib\Math\BigInteger as BigNumber;
|
|
|
|
class Utils
|
|
{
|
|
/**
|
|
* SHA3_NULL_HASH
|
|
*
|
|
* @const string
|
|
*/
|
|
const SHA3_NULL_HASH = 'c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470';
|
|
|
|
/**
|
|
* UNITS
|
|
* from ethjs-unit
|
|
*
|
|
* @const array
|
|
*/
|
|
const UNITS = [
|
|
'noether' => '0',
|
|
'wei' => '1',
|
|
'kwei' => '1000',
|
|
'Kwei' => '1000',
|
|
'babbage' => '1000',
|
|
'femtoether' => '1000',
|
|
'mwei' => '1000000',
|
|
'Mwei' => '1000000',
|
|
'lovelace' => '1000000',
|
|
'picoether' => '1000000',
|
|
'gwei' => '1000000000',
|
|
'Gwei' => '1000000000',
|
|
'shannon' => '1000000000',
|
|
'nanoether' => '1000000000',
|
|
'nano' => '1000000000',
|
|
'szabo' => '1000000000000',
|
|
'microether' => '1000000000000',
|
|
'micro' => '1000000000000',
|
|
'finney' => '1000000000000000',
|
|
'milliether' => '1000000000000000',
|
|
'milli' => '1000000000000000',
|
|
'ether' => '1000000000000000000',
|
|
'kether' => '1000000000000000000000',
|
|
'grand' => '1000000000000000000000',
|
|
'mether' => '1000000000000000000000000',
|
|
'gether' => '1000000000000000000000000000',
|
|
'tether' => '1000000000000000000000000000000'
|
|
];
|
|
|
|
/**
|
|
* NEGATIVE1
|
|
* Cannot work, see: http://php.net/manual/en/language.constants.syntax.php
|
|
*
|
|
* @const
|
|
*/
|
|
// const NEGATIVE1 = new BigNumber(-1);
|
|
|
|
/**
|
|
* construct
|
|
*
|
|
* @return void
|
|
*/
|
|
// public function __construct() {}
|
|
|
|
/**
|
|
* toHex
|
|
* Encoding string or integer or numeric string(is not zero prefixed) or big number to hex.
|
|
*
|
|
* @param string|int|BigNumber $value
|
|
* @param bool $isPrefix
|
|
* @return string
|
|
*/
|
|
public static function toHex($value, $isPrefix=false)
|
|
{
|
|
if (is_numeric($value)) {
|
|
// turn to hex number
|
|
$bn = self::toBn($value);
|
|
$hex = $bn->toHex(true);
|
|
$hex = preg_replace('/^0+(?!$)/', '', $hex);
|
|
} elseif (is_string($value)) {
|
|
$value = self::stripZero($value);
|
|
$hex = implode('', unpack('H*', $value));
|
|
} elseif ($value instanceof BigNumber) {
|
|
$hex = $value->toHex(true);
|
|
$hex = preg_replace('/^0+(?!$)/', '', $hex);
|
|
} else {
|
|
throw new InvalidArgumentException('The value to toHex function is not support.');
|
|
}
|
|
if ($isPrefix) {
|
|
return '0x' . $hex;
|
|
}
|
|
return $hex;
|
|
}
|
|
|
|
/**
|
|
* hexToBin
|
|
*
|
|
* @param string
|
|
* @return string
|
|
*/
|
|
public static function hexToBin($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to hexToBin function must be string.');
|
|
}
|
|
if (self::isZeroPrefixed($value)) {
|
|
$count = 1;
|
|
$value = str_replace('0x', '', $value, $count);
|
|
}
|
|
return pack('H*', $value);
|
|
}
|
|
|
|
/**
|
|
* isZeroPrefixed
|
|
*
|
|
* @param string
|
|
* @return bool
|
|
*/
|
|
public static function isZeroPrefixed($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to isZeroPrefixed function must be string.');
|
|
}
|
|
return (strpos($value, '0x') === 0);
|
|
}
|
|
|
|
/**
|
|
* stripZero
|
|
*
|
|
* @param string $value
|
|
* @return string
|
|
*/
|
|
public static function stripZero($value)
|
|
{
|
|
if (self::isZeroPrefixed($value)) {
|
|
$count = 1;
|
|
return str_replace('0x', '', $value, $count);
|
|
}
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* isNegative
|
|
*
|
|
* @param string
|
|
* @return bool
|
|
*/
|
|
public static function isNegative($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to isNegative function must be string.');
|
|
}
|
|
return (strpos($value, '-') === 0);
|
|
}
|
|
|
|
/**
|
|
* isAddress
|
|
*
|
|
* @param string $value
|
|
* @return bool
|
|
*/
|
|
public static function isAddress($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to isAddress function must be string.');
|
|
}
|
|
if (preg_match('/^(0x|0X)?[a-f0-9A-F]{40}$/', $value) !== 1) {
|
|
return false;
|
|
} elseif (preg_match('/^(0x|0X)?[a-f0-9]{40}$/', $value) === 1 || preg_match('/^(0x|0X)?[A-F0-9]{40}$/', $value) === 1) {
|
|
return true;
|
|
}
|
|
return self::isAddressChecksum($value);
|
|
}
|
|
|
|
/**
|
|
* isAddressChecksum
|
|
*
|
|
* @param string $value
|
|
* @return bool
|
|
*/
|
|
public static function isAddressChecksum($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to isAddressChecksum function must be string.');
|
|
}
|
|
$value = self::stripZero($value);
|
|
$hash = self::stripZero(self::sha3(mb_strtolower($value)));
|
|
|
|
for ($i = 0; $i < 40; $i++) {
|
|
if (
|
|
(intval($hash[$i], 16) > 7 && mb_strtoupper($value[$i]) !== $value[$i]) ||
|
|
(intval($hash[$i], 16) <= 7 && mb_strtolower($value[$i]) !== $value[$i])
|
|
) {
|
|
return false;
|
|
}
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* isHex
|
|
*
|
|
* @param string $value
|
|
* @return bool
|
|
*/
|
|
public static function isHex($value)
|
|
{
|
|
return (is_string($value) && preg_match('/^(0x)?[a-f0-9]*$/', $value) === 1);
|
|
}
|
|
|
|
/**
|
|
* sha3
|
|
* keccak256
|
|
*
|
|
* @param string $value
|
|
* @return string
|
|
*/
|
|
public static function sha3($value)
|
|
{
|
|
if (!is_string($value)) {
|
|
throw new InvalidArgumentException('The value to sha3 function must be string.');
|
|
}
|
|
if (strpos($value, '0x') === 0) {
|
|
$value = self::hexToBin($value);
|
|
}
|
|
$hash = Keccak::hash($value, 256);
|
|
|
|
if ($hash === self::SHA3_NULL_HASH) {
|
|
return null;
|
|
}
|
|
return '0x' . $hash;
|
|
}
|
|
|
|
/**
|
|
* toString
|
|
*
|
|
* @param mixed $value
|
|
* @return string
|
|
*/
|
|
public static function toString($value)
|
|
{
|
|
$value = (string) $value;
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* toWei
|
|
* Change number from unit to wei.
|
|
* For example:
|
|
* $wei = Utils::toWei('1', 'kwei');
|
|
* $wei->toString(); // 1000
|
|
*
|
|
* @param BigNumber|string|int $number
|
|
* @param string $unit
|
|
* @return \phpseclib\Math\BigInteger
|
|
*/
|
|
public static function toWei($number, $unit)
|
|
{
|
|
$bn = self::toBn($number);
|
|
|
|
if (!is_string($unit)) {
|
|
throw new InvalidArgumentException('toWei unit must be string.');
|
|
}
|
|
if (!isset(self::UNITS[$unit])) {
|
|
throw new InvalidArgumentException('toWei doesn\'t support ' . $unit . ' unit.');
|
|
}
|
|
$bnt = new BigNumber(self::UNITS[$unit]);
|
|
|
|
if (is_array($bn)) {
|
|
// fraction number
|
|
list($whole, $fraction, $negative1) = $bn;
|
|
|
|
$fractionLength = strlen($fraction->toString());
|
|
|
|
if ($fractionLength > strlen(self::UNITS[$unit])) {
|
|
throw new InvalidArgumentException('toWei fraction part is out of limit.');
|
|
}
|
|
$whole = $whole->multiply($bnt);
|
|
|
|
// There is no pow function in phpseclib 2.0, only can see in dev-master
|
|
// Maybe implement own biginteger in the future
|
|
// See 2.0 BigInteger: https://github.com/phpseclib/phpseclib/blob/2.0/phpseclib/Math/BigInteger.php
|
|
// See dev-master BigInteger: https://github.com/phpseclib/phpseclib/blob/master/phpseclib/Math/BigInteger.php#L700
|
|
// $base = (new BigNumber(10))->pow(new BigNumber($fractionLength));
|
|
|
|
// So we switch phpseclib special global param, change in the future
|
|
switch (MATH_BIGINTEGER_MODE) {
|
|
case $whole::MODE_GMP:
|
|
static $two;
|
|
$powerBase = gmp_pow(gmp_init(10), (int) $fractionLength);
|
|
break;
|
|
case $whole::MODE_BCMATH:
|
|
$powerBase = bcpow('10', (string) $fractionLength, 0);
|
|
break;
|
|
default:
|
|
$powerBase = pow(10, (int) $fractionLength);
|
|
break;
|
|
}
|
|
$base = new BigNumber($powerBase);
|
|
$fraction = $fraction->multiply($bnt)->divide($base)[0];
|
|
|
|
if ($negative1 !== false) {
|
|
return $whole->add($fraction)->multiply($negative1);
|
|
}
|
|
return $whole->add($fraction);
|
|
}
|
|
|
|
return $bn->multiply($bnt);
|
|
}
|
|
|
|
/**
|
|
* toEther
|
|
* Change number from unit to ether.
|
|
* For example:
|
|
* list($bnq, $bnr) = Utils::toEther('1', 'kether');
|
|
* $bnq->toString(); // 1000
|
|
*
|
|
* @param BigNumber|string|int $number
|
|
* @param string $unit
|
|
* @return array
|
|
*/
|
|
public static function toEther($number, $unit)
|
|
{
|
|
// if ($unit === 'ether') {
|
|
// throw new InvalidArgumentException('Please use another unit.');
|
|
// }
|
|
$wei = self::toWei($number, $unit);
|
|
$bnt = new BigNumber(self::UNITS['ether']);
|
|
|
|
return $wei->divide($bnt);
|
|
}
|
|
|
|
/**
|
|
* fromWei
|
|
* Change number from wei to unit.
|
|
* For example:
|
|
* list($bnq, $bnr) = Utils::fromWei('1000', 'kwei');
|
|
* $bnq->toString(); // 1
|
|
*
|
|
* @param BigNumber|string|int $number
|
|
* @param string $unit
|
|
* @return \phpseclib\Math\BigInteger
|
|
*/
|
|
public static function fromWei($number, $unit)
|
|
{
|
|
$bn = self::toBn($number);
|
|
|
|
if (!is_string($unit)) {
|
|
throw new InvalidArgumentException('fromWei unit must be string.');
|
|
}
|
|
if (!isset(self::UNITS[$unit])) {
|
|
throw new InvalidArgumentException('fromWei doesn\'t support ' . $unit . ' unit.');
|
|
}
|
|
$bnt = new BigNumber(self::UNITS[$unit]);
|
|
|
|
return $bn->divide($bnt);
|
|
}
|
|
|
|
/**
|
|
* jsonMethodToString
|
|
*
|
|
* @param stdClass|array $json
|
|
* @return string
|
|
*/
|
|
public static function jsonMethodToString($json)
|
|
{
|
|
if ($json instanceof stdClass) {
|
|
// one way to change whole json stdClass to array type
|
|
// $jsonString = json_encode($json);
|
|
|
|
// if (JSON_ERROR_NONE !== json_last_error()) {
|
|
// throw new InvalidArgumentException('json_decode error: ' . json_last_error_msg());
|
|
// }
|
|
// $json = json_decode($jsonString, true);
|
|
|
|
// another way to change whole json to array type but need the depth
|
|
// $json = self::jsonToArray($json, $depth)
|
|
|
|
// another way to change json to array type but not whole json stdClass
|
|
$json = (array) $json;
|
|
$typeName = [];
|
|
|
|
foreach ($json['inputs'] as $param) {
|
|
if (isset($param->type)) {
|
|
$typeName[] = $param->type;
|
|
}
|
|
}
|
|
return $json['name'] . '(' . implode(',', $typeName) . ')';
|
|
} elseif (!is_array($json)) {
|
|
throw new InvalidArgumentException('jsonMethodToString json must be array or stdClass.');
|
|
}
|
|
if (isset($json['name']) && strpos($json['name'], '(') > 0) {
|
|
return $json['name'];
|
|
}
|
|
$typeName = [];
|
|
|
|
foreach ($json['inputs'] as $param) {
|
|
if (isset($param['type'])) {
|
|
$typeName[] = $param['type'];
|
|
}
|
|
}
|
|
return $json['name'] . '(' . implode(',', $typeName) . ')';
|
|
}
|
|
|
|
/**
|
|
* jsonToArray
|
|
*
|
|
* @param stdClass|array|string $json
|
|
* @param int $depth
|
|
* @return array
|
|
*/
|
|
public static function jsonToArray($json, $depth=1)
|
|
{
|
|
if (!is_int($depth) || $depth <= 0) {
|
|
throw new InvalidArgumentException('jsonToArray depth must be int and depth must bigger than 0.');
|
|
}
|
|
if ($json instanceof stdClass) {
|
|
$json = (array) $json;
|
|
$typeName = [];
|
|
|
|
if ($depth > 1) {
|
|
foreach ($json as $key => $param) {
|
|
if (is_array($param)) {
|
|
foreach ($param as $subKey => $subParam) {
|
|
$json[$key][$subKey] = self::jsonToArray($subParam, $depth-1);
|
|
}
|
|
} elseif ($param instanceof stdClass) {
|
|
$json[$key] = self::jsonToArray($param, $depth-1);
|
|
}
|
|
}
|
|
}
|
|
return $json;
|
|
} elseif (is_array($json)) {
|
|
if ($depth > 1) {
|
|
foreach ($json as $key => $param) {
|
|
if (is_array($param)) {
|
|
foreach ($param as $subKey => $subParam) {
|
|
$json[$key][$subKey] = self::jsonToArray($subParam, $depth-1);
|
|
}
|
|
} elseif ($param instanceof stdClass) {
|
|
$json[$key] = self::jsonToArray($param, $depth-1);
|
|
}
|
|
}
|
|
}
|
|
} elseif (is_string($json)) {
|
|
$json = json_decode($json, true);
|
|
|
|
if (JSON_ERROR_NONE !== json_last_error()) {
|
|
throw new InvalidArgumentException('json_decode error: ' . json_last_error_msg());
|
|
}
|
|
return $json;
|
|
} else {
|
|
throw new InvalidArgumentException('The json param to jsonToArray must be array or stdClass or string.');
|
|
}
|
|
return $json;
|
|
}
|
|
|
|
/**
|
|
* toBn
|
|
* Change number or number string to bignumber.
|
|
*
|
|
* @param BigNumber|string|int $number
|
|
* @return array|\phpseclib\Math\BigInteger
|
|
*/
|
|
public static function toBn($number)
|
|
{
|
|
if ($number instanceof BigNumber){
|
|
$bn = $number;
|
|
} elseif (is_int($number)) {
|
|
$bn = new BigNumber($number);
|
|
} elseif (is_numeric($number)) {
|
|
$number = (string) $number;
|
|
|
|
if (self::isNegative($number)) {
|
|
$count = 1;
|
|
$number = str_replace('-', '', $number, $count);
|
|
$negative1 = new BigNumber(-1);
|
|
}
|
|
if (strpos($number, '.') > 0) {
|
|
$comps = explode('.', $number);
|
|
|
|
if (count($comps) > 2) {
|
|
throw new InvalidArgumentException('toBn number must be a valid number.');
|
|
}
|
|
$whole = $comps[0];
|
|
$fraction = $comps[1];
|
|
|
|
return [
|
|
new BigNumber($whole),
|
|
new BigNumber($fraction),
|
|
isset($negative1) ? $negative1 : false
|
|
];
|
|
} else {
|
|
$bn = new BigNumber($number);
|
|
}
|
|
if (isset($negative1)) {
|
|
$bn = $bn->multiply($negative1);
|
|
}
|
|
} elseif (is_string($number)) {
|
|
$number = mb_strtolower($number);
|
|
|
|
if (self::isNegative($number)) {
|
|
$count = 1;
|
|
$number = str_replace('-', '', $number, $count);
|
|
$negative1 = new BigNumber(-1);
|
|
}
|
|
if (self::isZeroPrefixed($number) || preg_match('/[a-f]+/', $number) === 1) {
|
|
$number = self::stripZero($number);
|
|
$bn = new BigNumber($number, 16);
|
|
} elseif (empty($number)) {
|
|
$bn = new BigNumber(0);
|
|
} else {
|
|
throw new InvalidArgumentException('toBn number must be valid hex string.');
|
|
}
|
|
if (isset($negative1)) {
|
|
$bn = $bn->multiply($negative1);
|
|
}
|
|
} else {
|
|
throw new InvalidArgumentException('toBn number must be BigNumber, string or int.');
|
|
}
|
|
return $bn;
|
|
}
|
|
} |