@quantabit/sdk-config

QuantaBit SDK unified config management. All SDKs share this config — modify once, apply everywhere.

Features

• 🔧 Unified Configuration - All SDKs share API URL, timeout, and other settings
• 🌍 Environment Presets - One-click switching between dev, staging, and production
• 🔄 Dynamic Updates - Runtime configuration changes supported
• ⚛️ React Hook - Convenient useSDKConfig Hook
• 🔐 Token Management - Unified authentication token storage and management
• 📝 Logging System - Configurable log levels

Installation

npm install @quantabit/sdk-config
# or
yarn add @quantabit/sdk-config

Quick Start

1. Initialize Configuration at App Startup

// app/layout.tsx or main.jsx
import { initConfig } from "@quantabit/sdk-config";

// Use custom configuration
initConfig({
  apiBaseUrl: "https://api.yoursite.com/api/v1",
  timeout: 15000,
  debug: process.env.NODE_ENV !== "production",
});

// Or use environment preset
import { initWithEnvironment } from "@quantabit/sdk-config";
initWithEnvironment("production");

2. Using Hooks in Components

import { useSDKConfig } from "@quantabit/sdk-config";

function SettingsPanel() {
  const { config, setApiBaseUrl } = useSDKConfig();

  return (
    <div>
      <p>Current API: {config.apiBaseUrl}</p>
      <button onClick={() => setApiBaseUrl("https://new-api.com")}>
        Switch API
      </button>
    </div>
  );
}

3. Using in Other SDKs

// Internal use by other SDKs
import { getConfig, buildApiUrl, getToken } from "@quantabit/sdk-config";

async function fetchData() {
  const config = getConfig();
  const url = buildApiUrl("/users/me");
  const token = getToken();

  const response = await fetch(url, {
    headers: {
      Authorization: `Bearer ${token}`,
    },
    timeout: config.timeout,
  });

  return response.json();
}

API Reference

Configuration Functions

| Function | Description | | ------------------------------------- | --------------------------------------- | | getConfig() | Get current config object | | initConfig(options) | Initialize config (call at app startup) | | setApiBaseUrl(url) | Set API base URL | | setWsBaseUrl(url) | Set WebSocket URL | | setDebug(debug) | Set debug mode | | resetConfig() | Reset to default config | | subscribeConfig(listener) | Subscribe to config changes | | initWithEnvironment(env, overrides) | Initialize with environment preset |

Token Management

| Function | Description | | ----------------------------- | ---------------------- | | getToken() | Get access token | | getRefreshToken() | Get refresh token | | saveTokens(access, refresh) | Save tokens | | clearTokens() | Clear all tokens | | isAuthenticated() | Check if authenticated |

Utility Functions

| Function | Description | | ----------------------------------- | ------------------ | | buildApiUrl(endpoint, useFullUrl) | Build full API URL | | logger.debug/info/warn/error | Log output |

Configuration

| Option | Type | Default | Description | | ------------ | ------- | --------------- | -------------------- | | apiBaseUrl | string | /api/v1 | API base path | | apiFullUrl | string | '' (required) | Full API URL | | timeout | number | 30000 | Request timeout (ms) | | retryCount | number | 3 | Retry count | | debug | boolean | false | Debug mode | | logLevel | string | info | Log level | | wsBaseUrl | string | '' (required) | WebSocket URL |

Environment Presets

import { initWithEnvironment } from "@quantabit/sdk-config";

// Development
initWithEnvironment("development");

// Staging
initWithEnvironment("staging");

// Production
initWithEnvironment("production");

// With override config
initWithEnvironment("production", {
  timeout: 10000,
});

Integration with Other SDKs

All QuantaBit SDKs should read configuration from this package:

// In auth-sdk, wallet-sdk, etc.
import {
  getConfig,
  buildApiUrl,
  getToken,
  logger,
} from "@quantabit/sdk-config";

class ApiClient {
  async request(endpoint, options = {}) {
    const config = getConfig();
    const url = buildApiUrl(endpoint);
    const token = getToken();

    logger.debug("Requesting:", url);

    const response = await fetch(url, {
      ...options,
      headers: {
        "Content-Type": "application/json",
        Authorization: token ? `Bearer ${token}` : undefined,
        ...options.headers,
      },
    });

    return response.json();
  }
}

License

MIT © QuantaBit Team

🌐 Brand & Links

• Official Mainnet: QuantaBit Chain
• Developer Platform: Developer Platform
• Open Platform: Open Platform
• Payment Platform: Pay Platform
• Feedback: Feedback