sysio::wallet::se_wallet Class Reference

#include <se_wallet.hpp>

Inheritance diagram for sysio::wallet::se_wallet:

Collaboration diagram for sysio::wallet::se_wallet:

Public Member Functions
	se_wallet ()
	~se_wallet ()
private_key_type	get_private_key (public_key_type pubkey) const override
bool	is_locked () const override
void	lock () override
void	unlock (string password) override
void	check_password (string password) override
void	set_password (string password) override
map< public_key_type, private_key_type >	list_keys () override
flat_set< public_key_type >	list_public_keys () override
bool	import_key (string wif_key) override
string	create_key (string key_type) override
bool	remove_key (string key) override
std::optional< signature_type >	try_sign_digest (const digest_type digest, const public_key_type public_key) override
Public Member Functions inherited from sysio::wallet::wallet_api
virtual	~wallet_api ()

Detailed Description

Definition at line 15 of file se_wallet.hpp.

Constructor & Destructor Documentation

se_wallet()

sysio::wallet::se_wallet::se_wallet

(

)

Definition at line 286 of file se_wallet.cpp.

                     : my(new detail::se_wallet_impl()) {
   detail::check_signed();
 
   //How to figure out of SE is available?!
   char model[256];
   size_t model_size = sizeof(model);
   if(sysctlbyname("hw.model", model, &model_size, nullptr, 0) == 0) {
      if(strncmp(model, "iMacPro", strlen("iMacPro")) == 0) {
         my->populate_existing_keys();
         return;
      }
      unsigned int major, minor;
      if(sscanf(model, "MacBookPro%u,%u", &major, &minor) == 2) {
         if((major >= 15) || (major >= 13 && minor >= 2)) {
            my->populate_existing_keys();
            return;
         }
      }
      if(sscanf(model, "Macmini%u", &major) == 1 && major >= 8) {
         my->populate_existing_keys();
         return;
      }
      if(sscanf(model, "MacBookAir%u", &major) == 1 && major >= 8) {
         my->populate_existing_keys();
         return;
      }
   }
 
   SYS_THROW(secure_enclave_exception, "Secure Enclave not supported on this hardware");
}

~se_wallet()

sysio::wallet::se_wallet::~se_wallet

(

)

Definition at line 317 of file se_wallet.cpp.

                      {
}

Member Function Documentation

check_password()

void sysio::wallet::se_wallet::check_password ( string password )

overridevirtual

Checks the password of the wallet

Validates the password on a wallet even if the wallet is already unlocked, throws if bad password given.

Parameters

password

the password previously set with set_password()

Implements sysio::wallet::wallet_api.

Definition at line 340 of file se_wallet.cpp.

                                              {
   //just leave this as a noop for now; remove_key from wallet_mgr calls through here
}

create_key()

string sysio::wallet::se_wallet::create_key ( string key_type )

overridevirtual

Creates a key within the wallet to be used to sign transactions by an account.

example: create_key K1

Parameters

key_type

the key type to create. May be empty to allow wallet to pick appropriate/"best" key type

Implements sysio::wallet::wallet_api.

Definition at line 360 of file se_wallet.cpp.

                                            {
   SYS_ASSERT(key_type.empty() || key_type == "R1", chain::unsupported_key_type_exception, "Secure Enclave wallet only supports R1 keys");
   return my->create().to_string();
}

get_private_key()

private_key_type sysio::wallet::se_wallet::get_private_key ( public_key_type pubkey ) const

overridevirtual

Get the private key corresponding to a public key. The private key must already be in the wallet.

Implements sysio::wallet::wallet_api.

Definition at line 320 of file se_wallet.cpp.

                                                                        {
   FC_THROW_EXCEPTION(chain::wallet_exception, "Obtaining private key for a key stored in Secure Enclave is impossible");
}

import_key()

bool sysio::wallet::se_wallet::import_key ( string wif_key )

overridevirtual

Imports a WIF Private Key into the wallet to be used to sign transactions by an account.

example: import_key 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

Parameters

wif_key

the WIF Private Key to import

Implements sysio::wallet::wallet_api.

