Trait grin_wallet_api::OwnerRpc

source · 
pub trait OwnerRpc {

Show 41 methods    // Required methods
    fn accounts(&self, token: Token) -> Result<Vec<AcctPathMapping>, Error>;
    fn create_account_path(
        &self,
        token: Token,
        label: &String
    ) -> Result<Identifier, Error>;
    fn set_active_account(
        &self,
        token: Token,
        label: &String
    ) -> Result<(), Error>;
    fn retrieve_outputs(
        &self,
        token: Token,
        include_spent: bool,
        refresh_from_node: bool,
        tx_id: Option<u32>
    ) -> Result<(bool, Vec<OutputCommitMapping>), Error>;
    fn retrieve_txs(
        &self,
        token: Token,
        refresh_from_node: bool,
        tx_id: Option<u32>,
        tx_slate_id: Option<Uuid>
    ) -> Result<(bool, Vec<TxLogEntry>), Error>;
    fn query_txs(
        &self,
        token: Token,
        refresh_from_node: bool,
        query: RetrieveTxQueryArgs
    ) -> Result<(bool, Vec<TxLogEntry>), Error>;
    fn retrieve_summary_info(
        &self,
        token: Token,
        refresh_from_node: bool,
        minimum_confirmations: u64
    ) -> Result<(bool, WalletInfo), Error>;
    fn init_send_tx(
        &self,
        token: Token,
        args: InitTxArgs
    ) -> Result<VersionedSlate, Error>;
    fn issue_invoice_tx(
        &self,
        token: Token,
        args: IssueInvoiceTxArgs
    ) -> Result<VersionedSlate, Error>;
    fn process_invoice_tx(
        &self,
        token: Token,
        slate: VersionedSlate,
        args: InitTxArgs
    ) -> Result<VersionedSlate, Error>;
    fn tx_lock_outputs(
        &self,
        token: Token,
        slate: VersionedSlate
    ) -> Result<(), Error>;
    fn finalize_tx(
        &self,
        token: Token,
        slate: VersionedSlate
    ) -> Result<VersionedSlate, Error>;
    fn post_tx(
        &self,
        token: Token,
        slate: VersionedSlate,
        fluff: bool
    ) -> Result<(), Error>;
    fn cancel_tx(
        &self,
        token: Token,
        tx_id: Option<u32>,
        tx_slate_id: Option<Uuid>
    ) -> Result<(), Error>;
    fn get_stored_tx(
        &self,
        token: Token,
        id: Option<u32>,
        slate_id: Option<Uuid>
    ) -> Result<Option<VersionedSlate>, Error>;
    fn get_rewind_hash(&self, token: Token) -> Result<String, Error>;
    fn scan_rewind_hash(
        &self,
        rewind_hash: String,
        start_height: Option<u64>
    ) -> Result<ViewWallet, Error>;
    fn scan(
        &self,
        token: Token,
        start_height: Option<u64>,
        delete_unconfirmed: bool
    ) -> Result<(), Error>;
    fn node_height(&self, token: Token) -> Result<NodeHeightResult, Error>;
    fn init_secure_api(
        &self,
        ecdh_pubkey: ECDHPubkey
    ) -> Result<ECDHPubkey, Error>;
    fn get_top_level_directory(&self) -> Result<String, Error>;
    fn set_top_level_directory(&self, dir: String) -> Result<(), Error>;
    fn create_config(
        &self,
        chain_type: ChainTypes,
        wallet_config: Option<WalletConfig>,
        logging_config: Option<LoggingConfig>,
        tor_config: Option<TorConfig>
    ) -> Result<(), Error>;
    fn create_wallet(
        &self,
        name: Option<String>,
        mnemonic: Option<String>,
        mnemonic_length: u32,
        password: String
    ) -> Result<(), Error>;
    fn open_wallet(
        &self,
        name: Option<String>,
        password: String
    ) -> Result<Token, Error>;
    fn close_wallet(&self, name: Option<String>) -> Result<(), Error>;
    fn get_mnemonic(
        &self,
        name: Option<String>,
        password: String
    ) -> Result<String, Error>;
    fn change_password(
        &self,
        name: Option<String>,
        old: String,
        new: String
    ) -> Result<(), Error>;
    fn delete_wallet(&self, name: Option<String>) -> Result<(), Error>;
    fn start_updater(&self, token: Token, frequency: u32) -> Result<(), Error>;
    fn stop_updater(&self) -> Result<(), Error>;
    fn get_updater_messages(
        &self,
        count: u32
    ) -> Result<Vec<StatusMessage>, Error>;
    fn get_slatepack_address(
        &self,
        token: Token,
        derivation_index: u32
    ) -> Result<SlatepackAddress, Error>;
    fn get_slatepack_secret_key(
        &self,
        token: Token,
        derivation_index: u32
    ) -> Result<Ed25519SecretKey, Error>;
    fn create_slatepack_message(
        &self,
        token: Token,
        slate: VersionedSlate,
        sender_index: Option<u32>,
        recipients: Vec<SlatepackAddress>
    ) -> Result<String, Error>;
    fn slate_from_slatepack_message(
        &self,
        token: Token,
        message: String,
        secret_indices: Vec<u32>
    ) -> Result<VersionedSlate, Error>;
    fn decode_slatepack_message(
        &self,
        token: Token,
        message: String,
        secret_indices: Vec<u32>
    ) -> Result<Slatepack, Error>;
    fn retrieve_payment_proof(
        &self,
        token: Token,
        refresh_from_node: bool,
        tx_id: Option<u32>,
        tx_slate_id: Option<Uuid>
    ) -> Result<PaymentProof, Error>;
    fn verify_payment_proof(
        &self,
        token: Token,
        proof: PaymentProof
    ) -> Result<(bool, bool), Error>;
    fn set_tor_config(&self, tor_config: Option<TorConfig>) -> Result<(), Error>;
    fn build_output(
        &self,
        token: Token,
        features: OutputFeatures,
        amount: Amount
    ) -> Result<BuiltOutput, Error>;

}
Expand description

Public definition used to generate Owner jsonrpc api. Secure version containing wallet lifecycle functions. All calls to this API must be encrypted. See init_secure_api for details of secret derivation and encryption.

Required Methods§

source

fn accounts(&self, token: Token) -> Result<Vec<AcctPathMapping>, Error>

Networked version of Owner::accounts.

§Json rpc example
{
	"jsonrpc": "2.0",
	"method": "accounts",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000"
	},
	"id": 1
}
{
	"jsonrpc": "2.0",
	"result": {
		"Ok": [
			{
				"label": "default",
				"path": "0200000000000000000000000000000000"
			}
		]
	},
	"id": 1
}
source

fn create_account_path( &self, token: Token, label: &String ) -> Result<Identifier, Error>

Networked version of Owner::create_account_path.

§Json rpc example
{
	"jsonrpc": "2.0",
	"method": "create_account_path",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"label": "account1"
	},
	"id": 1
}
{
	"jsonrpc": "2.0",
	"result": {
		"Ok": "0200000001000000000000000000000000"
	},
	"id": 1
}
source

fn set_active_account(&self, token: Token, label: &String) -> Result<(), Error>

Networked version of Owner::set_active_account.

§Json rpc example
{
	"jsonrpc": "2.0",
	"method": "set_active_account",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"label": "default"
	},
	"id": 1
}
{
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	},
	"id": 1
}
source

fn retrieve_outputs( &self, token: Token, include_spent: bool, refresh_from_node: bool, tx_id: Option<u32> ) -> Result<(bool, Vec<OutputCommitMapping>), Error>

Networked version of Owner::retrieve_outputs.

