ICX Maker Bot (dBTC)

[izzycsy]

For users who would like to test ICX (InterChain Exchange) maker bot independently on their local repository, here’s a guide. For the purpose of this test exercise, Taker (the user), will be interacting with Maker (bot) to perform the transaction.

Before starting the test, ensure that you have:

• node synced with Testnet and enabled spv=1 in defi.conf file
• sufficient utxoDFI, tokenDFI and SPV (Simplified Payment Verification) BTC balance

After testing, since you’re using dBTC Maker bot, you should receive dBTC token for BTC. Whereas if you’re using BTC Maker bot, you should receive BTC for dBTC token. Essentially, dBTC Maker is selling dBTC.

Prerequisite Parameters

Tips:

• Use Code Editor tool to take note the following parameters as you’ll be reusing several scripts
• Take note of the punctuation symbols, it should be printed as ' ' or " ", not “ ”

Open defi.conf in a Code Editor and retrieve the following parameters:

Mac — Go to Folder:
/Users/<username>/.defi/defi.conf

Windows:
C:\Users\<username>\.defi\defi.conf

Check in defi.conf that spv is enabled: spv=1

rpcaddress (rpcbind)=127.0.0.1
rpcport=8555
rpcuser=FXdChSOx
rpcpassword=1e4fb8343d563d6ce26a035dece3b4e03db407e433e8de8f9fd7e55c820edc399

From your DeFi Wallet, retrieve the following parameters:

dfi_address=tqEw2Q9yGJ1UWCXdQcUwkwSX48mkvdV2sS
spv_btc_address=tb1q2pysdzz8667dv4qvptqnzvm07vw9purg0hwhy5
spv_getaddresspubkey=03a4728fae10976ad7b2288782e083d2204b16c0b631f3c82f37e22cbeae18zy70

• If you do not have an spvWallet Bitcoin address, run the following command in DeFi Wallet CLI
  spv_getnewaddress in DeFi CLI

• To retrieve your spvWallet public key, run the following command in DeFi Wallet CLI
  spv_getaddresspubkey <space> spvAddress in DeFi CLI

Run DeFi Wallet in the background

• Ensure that DeFi Wallet is 100% synced, and keep it running in the background

Prepare the script

• Check connection is running smoothly and prerequisites are correct
• Run your Terminal, change directory to bin/defi-cli or bin/defi-cli.exe
• You may find the latest release here: https://github.com/DeFiCh/ain/releases

Check that it’s running smoothly by using the prerequisites parameters followed by the command getblockchaininfo

Example script:

./defi-cli -testnet -rpcport=8555 -rpcuser="FXdChSOx" -rpcpassword="1e4fb8343d563d6ce26a035dece3b4e03db407e433e8de8f9fd7e55c820edc399" getblockchaininfo

Example output:

% cd defichain-1.7.11
defichain-1.7.11 % cd bin
bin % ./defi-cli -testnet -rpcport=8555 -rpcuser="FXdChSOx" -rpcpassword="1e4fb8343d563d6ce26a035dece3b4e03db407e433e8de8f9fd7e55c820edc399" getblockchaininfo
{
  "chain": "test",
  "blocks": 444247,
  "headers": 444247,
  "bestblockhash": "5c8f1218399w1c56a10f6dc8a6a146821e4ab0646dd3b451931f5e2032581a8f",
  "difficulty": 31586510.68861501,
  "mediantime": 1625830658,
  "verificationprogress": 0.9999937812653793,
  "initialblockdownload": false,
  "chainwork": "0000000000000000000000000000000000000000000002ae8c684c14dcc3ab46",
  "size_on_disk": 229772755,
  "pruned": false,
  .
  .
  .
  "eunos": {
      "type": "buried",
      "active": true,
      "height": 354950
    }
  },
  "warnings": ""
}

To run dBTC maker bot

User role: Taker
Type: INTERNAL

INTERNAL would mean that the order is from DeFiChain to BTC network, while EXTERNAL order is from BTC to DeFiChain network.

• At the start of each command, you’ll have to use the following script followed by the respective command(s)

Example script:

./defi-cli -testnet -rpcport=8555 -rpcuser="FXdChSOx" -rpcpassword="1e4fb8343d563d6ce26a035dece3b4e03db407e433e8de8f9fd7e55c820edc399" <command here>

1. Get orders

./defi-cli -testnet -rpcport=8555 -rpcuser="FXdChSOx" -rpcpassword="..." icx_listorders

Example output

{
  "WARNING": "ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.",
    "fe87484fd39b7f66eb8214df811ddbaaf3b934219c9452af2cf09fdc3b065c1b": {
    "status": "OPEN",
    "type": "INTERNAL",
    "tokenFrom": "BTC",
    "chainTo": "BTC",
    "receivePubkey": "03668b5dc4f33dab92cd5b70c034a88e0d2510b14e39f3995245acb4d8723c2b35",
    "ownerAddress": "7Jw72Q9yGJ1UWCXdQcUwkwSX48mkvdV2sS",
    "amountFrom": 0.10000000,
    "amountToFill": 0.10000000,
    "orderPrice": 1.00000000,
    "amountToFillInToAsset": 0.10000000,
    "height": 476658,
    "expireHeight": 481658
  }
}

2. Taker makes an offer from type: INTERNAL output

Parameters:
orderTx: fe87… from output 1’s "type": INTERNAL output
ownerAddress: <taker’s DFI address>
amount: less than "amountFROM"
expiry: 240 refers to 240 minutes; 2 hours

