Add received transfers function for v10

Author: gkmk

src/Models/Wallet.php

@@ -13,13 +13,15 @@
 use Bavix\Wallet\Internal\Service\MathServiceInterface;
 use Bavix\Wallet\Internal\Service\UuidFactoryServiceInterface;
 use Bavix\Wallet\Services\AtomicServiceInterface;
+use Bavix\Wallet\Services\CastServiceInterface;
 use Bavix\Wallet\Services\RegulatorServiceInterface;
 use Bavix\Wallet\Traits\CanConfirm;
 use Bavix\Wallet\Traits\CanExchange;
 use Bavix\Wallet\Traits\CanPayFloat;
 use Bavix\Wallet\Traits\HasGift;
 use DateTimeInterface;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\MorphTo;
 use Illuminate\Database\RecordsNotFoundException;
 use Illuminate\Support\Str;
@@ -162,4 +164,17 @@ protected function initializeMorphOneWallet(): void
     {
         $this->uuid = app(UuidFactoryServiceInterface::class)->uuid4();
     }
+
+    /**
+     * returns all the receiving transfers to this wallet.
+     *
+     * @return HasMany<Transfer>
+     */
+    public function receivedTransfers(): HasMany
+    {
+        return app(CastServiceInterface::class)
+            ->getWallet($this, false)
+            ->hasMany(config('wallet.transfer.model', Transfer::class), 'to_id')
+        ;
+    }
 }

tests/Units/Service/AtomicServiceTest.php

@@ -35,6 +35,8 @@ public function testBlock(): void
         );
 
         self::assertSame(1, $user2->transfers()->count());
+        self::assertSame(2, $user2->wallet->receivedTransfers()->count());
+        self::assertSame(1, $user1->wallet->receivedTransfers()->count());
         self::assertSame(2, $user1->transfers()->count());
         self::assertSame(3, $user2->transactions()->count());
         self::assertSame(4, $user1->transactions()->count());