BitWasp\Bitcoin\Network\Network

Complexity

Total Complexity

29

Size/Duplication

Total Lines	225
Duplicated Lines	0 %

Coupling/Cohesion

Components	4
Dependencies	4

Test Coverage

Coverage

96.3%

Importance

Changes	1
Bugs	0	Features	0

16 Methods

Rating	Name	Duplication	Size	Complexity
A	validateHexString()	0	10	4
B	__construct()	0	18	5
A	hasBase58Prefix()	0	4	1
A	getBase58Prefix()	0	7	2
A	hasBech32Prefix()	0	4	1
A	getBech32Prefix()	0	7	2
A	hasBip32Prefix()	0	4	1
A	getBip32Prefix()	0	7	2
A	getSignedMessageMagic()	0	7	2
A	getNetMagicBytes()	0	7	2
A	getPrivByte()	0	7	2
A	getAddressByte()	0	4	1
A	getP2shByte()	0	4	1
A	getHDPubByte()	0	4	1
A	getHDPrivByte()	0	4	1
A	getSegwitBech32Prefix()	0	4	1

<?php

namespace BitWasp\Bitcoin\Network;

use BitWasp\Bitcoin\Exceptions\InvalidNetworkParameter;
use BitWasp\Bitcoin\Exceptions\MissingBase58Prefix;
use BitWasp\Bitcoin\Exceptions\MissingBech32Prefix;
use BitWasp\Bitcoin\Exceptions\MissingNetworkParameter;

class Network implements NetworkInterface
{

    const BECH32_PREFIX_SEGWIT = "segwit";

    const BASE58_PREFIX_P2PKH = "p2pkh";
    const BASE58_PREFIX_P2SH = "p2sh";

    const BIP32_PREFIX_XPUB = "xpub";
    const BIP32_PREFIX_XPRV = "xprv";

    /**
     * @var array map of base58 address type to byte
     */
    protected $base58PrefixMap = [];

    /**
     * @var array map of bech32 address type to HRP
     */
    protected $bech32PrefixMap = [];

    /**
     * @var array map of bip32 type to bytes
     */
    protected $bip32ByteMap = [];

    /**
     * @var array map of bip32 key type to script type
     */
    protected $bip32ScriptTypeMap = [];

    /**
     * @var string - single byte prefix for WIF encoding
     */
    protected $wifPrefix;

    /**
     * @var string - message prefix for bitcoin signed messages
     */
    protected $signedMessagePrefix;

    /**
     * @var string - 4 bytes for p2p magic
     */
    protected $p2pMagic;

    private function validateHexString($field, $value, $length)
    {
        if (!is_string($value) || strlen($value) !== 2 * $length) {
            throw new InvalidNetworkParameter("{$field} must be a {$length} byte hex string");
        }

        if (!ctype_xdigit($value)) {
            throw new InvalidNetworkParameter("{$field} prefix must be a valid hex string");
        }
    }

    public function __construct()
    {
        if (null !== $this->wifPrefix) {
            $this->validateHexString("WIF prefix", $this->wifPrefix, 1);
        }

        if (null !== $this->p2pMagic) {
            $this->validateHexString("P2P magic", $this->p2pMagic, 4);
        }

        foreach ($this->base58PrefixMap as $type => $byte) {
            $this->validateHexString("{$type} base58 prefix", $byte, 1);
        }

        foreach ($this->bip32ByteMap as $type => $bytes) {
            $this->validateHexString("{$type} bip32 prefix", $bytes, 4);
        }
    }

    /**
     * @param string $prefixType
     * @return bool
     */
    protected function hasBase58Prefix($prefixType)
    {
        return array_key_exists($prefixType, $this->base58PrefixMap);
    }

    /**
     * @param string $prefixType
     * @return string
     * @throws MissingBase58Prefix
     */
    protected function getBase58Prefix($prefixType)
    {
        if (!$this->hasBase58Prefix($prefixType)) {
            throw new MissingBase58Prefix();
        }
        return $this->base58PrefixMap[$prefixType];
    }

    /**
     * @param string $prefixType
     * @return bool
     */
    protected function hasBech32Prefix($prefixType)
    {
        return array_key_exists($prefixType, $this->bech32PrefixMap);
    }

    /**
     * @param string $prefixType
     * @return string
     * @throws MissingBech32Prefix
     */
    protected function getBech32Prefix($prefixType)
    {
        if (!$this->hasBase58Prefix($prefixType)) {
            throw new MissingBech32Prefix();
        }
        return $this->bech32PrefixMap[$prefixType];
    }

    /**
     * @param string $prefixType
     * @return bool
     */
    protected function hasBip32Prefix($prefixType)
    {
        return array_key_exists($prefixType, $this->bech32PrefixMap);
    }

    /**
     * @param string $prefixType
     * @return string
     * @throws MissingBech32Prefix
     */
    protected function getBip32Prefix($prefixType)
    {
        if (!$this->hasBase58Prefix($prefixType)) {
            throw new MissingBech32Prefix();
        }
        return $this->bech32PrefixMap[$prefixType];
    }

    /**
     * @return string
     * @throws MissingNetworkParameter
     */
    public function getSignedMessageMagic()
    {
        if (null === $this->signedMessagePrefix) {
            throw new MissingNetworkParameter("Missing magic string for signed message");
        }
        return $this->signedMessagePrefix;
    }

    /**
     * @return string
     * @throws MissingNetworkParameter
     */
    public function getNetMagicBytes()
    {
        if (null === $this->p2pMagic) {
            throw new MissingNetworkParameter("Missing network magic bytes");
        }
        return $this->p2pMagic;
    }

    /**
     * @return string
     * @throws MissingNetworkParameter
     */
    public function getPrivByte()
    {
        if (null === $this->wifPrefix) {
            throw new MissingNetworkParameter("Missing private key / WIF prefix");
        }
        return $this->wifPrefix;
    }

    /**
     * @inheritdoc
     */
    public function getAddressByte()
    {
        return $this->getBase58Prefix(self::BASE58_PREFIX_P2PKH);
    }

    /**
     * @inheritdoc
     */
    public function getP2shByte()
    {
        return $this->getBase58Prefix(self::BASE58_PREFIX_P2SH);
    }

    /**
     * Get version bytes for XPUB key
     *
     * @return string
     * @throws \Exception
     */
    public function getHDPubByte()
    {
        return $this->getBip32Prefix(self::BIP32_PREFIX_XPUB);
    }

    /**
     * Get version bytes for XPUB key
     *
     * @return string
     * @throws \Exception
     */
    public function getHDPrivByte()
    {
        return $this->getBip32Prefix(self::BIP32_PREFIX_XPRV);
    }

    /**
     * @return bool
     * @throws \Exception
     */
    public function getSegwitBech32Prefix()
    {
        return $this->getBech32Prefix(self::BECH32_PREFIX_SEGWIT);
    }
}