§Json rpc example
{
	"jsonrpc": "2.0",
	"method": "retrieve_outputs",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"include_spent": false,
		"refresh_from_node": true,
		"tx_id": null
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": [
			true,
			[
				{
					"commit": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
					"output": {
						"commit": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
						"height": "1",
						"is_coinbase": true,
						"key_id": "0300000000000000000000000000000000",
						"lock_height": "4",
						"mmr_index": null,
						"n_child": 0,
						"root_key_id": "0200000000000000000000000000000000",
						"status": "Unspent",
						"tx_log_entry": 0,
						"value": "60000000000"
					}
				},
				{
					"commit": "087df32304c5d4ae8b2af0bc31e700019d722910ef87dd4eec3197b80b207e3045",
					"output": {
						"commit": "087df32304c5d4ae8b2af0bc31e700019d722910ef87dd4eec3197b80b207e3045",
						"height": "2",
						"is_coinbase": true,
						"key_id": "0300000000000000000000000100000000",
						"lock_height": "5",
						"mmr_index": null,
						"n_child": 1,
						"root_key_id": "0200000000000000000000000000000000",
						"status": "Unspent",
						"tx_log_entry": 1,
						"value": "60000000000"
					}
				}
			]
		]
	}
}
source

fn retrieve_txs( &self, token: Token, refresh_from_node: bool, tx_id: Option<u32>, tx_slate_id: Option<Uuid> ) -> Result<(bool, Vec<TxLogEntry>), Error>

Networked version of Owner::retrieve_txs.

§Json rpc example
	{
		"jsonrpc": "2.0",
		"method": "retrieve_txs",
		"params": {
			"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"refresh_from_node": true,
			"tx_id": null,
			"tx_slate_id": null
		},
		"id": 1
	}
	{
	"id": 1,
	"jsonrpc": "2.0",
  "result": {
	"Ok": [
	  true,
	  [
		{
		  "amount_credited": "60000000000",
		  "amount_debited": "0",
		  "confirmation_ts": "2019-01-15T16:01:26Z",
		  "confirmed": true,
		  "creation_ts": "2019-01-15T16:01:26Z",
		  "fee": null,
		  "id": 0,
		  "kernel_excess": "0838e19c490038b10f051c9c190a9b1f96d59bbd242f5d3143f50630deb74342ed",
		  "kernel_lookup_min_height": 1,
		  "num_inputs": 0,
		  "num_outputs": 1,
		  "parent_key_id": "0200000000000000000000000000000000",
		  "stored_tx": null,
		  "ttl_cutoff_height": null,
		  "tx_slate_id": null,
		  "payment_proof": null,
		  "reverted_after": null,
		  "tx_type": "ConfirmedCoinbase"
		},
		{
		  "amount_credited": "60000000000",
		  "amount_debited": "0",
		  "confirmation_ts": "2019-01-15T16:01:26Z",
		  "confirmed": true,
		  "creation_ts": "2019-01-15T16:01:26Z",
		  "fee": null,
		  "id": 1,
		  "kernel_excess": "08cd9d890c0b6a004f700aa5939a1ce0488fe2a11fa33cf096b50732ceab0be1df",
		  "kernel_lookup_min_height": 2,
		  "num_inputs": 0,
		  "num_outputs": 1,
		  "parent_key_id": "0200000000000000000000000000000000",
		  "stored_tx": null,
		  "ttl_cutoff_height": null,
		  "payment_proof": null,
		  "reverted_after": null,
		  "tx_slate_id": null,
		  "tx_type": "ConfirmedCoinbase"
		}
	  ]
	]
  }
}
source

fn query_txs( &self, token: Token, refresh_from_node: bool, query: RetrieveTxQueryArgs ) -> Result<(bool, Vec<TxLogEntry>), Error>

Networked version of Owner::retrieve_txs, which passes only the tx_query_args parameter. See (../grin_wallet_libwallet/types.struct.RetrieveTxQueryArgs.html)

	{
		"jsonrpc": "2.0",
		"method": "query_txs",
		"params": {
			"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"refresh_from_node": true,
			"query": {
				"min_id": 0,
				"max_id": 100,
				"min_amount": "0",
				"max_amount": "60000000000",
				"sort_field": "Id",
				"sort_order": "Asc"
			}
		},
		"id": 1
	}
	{
	"id": 1,
	"jsonrpc": "2.0",
  "result": {
	"Ok": [
	  true,
	  [
		{
		  "amount_credited": "60000000000",
		  "amount_debited": "0",
		  "confirmation_ts": "2019-01-15T16:01:26Z",
		  "confirmed": true,
		  "creation_ts": "2019-01-15T16:01:26Z",
		  "fee": null,
		  "id": 0,
		  "kernel_excess": "0838e19c490038b10f051c9c190a9b1f96d59bbd242f5d3143f50630deb74342ed",
		  "kernel_lookup_min_height": 1,
		  "num_inputs": 0,
		  "num_outputs": 1,
		  "parent_key_id": "0200000000000000000000000000000000",
		  "stored_tx": null,
		  "ttl_cutoff_height": null,
		  "tx_slate_id": null,
		  "payment_proof": null,
		  "reverted_after": null,
		  "tx_type": "ConfirmedCoinbase"
		},
		{
		  "amount_credited": "60000000000",
		  "amount_debited": "0",
		  "confirmation_ts": "2019-01-15T16:01:26Z",
		  "confirmed": true,
		  "creation_ts": "2019-01-15T16:01:26Z",
		  "fee": null,
		  "id": 1,
		  "kernel_excess": "08cd9d890c0b6a004f700aa5939a1ce0488fe2a11fa33cf096b50732ceab0be1df",
		  "kernel_lookup_min_height": 2,
		  "num_inputs": 0,
		  "num_outputs": 1,
		  "parent_key_id": "0200000000000000000000000000000000",
		  "stored_tx": null,
		  "ttl_cutoff_height": null,
		  "payment_proof": null,
		  "reverted_after": null,
		  "tx_slate_id": null,
		  "tx_type": "ConfirmedCoinbase"
		}
	  ]
	]
  }
}
source

fn retrieve_summary_info( &self, token: Token, refresh_from_node: bool, minimum_confirmations: u64 ) -> Result<(bool, WalletInfo), Error>

Networked version of Owner::retrieve_summary_info.

{
	"jsonrpc": "2.0",
	"method": "retrieve_summary_info",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"refresh_from_node": true,
		"minimum_confirmations": 1
	},
	"id": 1
}
{
"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": [
			true,
			{
				"amount_awaiting_confirmation": "0",
				"amount_awaiting_finalization": "0",
				"amount_currently_spendable": "60000000000",
				"amount_immature": "180000000000",
				"amount_locked": "0",
				"amount_reverted": "0",
				"last_confirmed_height": "4",
				"minimum_confirmations": "1",
				"total": "240000000000"
			}
		]
	}
}
source

fn init_send_tx( &self, token: Token, args: InitTxArgs ) -> Result<VersionedSlate, Error>

;Networked version of Owner::init_send_tx.

	{
		"jsonrpc": "2.0",
		"method": "init_send_tx",
		"params": {
			"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"args": {
				"src_acct_name": null,
				"amount": "6000000000",
				"minimum_confirmations": 2,
				"max_outputs": 500,
				"num_change_outputs": 1,
				"selection_strategy_is_use_all": true,
				"target_slate_version": null,
				"payment_proof_recipient_address": "tgrin1xtxavwfgs48ckf3gk8wwgcndmn0nt4tvkl8a7ltyejjcy2mc6nfs9gm2lp",
				"ttl_blocks": null,
				"send_args": null
			}
		},
		"id": 1
	}
	{
	"id": 1,
		"jsonrpc": "2.0",
		"result": {
			"Ok": {
				"amt": "6000000000",
				"fee": "23000000",
				"id": "0436430c-2b02-624c-2032-570501212b00",
				"proof": {
					"raddr": "32cdd63928854f8b2628b1dce4626ddcdf35d56cb7cfdf7d64cca5822b78d4d3",
					"saddr": "32cdd63928854f8b2628b1dce4626ddcdf35d56cb7cfdf7d64cca5822b78d4d3"
				},
				"sigs": [
					{
						"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
						"xs": "02e89cce4499ac1e9bb498dab9e3fab93cc40cd3d26c04a0292e00f4bf272499ec"
					}
				],
				"sta": "S1",
				"ver": "4:2"
			}
		}
	}
