Release v1.0.1

Author: ryanio

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+      - run: npm install
+      - run: npm run format:check
+      - run: npm run lint
+      - run: npm run type-check
+      - run: npm test
+      - run: npm run build

.github/workflows/npm-publish-reusable.yml

@@ -0,0 +1,56 @@
+name: Publish npm package
+
+on:
+  workflow_call:
+    inputs:
+      build-before-publish:
+        description: Run build and test before publishing
+        type: boolean
+        default: true
+      stub-package-dir:
+        description: Path to stub package directory (e.g. packages/opensea-js-stub)
+        type: string
+        default: ""
+      node-version-file:
+        description: Path to node version file
+        type: string
+        default: .nvmrc
+    secrets:
+      OPENSEA_API_KEY:
+        required: false
+      ALCHEMY_API_KEY:
+        required: false
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: ${{ inputs.node-version-file }}
+          registry-url: https://registry.npmjs.org/
+
+      # Use npm install (not npm ci) because the package-lock.json may be
+      # out of sync after the sync-package workflow resolves workspace: protocols
+      # and updates dependencies. npm ci requires exact lockfile match.
+      - run: npm install
+
+      - if: ${{ inputs.build-before-publish }}
+        run: npm run build
+
+      - if: ${{ inputs.build-before-publish }}
+        run: npm test
+        env:
+          OPENSEA_API_KEY: ${{ secrets.OPENSEA_API_KEY }}
+          ALCHEMY_API_KEY: ${{ secrets.ALCHEMY_API_KEY }}
+
+      - run: npm publish --provenance --access public
+
+      - if: ${{ inputs.stub-package-dir != '' }}
+        run: npm publish --provenance --access public
+        working-directory: ${{ inputs.stub-package-dir }}
+        continue-on-error: true

.github/workflows/npm-publish.yml

@@ -5,22 +5,9 @@ on:
     types: [published]
 
 jobs:
-  publish-npm:
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: read
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version-file: .nvmrc
-          registry-url: https://registry.npmjs.org/
-      # Publish @opensea/cli
-      - run: npm install
-      - run: npm publish --provenance --access public
-
-      # Publish opensea-cli stub (skip if version already exists)
-      - run: npm publish --provenance --access public
-        working-directory: packages/opensea-cli-stub
-        continue-on-error: true
+  publish:
+    uses: ./.github/workflows/npm-publish-reusable.yml
+    with:
+      build-before-publish: false
+      stub-package-dir: packages/opensea-cli-stub
+    secrets: inherit

.gitignore

@@ -1,5 +1,11 @@
 # @opensea/cli
 
+## 1.0.1
+
+### Patch Changes
+
+- 6bb30d7: Fix `--version` to report correct version; auto-convert decimal quantities in swap commands
+
 ## 1.0.0
 
 ### Minor Changes

CHANGELOG.md

