fc::ecc::public_key Class Reference

contains only the public point of an elliptic curve key. More...

#include <elliptic.hpp>

Public Member Functions
	public_key ()
	public_key (const public_key &k)
	~public_key ()
public_key_data	serialize () const
public_key_point_data	serialize_ecc_point () const
	operator public_key_data () const
	public_key (const public_key_data &v)
	public_key (const public_key_point_data &v)
	public_key (const compact_signature &c, const fc::sha256 &digest, bool check_canonical=true)
public_key	child (const fc::sha256 &offset) const
bool	valid () const
	public_key (public_key &&pk)
public_key &	operator= (public_key &&pk)
public_key &	operator= (const public_key &pk)
std::string	to_base58 () const
	Allows to convert current public key object into base58 number.
unsigned int	fingerprint () const

Static Public Member Functions
static std::string	to_base58 (const public_key_data &key)
static public_key	from_base58 (const std::string &b58)

Friends
class	private_key
bool	operator== (const public_key &a, const public_key &b)
bool	operator!= (const public_key &a, const public_key &b)

Detailed Description

Definition at line 35 of file elliptic.hpp.

Constructor & Destructor Documentation

public_key() [1/6]

fc::ecc::public_key::public_key

(

)

Definition at line 142 of file elliptic_impl_pub.cpp.

{}

public_key() [2/6]

fc::ecc::public_key::public_key

(

const public_key &

k

)

Definition at line 144 of file elliptic_impl_pub.cpp.

: my( pk.my ) {}

~public_key()

fc::ecc::public_key::~public_key

(

)

Definition at line 148 of file elliptic_impl_pub.cpp.

{}

public_key() [3/6]

fc::ecc::public_key::public_key

(

const public_key_data &

v

)

Definition at line 306 of file elliptic_impl_pub.cpp.

    {
      const char* front = &dat.data[0];
      if( *front == 0 ){}
      else
      {
         my->_key = EC_KEY_new_by_curve_name( NID_secp256k1 );
         my->_key = o2i_ECPublicKey( &my->_key, (const unsigned char**)&front, sizeof(public_key_data) );
         if( !my->_key )
         {
           FC_THROW_EXCEPTION( exception, "error decoding public key", ("s", ERR_error_string( ERR_get_error(), nullptr) ) );
         }
      }
    }

public_key() [4/6]

fc::ecc::public_key::public_key

(

const public_key_point_data &

v

)

Definition at line 292 of file elliptic_impl_pub.cpp.

    {
      const char* front = &dat.data[0];
      if( *front == 0 ){}
      else
      {
         my->_key = EC_KEY_new_by_curve_name( NID_secp256k1 );
         my->_key = o2i_ECPublicKey( &my->_key, (const unsigned char**)&front, sizeof(dat)  );
         if( !my->_key )
         {
           FC_THROW_EXCEPTION( exception, "error decoding public key", ("s", ERR_error_string( ERR_get_error(), nullptr) ) );
         }
      }
    }

public_key() [5/6]

fc::ecc::public_key::public_key	(	const compact_signature &	c,
		const fc::sha256 &	digest,
		bool	check_canonical = true )

Definition at line 326 of file elliptic_impl_pub.cpp.

    {
        int nV = c.data[0];
        if (nV<27 || nV>=35)
            FC_THROW_EXCEPTION( exception, "unable to reconstruct public key from signature" );
 
        ECDSA_SIG *sig = ECDSA_SIG_new();
        BN_bin2bn(&c.data[1],32,sig->r);
        BN_bin2bn(&c.data[33],32,sig->s);
 
        if( check_canonical )
        {
            FC_ASSERT( is_canonical( c ), "signature is not canonical" );
        }
 
        my->_key = EC_KEY_new_by_curve_name(NID_secp256k1);
 
        if (nV >= 31)
        {
            EC_KEY_set_conv_form( my->_key, POINT_CONVERSION_COMPRESSED );
            nV -= 4;
//            fprintf( stderr, "compressed\n" );
        }
 
        if (detail::public_key_impl::ECDSA_SIG_recover_key_GFp(my->_key, sig, (unsigned char*)&digest, sizeof(digest), nV - 27, 0) == 1)
        {
            ECDSA_SIG_free(sig);
            return;
        }
        ECDSA_SIG_free(sig);
        FC_THROW_EXCEPTION( exception, "unable to reconstruct public key from signature" );
    }

Here is the call graph for this function:

public_key() [6/6]

fc::ecc::public_key::public_key

(

public_key &&

pk

)

Definition at line 146 of file elliptic_impl_pub.cpp.

: my( std::move( pk.my ) ) {}

Member Function Documentation

child()

public_key fc::ecc::public_key::child

(

const fc::sha256 &

offset

)

const

fingerprint()

unsigned int fc::ecc::public_key::fingerprint

(

)

const

