Address Book
If you repeatedly transfer tokens to the same recipients or if you just want to
store an arbitrary address for future use, you can use the addressbook
command to name the address and store it in your address book. Entries
in your address book are behaving similarly to the
accounts stored in your wallet, for example when checking the balance
of the account or sending tokens to. Of course, you cannot sign any
transactions with the address stored in your address book since you do not
possess the private key of that account. Both the Oasis native and the
Ethereum-compatible addresses can be stored.
The name of the address book entry may not clash with any of the account names in your wallet. The Oasis CLI will prevent you from doing so.
Add a New Entry
Use addressbook add <name> <address>
to name the address and store it in your
address book.
oasis addressbook add mike oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
oasis addressbook add meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
Then, you can for example use the entry name in you address book to send the
tokens to. In this case, we're sending 2.5 TEST
to meghan
on Sapphire
Testnet:
oasis account transfer 2.5 meghan
You are about to sign the following transaction:
Format: plain
Method: accounts.Transfer
Body:
To: meghan (oasis1qrjzcve7y6qp3nqs3n7ghavw68vkdh3epcv64ega)
Amount: 2.5 ROSE
Authorized signer(s):
1. ArEjDxsPfDvfeLlity4mjGzy8E/nI4umiC8vYQh+eh/c (secp256k1eth)
Nonce: 0
Fee:
Amount: 0.0002316 ROSE
Gas limit: 2316
(gas price: 0.0000001 ROSE per gas unit)
Network: mainnet
ParaTime: emerald
Account: eugene
List Entries
You can list all entries in your address book by invoking addressbook list
.
oasis addressbook list
NAME ADDRESS
meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
mike oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
Show Entry Details
You can check the details such as the native Oasis address of the Ethereum
account or simply check, if an entry exists in the address book, by running
addressbook show <name>
:
oasis addressbook show meghan
Name: meghan
Ethereum address: 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
Native address: oasis1qrjzcve7y6qp3nqs3n7ghavw68vkdh3epcv64ega
oasis addressbook show mike
Name: mike
Native address: oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
Rename an Entry
You can always rename the entry in your address book by using
addressbook rename <old_name> <new_name>
:
oasis addressbook list
NAME ADDRESS
meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
mike oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
oasis addressbook rename mike mark
oasis addressbook list
NAME ADDRESS
mark oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
Remove an Entry
To delete an entry from your address book invoke
addressbook remove <name>
.
oasis addressbook list
NAME ADDRESS
meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1
mike oasis1qrtrpg56l6y2cfudwtgfuxmq5e5cyhffcsfpdqvw
oasis addressbook remove mike
oasis addressbook list
NAME ADDRESS
meghan 0xBe8B38ED9b0794e7ab9EbEfC1e710b4F4EC6F6C1