⚠️ CRITICAL: Wallet ownership checks MUST use LIVE RPC endpoints (not cached APIs).
Claim page uses: api.wax.alohaeos.com as primary.
🔴 LIVE RPC Endpoints (Wallet Ownership)
Direct blockchain queries with ZERO delay. Used for wallet ownership verification.
Priority Order:
PRIMARY
https://api.wax.alohaeos.com
Real-time wallet ownership checks
Used by: /api/user/eligibility, /api/user/claim, /api/user/check-ownership, /api/user/assets-rpc
FALLBACK
https://wax.greymass.com
Backup RPC #1
Automatic failover if primary is down
FALLBACK
https://api.waxsweden.org
Backup RPC #2
Automatic failover
FALLBACK
https://wax.eosphere.io
Backup RPC #3
Automatic failover
FALLBACK
https://wax.eu.eosamsterdam.net
Backup RPC #4
Automatic failover
FALLBACK
https://wax.cryptolions.io
Backup RPC #5
Automatic failover
⚡ Cached AtomicAssets APIs (Asset Metadata)
Indexed APIs with 30-120 second cache. Used ONLY for asset metadata, images, and attributes. Never for wallet ownership!
PRIMARY
https://aa.wax.blacklusion.io
Asset metadata, images, template data (FAST - 86ms avg)
Used for: Template lookups, NFT images/videos, mint numbers
FALLBACK
https://atomic.wax.eosrio.io
Backup AtomicAssets API (594ms avg)
Automatic failover for metadata
FALLBACK
https://wax.api.atomicassets.io
Official AtomicAssets API (slower but reliable)
Automatic failover for metadata
FALLBACK
https://aa.dapplica.io
Backup AtomicAssets API
Automatic failover for metadata
📜 Smart Contract Queries
Direct blockchain contract table queries via RPC endpoints.
LIVE
atomicassets → assets table
Real-time wallet ownership (scope=account)
Used by: /api/user/eligibility, /api/user/claim
LIVE
blenderizerx → blends table
Blend configurations and ingredients
Used by: BLEND_ARRAY actions in story
LIVE
atomicpacksx → packs table
Pack configurations
Used by: /api/pack/roll-count
LIVE
atomicpacksx → unboxassets table
Unboxed pack rolls
Used by: /api/pack/unboxed-rolls, /api/user/claimable-packs
LIVE
atomicpacksx → unboxpacks table
User's unboxed packs
Used by: /api/user/claimable-packs
🌍 Other External Services
IPFS
https://ipfs.io/ipfs/
NFT images and videos
Fetches media files from IPFS hashes
LINK
https://wax.atomichub.io/market
AtomicHub marketplace links
External marketplace URL generation
LINK
https://neftyblocks.com/collection/
NeftyBlocks marketplace links
External marketplace URL generation
LINK
https://waxblock.io/transaction/
Transaction explorer links
Blockchain transaction viewing
🚨 Critical Rules
Rule #1: Wallet Checks = LIVE RPC ONLY
NEVER use cached AtomicAssets API for wallet ownership checks!
✅ Correct: getUserAssetsLive() → alohaeos RPC
❌ Wrong: checkEligibility() → cached API
Why: Users who just acquired NFTs will see "You don't own this" errors with cached APIs.
Rule #2: RPC Priority Order
For wallet checks, always try in this order:
- api.wax.alohaeos.com (primary - user requested)
- wax.greymass.com (fallback #1)
- api.waxsweden.org (fallback #2)
- wax.eosphere.io (fallback #3)
- wax.eu.eosamsterdam.net (fallback #4)
- wax.cryptolions.io (fallback #5)
Rule #3: Eligibility & Claim Must Match
Both /api/user/eligibility and /api/user/claim MUST use getUserAssetsLive()
Why: Mixing LIVE and CACHED causes "Ready to claim!" → "You don't own this" errors.
📚 For complete documentation, see SYSTEM_STATE_REPORT.md and CRITICAL_FIXES_2025-12-28.md