@opensea/cli 1.0.0 → 1.1.0

package/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
 

package/dist/cli.js

@@ -6,7 +6,7 @@ import { Command as Command13 } from "commander";
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.opensea.io";
 var DEFAULT_TIMEOUT_MS = 3e4;
-var USER_AGENT = `opensea-cli/${"1.0.0"}`;
+var USER_AGENT = `opensea-cli/${"1.1.0"}`;
 var DEFAULT_MAX_RETRIES = 0;
 var DEFAULT_RETRY_BASE_DELAY_MS = 1e3;
 function isRetryableStatus(status, method) {
@@ -1954,23 +1954,24 @@ function createWalletFromEnv(provider) {
   if (provider) {
     return createAdapter(provider);
   }
-  const hasTurnkey = !!process.env.TURNKEY_API_PUBLIC_KEY && !!process.env.TURNKEY_ORGANIZATION_ID;
+  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 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",
-    hasPrivateKey && "private-key",
-    hasPrivy && "privy"
+    hasTurnkey && "turnkey",
+    hasPrivateKey && "private-key"
   ].filter(Boolean);
   if (detected.length > 1) {
     console.warn(
       `WARNING: Multiple wallet providers detected: ${detected.join(", ")}. Using ${detected[0]}. Set --wallet-provider explicitly to avoid ambiguity.`
     );
   }
-  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();
   return PrivyAdapter.fromEnv();
 }
@@ -1992,6 +1993,30 @@ function createAdapter(provider) {
 }
 
 // src/sdk.ts
+function convertToSmallestUnit(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  if (frac.length > decimals) {
+    throw new Error(
+      `Too many decimal places (${frac.length}) for token with ${decimals} decimals`
+    );
+  }
+  const paddedFrac = frac.padEnd(decimals, "0");
+  return (BigInt(whole) * BigInt(10) ** BigInt(decimals) + BigInt(paddedFrac)).toString();
+}
+async function resolveQuantity(client, chain, tokenAddress, quantity) {
+  if (/^\d+$/.test(quantity)) {
+    return quantity;
+  }
+  if (!/^\d+\.\d+$/.test(quantity)) {
+    throw new Error(
+      `Invalid quantity "${quantity}": must be an integer or decimal number`
+    );
+  }
+  const token = await client.get(
+    `/api/v2/chain/${chain}/token/${tokenAddress}`
+  );
+  return convertToSmallestUnit(quantity, token.decimals);
+}
 var SwapsAPI = class {
   constructor(client) {
     this.client = client;
@@ -2067,7 +2092,10 @@ function swapsCommand(getClient2, getFormat2) {
   ).requiredOption("--to-chain <chain>", "Chain of the token to swap to").requiredOption(
     "--to-address <address>",
     "Contract address of the token to swap to"
-  ).requiredOption("--quantity <quantity>", "Amount to swap (in token units)").requiredOption("--address <address>", "Wallet address executing the swap").option(
+  ).requiredOption(
+    "--quantity <quantity>",
+    "Amount to swap (decimals like 0.1 are auto-converted to smallest units)"
+  ).requiredOption("--address <address>", "Wallet address executing the swap").option(
     "--slippage <slippage>",
     "Slippage tolerance (0.0 to 0.5, default: 0.01)"
   ).option(
@@ -2076,6 +2104,12 @@ function swapsCommand(getClient2, getFormat2) {
   ).action(
     async (options) => {
       const client = getClient2();
+      const quantity = await resolveQuantity(
+        client,
+        options.fromChain,
+        options.fromAddress,
+        options.quantity
+      );
       const result = await client.get(
         "/api/v2/swap/quote",
         {
@@ -2083,7 +2117,7 @@ function swapsCommand(getClient2, getFormat2) {
           from_address: options.fromAddress,
           to_chain: options.toChain,
           to_address: options.toAddress,
-          quantity: options.quantity,
+          quantity,
           address: options.address,
           slippage: options.slippage ? parseFloatOption(options.slippage, "--slippage") : void 0,
           recipient: options.recipient
@@ -2100,7 +2134,10 @@ function swapsCommand(getClient2, getFormat2) {
   ).requiredOption("--to-chain <chain>", "Chain of the token to swap to").requiredOption(
     "--to-address <address>",
     "Contract address of the token to swap to"
-  ).requiredOption("--quantity <quantity>", "Amount to swap (in token units)").option(
+  ).requiredOption(
+    "--quantity <quantity>",
+    "Amount to swap (decimals like 0.1 are auto-converted to smallest units)"
+  ).option(
     "--slippage <slippage>",
     "Slippage tolerance (0.0 to 0.5, default: 0.01)"
   ).option(
@@ -2116,12 +2153,20 @@ function swapsCommand(getClient2, getFormat2) {
       );
       const address = await wallet.getAddress();
       console.error(`Using ${wallet.name} wallet: ${address}`);
-      const swaps = new SwapsAPI(getClient2());
+      const client = getClient2();
+      const quantity = await resolveQuantity(
+        client,
+        options.fromChain,
+        options.fromAddress,
+        options.quantity
+      );
+      const swaps = new SwapsAPI(client);
       const format = getFormat2();
       const slippage = options.slippage ? parseFloatOption(options.slippage, "--slippage") : void 0;
       if (options.dryRun) {
         const quote = await swaps.quote({
           ...options,
+          quantity,
           address,
           slippage
         });
@@ -2131,6 +2176,7 @@ function swapsCommand(getClient2, getFormat2) {
       const results = await swaps.execute(
         {
           ...options,
+          quantity,
           address,
           slippage
         },
@@ -2216,7 +2262,7 @@ var BANNER = `
         |_|
 `;
 var program = new Command13();
-program.name("opensea").description("OpenSea CLI - Query the OpenSea API from the command line").version(process.env.npm_package_version ?? "0.0.0").addHelpText("before", BANNER).option("--api-key <key>", "OpenSea API key (or set OPENSEA_API_KEY env var)").option("--chain <chain>", "Default chain", "ethereum").option("--format <format>", "Output format (json, table, or toon)", "json").option("--base-url <url>", "API base URL").option("--timeout <ms>", "Request timeout in milliseconds", "30000").option("--verbose", "Log request and response info to stderr").option(
+program.name("opensea").description("OpenSea CLI - Query the OpenSea API from the command line").version("1.1.0").addHelpText("before", BANNER).option("--api-key <key>", "OpenSea API key (or set OPENSEA_API_KEY env var)").option("--chain <chain>", "Default chain", "ethereum").option("--format <format>", "Output format (json, table, or toon)", "json").option("--base-url <url>", "API base URL").option("--timeout <ms>", "Request timeout in milliseconds", "30000").option("--verbose", "Log request and response info to stderr").option(
   "--fields <fields>",
   "Comma-separated list of fields to include in output"
 ).option("--max-lines <lines>", "Truncate output after N lines").option("--max-retries <n>", "Max retries on 429/5xx (0 to disable)", "3").option("--no-retry", "Disable request retries");