@clawdvault/sdk 0.3.1 → 0.4.0

package/README.md

@@ -127,6 +127,59 @@ client.setSigner(newSigner);
 const address = client.getWalletAddress(); // returns string | null
 ```
 
+## USD Price Fields
+
+The SDK provides native USD pricing on tokens, trades, and stats:
+
+### Token Fields
+
+```typescript
+const { token } = await client.getToken('MINT_ADDRESS');
+
+// USD Fields
+console.log(token.price_usd);        // Current price in USD
+console.log(token.market_cap_usd);   // Market cap in USD
+
+// SOL Fields (still available)
+console.log(token.price_sol);        // Price in SOL
+console.log(token.market_cap_sol);   // Market cap in SOL
+```
+
+### Trade Fields
+
+```typescript
+const { trades } = await client.getTrades({ mint: 'MINT_ADDRESS' });
+
+for (const trade of trades) {
+  console.log(trade.price_usd);      // Price in USD at time of trade
+  console.log(trade.sol_price_usd);  // SOL/USD price at time of trade
+  console.log(trade.price_sol);      // Price in SOL at time of trade
+}
+```
+
+### Candles with Currency
+
+```typescript
+// Get candles in USD
+const { candles } = await client.getCandles({
+  mint: 'MINT_ADDRESS',
+  interval: '5m',
+  currency: 'usd'  // 'usd' or 'sol'
+});
+
+// candles[0].open, high, low, close are in USD when currency='usd'
+```
+
+### Stats Fields
+
+```typescript
+const stats = await client.getStats('MINT_ADDRESS');
+
+console.log(stats.onChain?.priceUsd);      // Price in USD
+console.log(stats.onChain?.marketCapUsd);  // Market cap in USD
+console.log(stats.onChain?.solPriceUsd);   // SOL/USD rate
+```
+
 ## Browser Usage with Phantom Wallet
 
 ```typescript
