Table of Contents

Confidential Assets Guide

Overview

Asset Methods
Asset Creation Example
Asset via Wallet RPC
Querying assets on chain
Requirements

Ionic Swaps Guide
CLI Methods Reference

burn_asset
deploy_new_asset
Parameters File
Command
emit_asset
Command
update_asset
Parameters File
Command

Wallet RPC Methods for Assets

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Confidential Assets Guide

Confidential Assets are privacy tokens on Lethean with all the features of the native LTHN coin. This guide covers asset creation, management, and Ionic Swaps.

Overview

Confidential Assets are privacy tokens with all the features of native Lethean coin

Confidential Assets Commands are availabe trough CLI interface (lethean-wallet-cli)

Asset Methods

Full list of supported commands available in the Methods section. Assets can be created, minted, burned, whitelisted and updated (only metadata)

Asset Creation Example

To deploy a new asset on the Lethean blockchain, you need to prepare a JSON-formatted file with asset parameters. Here’s an example:

{
  "ticker": "CT",
  "full_name": "Confidential token",
  "total_max_supply": 100000000000000000,
  "current_supply": 1000000000000000,
  "decimal_point": 12,
  "meta_info": ""
}

Then run the following command specifying the route to the file:

deploy_new_asset <asset specs file location>

You should see a confirmation message upon successful execution.

Asset via Wallet RPC

curl -X POST http://127.0.0.1:36944/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","method":"deploy_asset",
    "params":{
      "asset_descriptor":{
        "ticker":"TEST",
        "full_name":"Test Token",
        "total_max_supply":100000000000000000,
        "current_supply":1000000000000000,
        "decimal_point":12,
        "meta_info":"A test token on Lethean"
      }
    }
  }'

Querying assets on chain

## List all assets
curl -X POST http://127.0.0.1:36941/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"get_assets_list","params":{"offset":0,"count":100}}'

## Get specific asset info
curl -X POST http://127.0.0.1:36941/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"get_asset_info","params":{"asset_id":"ASSET_ID_HERE"}}'

The native LTHN asset ID is: d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a

Requirements

HF4 (Zarcanum) must be active — height 11,000 on testnet/mainnet
Deploying an asset requires LTHN for the transaction fee
Only the deployer (maintainer) can emit or burn the asset
Asset ownership can be transferred via transfer_asset_ownership

Verified: get_asset_info RPC tested on testnet — returns native LTHN asset with ticker "LTHN", decimal_point 12. Asset deployment requires HF4.

Ionic Swaps Guide

This example illustrates and explains the usage of a technology we call IonicSwap, which involves exchanging one asset for another within a single transaction.

Such a transaction is created collaboratively by two users using a secure trustless mechanism (see section 2.4 in whitepaper "Consolidated Transactions"). Initially, one user creates one part of the transaction, and then the second user adds the second part necessary for the transaction to become valid. Afterward, the transaction is sent to the network.

Traditionally, we will use the commonly used cryptographic designations for the parties involved - Initiator and Finalizer. Initiator will act as the initiator, creating the Ionic Swap Proposal and sending it to Finalizer, who will then make a decision whether to accept it or not.

Let's assume that the native token Lethean is circulating in the network with an asset_id of "d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a".

Additionally, let's assume that there is a token called CT with an asset_id of "e03a140b8447d2895290022b25c06bdabea514e2475ae56ce5bcbc554ab9865c".

Let's assume Initiator has the following address and balance in her wallet:

iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY
balance unlocked     / [balance total]       ticker   asset id
16387469.748                                  LTHN     d6329b5b....51a6498a
14.0                                          CT       e03a140b....4ab9865c

And Finalizer has a wallet with the following address and balance:

iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY
 balance unlocked     / [balance total]       ticker   asset id
   11738.97                                   LTHN     d6329b5b....51a6498a

Initiator is planning to offer Finalizer to exchange 2 coins of the CT token that she possesses (but Finalizer does not) for 10 native coins of LTHN (which Finalizer has). To do this, she generates a proposal through an API call ionic_swap_generate_proposal in her wallet with the following parameters:

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "ionic_swap_generate_proposal",
  "params": {
    "proposal": {
      "to_finalizer": [
        {
          "asset_id": "e03a140b8447d2895290022b25c06bdabea514e2475ae56ce5bcbc554ab9865c",
          "amount": 2000000000000
        }
      ],
      "to_initiator": [
        {
          "asset_id": "d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a",
          "amount": 10000000000000
        }
      ],
      "mixins": 10,
      "fee_paid_by_a": 10000000000,
      "expiration_time": 0
    },
    "destination_address": "iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzFiBiyR4dKG3j6534e9jMriY6SM7PH8NibVwVWW1DWJfQEWnSjS8n3Wgx86pQpY"
  }
}

As destination_address she set a Finalizer's wallet address, to make sure that he'll be able to decrypt payload data, that needed to finalise transaction and properly read it's details.

In fee_paid_by_a she specifies how much fee of this transaction Initiator willing to pay. If fee is not enough, Finalizer supposed to add more fee to fulfil network requirements

In a to_finalizer entry Initiator put list of assets that she wants to transfer to Finalizer, in our case it's only asset "CT" with asset_id "e03a140b8447d2895290022b25c06bdabea514e2475ae56ce5bcbc554ab9865c".

In a to_initiatorentry Alic put list of assets that she expect to get in exchange, in our case it's 10 coins of Lethean (native asset_id "d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a")

