Notes on Bindings

Status Bindings Notes

Main Account creation

// createAccount creates an internal geth account
// BIP44-compatible keys are generated: CKD#1 is stored as account key, CKD#2 stored as sub-account root
// Public key of CKD#1 is returned, with CKD#2 securely encoded into account key file (to be used for
// sub-account derivations)
func createAccount(password string) (address, pubKey, mnemonic string, err error)

Sub-account creation

// createChildAccount creates sub-account for an account identified by parent address.
// CKD#2 is used as root for master accounts (when parentAddress is "").
// Otherwise (when parentAddress != ""), child is derived directly from parent.
func createChildAccount(parentAddress, password string) (address, pubKey string, err error)

Recover account details

// recoverAccount re-creates master key using given details.
// Once master key is re-generated, it is inserted into keystore (if not already there).
func recoverAccount(password, mnemonic string) (address, pubKey string, err error)

Login (select active/current account)

Binding:

func Login(address, password *C.char) *C.char

Internally:

// selectAccount selects current account, by verifying that address has corresponding account which can be decrypted
// using provided password. Once verification is done, decrypted key is injected into Whisper (as a single identity,
// all previous identities are removed).
func selectAccount(address, password string) error

UnlockAccount(address, password string, seconds int)

Every time somebody unlocks Ethereum account Cthulhu kills kittens, dozens of them. So, don't use this method.

This method is deprecated, and will return error, asking you to rely Login() instead (if kittens weren't enough for you!)

CompleteTransaction(hash, password string)

StartNode(datadir string)

addPeer(url string)

addWhisperFilter(filterJson string)

removeWhisperFilter(id int)

cleanWhisperFilters()