source

fn issue_invoice_tx( &self, token: Token, args: IssueInvoiceTxArgs ) -> Result<VersionedSlate, Error>

;Networked version of Owner::issue_invoice_tx.

	{
		"jsonrpc": "2.0",
		"method": "issue_invoice_tx",
		"params": {
			"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"args": {
				"amount": "6000000000",
				"dest_acct_name": null,
				"target_slate_version": null
			}
		},
		"id": 1
	}
	{
		"id": 1,
		"jsonrpc": "2.0",
		"result": {
			"Ok": {
				"amt": "6000000000",
				"id": "0436430c-2b02-624c-2032-570501212b00",
				"sigs": [
					{
						"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
						"xs": "02e89cce4499ac1e9bb498dab9e3fab93cc40cd3d26c04a0292e00f4bf272499ec"
					}
				],
				"sta": "I1",
				"ver": "4:2"
			}
		}
	}
source

fn process_invoice_tx( &self, token: Token, slate: VersionedSlate, args: InitTxArgs ) -> Result<VersionedSlate, Error>

;Networked version of Owner::process_invoice_tx.

	{
		"jsonrpc": "2.0",
		"method": "process_invoice_tx",
		"params": {
			"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"slate": {
				"amt": "6000000000",
				"id": "0436430c-2b02-624c-2032-570501212b00",
				"off": "d202964900000000d302964900000000d402964900000000d502964900000000",
				"sigs": [
					{
						"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
						"xs": "028e95921cc0d5be5922362265d352c9bdabe51a9e1502a3f0d4a10387f1893f40"
					}
				],
				"sta": "I1",
				"ver": "4:2"
			},
			"args": {
				"src_acct_name": null,
				"amount": "0",
				"minimum_confirmations": 2,
				"max_outputs": 500,
				"num_change_outputs": 1,
				"selection_strategy_is_use_all": true,
				"target_slate_version": null,
				"payment_proof_recipient_address": null,
				"ttl_blocks": null,
				"send_args": null
			}
		},
		"id": 1
	}
	{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"coms": [
				{
					"c": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
					"f": 1
				},
				{
					"c": "087e4e373ef2ab9921ba53e05f384b717789ddb4ad18a8f2057c9338bd639e02a5",
					"p": "28875d797af7cb6c63eba070e0a79af57ea0a434d7d34801a02bc85624ae14a4a13519164737c7154b6222a9d6da33b8c52ef7dc4dc58aea3c776b7907e474450a52f3ccc017f66e2ce9f97a45733d6ed90a223e7d1a67802d393834cc9e4103c27bb7d63abc2753a5b54bcc48751c63b6accde16a37678338452bc985d24fb6af405a9166c0ca750f1cdedc5c0996c56f199722df3844b822de96480fac6e706dab6241d0338d7914a10a0e83406d0689224a3286e8c579c50882ce96123aecc6aa667c27abf1ce894e0c6282fc81e5fba51d498af16c5b0c39b45faf3f0cd7140dccae7d8d45330ec7895ce0c90e2490877311b9dfe157c05c6206f929ffef0da1a8d807077712a80670dfb9ac38ca565d47acf7e93bd09f418f20f10c9e87f6f4421fa889e522c33475f98ddff87a36eb0a0b445a8679628e163ae56bf3cfc39a5a5867d3e31e1e9d373a6b3924d7d895d5140e4bf00c0cbf7f343c12dc2b2c6b01769a588cc1ef1178fbf3bd645e25bf5c458c4af79884329b7ed80e08868121baeb39b11814f2dd8dddbb7114382e65378e2c6f1e837ace9a980acb965629f9f1525f60efb54301a7540a9105bf33eac1be37e1add96801f1c62857be0ac38ac370e0722764c59517960056bafe6fdd388eb78c98954f3f966d44e8f060366617844eff416625f8609b44263efc10e4f2f4fb22ceae5c16d4105e477a49511b4ac37aefac17e5532ee1ccb1654eb0bf17b32415561f02c2b07462f2c5aa7846ef21cfb30548c6bfe4d762333a199be183d7d9fa1ae6c9b4730965f741183d75ac0610efcf48d0039514011816f421a7a1a4c7c1bbc2ba8b522178cff367b4c704d343fac3a2662b50211556b630b5620244587d2f90941ef1edf8e44fa97d35daaa58d16fff3f57c6e6fa618f511dc770704d831a1f49630ec9da6f33f551923c"
				}
			],
			"fee": "23000000",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"off": "16672e6b4e2a6851b27641d8b5c32fcee83abbd516ceb9af5f0e8b6aad8d26a5",
			"sigs": [
				{
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841bdac2d36fe4c972de75f4e462004de9ca3e8c77d4dae5344d210beea9ad138c45",
					"xs": "02e3c128e436510500616fef3f9a22b15ca015f407c8c5cf96c9059163c873828f"
				}
			],
			"sta": "I2",
			"ver": "4:2"
		}
	}
}
source

fn tx_lock_outputs( &self, token: Token, slate: VersionedSlate ) -> Result<(), Error>

Networked version of Owner::tx_lock_outputs.

{
	"jsonrpc": "2.0",
	"method": "tx_lock_outputs",
	"id": 1,
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"slate": {
			"ver": "4:2",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"sta": "S1",
			"off": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"amt": "60000000000",
			"fee": "7000000",
			"sigs": [
				{
					"xs": "030152d2d72e2dba7c6086ad49a219d9ff0dfe0fd993dcaea22e058c210033ce93",
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f"
				}
			]
		}
	}
}
{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"Ok": null
	}
}
source

fn finalize_tx( &self, token: Token, slate: VersionedSlate ) -> Result<VersionedSlate, Error>

Networked version of Owner::finalize_tx.

