The rns
module is a nameservice that allows users to use a human readable name when interacting with the Jackal Blockchain. Users can register names, list names for sale, buy names on sale, and place/accept bids from other users on their names.
The query
commands allow users to query rns
state.
canined q rns --help
The list-names
command allows users to see a list of registered names.
canined q rns list-names
The show-names
command allows users to see information about a single name.
canined q rns show-names
The list-bids
command allows users to see a list of currently active bids.
canined q rns list-bids
The show-bids
command allows users to see information about an active bid.
canined q rns show-bids
The list-forsale
command allows users to see a list of names on sale.
canined q rns list-forsale
The show-forsale
command allows users to see information about a name on sale.
canined q rns show-forsale
The params
command allows users to view the params of the module.
canined q rns params
The tx
commands allow users to interact with the rns
module.
canined tx rns --help
The register
command registers a name for the years specified under the user account. Must also pass in a data field, used for storing a JSON structure defining extra characteristics of the name. Will take tokens from user account proportional to years registered & length of name.
canined tx rns register [name] [years] [data]
The add-record
command appends the new record to the name acting as a subdomain.
canined tx rns add-record [name] [record] [data]
The del-record
command removes the record from the name.
canined tx rns del-record [name] [record] [data]
The list
command lists a name for sale at a specified price. When bought, the amount specified will be sent to the user.
canined tx rns list [name] [price]
The delist
command removes a name from the sale listings.
canined tx rns delist [name]
The buy
command buys a name that is listed for sale.
canined tx rns buy [name]
The bid
command places a bid for a name. The price of the bid is locked up in escrow until either the bid is cancelled or is accepted. The owner can accept this bid and the name will be transfered.
canined tx rns bid [name] [price]
The cancel-bid
command removes a bid from the bid list and returns the funds locked in escrow.
canined tx rns cancel-bid [bid-id]
The accept-bid
command accepts a bid, transferring ownership of the name specified and taking the tokens locked in escrow.
canined tx rns accept-bid [bid-id]