Address Alias

Create an alias for your address.

• Search an address by alias: "batman" => "secret12345678901234567890"
• Search an alias by address: "secret12345678901234567890" => "batman"

Concept / Why

• Easy way to find and share addresses.
• Easy way to let people know the purpose of an address. e.g. "btn.group - admin 1"

Use case examples

Finding and sharing an address through btn.group's site

• Batman asks Bane to send him 3 scrt tokens.
• Batman tells Bane that he can grab his wallet address from btn.group by searching for 'thedarkknight'.
• Bane goes to website, searches for 'thedarkknight' and retrieves the wallet address.

Finding and sharing an address via a third party app

• Bane asks the league of shadows to send him 333 tokens.
• The league of shadows is using an app which has incorporated this contract.
• Bane tells the league of shadows that his alias is 'breakyou'.
• The league of shadows enters the alias into the app and it auto fills the wallet adddress to send to.

Easier auditing

• Robin wants to audit an instance of a smart contract before investing.
• Robin sees a few different addresses interacting with it.
• He looks up an address in a flash and gets a better picture of what's going on.

Testing locally examples

# Run chain locally
docker run -it --rm -p 26657:26657 -p 26656:26656 -p 1337:1337 -v $(pwd):/root/code --name secretdev enigmampc/secret-network-sw-dev

# Access container via separate terminal window 
docker exec -it secretdev /bin/bash

# cd into code folder
cd code

# Store contracts required for test
secretcli tx compute store buttcoin.wasm.gz --from a --gas 3000000 -y --keyring-backend test
secretcli tx compute store butt-lode.wasm.gz --from a --gas 3000000 -y --keyring-backend test
secretcli tx compute store address-alias.wasm.gz --from a --gas 3000000 -y --keyring-backend test

# Get the contract's id
secretcli query compute list-code

# Init Buttcoin 
CODE_ID=1
INIT='{"name": "Buttcoin", "symbol": "BUTT", "decimals": 6, "initial_balances": [{"address": "secret1qwkd2mdr0w79fyz6zyljs7u3cnff6dtekp3y39", "amount": "1000000000000000000"},{"address": "secret1wz95rde3wrf9e4hvdtwgey4d9zeys35sevchg5", "amount": "1000000000000000000"}], "prng_seed": "testing"}'
secretcli tx compute instantiate $CODE_ID "$INIT" --from a --label "Buttcoin" -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt

# Set viewing key for Buttcoin
secretcli tx compute execute secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg '{"set_viewing_key": { "key": "testing" }}' --from a -y --keyring-backend test
secretcli tx compute execute secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg '{"set_viewing_key": { "key": "testing" }}' --from b -y --keyring-backend test

# Init BUTT lode
CODE_ID=4
INIT='{"viewing_key": "DoTheRightThing."}'
secretcli tx compute instantiate $CODE_ID "$INIT" --from a --label "butt-lode" -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt

