Sync from opensea-devtools

Author: CodySearsOS

README.md

@@ -41,14 +41,15 @@ npx @opensea/cli collections get mfers
 Set your API key via environment variable or flag:
 
 ```bash
-export OPENSEA_API_KEY=your-api-key
+# Get an instant free-tier API key (no signup needed)
+export OPENSEA_API_KEY=$(curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key')
 opensea collections get mfers
 
 # or pass inline
 opensea --api-key your-api-key collections get mfers
 ```
 
-Get an API key at [docs.opensea.io](https://docs.opensea.io/reference/api-keys).
+Get an API key instantly via the command above, or get a full key at [opensea.io/settings/developer](https://opensea.io/settings/developer) for higher rate limits. See [API key docs](https://docs.opensea.io/reference/api-keys) for details.
 
 ## Quick Start
 
@@ -174,7 +175,7 @@ console.log(formatToon(data))
 ## Requirements
 
 - Node.js >= 18.0.0
-- OpenSea API key ([get one here](https://docs.opensea.io/reference/api-keys))
+- OpenSea API key — get one instantly: `curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key'` or from [opensea.io/settings/developer](https://opensea.io/settings/developer)
 
 ## Development
 

src/wallet/index.ts

@@ -28,28 +28,27 @@ export const WALLET_PROVIDERS: WalletProvider[] = [
  * Create a WalletAdapter from the current environment.
  *
  * When no provider is specified, auto-detects based on which
- * environment variables are set. Priority: Turnkey > Fireblocks > PrivateKey > Privy.
- * If no provider-specific vars are found, defaults to Privy.
+ * environment variables are set. Priority: Privy > Fireblocks > Turnkey > PrivateKey.
  */
 export function createWalletFromEnv(provider?: WalletProvider): WalletAdapter {
   if (provider) {
     return createAdapter(provider)
   }
 
   // Auto-detect based on available env vars
+  const hasPrivy = !!process.env.PRIVY_APP_ID && !!process.env.PRIVY_APP_SECRET
+  const hasFireblocks =
+    !!process.env.FIREBLOCKS_API_KEY && !!process.env.FIREBLOCKS_VAULT_ID
   const hasTurnkey =
     !!process.env.TURNKEY_API_PUBLIC_KEY &&
     !!process.env.TURNKEY_ORGANIZATION_ID
-  const hasFireblocks =
-    !!process.env.FIREBLOCKS_API_KEY && !!process.env.FIREBLOCKS_VAULT_ID
   const hasPrivateKey = !!process.env.PRIVATE_KEY && !!process.env.RPC_URL
-  const hasPrivy = !!process.env.PRIVY_APP_ID && !!process.env.PRIVY_APP_SECRET
 
   const detected = [
-    hasTurnkey && "turnkey",
+    hasPrivy && "privy",
     hasFireblocks && "fireblocks",
+    hasTurnkey && "turnkey",
     hasPrivateKey && "private-key",
-    hasPrivy && "privy",
   ].filter(Boolean) as WalletProvider[]
 
   if (detected.length > 1) {
@@ -59,11 +58,12 @@ export function createWalletFromEnv(provider?: WalletProvider): WalletAdapter {
     )
   }
 
-  if (hasTurnkey) return TurnkeyAdapter.fromEnv()
+  if (hasPrivy) return PrivyAdapter.fromEnv()
   if (hasFireblocks) return FireblocksAdapter.fromEnv()
+  if (hasTurnkey) return TurnkeyAdapter.fromEnv()
   if (hasPrivateKey) return PrivateKeyAdapter.fromEnv()
 
-  // Default to Privy
+  // No provider env vars found — fall back to Privy (will fail with a clear error if not configured)
   return PrivyAdapter.fromEnv()
 }