refactor: rename getNftCollection* methods to getCollection* (#604)

app/Console/Commands/LiveDumpNfts.php

@@ -293,7 +293,7 @@ private function getCollectionTraitsAndPersist(Chain $chain, string $address): v
 
         $fs = Storage::disk(self::diskName);
 
-        $traits = Mnemonic::getNftCollectionTraits($chain, $address);
+        $traits = Mnemonic::getCollectionTraits($chain, $address);
 
         $path = $this->prepareCollectionPath($chain, $address);
 

app/Console/Commands/LiveDumpWallets.php

@@ -84,7 +84,7 @@ public function handle(): int
 
                     $collectionFloorPrices = $collectionAddresses
                         ->mapWithKeys(fn (string $collectionAddress
-                        ) => [$collectionAddress => Mnemonic::getNftCollectionFloorPrice($chain, $collectionAddress)]);
+                        ) => [$collectionAddress => Mnemonic::getCollectionFloorPrice($chain, $collectionAddress)]);
 
                     // modify `network` and `retrievedAt` to make output stable between reruns as these change independent
                     // of the API response.
@@ -114,7 +114,7 @@ public function handle(): int
         // Download traits for each collection
         $allTraits = $nftCollections->mapWithKeys(function ($collectionAddresses, $chainId) {
             $traits = $collectionAddresses->unique()
-                ->mapWithKeys(fn ($collectionAddress) => [$collectionAddress => Mnemonic::getNftCollectionTraits(Chain::from($chainId), $collectionAddress)]);
+                ->mapWithKeys(fn ($collectionAddress) => [$collectionAddress => Mnemonic::getCollectionTraits(Chain::from($chainId), $collectionAddress)]);
 
             return [$chainId => $traits];
         });

app/Contracts/Web3DataProvider.php

@@ -38,5 +38,5 @@ public function getBlockTimestamp(Network $network, int $blockNumber): Carbon;
      */
     public function getMiddleware(): array;
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice;
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice;
 }

app/Http/Client/Alchemy/AlchemyPendingRequest.php

@@ -484,7 +484,7 @@ private function tokenMetadata(string $tokenAddress): ?array
     }
 
     // https://docs.alchemy.com/reference/getfloorprice
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         // Only ETH is supported at the moment since this API is still considered in beta:
 

app/Http/Client/Mnemonic/MnemonicPendingRequest.php

@@ -99,7 +99,7 @@ public function send(string $method, string $path, array $options = []): Respons
     }
 
     // https://docs.mnemonichq.com/reference/marketplacesservice_getfloorprice
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         $this->chain = MnemonicChain::fromChain($chain);
 
@@ -180,7 +180,7 @@ public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress
     }
 
     // https://docs.mnemonichq.com/reference/collectionsservice_getmetadata
-    public function getNftCollectionBanner(Chain $chain, string $contractAddress): ?string
+    public function getCollectionBanner(Chain $chain, string $contractAddress): ?string
     {
         $this->chain = MnemonicChain::fromChain($chain);
 
@@ -215,7 +215,7 @@ public function getNftCollectionBanner(Chain $chain, string $contractAddress): ?
     }
 
     // https://docs.mnemonichq.com/reference/collectionsservice_getownerscount
-    public function getNftCollectionOwners(Chain $chain, string $contractAddress): ?int
+    public function getCollectionOwners(Chain $chain, string $contractAddress): ?int
     {
         $this->chain = MnemonicChain::fromChain($chain);
 
@@ -232,7 +232,7 @@ public function getNftCollectionOwners(Chain $chain, string $contractAddress): ?
     }
 
     // https://docs.mnemonichq.com/reference/collectionsservice_getsalesvolume
