init

2025-10-09 17:41:57 +00:00
commit 7a3b2960f8
146 changed files with 34948 additions and 0 deletions
@@ -0,0 +1,144 @@
+<?php
+
+namespace Elliptic\EC;
+
+use BN\BN;
+
+class KeyPair
+{
+    public $ec;
+    public $pub;
+    public $priv;
+
+    function __construct($ec, #[\SensitiveParameter]
+                         $options)
+    {
+        $this->ec = $ec;
+
+        $this->priv = null;
+        $this->pub = null;
+
+        if( isset($options["priv"]) )
+            $this->_importPrivate($options["priv"], $options["privEnc"]);
+
+        if( isset($options["pub"]) )
+            $this->_importPublic($options["pub"], $options["pubEnc"]);
+    }
+
+    public static function fromPublic($ec, $pub, $enc)
+    {
+        if( $pub instanceof KeyPair )
+            return $pub;
+
+        return new KeyPair($ec, array(
+            "pub" => $pub,
+            "pubEnc" => $enc
+        ));
+    }
+
+    public static function fromPrivate($ec, #[\SensitiveParameter]
+                                       $priv, $enc)
+    {
+        if( $priv instanceof KeyPair )
+            return $priv;
+
+        return new KeyPair($ec, array(
+            "priv" => $priv,
+            "privEnc" => $enc
+        ));
+    }
+
+    public function validate()
+    {
+        $pub = $this->getPublic();
+
+        if( $pub->isInfinity() )
+            return array( "result" => false, "reason" => "Invalid public key" );
+
+        if( !$pub->validate() )
+            return array( "result" => false, "reason" => "Public key is not a point" );
+
+        if( !$pub->mul($this->ec->curve->n)->isInfinity() )
+            return array( "result" => false, "reason" => "Public key * N != O" );
+
+        return array( "result" => true, "reason" => null );
+    }
+
+    public function getPublic($compact = false, $enc = "")
+    {
+        //compact is optional argument
+        if( is_string($compact) )
+        {
+            $enc = $compact;
+            $compact = false;
+        }
+
+        if( $this->pub === null )
+            $this->pub = $this->ec->g->mul($this->priv);
+
+        if( !$enc )
+            return $this->pub;
+
+        return $this->pub->encode($enc, $compact);
+    }
+
+    public function getPrivate($enc = false)
+    {
+        if( $enc === "hex" )
+            return $this->priv->toString(16, 2);
+
+        return $this->priv;
+    }
+
+    private function _importPrivate(#[\SensitiveParameter]
+        $key, $enc)
+    {
+        $this->priv = new BN($key, (isset($enc) && $enc) ? $enc : 16);
+
+        // Ensure that the priv won't be bigger than n, otherwise we may fail
+        // in fixed multiplication method
+        $this->priv = $this->priv->umod($this->ec->curve->n);
+    }
+
+    private function _importPublic($key, $enc)
+    {
+        $x = $y = null;
+        if ( is_object($key) ) {
+            $x = $key->x;
+            $y = $key->y;
+        } elseif ( is_array($key) ) {
+            $x = isset($key["x"]) ? $key["x"] : null;
+            $y = isset($key["y"]) ? $key["y"] : null;
+        }
+
+        if( $x != null || $y != null )
+            $this->pub = $this->ec->curve->point($x, $y);
+        else
+            $this->pub = $this->ec->curve->decodePoint($key, $enc);
+    }
+
+    //ECDH
+    public function derive($pub) {
+        return $pub->mul($this->priv)->getX();
+    }
+
+    //ECDSA
+    public function sign($msg, $enc = false, $options = false) {
+        return $this->ec->sign($msg, $this, $enc, $options);
+    }
+
+    public function verify($msg, $signature) {
+        return $this->ec->verify($msg, $signature, $this);
+    }
+
+    public function inspect() {
+        return "<Key priv: " . (isset($this->priv) ? $this->priv->toString(16, 2) : "") .
+            " pub: " . (isset($this->pub) ? $this->pub->inspect() : "") . ">";
+    }
+
+    public function __debugInfo() {
+        return ["priv" => $this->priv, "pub" => $this->pub];
+    }
+}
+
+?>