Definition at line 144 of file elliptic_common.cpp.

    {
        public_key_data key = serialize();
        ripemd160 hash = ripemd160::hash( sha256::hash( key.begin(), key.size() ) );
        unsigned char* fp = (unsigned char*) hash._hash;
        return (fp[0] << 24) | (fp[1] << 16) | (fp[2] << 8) | fp[3];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

from_base58()

public_key fc::ecc::public_key::from_base58 ( const std::string & b58 )

static

Definition at line 131 of file elliptic_common.cpp.

    {
        array<char, 37> data;
        size_t s = fc::from_base58(b58, (char*)&data, sizeof(data) );
        FC_ASSERT( s == sizeof(data) );
 
        public_key_data key;
        uint32_t check = (uint32_t)sha256::hash(data.data, sizeof(key))._hash[0];
        FC_ASSERT( memcmp( (char*)&check, data.data + sizeof(key), sizeof(check) ) == 0 );
        memcpy( (char*)key.data, data.data, sizeof(key) );
        return from_key_data(key);
    }

Here is the call graph for this function:

operator public_key_data()

fc::ecc::public_key::operator public_key_data ( ) const

inline

Definition at line 45 of file elliptic.hpp.

{ return serialize(); }

Here is the call graph for this function:

operator=() [1/2]

public_key & fc::ecc::public_key::operator=

(

const public_key &

pk

)

Definition at line 156 of file elliptic_impl_pub.cpp.

    {
        my = pk.my;
        return *this;
    }

operator=() [2/2]

public_key & fc::ecc::public_key::operator=

(

public_key &&

pk

)

Definition at line 150 of file elliptic_impl_pub.cpp.

    {
        my = std::move(pk.my);
        return *this;
    }

serialize()

public_key_data fc::ecc::public_key::serialize

(

)

const

Definition at line 266 of file elliptic_impl_pub.cpp.

    {
      public_key_data dat;
      if( !my->_key ) return dat;
      EC_KEY_set_conv_form( my->_key, POINT_CONVERSION_COMPRESSED );
      /*size_t nbytes = i2o_ECPublicKey( my->_key, nullptr ); */
      /*assert( nbytes == 33 )*/
      char* front = &dat.data[0];
      i2o_ECPublicKey( my->_key, (unsigned char**)&front ); // FIXME: questionable memory handling
      return dat;
      /*
       EC_POINT* pub   = EC_KEY_get0_public_key( my->_key );
       EC_GROUP* group = EC_KEY_get0_group( my->_key );
       EC_POINT_get_affine_coordinates_GFp( group, pub, self.my->_pub_x.get(), self.my->_pub_y.get(), nullptr );
       */
    }

Here is the caller graph for this function:

serialize_ecc_point()

public_key_point_data fc::ecc::public_key::serialize_ecc_point

(

)

const

Definition at line 282 of file elliptic_impl_pub.cpp.

    {
      public_key_point_data dat;
      if( !my->_key ) return dat;
      EC_KEY_set_conv_form( my->_key, POINT_CONVERSION_UNCOMPRESSED );
      char* front = &dat.data[0];
      i2o_ECPublicKey( my->_key, (unsigned char**)&front ); // FIXME: questionable memory handling
      return dat;
    }

to_base58() [1/2]

std::string fc::ecc::public_key::to_base58

(

)

const

Definition at line 238 of file elliptic_impl_pub.cpp.

    {
      public_key_data key = serialize();
      return to_base58( key );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

to_base58() [2/2]

std::string fc::ecc::public_key::to_base58 ( const public_key_data & key )

static

Definition at line 121 of file elliptic_common.cpp.

    {
      uint32_t check = (uint32_t)sha256::hash(key.data, sizeof(key))._hash[0];
      static_assert(sizeof(key) + sizeof(check) == 37, ""); // hack around gcc bug: key.size() should be constexpr, but isn't
      array<char, 37> data;
      memcpy(data.data, key.begin(), key.size());
      memcpy(data.begin() + key.size(), (const char*)&check, sizeof(check));
      return fc::to_base58(data.begin(), data.size(), fc::yield_function_t());
    }

Here is the call graph for this function:

valid()

bool fc::ecc::public_key::valid

(

)

const

Definition at line 162 of file elliptic_impl_pub.cpp.

    {
      return my->_key != nullptr;
    }

Here is the caller graph for this function:

Friends And Related Symbol Documentation

operator!=

bool operator!= ( const public_key & a, const public_key & b )

friend

Definition at line 64 of file elliptic.hpp.

           {
            return a.serialize() != b.serialize();
           }

operator==

bool operator== ( const public_key & a, const public_key & b )

friend

Definition at line 60 of file elliptic.hpp.

           {
            return a.serialize() == b.serialize();
           }

private_key

friend class private_key

friend

Definition at line 77 of file elliptic.hpp.

---

The documentation for this class was generated from the following files:

• libraries/fc/include/fc/crypto/elliptic.hpp
• libraries/fc/src/crypto/elliptic_common.cpp
• libraries/fc/src/crypto/elliptic_impl_pub.cpp
• libraries/fc/src/crypto/elliptic_secp256k1.cpp