Skip to content

Commit 973a585

Browse files
committed
docs(api docs): add api docs
1 parent 5fdefe2 commit 973a585

File tree

78 files changed

+1554
-1
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

78 files changed

+1554
-1
lines changed

README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,10 @@ For more examples, check the [examples directory](examples).
6262

6363
## API Documentation
6464

65-
The SDK is built on top of an OpenAPI specification which can be found in the [openapi.json](openapi.json) file. For detailed API documentation, please refer to the OpenZeppelin Relayer documentation.
65+
The SDK is built on top of an OpenAPI specification which can be found in the [openapi.json](openapi.json) file.
66+
67+
For detailed API documentation, please refer to the [API Reference](docs/README.md) in the docs folder. This documentation provides comprehensive information about all available endpoints, request parameters, and response types.
68+
6669

6770
## Development
6871

docs/.openapi-generator-ignore

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# OpenAPI Generator Ignore
2+
# Generated by openapi-generator https://github.com/openapitools/openapi-generator
3+
4+
# Use this file to prevent files from being overwritten by the generator.
5+
# The patterns follow closely to .gitignore or .dockerignore.
6+
7+
# As an example, the C# client generator defines ApiClient.cs.
8+
# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
9+
#ApiClient.cs
10+
11+
# You can match any string of characters against a directory, file or extension with a single asterisk (*):
12+
#foo/*/qux
13+
# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
14+
15+
# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
16+
#foo/**/qux
17+
# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
18+
19+
# You can also negate patterns with an exclamation (!).
20+
# For example, you can ignore all files in a docs folder with the file extension .md:
21+
#docs/*.md
22+
# Then explicitly reverse the ignore rule for a single file:
23+
#!docs/README.md

docs/.openapi-generator/FILES

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
Apis/MetricsApi.md
2+
Apis/RelayersApi.md
3+
Models/ApiResponse_BalanceResponse.md
4+
Models/ApiResponse_BalanceResponse_data.md
5+
Models/ApiResponse_RelayerResponse.md
6+
Models/ApiResponse_RelayerResponse_data.md
7+
Models/ApiResponse_SignDataResponse.md
8+
Models/ApiResponse_SignDataResponse_data.md
9+
Models/ApiResponse_String.md
10+
Models/ApiResponse_TransactionResponse.md
11+
Models/ApiResponse_TransactionResponse_data.md
12+
Models/ApiResponse_Vec_RelayerResponse.md
13+
Models/ApiResponse_Vec_TransactionResponse.md
14+
Models/ApiResponse_bool.md
15+
Models/BalanceResponse.md
16+
Models/EvmPolicyResponse.md
17+
Models/EvmRpcRequest.md
18+
Models/EvmRpcRequest_oneOf.md
19+
Models/EvmRpcResult.md
20+
Models/EvmTransactionRequest.md
21+
Models/EvmTransactionResponse.md
22+
Models/FeeEstimateRequestParams.md
23+
Models/FeeEstimateResult.md
24+
Models/GetFeaturesEnabledResult.md
25+
Models/GetSupportedTokensItem.md
26+
Models/GetSupportedTokensResult.md
27+
Models/JsonRpcError.md
28+
Models/JsonRpcRequest_NetworkRpcRequest.md
29+
Models/JsonRpcResponse_NetworkRpcResult.md
30+
Models/JsonRpcResponse_NetworkRpcResult_result.md
31+
Models/NetworkPolicyResponse.md
32+
Models/NetworkRpcRequest.md
33+
Models/NetworkRpcResult.md
34+
Models/NetworkTransactionRequest.md
35+
Models/NetworkType.md
36+
Models/PaginationMeta.md
37+
Models/PrepareTransactionRequestParams.md
38+
Models/PrepareTransactionResult.md
39+
Models/RelayerResponse.md
40+
Models/RelayerUpdateRequest.md
41+
Models/SignAndSendTransactionRequestParams.md
42+
Models/SignAndSendTransactionResult.md
43+
Models/SignDataRequest.md
44+
Models/SignDataResponse.md
45+
Models/SignDataResponseEvm.md
46+
Models/SignDataResponseSolana.md
47+
Models/SignTransactionRequestParams.md
48+
Models/SignTransactionResult.md
49+
Models/SignTypedDataRequest.md
50+
Models/SolanaAllowedTokensPolicy.md
51+
Models/SolanaPolicyResponse.md
52+
Models/SolanaRpcRequest.md
53+
Models/SolanaRpcRequest_oneOf.md
54+
Models/SolanaRpcRequest_oneOf_1.md
55+
Models/SolanaRpcRequest_oneOf_2.md
56+
Models/SolanaRpcRequest_oneOf_3.md
57+
Models/SolanaRpcRequest_oneOf_4.md
58+
Models/SolanaRpcRequest_oneOf_5.md
59+
Models/SolanaRpcRequest_oneOf_6.md
60+
Models/SolanaRpcResult.md
61+
Models/SolanaTransactionRequest.md
62+
Models/SolanaTransactionResponse.md
63+
Models/Speed.md
64+
Models/StellarPolicyResponse.md
65+
Models/StellarRpcRequest.md
66+
Models/StellarRpcResult.md
67+
Models/StellarTransactionRequest.md
68+
Models/StellarTransactionResponse.md
69+
Models/TransactionResponse.md
70+
Models/TransactionStatus.md
71+
Models/TransferTransactionRequestParams.md
72+
Models/TransferTransactionResult.md
73+
README.md