{
	"jsonrpc": "2.0",
	"method": "finalize_tx",
	"id": 1,
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"slate":
		{
			"ver": "4:2",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"sta": "S2",
			"off": "6c6a69136154775488782121887bb3c32787a8320551fdb9732ec2d333fe54ee",
			"sigs": [
				{
					"xs": "02e3c128e436510500616fef3f9a22b15ca015f407c8c5cf96c9059163c873828f",
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841be7bf31d80494f5e4a3d656649b1610c61a268f9cafcfc604b5d9f25efb2aa3c5"
				}
			],
			"coms": [
				{
					"c": "099b48cfb1f80a2347dc89818449e68e76a3c6817a532a8e9ef2b4a5ccf4363850",
					"p": "29701ceae262cac77b79b868c883a292e61e6de8192b868edcd1300b0973d91396b156ace6bd673402a303de10ddd8a5e6b7f17ba6557a574a672bd04cc273ab04ed8e2ca80bac483345c0ec843f521814ce1301ec9adc38956a12b4d948acce71295a4f52bcdeb8a1c9f2d6b2da5d731262a5e9c0276ef904df9ef8d48001420cd59f75a2f1ae5c7a1c7c6b9f140e7613e52ef9e249f29f9340b7efb80699e460164324616f98fd4cde3db52497c919e95222fffeacb7e65deca7e368a80ce713c19de7da5369726228ee336f5bd494538c12ccbffeb1b9bfd5fc8906d1c64245b516f103fa96d9c56975837652c1e0fa5803d7ccf1147d8f927e36da717f7ad79471dbe192f5f50f87a79fc3fe030dba569b634b92d2cf307993cce545633af263897cd7e6ebf4dcafb176d07358bdc38d03e45a49dfa9c8c6517cd68d167ffbf6c3b4de0e2dd21909cbad4c467b84e5700be473a39ac59c669d7c155c4bcab9b8026eea3431c779cd277e4922d2b9742e1f6678cbe869ec3b5b7ef4132ddb6cdd06cf27dbeb28be72b949fa897610e48e3a0d789fd2eea75abc97b3dc7e00e5c8b3d24e40c6f24112adb72352b89a2bef0599345338e9e76202a3c46efa6370952b2aca41aadbae0ea32531acafcdab6dd066d769ebf50cf4f3c0a59d2d5fa79600a207b9417c623f76ad05e8cccfcd4038f9448bc40f127ca7c0d372e46074e334fe49f5a956ec0056f4da601e6af80eb1a6c4951054869e665b296d8c14f344ca2dc5fdd5df4a3652536365a1615ad9b422165c77bf8fe65a835c8e0c41e070014eb66ef8c525204e990b3a3d663c1e42221b496895c37a2f0c1bf05e91235409c3fe3d89a9a79d6c78609ab18a463311911f71fa37bb73b15fcd38143d1404fd2ce81004dc7ff89cf1115dcc0c35ce1c1bf9941586fb959770f2618ccb7118a7"
				}
			]
		}
	}
}
{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"Ok": {
			"coms": [
				{
					"c": "087df32304c5d4ae8b2af0bc31e700019d722910ef87dd4eec3197b80b207e3045",
					"f": 1
				},
				{
					"c": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
					"f": 1
				},
				{
					"c": "099b48cfb1f80a2347dc89818449e68e76a3c6817a532a8e9ef2b4a5ccf4363850",
					"p": "29701ceae262cac77b79b868c883a292e61e6de8192b868edcd1300b0973d91396b156ace6bd673402a303de10ddd8a5e6b7f17ba6557a574a672bd04cc273ab04ed8e2ca80bac483345c0ec843f521814ce1301ec9adc38956a12b4d948acce71295a4f52bcdeb8a1c9f2d6b2da5d731262a5e9c0276ef904df9ef8d48001420cd59f75a2f1ae5c7a1c7c6b9f140e7613e52ef9e249f29f9340b7efb80699e460164324616f98fd4cde3db52497c919e95222fffeacb7e65deca7e368a80ce713c19de7da5369726228ee336f5bd494538c12ccbffeb1b9bfd5fc8906d1c64245b516f103fa96d9c56975837652c1e0fa5803d7ccf1147d8f927e36da717f7ad79471dbe192f5f50f87a79fc3fe030dba569b634b92d2cf307993cce545633af263897cd7e6ebf4dcafb176d07358bdc38d03e45a49dfa9c8c6517cd68d167ffbf6c3b4de0e2dd21909cbad4c467b84e5700be473a39ac59c669d7c155c4bcab9b8026eea3431c779cd277e4922d2b9742e1f6678cbe869ec3b5b7ef4132ddb6cdd06cf27dbeb28be72b949fa897610e48e3a0d789fd2eea75abc97b3dc7e00e5c8b3d24e40c6f24112adb72352b89a2bef0599345338e9e76202a3c46efa6370952b2aca41aadbae0ea32531acafcdab6dd066d769ebf50cf4f3c0a59d2d5fa79600a207b9417c623f76ad05e8cccfcd4038f9448bc40f127ca7c0d372e46074e334fe49f5a956ec0056f4da601e6af80eb1a6c4951054869e665b296d8c14f344ca2dc5fdd5df4a3652536365a1615ad9b422165c77bf8fe65a835c8e0c41e070014eb66ef8c525204e990b3a3d663c1e42221b496895c37a2f0c1bf05e91235409c3fe3d89a9a79d6c78609ab18a463311911f71fa37bb73b15fcd38143d1404fd2ce81004dc7ff89cf1115dcc0c35ce1c1bf9941586fb959770f2618ccb7118a7"
				},
				{
					"c": "09ede20409d5ae0d1c0d3f3d2c68038a384cdd6b7cc5ca2aab670f570adc2dffc3",
					"p": "6d86fe00220f8c6ac2ad4e338d80063dba5423af525bd273ecfac8ef6b509192732a8cd0c53d3313e663ac5ccece3d589fd2634e29f96e82b99ca6f8b953645a005d1bc73493f8c41f84fb8e327d4cbe6711dba194a60db30700df94a41e1fda7afe0619169389f8d8ee12bddf736c4bc86cd5b1809a5a27f195209147dc38d0de6f6710ce9350f3b8e7e6820bfe5182e6e58f0b41b82b6ec6bb01ffe1d8b3c2368ebf1e31dfdb9e00f0bc68d9119a38d19c038c29c7b37e31246e7bba56019bc88881d7d695d32557fc0e93635b5f24deffefc787787144e5de7e86281e79934e7e20d9408c34317c778e6b218ee26d0a5e56b8b84a883e3ddf8603826010234531281486454f8c2cf3fee074f242f9fc1da3c6636b86fb6f941eb8b633d6e3b3f87dfe5ae261a40190bd4636f433bcdd5e3400255594e282c5396db8999d95be08a35be9a8f70fdb7cf5353b90584523daee6e27e208b2ca0e5758b8a24b974dca00bab162505a2aa4bcefd8320f111240b62f861261f0ce9b35979f9f92da7dd6989fe1f41ec46049fd514d9142ce23755f52ec7e64df2af33579e9b8356171b91bc96b875511bef6062dd59ef3fe2ddcc152147554405b12c7c5231513405eb062aa8fa093e3414a144c544d551c4f1f9bf5d5d2ff5b50a3f296c800907704bed8d8ee948c0855eff65ad44413af641cdc68a06a7c855be7ed7dd64d5f623bbc9645763d48774ba2258240a83f8f89ef84d21c65bcb75895ebca08b0090b40aafb7ddef039fcaf4bad2dbbac72336c4412c600e854d368ed775597c15d2e66775ab47024ce7e62fd31bf90b183149990c10b5b678501dbac1af8b2897b67d085d87cab7af4036cba3bdcfdcc7548d7710511045813c6818d859e192e03adc0d6a6b30c4cbac20a0d6f8719c7a9c3ad46d62eec464c4c44b58fca463fea3ce1fc51"
				}
			],
			"fee": "23500000",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"off": "a5a632f26f27a9b71e98c1c8b8098bb41204ffcfd206d995f9c16d10764ad95a",
			"sigs": [
				{
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841be7bf31d80494f5e4a3d656649b1610c61a268f9cafcfc604b5d9f25efb2aa3c5",
					"xs": "02e3c128e436510500616fef3f9a22b15ca015f407c8c5cf96c9059163c873828f"
				},
				{
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841b04e1e15ceb1b5dbab8baf7750d7bd4aad6cfe97b83e4dc080dae328eb75881fd",
					"xs": "02e89cce4499ac1e9bb498dab9e3fab93cc40cd3d26c04a0292e00f4bf272499ec"
				}
			],
			"sta": "S3",
			"ver": "4:2"
		}
	}
}
source

fn post_tx( &self, token: Token, slate: VersionedSlate, fluff: bool ) -> Result<(), Error>

Networked version of Owner::post_tx.

