Accounts
This document describes the in-built accounts system of Uptick.
Pre-requisite Readings
Uptick Accounts
Uptick defines its own custom Account
type that uses Ethereum's ECDSA secp256k1 curve for keys. This satisfies the EIP84 for full BIP44 paths. The root HD path for Uptick-based accounts is m/44'/60'/0'/0
.
+++ https://github.com/tharsis/ethermint/blob/main/types/account.pb.go#L28-L33
Addresses and Public Keys
BIP-0173 defines a new format for segregated witness output addresses that contains a human-readable part that identifies the Bech32 usage. Uptick uses the following HRP (human readable prefix) as the base HRP:
Network | Mainnet | Testnet | Regtest |
---|---|---|---|
Uptick |
|
|
There are 3 main types of HRP for the Addresses
/PubKeys
available by default on Uptick:
Addresses and Keys for accounts, which identify users (e.g. the sender of a
message
). They are derived using theeth_secp256k1
curve.Addresses and Keys for validator operators, which identify the operators of validators. They are derived using the
eth_secp256k1
curve.Addresses and Keys for consensus nodes, which identify the validator nodes participating in consensus. They are derived using the
ed25519
curve.
Address bech32 Prefix | Pubkey bech32 Prefix | Curve | Address byte length | Pubkey byte length | |
---|---|---|---|---|---|
Accounts |
|
|
|
|
|
Validator Operator |
|
|
|
|
|
Consensus Nodes |
|
|
|
|
|
Address formats for clients
EthAccount
can be represented in both Bech32 (uptick1...
) and hex (0x...
) formats for Ethereum's Web3 tooling compatibility.
The Bech32 format is the default format for Cosmos-SDK queries and transactions through CLI and REST clients. The hex format on the other hand, is the Ethereum common.Address
representation of a Cosmos sdk.AccAddress
.
Address (Bech32):
uptick1z3t55m0l9h0eupuz3dp5t5cypyv674jj7mz2jw
Address (EIP55 Hex):
0x91defC7fE5603DFA8CC9B655cF5772459BF10c6f
Compressed Public Key:
{"@type":"/ethermint.crypto.v1.ethsecp256k1.PubKey","key":"AsV5oddeB+hkByIJo/4lZiVUgXTzNfBPKC73cZ4K1YD2"}
Address conversion
The uptickd debug addr <address>
can be used to convert an address between hex and bech32 formats. For example:
Bech32
Hex
Key output
The Cosmos SDK Keyring output (i.e uptickd keys
) only supports addresses and public keys in Bech32 format.
We can use the keys show
command of uptickd
with the flag --bech <type> (acc|val|cons)
to obtain the addresses and keys as mentioned above,
Account
Validator
Consensus
Querying an Account
You can query an account address using the CLI, gRPC or
Command Line Interface
Cosmos gRPC and REST
JSON-RPC
To retrieve the Ethereum hex address using Web3, use the JSON-RPC eth_accounts
or personal_listAccounts
endpoints:
Last updated