Definition at line 356 of file se_wallet.cpp.

                                         {
   FC_THROW_EXCEPTION(chain::wallet_exception, "It is not possible to import a key in to the Secure Enclave wallet");
}

is_locked()

bool sysio::wallet::se_wallet::is_locked ( ) const

overridevirtual

Checks whether the wallet is locked (is unable to use its private keys).

This state can be changed by calling lock() or unlock().

Returns

true if the wallet is locked

Implements sysio::wallet::wallet_api.

Definition at line 324 of file se_wallet.cpp.

                                {
   return my->locked;
}

Here is the caller graph for this function:

list_keys()

map< public_key_type, private_key_type > sysio::wallet::se_wallet::list_keys ( )

overridevirtual

Dumps all private keys owned by the wallet.

The keys are printed in WIF format. You can import these keys into another wallet using import_key()

Returns

a map containing the private keys, indexed by their public key

Implements sysio::wallet::wallet_api.

Definition at line 347 of file se_wallet.cpp.

                                                            {
   FC_THROW_EXCEPTION(chain::wallet_exception, "Getting the private keys from the Secure Enclave wallet is impossible");
}

list_public_keys()

flat_set< public_key_type > sysio::wallet::se_wallet::list_public_keys ( )

overridevirtual

Dumps all public keys owned by the wallet.

Returns

a vector containing the public keys

Implements sysio::wallet::wallet_api.

Definition at line 350 of file se_wallet.cpp.

                                                      {
   flat_set<public_key_type> keys;
   boost::copy(my->_keys | boost::adaptors::map_keys, std::inserter(keys, keys.end()));
   return keys;
}

lock()

void sysio::wallet::se_wallet::lock ( )

overridevirtual

Locks the wallet immediately

Implements sysio::wallet::wallet_api.

Definition at line 327 of file se_wallet.cpp.

                     {
   SYS_ASSERT(!is_locked(), wallet_locked_exception, "You can not lock an already locked wallet");
   my->locked = true;
}

Here is the call graph for this function:

remove_key()

bool sysio::wallet::se_wallet::remove_key ( string key )

overridevirtual

Removes a key from the wallet.

example: remove_key SYS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV

Parameters

key	the Public Key to remove

Implements sysio::wallet::wallet_api.

Definition at line 365 of file se_wallet.cpp.

                                     {
   SYS_ASSERT(!is_locked(), wallet_locked_exception, "You can not remove a key from a locked wallet");
   return my->remove_key(key);
}

Here is the call graph for this function:

set_password()

void sysio::wallet::se_wallet::set_password ( string password )

overridevirtual

Sets a new password on the wallet.

The wallet must be either 'new' or 'unlocked' to execute this command.

Implements sysio::wallet::wallet_api.

Definition at line 343 of file se_wallet.cpp.

                                            {
   FC_THROW_EXCEPTION(chain::wallet_exception, "Secure Enclave wallet cannot have a password set");
}

try_sign_digest()

std::optional< signature_type > sysio::wallet::se_wallet::try_sign_digest ( const digest_type digest, const public_key_type public_key )

overridevirtual

Returns a signature given the digest and public_key, if this wallet can sign via that public key

Implements sysio::wallet::wallet_api.

Definition at line 370 of file se_wallet.cpp.

                                                                                                                 {
   return my->try_sign_digest(digest, public_key);
}

Here is the call graph for this function:

unlock()

void sysio::wallet::se_wallet::unlock ( string password )

overridevirtual

Unlocks the wallet.

The wallet remain unlocked until the lock is called or the program exits.

Parameters

password

the password previously set with set_password()

Implements sysio::wallet::wallet_api.

Definition at line 332 of file se_wallet.cpp.

                                      {
   promise<bool> prom;
   future<bool> fut = prom.get_future();
   macos_user_auth(detail::auth_callback, &prom, CFSTR("unlock your SYSIO wallet"));
   if(!fut.get())
      FC_THROW_EXCEPTION(chain::wallet_invalid_password_exception, "Local user authentication failed");
   my->locked = false;
}

Here is the call graph for this function:

---

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

• plugins/wallet_plugin/include/sysio/wallet_plugin/se_wallet.hpp
• plugins/wallet_plugin/se_wallet.cpp