{
	"jsonrpc": "2.0",
	"id": 1,
	"method": "post_tx",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"slate": {
			"ver": "4:2",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"sta": "S3",
			"off": "750dbf4fd43b7f4cfd68d2698a522f3ff6e6a00ad9895b33f1ec46493b837b49",
			"fee": "23500000",
			"sigs": [
				{
					"xs": "033bbe2a419ea2e9d6810a8d66552e709d1783ca50759a44dbaf63fc79c0164c4c",
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841b92c7c53280dd79f8b028cd9863bac89820267cac794b121e217541efb061ad53"
				},
				{
					"xs": "02b57c1f4fea69a3ee070309cf8f06082022fe06f25a9be1851b56ef0fa18f25d6",
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"part": "8f07ddd5e9f5179cff19486034181ed76505baaad53e5d994064127b56c5841b4cd4afef1cd2d708100cd1680d6566e4e987ac5c939ace9c0e036a679121c7a8"
				}
			],
			"coms": [
				{
					"f": 1,
					"c": "087df32304c5d4ae8b2af0bc31e700019d722910ef87dd4eec3197b80b207e3045"
				},
				{
					"f": 1,
					"c": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7"
				},
				{
					"c": "099b48cfb1f80a2347dc89818449e68e76a3c6817a532a8e9ef2b4a5ccf4363850",
					"p": "29701ceae262cac77b79b868c883a292e61e6de8192b868edcd1300b0973d91396b156ace6bd673402a303de10ddd8a5e6b7f17ba6557a574a672bd04cc273ab04ed8e2ca80bac483345c0ec843f521814ce1301ec9adc38956a12b4d948acce71295a4f52bcdeb8a1c9f2d6b2da5d731262a5e9c0276ef904df9ef8d48001420cd59f75a2f1ae5c7a1c7c6b9f140e7613e52ef9e249f29f9340b7efb80699e460164324616f98fd4cde3db52497c919e95222fffeacb7e65deca7e368a80ce713c19de7da5369726228ee336f5bd494538c12ccbffeb1b9bfd5fc8906d1c64245b516f103fa96d9c56975837652c1e0fa5803d7ccf1147d8f927e36da717f7ad79471dbe192f5f50f87a79fc3fe030dba569b634b92d2cf307993cce545633af263897cd7e6ebf4dcafb176d07358bdc38d03e45a49dfa9c8c6517cd68d167ffbf6c3b4de0e2dd21909cbad4c467b84e5700be473a39ac59c669d7c155c4bcab9b8026eea3431c779cd277e4922d2b9742e1f6678cbe869ec3b5b7ef4132ddb6cdd06cf27dbeb28be72b949fa897610e48e3a0d789fd2eea75abc97b3dc7e00e5c8b3d24e40c6f24112adb72352b89a2bef0599345338e9e76202a3c46efa6370952b2aca41aadbae0ea32531acafcdab6dd066d769ebf50cf4f3c0a59d2d5fa79600a207b9417c623f76ad05e8cccfcd4038f9448bc40f127ca7c0d372e46074e334fe49f5a956ec0056f4da601e6af80eb1a6c4951054869e665b296d8c14f344ca2dc5fdd5df4a3652536365a1615ad9b422165c77bf8fe65a835c8e0c41e070014eb66ef8c525204e990b3a3d663c1e42221b496895c37a2f0c1bf05e91235409c3fe3d89a9a79d6c78609ab18a463311911f71fa37bb73b15fcd38143d1404fd2ce81004dc7ff89cf1115dcc0c35ce1c1bf9941586fb959770f2618ccb7118a7"
				},
				{
					"c": "09ede20409d5ae0d1c0d3f3d2c68038a384cdd6b7cc5ca2aab670f570adc2dffc3",
					"p": "6d86fe00220f8c6ac2ad4e338d80063dba5423af525bd273ecfac8ef6b509192732a8cd0c53d3313e663ac5ccece3d589fd2634e29f96e82b99ca6f8b953645a005d1bc73493f8c41f84fb8e327d4cbe6711dba194a60db30700df94a41e1fda7afe0619169389f8d8ee12bddf736c4bc86cd5b1809a5a27f195209147dc38d0de6f6710ce9350f3b8e7e6820bfe5182e6e58f0b41b82b6ec6bb01ffe1d8b3c2368ebf1e31dfdb9e00f0bc68d9119a38d19c038c29c7b37e31246e7bba56019bc88881d7d695d32557fc0e93635b5f24deffefc787787144e5de7e86281e79934e7e20d9408c34317c778e6b218ee26d0a5e56b8b84a883e3ddf8603826010234531281486454f8c2cf3fee074f242f9fc1da3c6636b86fb6f941eb8b633d6e3b3f87dfe5ae261a40190bd4636f433bcdd5e3400255594e282c5396db8999d95be08a35be9a8f70fdb7cf5353b90584523daee6e27e208b2ca0e5758b8a24b974dca00bab162505a2aa4bcefd8320f111240b62f861261f0ce9b35979f9f92da7dd6989fe1f41ec46049fd514d9142ce23755f52ec7e64df2af33579e9b8356171b91bc96b875511bef6062dd59ef3fe2ddcc152147554405b12c7c5231513405eb062aa8fa093e3414a144c544d551c4f1f9bf5d5d2ff5b50a3f296c800907704bed8d8ee948c0855eff65ad44413af641cdc68a06a7c855be7ed7dd64d5f623bbc9645763d48774ba2258240a83f8f89ef84d21c65bcb75895ebca08b0090b40aafb7ddef039fcaf4bad2dbbac72336c4412c600e854d368ed775597c15d2e66775ab47024ce7e62fd31bf90b183149990c10b5b678501dbac1af8b2897b67d085d87cab7af4036cba3bdcfdcc7548d7710511045813c6818d859e192e03adc0d6a6b30c4cbac20a0d6f8719c7a9c3ad46d62eec464c4c44b58fca463fea3ce1fc51"
				}
			]
		},
	"fluff": false
	}
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn cancel_tx( &self, token: Token, tx_id: Option<u32>, tx_slate_id: Option<Uuid> ) -> Result<(), Error>

Networked version of Owner::cancel_tx.

{
	"jsonrpc": "2.0",
	"method": "cancel_tx",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"tx_id": null,
		"tx_slate_id": "0436430c-2b02-624c-2032-570501212b00"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn get_stored_tx( &self, token: Token, id: Option<u32>, slate_id: Option<Uuid> ) -> Result<Option<VersionedSlate>, Error>

Networked version of Owner::get_stored_tx.

{
	"jsonrpc": "2.0",
	"method": "get_stored_tx",
	"id": 1,
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"id": null,
		"slate_id": "0436430c-2b02-624c-2032-570501212b00"
	}
}
{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"Ok": {
			"coms": [
				{
					"c": "099b48cfb1f80a2347dc89818449e68e76a3c6817a532a8e9ef2b4a5ccf4363850",
					"p": "29701ceae262cac77b79b868c883a292e61e6de8192b868edcd1300b0973d91396b156ace6bd673402a303de10ddd8a5e6b7f17ba6557a574a672bd04cc273ab04ed8e2ca80bac483345c0ec843f521814ce1301ec9adc38956a12b4d948acce71295a4f52bcdeb8a1c9f2d6b2da5d731262a5e9c0276ef904df9ef8d48001420cd59f75a2f1ae5c7a1c7c6b9f140e7613e52ef9e249f29f9340b7efb80699e460164324616f98fd4cde3db52497c919e95222fffeacb7e65deca7e368a80ce713c19de7da5369726228ee336f5bd494538c12ccbffeb1b9bfd5fc8906d1c64245b516f103fa96d9c56975837652c1e0fa5803d7ccf1147d8f927e36da717f7ad79471dbe192f5f50f87a79fc3fe030dba569b634b92d2cf307993cce545633af263897cd7e6ebf4dcafb176d07358bdc38d03e45a49dfa9c8c6517cd68d167ffbf6c3b4de0e2dd21909cbad4c467b84e5700be473a39ac59c669d7c155c4bcab9b8026eea3431c779cd277e4922d2b9742e1f6678cbe869ec3b5b7ef4132ddb6cdd06cf27dbeb28be72b949fa897610e48e3a0d789fd2eea75abc97b3dc7e00e5c8b3d24e40c6f24112adb72352b89a2bef0599345338e9e76202a3c46efa6370952b2aca41aadbae0ea32531acafcdab6dd066d769ebf50cf4f3c0a59d2d5fa79600a207b9417c623f76ad05e8cccfcd4038f9448bc40f127ca7c0d372e46074e334fe49f5a956ec0056f4da601e6af80eb1a6c4951054869e665b296d8c14f344ca2dc5fdd5df4a3652536365a1615ad9b422165c77bf8fe65a835c8e0c41e070014eb66ef8c525204e990b3a3d663c1e42221b496895c37a2f0c1bf05e91235409c3fe3d89a9a79d6c78609ab18a463311911f71fa37bb73b15fcd38143d1404fd2ce81004dc7ff89cf1115dcc0c35ce1c1bf9941586fb959770f2618ccb7118a7"
				}
			],
			"fee": "23500000",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"sigs": [],
			"sta": "S3",
			"ver": "4:3"
		}
	}
}
source

