wwallet

README

Wasp Client tool

Wasp Client is a CLI tool for interacting with Goshimmer and Wasp, allowing to:

• Manipulate a Goshimmer wallet
• Interact with the FairRoulette smart contract

Wallet

• Create a new wallet (creates wwallet.json which stores the seed):

wwallet init

• Show private key + public key + account address for index 0 (index optional, default 0):

wwallet address -i 0

• Query Goshimmer for account balance:

wwallet balance [-i index]

• Use Testnet Faucet to transfer some funds into the wallet address at index n:

wwallet request-funds [-i index]

FairRoulette (a.k.a "fr") Smart Contract

Steps:

1. Create a new wallet for the owner account:

wwallet -c owner.json init

This will create the file owner.json with the admin user's wallet.

1. Transfer some funds to the owner address: wwallet -c owner.json request-funds.

2. Initialize the FairRoulette smart contract, and transfer some operating capital to it:

$ wwallet -c owner.json fr admin deploy
Initialized FairRoulette smart contract
SC Address: mUbfBM...
$ wwallet -c owner.json send-funds mUbfBM... IOTA 100

Copy the generated SC address. (It is also saved in owner.json)

1. Initialize a wallet for the client account:

wwallet init

This creates wwallet.json (can be changed with -c).

1. Transfer some funds to your wallet: wwallet request-funds.

2. Query your balance:

$ wwallet balance
Index 0
  Address: WKos8N...
  Balances:
    10000 IOTA

1. Configure the SC address in wwallet.json (obtained in step 7):

wwallet fr set address mUbfBM...

1. Make a bet: wwallet fr bet 2 100

2 is the color to bet.

100 is the amount of IOTAs to bet.

1. Query the SC state: wwallet fr status

Also try wwallet dashboard!

1. Change the play period (as admin): wwallet fr admin set-period 10 -c owner.json

FairAuction (a.k.a "fa") Smart Contract

Steps:

1. Initialize wallets for the owner and client account, as needed (see the relevant steps in FairRoulette section.

2. Initialize the FairAuction smart contract, and transfer some operating capital to it:

$ wwallet -c owner.json fa admin deploy
Initialized FairAuction smart contract
SC Address: mUbfBM...
$ wwallet -c owner.json send-funds mUbfBM... IOTA 100

Copy the generated SC address. (It is also saved in owner.json)

1. Configure the SC address in wwallet.json (obtained in step 2):

wwallet fa set address mUbfBM...

1. Mint some tokens:

$ wwallet mint 10
Minted 10 tokens of color y72kGq...

Copy the color ID.

1. Start an auction for those tokens:

$ wwallet fa start-auction "My first auction" y72kGq... 10 100 1

Arguments are: start-auction <description> <color> <amount> <minimum-bid> <duration-in-minutes>

1. Place a bid for an auction:

$ wwallet fa place-bid y72kGq... 110

1. Query the SC state: wwallet fa status

Also try wwallet dashboard!