aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/stephenhill/base58/src
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/stephenhill/base58/src')
-rw-r--r--vendor/stephenhill/base58/src/BCMathService.php165
-rw-r--r--vendor/stephenhill/base58/src/Base58.php90
-rw-r--r--vendor/stephenhill/base58/src/GMPService.php156
-rw-r--r--vendor/stephenhill/base58/src/ServiceInterface.php24
4 files changed, 435 insertions, 0 deletions
diff --git a/vendor/stephenhill/base58/src/BCMathService.php b/vendor/stephenhill/base58/src/BCMathService.php
new file mode 100644
index 000000000..329e1ceba
--- /dev/null
+++ b/vendor/stephenhill/base58/src/BCMathService.php
@@ -0,0 +1,165 @@
+<?php
+
+namespace StephenHill;
+
+use InvalidArgumentException;
+
+class BCMathService implements ServiceInterface
+{
+ /**
+ * @var string
+ * @since v1.1.0
+ */
+ protected $alphabet;
+
+ /**
+ * @var int
+ * @since v1.1.0
+ */
+ protected $base;
+
+ /**
+ * Constructor
+ *
+ * @param string $alphabet optional
+ * @since v1.1.0
+ */
+ public function __construct($alphabet = null)
+ {
+ // Handle null alphabet
+ if (is_null($alphabet) === true) {
+ $alphabet = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+ }
+
+ // Type validation
+ if (is_string($alphabet) === false) {
+ throw new InvalidArgumentException('Argument $alphabet must be a string.');
+ }
+
+ // The alphabet must contain 58 characters
+ if (strlen($alphabet) !== 58) {
+ throw new InvalidArgumentException('Argument $alphabet must contain 58 characters.');
+ }
+
+ $this->alphabet = $alphabet;
+ $this->base = strlen($alphabet);
+ }
+ /**
+ * Encode a string into base58.
+ *
+ * @param string $string The string you wish to encode.
+ * @since Release v1.1.0
+ * @return string The Base58 encoded string.
+ */
+ public function encode($string)
+ {
+ // Type validation
+ if (is_string($string) === false) {
+ throw new InvalidArgumentException('Argument $string must be a string.');
+ }
+
+ // If the string is empty, then the encoded string is obviously empty
+ if (strlen($string) === 0) {
+ return '';
+ }
+
+ // Strings in PHP are essentially 8-bit byte arrays
+ // so lets convert the string into a PHP array
+ $bytes = array_values(unpack('C*', $string));
+
+ // Now we need to convert the byte array into an arbitrary-precision decimal
+ // We basically do this by performing a base256 to base10 conversion
+ $decimal = $bytes[0];
+
+ for ($i = 1, $l = count($bytes); $i < $l; $i++) {
+ $decimal = bcmul($decimal, 256);
+ $decimal = bcadd($decimal, $bytes[$i]);
+ }
+
+ // This loop now performs base 10 to base 58 conversion
+ // The remainder or modulo on each loop becomes a base 58 character
+ $output = '';
+ while ($decimal >= $this->base) {
+ $div = bcdiv($decimal, $this->base, 0);
+ $mod = (int) bcmod($decimal, $this->base);
+ $output .= $this->alphabet[$mod];
+ $decimal = $div;
+ }
+
+ // If there's still a remainder, append it
+ if ($decimal > 0) {
+ $output .= $this->alphabet[$decimal];
+ }
+
+ // Now we need to reverse the encoded data
+ $output = strrev($output);
+
+ // Now we need to add leading zeros
+ foreach ($bytes as $byte) {
+ if ($byte === 0) {
+ $output = $this->alphabet[0] . $output;
+ continue;
+ }
+ break;
+ }
+
+ return (string) $output;
+ }
+
+ /**
+ * Decode base58 into a PHP string.
+ *
+ * @param string $base58 The base58 encoded string.
+ * @since Release v1.1.0
+ * @return string Returns the decoded string.
+ */
+ public function decode($base58)
+ {
+ // Type Validation
+ if (is_string($base58) === false) {
+ throw new InvalidArgumentException('Argument $base58 must be a string.');
+ }
+
+ // If the string is empty, then the decoded string is obviously empty
+ if (strlen($base58) === 0) {
+ return '';
+ }
+
+ $indexes = array_flip(str_split($this->alphabet));
+ $chars = str_split($base58);
+
+ // Check for invalid characters in the supplied base58 string
+ foreach ($chars as $char) {
+ if (isset($indexes[$char]) === false) {
+ throw new InvalidArgumentException('Argument $base58 contains invalid characters. ($char: "'.$char.'" | $base58: "'.$base58.'") ');
+ }
+ }
+
+ // Convert from base58 to base10
+ $decimal = $indexes[$chars[0]];
+
+ for ($i = 1, $l = count($chars); $i < $l; $i++) {
+ $decimal = bcmul($decimal, $this->base);
+ $decimal = bcadd($decimal, $indexes[$chars[$i]]);
+ }
+
+ // Convert from base10 to base256 (8-bit byte array)
+ $output = '';
+ while ($decimal > 0) {
+ $byte = (int) bcmod($decimal, 256);
+ $output = pack('C', $byte) . $output;
+ $decimal = bcdiv($decimal, 256, 0);
+ }
+
+ // Now we need to add leading zeros
+ foreach ($chars as $char) {
+ if ($indexes[$char] === 0) {
+ $output = "\x00" . $output;
+ continue;
+ }
+ break;
+ }
+
+ return $output;
+ }
+}
diff --git a/vendor/stephenhill/base58/src/Base58.php b/vendor/stephenhill/base58/src/Base58.php
new file mode 100644
index 000000000..75a2e0de4
--- /dev/null
+++ b/vendor/stephenhill/base58/src/Base58.php
@@ -0,0 +1,90 @@
+<?php
+
+namespace StephenHill;
+
+use InvalidArgumentException;
+
+/**
+ * @package StephenHill\Base58
+ * @author Stephen Hill <stephen@gatekiller.co.uk>
+ * @copyright 2014 Stephen Hill <stephen@gatekiller.co.uk>
+ * @license http://www.opensource.org/licenses/MIT The MIT License
+ * @link https://github.com/stephen-hill/base58php
+ * @since Release v1.0.0
+ */
+class Base58
+{
+ /**
+ * @var StephenHill\ServiceInterface;
+ * @since v1.1.0
+ */
+ protected $service;
+
+ /**
+ * Constructor
+ *
+ * @param string $alphabet optional
+ * @param ServiceInterface $service optional
+ * @since v1.0.0
+ * @since v1.1.0 Added the optional $service argument.
+ */
+ public function __construct(
+ $alphabet = null,
+ ServiceInterface $service = null
+ ) {
+ // Handle null alphabet
+ if (is_null($alphabet) === true) {
+ $alphabet = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+ }
+
+ // Type validation
+ if (is_string($alphabet) === false) {
+ throw new InvalidArgumentException('Argument $alphabet must be a string.');
+ }
+
+ // The alphabet must contain 58 characters
+ if (strlen($alphabet) !== 58) {
+ throw new InvalidArgumentException('Argument $alphabet must contain 58 characters.');
+ }
+
+ // Provide a default service if one isn't injected
+ if ($service === null) {
+ // Check for GMP support first
+ if (function_exists('\gmp_init') === true) {
+ $service = new GMPService($alphabet);
+ }
+ else if (function_exists('\bcmul') === true) {
+ $service = new BCMathService($alphabet);
+ }
+ else {
+ throw new \Exception('Please install the BC Math or GMP extension.');
+ }
+ }
+
+ $this->service = $service;
+ }
+
+ /**
+ * Encode a string into base58.
+ *
+ * @param string $string The string you wish to encode.
+ * @since v1.0.0
+ * @return string The Base58 encoded string.
+ */
+ public function encode($string)
+ {
+ return $this->service->encode($string);
+ }
+
+ /**
+ * Decode base58 into a PHP string.
+ *
+ * @param string $base58 The base58 encoded string.
+ * @since v1.0.0
+ * @return string Returns the decoded string.
+ */
+ public function decode($base58)
+ {
+ return $this->service->decode($base58);
+ }
+}
diff --git a/vendor/stephenhill/base58/src/GMPService.php b/vendor/stephenhill/base58/src/GMPService.php
new file mode 100644
index 000000000..0dde30594
--- /dev/null
+++ b/vendor/stephenhill/base58/src/GMPService.php
@@ -0,0 +1,156 @@
+<?php
+
+namespace StephenHill;
+
+use InvalidArgumentException;
+
+class GMPService implements ServiceInterface
+{
+ /**
+ * @var string
+ * @since v1.1.0
+ */
+ protected $alphabet;
+
+ /**
+ * @var int
+ * @since v1.1.0
+ */
+ protected $base;
+
+ /**
+ * Constructor
+ *
+ * @param string $alphabet optional
+ * @since v1.1.0
+ */
+ public function __construct($alphabet = null)
+ {
+ // Handle null alphabet
+ if (is_null($alphabet) === true) {
+ $alphabet = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+ }
+
+ // Type validation
+ if (is_string($alphabet) === false) {
+ throw new InvalidArgumentException('Argument $alphabet must be a string.');
+ }
+
+ // The alphabet must contain 58 characters
+ if (strlen($alphabet) !== 58) {
+ throw new InvalidArgumentException('Argument $alphabet must contain 58 characters.');
+ }
+
+ $this->alphabet = $alphabet;
+ $this->base = strlen($alphabet);
+ }
+ /**
+ * Encode a string into base58.
+ *
+ * @param string $string The string you wish to encode.
+ * @since Release v1.1.0
+ * @return string The Base58 encoded string.
+ */
+ public function encode($string)
+ {
+ // Type validation
+ if (is_string($string) === false) {
+ throw new InvalidArgumentException('Argument $string must be a string.');
+ }
+
+ // If the string is empty, then the encoded string is obviously empty
+ if (strlen($string) === 0) {
+ return '';
+ }
+
+ // Now we need to convert the byte array into an arbitrary-precision decimal
+ // We basically do this by performing a base256 to base10 conversion
+ $hex = unpack('H*', $string);
+ $hex = reset($hex);
+ $decimal = gmp_init($hex, 16);
+
+ // This loop now performs base 10 to base 58 conversion
+ // The remainder or modulo on each loop becomes a base 58 character
+ $output = '';
+ while (gmp_cmp($decimal, $this->base) >= 0) {
+ list($decimal, $mod) = gmp_div_qr($decimal, $this->base);
+ $output .= $this->alphabet[gmp_intval($mod)];
+ }
+
+ // If there's still a remainder, append it
+ if (gmp_cmp($decimal, 0) > 0) {
+ $output .= $this->alphabet[gmp_intval($decimal)];
+ }
+
+ // Now we need to reverse the encoded data
+ $output = strrev($output);
+
+ // Now we need to add leading zeros
+ $bytes = str_split($string);
+ foreach ($bytes as $byte) {
+ if ($byte === "\x00") {
+ $output = $this->alphabet[0] . $output;
+ continue;
+ }
+ break;
+ }
+
+ return (string) $output;
+ }
+
+ /**
+ * Decode base58 into a PHP string.
+ *
+ * @param string $base58 The base58 encoded string.
+ * @since Release v1.1.0
+ * @return string Returns the decoded string.
+ */
+ public function decode($base58)
+ {
+ // Type Validation
+ if (is_string($base58) === false) {
+ throw new InvalidArgumentException('Argument $base58 must be a string.');
+ }
+
+ // If the string is empty, then the decoded string is obviously empty
+ if (strlen($base58) === 0) {
+ return '';
+ }
+
+ $indexes = array_flip(str_split($this->alphabet));
+ $chars = str_split($base58);
+
+ // Check for invalid characters in the supplied base58 string
+ foreach ($chars as $char) {
+ if (isset($indexes[$char]) === false) {
+ throw new InvalidArgumentException('Argument $base58 contains invalid characters.');
+ }
+ }
+
+ // Convert from base58 to base10
+ $decimal = gmp_init($indexes[$chars[0]], 10);
+
+ for ($i = 1, $l = count($chars); $i < $l; $i++) {
+ $decimal = gmp_mul($decimal, $this->base);
+ $decimal = gmp_add($decimal, $indexes[$chars[$i]]);
+ }
+
+ // Convert from base10 to base256 (8-bit byte array)
+ $output = '';
+ while (gmp_cmp($decimal, 0) > 0) {
+ list($decimal, $byte) = gmp_div_qr($decimal, 256);
+ $output = pack('C', gmp_intval($byte)) . $output;
+ }
+
+ // Now we need to add leading zeros
+ foreach ($chars as $char) {
+ if ($indexes[$char] === 0) {
+ $output = "\x00" . $output;
+ continue;
+ }
+ break;
+ }
+
+ return $output;
+ }
+}
diff --git a/vendor/stephenhill/base58/src/ServiceInterface.php b/vendor/stephenhill/base58/src/ServiceInterface.php
new file mode 100644
index 000000000..0fe374524
--- /dev/null
+++ b/vendor/stephenhill/base58/src/ServiceInterface.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace StephenHill;
+
+interface ServiceInterface
+{
+ /**
+ * Encode a string into base58.
+ *
+ * @param string $string The string you wish to encode.
+ * @since v1.1.0
+ * @return string The Base58 encoded string.
+ */
+ public function encode($string);
+
+ /**
+ * Decode base58 into a PHP string.
+ *
+ * @param string $base58 The base58 encoded string.
+ * @since v1.1.0
+ * @return string Returns the decoded string.
+ */
+ public function decode($base58);
+}
generated by cgit v1.2.3 (git 2.25.1) at 2024-07-01 07:44:10 +0000