fn get_rewind_hash(&self, token: Token) -> Result<String, Error>

Networked version of Owner::get_rewind_hash.

{
	"jsonrpc": "2.0",
	"method": "get_rewind_hash",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000"
	},
	"id": 1
}
{
	"id":1,
	"jsonrpc":"2.0",
	"result":{
		"Ok":"c820c52a492b7db511c752035483d0e50e8fd3ec62544f1b99638e220a4682de"
	}
}
source

fn scan_rewind_hash( &self, rewind_hash: String, start_height: Option<u64> ) -> Result<ViewWallet, Error>

Networked version of Owner::scan_rewind_hash.

{
	"jsonrpc": "2.0",
	"method": "scan_rewind_hash",
	"params": {
		"rewind_hash": "c820c52a492b7db511c752035483d0e50e8fd3ec62544f1b99638e220a4682de",
		"start_height": 1
	},
	"id": 1
}
{
	"id":1,
	"jsonrpc":"2.0",
	"result":{
		"Ok":{
			"last_pmmr_index":8,
			"output_result":[
				   {
					   "commit":"08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
					   "height":1,
					   "is_coinbase":true,
					   "lock_height":4,
					   "mmr_index":1,
					   "value":60000000000
				   },
				   {
					   "commit":"087df32304c5d4ae8b2af0bc31e700019d722910ef87dd4eec3197b80b207e3045",
					   "height":2,
					   "is_coinbase":true,
					   "lock_height":5,
					   "mmr_index":2,
					   "value":60000000000
				   },
				   {
					   "commit":"084219d64014223a205431acfa8f8cc3e8cb8c6d04df80b26713314becf83861c7",
					   "height":3,
					   "is_coinbase":true,
					   "lock_height":6,
					   "mmr_index":4,
					   "value":60000000000
				   },
				   {
					   "commit":"09c5efc4dab05d7d16fc90168c484c13f15a142ea4e1bf93c3fad12f5e8a402598",
					   "height":4,
					   "is_coinbase":true,
					   "lock_height":7,
					   "mmr_index":5,
					   "value":60000000000
				   },
				   {
					   "commit":"08fe198e525a5937d0c5d01fa354394d2679be6df5d42064a0f7550c332fce3d9d",
					   "height":5,
					   "is_coinbase":true,
					   "lock_height":8,
					   "mmr_index":8,
					   "value":60000000000
				   }
			],
			"rewind_hash":"c820c52a492b7db511c752035483d0e50e8fd3ec62544f1b99638e220a4682de",
			"total_balance":300000000000
		}
	}
 }
source

fn scan( &self, token: Token, start_height: Option<u64>, delete_unconfirmed: bool ) -> Result<(), Error>

Networked version of Owner::scan.

{
	"jsonrpc": "2.0",
	"method": "scan",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"start_height": 1,
		"delete_unconfirmed": false
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn node_height(&self, token: Token) -> Result<NodeHeightResult, Error>

Networked version of Owner::node_height.

{
	"jsonrpc": "2.0",
	"method": "node_height",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"header_hash": "d4b3d3c40695afd8c7760f8fc423565f7d41310b7a4e1c4a4a7950a66f16240d",
			"height": "5",
			"updated_from_node": true
		}
	}
}
source

fn init_secure_api(&self, ecdh_pubkey: ECDHPubkey) -> Result<ECDHPubkey, Error>

Initializes the secure JSON-RPC API. This function must be called and a shared key established before any other OwnerAPI JSON-RPC function can be called.

The shared key will be derived using ECDH with the provided public key on the secp256k1 curve. This function will return its public key used in the derivation, which the caller should multiply by its private key to derive the shared key.

Once the key is established, all further requests and responses are encrypted and decrypted with the following parameters:

  • AES-256 in GCM mode with 128-bit tags and 96 bit nonces
  • 12 byte nonce which must be included in each request/response to use on the decrypting side
  • Empty vector for additional data
  • Suffix length = AES-256 GCM mode tag length = 16 bytes

Fully-formed JSON-RPC requests (as documented) should be encrypted using these parameters, encoded into base64 and included with the one-time nonce in a request for the encrypted_request_v3 method as follows:

{
	 "jsonrpc": "2.0",
	 "method": "encrypted_request_v3",
	 "id": "1",
	 "params": {
			"nonce": "ef32...",
			"body_enc": "e0bcd..."
	 }
}

With a typical response being:

{
	 "jsonrpc": "2.0",
	 "method": "encrypted_response_v3",
	 "id": "1",
	 "Ok": {
			"nonce": "340b...",
			"body_enc": "3f09c..."
	 }
}
source

fn get_top_level_directory(&self) -> Result<String, Error>

Networked version of Owner::get_top_level_directory.

{
	"jsonrpc": "2.0",
	"method": "get_top_level_directory",
	"params": {
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "/doctest/dir"
	}
}
source

fn set_top_level_directory(&self, dir: String) -> Result<(), Error>

Networked version of Owner::set_top_level_directory.