As a result of this API call Initiator receive proposal in raw hex format:

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "hex_raw_proposal": "000202250b1a834f0000000000001a7b230000000000001ae0060000000000001aac130000000000001a69500000000000001afa040000000000001a22110000000000001ad11e0000000000001a10070000000000001a8b0a0000000000001a5d14000000000000569db37a54d85d21f5c569bb1e0febcca0dbe53ff15679adf3771b3981255dd801110407250b1a39110000000000001ad4070000000000001aec1f0000000000001a770d0000000000001ad6170000000000001ae2160000000000001aff390000000000001aff0e0000000000001ac71c0000000000001ae2070000000000001aa60400000000000079856112b2c15d5aefb1898be49634bcaef59007846b768f9ba7709340869b5701110407070f001001165eef9fef396fad7229deb913793c3ab867ed1a4e27d696e1ebe401858e14aa571700000b02b0e20b02ad702700e40b54020000000426aa2d51cb9c96a5803a0186886c051f45800ed9b7784d7a86da6679accd71ede95ce5534238e1eaa7569981977901bcf50495474ef28ec5df5592bdf5a139b5de926e525f0c659868964292093d19d723d19c07f4b46dccd6dccad0e62964cfcb625de2d2cb821ec5804b13f601e72924dcb428a1cbeca1becb0d5ab5744effe008023327bdf8a39e0026590b3429a073d0fa54dd8d6ce7465e2dfa9121e75df349938ea5d8391c02c7c32db01f14b076d099ba30c280702cbf1a5b501263d9b775164332d02582f33a1610c9e09b454e265a00f118f81d92e0a5740d3e621762976603494f7e6e2ce5e6505011065873c185424ccb6bc94344116a7a83f16c34cbb5873bd2f9781a8ad16e8638d11a6acecf002621d8dfd0e90acccb36085232dc1403239e3f1409157fd4bfce85c098030cc53de57916d6461b939f72c5fce64f83436f78b492827ff871951dd085817586f4cfa27d74b635b059e21f0ffb998e17a0135aa0201302aa7c1c9b05a926b0185ac927e76f70345f50bc183c106455524943b22eacbae8aa418469d9abeda154fe48b2f32ff93f80de5f0026c2e4a55bb95e387610b64560ea19a5f5d49cdf98bfc1e09c7ee035771c674574b997e3a9877c1997a1c379b6f7502b30714808fbe1114c969e8766c7bfdc5b6b1c4870fddbdb25340a1d1faf36349227a8398345e63ea1f53e7677fed22cdd130e13186baab99aacdbf26fde0e68593cc03392d48316a96eed8e7c1c0b8c9bf72ac55c4a4c41a33e0000022bade112efdab69a6d9034457cb8cbd20855916e432f0e21c08808c2c030d91db95f0d818839ee396bdb04ca102affa6a481c8308c094e47a008c39234218523fc145d5f56a81a3162822f55cb652947d6b96f892746da5945822e7e31ee2fe9080b1e1739e7478f80a83fed48083497a2417b5dff4f68c046f768a13251960463081ec1a5c717590c6bad0c322cb843943afa9d39663102453ec9135ffa31540f00fefb23797685ad800e6b21c2cc4960d3aa2362469ab4c91c750038d775bae10b54b9c8a6ae0ef5404033abba075e1ef10591457964586eb5c87e6c50e7bf36049658f2809f199d0ebb15814110be62be439942e062dadb0d556706abafa1650ab4308b03ea8e26ba36f692ee6ca132dd38cbef9fac9278014b58afc4b2cb2c0dc065c6a796125adc1db765fcafd6a13a6e63310255d6b17baa9fa3320795360e69f93e1288155e9a88de1484291a38c2adea8678c20470377eb7e41861d8ed075c5eec28c9822c7df5f9dbec8722ea6e3f337835360e521913b8e0023658ab0f06c93ecba5c364f09aa688448bc45a4dcc0aaa68f137fea1d26a7d76fa2aef0dac86351529d72555347654d6e9383f0de367ed516ad5ed1bdc2ef95b94399f040b0030361df1289f59ed603b6caa3d6d5e699f2d1a1358a1bbf5ac2c7aca18ad06f7e4495a4c87a8d5efc1fdd12898230dd512f99536f11113a16b5ff1f529f101b040d98f46ecc46bd486b6cee40038b19575a155fe956c84274693c70bd3fd044cbada51d28cf4e6ac78e0b917420ef1fe6ea6c0f3bbf26d5fc075534a328f02ff332efba7d43e4a00d2a2de75a886743830b16667f516e89b9e3b8da79253093e65f0bb42fe0b2ca9e179aba709f4b40e59efde4e35049a9dc6550226da6703b14a81a3b021b0df1486df6e353cf1f84e85a56dff10410e046822945a033d0f6373145d7b125a6727d6419412fcfc3092999bb48df33561d2f4038043c5f80c1cb31b622eaa49184a5eb2dbaecf5f0d700d385bf2efa76e1924a671922f0a0093a4a389f955027e5dead32386f83e73e9ced6705ee5d0d6557d62ab68b5b90cc5d4e70f153ce169127b9c4353919522a0d50051f041d3d095dda37c5ac7330dbe3a8ff695a6cc04697bae5555484667f4846a02f71e5c616cff447db83e0e8d153c0691cb4dc39f79621dc0cb5365f95a09d71f125eff113971ff211959bb4d2b69d15f24de2de1f9605d66cafed790530926b7f644ff0167d3afeffbd3089aa41a33de8bc5f00f7ca9da416e898a9f414540c553eca35c74c6fb9545d1b94b8871ef859bb8f09c2a7c33e4dd6b59fae2381317d48bd960052b4bc08b0323ba020b34bafd86b9291e66aec22fd3a6d91621cbff1c4362f8fefe418d615c584a770cb4b529b043aff5e92762f4a647b21baacf7d537cd8fce2e9e5bb425cb49ff10302067dfb207acdc6ce237343c75331f776365403f66a573df0e502cc8bf5c20f4073ff178cf9be9f1c72814c4cab766148f06ad8ad3b4e931fe7bad941e25b0fe087f3aff200f712e03c72d27bbc3955b382288347d6a6ea1504227e6a3a21051440c1c6067a23f29bb2fef7d2b3f7b73cfac49c401f8356e524a0353faf49072af973d38b03cb3712d08b3db5bada8b00cd73339da8a10b827a62885308240a06befa382f23083f1be64ab06e89ac1e5d4543d82d80c8cdecc51cd368f1de020042f8f830f0f716d28e918a41c63ad66e4cd6a1ab99dbd52d428573195b3e0a61854b1b1c2c4cc297712a2be90857498c6e5d992f80ca7505646ca649301e0171b4c0e8a6fa325df8884650ec4140fc935336e05d58be0c2dbc43b686d0720d0bfaaf421156be195330aa2340a0b8286a1cf452ccd66220fb2016feb3da33010c0b24ec42f88ccfb71a04ccdfac3622e98c3ab3e06079a2d088d50299e900b40ac9029393bc178a86657e7c961e0e2fdc16fe06c8ba9c7750e67fb4de042a0a0e6f89865f07fcb7fe7b22e8148e82ede8e4db69a4d64b55f334057115e8d2d401ea0e010e53062638db08e74807235196e79881e6f9008cf778080b9efe9c770de10055bd24dd555628904331a74cc887fcc2649c8f8de619cdfa95d5809c8509071082c0af143791ea3665b9e2e03a381c1d501fd8d20e28e2d1f66821c806031578f9d3d5c9a44a3eb7749e8e93ac5856fb08a51e94bc7a816789065291da02cd6e54b6fd321c3f03052927800b2e2c601a68707f50b802c08320356620b70ba021945c79f63ad2a15e57f2d5d8aef0304bc1b05b8c18ca6b1b305f3931c40f54944d27c96cc052b15b89a3edf007a6b41658ab35ffe1b4b22d11d0e379900a49ade4f5a510d7eeb0c01aa924d5bf94b5911d3af6869ef3c6b86452e06cc4e8ff307937e52f529ceff9177377763ab206545c959c3d63253c3692bcfe29244600b91b4e14603319b158212c4c978259645f3151d830d73813241cd914b3400e9b5165e6913db036b194a5aa2e14f9cb4ba4e8b4b94ad16b3afe1910d55c02fcf527a894fd3f3390e2b1fa9a3c0e25c4ef61aa161be7de67876e9dfd91919fbab56a9cedcbd55cf874b0db399a55aa00ce4533e71b0cf888f6b1ed5e566d8d11be2666ad2358794c7fa14ab66e1020b9875e05ef5db754968730f6d1c26e56ad57a5d83beec765ef70bcc143d5c6813b4383d66776e86a9a8c10e874c3cc25ee4a93556c08197317829d48764c692397a0f7d8513ca72ffa0d99dc61d56e7cbd287586a477e1c117eb2bba48d22a022ca65eb8f9ccbd65f712c23ca87e7fd912e042d53a19ae0a094483b7cc1ea0e2ff9997d19cce35d87fe830154d9ef5b34be395e93723bd3a97fa764a45eca046affcd6cb6c1b9f9284c588c4a413c201ab89f56bf46ef7d061034b7e49af3117b9d315eb8b79b0b2bfc76de516cd45b56a221ce7e7234b194e7782bc38b8300d5b80f9695d43f80bc663b8e074a52598f471bc941de1a760fb72ab65b8c284f01b5726f9385217483c406da85535e3361d05b7d29d44c9bca6d47c95ae3b15d07612a580e6b5dfbbfbe3c23fefe8fae0917edfdb8cfbad974707f70d938d2edc02249ad65fc5c51a0a8de8c42e1a429561e586facfbea862a8f64e17da9fdbc69d247ff680b928fa76465300a917db68518e06e283e819cb140978c70eed7055f5c8171e749d3c2358e14b12c60985039c1f282dc6297e98be6c576a574f63b0c730057c480a96b6f3ff8aa2aaedc279013c3b57442766883186ecca1f9cb4ced42a57183ffbbd4997d40a66cac8be10c3415e4e604fa9ec41dd9ae41875054f80e7c8784bec1aa8f5ad1e5973e7a18b512c4cff1fa56712e8c7c5392dd49ccffec91f5ce5d5533a0868a31d2b7098b75a235666b51e67df85842501e1847693800929426307c7c15311b1fe2845c2f59b6c43412836cebab254046cd5e4f4823248c3b8abfaf2c8cdd5e42045769ebe5e1fb41ebbeae9df80002b64a48cd71dfe8a7c8dea7680ce9ffd8043c22cfb34e9a4c84dd874ad04e615a46be387b6c3aee27a1b25fded3f8a572cac0ac3fca5608448efc14d67771cdae2c32f97712b2b33efbeae7a47d9eb3f8cb8910a64863d672bf48a45dcf9cbff22ef227e31e232a3203af5cd53ff95401fbf99cc000ac452e34ea038ae7b8c239657cf432b9b5dffa7ee79a63f524ae57879693084ed5c5d912b529822149bb7dd6efbf951759127e3b6564c2d6155cdaa8b644d2b0c2e47625b462a10d13894c493299e7a7d850ebaee5cacfdf93308b5d7e2d5ead1acf5e51372629da9f8465ebd97c3c831cb1f68f8d9499f9afe4e1f7cadf6033d40c7c4957db287c3d571f89c45bf1a3102050bd58f745e967c9f593c08d184b081751a839777774999bfedc542d2fc2d2d59cef9afea56f57f62ff5da2886a6c79c0483b9146cf6af5c2f4cc830712915a88bcdd7c0659469f4640076470379f8ce25a24727ecf6c0266e43a451b97c1f4948a069e382d26f03307edd5d7858cf731cda19718244e809eefcf9564259d46452a24ce9e25618a82598625408689f3d16afb9db429e324038c69f47c0d0426e8e9bcab3d27e1843a08cc7c73e3549aea6bb020e6dd9c71bdc3b2e8e8d02df5d5350d408f07a9e2dea3cc9c44920db8a59f57b9ca5eef1103061a0e662c78bb1b33cb4f1bb09e52b9a66e0982cd30b4921a291ef176f3faad44df1a527fb74f432f5c608fb13abb32448c2b1460524168c9e895c00e39f8cefe8a17cbe0418d9c1660c0f8edb75bb93eeca06db5d521eca7e36e516168df900a56f30e3c9087c8e2004a66f5905d97942f79dae7d98f98d5bcf8246d4c13de457de3504ef1847d862de5416969bf54f07fb3764b0ff0287e7884c5e46a66932eb67f238d8f14e8051d36b90a21b999d61b1556463023282342fad093c9eb773b484c637f2525ba35591e0beb045f6307c3026bd594b975f3e870ec2100d5ebe831eef7a3c1f424986bd5252c686a22d71fa40217fdcd69a8c5dea752aee1e2a70523c49e844d514221066feeb7822b8ea3e96af7fe1a284c733d73de372c2754b17a8a9fc8fabc64e006ac637d3c8ce5ee21e1c3a22d6ae160a39731b358b18496c8b5c283115bec4b4915fd3ea4e0d24791a470252a49c45cc6f4173819fa94d9513d2af3ff295a307d3c000f6eca53b64ecf836f60a3c20bd83c13276c7a811e1e7f7f6beae79536a4110021cf4fa2778703380aec1e2ea4942c14c28aedb89c0f028bf22c8f3d123af6ebe07ba971927ecfd25925db4c902c80719e6c20080b14f23a2d2cc0d36c44e1c58aa4195bf9b283cd4c9f8fd6192be542b25e4bfd19ac23167f36cc40737c0f123026bc833d0f290db752a9162141fc6293623f5dd518b3a64ce8514373055208dceb7992e1a308631ef87aeeea3209078663ba4b7e3644a791a0203902df1d66da892161ca465a2240adc712a4c7886b434a5935d037d9c1aad9c92fa739d656e05219220f57e0685fbc9430242b36b62542f689031cf4b797c7cff76c0a05838befd435f2a5c92023a2e5aa5286e0ae024331519ac2d42e8020cbf545afd76553d3cacb96dcf278159bf2860826b4c4dfe199eea5b4e2a11096efbc9c9fb649c694449fb63446b1b7fcdb2e8154cc6aaf59557d85bab4e0aadc6d9da97f935c4b521a909ad4891f6a98dcac75d0b0f1f0718e1ed699a44b4fef3e472ec877230a956216a5fd01b23209fe3d77ae4722f18df128d44aa4a4f5603d9aa24468fd9a0f8f95d6467d936aff30dc5a30964d07338853d2bd8925d9763f41bf67bb551d4a7c6ef682ed40ea6c8ceaf85454ffe630e8658b41517923b26d0dac7f916f0e1bdb2db956d6bab16dee34bf648e816c45cac40b6b2e6a375aea5fd608ce1c85309ec648f26edc1fdeebe75e113adc845058bc0cbd7c8da64428ae42570c7811d9dfb541ded374e7e489b365ffda4afaeb99ca85289fe9560068d6d544c4f7540e4bba1b2fca478ab82b4015272833243b2e0896bd15156dcd2bdf07ee789a89f0bcaae43fec145b200ff9c96dbf9e039231dd1f57e66fe7d8501294c79899d84001f4241fe7967774485b576c53db74a7c53615db3b20ed2af360ac2d1e82f691e1b704e28c8c3bb12df083382f05a0d9037fda171fa87803fb8aa7d7c5ee1a1263dd6a6c4ad321373751204da88a58a666dd9abca9fac0daf318cc78358fef906ee59b319c0ebd8fff5798792186f45ec71e978fe734c909d8a83d9303139cdf8323ef61b6bd55389c6a09165b31ce6290318738a774d0f34dc2bb4d7a4e298ab19c9d93e4af0050f3cc40cd64e9090dc5abc17c6947f8496d8e768e31ed908370921f7613b29255fe08c94fd97ea971e0bf6a51283af23d9b59d2ee62d34055472f60f593ff951994f04fe16cdb1278fa4100195d84e6acb140d9a6121524775519e9b065b1e6492dd231d209b878643695e2c51641ce82ff6a81c829e7641adeedc167b5c9e44202b50173fb3114b5a5cf1929c7c417e122b448596210a5de3b515cd41ebaa49e2226099d8ba65ec8978bd2967d72a74aaf995a156a7521df75ad5f076edfbd84f6631d8b7ebd577f32d1d24d339ad7ca08d3ddd6bcb51e1f3f0bf9e54975f03a800031a6f8c67c9ed5d83202401fdf768005da53095545020b2327c315882e2b08e08c713e4fa9ea896d493a0f9ebba8108390dd6d7999b358e87d9a4f8552767cc6757f58df0b2c40ed2408bb01adbd4a21ebfeb2022439fd8b8bf080d47db29fe54e7ab1f6dff88de6c2d299893e6b9a707e597bf8b833fed78e5b0fa10583d94ea72804d7f4ef5070c5f54e6954233e717cf4a75b232df78b6426aa87dba26160f082a2e37174d0660c9b10fb3ce673ce63a13903c1c8fd5ccd7aab6ee94ea951e4ca5b9534177fc5b4edd69329cc2bb5395eff1586c79797bffd7262c39088c185753fa463899804b36e4014fa2415d00da6cb48ded2d60409b78dd83c483611f117f0df8b64911b4b4c26f0690dfac9c2358ae038d0bdd476e8f756099cb709074d08d3e23a9f7d413dd297b739387c6305485fc62ec8f9eebec10bd561e6a77242f1e518a54713946679fd701aaa7dd037f0ef3aa62a1bc0a427be64eb7c12652496f15a78a28724ce8aa368c18f2d1d8201c97243ec79b56248de5ad10096a958475a1b4a1585eb93009bb879b448d16d3e300a50af1aed549a00111ac5b0b137deb921fcfa996b368e8b074451dcc6c631d132b85e3e2eb59e627765c22dcb0ce8d7dbdcc6f842b672a098cb653b0554fcbbb873d3e46e372b1b8c8ae890352a44abfa968e8d4854558b8c65148ff0666b3873aa6d1bdb75615733201f0bf04781c3a9e07c52e65cb5971902d23ba04d70c3176162e1736654054cfe3517fe709e839b04c70e40717aa31936d34d904e38f487027f30d1060a67d65bffc144777a3d38167a31c28e321741f55489e9df21ad48136541d72a7a71725ca221c4a92185cf5407ea4d169401474545e919fc47b690a7f746743050e4a3e548c7e9a53e98a0c0eb29d33b94596187e2b49736d0f639f5ee13dd3b40df16b9bab9978d7f0307c3c5ad4f26d538ddd9853f032e94c2844725f3af38d8ff7cd49e9c07176beb3f9f042cf97f48b769034fe37ca0c34b1f23ffe1941b0de7267a65be8686bd44553de57baf6661a646d0d03a4938a35e33bf4b04639dfdf5524fc51eef0b29b7d280d6e3185f193eca862ce7579971c97161a73e5e2d8b34d1f04ea2a9dcac05f107d443995cb80e40fcd98dc613b074a5d2d36719f12af6b16c7541acb6d3c91626a4eb1bba020134774e23685c8396fe9e3da101942c6f1886721e8a2cef894e59599668bec20c636eeae906c600c6da137b1995a6"
  }
}

