Trait grin_wallet_api::OwnerRpc

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

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

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

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
}

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

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
}

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

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
}

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

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"
					}
				}
			]
		]
	}
}

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

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"
		}
	  ]
	]
  }
}

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

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"
			}
		]
	}
}

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

Networked version of [Owner::init_send_tx](struct.Owner.html#method.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"
			}
		}
	}

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

Networked version of [Owner::issue_invoice_tx](struct.Owner.html#method.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"
			}
		}
	}

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

 Networked version of [Owner::process_invoice_tx](struct.Owner.html#method.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"
		}
	}
}

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

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
	}
}

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

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"
		}
	}
}

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

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
	}
}

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

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
	}
}

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

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"
		}
	}
}

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

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
	}
}

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

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
		}
	}
}

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

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..."
	 }
}

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

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"
	}
}

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

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
	}
}

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

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,
			"keybase_notify_ttl": 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
	}
}

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

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
	}
}

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

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"
	}
}

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

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
	}
}

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

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"
	}
}

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

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
	}
}

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

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
	}
}

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

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
	}
}

pub fn stop_updater(&self) -> Result<(), ErrorKind>

Networked version of Owner::stop_updater.

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

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

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": []
	}
}

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

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"
	}
}

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

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"
	}
}

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

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."
	}
}

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

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"
		}
	}
}

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

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"
		}
	}
}

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

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"
		}
	}
}

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

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
		]
	}
}

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

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
	}
}

Loading content...

Trait Implementations

impl Handler for dyn OwnerRpc

pub 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.

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

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

Implementors

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

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

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

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

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

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

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

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

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

pub fn process_invoice_tx(
    &self,
    token: Token,
    in_slate: VersionedSlate,
    args: InitTxArgs
) -> Result<VersionedSlate, ErrorKind>

pub fn finalize_tx(
    &self,
    token: Token,
    in_slate: VersionedSlate
) -> Result<VersionedSlate, ErrorKind>

pub fn tx_lock_outputs(
    &self,
    token: Token,
    in_slate: VersionedSlate
) -> Result<(), ErrorKind>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub fn stop_updater(&self) -> Result<(), ErrorKind>

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

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

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

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

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

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

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

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

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

Loading content...