{
	"jsonrpc": "2.0",
	"method": "set_top_level_directory",
	"params": {
		"dir": "/home/wallet_user/my_wallet_dir"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn create_config( &self, chain_type: ChainTypes, wallet_config: Option<WalletConfig>, logging_config: Option<LoggingConfig>, tor_config: Option<TorConfig> ) -> Result<(), Error>

Networked version of Owner::create_config.

Both the wallet_config and logging_config parameters can be null, the examples below are for illustration. Note that the values provided for log_file_path and data_file_dir will be ignored and replaced with the actual values based on the value of get_top_level_directory

{
	"jsonrpc": "2.0",
	"method": "create_config",
	"params": {
		"chain_type": "Mainnet",
		"wallet_config": {
			"chain_type": null,
			"api_listen_interface": "127.0.0.1",
			"api_listen_port": 3415,
			"owner_api_listen_port": 3420,
			"api_secret_path": null,
			"node_api_secret_path": null,
			"check_node_api_http_addr": "http://127.0.0.1:3413",
			"owner_api_include_foreign": false,
			"data_file_dir": "/path/to/data/file/dir",
			"no_commit_cache": null,
			"tls_certificate_file": null,
			"tls_certificate_key": null,
			"dark_background_color_scheme": null
		},
		"logging_config": {
			"log_to_stdout": false,
			"stdout_log_level": "Info",
			"log_to_file": true,
			"file_log_level": "Debug",
			"log_file_path": "/path/to/log/file",
			"log_file_append": true,
			"log_max_size": null,
			"log_max_files": null,
			"tui_running": null
		},
		"tor_config" : {
			"use_tor_listener": true,
			"socks_proxy_addr": "127.0.0.1:9050",
			"send_config_dir": "."
		}
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn create_wallet( &self, name: Option<String>, mnemonic: Option<String>, mnemonic_length: u32, password: String ) -> Result<(), Error>

Networked version of Owner::create_wallet.

{
	"jsonrpc": "2.0",
	"method": "create_wallet",
	"params": {
		"name": null,
		"mnemonic": null,
		"mnemonic_length": 32,
		"password": "my_secret_password"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn open_wallet( &self, name: Option<String>, password: String ) -> Result<Token, Error>

Networked version of Owner::open_wallet.

{
	"jsonrpc": "2.0",
	"method": "open_wallet",
	"params": {
		"name": null,
		"password": "my_secret_password"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "d096b3cb75986b3b13f80b8f5243a9edf0af4c74ac37578c5a12cfb5b59b1868"
	}
}
source

fn close_wallet(&self, name: Option<String>) -> Result<(), Error>

Networked version of Owner::close_wallet.

{
	"jsonrpc": "2.0",
	"method": "close_wallet",
	"params": {
		"name": null
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn get_mnemonic( &self, name: Option<String>, password: String ) -> Result<String, Error>

Networked version of Owner::get_mnemonic.

{
	"jsonrpc": "2.0",
	"method": "get_mnemonic",
	"params": {
		"name": null,
		"password": ""
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "fat twenty mean degree forget shell check candy immense awful flame next during february bulb bike sun wink theory day kiwi embrace peace lunch"
	}
}
source

fn change_password( &self, name: Option<String>, old: String, new: String ) -> Result<(), Error>

Networked version of Owner::change_password.

{
	"jsonrpc": "2.0",
	"method": "change_password",
	"params": {
		"name": null,
		"old": "",
		"new": "new_password"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn delete_wallet(&self, name: Option<String>) -> Result<(), Error>

Networked version of Owner::delete_wallet.

{
	"jsonrpc": "2.0",
	"method": "delete_wallet",
	"params": {
		"name": null
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn start_updater(&self, token: Token, frequency: u32) -> Result<(), Error>

Networked version of Owner::start_updated.

{
	"jsonrpc": "2.0",
	"method": "start_updater",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"frequency": 30000
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn stop_updater(&self) -> Result<(), Error>

Networked version of Owner::stop_updater.

{
	"jsonrpc": "2.0",
	"method": "stop_updater",
	"params": null,
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn get_updater_messages(&self, count: u32) -> Result<Vec<StatusMessage>, Error>

Networked version of Owner::get_updater_messages.

{
	"jsonrpc": "2.0",
	"method": "get_updater_messages",
	"params": {
		"count": 1
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": []
	}
}
source

fn get_slatepack_address( &self, token: Token, derivation_index: u32 ) -> Result<SlatepackAddress, Error>

Networked version of Owner::get_slatepack_address.

{
	"jsonrpc": "2.0",
	"method": "get_slatepack_address",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"derivation_index": 0
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "tgrin1xtxavwfgs48ckf3gk8wwgcndmn0nt4tvkl8a7ltyejjcy2mc6nfs9gm2lp"
	}
}
source

fn get_slatepack_secret_key( &self, token: Token, derivation_index: u32 ) -> Result<Ed25519SecretKey, Error>

Networked version of Owner::get_slatepack_secret_key.

{
	"jsonrpc": "2.0",
	"method": "get_slatepack_secret_key",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"derivation_index": 0
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "86cca2aedea7989dfcca62e54477301d098bac260656d11373e314c099f0b26f"
	}
}
source

fn create_slatepack_message( &self, token: Token, slate: VersionedSlate, sender_index: Option<u32>, recipients: Vec<SlatepackAddress> ) -> Result<String, Error>

Networked version of Owner::create_slatepack_message.

{
	"jsonrpc": "2.0",
	"method": "create_slatepack_message",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"sender_index": 0,
		"recipients": [],
		"slate": {
			"ver": "4:2",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"sta": "S1",
			"off": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"amt": "60000000000",
			"fee": "7000000",
			"sigs": [
				{
					"xs": "030152d2d72e2dba7c6086ad49a219d9ff0dfe0fd993dcaea22e058c210033ce93",
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f"
				}
			]
		}
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": "BEGINSLATEPACK. xyfzdULuUuM5r3R kS68aywyCuYssPs Jf1JbvnBcK6NDDo ajiGAgh2SPx4t49 xtKuJE3BZCcSEue ksecMmbSoV2DQbX gGcmJniP9UadcmR N1KSc5FBhwAaUjy LXeYDP7EV7Cmsj4 pLaJdZTJTQbccUH 2zG8QTgoEiEWP5V T6rKst1TibmDAFm RRVHYDtskdYJb5G krqfpgN7RjvPfpm Z5ZFyz6ipAt5q9T 2HCjrTxkHdVi9js 22tr2Lx6iXT5vm8 JL6HhjwyFrSaEmN AjsBE8jgiaAABA6 GGZKwcXeXToMfRt nL9DeX1. ENDSLATEPACK."
	}
}
source

fn slate_from_slatepack_message( &self, token: Token, message: String, secret_indices: Vec<u32> ) -> Result<VersionedSlate, Error>

Networked version of Owner::slate_from_slatepack_message.

{
	"jsonrpc": "2.0",
	"method": "slate_from_slatepack_message",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"secret_indices": [0],
		"message": "BEGINSLATEPACK. 8GQrdcwdLKJD28F 3a9siP7ZhZgAh7w BR2EiZHza5WMWmZ Cc8zBUemrrYRjhq j3VBwA8vYnvXXKU BDmQBN2yKgmR8mX UzvXHezfznA61d7 qFZYChhz94vd8Ew NEPLz7jmcVN2C3w wrfHbeiLubYozP2 uhLouFiYRrbe3fQ 4uhWGfT3sQYXScT dAeo29EaZJpfauh j8VL5jsxST2SPHq nzXFC2w9yYVjt7D ju7GSgHEp5aHz9R xstGbHjbsb4JQod kYLuELta1ohUwDD pvjhyJmsbLcsPei k5AQhZsJ8RJGBtY bou6cU7tZeFJvor 4LB9CBfFB3pmVWD vSLd5RPS75dcnHP nbXD8mSDZ8hJS2Q A9wgvppWzuWztJ2 dLUU8f9tLJgsRBw YZAs71HiVeg7. ENDSLATEPACK."
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"amt": "6000000000",
			"fee": "8000000",
			"id": "0436430c-2b02-624c-2032-570501212b00",
			"off": "d202964900000000d302964900000000d402964900000000d502964900000000",
			"proof": {
				"raddr": "783f6528669742a990e0faf0a5fca5d5b3330e37bbb9cd5c628696d03ce4e810",
				"saddr": "32cdd63928854f8b2628b1dce4626ddcdf35d56cb7cfdf7d64cca5822b78d4d3"
			},
			"sigs": [
				{
					"nonce": "031b84c5567b126440995d3ed5aaba0565d71e1834604819ff9c17f5e9d5dd078f",
					"xs": "023878ce845727f3a4ec76ca3f3db4b38a2d05d636b8c3632108b857fed63c96de"
				}
			],
			"sta": "S1",
			"ver": "4:2"
		}
	}
}
source

fn decode_slatepack_message( &self, token: Token, message: String, secret_indices: Vec<u32> ) -> Result<Slatepack, Error>

Networked version of Owner::decode_slatepack_message.

{
	"jsonrpc": "2.0",
	"method": "decode_slatepack_message",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"secret_indices": [0],
		"message": "BEGINSLATEPACK. t9EcGgrKr1GFCQB SK2jPCxME6Hgpqx bntpQm3zKFycoPY nW4UeoL4KQ7ExNK At6EQsvpz6MjUs8 6WG8KHEbMfqufJQ ZJTw2gkcdJmJjiJ f29oGgYqqXDZox4 ujPSjrtoxCN4h3e i1sZ8dYsm3dPeXL 7VQLsYNjAefciqj ZJXPm4Pqd7VDdd4 okGBGBu3YJvYzT6 arAxeCEx66us31h AJLcDweFwyWBkW5 J1DLiYAjt5ftFTo CjpfW9KjiLq2LM5 jepXWEHJPSDAYVK 4macDZUhRbJiG6E hrQcPrJBVC716mb Hw5E1PFrE6on5wq oEmrS4j9vaB5nw8 Z9ZyXvPc2LN7tER yt6pSHZeY9EpYdY zv4bthzfRfF8ePT TMeMpV2gpgyRXQa CPD2TR. ENDSLATEPACK."
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"mode": 0,
			"payload": "AAQAAgQ2QwwrAmJMIDJXBQEhKwAB0gKWSQAAAADTApZJAAAAANQClkkAAAAA1QKWSQAAAAAGAAAAAWWgvAAAAAAAAHoSAAEAAjh4zoRXJ/Ok7HbKPz20s4otBdY2uMNjIQi4V/7WPJbeAxuExVZ7EmRAmV0+1aq6BWXXHhg0YEgZ/5wX9enV3QePAjLN1jkohU+LJiix3ORibdzfNdVst8/ffWTMpYIreNTTeD9lKGaXQqmQ4Prwpfyl1bMzDje7uc1cYoaW0Dzk6BAA",
			"sender": "tgrin1xtxavwfgs48ckf3gk8wwgcndmn0nt4tvkl8a7ltyejjcy2mc6nfs9gm2lp",
			"slatepack": "1.0"
		}
	}
}
source

fn retrieve_payment_proof( &self, token: Token, refresh_from_node: bool, tx_id: Option<u32>, tx_slate_id: Option<Uuid> ) -> Result<PaymentProof, Error>

Networked version of Owner::retrieve_payment_proof.

{
	"jsonrpc": "2.0",
	"method": "retrieve_payment_proof",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"refresh_from_node": true,
		"tx_id": null,
		"tx_slate_id": "0436430c-2b02-624c-2032-570501212b00"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"amount": "60000000000",
			"excess": "09eac5f5872fa5e08e0c29fd900f1b8f77ff3ad1d0d1c46aeb202cbf92363fe0af",
			"recipient_address": "tgrin10qlk22rxjap2ny8qltc2tl996kenxr3hhwuu6hrzs6tdq08yaqgqq6t83r",
			"recipient_sig": "02868f2d2b983981f8f98043701687a8531ed2de564ea3df48e9e7e0229ccbe8359efe506896df2efbe3528e977252c50e4a41ca3cc9896e7c5a30bbb1d33604",
			"sender_address": "tgrin1xtxavwfgs48ckf3gk8wwgcndmn0nt4tvkl8a7ltyejjcy2mc6nfs9gm2lp",
			"sender_sig": "c511764f3f61ed3d1cbca9514df8bc6811fad5662b1cb0e0587b9c9e49db9f33183cce71af6cb24b507fabf525a2bc405c6e84e63a60334edff0b451ae5e6102"
		}
	}
}
source

fn verify_payment_proof( &self, token: Token, proof: PaymentProof ) -> Result<(bool, bool), Error>

Networked version of Owner::verify_payment_proof.

{
	"jsonrpc": "2.0",
	"method": "verify_payment_proof",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"proof": {
			"amount": "60000000000",
			"excess": "09eac5f5872fa5e08e0c29fd900f1b8f77ff3ad1d0d1c46aeb202cbf92363fe0af",
			"recipient_address": "slatepack10qlk22rxjap2ny8qltc2tl996kenxr3hhwuu6hrzs6tdq08yaqgqnlumr7",
			"recipient_sig": "02868f2d2b983981f8f98043701687a8531ed2de564ea3df48e9e7e0229ccbe8359efe506896df2efbe3528e977252c50e4a41ca3cc9896e7c5a30bbb1d33604",
			"sender_address": "slatepack1xtxavwfgs48ckf3gk8wwgcndmn0nt4tvkl8a7ltyejjcy2mc6nfskdvkdu",
			"sender_sig": "c511764f3f61ed3d1cbca9514df8bc6811fad5662b1cb0e0587b9c9e49db9f33183cce71af6cb24b507fabf525a2bc405c6e84e63a60334edff0b451ae5e6102"
		}
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": [
			true,
			false
		]
	}
}
source

fn set_tor_config(&self, tor_config: Option<TorConfig>) -> Result<(), Error>

Networked version of Owner::set_tor_config.

{
	"jsonrpc": "2.0",
	"method": "set_tor_config",
	"params": {
		"tor_config": {
			"use_tor_listener": true,
			"socks_proxy_addr": "127.0.0.1:59050",
			"send_config_dir": "."
		}
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": null
	}
}
source

fn build_output( &self, token: Token, features: OutputFeatures, amount: Amount ) -> Result<BuiltOutput, Error>

Networked version of Owner::build_output.

{
	"jsonrpc": "2.0",
	"method": "build_output",
	"params": {
		"token": "d202964900000000d302964900000000d402964900000000d502964900000000",
		"features": "Plain",
		"amount":  "60000000000"
	},
	"id": 1
}
{
	"id": 1,
	"jsonrpc": "2.0",
	"result": {
		"Ok": {
			"blind": "089705aa74b638ee391e295d227c534a50dd58e603bca97a4404747cf8a5a189",
			"key_id": "0300000000000000000000000000000000",
			"output": {
				"commit": "08e1da9e6dc4d6e808a718b2f110a991dd775d65ce5ae408a4e1f002a4961aa9e7",
				"features": "Plain",
				"proof": "4b5d6fb1b4d143fc50c83aef61c5410be760a395ed71f3424f7746bf5ee0539ae299569d99b73ea6583b1057834551faa0ac8cfe34c75431b86d6f37dec1ff070fc01f44babf0d3446781564ff7a143242ea67cb4ff7b11fe399735695c3fe70b40b71f31b04cf73b1d1f3430fb53a8c9f990fae48c09b42f8212d60a2d3ce0b8ea4dc0d37a82c3f328162ab8d50f48c28cb9a721a87a40aa3915bf9fffc0cd820e15b758e8565ad7fbf22d03711dc83f98e7c9f955d9398a1c75bc96df2ee64751592953cced38527b3f68282d2ca2fdf2994fbd93a1642fb9d265d57c3cf7df01501da569f2b4e606a1c3084c807a39947a3e1fd41b0647891e1f64842a2b98e694b93857e30691e0b0bca7bc49dec9d6af1003a40b3431ae0bcae8454a438523d066dcac4f194d8370c5ba6567830f302e1ec2607b8d1720bb6c6c57c549f1a3ef7ad2b54dfdd0178329e0723b8a55b438a1e43a984c072d6505aa5e193042d9703484c8383e78d9553684fad5e399f11f8ae6577e4ac4e3c2478e3fd8df0164600b4816b2167c2bf5b9fd7dd29cc1041fccbf1392240fd7c1dc39dd1ebc86b882a383dfe683e9f029d40b2829e3bf56b9760e1d81b7ad4a9066b1c01ccbea6b196154443cacedaccd5ff4fd25cbd9a8f0d271d5688bbe4b956fd34d3413d0478ac9400f6f1ff3890dea10be072d2d48bfa69a6e1e1b6fffaa9db4663eb1ecc26da331072877eb6d4a05a41584d44ed5d2a96a98727563bf180768940c99a15e9183ae927f47f2c0e13d9c00d7ebf0dacb1b6c139d3e18701d10c9d1ef300eeeab756eaa4584c3f5fb42793f7c2517601ae31d887c177eec8bce35c0aa16ba6991fd885deb9ff7b44ffd489f8e9e9d0717141501143c027d33e8a4baf6d85c859ff8a04d1aafbb3d1a97dc6c8ee3642ec41b8e43a137b43c8e60d69a6f19eb9749e"
			}
		}
	}
}

Trait Implementations§

source§

impl Handler for dyn OwnerRpc

source§

fn handle(&self, method: &str, params: Params) -> Result<Value, Error>

Type-check params and call method if method exists. This method is implemented automatically by the rpc macro.
source§

fn handle_request(&self, raw_request: Value) -> MaybeReply

Parses raw_request as a jsonrpc request, handles request according to the jsonrpc spec.

Implementors§

source§

impl<L, C, K> OwnerRpc for Owner<L, C, K>
where L: WalletLCProvider<'static, C, K>, C: NodeClient + 'static, K: Keychain + 'static,