-    public function getNftCollectionVolume(Chain $chain, string $contractAddress): ?string
+    public function getCollectionVolume(Chain $chain, string $contractAddress): ?string
     {
         $this->chain = MnemonicChain::fromChain($chain);
 
@@ -258,7 +258,7 @@ public function getNftCollectionVolume(Chain $chain, string $contractAddress): ?
     /**
      * @return Collection<int, Web3NftCollectionTrait>
      */
-    public function getNftCollectionTraits(Chain $chain, string $contractAddress): Collection
+    public function getCollectionTraits(Chain $chain, string $contractAddress): Collection
     {
         //  {
         //      "name": "string",

app/Http/Client/Moralis/MoralisPendingRequest.php

@@ -242,7 +242,7 @@ public function getNativeBalances(array $walletAddresses, Network $network): Col
      * @see https://docs.moralis.io/web3-data-api/evm/reference/get-nft-lowest-price
      * Get the lowest executed price for an NFT contract for the last x days (only trades paid in ETH).
      */
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         try {
             $data = self::get(sprintf('nft/%s/lowestprice', $contractAddress), [

app/Http/Client/Opensea/OpenseaPendingRequest.php

@@ -96,7 +96,7 @@ public function nft(Chain $chain, string $address, string $identifier): ?Opensea
     /**
      * @see https://docs.opensea.io/v1.0/reference/retrieving-collection-stats
      */
-    public function getNftCollectionFloorPrice(string $collectionSlug): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(string $collectionSlug): ?Web3NftCollectionFloorPrice
     {
         try {
             $response = $this->makeCollectionStatsRequest($collectionSlug);

app/Jobs/FetchCollectionBanner.php

@@ -40,7 +40,7 @@ public function handle(): void
             'collection' => $this->collection->address,
         ]);
 
-        $banner = Mnemonic::getNftCollectionBanner(
+        $banner = Mnemonic::getCollectionBanner(
             chain: $this->collection->network->chain(),
             contractAddress: $this->collection->address
         );

app/Jobs/FetchCollectionFloorPrice.php

@@ -53,7 +53,7 @@ public function handle(): void
         $collection->save();
 
         $web3DataProvider = $this->getWeb3DataProvider();
-        $floorPrice = $web3DataProvider->getNftCollectionFloorPrice(
+        $floorPrice = $web3DataProvider->getCollectionFloorPrice(
             Chain::from($this->chainId), $this->address
         );
 

app/Jobs/FetchCollectionOwners.php

@@ -39,7 +39,7 @@ public function handle(): void
             'collection' => $this->collection->address,
         ]);
 
-        $owners = Mnemonic::getNftCollectionOwners(
+        $owners = Mnemonic::getCollectionOwners(
             chain: $this->collection->network->chain(),
             contractAddress: $this->collection->address
         );

app/Jobs/FetchCollectionTraits.php

@@ -41,7 +41,7 @@ public function handle(): void
             'collection' => $this->collection->address,
         ]);
 
-        $traits = Mnemonic::getNftCollectionTraits(
+        $traits = Mnemonic::getCollectionTraits(
             chain: $this->collection->network->chain(),
             contractAddress: $this->collection->address
         );

app/Jobs/FetchCollectionVolume.php

@@ -39,7 +39,7 @@ public function handle(): void
             'collection' => $this->collection->address,
         ]);
 
-        $volume = Mnemonic::getNftCollectionVolume(
+        $volume = Mnemonic::getCollectionVolume(
             chain: $this->collection->network->chain(),
             contractAddress: $this->collection->address
         );

app/Services/Web3/Alchemy/AlchemyWeb3DataProvider.php

@@ -82,10 +82,10 @@ public function getMiddleware(): array
         return [];
     }
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         return $this->fromCache(
-            static fn () => Alchemy::getNftCollectionFloorPrice($chain, $contractAddress),
+            static fn () => Alchemy::getCollectionFloorPrice($chain, $contractAddress),
             [$chain->name, $contractAddress]
         );
     }

app/Services/Web3/Fake/FakeWeb3DataProvider.php

@@ -82,7 +82,7 @@ public function getWalletNfts(Wallet $wallet, Network $network, ?string $cursor
                 name: $nft->name,
                 description: null,
                 extraAttributes: $nft['extra_attributes']->toArray(),
-                floorPrice: $this->getNftCollectionFloorPrice(Chain::ETH, $wallet->address),
+                floorPrice: $this->getCollectionFloorPrice(Chain::ETH, $wallet->address),
                 traits: [],
                 mintedBlock: random_int(1, 10000),
                 mintedAt: now(),
@@ -114,7 +114,7 @@ public function getBlockTimestamp(Network $network, int $blockNumber): Carbon
         return now();
     }
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         return new Web3NftCollectionFloorPrice((string) (random_int(50, 1000) * 1e18), 'eth', Carbon::now());
     }

app/Services/Web3/Mnemonic/MnemonicWeb3DataProvider.php

@@ -49,10 +49,10 @@ public function getCollectionsNfts(CollectionModel $collection, ?string $startTo
         throw new NotImplementedException();
     }
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         return $this->fromCache(
-            static fn () => Mnemonic::getNftCollectionFloorPrice($chain, $contractAddress),
+            static fn () => Mnemonic::getCollectionFloorPrice($chain, $contractAddress),
             [$chain->name, $contractAddress]
         );
     }

