tests: begin work on tests

Author: owenvoke

src/Api/Account.php

@@ -6,6 +6,13 @@
 
 class Account extends AbstractApi
 {
+    public function generate(): array
+    {
+        return $this->get(self::API_PATH, [
+            'q' => 'generateAccount',
+        ]);
+    }
+
     public function address(string $publicKey): array
     {
         return $this->get(self::API_PATH, [
@@ -30,13 +37,6 @@ public function publicKey(string $address): array
         ]);
     }
 
-    public function generate(): array
-    {
-        return $this->get(self::API_PATH, [
-            'q' => 'generateAccount',
-        ]);
-    }
-
     public function balance(string $address): array
     {
         return $this->get(self::API_PATH, [

src/Client.php

@@ -21,11 +21,17 @@
  * @method Api\Account accounts()
  * @method Api\Account address()
  * @method Api\Account addresses()
+ * @method Api\Asset asset()
+ * @method Api\Asset assets()
+ * @method Api\Block block()
+ * @method Api\Block blocks()
  * @method Api\Node node()
  * @method Api\Node nodes()
  * @method Api\Other other()
  * @method Api\Other misc()
  * @method Api\Other miscellaneous()
+ * @method Api\Transaction transaction()
+ * @method Api\Transaction transactions()
  */
 final class Client
 {
@@ -57,6 +63,7 @@ public function api(string $name): AbstractApi
         return match ($name) {
             'account', 'accounts', 'address', 'addresses' => new Api\Account($this),
             'asset', 'assets' => new Api\Asset($this),
+            'block', 'blocks' => new Api\Block($this),
             'node', 'nodes' => new Api\Node($this),
             'other', 'misc', 'miscellaneous' => new Api\Other($this),
             'transaction', 'transactions' => new Api\Transaction($this),

src/Enums/Node.php

@@ -19,7 +19,7 @@ enum Node: string
 
     public static function providedOrRandom(string|null $uri = null): string
     {
-        if (str_starts_with($uri, 'http')) {
+        if (str_starts_with($uri ?? '', 'http')) {
             return $uri;
         }
 

tests/.gitkeep

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Account;
+
+beforeEach(fn () => $this->apiClass = Account::class);
+
+it('can generate an account', function () {
+    $response = [
+        'data' => [
+            'address' => '2tR6BWvwpwrQLUWN8GpVP4b6srCxgR2PnrsXs7jYfdeBj3FimJ5Tjd4xzWcWe8y59ZtEBXgQJxe6Uibux1cCDfxL',
+            'public_key' => 'PZ8Tyr4Nx8MHsRAGMpZmZ6TWY63dXWSCyPP8v9FpH75La76KNgkUpZ2KiMHxHQsUKFytyEMXFPkh3yC25p5JoiR1dEsTgJJkNSrrkTM96BcMae5h6NeSdrH1',
+            'private_key' => 'Lzhp9LopCF2mJMHtXj13vuZorf5qMDmYYpjBMLcUshSyyycjFt7YqSjFrzK4AUFpRWw3XPBYcA2maavRp1kbDe7iHwcLaTVwQ6sH2n5vRqZSoAzvcx4JHACDSF4K6TzA3WdspLXZYKbq612psVmtqBuYwvUkDhd2j',
+        ],
+    ];
+
+    $api = $this->getApiMock();
+
+    $api->expects($this->once())
+        ->method('get')
+        ->with('/api.php', [
+            'q' => 'generateAccount',
+        ])
+        ->willReturn($response);
+
+    /** @var Account $api */
+    expect($api->generate())->toBe($response);
+});
+
+it('can get an address by public key');
+
+it('can get the balance for an address');
+
+it('can get the balance for an alias');
+
+it('can get the balance for a public key');
+
+it('can get the pending balance for a public key');
+
+it('can get the alias for an address');
+
+it('can get check that an address is valid');

tests/Api/AccountTest.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Asset;
+
+beforeEach(fn () => $this->apiClass = Asset::class);
+
+it('can get all assets');
+
+it('can get a specific asset');
+
+it('can get the asset balance for an account');
+
+it('can get the asset orders for an address');

tests/Api/AssetTest.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Asset;
+
+beforeEach(fn () => $this->apiClass = Asset::class);
+
+it('can get the current block');
+
+it('can get a specific block by its height');
+
+it('can get the transactions for a block');

tests/Api/BlockTest.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Asset;
+
+beforeEach(fn () => $this->apiClass = Asset::class);
+
+it('can get the version of the current node');
+
+it('can get information about the current node');
+
+it('can get the sanity details for the current node');
+
+it('can get a list of masternodes');

tests/Api/NodeTest.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Asset;
+
+beforeEach(fn () => $this->apiClass = Asset::class);
+
+it('can get a random number');
+
+it('can get the Base58 encoded version of a string');
+
+it('can check a signature is valid');

tests/Api/OtherTest.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+use OwenVoke\Arionum\Api\Asset;
+use OwenVoke\Arionum\Enums\TransactionVersion;
+
+beforeEach(fn () => $this->apiClass = Asset::class);
+
+it('can get the transactions for an address');
+
+it('can get the transactions for a public key');
+
+it('can get a specific transaction');
+
+it('can create a transaction')->with(TransactionVersion::cases());
+
+it('can get the number of transactions in the mempool');