hex_raw_proposal contains proposal transaction template(half-creted transaction) and additional encrypted data, that would be needed by Finalizer if he'll be accepting this swap operation.

After Initiator got this response, she sends hex_raw_proposal to Finalizer by messenger/email or any other available channel.

After Finalizer receives the raw proposal from Initiator, his first step is to analyze the proposal and ensure that the transaction entails the conditions that suit him. To do this, he calls the API ionic_swap_get_proposal_info from his wallet and obtains the proposal details that are validated by his wallet using his keys. In our case request and response supposed to look like this:

Request:

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "ionic_swap_get_proposal_info",
  "params": {
    "hex_raw_proposal": "000202250b1a834f0000000000001a7b230000000000001ae0060000000000001aac130000000000001a69500000000000001afa040000000000001a22110000000000001ad11e0000000000001a10070000000000001a8b0a0000000000001a5d14000000000000569db37a54d85d21f5c569bb1e0febcca0dbe53ff15679adf3771b3981255dd801110407250b1a39110000000000001ad4070000000000001aec1f0000000000001a770d0000000000001ad6170000000000001ae2160000000000001aff390000000000001aff0e0000000000001ac71c0000000000001ae2070000000000001aa60400000000000079856112b2c15d5aefb1898be49634bcaef59007846b768f9ba7709340869b5701110407070f001001165eef9fef396fad7229deb913793c3ab867ed1a4e27d696e1ebe401858e14aa571700000b02b0e20b02ad702700e40b54020000000426aa2d51cb9c96a5803a0186886c051f45800ed9b7784d7a86da6679accd71ede95ce5534238e1eaa7569981977901bcf50495474ef28ec5df5592bdf5a139b5de926e525f0c659868964292093d19d723d19c07f4b46dccd6dccad0e62964cfcb625de2d2cb821ec5804b13f601e72924dcb428a1cbeca1becb0d5ab5744effe008023327bdf8a39e0026590b3429a073d0fa54dd8d6ce7465e2dfa9121e75df349938ea5d8391c02c7c32db01f14b076d099ba30c280702cbf1a5b501263d9b775164332d02582f33a1610c9e09b454e265a00f118f81d92e0a5740d3e621762976603494f7e6e2ce5e6505011065873c185424ccb6bc94344116a7a83f16c34cbb5873bd2f9781a8ad16e8638d11a6acecf002621d8dfd0e90acccb36085232dc1403239e3f1409157fd4bfce85c098030cc53de57916d6461b939f72c5fce64f83436f78b492827ff871951dd085817586f4cfa27d74b635b059e21f0ffb998e17a0135aa0201302aa7c1c9b05a926b0185ac927e76f70345f50bc183c106455524943b22eacbae8aa418469d9abeda154fe48b2f32ff93f80de5f0026c2e4a55bb95e387610b64560ea19a5f5d49cdf98bfc1e09c7ee035771c674574b997e3a9877c1997a1c379b6f7502b30714808fbe1114c969e8766c7bfdc5b6b1c4870fddbdb25340a1d1faf36349227a8398345e63ea1f53e7677fed22cdd130e13186baab99aacdbf26fde0e68593cc03392d48316a96eed8e7c1c0b8c9bf72ac55c4a4c41a33e0000022bade112efdab69a6d9034457cb8cbd20855916e432f0e21c08808c2c030d91db95f0d818839ee396bdb04ca102affa6a481c8308c094e47a008c39234218523fc145d5f56a81a3162822f55cb652947d6b96f892746da5945822e7e31ee2fe9080b1e1739e7478f80a83fed48083497a2417b5dff4f68c046f768a13251960463081ec1a5c717590c6bad0c322cb843943afa9d39663102453ec9135ffa31540f00fefb23797685ad800e6b21c2cc4960d3aa2362469ab4c91c750038d775bae10b54b9c8a6ae0ef5404033abba075e1ef10591457964586eb5c87e6c50e7bf36049658f2809f199d0ebb15814110be62be439942e062dadb0d556706abafa1650ab4308b03ea8e26ba36f692ee6ca132dd38cbef9fac9278014b58afc4b2cb2c0dc065c6a796125adc1db765fcafd6a13a6e63310255d6b17baa9fa3320795360e69f93e1288155e9a88de1484291a38c2adea8678c20470377eb7e41861d8ed075c5eec28c9822c7df5f9dbec8722ea6e3f337835360e521913b8e0023658ab0f06c93ecba5c364f09aa688448bc45a4dcc0aaa68f137fea1d26a7d76fa2aef0dac86351529d72555347654d6e9383f0de367ed516ad5ed1bdc2ef95b94399f040b0030361df1289f59ed603b6caa3d6d5e699f2d1a1358a1bbf5ac2c7aca18ad06f7e4495a4c87a8d5efc1fdd12898230dd512f99536f11113a16b5ff1f529f101b040d98f46ecc46bd486b6cee40038b19575a155fe956c84274693c70bd3fd044cbada51d28cf4e6ac78e0b917420ef1fe6ea6c0f3bbf26d5fc075534a328f02ff332efba7d43e4a00d2a2de75a886743830b16667f516e89b9e3b8da79253093e65f0bb42fe0b2ca9e179aba709f4b40e59efde4e35049a9dc6550226da6703b14a81a3b021b0df1486df6e353cf1f84e85a56dff10410e046822945a033d0f6373145d7b125a6727d6419412fcfc3092999bb48df33561d2f4038043c5f80c1cb31b622eaa49184a5eb2dbaecf5f0d700d385bf2efa76e1924a671922f0a0093a4a389f955027e5dead32386f83e73e9ced6705ee5d0d6557d62ab68b5b90cc5d4e70f153ce169127b9c4353919522a0d50051f041d3d095dda37c5ac7330dbe3a8ff695a6cc04697bae5555484667f4846a02f71e5c616cff447db83e0e8d153c0691cb4dc39f79621dc0cb5365f95a09d71f125eff113971ff211959bb4d2b69d15f24de2de1f9605d66cafed790530926b7f644ff0167d3afeffbd3089aa41a33de8bc5f00f7ca9da416e898a9f414540c553eca35c74c6fb9545d1b94b8871ef859bb8f09c2a7c33e4dd6b59fae2381317d48bd960052b4bc08b0323ba020b34bafd86b9291e66aec22fd3a6d91621cbff1c4362f8fefe418d615c584a770cb4b529b043aff5e92762f4a647b21baacf7d537cd8fce2e9e5bb425cb49ff10302067dfb207acdc6ce237343c75331f776365403f66a573df0e502cc8bf5c20f4073ff178cf9be9f1c72814c4cab766148f06ad8ad3b4e931fe7bad941e25b0fe087f3aff200f712e03c72d27bbc3955b382288347d6a6ea1504227e6a3a21051440c1c6067a23f29bb2fef7d2b3f7b73cfac49c401f8356e524a0353faf49072af973d38b03cb3712d08b3db5bada8b00cd73339da8a10b827a62885308240a06befa382f23083f1be64ab06e89ac1e5d4543d82d80c8cdecc51cd368f1de020042f8f830f0f716d28e918a41c63ad66e4cd6a1ab99dbd52d428573195b3e0a61854b1b1c2c4cc297712a2be90857498c6e5d992f80ca7505646ca649301e0171b4c0e8a6fa325df8884650ec4140fc935336e05d58be0c2dbc43b686d0720d0bfaaf421156be195330aa2340a0b8286a1cf452ccd66220fb2016feb3da33010c0b24ec42f88ccfb71a04ccdfac3622e98c3ab3e06079a2d088d50299e900b40ac9029393bc178a86657e7c961e0e2fdc16fe06c8ba9c7750e67fb4de042a0a0e6f89865f07fcb7fe7b22e8148e82ede8e4db69a4d64b55f334057115e8d2d401ea0e010e53062638db08e74807235196e79881e6f9008cf778080b9efe9c770de10055bd24dd555628904331a74cc887fcc2649c8f8de619cdfa95d5809c8509071082c0af143791ea3665b9e2e03a381c1d501fd8d20e28e2d1f66821c806031578f9d3d5c9a44a3eb7749e8e93ac5856fb08a51e94bc7a816789065291da02cd6e54b6fd321c3f03052927800b2e2c601a68707f50b802c08320356620b70ba021945c79f63ad2a15e57f2d5d8aef0304bc1b05b8c18ca6b1b305f3931c40f54944d27c96cc052b15b89a3edf007a6b41658ab35ffe1b4b22d11d0e379900a49ade4f5a510d7eeb0c01aa924d5bf94b5911d3af6869ef3c6b86452e06cc4e8ff307937e52f529ceff9177377763ab206545c959c3d63253c3692bcfe29244600b91b4e14603319b158212c4c978259645f3151d830d73813241cd914b3400e9b5165e6913db036b194a5aa2e14f9cb4ba4e8b4b94ad16b3afe1910d55c02fcf527a894fd3f3390e2b1fa9a3c0e25c4ef61aa161be7de67876e9dfd91919fbab56a9cedcbd55cf874b0db399a55aa00ce4533e71b0cf888f6b1ed5e566d8d11be2666ad2358794c7fa14ab66e1020b9875e05ef5db754968730f6d1c26e56ad57a5d83beec765ef70bcc143d5c6813b4383d66776e86a9a8c10e874c3cc25ee4a93556c08197317829d48764c692397a0f7d8513ca72ffa0d99dc61d56e7cbd287586a477e1c117eb2bba48d22a022ca65eb8f9ccbd65f712c23ca87e7fd912e042d53a19ae0a094483b7cc1ea0e2ff9997d19cce35d87fe830154d9ef5b34be395e93723bd3a97fa764a45eca046affcd6cb6c1b9f9284c588c4a413c201ab89f56bf46ef7d061034b7e49af3117b9d315eb8b79b0b2bfc76de516cd45b56a221ce7e7234b194e7782bc38b8300d5b80f9695d43f80bc663b8e074a52598f471bc941de1a760fb72ab65b8c284f01b5726f9385217483c406da85535e3361d05b7d29d44c9bca6d47c95ae3b15d07612a580e6b5dfbbfbe3c23fefe8fae0917edfdb8cfbad974707f70d938d2edc02249ad65fc5c51a0a8de8c42e1a429561e586facfbea862a8f64e17da9fdbc69d247ff680b928fa76465300a917db68518e06e283e819cb140978c70eed7055f5c8171e749d3c2358e14b12c60985039c1f282dc6297e98be6c576a574f63b0c730057c480a96b6f3ff8aa2aaedc279013c3b57442766883186ecca1f9cb4ced42a57183ffbbd4997d40a66cac8be10c3415e4e604fa9ec41dd9ae41875054f80e7c8784bec1aa8f5ad1e5973e7a18b512c4cff1fa56712e8c7c5392dd49ccffec91f5ce5d5533a0868a31d2b7098b75a235666b51e67df85842501e1847693800929426307c7c15311b1fe2845c2f59b6c43412836cebab254046cd5e4f4823248c3b8abfaf2c8cdd5e42045769ebe5e1fb41ebbeae9df80002b64a48cd71dfe8a7c8dea7680ce9ffd8043c22cfb34e9a4c84dd874ad04e615a46be387b6c3aee27a1b25fded3f8a572cac0ac3fca5608448efc14d67771cdae2c32f97712b2b33efbeae7a47d9eb3f8cb8910a64863d672bf48a45dcf9cbff22ef227e31e232a3203af5cd53ff95401fbf99cc000ac452e34ea038ae7b8c239657cf432b9b5dffa7ee79a63f524ae57879693084ed5c5d912b529822149bb7dd6efbf951759127e3b6564c2d6155cdaa8b644d2b0c2e47625b462a10d13894c493299e7a7d850ebaee5cacfdf93308b5d7e2d5ead1acf5e51372629da9f8465ebd97c3c831cb1f68f8d9499f9afe4e1f7cadf6033d40c7c4957db287c3d571f89c45bf1a3102050bd58f745e967c9f593c08d184b081751a839777774999bfedc542d2fc2d2d59cef9afea56f57f62ff5da2886a6c79c0483b9146cf6af5c2f4cc830712915a88bcdd7c0659469f4640076470379f8ce25a24727ecf6c0266e43a451b97c1f4948a069e382d26f03307edd5d7858cf731cda19718244e809eefcf9564259d46452a24ce9e25618a82598625408689f3d16afb9db429e324038c69f47c0d0426e8e9bcab3d27e1843a08cc7c73e3549aea6bb020e6dd9c71bdc3b2e8e8d02df5d5350d408f07a9e2dea3cc9c44920db8a59f57b9ca5eef1103061a0e662c78bb1b33cb4f1bb09e52b9a66e0982cd30b4921a291ef176f3faad44df1a527fb74f432f5c608fb13abb32448c2b1460524168c9e895c00e39f8cefe8a17cbe0418d9c1660c0f8edb75bb93eeca06db5d521eca7e36e516168df900a56f30e3c9087c8e2004a66f5905d97942f79dae7d98f98d5bcf8246d4c13de457de3504ef1847d862de5416969bf54f07fb3764b0ff0287e7884c5e46a66932eb67f238d8f14e8051d36b90a21b999d61b1556463023282342fad093c9eb773b484c637f2525ba35591e0beb045f6307c3026bd594b975f3e870ec2100d5ebe831eef7a3c1f424986bd5252c686a22d71fa40217fdcd69a8c5dea752aee1e2a70523c49e844d514221066feeb7822b8ea3e96af7fe1a284c733d73de372c2754b17a8a9fc8fabc64e006ac637d3c8ce5ee21e1c3a22d6ae160a39731b358b18496c8b5c283115bec4b4915fd3ea4e0d24791a470252a49c45cc6f4173819fa94d9513d2af3ff295a307d3c000f6eca53b64ecf836f60a3c20bd83c13276c7a811e1e7f7f6beae79536a4110021cf4fa2778703380aec1e2ea4942c14c28aedb89c0f028bf22c8f3d123af6ebe07ba971927ecfd25925db4c902c80719e6c20080b14f23a2d2cc0d36c44e1c58aa4195bf9b283cd4c9f8fd6192be542b25e4bfd19ac23167f36cc40737c0f123026bc833d0f290db752a9162141fc6293623f5dd518b3a64ce8514373055208dceb7992e1a308631ef87aeeea3209078663ba4b7e3644a791a0203902df1d66da892161ca465a2240adc712a4c7886b434a5935d037d9c1aad9c92fa739d656e05219220f57e0685fbc9430242b36b62542f689031cf4b797c7cff76c0a05838befd435f2a5c92023a2e5aa5286e0ae024331519ac2d42e8020cbf545afd76553d3cacb96dcf278159bf2860826b4c4dfe199eea5b4e2a11096efbc9c9fb649c694449fb63446b1b7fcdb2e8154cc6aaf59557d85bab4e0aadc6d9da97f935c4b521a909ad4891f6a98dcac75d0b0f1f0718e1ed699a44b4fef3e472ec877230a956216a5fd01b23209fe3d77ae4722f18df128d44aa4a4f5603d9aa24468fd9a0f8f95d6467d936aff30dc5a30964d07338853d2bd8925d9763f41bf67bb551d4a7c6ef682ed40ea6c8ceaf85454ffe630e8658b41517923b26d0dac7f916f0e1bdb2db956d6bab16dee34bf648e816c45cac40b6b2e6a375aea5fd608ce1c85309ec648f26edc1fdeebe75e113adc845058bc0cbd7c8da64428ae42570c7811d9dfb541ded374e7e489b365ffda4afaeb99ca85289fe9560068d6d544c4f7540e4bba1b2fca478ab82b4015272833243b2e0896bd15156dcd2bdf07ee789a89f0bcaae43fec145b200ff9c96dbf9e039231dd1f57e66fe7d8501294c79899d84001f4241fe7967774485b576c53db74a7c53615db3b20ed2af360ac2d1e82f691e1b704e28c8c3bb12df083382f05a0d9037fda171fa87803fb8aa7d7c5ee1a1263dd6a6c4ad321373751204da88a58a666dd9abca9fac0daf318cc78358fef906ee59b319c0ebd8fff5798792186f45ec71e978fe734c909d8a83d9303139cdf8323ef61b6bd55389c6a09165b31ce6290318738a774d0f34dc2bb4d7a4e298ab19c9d93e4af0050f3cc40cd64e9090dc5abc17c6947f8496d8e768e31ed908370921f7613b29255fe08c94fd97ea971e0bf6a51283af23d9b59d2ee62d34055472f60f593ff951994f04fe16cdb1278fa4100195d84e6acb140d9a6121524775519e9b065b1e6492dd231d209b878643695e2c51641ce82ff6a81c829e7641adeedc167b5c9e44202b50173fb3114b5a5cf1929c7c417e122b448596210a5de3b515cd41ebaa49e2226099d8ba65ec8978bd2967d72a74aaf995a156a7521df75ad5f076edfbd84f6631d8b7ebd577f32d1d24d339ad7ca08d3ddd6bcb51e1f3f0bf9e54975f03a800031a6f8c67c9ed5d83202401fdf768005da53095545020b2327c315882e2b08e08c713e4fa9ea896d493a0f9ebba8108390dd6d7999b358e87d9a4f8552767cc6757f58df0b2c40ed2408bb01adbd4a21ebfeb2022439fd8b8bf080d47db29fe54e7ab1f6dff88de6c2d299893e6b9a707e597bf8b833fed78e5b0fa10583d94ea72804d7f4ef5070c5f54e6954233e717cf4a75b232df78b6426aa87dba26160f082a2e37174d0660c9b10fb3ce673ce63a13903c1c8fd5ccd7aab6ee94ea951e4ca5b9534177fc5b4edd69329cc2bb5395eff1586c79797bffd7262c39088c185753fa463899804b36e4014fa2415d00da6cb48ded2d60409b78dd83c483611f117f0df8b64911b4b4c26f0690dfac9c2358ae038d0bdd476e8f756099cb709074d08d3e23a9f7d413dd297b739387c6305485fc62ec8f9eebec10bd561e6a77242f1e518a54713946679fd701aaa7dd037f0ef3aa62a1bc0a427be64eb7c12652496f15a78a28724ce8aa368c18f2d1d8201c97243ec79b56248de5ad10096a958475a1b4a1585eb93009bb879b448d16d3e300a50af1aed549a00111ac5b0b137deb921fcfa996b368e8b074451dcc6c631d132b85e3e2eb59e627765c22dcb0ce8d7dbdcc6f842b672a098cb653b0554fcbbb873d3e46e372b1b8c8ae890352a44abfa968e8d4854558b8c65148ff0666b3873aa6d1bdb75615733201f0bf04781c3a9e07c52e65cb5971902d23ba04d70c3176162e1736654054cfe3517fe709e839b04c70e40717aa31936d34d904e38f487027f30d1060a67d65bffc144777a3d38167a31c28e321741f55489e9df21ad48136541d72a7a71725ca221c4a92185cf5407ea4d169401474545e919fc47b690a7f746743050e4a3e548c7e9a53e98a0c0eb29d33b94596187e2b49736d0f639f5ee13dd3b40df16b9bab9978d7f0307c3c5ad4f26d538ddd9853f032e94c2844725f3af38d8ff7cd49e9c07176beb3f9f042cf97f48b769034fe37ca0c34b1f23ffe1941b0de7267a65be8686bd44553de57baf6661a646d0d03a4938a35e33bf4b04639dfdf5524fc51eef0b29b7d280d6e3185f193eca862ce7579971c97161a73e5e2d8b34d1f04ea2a9dcac05f107d443995cb80e40fcd98dc613b074a5d2d36719f12af6b16c7541acb6d3c91626a4eb1bba020134774e23685c8396fe9e3da101942c6f1886721e8a2cef894e59599668bec20c636eeae906c600c6da137b1995a6"
  }
}

