feat: add DLN api client

.github/workflows/check_pr.yml

@@ -64,7 +64,7 @@ jobs:
     env:
       DEVNET_RPC_URL: "http://localhost:8899"
       DEVNET_WEBSOCKET_URL: "ws://localhost:8900"
-      SCOPE: --scope="espressocash_backend" --scope="espressocash_api" --scope="jupiter_aggregator"
+      SCOPE: --scope="espressocash_backend" --scope="espressocash_api" --scope="jupiter_aggregator" --scope="dln_api"
       EC_LINKS_ID: "7rE2We9zMQzj2xmhJRTvYXKP22VKDGh3krujdBqWibBL"
       EC_LINKS_SO: "packages/espressocash_backend/test/bpf-programs/ec_shareable_links.so"
     steps:

packages/espressocash_backend/dln_api/.gitignore

@@ -0,0 +1,12 @@
+# Files and directories created by pub.
+.dart_tool/
+.packages
+
+# Conventional directory for build outputs.
+build/
+
+# Omit committing pubspec.lock for library packages; see
+# https://dart.dev/guides/libraries/private-files#pubspeclock.
+pubspec.lock
+
+bin/

packages/espressocash_backend/dln_api/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+- Initial version.

packages/espressocash_backend/dln_api/Makefile

@@ -0,0 +1 @@
+include ../../../Makefile

packages/espressocash_backend/dln_api/README.md

@@ -0,0 +1,2 @@
+A sample command-line application with an entrypoint in `bin/`, library code
+in `lib/`, and example unit test in `test/`.

packages/espressocash_backend/dln_api/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:mews_pedantic/analysis_options.yaml

packages/espressocash_backend/dln_api/build.yaml

@@ -0,0 +1,7 @@
+targets:
+  $default:
+    builders:
+      json_serializable:
+        options:
+          explicit_to_json: true
+          include_if_null: false

packages/espressocash_backend/dln_api/lib/dln_api.dart

@@ -0,0 +1,4 @@
+export 'src/client.dart';
+export 'src/models/chains.dart';
+export 'src/models/dto.dart';
+export 'src/models/models.dart';

packages/espressocash_backend/dln_api/lib/src/client.dart

@@ -0,0 +1,38 @@
+import 'package:dio/dio.dart';
+import 'package:dln_api/src/models/dto.dart';
+import 'package:retrofit/retrofit.dart';
+
+part 'client.g.dart';
+
+/// For docs head to https://api.dln.trade/v1.0/#/DLN
+@RestApi(baseUrl: 'https://api.dln.trade/v1.0/dln')
+abstract class DlnApiClient {
+  factory DlnApiClient() => _DlnApiClient(Dio());
+
+  /// This endpoint returns the recommended take amount for creating DLN order.
+  @GET('/order/quote')
+  Future<DlnQuoteResponseDto> getQuote(
+    @Queries() DlnQuoteRequestDto quoteRequestDto,
+  );
+
+  /// This endpoint returns the data for a transaction to place a cross-chain DLN order.
+  @GET('/order/create-tx')
+  Future<CreateTxResponseDto> createTx(
+    @Queries() CreateTxRequestDto createTxRequestDto,
+  );
+
+  /// This endpoint returns the data of order.
+  @GET('/order/{id}')
+  Future<OrderResponseDto> getOrder(@Path() String id);
+
+  /// This endpoint returns the status of order.
+  @GET('/order/{id}/status')
+  Future<OrderStatusResponseDto> getStatus(@Path() String id);
+
+  @GET('/tx/{hash}/order-ids')
+  Future<OrderIdTxResponseDto> getOrderIdByHash(@Path() String hash);
+
+  /// This endpoint generates a transaction that cancels the given order.
+  @GET('/order/{id}/cancel-tx')
+  Future<CancelTxResponseDto> cancelTx(@Path() String id);
+}

packages/espressocash_backend/dln_api/lib/src/models/chains.dart

@@ -0,0 +1,37 @@
+enum DlnChains {
+  arbitrum,
+  avalanche,
+  bnb,
+  ethereum,
+  polygon,
+  solana,
+  linea,
+  base,
+  optimism
+}
+
+extension DlnChainsExt on DlnChains {
+  String get name => switch (this) {
+        DlnChains.arbitrum => 'Arbitrum',
+        DlnChains.avalanche => 'Avalanche',
+        DlnChains.bnb => 'Binance Smart Chain',
+        DlnChains.ethereum => 'Ethereum',
+        DlnChains.polygon => 'Polygon',
+        DlnChains.solana => 'Solana',
+        DlnChains.linea => 'Linea',
+        DlnChains.base => 'Base',
+        DlnChains.optimism => 'Optimism',
+      };
+
+  String get chainId => switch (this) {
+        DlnChains.arbitrum => '42161',
+        DlnChains.avalanche => '43114',
+        DlnChains.bnb => '56',
+        DlnChains.ethereum => '1',
+        DlnChains.polygon => '137',
+        DlnChains.solana => '7565164',
+        DlnChains.linea => '59144',
+        DlnChains.base => '8453',
+        DlnChains.optimism => '10',
+      };
+}