Improve FFI interface documentation

Co-authored-by: Daira Hopwood <daira@jacaranda.org>
This commit is contained in:
Jack Grigg 2022-03-12 01:33:39 +00:00
parent 7921ef1c55
commit 93797d185b
2 changed files with 5 additions and 1 deletions

View File

@ -47,7 +47,7 @@ void orchard_builder_free(OrchardBuilderPtr* ptr);
/// Returns `false` if the Merkle path in `spend_info` does not have the
/// required anchor.
///
/// `spend_info` is always freed by this method.
/// `spend_info` is always freed by this method, whether or not it succeeds.
bool orchard_builder_add_spend(
OrchardBuilderPtr* ptr,
OrchardSpendInfoPtr* spend_info);

View File

@ -199,6 +199,8 @@ OrchardIncomingViewingKeyPtr* orchard_full_viewing_key_to_internal_incoming_view
/**
* Returns the external outgoing viewing key for the specified full viewing key.
*
* `ovk_ret` must be 32 bytes.
*/
OrchardIncomingViewingKeyPtr* orchard_full_viewing_key_to_external_outgoing_viewing_key(
const OrchardFullViewingKeyPtr* fvk,
@ -206,6 +208,8 @@ OrchardIncomingViewingKeyPtr* orchard_full_viewing_key_to_external_outgoing_view
/**
* Returns the internal outgoing viewing key for the specified full viewing key.
*
* `ovk_ret` must be 32 bytes.
*/
OrchardIncomingViewingKeyPtr* orchard_full_viewing_key_to_internal_outgoing_viewing_key(
const OrchardFullViewingKeyPtr* fvk,