# Init address alias
CODE_ID=5
INIT='{"buttcoin": {"address": "secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg", "contract_hash": "4CD7F64B9ADE65200E595216265932A0C7689C4804BE7B4A5F8CEBED250BF7EA"}, "butt_lode": {"address": "secret1tndcaqxkpc5ce9qee5ggqf430mr2z3pedc68dx", "contract_hash": "C924D1D07B2386BDBDC0F0F324F551EBEB1C09D628C5047B9E8FA61C17FCC423"}, "aliases": [{"alias": "bogoggl", "address": "secret1pe5c78vprahdqlwwx7rlz74rtnxhp8swgrtacr"}, {"alias": "sex", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1626422552/secret_network/address_alias/user_uploads/rso5ouuglk3tq5itkayd.jpg", "address": "secret1hdam2af5gpytmw3lfkhlnqjapqd9fh3skusd6z"}, {"alias": "secretnetwork", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1626421705/secret_network/address_alias/user_uploads/irict0nfewkvoikpbajd.jpg", "address": "secret1s2g7fepnl2hq65gflpv92legke452nnzuqtcet"}, {"alias": "x", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1626421288/secret_network/address_alias/user_uploads/dxh13oasotliwggbczst.jpg", "address": "secret1c4ustsk77j7tljdnee2ehm2jxkn22666y5sa25"}, {"alias": "xxx", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1626419086/secret_network/address_alias/user_uploads/pyqac3nll9escxjzwp1a.gif", "address": "secret1u2x7ndzsau7e9n5xu4ng2hghxp58q5xg8hevkk"}, {"alias": "etoque angry dawg", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1623854847/secret_network/address_alias/user_uploads/k0pkom4sarf6av6uvgmg.png", "address": "secret13yfwh0lv3f7c703etpwm6pjdp2jyuwfk527g7j"}, {"alias": "gus", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1623854331/secret_network/address_alias/user_uploads/ytiylm9s4q5z6dik8kx1.jpg", "address": "secret1nu5j6lqpaw47qqs9d6ym835ywyn462l4gq723n"}, {"alias": "btn.group admin3", "avatar_url": "https://res.cloudinary.com/hv5cxagki/image/upload/secret_network/yield_optimizer/3143e566-c3f1-4252-80f2-6bbbc5242368_pfkrls.png", "address": "secret1wgfe52tz8hthe236nh28y0qac4df9yg2qdmrpr"}, {"alias": "btn.group admin2", "avatar_url": "https://res.cloudinary.com/hv5cxagki/image/upload/v1/secret_network/smart_contract_interface/contract_rough_MG_tw1vei.png", "address": "secret1s32ccax83w483rj5nsnsz56wvryfszrhev7sjn"}, {"alias": "petar", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1623188805/secret_network/address_alias/user_uploads/muvb0mnrflvjd79pgcoq.png", "address": "secret1yza5mzgmypm43mzzgwyg3nt958vchxracj3mx3"}, {"alias": "cryptochrisb", "address": "secret1fu9kr29n7d0k59dtezkl09pz8rwazykf6yctp0"}, {"alias": "emily chen", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622768025/secret_network/address_alias/user_uploads/mkiq3e1erohtph51vs9b.png", "address": "secret1sm7yp4gw22xawvekjcvt06wenz22mfspukwfks"}, {"alias": "patrick", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622663448/secret_network/address_alias/user_uploads/ggkqrbqmchoa9olbyk6v.png", "address": "secret1j486ekz7ksn4l7s2tlnnh9mexrex3nxz7ue80u"}, {"alias": "joe", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622651509/secret_network/address_alias/user_uploads/ybkikya8ozpmvvykc7di.jpg", "address": "secret1sv83nqu9lql67lz8dvumerz5zm9xlnsq9xpxjx"}, {"alias": "s", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622640201/secret_network/address_alias/user_uploads/y6nitqlx5u5plj6e6s5e.jpg", "address": "secret1ctqpkfjfhtl8vhz52rmf39gzcdfpamftr9h2yh"}, {"alias": "syck", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622639791/secret_network/address_alias/user_uploads/ajizdbadebzgizjzn3st.jpg", "address": "secret1x2nr7lx0dgguuadz9k93zjf2gt8elvnsjhyq9s"}, {"alias": "this is not fine!!", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622617116/secret_network/address_alias/user_uploads/myvj4h8sy7u5vmqpabih.jpg", "address": "secret146uuuagufhk64k6feckcuef2hxvsg4cneyn40k"}, {"alias": "btn.group admin", "avatar_url": "http://res.cloudinary.com/hv5cxagki/image/upload/v1622605639/secret_network/address_alias/user_uploads/dd07sfnuj1tnwe5nrfzg.png", "address": "secret1zm55tcme6epjl4jt30v05gh9xetyp9e3vvv6nr"}]}'
secretcli tx compute instantiate $CODE_ID "$INIT" --from a --label "address alias - btn.group" -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt

# Query config for address alias
secretcli query compute query $CONTRACT_INSTANCE_ADDRESS '{"config": {}}'

# Query by address
secretcli query compute query secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek '{"search": {"search_type": "address", "search_value": "secret1zm55tcme6epjl4jt30v05gh9xetyp9e3vvv6nr"}}'

# Query by alias
secretcli query compute query secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek '{"search": {"search_type": "alias", "search_value": "btn.group admin"}}'

# Create alias
secretcli tx compute execute secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg '{"send": { "recipient": "secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek", "amount": "1000000", "msg": "eyJjcmVhdGUiOnsiYWxpYXMiOiAiYWRmYXNkZmEiLCJhdmF0YXJfdXJsIjogImh0dHBzOi8vc2VjcmV0bm9kZXMuY29tL2Fzc2V0cy9odWJibGUtbG9nby03M2JkN2FjYzI2YmYxNmM0YWY5NjZiZWE2Yjk0ZTY4MDliMTBkNzNmOTllMTJiNTU4YTc4OGQ2OTdiYjdjY2Q0LnBuZyJ9fQ" }}' --from a -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt

# Query by address
secretcli query compute query secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek '{"search": {"search_type": "address", "search_value": "secret1qwkd2mdr0w79fyz6zyljs7u3cnff6dtekp3y39"}}'

# Destroy alias
secretcli tx compute execute secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek '{"destroy": {"alias": "adfasdfa"}}' --from a -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt

# Query that BUTT was sent to BUTT lode
secretcli tx compute execute secret1tndcaqxkpc5ce9qee5ggqf430mr2z3pedc68dx '{"set_viewing_key_for_snip20": {"token": {"address": "secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg", "contract_hash": "4CD7F64B9ADE65200E595216265932A0C7689C4804BE7B4A5F8CEBED250BF7EA"}}}' --from a -y --keyring-backend test --gas 3000000 --gas-prices=3.0uscrt
secretcli query compute query secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg '{"balance": {"address": "secret1tndcaqxkpc5ce9qee5ggqf430mr2z3pedc68dx", "key": "DoTheRightThing."}}'

References

1. Address alias: https://btn.group/secret_network/address_alias
2. Secret contracts guide: https://github.com/enigmampc/secret-contracts-guide