@@ -205,21 +258,27 @@ const jupSell = await client.sellJupiter('MINT', 1000000, 50);
 ### Price & Market Data
 
 ```typescript
-// Trade history
+// Trade history (includes USD prices)
 const { trades } = await client.getTrades({
   mint: 'MINT_ADDRESS',
   limit: 50
 });
+// trades[0].price_usd       - Price in USD at trade time
+// trades[0].sol_price_usd   - SOL price at trade time
 
-// OHLCV candles
+// OHLCV candles (SOL or USD)
 const { candles } = await client.getCandles({
   mint: 'MINT_ADDRESS',
-  interval: '1m',  // '1m' | '5m' | '15m' | '1h' | '4h' | '1d'
-  limit: 100
+  interval: '1m',   // '1m' | '5m' | '15m' | '1h' | '4h' | '1d'
+  limit: 100,
+  currency: 'usd'   // 'usd' or 'sol' (default: 'sol')
 });
 
-// On-chain stats
+// On-chain stats (includes USD market cap)
 const stats = await client.getStats('MINT_ADDRESS');
+// stats.onChain.priceUsd      - Price in USD
+// stats.onChain.marketCapUsd  - Market cap in USD
+// stats.onChain.solPriceUsd   - SOL/USD price
 
 // Top holders
 const { holders } = await client.getHolders('MINT_ADDRESS');

package/dist/index.d.mts

@@ -538,6 +538,8 @@ interface paths {
          * Get OHLCV candles
          * @description Returns candlestick data for charting. This is the recommended source
          *     of truth for price display. Use the last candle's `close` for current price.
+         *
+         *     Set `currency=usd` to get USD-denominated candles.
          */
         get: {
             parameters: {
@@ -545,6 +547,8 @@ interface paths {
                     mint: string;
                     interval?: "1m" | "5m" | "15m" | "1h" | "1d";
                     limit?: number;
+                    /** @description Currency for OHLCV values (sol or usd) */
+                    currency?: "sol" | "usd";
                 };
                 header?: never;
                 path?: never;
@@ -561,6 +565,8 @@ interface paths {
                         "application/json": {
                             mint?: string;
                             interval?: string;
+                            /** @enum {string} */
+                            currency?: "sol" | "usd";
                             candles?: {
                                 /** @description Unix timestamp (seconds) */
                                 time?: number;
@@ -593,7 +599,7 @@ interface paths {
         };
         /**
          * Get on-chain stats
-         * @description Returns bonding curve state directly from Solana.
+         * @description Returns bonding curve state directly from Solana with USD values.
          */
         get: {
             parameters: {
@@ -606,7 +612,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description On-chain stats */
+                /** @description On-chain stats with USD values */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -622,8 +628,16 @@ interface paths {
                                 bondingCurveSol?: number;
                                 virtualSolReserves?: number;
                                 virtualTokenReserves?: number;
+                                /** @description Price in SOL */
                                 price?: number;
+                                /** @description Price in USD */
+                                priceUsd?: number;
+                                /** @description Market cap in SOL */
                                 marketCap?: number;
+                                /** @description Market cap in USD */
+                                marketCapUsd?: number;
+                                /** @description SOL price at time of request */
+                                solPriceUsd?: number;
                                 graduated?: boolean;
                             };
                         };
@@ -1368,7 +1382,11 @@ interface components {
             creator?: string;
             creator_name?: string;
             price_sol?: number;
+            /** @description Price in USD */
+            price_usd?: number;
             market_cap_sol?: number;
+            /** @description Market cap in USD */
+            market_cap_usd?: number;
             volume_24h?: number;
             virtual_sol_reserves?: number;
             virtual_token_reserves?: number;
@@ -1388,7 +1406,12 @@ interface components {
             type?: "buy" | "sell";
             sol_amount?: number;
             token_amount?: number;
-            price?: number;
+            /** @description Price in SOL */
+            price_sol?: number;
+            /** @description Price in USD (calculated from sol_price_usd) */
+            price_usd?: number;
+            /** @description SOL price at time of trade */
+            sol_price_usd?: number;
             trader?: string;
             signature?: string;
             /** Format: date-time */

package/dist/index.d.ts

@@ -538,6 +538,8 @@ interface paths {
          * Get OHLCV candles
          * @description Returns candlestick data for charting. This is the recommended source
          *     of truth for price display. Use the last candle's `close` for current price.
+         *
+         *     Set `currency=usd` to get USD-denominated candles.
          */
         get: {
             parameters: {
@@ -545,6 +547,8 @@ interface paths {
                     mint: string;
                     interval?: "1m" | "5m" | "15m" | "1h" | "1d";
                     limit?: number;
+                    /** @description Currency for OHLCV values (sol or usd) */
+                    currency?: "sol" | "usd";
                 };
                 header?: never;
                 path?: never;
@@ -561,6 +565,8 @@ interface paths {
                         "application/json": {
                             mint?: string;
                             interval?: string;
+                            /** @enum {string} */
+                            currency?: "sol" | "usd";
                             candles?: {
                                 /** @description Unix timestamp (seconds) */
                                 time?: number;
@@ -593,7 +599,7 @@ interface paths {
         };
         /**
          * Get on-chain stats
-         * @description Returns bonding curve state directly from Solana.
+         * @description Returns bonding curve state directly from Solana with USD values.
          */
         get: {
             parameters: {
@@ -606,7 +612,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description On-chain stats */
+                /** @description On-chain stats with USD values */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -622,8 +628,16 @@ interface paths {
                                 bondingCurveSol?: number;
                                 virtualSolReserves?: number;
                                 virtualTokenReserves?: number;
+                                /** @description Price in SOL */
                                 price?: number;
+                                /** @description Price in USD */
+                                priceUsd?: number;
+                                /** @description Market cap in SOL */
                                 marketCap?: number;
+                                /** @description Market cap in USD */
+                                marketCapUsd?: number;
+                                /** @description SOL price at time of request */
+                                solPriceUsd?: number;
                                 graduated?: boolean;
                             };
                         };
@@ -1368,7 +1382,11 @@ interface components {
             creator?: string;
             creator_name?: string;
             price_sol?: number;
+            /** @description Price in USD */
+            price_usd?: number;
             market_cap_sol?: number;
+            /** @description Market cap in USD */
+            market_cap_usd?: number;
             volume_24h?: number;
             virtual_sol_reserves?: number;
             virtual_token_reserves?: number;
@@ -1388,7 +1406,12 @@ interface components {
             type?: "buy" | "sell";
             sol_amount?: number;
             token_amount?: number;
-            price?: number;
+            /** @description Price in SOL */
+            price_sol?: number;
+            /** @description Price in USD (calculated from sol_price_usd) */
+            price_usd?: number;
+            /** @description SOL price at time of trade */
+            sol_price_usd?: number;
             trader?: string;
             signature?: string;
             /** Format: date-time */

package/dist/index.js

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -46,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/wallet.ts
 var import_web3 = require("@solana/web3.js");
-var import_bs58 = __toESM(require("bs58"));
+var bs58 = require("bs58").default || require("bs58");
 var KeypairSigner = class _KeypairSigner {
   constructor(keypairOrSecretKey) {
     if (keypairOrSecretKey instanceof import_web3.Keypair) {
@@ -56,7 +46,7 @@ var KeypairSigner = class _KeypairSigner {
         const secretKey = new Uint8Array(JSON.parse(keypairOrSecretKey));
         this._keypair = import_web3.Keypair.fromSecretKey(secretKey);
       } else {
-        const secretKey = import_bs58.default.decode(keypairOrSecretKey);
+        const secretKey = bs58.decode(keypairOrSecretKey);
         this._keypair = import_web3.Keypair.fromSecretKey(secretKey);
       }
     } else {
@@ -162,14 +152,14 @@ async function createAuthSignature(signer, payload, action) {
   const messageBytes = new TextEncoder().encode(message);
   const signatureBytes = await signer.signMessage(messageBytes);
   return {
-    signature: import_bs58.default.encode(signatureBytes),
+    signature: bs58.encode(signatureBytes),
     wallet: signer.publicKey.toBase58()
   };
 }
 function verifySignature(message, signature, publicKey) {
   try {
     const messageBytes = new TextEncoder().encode(message);
-    const signatureBytes = import_bs58.default.decode(signature);
+    const signatureBytes = bs58.decode(signature);
     const pubkey = new import_web3.PublicKey(publicKey);
     const nacl = require("tweetnacl");
     return nacl.sign.detached.verify(messageBytes, signatureBytes, pubkey.toBytes());

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   Transaction,
   VersionedTransaction
 } from "@solana/web3.js";
-import bs58 from "bs58";
+var bs58 = __require("bs58").default || __require("bs58");
 var KeypairSigner = class _KeypairSigner {
   constructor(keypairOrSecretKey) {
     if (keypairOrSecretKey instanceof Keypair) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdvault/sdk",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "TypeScript SDK for ClawdVault - Solana token launchpad",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@solana/spl-token": "^0.4.0",
     "@solana/web3.js": "^1.91.0",
-    "bs58": "^5.0.0",
+    "bs58": "^6.0.0",
     "eventsource": "^2.0.2",
     "tweetnacl": "^1.0.3"
   },