Skip to content

Latest commit

 

History

History
127 lines (83 loc) · 3.8 KB

escrow.md

File metadata and controls

127 lines (83 loc) · 3.8 KB
Raw

Escrow Contract - Or how to buy a raspberry pi

Use Case

Let's imagine you want to buy a raspberry pi from an online shop you know vaguely. These are the steps to do:

  1. Find out address of the online shop (in this demo it is ST1JDEC841ZDWN9CKXKJMDQGP5TW1AM10B7EV0DV9)
  2. Deposit STX for the price (0x10000)
  3. Wait until the seller agrees to the deal (accept) and sends you the pi
  4. Confirm the reception of the pi (accept)

Testnet in mocknet mode

The demo can be run in

  • mocknet mode
  • helium node (not yet tested)
  • neon mode

Setup Mocknet

The testnet in mocknet mode (local mining without p2p) should be set it up as follows:

git clone https://github.com/blockstack/stacks-blockchain.git
cd stacks-blockchain
cargo testnet mocknet

Configure Mocknet

Add stacks to the accounts in the testnet/stacks-node/Stacks.toml configuration file, accounts are defined in keys.json and keys2.json

  • for seller ST1JDEC841ZDWN9CKXKJMDQGP5TW1AM10B7EV0DV9: 0x100 fees
  • for buyer ST398K1WZTBVY6FE2YEHM6HP20VSNVSSPJTW0D53M: 0x800 fees + price

In directory stacks-blockchain:

vi testnet/stacks-node/Stacks.toml

insert

[[mstx_balance]]
address = "ST1JDEC841ZDWN9CKXKJMDQGP5TW1AM10B7EV0DV9"
amount = 256

[[mstx_balance]]
address = "ST398K1WZTBVY6FE2YEHM6HP20VSNVSSPJTW0D53M"
amount = 67584

If you want to use your own keys do something like this:

cargo run --bin blockstack-cli generate-sk --testnet > keys.json
cargo run --bin blockstack-cli generate-sk --testnet > keys2.json

Run Mocknet

In directory stacks-blockchain:

cargo testnet start --config=./testnet/stacks-node/Stacks.toml

Continue below with "Use Escrow Smart Contracts"

Testnet in Neo mode

Setup Neon testnet

The testnet in neon mode (mining on one dedicated remote node) should be set it up as follows:

git clone https://github.com/blockstack/stacks-blockchain.git
cd stacks-blockchain
cargo testnet neon

Verify Balances

The demo uses hard coded STX addresses, all users of this demo use the same addresses and keys.

Verify the balances at

and if necessary request tokens at the faucet for both addresses.

Use Escrow Smart Contracts

For the online deal we want to use the escrow contract.

Open a new terminal (or move to the parent directory of stacks-blockchain using cd ..)

git clone https://github.com/friedger/clarity-smart-contracts.git
cd clarity-smart-contracts
yarn

The demo was tested with version 0.4.0 of @blockstack/stacks-transaction library.

Finally, run the sequence of transactions that are defined in the integration test script (mocha test):

yarn escrow

The test script contains calls of the following methods defined in the stacks-transaction library:

  • makeContractDeploy
  • makeContractCall
  • makeStandardSTXPostCondition
  • makeContractSTXPostCondition

The buyer will deploy the contract, wait 10 seconds, deposit 65536 uSTXs. Then the seller will accept the deal. After another 10 seconds, the buyer will accept the deal and the price STXs will be transferred to the seller.

While the testnet is still running, you can check the balance of the buyer and the seller at