app/Services/Web3/Moralis/MoralisWeb3DataProvider.php

@@ -76,10 +76,10 @@ public function getMiddleware(): array
         return [new RateLimited(Service::Moralis)];
     }
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         return $this->fromCache(
-            static fn () => Moralis::getNftCollectionFloorPrice($chain, $contractAddress),
+            static fn () => Moralis::getCollectionFloorPrice($chain, $contractAddress),
             [$chain->name, $contractAddress]
         );
     }

app/Services/Web3/Opensea/OpenseaWeb3DataProvider.php

@@ -50,7 +50,7 @@ public function getCollectionsNfts(CollectionModel $collection, ?string $startTo
         throw new NotImplementedException();
     }
 
-    public function getNftCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
+    public function getCollectionFloorPrice(Chain $chain, string $contractAddress): ?Web3NftCollectionFloorPrice
     {
         return $this->fromCache(
             function () use ($contractAddress, $chain) {
@@ -64,7 +64,7 @@ function () use ($contractAddress, $chain) {
                     return null;
                 }
 
-                return Opensea::getNftCollectionFloorPrice($openseaSlug);
+                return Opensea::getCollectionFloorPrice($openseaSlug);
             },
             [$chain->name, $contractAddress]
         );

app/Support/Facades/Alchemy.php

@@ -29,7 +29,7 @@
  * @method static Web3NftData parseNft(array $nft, int $networkId)
  * @method static string getNativeBalance(Wallet $wallet, Network $network)
  * @method static Carbon getBlockTimestamp(Network $network, int $blockNumber)
- * @method static Web3NftCollectionFloorPrice | null getNftCollectionFloorPrice(Chain $chain, string $contractAddress)
+ * @method static Web3NftCollectionFloorPrice | null getCollectionFloorPrice(Chain $chain, string $contractAddress)
  *
  * @see App\Http\Client\Alchemy\AlchemyPendingRequest
  */

app/Support/Facades/Mnemonic.php

@@ -17,11 +17,11 @@
 
 /**
  * @method static string getNativeBalance(Wallet $wallet, Network $network)
- * @method static Web3NftCollectionFloorPrice | null getNftCollectionFloorPrice(Chain $chain, string $contractAddress)
- * @method static string | null getNftCollectionBanner(Chain $chain, string $contractAddress)
- * @method static int | null getNftCollectionOwners(Chain $chain, string $contractAddress)
- * @method static string | null getNftCollectionVolume(Chain $chain, string $contractAddress)
- * @method static Collection<int, Web3NftCollectionTrait> getNftCollectionTraits(Chain $chain, string $contractAddress)
+ * @method static Web3NftCollectionFloorPrice | null getCollectionFloorPrice(Chain $chain, string $contractAddress)
+ * @method static string | null getCollectionBanner(Chain $chain, string $contractAddress)
+ * @method static int | null getCollectionOwners(Chain $chain, string $contractAddress)
+ * @method static string | null getCollectionVolume(Chain $chain, string $contractAddress)
+ * @method static Collection<int, Web3NftCollectionTrait> getCollectionTraits(Chain $chain, string $contractAddress)
  * @method static Collection<int, CollectionActivity> getCollectionActivity(Chain $chain, string $contractAddress, int $limit, ?Carbon $from = null)
  * @method static Collection<int, CollectionActivity> getBurnActivity(Chain $chain, string $contractAddress, int $limit, ?Carbon $from = null)
  *

app/Support/Facades/Moralis.php

@@ -23,7 +23,7 @@
  * @method static string getNativeBalance(Wallet $wallet, Network $network)
  * @method static Collection<int, WalletBalance> getNativeBalances(array $walletAddresses, Network $network)
  * @method static Carbon getBlockTimestamp(Network $network, int $blockNumber)
- * @method static Web3NftCollectionFloorPrice | null getNftCollectionFloorPrice(Chain $chain, string $contractAddress)
+ * @method static Web3NftCollectionFloorPrice | null getCollectionFloorPrice(Chain $chain, string $contractAddress)
  *
  * @see App\Http\Client\Moralis\MoralisPendingRequest
  */

app/Support/Facades/Opensea.php

@@ -13,7 +13,7 @@
 
 /**
  * @method static string getCollectionTotalVolume(Collection $collection)
- * @method static Web3NftCollectionFloorPrice | null getNftCollectionFloorPrice(string $collectionSlug)
+ * @method static Web3NftCollectionFloorPrice | null getCollectionFloorPrice(string $collectionSlug)
  * @method static OpenseaNftDetails | null nft(Chain $chain, string $address, string $identifier)
  *
  * @see App\Http\Client\Opensea\OpenseaPendingRequest

config/dashbrd.php

@@ -81,19 +81,19 @@
     'cache_ttl' => [
         'alchemy' => [
             'getBlockTimestamp' => 60 * 60 * 24 * 10, // 10 days... Creation date for blocks will never change, so we can safely cache in a distant future...
-            'getNftCollectionFloorPrice' => 60, // 1 minute
+            'getCollectionFloorPrice' => 60, // 1 minute
         ],
         'moralis' => [
             'getEnsDomain' => 60, // 1 minute
             'getBlockTimestamp' => 60 * 60 * 24 * 10, // 10 days... Creation date for blocks will never change, so we can safely cache in a distant future...
-            'getNftCollectionFloorPrice' => 60, // 1 minute
+            'getCollectionFloorPrice' => 60, // 1 minute
         ],
         'mnemonic' => [
             'getBlockTimestamp' => 60 * 60 * 24 * 10, // 10 days... Creation date for blocks will never change, so we can safely cache in a distant future...
-            'getNftCollectionFloorPrice' => 60, // 1 minute
+            'getCollectionFloorPrice' => 60, // 1 minute
         ],
         'opensea' => [
-            'getNftCollectionFloorPrice' => 60, // 1 minute
+            'getCollectionFloorPrice' => 60, // 1 minute
         ],
         'coingecko' => [
             'getPriceHistory' => [

tests/App/Http/Client/Mnemonic/MnemonicPendingRequestTest.php

@@ -36,7 +36,7 @@
         'network_id' => $network->id,
     ]);
 
-    Mnemonic::getNftCollectionFloorPrice(Chain::Polygon, $collection->address);
+    Mnemonic::getCollectionFloorPrice(Chain::Polygon, $collection->address);
 })->throws(ConnectionException::class);
 
 it('should throw on 401', function () {
@@ -50,7 +50,7 @@
         'network_id' => $network->id,
     ]);
 
-    Mnemonic::getNftCollectionFloorPrice(Chain::Polygon, $collection->address);
+    Mnemonic::getCollectionFloorPrice(Chain::Polygon, $collection->address);
 })->throws(Exception::class);
 
 it('should throw a custom exception on rate limits', function () {
@@ -66,7 +66,7 @@
         'network_id' => $network->id,
     ]);
 
-    Mnemonic::getNftCollectionFloorPrice(Chain::Polygon, $collection->address);
+    Mnemonic::getCollectionFloorPrice(Chain::Polygon, $collection->address);
 })->throws(RateLimitException::class);
 
 it('should not retry request on 400', function () {
@@ -100,7 +100,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionOwners(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionOwners(Chain::Polygon, $collection->address);
 
     expect($data)->toBe(789);
 });
@@ -121,7 +121,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionVolume(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionVolume(Chain::Polygon, $collection->address);
 
     expect($data)->toBe('12300000000000000000');
 });
@@ -138,7 +138,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionVolume(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionVolume(Chain::Polygon, $collection->address);
 
     expect($data)->toBe(null);
 })->with([
@@ -171,7 +171,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionTraits(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionTraits(Chain::Polygon, $collection->address);
 
     expect($data)->toHaveCount(25);
 });
@@ -198,7 +198,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionTraits(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionTraits(Chain::Polygon, $collection->address);
 
     expect($data)->toHaveCount(500 + 500 + 0 + 0);
 });
@@ -219,7 +219,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionTraits(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionTraits(Chain::Polygon, $collection->address);
 
     expect($data)->toHaveCount(1);
 });
@@ -240,7 +240,7 @@
         'network_id' => $network->id,
     ]);
 
-    $data = Mnemonic::getNftCollectionTraits(Chain::Polygon, $collection->address);
+    $data = Mnemonic::getCollectionTraits(Chain::Polygon, $collection->address);
 
     expect($data)->toHaveCount(1);
 });
@@ -472,5 +472,5 @@
         'network_id' => $network->id,
     ]);
 
-    expect(Mnemonic::getNftCollectionFloorPrice(Chain::ETH, $collection->address))->toBeNull();
+    expect(Mnemonic::getCollectionFloorPrice(Chain::ETH, $collection->address))->toBeNull();
 });