Response:

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "proposal": {
      "expiration_time": 0,
      "fee_paid_by_a": 10000000000,
      "mixins": 10,
      "to_initiator": [
        {
          "amount": 10000000000000,
          "asset_id": "d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a"
        }
      ],
      "to_finalizer": [
        {
          "amount": 2000000000000,
          "asset_id": "e03a140b8447d2895290022b25c06bdabea514e2475ae56ce5bcbc554ab9865c"
        }
      ]
    }
  }
}

🚧 IMPORTANT

It is critically important for Finalizer to analyze this structure and ensure that the conditions described therein perfectly reflect his intentions regarding the upcoming swap transaction.

After Finalizer reviewed structure of the proposal, he call API ionic_swap_accept_proposal and by calling this he execute the swap operation.

Request:

{
  "jsonrpc": "2.0",
  "id": "0",
  "method": "ionic_swap_accept_proposal",
  "params": {
    "hex_raw_proposal": "000202250b1a834f0000000000001a7b230000000000001ae0060000000000001aac130000000000001a69500000000000001afa040000000000001a22110000000000001ad11e0000000000001a10070000000000001a8b0a0000000000001a5d14000000000000569db37a54d85d21f5c569bb1e0febcca0dbe53ff15679adf3771b3981255dd801110407250b1a39110000000000001ad4070000000000001aec1f0000000000001a770d0000000000001ad6170000000000001ae2160000000000001aff390000000000001aff0e0000000000001ac71c0000000000001ae2070000000000001aa60400000000000079856112b2c15d5aefb1898be49634bcaef59007846b768f9ba7709340869b5701110407070f001001165eef9fef396fad7229deb913793c3ab867ed1a4e27d696e1ebe401858e14aa571700000b02b0e20b02ad702700e40b54020000000426aa2d51cb9c96a5803a0186886c051f45800ed9b7784d7a86da6679accd71ede95ce5534238e1eaa7569981977901bcf50495474ef28ec5df5592bdf5a139b5de926e525f0c659868964292093d19d723d19c07f4b46dccd6dccad0e62964cfcb625de2d2cb821ec5804b13f601e72924dcb428a1cbeca1becb0d5ab5744effe008023327bdf8a39e0026590b3429a073d0fa54dd8d6ce7465e2dfa9121e75df349938ea5d8391c02c7c32db01f14b076d099ba30c280702cbf1a5b501263d9b775164332d02582f33a1610c9e09b454e265a00f118f81d92e0a5740d3e621762976603494f7e6e2ce5e6505011065873c185424ccb6bc94344116a7a83f16c34cbb5873bd2f9781a8ad16e8638d11a6acecf002621d8dfd0e90acccb36085232dc1403239e3f1409157fd4bfce85c098030cc53de57916d6461b939f72c5fce64f83436f78b492827ff871951dd085817586f4cfa27d74b635b059e21f0ffb998e17a0135aa0201302aa7c1c9b05a926b0185ac927e76f70345f50bc183c106455524943b22eacbae8aa418469d9abeda154fe48b2f32ff93f80de5f0026c2e4a55bb95e387610b64560ea19a5f5d49cdf98bfc1e09c7ee035771c674574b997e3a9877c1997a1c379b6f7502b30714808fbe1114c969e8766c7bfdc5b6b1c4870fddbdb25340a1d1faf36349227a8398345e63ea1f53e7677fed22cdd130e13186baab99aacdbf26fde0e68593cc03392d48316a96eed8e7c1c0b8c9bf72ac55c4a4c41a33e0000022bade112efdab69a6d9034457cb8cbd20855916e432f0e21c08808c2c030d91db95f0d818839ee396bdb04ca102affa6a481c8308c094e47a008c39234218523fc145d5f56a81a3162822f55cb652947d6b96f892746da5945822e7e31ee2fe9080b1e1739e7478f80a83fed48083497a2417b5dff4f68c046f768a13251960463081ec1a5c717590c6bad0c322cb843943afa9d39663102453ec9135ffa31540f00fefb23797685ad800e6b21c2cc4960d3aa2362469ab4c91c750038d775bae10b54b9c8a6ae0ef5404033abba075e1ef10591457964586eb5c87e6c50e7bf36049658f2809f199d0ebb15814110be62be439942e062dadb0d556706abafa1650ab4308b03ea8e26ba36f692ee6ca132dd38cbef9fac9278014b58afc4b2cb2c0dc065c6a796125adc1db765fcafd6a13a6e63310255d6b17baa9fa3320795360e69f93e1288155e9a88de1484291a38c2adea8678c20470377eb7e41861d8ed075c5eec28c9822c7df5f9dbec8722ea6e3f337835360e521913b8e0023658ab0f06c93ecba5c364f09aa688448bc45a4dcc0aaa68f137fea1d26a7d76fa2aef0dac86351529d72555347654d6e9383f0de367ed516ad5ed1bdc2ef95b94399f040b0030361df1289f59ed603b6caa3d6d5e699f2d1a1358a1bbf5ac2c7aca18ad06f7e4495a4c87a8d5efc1fdd12898230dd512f99536f11113a16b5ff1f529f101b040d98f46ecc46bd486b6cee40038b19575a155fe956c84274693c70bd3fd044cbada51d28cf4e6ac78e0b917420ef1fe6ea6c0f3bbf26d5fc075534a328f02ff332efba7d43e4a00d2a2de75a886743830b16667f516e89b9e3b8da79253093e65f0bb42fe0b2ca9e179aba709f4b40e59efde4e35049a9dc6550226da6703b14a81a3b021b0df1486df6e353cf1f84e85a56dff10410e046822945a033d0f6373145d7b125a6727d6419412fcfc3092999bb48df33561d2f4038043c5f80c1cb31b622eaa49184a5eb2dbaecf5f0d700d385bf2efa76e1924a671922f0a0093a4a389f955027e5dead32386f83e73e9ced6705ee5d0d6557d62ab68b5b90cc5d4e70f153ce169127b9c4353919522a0d50051f041d3d095dda37c5ac7330dbe3a8ff695a6cc04697bae5555484667f4846a02f71e5c616cff447db83e0e8d153c0691cb4dc39f79621dc0cb5365f95a09d71f125eff113971ff211959bb4d2b69d15f24de2de1f9605d66cafed790530926b7f644ff0167d3afeffbd3089aa41a33de8bc5f00f7ca9da416e898a9f414540c553eca35c74c6fb9545d1b94b8871ef859bb8f09c2a7c33e4dd6b59fae2381317d48bd960052b4bc08b0323ba020b34bafd86b9291e66aec22fd3a6d91621cbff1c4362f8fefe418d615c584a770cb4b529b043aff5e92762f4a647b21baacf7d537cd8fce2e9e5bb425cb49ff10302067dfb207acdc6ce237343c75331f776365403f66a573df0e502cc8bf5c20f4073ff178cf9be9f1c72814c4cab766148f06ad8ad3b4e931fe7bad941e25b0fe087f3aff200f712e03c72d27bbc3955b382288347d6a6ea1504227e6a3a21051440c1c6067a23f29bb2fef7d2b3f7b73cfac49c401f8356e524a0353faf49072af973d38b03cb3712d08b3db5bada8b00cd73339da8a10b827a62885308240a06befa382f23083f1be64ab06e89ac1e5d4543d82d80c8cdecc51cd368f1de020042f8f830f0f716d28e918a41c63ad66e4cd6a1ab99dbd52d428573195b3e0a61854b1b1c2c4cc297712a2be90857498c6e5d992f80ca7505646ca649301e0171b4c0e8a6fa325df8884650ec4140fc935336e05d58be0c2dbc43b686d0720d0bfaaf421156be195330aa2340a0b8286a1cf452ccd66220fb2016feb3da33010c0b24ec42f88ccfb71a04ccdfac3622e98c3ab3e06079a2d088d50299e900b40ac9029393bc178a86657e7c961e0e2fdc16fe06c8ba9c7750e67fb4de042a0a0e6f89865f07fcb7fe7b22e8148e82ede8e4db69a4d64b55f334057115e8d2d401ea0e010e53062638db08e74807235196e79881e6f9008cf778080b9efe9c770de10055bd24dd555628904331a74cc887fcc2649c8f8de619cdfa95d5809c8509071082c0af143791ea3665b9e2e03a381c1d501fd8d20e28e2d1f66821c806031578f9d3d5c9a44a3eb7749e8e93ac5856fb08a51e94bc7a816789065291da02cd6e54b6fd321c3f03052927800b2e2c601a68707f50b802c08320356620b70ba021945c79f63ad2a15e57f2d5d8aef0304bc1b05b8c18ca6b1b305f3931c40f54944d27c96cc052b15b89a3edf007a6b41658ab35ffe1b4b22d11d0e379900a49ade4f5a510d7eeb0c01aa924d5bf94b5911d3af6869ef3c6b86452e06cc4e8ff307937e52f529ceff9177377763ab206545c959c3d63253c3692bcfe29244600b91b4e14603319b158212c4c978259645f3151d830d73813241cd914b3400e9b5165e6913db036b194a5aa2e14f9cb4ba4e8b4b94ad16b3afe1910d55c02fcf527a894fd3f3390e2b1fa9a3c0e25c4ef61aa161be7de67876e9dfd91919fbab56a9cedcbd55cf874b0db399a55aa00ce4533e71b0cf888f6b1ed5e566d8d11be2666ad2358794c7fa14ab66e1020b9875e05ef5db754968730f6d1c26e56ad57a5d83beec765ef70bcc143d5c6813b4383d66776e86a9a8c10e874c3cc25ee4a93556c08197317829d48764c692397a0f7d8513ca72ffa0d99dc61d56e7cbd287586a477e1c117eb2bba48d22a022ca65eb8f9ccbd65f712c23ca87e7fd912e042d53a19ae0a094483b7cc1ea0e2ff9997d19cce35d87fe830154d9ef5b34be395e93723bd3a97fa764a45eca046affcd6cb6c1b9f9284c588c4a413c201ab89f56bf46ef7d061034b7e49af3117b9d315eb8b79b0b2bfc76de516cd45b56a221ce7e7234b194e7782bc38b8300d5b80f9695d43f80bc663b8e074a52598f471bc941de1a760fb72ab65b8c284f01b5726f9385217483c406da85535e3361d05b7d29d44c9bca6d47c95ae3b15d07612a580e6b5dfbbfbe3c23fefe8fae0917edfdb8cfbad974707f70d938d2edc02249ad65fc5c51a0a8de8c42e1a429561e586facfbea862a8f64e17da9fdbc69d247ff680b928fa76465300a917db68518e06e283e819cb140978c70eed7055f5c8171e749d3c2358e14b12c60985039c1f282dc6297e98be6c576a574f63b0c730057c480a96b6f3ff8aa2aaedc279013c3b57442766883186ecca1f9cb4ced42a57183ffbbd4997d40a66cac8be10c3415e4e604fa9ec41dd9ae41875054f80e7c8784bec1aa8f5ad1e5973e7a18b512c4cff1fa56712e8c7c5392dd49ccffec91f5ce5d5533a0868a31d2b7098b75a235666b51e67df85842501e1847693800929426307c7c15311b1fe2845c2f59b6c43412836cebab254046cd5e4f4823248c3b8abfaf2c8cdd5e42045769ebe5e1fb41ebbeae9df80002b64a48cd71dfe8a7c8dea7680ce9ffd8043c22cfb34e9a4c84dd874ad04e615a46be387b6c3aee27a1b25fded3f8a572cac0ac3fca5608448efc14d67771cdae2c32f97712b2b33efbeae7a47d9eb3f8cb8910a64863d672bf48a45dcf9cbff22ef227e31e232a3203af5cd53ff95401fbf99cc000ac452e34ea038ae7b8c239657cf432b9b5dffa7ee79a63f524ae57879693084ed5c5d912b529822149bb7dd6efbf951759127e3b6564c2d6155cdaa8b644d2b0c2e47625b462a10d13894c493299e7a7d850ebaee5cacfdf93308b5d7e2d5ead1acf5e51372629da9f8465ebd97c3c831cb1f68f8d9499f9afe4e1f7cadf6033d40c7c4957db287c3d571f89c45bf1a3102050bd58f745e967c9f593c08d184b081751a839777774999bfedc542d2fc2d2d59cef9afea56f57f62ff5da2886a6c79c0483b9146cf6af5c2f4cc830712915a88bcdd7c0659469f4640076470379f8ce25a24727ecf6c0266e43a451b97c1f4948a069e382d26f03307edd5d7858cf731cda19718244e809eefcf9564259d46452a24ce9e25618a82598625408689f3d16afb9db429e324038c69f47c0d0426e8e9bcab3d27e1843a08cc7c73e3549aea6bb020e6dd9c71bdc3b2e8e8d02df5d5350d408f07a9e2dea3cc9c44920db8a59f57b9ca5eef1103061a0e662c78bb1b33cb4f1bb09e52b9a66e0982cd30b4921a291ef176f3faad44df1a527fb74f432f5c608fb13abb32448c2b1460524168c9e895c00e39f8cefe8a17cbe0418d9c1660c0f8edb75bb93eeca06db5d521eca7e36e516168df900a56f30e3c9087c8e2004a66f5905d97942f79dae7d98f98d5bcf8246d4c13de457de3504ef1847d862de5416969bf54f07fb3764b0ff0287e7884c5e46a66932eb67f238d8f14e8051d36b90a21b999d61b1556463023282342fad093c9eb773b484c637f2525ba35591e0beb045f6307c3026bd594b975f3e870ec2100d5ebe831eef7a3c1f424986bd5252c686a22d71fa40217fdcd69a8c5dea752aee1e2a70523c49e844d514221066feeb7822b8ea3e96af7fe1a284c733d73de372c2754b17a8a9fc8fabc64e006ac637d3c8ce5ee21e1c3a22d6ae160a39731b358b18496c8b5c283115bec4b4915fd3ea4e0d24791a470252a49c45cc6f4173819fa94d9513d2af3ff295a307d3c000f6eca53b64ecf836f60a3c20bd83c13276c7a811e1e7f7f6beae79536a4110021cf4fa2778703380aec1e2ea4942c14c28aedb89c0f028bf22c8f3d123af6ebe07ba971927ecfd25925db4c902c80719e6c20080b14f23a2d2cc0d36c44e1c58aa4195bf9b283cd4c9f8fd6192be542b25e4bfd19ac23167f36cc40737c0f123026bc833d0f290db752a9162141fc6293623f5dd518b3a64ce8514373055208dceb7992e1a308631ef87aeeea3209078663ba4b7e3644a791a0203902df1d66da892161ca465a2240adc712a4c7886b434a5935d037d9c1aad9c92fa739d656e05219220f57e0685fbc9430242b36b62542f689031cf4b797c7cff76c0a05838befd435f2a5c92023a2e5aa5286e0ae024331519ac2d42e8020cbf545afd76553d3cacb96dcf278159bf2860826b4c4dfe199eea5b4e2a11096efbc9c9fb649c694449fb63446b1b7fcdb2e8154cc6aaf59557d85bab4e0aadc6d9da97f935c4b521a909ad4891f6a98dcac75d0b0f1f0718e1ed699a44b4fef3e472ec877230a956216a5fd01b23209fe3d77ae4722f18df128d44aa4a4f5603d9aa24468fd9a0f8f95d6467d936aff30dc5a30964d07338853d2bd8925d9763f41bf67bb551d4a7c6ef682ed40ea6c8ceaf85454ffe630e8658b41517923b26d0dac7f916f0e1bdb2db956d6bab16dee34bf648e816c45cac40b6b2e6a375aea5fd608ce1c85309ec648f26edc1fdeebe75e113adc845058bc0cbd7c8da64428ae42570c7811d9dfb541ded374e7e489b365ffda4afaeb99ca85289fe9560068d6d544c4f7540e4bba1b2fca478ab82b4015272833243b2e0896bd15156dcd2bdf07ee789a89f0bcaae43fec145b200ff9c96dbf9e039231dd1f57e66fe7d8501294c79899d84001f4241fe7967774485b576c53db74a7c53615db3b20ed2af360ac2d1e82f691e1b704e28c8c3bb12df083382f05a0d9037fda171fa87803fb8aa7d7c5ee1a1263dd6a6c4ad321373751204da88a58a666dd9abca9fac0daf318cc78358fef906ee59b319c0ebd8fff5798792186f45ec71e978fe734c909d8a83d9303139cdf8323ef61b6bd55389c6a09165b31ce6290318738a774d0f34dc2bb4d7a4e298ab19c9d93e4af0050f3cc40cd64e9090dc5abc17c6947f8496d8e768e31ed908370921f7613b29255fe08c94fd97ea971e0bf6a51283af23d9b59d2ee62d34055472f60f593ff951994f04fe16cdb1278fa4100195d84e6acb140d9a6121524775519e9b065b1e6492dd231d209b878643695e2c51641ce82ff6a81c829e7641adeedc167b5c9e44202b50173fb3114b5a5cf1929c7c417e122b448596210a5de3b515cd41ebaa49e2226099d8ba65ec8978bd2967d72a74aaf995a156a7521df75ad5f076edfbd84f6631d8b7ebd577f32d1d24d339ad7ca08d3ddd6bcb51e1f3f0bf9e54975f03a800031a6f8c67c9ed5d83202401fdf768005da53095545020b2327c315882e2b08e08c713e4fa9ea896d493a0f9ebba8108390dd6d7999b358e87d9a4f8552767cc6757f58df0b2c40ed2408bb01adbd4a21ebfeb2022439fd8b8bf080d47db29fe54e7ab1f6dff88de6c2d299893e6b9a707e597bf8b833fed78e5b0fa10583d94ea72804d7f4ef5070c5f54e6954233e717cf4a75b232df78b6426aa87dba26160f082a2e37174d0660c9b10fb3ce673ce63a13903c1c8fd5ccd7aab6ee94ea951e4ca5b9534177fc5b4edd69329cc2bb5395eff1586c79797bffd7262c39088c185753fa463899804b36e4014fa2415d00da6cb48ded2d60409b78dd83c483611f117f0df8b64911b4b4c26f0690dfac9c2358ae038d0bdd476e8f756099cb709074d08d3e23a9f7d413dd297b739387c6305485fc62ec8f9eebec10bd561e6a77242f1e518a54713946679fd701aaa7dd037f0ef3aa62a1bc0a427be64eb7c12652496f15a78a28724ce8aa368c18f2d1d8201c97243ec79b56248de5ad10096a958475a1b4a1585eb93009bb879b448d16d3e300a50af1aed549a00111ac5b0b137deb921fcfa996b368e8b074451dcc6c631d132b85e3e2eb59e627765c22dcb0ce8d7dbdcc6f842b672a098cb653b0554fcbbb873d3e46e372b1b8c8ae890352a44abfa968e8d4854558b8c65148ff0666b3873aa6d1bdb75615733201f0bf04781c3a9e07c52e65cb5971902d23ba04d70c3176162e1736654054cfe3517fe709e839b04c70e40717aa31936d34d904e38f487027f30d1060a67d65bffc144777a3d38167a31c28e321741f55489e9df21ad48136541d72a7a71725ca221c4a92185cf5407ea4d169401474545e919fc47b690a7f746743050e4a3e548c7e9a53e98a0c0eb29d33b94596187e2b49736d0f639f5ee13dd3b40df16b9bab9978d7f0307c3c5ad4f26d538ddd9853f032e94c2844725f3af38d8ff7cd49e9c07176beb3f9f042cf97f48b769034fe37ca0c34b1f23ffe1941b0de7267a65be8686bd44553de57baf6661a646d0d03a4938a35e33bf4b04639dfdf5524fc51eef0b29b7d280d6e3185f193eca862ce7579971c97161a73e5e2d8b34d1f04ea2a9dcac05f107d443995cb80e40fcd98dc613b074a5d2d36719f12af6b16c7541acb6d3c91626a4eb1bba020134774e23685c8396fe9e3da101942c6f1886721e8a2cef894e59599668bec20c636eeae906c600c6da137b1995a6"
  }
}

