feat: add provider interface

fix: fix an issue that was preventing unit intervals to be created from doubles without decilams

CMakeLists.txt

@@ -6,6 +6,7 @@ SET(PROJECT_NAME "cardano-c")
 # Option that the user can optionally select
 OPTION (TESTING_ENABLED "Enables unit test build." ON)
 OPTION (DOXYGEN_ENABLED "Build documentation" OFF)
+OPTION (EXAMPLES_ENABLED "Build examples" OFF)
 
 # Find external dependencies
 LIST (APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
@@ -67,6 +68,7 @@ MESSAGE ( STATUS "CMAKE_PREFIX_PATH = ${CMAKE_PREFIX_PATH}" )
 MESSAGE ( STATUS "ARCHITECTURE = ${ARCHITECTURE}" )
 MESSAGE ( STATUS "TESTING ENABLED = ${TESTING_ENABLED}")
 MESSAGE ( STATUS "DOXYGEN ENABLED = ${DOXYGEN_ENABLED}")
+MESSAGE ( STATUS "EXAMPLES ENABLED = ${EXAMPLES_ENABLED}")
 MESSAGE ( STATUS "CMAKE_C_CLANG_TIDY = ${CMAKE_C_CLANG_TIDY}")
 MESSAGE ( STATUS )
 MESSAGE ( STATUS "change a configuration variable with: cmake -D<Variable>=<Value>" )
@@ -159,6 +161,10 @@ IF (CMAKE_BUILD_TYPE STREQUAL "Fuzz")
  ADD_SUBDIRECTORY (fuzz ${BUILD_DIR}/fuzz)
 ENDIF ()
 
+# Build examples
+IF (EXAMPLES_ENABLED)
+ ADD_SUBDIRECTORY (examples ${BUILD_DIR}/examples)
+ENDIF ()
 
 # Packaging.
 SET (CPACK_SOURCE_IGNORE_FILES ".git,.swp")

doc/src/sections/api/providers/index.rst

@@ -0,0 +1,10 @@
+Providers
+===================
+
+This section of the documentation introduces the data providers for interacting with the Cardano blockchain:
+
+.. toctree::
+ :maxdepth: 1
+
+ provider
+ provider_impl

doc/src/sections/api/providers/provider.rst

@@ -0,0 +1,72 @@
+Provider
+==========================
+
+.. doxygentypedef:: cardano_provider_t
+
+------------
+
+.. doxygenfunction:: cardano_provider_new
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_name
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_parameters
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_unspent_outputs
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_rewards_available
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_unspent_outputs_with_asset
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_unspent_output_by_nft
+
+------------
+
+.. doxygenfunction:: cardano_provider_resolve_unspent_outputs
+
+------------
+
+.. doxygenfunction:: cardano_provider_resolve_datum_outputs
+
+------------
+
+.. doxygenfunction:: cardano_provider_confirm_transaction_outputs
+
+------------
+
+.. doxygenfunction:: cardano_provider_submit_transaction
+
+------------
+
+.. doxygenfunction:: cardano_provider_evaluate_transaction
+
+------------
+
+.. doxygenfunction:: cardano_provider_unref
+
+------------
+
+.. doxygenfunction:: cardano_provider_ref
+
+------------
+
+.. doxygenfunction:: cardano_provider_refcount
+
+------------
+
+.. doxygenfunction:: cardano_provider_set_last_error
+
+------------
+
+.. doxygenfunction:: cardano_provider_get_last_error

doc/src/sections/api/providers/provider_impl.rst

@@ -0,0 +1,49 @@
+Provider Implementation
+==========================
+
+.. doxygentypedef:: cardano_provider_impl_t
+
+------------
+
+.. doxygentypedef:: cardano_get_parameters_func_t
+
+
+------------
+
+.. doxygentypedef:: cardano_get_unspent_outputs_func_t
+
+------------
+
+.. doxygentypedef:: cardano_get_rewards_balance_func_t
+
+------------
+
+.. doxygentypedef:: cardano_get_unspent_outputs_with_asset_func_t
+
+------------
+
+.. doxygentypedef:: cardano_get_unspent_output_by_nft_func_t
+
+------------
+
+.. doxygentypedef:: cardano_resolve_unspent_outputs_func_t
+
+
+------------
+
+.. doxygentypedef:: cardano_resolve_datum_func_t
+
+------------
+
+.. doxygentypedef:: cardano_confirm_transaction_func_t
+
+
+------------
+
+.. doxygentypedef:: cardano_submit_transaction_func_t
+
+
+------------
+
+.. doxygentypedef:: cardano_evaluate_transaction_func_t
+

doc/src/sections/api/transaction_body/value.rst

@@ -9,6 +9,10 @@ Value
 
 ------------
 
+.. doxygenfunction:: cardano_value_from_asset_map
+
+------------
+
 .. doxygenfunction:: cardano_value_from_cbor
 
 ------------

doc/src/sections/api/witness_set/redeemer_list.rst

@@ -29,6 +29,14 @@ Redeemer List
 
 ------------
 
+.. doxygenfunction:: cardano_redeemer_list_set_ex_units
+
+------------
+
+.. doxygenfunction:: cardano_redeemer_list_clone
+
+------------
+
 .. doxygenfunction:: cardano_redeemer_list_clear_cbor_cache
 
 ------------

doc/src/sections/index.rst

@@ -83,6 +83,7 @@ See `APACHE LICENSE, VERSION 2.0`_
  api/pool_params/index
  api/proposal_procedures/index
  api/protocol_params/index
+ api/providers/index
  api/scripts/index
  api/transaction/index
  api/transaction_body/index

examples/CMakeLists.txt

@@ -0,0 +1,20 @@
+FILE(GLOB EXAMPLE_SOURCES "*_example.c")
+MESSAGE(STATUS "Example sources: ${EXAMPLE_SOURCES}")
+
+FILE(GLOB_RECURSE PROVIDERS_HEADER_DIRS RELATIVE ${CMAKE_SOURCE_DIR} utils/ providers/)
+
+FILE(GLOB_RECURSE PROVIDERS_SOURCE_FILES utils/*.c providers/*.c)
+
+FIND_PACKAGE(CURL REQUIRED)
+
+FOREACH(EXAMPLE_SOURCE ${EXAMPLE_SOURCES})
+ GET_FILENAME_COMPONENT(EXAMPLE_TARGET_NAME ${EXAMPLE_SOURCE} NAME_WE) # Extract the filename without extension
+
+ ADD_EXECUTABLE(${EXAMPLE_TARGET_NAME} ${EXAMPLE_SOURCE} ${PROVIDERS_SOURCE_FILES})
+ MESSAGE(STATUS "Example source: ${EXAMPLE_TARGET_NAME}")
+
+ TARGET_INCLUDE_DIRECTORIES(${EXAMPLE_TARGET_NAME} PRIVATE ${CARDANO_C_INCLUDE_DIR})
+ TARGET_INCLUDE_DIRECTORIES(${EXAMPLE_TARGET_NAME} PRIVATE utils providers)
+
+ TARGET_LINK_LIBRARIES(${EXAMPLE_TARGET_NAME} PRIVATE cardano-c ${CURL_LIBRARIES})
+ENDFOREACH()