Hierarchical deterministic Ethereum 2 wallet.
go-eth2-wallet-hd
is a standard Go module which can be installed with:
go get github.com/wealdtech/go-eth2-wallet-hd
Access to the wallet
is usually via go-eth2-wallet; the first two examples below shows how this can be achieved.
This wallet generates keys deterministically based on a seed phrase stored within the wallet itself.
The wallet uses the path m/12381/3600/n/0
, where n is the number of the account created; for the first account created n is 0, for the second accout n is 1, etc.
Wallet and account names may be composed of any valid UTF-8 characters; the only restriction is they can not start with the underscore (_
) character.
package main
import (
e2wallet "github.com/wealdtech/go-eth2-wallet"
)
func main() {
// Create a wallet
wallet, err := e2wallet.CreateWallet("My wallet", e2wallet.WithType("hierarchical deterministic"), e2wallet.WithPassphrase([]byte("my wallet secret")))
if err != nil {
panic(err)
}
...
}
package main
import (
e2wallet "github.com/wealdtech/go-eth2-wallet"
)
func main() {
// Open a wallet
wallet, err := e2wallet.OpenWallet("My wallet")
if err != nil {
panic(err)
}
...
}
package main
import (
e2wallet "github.com/wealdtech/go-eth2-wallet"
)
func main() {
// Open a wallet
wallet, err := e2wallet.OpenWallet("My wallet")
if err != nil {
panic(err)
}
err = wallet.Unlock([]byte("my wallet secret"))
if err != nil {
panic(err)
}
// Always immediately defer locking the wallet to ensure it does not remain unlocked outside of the function.
defer wallet.Lock()
account, err := wallet.CreateAccount("My account", []byte("my account secret"))
if err != nil {
panic(err)
}
// Wallet should be locked as soon as unlocked operations have finished; it is safe to explicitly call wallet.Lock() as well
// as defer it as per above.
wallet.Lock()
...
}
Jim McDonald: @mcdee.
Contributions welcome. Please check out the issues.
Apache-2.0 © 2019 Weald Technology Trading Ltd