Response:

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "result_tx_id": "c08522c94355524cc8a1fa1514419814e99989ba503382256cbffc39a733a186"
  }
}

This operation is irreversible. Upon confirmation, the balances of both parties should be updated according to the swap structure.

After swap tx got confirmed,Initiator balance change would look like this:

height 42712, tx c08522c94355524cc8a1fa1514419814e99989ba503382256cbffc39a733a186
           2.0            spent CT[*]
           9.99           received, LTHN
Refresh done, blocks received: 42775
 balance unlocked     / [balance total]       ticker   asset id
 16387479.738                                  LTHN     d6329b5b....51a6498a
 12.0                                          CT       e03a140b....4ab9865c

Pay attention to transaction c08522c94355524cc8a1fa1514419814e99989ba503382256cbffc39a733a186. For Initiator's wallet, this transaction simultaneously sends the CT token and receives LTHN (the amount minus the transaction fee).

For Finalizer balance change would look like that:

height 42712, tx c08522c94355524cc8a1fa1514419814e99989ba503382256cbffc39a733a186
          10.0            spent LTHN
           2.0            received, CT[*]
Refresh done, blocks received: 42776
 balance unlocked     / [balance total]       ticker   asset id
   11728.97                                   LTHN     d6329b5b....51a6498a
   2.0                                        CT       e03a140b....4ab9865c

