| Server IP : 66.29.137.217 / Your IP : 3.148.235.247 Web Server : LiteSpeed System : Linux premium294.web-hosting.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : gltevjme ( 1095) PHP Version : 7.0.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/./gltevjme/cbt.bofirm.com/vendor/bavix/laravel-wallet/src/Traits/ |
Upload File : |
<?php
namespace Bavix\Wallet\Traits;
use function app;
use Bavix\Wallet\Exceptions\AmountInvalid;
use Bavix\Wallet\Exceptions\BalanceIsEmpty;
use Bavix\Wallet\Exceptions\InsufficientFunds;
use Bavix\Wallet\Interfaces\Mathable;
use Bavix\Wallet\Interfaces\Storable;
use Bavix\Wallet\Interfaces\Wallet;
use Bavix\Wallet\Models\Transaction;
use Bavix\Wallet\Models\Transfer;
use Bavix\Wallet\Models\Wallet as WalletModel;
use Bavix\Wallet\Services\CommonService;
use Bavix\Wallet\Services\DbService;
use Bavix\Wallet\Services\WalletService;
use function config;
use Illuminate\Database\Eloquent\Relations\MorphMany;
use Illuminate\Support\Collection;
use Throwable;
/**
* Trait HasWallet.
*
*
* @property-read Collection|WalletModel[] $wallets
* @property-read int $balance
*/
trait HasWallet
{
use MorphOneWallet;
/**
* The input means in the system.
*
* @param int|string $amount
* @param array|null $meta
* @param bool $confirmed
*
* @return Transaction
*
* @throws AmountInvalid
* @throws Throwable
*/
public function deposit($amount, ?array $meta = null, bool $confirmed = true): Transaction
{
/** @var Wallet $self */
$self = $this;
return app(DbService::class)->transaction(static function () use ($self, $amount, $meta, $confirmed) {
return app(CommonService::class)
->deposit($self, $amount, $meta, $confirmed);
});
}
/**
* Magic laravel framework method, makes it
* possible to call property balance.
*
* Example:
* $user1 = User::first()->load('wallet');
* $user2 = User::first()->load('wallet');
*
* Without static:
* var_dump($user1->balance, $user2->balance); // 100 100
* $user1->deposit(100);
* $user2->deposit(100);
* var_dump($user1->balance, $user2->balance); // 200 200
*
* With static:
* var_dump($user1->balance, $user2->balance); // 100 100
* $user1->deposit(100);
* var_dump($user1->balance); // 200
* $user2->deposit(100);
* var_dump($user2->balance); // 300
*
* @return int|float|string
*
* @throws Throwable
*/
public function getBalanceAttribute()
{
/** @var Wallet $this */
return app(Storable::class)->getBalance($this);
}
/**
* all user actions on wallets will be in this method.
*
* @return MorphMany
*/
public function transactions(): MorphMany
{
return ($this instanceof WalletModel ? $this->holder : $this)
->morphMany(config('wallet.transaction.model', Transaction::class), 'payable');
}
/**
* This method ignores errors that occur when transferring funds.
*
* @param Wallet $wallet
* @param int|string $amount
* @param array|null $meta
*
* @return Transfer|null
*/
public function safeTransfer(Wallet $wallet, $amount, ?array $meta = null): ?Transfer
{
try {
return $this->transfer($wallet, $amount, $meta);
} catch (Throwable $throwable) {
return null;
}
}
/**
* A method that transfers funds from host to host.
*
* @param Wallet $wallet
* @param int|string $amount
* @param array|null $meta
*
* @return Transfer
*
* @throws AmountInvalid
* @throws BalanceIsEmpty
* @throws InsufficientFunds
* @throws Throwable
*/
public function transfer(Wallet $wallet, $amount, ?array $meta = null): Transfer
{
/** @var $this Wallet */
app(CommonService::class)->verifyWithdraw($this, $amount);
return $this->forceTransfer($wallet, $amount, $meta);
}
/**
* Withdrawals from the system.
*
* @param int|string $amount
* @param array|null $meta
* @param bool $confirmed
*
* @return Transaction
*
* @throws AmountInvalid
* @throws BalanceIsEmpty
* @throws InsufficientFunds
* @throws Throwable
*/
public function withdraw($amount, ?array $meta = null, bool $confirmed = true): Transaction
{
/** @var Wallet $this */
app(CommonService::class)->verifyWithdraw($this, $amount);
return $this->forceWithdraw($amount, $meta, $confirmed);
}
/**
* Checks if you can withdraw funds.
*
* @param int|string $amount
* @param bool $allowZero
*
* @return bool
*/
public function canWithdraw($amount, bool $allowZero = null): bool
{
$math = app(Mathable::class);
/**
* Allow to buy for free with a negative balance.
*/
if ($allowZero && ! $math->compare($amount, 0)) {
return true;
}
return $math->compare($this->balance, $amount) >= 0;
}
/**
* Forced to withdraw funds from system.
*
* @param int|string $amount
* @param array|null $meta
* @param bool $confirmed
*
* @return Transaction
*
* @throws AmountInvalid
* @throws Throwable
*/
public function forceWithdraw($amount, ?array $meta = null, bool $confirmed = true): Transaction
{
/** @var Wallet $self */
$self = $this;
return app(DbService::class)->transaction(static function () use ($self, $amount, $meta, $confirmed) {
return app(CommonService::class)
->forceWithdraw($self, $amount, $meta, $confirmed);
});
}
/**
* the forced transfer is needed when the user does not have the money and we drive it.
* Sometimes you do. Depends on business logic.
*
* @param Wallet $wallet
* @param int|string $amount
* @param array|null $meta
*
* @return Transfer
*
* @throws AmountInvalid
* @throws Throwable
*/
public function forceTransfer(Wallet $wallet, $amount, ?array $meta = null): Transfer
{
/** @var Wallet $self */
$self = $this;
return app(DbService::class)->transaction(static function () use ($self, $amount, $wallet, $meta) {
return app(CommonService::class)
->forceTransfer($self, $wallet, $amount, $meta);
});
}
/**
* the transfer table is used to confirm the payment
* this method receives all transfers.
*
* @return MorphMany
*/
public function transfers(): MorphMany
{
/** @var Wallet $this */
return app(WalletService::class)
->getWallet($this, false)
->morphMany(config('wallet.transfer.model', Transfer::class), 'from');
}
}