Development registrar client (#2)

* setup melos and registrar_client pkg

* add models and registrar client

* implemented account, farm, node and zos methods

* update path + update createFarm + fix UptimeReport model

Author: SalmaElsoly

.gitignore

@@ -0,0 +1,2 @@
+.dart_tool/
+.idea/

README.md

@@ -0,0 +1,7 @@
+# tfgridV4-sdk-dart
+
+This repo contains the dart clients for Threefold gridV4.
+
+## Packages
+
+- [registrar_client](./packages/registrar_client/README.md)

melos.yaml

@@ -0,0 +1,7 @@
+name: tfgridv4_sdk_dart
+
+packages:
+  - packages/**
+
+scripts:
+  

packages/registrar_client/.gitignore

@@ -0,0 +1,7 @@
+# https://dart.dev/guides/libraries/private-files
+# Created by `dart pub`
+.dart_tool/
+
+# Avoid committing pubspec.lock for library packages; see
+# https://dart.dev/guides/libraries/private-files#pubspeclock.
+pubspec.lock

packages/registrar_client/README.md

@@ -0,0 +1,29 @@
+# Registrar Client
+
+This package provides a client for interacting with the TFGrid v4 Node Registrar.
+
+## Install Dependencies
+
+```bash
+dart pub get
+```
+
+## Usage
+
+- Example usage:
+
+```dart
+import 'package:registrar_client/registrar_client.dart';
+
+void main() async{
+
+     final client = RegistrarClient(
+        baseUrl: 'https://registrar.dev4.grid.tf/v1',
+        privateKey: 'your_private_key');
+
+    final account = await client.account.create(relays: ['relay1', 'relay2'] , rmbEncKey: 'rmb_enc_key');
+
+    final farmIDCreated = await client.farms
+          .create(Farm(dedicated: true, farmName: 'farm', twinID: account.twinID));
+}
+```

packages/registrar_client/bin/registrar_client_example.dart

@@ -0,0 +1,10 @@
+import 'package:registrar_client/registrar_client.dart';
+
+void main() async {
+  final client = RegistrarClient(
+      baseUrl: 'https://registrar.dev4.grid.tf/v1',
+      privateKey: 'your_private_key');
+  final account = await client.accounts.create();
+
+  print(account);
+}

packages/registrar_client/lib/models/account.dart

@@ -0,0 +1,78 @@
+import 'farm.dart';
+
+class Account {
+  final String createdAt;
+  final List<Farm>? farms;
+  final String publicKey;
+  final List<String>? relays;
+  final String? rmbEncKey;
+  final int twinID;
+  final String updatedAt;
+
+  Account({
+    required this.createdAt,
+    this.farms,
+    required this.publicKey,
+    this.relays,
+    this.rmbEncKey,
+    required this.twinID,
+    required this.updatedAt,
+  });
+
+  factory Account.fromJson(Map<String, dynamic> json) {
+    return Account(
+      createdAt: json['created_at'],
+      farms: json['farms'] != null
+          ? (json['farms'] as List).map((farm) => Farm.fromJson(farm)).toList()
+          : null,
+      publicKey: json['public_key'],
+      relays: json['relays'] != null ? List<String>.from(json['relays']) : null,
+      rmbEncKey: json['rmb_enc_key'],
+      twinID: json['twin_id'],
+      updatedAt: json['updated_at'],
+    );
+  }
+}
+
+class AccountCreationRequest {
+  final String publicKey;
+  final String signature;
+  final int timestamp;
+  final List<String>? relays;
+  final String? rmbEncKey;
+
+  AccountCreationRequest({
+    required this.publicKey,
+    required this.signature,
+    required this.timestamp,
+    this.relays,
+    this.rmbEncKey,
+  });
+
+  Map<String, dynamic> toJson() {
+    return {
+      'public_key': publicKey,
+      'signature': signature,
+      'timestamp': timestamp,
+      'relays': relays,
+      'rmb_enc_key': rmbEncKey,
+    };
+  }
+}
+
+class AccountUpdateRequest {
+  final List<String> relays;
+  final String rmbEncKey;
+
+  AccountUpdateRequest({
+    required this.relays,
+    required this.rmbEncKey,
+  });
+
+  Map<String, dynamic> toJson() {
+    return {
+      'relays': relays,
+      'rmb_enc_key': rmbEncKey,
+    };
+  }
+}

packages/registrar_client/lib/models/farm.dart

@@ -0,0 +1,89 @@
+import 'node.dart';
+
+class Farm {
+  final String? createdAt;
+  final bool dedicated;
+  final int? farmID;
+  final String farmName;
+  final List<Node>? nodes;
+  final int twinID;
+  final String? updatedAt;
+
+  Farm({
+    this.createdAt,
+    required this.dedicated,
+    this.farmID,
+    required farmName,
+    this.nodes,
+    required twinID,
+    this.updatedAt,
+  })  : farmName = _validateFarmName(farmName),
+        twinID = _validateTwinId(twinID);
+
+  factory Farm.fromJson(Map<String, dynamic> json) {
+    return Farm(
+      createdAt: json['created_at'],
+      dedicated: json['dedicated'],
+      farmID: json['farm_id'],
+      farmName: json['farm_name'],
+      nodes: json['nodes'] != null
+          ? (json['nodes'] as List).map((node) => Node.fromJson(node)).toList()
+          : null,
+      twinID: json['twin_id'],
+      updatedAt: json['updated_at'],
+    );
+  }
+
+  Map<String, dynamic> toJson() {
+    return {
+      'created_at': createdAt,
+      'dedicated': dedicated,
+      'farm_id': farmID,
+      'farm_name': farmName,
+      'nodes': nodes ?? [],
+      'twin_id': twinID,
+      'updated_at': updatedAt,
+    };
+  }
+
+  static String _validateFarmName(String farmName) {
+    if (farmName.isEmpty || farmName.length > 40) {
+      throw ArgumentError(
+          'Farm name cannot be empty and must be less than or equal to 40 characters');
+    }
+    return farmName;
+  }
+
+  static int _validateTwinId(int twinId) {
+    if (twinId <= 0) {
+      throw ArgumentError('Twin ID cannot be negative');
+    }
+    return twinId;
+  }
+}
+
+class FarmFilter {
+  final String? farmName;
+  final int? twinID;
+  final int? farmID;
+  final int? page;
+  final int? size;
+
+  FarmFilter({
+    this.farmName,
+    this.twinID,
+    this.farmID,
+    this.page,
+    this.size,
+  });
+
+  Map<String, dynamic> toJson() {
+    return {
+      'farm_name': farmName,
+      'twin_id': twinID,
+      'farm_id': farmID,
+      'page': page,
+      'size': size,
+    };
+  }
+}