From Finalizer's wallet perspective same transaction c08522c94355524cc8a1fa1514419814e99989ba503382256cbffc39a733a186 sends 10 Lethean and receives 2 CT tokens.

CLI Methods Reference

burn_asset

Burns coins for the asset, possible only if current wallet is a maintainer for the asset AND possess given amount of coins to burn

burn_asset <asset_id> <amount>

deploy_new_asset

Creates a new Confidential Asset

Parameters File

{
  "ticker": "CT",
  "full_name": "Confidential token",
  "total_max_supply": 100000000000000000,
  "current_supply": 1000000000000000,
  "decimal_point": 12,
  "meta_info": ""
}

Command

deploy_new_asset <asset specs file location>

emit_asset

Mint more coins for the asset, possible only if current wallet is a maintainer for the asset

Command

emit_asset <asset_id> <amount>

update_asset

Updates asset descriptor's metadata, possible only if current wallet is a maintainer for the asset

Parameters File

{
  "meta_info": "Updated metadata"
}

Command

update_asset <asset_id> <path_to_metadata_file>

Wallet RPC Methods for Assets

For the full wallet RPC reference for asset operations, see the Wallet RPC Reference page, specifically the Confidential Assets and Asset Whitelist sections.

Key methods:

deploy_asset -- deploy a new asset on the blockchain
emit_asset -- mint additional tokens for an owned asset
burn_asset -- burn tokens of an owned asset
update_asset -- update asset metadata
transfer_asset_ownership -- transfer ownership to a new key
get_asset_info (daemon) -- query asset details by ID
get_assets_list (daemon) -- list all registered assets
assets_whitelist_add / assets_whitelist_remove / assets_whitelist_get -- manage wallet asset whitelist

The native LTHN asset ID is: d6329b5b1f7c0805b5c345f4957554002a2f557845f64d7645dae0e051a6498a