% ./defi-cli -testnet -rpcport=8555 -rpcuser="FXdChSOx" -rpcpassword="..." icx_makeoffer '{"orderTx":"fe87484fd39b7f66eb8214df811ddbaaf3b934219c9452af2cf09fdc3b065c1b","amount":0.0001,"ownerAddress":"tqEw2Q9yGJ1UWCXdQcUwkwSX48mkvdV2sS","expiry":240}'

Example output

{
  "WARNING": "ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.",
  "txid": "bb4823b1321179c99163223f53b8b22168d9430e8f71e17ab968e378e1bfe824"
}

3. After a few minutes, check if maker accepted taker’s offer

Parameters:
txid: from output 2

% ./defi-cli ... icx_listhtlcs '{"offerTx":"bb4823b1321179c99163223f53b8b22168d9430e8f71e17ab968e378e1bfe824"}'

Example output

{
  "WARNING": "ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.",
  "2afa1a7c935548ffd6be9d550bb9c7f59da31b9a461bd6c3ad8ee11a50f8ac41": {
    "type": "DFC",
    "status": "OPEN",
    "offerTx": "bb4823b1321179c99163223f53b8b22168d9430e8f71e17ab968e378e1bfe824",
    "amount": 0.00010000,
    "amountInEXTAsset": 0.00010000,
    "hash": "a652273667e1de4af04ae580284be1994408c31461afc2936539260d491544af",
    "timeout": 1500,
    "height": 476766,
    "refundHeight": 478266
  }
}

4. With the above output, create HTLC (Hashed Timelock Contract) on SPV

Parameters (separate with a space):
Param 1 (the one who receives the BTC): Maker’s receivePubKey from output 1
Param 2: Taker’s receivePubKey (spv_getaddresspubkey) from Prerequisite Parameters
Param 3: timeout should be less than the order timeout number and larger than 24
Param 4: output 3’s hash

% ./defi-cli ... spv_createhtlc 03668b5dc4f33dab92cd5b70c034a88e0d2510b14e39f3995245acb4d8723c2b35 03a4728fae10976ad7b2288782e083d2204b16c0b631f3c82f37e22cbeae18zy70 30 a652273667e1de4af04ae580284be1994408c31461afc2936539260d491544af

Example output

{
  "address": "2N8uZ3s3P8GECXUV6rFukdkPzruRRhy4shf",
  "redeemScript": "63a820a652273667e1de4af04ae580284be1994408c31461afc2936539260d491544af882103668b5dc4f33dab92cd5b70c034a88e0d2510b14e39f3995245acb4d8723c2b3567011eb2752103a4728fae10976ad7b2288782e083d2204b16c0b631f3c82f37e22cbeae18ad6068ac"
}

5. Fund SPV HTLC address from output 4

Parameters (separate with a space):
Param 1: htlcScriptAddress from output 4
Param 2: amount from output 2

% ./defi-cli ... spv_sendtoaddress 2N8uZ3s3P8GECXUV6rFukdkPzruRRhy4shf 0.0001

Example output

{
  "txid": "6a0249e3848159f061203f86f64e82065ca36e25d331eb21dfb342f1fd989506",
  "sendmessage": "Undefined error: 0"
}

6. Submit external HTLC to DeFiChain

Parameters:
offerTx: from output 3
hash: from output 3
amount: from output 2
htlcScriptAddress: from output 4
ownerPubKey: Taker’s receivePubKey (spv_getaddresspubkey) from Prerequisite Parameters
timeout: same as output 4

% ./defi-cli ... icx_submitexthtlc '{"offerTx":"bb4823b1321179c99163223f53b8b22168d9430e8f71e17ab968e378e1bfe824","hash":"a652273667e1de4af04ae580284be1994408c31461afc2936539260d491544af","amount":"0.0001","htlcScriptAddress":"2N8uZ3s3P8GECXUV6rFukdkPzruRRhy4shf","ownerPubkey":"03a4728fae10976ad7b2288782e083d2204b16c0b631f3c82f37e22cbeae18zy70","timeout":30}'

Example output

{
  "WARNING": "ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.",
  "txid": "9fd8bd1e7b67afbfd5fe85dc06a9513278486517ac580af355075faca289825c"
}

7. Taker checks constantly if Maker claims the SPV HTLC

Parameters (separate with a space):
Param 1: htlcScriptAddress from output 4

% ./defi-cli ... spv_gethtlcseed 2N8uZ3s3P8GECXUV6rFukdkPzruRRhy4shf

Example output

26f5d9f68086e0bb3458d6f102a6b3bb66a1f70a4a439a3276362017bc1d5540

8. Taker to use seed to claim DeFiChain HTLC

Parameters:
dfchtlcTx: 2afa... from output 3; the string of numbers before "type": "DFC"
seed: from output 7

% ./defi-cli ... icx_claimdfchtlc '{"dfchtlcTx":"2afa1a7c935548ffd6be9d550bb9c7f59da31b9a461bd6c3ad8ee11a50f8ac41","seed":"26f5d9f68086e0bb3458d6f102a6b3bb66a1f70a4a439a3276362017bc1d5540"}'

Example output

{
  "WARNING": "ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.",
  "txid": "c95a90a92bbc275818f9d149b93ed9542f41e8b8e871efc88f708d60cf73c4e9"
}

You may check your transaction on DeFiChain Testnet Explorer: https://testnet.defichain.io/#/DFI/testnet/home

Footnote

• To retrieve latest version for defi-cli: go to https://github.com/DeFiCh/ain/releases
• To retrieve latest version for DeFi Wallet: go to https://github.com/DeFiCh/app/releases
• Warning: ICX and Atomic Swap are experimental features. You might end up losing your funds. USE IT AT YOUR OWN RISK.