Getting Set Up
- 1.Install Keplr
- 2.Add
pulsar-2to Keplr - 3.
- 4.Add custom SNIP-20 tokens to Keplr
- 5.Install
secretcliand connect it topulsar-2 - 6.Instantiate the
auction-factorycontract - 7.Create auctions
Check out this video to set up you Keplr wallet.
Keep your mnemonic at hand, you will need it later on in this guide.
- 1.In order to connect to the
pulsar-2chain, go to https://connect.pulsar.griptapejs.com and click on the "pulsar-2" button - 2.Then a Keplr window will pop up, click on the "approve" button
Once you have Keplr installed and an account created, you con now send test tokens to your account. In order to send these tokens you will need to go the the faucet and paste your account address there. (There are reports that the faucet may be down, lets us know if you need test SCRT and we will send)
To see all the balances for the custom tokens we have provided you, do the following:
- 1.Open the Keplr extension
- 2.Click on the hamburger menu
- 3.Click on add token
- 4.Paste the contract address of the token you want to add and click the "Submit" button
- 5.Click the "approve" button
- 6.Check that your tokens was added
Secret Network Releases Page
Once you have downloaded the binary, save it into a known location for executables. For Linux and Mac users, open a terminal emulator, go to the directory you saved the binary and run the following command:
chmod +x secretclit-macOS # Or secretcli-linux in case you are in Linux
The next step is to rename the binary:
mv secretcli-macOS secretcli
In order to finish the installation, let's add the binary to our PATH, so we can call it whenever we want. Here are some good resources that tells you how to add it to your path:
After the installation is complete and you are now able to execute the
secretcli from your terminal, is time to configure it. Run the following commands to connect it to the pulsar-2 chain:secretcli config broadcast-mode sync
secretcli config node http://rpc.pulsar.griptapejs.com:26657
secretcli config output json
secretcli config chain-id pulsar-2
Finally, let's add our account to the
secretcli command. To do that, you will need your mnemonic. Copy you mnemonic and go to a terminal and run the following command:secretcli keys add <a-name> --recover
Where:
<a-name>is the name you want you use for your key
You will be asked to paste your mnemonic, then do so.
The objective of the instantiation of the factory contract is to get the contract address that we are going to use to create auctions.
To instantiate the
auction-factory contract, run the following command:secretcli tx compute instantiate 2496 \
'{"entropy":"QUIza1hNOVlrYVlPQXFuWU00Vmw=","auction_contract":{"code_id":2760,"code_hash":"9D733DD6C613C354A6A86ED62C7839F25C47F942E59F590C6233BD0243D8540C"}}' \
--from <your-key> \
--gas 1000000 \
--label <your-label> -y
Where:
<your-key>is the key assigned to you account in thesecretcli<your-label>a unique identifier for your instantiated contract. Use whatever it makes sense for you.
The encoded JSON of the init message looks like this:
{
"entropy":"QUIza1hNOVlrYVlPQXFuWU00Vmw=",
"auction_contract":{
"code_id":2760,
"code_hash":"9D733DD6C613C354A6A86ED62C7839F25C47F942E59F590C6233BD0243D8540C"
}
}
In this case, there's no need for you to edit the values of the JSON.
After you run the command, you will get a response like this:
{
"height": "0",
"txhash": "E1D13A11CB08506EF711E33DAFEDFB7BB6DA627C1E2286009905A09C14F05831",
"codespace": "",
"code": 0,
"data": "",
"raw_log": "[]",
"logs": [],
"info": "",
"gas_wanted": "0",
"gas_used": "0",
"tx": null,
"timestamp": ""
}
Take the value of the
txhash property of the JSON and run the following command, replacing <my-txhash> with the value copied before:secretcli query compute tx <my-txhash>
Finally, we have the contract address of the
auction-factory at $.output_logs[0].attributes[0].value:{
"type": "instantiate",
"input": "efbe0fdfd33254afdd5f3481b171e074a13fe3ebca82c6c2728ec16fb6eca854{\"entropy\":\"QUIza1hNOVlrYVlPQXFuWU00Vmw=\",\"auction_contract\":{\"code_id\":2760,\"code_hash\":\"9D733DD6C613C354A6A86ED62C7839F25C47F942E59F590C6233BD0243D8540C\"}}",
"output_logs": [
{
"type": "wasm",
"attributes": [
{
"key": "contract_address",
"value": "secret17atn0als6n6n0s8dft0axa78nk5qvjrvdj0825"
}
]
}
]
}
To create auctions you need to do a two step process.
First, you need to run the following transaction:
secretcli tx compute execute <sell-token-address> \
'{"increase_allowance":{"spender":"<auction-factory-contract>","amount":"1000000"}}' \
--from <your-key> \
--gas 120000 -y
Where:
<sell-token-address>an address of a SNIP-20 token that you want to sell. You can use any token in the Glossary.<your-key-name>is the key assigned to you account in thesecretcli
Now, the second step is to create the auction itself. The encoded JSON looks like this:
{
"create_auction":{
"label":"<your-unique-auction-label>",
"sell_contract":{
"code_hash":"<sell-token-code-hash>",
"address":"<sell-token-address>"
},
"bid_contract":{
"code_hash":"<bid-token-code-hash>",
"address":"<bid-token-address>"
},
"sell_amount":"<sell-token-amount>",
"minimum_bid":"<bid-token-minimum-amount>",
"ends_at":1643698320,
"description":"This is an optional description"
}
}
Getting the
code_hash for your tokens is pretty simple:secretcli query compute contract-hash <token-address>
Where:
<token-address>the contract address of the token you want to get the hash of
And finally, to create a new auction, run the following command for as many tokens you want to:
secretcli tx compute execute <auction-factory-contract> \
'{"create_auction":{"label":"new-auction-001","sell_contract":{"code_hash":"9587d60b8e6b078ace12014ceeee089530b9fabcd76535d93666a6c127ad8813","address":"secret18vd8fpwxzck93qlwghaj6arh4p7c5n8978vsyg"},"bid_contract":{"code_hash":"cd306596d0c5f43d99b7085c35be615dd2210c0a36bddfb4189b6a54d0906d95","address":"secret1zh5lx269gjjklsz2m32ztt95qcqve37zt3etcx"},"sell_amount":"1000000","minimum_bid":"1000000","ends_at":1643698320,"description":"This is an optional description"}}' \
--from <your-key> \
--gas 630000 -y
Where:
<your-key-name>is the key assigned to you account in thesecretcli
Lastly you can test that everything is working by querying the auction-factory-contract asking for a list of active auctions
secretcli q compute query <auction-factory-contract> '{"list_active_auctions":{}}'AND QUERY THE AUCTION DIRECTION WITHsecretcli q compute query <auction-contract> '{"auction_info":{}}'Last modified 1yr ago