wallet

func AddressFromKeystoreFile ¶

func AddressFromKeystoreFile(path string) (common.Address, error)

AddressFromKeystoreFile reads a v3 JSON keystore from path and returns the address it encodes. Works for keystores that include the `address` field at the top level (go-ethereum + foundry do).

func DecryptKeystoreAccount ¶

func DecryptKeystoreAccount(acc accounts.Account, password string) (*ecdsa.PrivateKey, error)

DecryptKeystoreAccount loads the raw JSON for acc and decrypts it with password, returning the raw ECDSA private key. It is the lower level of ks.Unlock; we need the key material directly for signing utilities that are not part of the keystore's own signing surface.

func DeriveFromMnemonic ¶

func DeriveFromMnemonic(mnemonic, passphrase, path string, index uint32) (*ecdsa.PrivateKey, string, common.Address, error)

DeriveFromMnemonic returns the ECDSA private key, effective derivation path, and Ethereum address for mnemonic at the given path / index.

If path is empty it is built from DefaultDerivationPath with the final component replaced by index. If path is non-empty, index is ignored — this matches `cast wallet` semantics where an explicit path overrides --mnemonic-index.

func FindAccount ¶

func FindAccount(ks *keystore.KeyStore, identifier string) (accounts.Account, error)

FindAccount resolves a CLI identifier to a keystore account. Supported identifier forms:

• `0x`-prefixed address
• path to a keystore JSON file (UTC-- / .json)
• decimal index into ks.Accounts() (for `--account 0` style use)

The index form is what the tx/mktx/send paths call "account by position"; the wallet package does not currently expose that surface, but supporting it here costs nothing.

func NewKeyStore ¶

func NewKeyStore(dir string) *keystore.KeyStore

NewKeyStore returns a KeyStore rooted at dir using light scrypt parameters. LightScryptN/P gives the cast-compatible "fast enough on a laptop" encryption — matches the Foundry default.

func ParseDerivationPath ¶

func ParseDerivationPath(path string) ([]uint32, error)

ParseDerivationPath turns a path like "m/44'/60'/0'/0/0" into the list of BIP-32 child indices. Hardened components are marked with a trailing apostrophe (') and offset by bip32.FirstHardenedChild.

func ResolveKeystoreDir ¶

func ResolveKeystoreDir(override string, createDefault bool) (string, error)

ResolveKeystoreDir returns the keystore directory to use per the precedence rule:

1. override (from --keystore-dir flag), if non-empty
2. ETH_KEYSTORE environment variable
3. ~/.foundry/keystores, if it already exists (honour existing cast users without migration)
4. ~/.polycli/keystores (the default)

createDefault controls whether step 4 creates the fallback directory on demand. Keystore-management commands (`wallet new`, `wallet import`) pass true so the default is materialised the first time an operator uses it. Signing commands (`mktx`, `send`, `estimate`) pass false: they shouldn't silently create a keystore dir just because an operator typo'd an address, and they should surface a clear "account not found" error instead.

The returned path is absolute and logged at debug so operators can see why a given path was chosen.