solrengine-tokens 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 930e4472835da1e01f1a9eafbb31d5c46d1921259b398b99ae15f33df17de693
-  data.tar.gz: a398418d46fb4a10c6660594c97f0e77885cb56c0a3ae9a6830ce119d7fc34dc
+  metadata.gz: d2767d22284ff63196054807b027476d82ca371eb63d5090850e068379e54b72
+  data.tar.gz: c1428d90b5a6e24258b344d56a8057d5a02f886747dabe17c835dbf0f42fe2f1
 SHA512:
-  metadata.gz: 55f0eb6392f6b58407ebf1c7dcf3dda97f7d04b04ac62fcbd2c798cb2e8c9281b95b46bf5b9e921016199f11972d20e38bc346fc1fd11a4d408b7b55727acce6
-  data.tar.gz: 230707c3b92e98b0e9c055d3442573f68c9de2daed4067e118d25096d11af24981bb4e2005e47be8474c10ef3c41ab8616f1b3d0b20aa53c635477bcccca3065
+  metadata.gz: 73dcb287ca0d899db885be96cb5f60c361182049f17ca1636b747661f71e517162bf83257ad069ef4b14b61a3e0af2a5c2958237d9fe9a1bb7c35206b4a5e1cd
+  data.tar.gz: 7009ac920ba69fe8d22591e5fc5e1fc11a47600f6e0b3474d0b7e9560d8db05c710f2b91343e8de999af8e806310714572306ddc2c1afb4b764ea0d17eca5f3e

data/README.md

@@ -12,7 +12,7 @@ gem "solrengine-tokens"
 
 ```bash
 rails generate solrengine:tokens:install
-rails db:migrate
+rails db:prepare
 ```
 
 ## Configuration
@@ -39,6 +39,16 @@ portfolio.total_usd_value     # => 1847.63
 portfolio.recent_transactions # => [{ signature:, block_time:, ... }]
 ```
 
+NFTs owned by the wallet, via the Metaplex DAS API:
+
+```ruby
+portfolio.nfts  # => [{ id:, name: "Mad Lad #1234", image: "https://...", collection: "...", compressed: false }, ...]
+```
+
+> **Note:** `Portfolio#nfts` uses the DAS `getAssetsByOwner` method, which requires a
+> DAS-capable RPC endpoint (Helius, Triton, ...). The public `api.*.solana.com`
+> endpoints do not serve DAS — on those, the call degrades to an empty list.
+
 Token metadata is fetched once from Jupiter and persisted:
 
 ```ruby

data/lib/solrengine/tokens/nft_service.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Solrengine
+  module Tokens
+    # Fetches Metaplex NFTs owned by a wallet via the DAS API
+    # (getAssetsByOwner). Requires a DAS-capable RPC endpoint (Helius,
+    # Triton, etc.) — the public Solana endpoints do not serve DAS.
+    class NftService
+      NFT_INTERFACES = [ "V1_NFT", "V2_NFT", "ProgrammableNFT", "LEGACY_NFT", "MplCoreAsset" ].freeze
+
+      def initialize
+        @client = Solrengine::Rpc.client
+      end
+
+      def nfts_for(wallet_address, page: 1, limit: 50)
+        response = @client.request("getAssetsByOwner", {
+          ownerAddress: wallet_address,
+          page: page,
+          limit: limit
+        })
+
+        items = response.dig("result", "items") || []
+        items.filter_map { |asset| build_entry(asset) }
+      end
+
+      private
+
+      def build_entry(asset)
+        return nil unless NFT_INTERFACES.include?(asset["interface"])
+
+        metadata = asset.dig("content", "metadata") || {}
+
+        {
+          id: asset["id"],
+          name: metadata["name"].presence || "Unknown",
+          symbol: metadata["symbol"],
+          description: metadata["description"],
+          image: image_for(asset),
+          collection: collection_for(asset),
+          compressed: asset.dig("compression", "compressed") || false,
+          interface: asset["interface"]
+        }
+      end
+
+      def image_for(asset)
+        asset.dig("content", "links", "image") ||
+          (asset.dig("content", "files") || []).find { |f| f["mime"].to_s.start_with?("image/") }&.dig("uri")
+      end
+
+      def collection_for(asset)
+        grouping = (asset["grouping"] || []).find { |g| g["group_key"] == "collection" }
+        grouping && grouping["group_value"]
+      end
+    end
+  end
+end

data/lib/solrengine/tokens/portfolio.rb

@@ -18,6 +18,12 @@ module Solrengine
         tokens.sum { |t| t[:usd_value] || 0 }
       end
 
+      def nfts(page: 1, limit: 50)
+        Solrengine::Tokens.cache_fetch("solrengine_tokens/wallet/#{@wallet_address}/nfts", expires_in: 60) do
+          NftService.new.nfts_for(@wallet_address, page: page, limit: limit)
+        end
+      end
+
       def recent_transactions(limit: 5)
         Solrengine::Tokens.cache_fetch("solrengine_tokens/wallet/#{@wallet_address}/recent_txs", expires_in: 30) do
           Solrengine::Rpc.client.get_recent_signatures(@wallet_address, limit: limit)

data/lib/solrengine/tokens/version.rb

@@ -2,6 +2,6 @@
 
 module Solrengine
   module Tokens
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/solrengine/tokens.rb

@@ -2,6 +2,7 @@ require "solrengine/rpc"
 require_relative "tokens/version"
 require_relative "tokens/jupiter_client"
 require_relative "tokens/token_metadata_service"
+require_relative "tokens/nft_service"
 require_relative "tokens/portfolio"
 require_relative "tokens/engine" if defined?(Rails::Engine)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solrengine-tokens
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jose Ferrer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-21 00:00:00.000000000 Z
+date: 2026-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -53,6 +53,7 @@ files:
 - lib/solrengine/tokens.rb
 - lib/solrengine/tokens/engine.rb
 - lib/solrengine/tokens/jupiter_client.rb
+- lib/solrengine/tokens/nft_service.rb
 - lib/solrengine/tokens/portfolio.rb
 - lib/solrengine/tokens/token_metadata_service.rb
 - lib/solrengine/tokens/version.rb