docs/.openapi-generator/VERSION

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
7.12.0

docs/Apis/MetricsApi.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# MetricsApi
2+
3+
All URIs are relative to *http://localhost*
4+
5+
| Method | HTTP request | Description |
6+
|------------- | ------------- | -------------|
7+
| [**listMetrics**](MetricsApi.md#listMetrics) | **GET** /metrics | Returns a list of all available metric names in JSON format. |
8+
| [**metricDetail**](MetricsApi.md#metricDetail) | **GET** /metrics/{metric_name} | Returns the details of a specific metric in plain text format. |
9+
| [**scrapeMetrics**](MetricsApi.md#scrapeMetrics) | **GET** /debug/metrics/scrape | Triggers an update of system metrics and returns the result in plain text format. |
10+
11+
12+
<a name="listMetrics"></a>
13+
# **listMetrics**
14+
> List listMetrics()
15+
16+
Returns a list of all available metric names in JSON format.
17+
18+
# Returns An &#x60;HttpResponse&#x60; containing a JSON array of metric names.
19+
20+
### Parameters
21+
This endpoint does not need any parameter.
22+
23+
### Return type
24+
25+
**List**
26+
27+
### Authorization
28+
29+
No authorization required
30+
31+
### HTTP request headers
32+
33+
- **Content-Type**: Not defined
34+
- **Accept**: application/json
35+
36+
<a name="metricDetail"></a>
37+
# **metricDetail**
38+
> String metricDetail(metric\_name)
39+
40+
Returns the details of a specific metric in plain text format.
41+
42+
# Parameters - &#x60;path&#x60;: The name of the metric to retrieve details for. # Returns An &#x60;HttpResponse&#x60; containing the metric details in plain text, or a 404 error if the metric is not found.
43+
44+
### Parameters
45+
46+
|Name | Type | Description | Notes |
47+
|------------- | ------------- | ------------- | -------------|
48+
| **metric\_name** | **String**| Name of the metric to retrieve, e.g. utopia_transactions_total | [default to null] |
49+
50+
### Return type
51+
52+
**String**
53+
54+
### Authorization
55+
56+
[bearer_auth](../README.md#bearer_auth)
57+
58+
### HTTP request headers
59+
60+
- **Content-Type**: Not defined
61+
- **Accept**: text/plain
62+
63+
<a name="scrapeMetrics"></a>
64+
# **scrapeMetrics**
65+
> String scrapeMetrics()
66+
67+
Triggers an update of system metrics and returns the result in plain text format.
68+
69+
# Returns An &#x60;HttpResponse&#x60; containing the updated metrics in plain text, or an error message if the update fails.
70+
71+
### Parameters
72+
This endpoint does not need any parameter.
73+
74+
### Return type
75+
76+
**String**
77+
78+
### Authorization
79+
80+
No authorization required
81+
82+
### HTTP request headers
83+
84+
- **Content-Type**: Not defined
85+
- **Accept**: text/plain
86+

0 commit comments

Comments
 (0)