Decentralised Art Server
High-performance C++ backend that exposes HTML interface and a secure REST API for managing Performative Transactions entities
Loading...
Searching...
No Matches
api.hpp
Go to the documentation of this file.
1#pragma once
2#include <ranges>
3
4#include <spdlog/spdlog.h>
5
6#include "async.hpp"
7#include "utils.hpp"
8#include "config.hpp"
9#include "route.hpp"
10#include "parser.hpp"
11#include "pt.hpp"
12#include "auth.hpp"
13#include "chain.hpp"
14#include "evm.hpp"
15#include "version.hpp"
16#include "loader.hpp"
17#include "events.hpp"
18#include "feed_types.hpp"
19
20namespace dcn
21{
25 asio::awaitable<std::expected<chain::Address, auth::AuthError>> authenticate(const http::Request & request, const auth::AuthManager & auth_manager);
26
27
37 asio::awaitable<http::Response> GET_version(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, const std::string & build_timestamp);
38
39
48 asio::awaitable<http::Response> HEAD_serveFile(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
49
58 asio::awaitable<http::Response> OPTIONS_serveFile(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
59
70 asio::awaitable<http::Response> GET_serveFile(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, const std::string mime_type, const std::string & file_content);
71
82 asio::awaitable<http::Response> GET_serveBinaryFile(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, const std::string mime_type, const std::vector<std::byte> & file_content);
83
93 asio::awaitable<http::Response> GET_nonce(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, auth::AuthManager & auth_manager);
94
95
104 asio::awaitable<http::Response> OPTIONS_auth(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
105
115 asio::awaitable<http::Response> POST_auth(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, auth::AuthManager & auth_manager);
116
117
126 asio::awaitable<http::Response> OPTIONS_accountInfo(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
127
137 asio::awaitable<http::Response> GET_accountInfo(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
138
147 asio::awaitable<http::Response> OPTIONS_formats(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
148
160 asio::awaitable<http::Response> HEAD_formats(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
161
173 asio::awaitable<http::Response> GET_formats(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
174
183 asio::awaitable<http::Response> OPTIONS_format(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
184
196 asio::awaitable<http::Response> GET_format(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
197
206 asio::awaitable<http::Response> OPTIONS_accounts(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
207
219 asio::awaitable<http::Response> HEAD_accounts(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
220
232 asio::awaitable<http::Response> GET_accounts(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
233
237 asio::awaitable<http::Response> OPTIONS_feed(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
238
242 asio::awaitable<http::Response> GET_feed(
243 const http::Request & request,
244 std::vector<server::RouteArg> route_args,
245 server::QueryArgsList query_args,
246 feed::IFeedRepository & feed_repo);
247
251 asio::awaitable<http::Response> OPTIONS_feedStream(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
252
261 std::string buildFeedStreamSseReplay(
262 feed::IFeedRepository & feed_repo,
263 const feed::StreamQuery & query);
264
275 asio::awaitable<void> GET_feedStream(
276 asio::ip::tcp::socket & sock,
277 const http::Request & request,
278 std::vector<server::RouteArg> route_args,
279 server::QueryArgsList query_args,
280 std::chrono::steady_clock::time_point & deadline,
281 feed::IFeedRepository & feed_repo);
282
283
293 asio::awaitable<http::Response> HEAD_connector(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
294
303 asio::awaitable<http::Response> OPTIONS_connector(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
304
314 asio::awaitable<http::Response> GET_connector(
315 const http::Request & request,
316 std::vector<server::RouteArg> route_args,
317 server::QueryArgsList query_args,
318 registry::Registry & registry);
319
329 asio::awaitable<http::Response> POST_connector(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args,
330 auth::AuthManager & auth_manager, registry::Registry & registry, evm::EVM & evm, const config::Config & config);
331
341 asio::awaitable<http::Response> HEAD_transformation(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
342
351 asio::awaitable<http::Response> OPTIONS_transformation(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
352
365 asio::awaitable<http::Response> GET_transformation(
366 const http::Request & request,
367 std::vector<server::RouteArg> route_args,
368 server::QueryArgsList query_args,
369 registry::Registry & registry);
370
384 asio::awaitable<http::Response> POST_transformation(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args,
385 auth::AuthManager & auth_manager, registry::Registry & registry, evm::EVM & evm, const config::Config & config);
386
387
397 asio::awaitable<http::Response> HEAD_condition(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args, registry::Registry & registry);
398
407 asio::awaitable<http::Response> OPTIONS_condition(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
408
421 asio::awaitable<http::Response> GET_condition(
422 const http::Request & request,
423 std::vector<server::RouteArg> route_args,
424 server::QueryArgsList query_args,
425 registry::Registry & registry);
426
440 asio::awaitable<http::Response> POST_condition(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args,
441 auth::AuthManager & auth_manager, registry::Registry & registry, evm::EVM & evm, const config::Config & config);
442
451 asio::awaitable<http::Response> OPTIONS_execute(const http::Request & request, std::vector<server::RouteArg> route_args, server::QueryArgsList query_args);
452
465 asio::awaitable<http::Response> POST_execute(
466 const http::Request & request,
467 std::vector<server::RouteArg> route_args,
468 server::QueryArgsList query_args,
469 const auth::AuthManager & auth_manager,
470 registry::Registry & registry,
471 evm::EVM & evm,
472 const config::Config & config);
473}
dcn::auth::AuthManager
Definition auth.hpp:42
dcn::evm::EVM
Definition evm.hpp:45
dcn::feed::IFeedRepository
Definition feed_types.hpp:91
dcn::http::Request
Definition http.hpp:110
dcn::registry::Registry
Definition registry.hpp:42
feed_types.hpp
dcn::config
Definition config.hpp:8
dcn::evm
Definition evm.hpp:43
dcn::registry
Definition registry.hpp:23
dcn::server::QueryArgsList
absl::flat_hash_map< std::string, RouteArg > QueryArgsList
Definition route.hpp:25
dcn
Definition decentralised_art.hpp:35
dcn::OPTIONS_serveFile
asio::awaitable< http::Response > OPTIONS_serveFile(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests for a file by returning a response with CORS headers.
Definition api_file.cpp:17
dcn::GET_feedStream
asio::awaitable< void > GET_feedStream(asio::ip::tcp::socket &sock, const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, std::chrono::steady_clock::time_point &deadline, feed::IFeedRepository &feed_repo)
Handles GET requests to /feed/stream?since_seq=<~uint>&limit=<~uint>
Definition api_feed.cpp:265
dcn::GET_nonce
asio::awaitable< http::Response > GET_nonce(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, auth::AuthManager &auth_manager)
Handle a GET request to /auth/nonce.
Definition api_auth.cpp:55
dcn::POST_connector
asio::awaitable< http::Response > POST_connector(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, auth::AuthManager &auth_manager, registry::Registry &registry, evm::EVM &evm, const config::Config &config)
Handle a POST request to /connectors.
Definition api_connector.cpp:145
dcn::OPTIONS_feedStream
asio::awaitable< http::Response > OPTIONS_feedStream(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests to /feed/stream?since_seq=<~uint>&limit=<~uint>
Definition api_feed.cpp:164
dcn::HEAD_serveFile
asio::awaitable< http::Response > HEAD_serveFile(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles HEAD requests for a file.
Definition api_file.cpp:6
dcn::GET_serveBinaryFile
asio::awaitable< http::Response > GET_serveBinaryFile(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, const std::string mime_type, const std::vector< std::byte > &file_content)
Handles GET requests for a binary file.
Definition api_file.cpp:44
dcn::authenticate
asio::awaitable< std::expected< chain::Address, auth::AuthError > > authenticate(const http::Request &request, const auth::AuthManager &auth_manager)
Helper function to handle authentication.
Definition api_auth.cpp:32
dcn::POST_transformation
asio::awaitable< http::Response > POST_transformation(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, auth::AuthManager &auth_manager, registry::Registry &registry, evm::EVM &evm, const config::Config &config)
Handles POST requests for the transformation endpoint.
Definition api_transformation.cpp:134
dcn::GET_transformation
asio::awaitable< http::Response > GET_transformation(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles GET requests for the transformation endpoint.
Definition api_transformation.cpp:65
dcn::GET_condition
asio::awaitable< http::Response > GET_condition(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles GET requests for the condition endpoint.
Definition api_condition.cpp:65
dcn::HEAD_connector
asio::awaitable< http::Response > HEAD_connector(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles HEAD requests for the connector endpoint.
Definition api_connector.cpp:11
dcn::OPTIONS_accounts
asio::awaitable< http::Response > OPTIONS_accounts(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles a OPTIONS request to /accounts?limit=<uint>&after=<~string>
Definition api_account.cpp:62
dcn::OPTIONS_feed
asio::awaitable< http::Response > OPTIONS_feed(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests to /feed?limit=<uint>&before=<~string>&type=<~string>&include_unfinalized=<~...
Definition api_feed.cpp:17
dcn::OPTIONS_formats
asio::awaitable< http::Response > OPTIONS_formats(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles a OPTIONS request to /formats?limit=<uint>&after=<~string>
Definition api_format.cpp:15
dcn::OPTIONS_auth
asio::awaitable< http::Response > OPTIONS_auth(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles a OPTIONS request to /auth.
Definition api_auth.cpp:106
dcn::OPTIONS_connector
asio::awaitable< http::Response > OPTIONS_connector(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests by returning a response with CORS headers.
Definition api_connector.cpp:48
dcn::HEAD_transformation
asio::awaitable< http::Response > HEAD_transformation(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles HEAD requests for the transformation endpoint.
Definition api_transformation.cpp:12
dcn::HEAD_accounts
asio::awaitable< http::Response > HEAD_accounts(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a HEAD request to /accounts?limit=<uint>&after=<~string>
Definition api_account.cpp:76
dcn::OPTIONS_condition
asio::awaitable< http::Response > OPTIONS_condition(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests for the condition endpoint by returning a response with CORS headers.
Definition api_condition.cpp:51
dcn::buildFeedStreamSseReplay
std::string buildFeedStreamSseReplay(feed::IFeedRepository &feed_repo, const feed::StreamQuery &query)
Builds the SSE replay body for /feed/stream using the feed module.
Definition api_feed.cpp:236
dcn::POST_auth
asio::awaitable< http::Response > POST_auth(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, auth::AuthManager &auth_manager)
Handles a POST request to /auth.
Definition api_auth.cpp:120
dcn::HEAD_condition
asio::awaitable< http::Response > HEAD_condition(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles HEAD requests for the condition endpoint.
Definition api_condition.cpp:12
dcn::GET_feed
asio::awaitable< http::Response > GET_feed(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, feed::IFeedRepository &feed_repo)
Handles GET requests to /feed?limit=<uint>&before=<~string>&type=<~string>&include_unfinalized=<~uint...
Definition api_feed.cpp:30
dcn::OPTIONS_transformation
asio::awaitable< http::Response > OPTIONS_transformation(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests for the transformation endpoint by returning a response with CORS headers.
Definition api_transformation.cpp:51
dcn::GET_formats
asio::awaitable< http::Response > GET_formats(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a GET request to /formats?limit=<uint>&after=<~string>
Definition api_format.cpp:85
dcn::GET_format
asio::awaitable< http::Response > GET_format(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a GET request to /format/<hash>?limit=<uint>&after=<~string>
Definition api_format.cpp:190
dcn::POST_execute
asio::awaitable< http::Response > POST_execute(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, const auth::AuthManager &auth_manager, registry::Registry &registry, evm::EVM &evm, const config::Config &config)
Handles POST requests for the execute endpoint.
Definition api_execute.cpp:26
dcn::GET_connector
asio::awaitable< http::Response > GET_connector(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handle a GET request to /connectors.
Definition api_connector.cpp:62
dcn::POST_condition
asio::awaitable< http::Response > POST_condition(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, auth::AuthManager &auth_manager, registry::Registry &registry, evm::EVM &evm, const config::Config &config)
Handles POST requests for the condition endpoint.
Definition api_condition.cpp:134
dcn::OPTIONS_accountInfo
asio::awaitable< http::Response > OPTIONS_accountInfo(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles a OPTIONS request to /account.
Definition api_account.cpp:223
dcn::HEAD_formats
asio::awaitable< http::Response > HEAD_formats(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a HEAD request to /formats?limit=<uint>&after=<~string>
Definition api_format.cpp:29
dcn::GET_version
asio::awaitable< http::Response > GET_version(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, const std::string &build_timestamp)
Handles GET requests for the version endpoint.
Definition api.cpp:5
dcn::OPTIONS_format
asio::awaitable< http::Response > OPTIONS_format(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles a OPTIONS request to /format/<hash>?limit=<uint>&after=<~string>
Definition api_format.cpp:176
dcn::GET_accounts
asio::awaitable< http::Response > GET_accounts(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a GET request to /accounts?limit=<uint>&after=<~string>
Definition api_account.cpp:132
dcn::OPTIONS_execute
asio::awaitable< http::Response > OPTIONS_execute(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args)
Handles OPTIONS requests for the execute endpoint by returning a response with CORS headers.
Definition api_execute.cpp:12
dcn::GET_accountInfo
asio::awaitable< http::Response > GET_accountInfo(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, registry::Registry &registry)
Handles a GET request to /account.
Definition api_account.cpp:237
dcn::GET_serveFile
asio::awaitable< http::Response > GET_serveFile(const http::Request &request, std::vector< server::RouteArg > route_args, server::QueryArgsList query_args, const std::string mime_type, const std::string &file_content)
Handles GET requests for a file.
Definition api_file.cpp:31
dcn::config::Config
Definition config.hpp:24
dcn::feed::StreamQuery
Definition feed_types.hpp:64