@@ -0,0 +1,63 @@
+{
+  "$schema": "node_modules/@biomejs/biome/configuration_schema.json",
+  "files": {
+    "includes": [
+      "**/*.ts",
+      "**/*.js",
+      "**/*.json",
+      "!**/node_modules/**",
+      "!**/dist/**",
+      "!**/lib/**",
+      "!**/coverage/**",
+      "!**/.nyc_output/**",
+      "!packages/sdk/src/typechain/**",
+      "!**/typechain/**",
+      "!packages/api-types/src/generated.ts",
+      "!**/pnpm-lock.yaml",
+      "!**/package-lock.json"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "asNeeded"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noConsole": "off",
+        "noExplicitAny": "off"
+      },
+      "correctness": {
+        "noUnusedImports": "warn"
+      },
+      "style": {
+        "noUnusedTemplateLiteral": "off"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.test.ts", "**/*.spec.ts", "**/test/**"],
+      "linter": {
+        "rules": {
+          "correctness": {
+            "noUnusedImports": "off"
+          }
+        }
+      }
+    }
+  ]
+}

biome.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "OpenSea CLI - Query the OpenSea API from the command line or programmatically",
   "main": "dist/index.js",
@@ -14,10 +14,10 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "format": "biome format --config-path ../.. --write .",
-    "format:check": "biome format --config-path ../.. .",
-    "lint": "biome check --config-path ../.. .",
-    "lint:fix": "biome check --config-path ../.. --fix .",
+    "format": "biome format --config-path . --write .",
+    "format:check": "biome format --config-path . .",
+    "lint": "biome check --config-path . .",
+    "lint:fix": "biome check --config-path . --write .",
     "type-check": "tsc --noEmit",
     "test": "vitest run",
     "prepublishOnly": "npm run build"
@@ -32,7 +32,8 @@
     "@vitest/coverage-v8": "^3.2.4",
     "tsup": "^8.3.0",
     "typescript": "^6.0.2",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@biomejs/biome": "^2.4.10"
   },
   "engines": {
     "node": ">=18.0.0"

package.json

@@ -17,6 +17,8 @@ import {
 import { type OutputFormat, setOutputOptions } from "./output.js"
 import { parseIntOption } from "./parse.js"
 
+declare const __VERSION__: string
+
 const EXIT_API_ERROR = 1
 const EXIT_AUTH_ERROR = 2
 const EXIT_RATE_LIMITED = 3
@@ -37,7 +39,7 @@ const program = new Command()
 program
   .name("opensea")
   .description("OpenSea CLI - Query the OpenSea API from the command line")
-  .version(process.env.npm_package_version ?? "0.0.0")
+  .version(__VERSION__)
   .addHelpText("before", BANNER)
   .option("--api-key <key>", "OpenSea API key (or set OPENSEA_API_KEY env var)")
   .option("--chain <chain>", "Default chain", "ethereum")

src/cli.ts

@@ -3,7 +3,7 @@ import type { OpenSeaClient } from "../client.js"
 import type { OutputFormat } from "../output.js"
 import { formatOutput } from "../output.js"
 import { parseFloatOption } from "../parse.js"
-import { SwapsAPI } from "../sdk.js"
+import { resolveQuantity, SwapsAPI } from "../sdk.js"
 import type { SwapQuoteResponse } from "../types/index.js"
 import type { WalletProvider } from "../wallet/index.js"
 import { createWalletFromEnv, WALLET_PROVIDERS } from "../wallet/index.js"
@@ -31,7 +31,10 @@ export function swapsCommand(
       "--to-address <address>",
       "Contract address of the token to swap to",
     )
-    .requiredOption("--quantity <quantity>", "Amount to swap (in token units)")
+    .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>",
@@ -53,14 +56,20 @@ export function swapsCommand(
         recipient?: string
       }) => {
         const client = getClient()
+        const quantity = await resolveQuantity(
+          client,
+          options.fromChain,
+          options.fromAddress,
+          options.quantity,
+        )
         const result = await client.get<SwapQuoteResponse>(
           "/api/v2/swap/quote",
           {
             from_chain: options.fromChain,
             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")
@@ -88,7 +97,10 @@ export function swapsCommand(
       "--to-address <address>",
       "Contract address of the token to swap to",
     )
-    .requiredOption("--quantity <quantity>", "Amount to swap (in token units)")
+    .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)",
@@ -120,7 +132,14 @@ export function swapsCommand(
         const address = await wallet.getAddress()
         console.error(`Using ${wallet.name} wallet: ${address}`)
 
-        const swaps = new SwapsAPI(getClient())
+        const client = getClient()
+        const quantity = await resolveQuantity(
+          client,
+          options.fromChain,
+          options.fromAddress,
+          options.quantity,
+        )
+        const swaps = new SwapsAPI(client)
         const format = getFormat()
         const slippage = options.slippage
           ? parseFloatOption(options.slippage, "--slippage")
@@ -129,6 +148,7 @@ export function swapsCommand(
         if (options.dryRun) {
           const quote = await swaps.quote({
             ...options,
+            quantity,
             address,
             slippage,
           })
@@ -139,6 +159,7 @@ export function swapsCommand(
         const results = await swaps.execute(
           {
             ...options,
+            quantity,
             address,
             slippage,
           },

src/commands/swaps.ts

@@ -33,6 +33,43 @@ import type {
 import type { TransactionResult, WalletAdapter } from "./wallet/index.js"
 import { resolveChainId } from "./wallet/index.js"
 
+function convertToSmallestUnit(amount: string, decimals: number): string {
+  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()
+}
+
+export async function resolveQuantity(
+  client: OpenSeaClient,
+  chain: string,
+  tokenAddress: string,
+  quantity: string,
+): Promise<string> {
+  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<TokenDetails>(
+    `/api/v2/chain/${chain}/token/${tokenAddress}`,
+  )
+  return convertToSmallestUnit(quantity, token.decimals)
+}
+
+/** @internal Exported for testing only */
+export { convertToSmallestUnit as _convertToSmallestUnit }
+
 export class OpenSeaCLI {
   private client: OpenSeaClient