orbis1-sdk-rn 0.0.4 → 0.0.5

package/lib/typescript/src/types/SDKConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SDKConfig.d.ts","sourceRoot":"","sources":["../../../../src/types/SDKConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,sBAAsB;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,mCAAmC;IACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,iBAAiB;IACjB,IAAI,SAAS;IACb,0BAA0B;IAC1B,KAAK,UAAU;IACf,0BAA0B;IAC1B,IAAI,SAAS;IACb,mDAAmD;IACnD,IAAI,SAAS;IACb,mCAAmC;IACnC,KAAK,UAAU;IACf,qCAAqC;IACrC,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAQxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QACT,qCAAqC;QACrC,OAAO,CAAC,EAAE,cAAc,GAAG;YACzB,sCAAsC;YACtC,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QAEF,wCAAwC;QACxC,UAAU,CAAC,EAAE,cAAc,GAAG;YAC5B,uCAAuC;YACvC,eAAe,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;QAEF,sBAAsB;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;KAC3C,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,gBAAgB;QAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;QACjB,6BAA6B;QAC7B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KACzE,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,8CAA8C;QAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,SAAS,CAQjD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAezD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAgB9D"}
+{"version":3,"file":"SDKConfig.d.ts","sourceRoot":"","sources":["../../../../src/types/SDKConfig.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orbis1-sdk-rn",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Orbis1 SDK for React Native with RGB core, Watch Tower, and Gas-Free transfers.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/Orbis1SDK.ts

@@ -9,7 +9,11 @@
 import { Wallet } from './core/Wallet';
 import type { IFeatureModule } from './types/IFeatureModule';
 import type { SDKConfig } from './types/SDKConfig';
-import { validateSDKConfig, mergeWithDefaults } from './types/SDKConfig';
+import {
+  validateSDKConfig,
+  mergeWithDefaults,
+  Environment,
+} from './types/SDKConfig';
 import { Feature } from './types/Feature';
 import { ConfigurationError } from './errors/ConfigurationError';
 import { OrbisError, OrbisErrorCode } from './errors/OrbisError';
@@ -17,6 +21,7 @@ import { FeatureRegistry } from './utils/FeatureRegistry';
 import { Logger, createLogger } from './utils/logger';
 import { WatchTowerModule } from './features/watch-tower';
 import { GasFreeModule } from './features/gas-free';
+import { BitcoinNetwork } from './core/Interfaces';
 
 /**
  * Orbis1SDK class
@@ -55,13 +60,21 @@ export class Orbis1SDK {
 
     // Initialize wallet from config (if enabled)
     if (this.config.wallet?.enabled) {
+      // Determine network from environment
+      const network =
+        this.config.environment === Environment.MAINNET
+          ? BitcoinNetwork.MAINNET
+          : BitcoinNetwork.TESTNET4;
+
       this.wallet = new Wallet(this.config.wallet.keys, {
-        network: this.config.wallet.network,
+        network,
         supportedSchemas: this.config.wallet.supportedSchemas,
         maxAllocationsPerUtxo: this.config.wallet.maxAllocationsPerUtxo,
         vanillaKeychain: this.config.wallet.vanillaKeychain,
       });
-      this.logger.info('Wallet initialized from configuration');
+      this.logger.info(
+        `Wallet initialized for ${this.config.environment} environment`
+      );
     }
 
     // Initialize feature registry
@@ -121,8 +134,9 @@ export class Orbis1SDK {
       }
 
       const gasFreeModule = new GasFreeModule({
-        name: 'gasFree',
+        name: Feature.GAS_FREE,
         enabled: true,
+        environment: this.config.environment,
         apiKey: this.config.apiKey,
         timeout: features.gasFree.timeout,
       });
@@ -133,8 +147,9 @@ export class Orbis1SDK {
     // Initialize Watch Tower feature
     if (features?.watchTower?.enabled) {
       const watchTowerModule = new WatchTowerModule({
-        name: 'watchTower',
+        name: Feature.WATCH_TOWER,
         enabled: true,
+        environment: this.config.environment,
         apiKey: this.config.apiKey,
       });
       this.featureRegistry.register(Feature.WATCH_TOWER, watchTowerModule);

package/src/features/gas-free/GasFreeModule.ts

@@ -16,7 +16,7 @@ import type { IServiceClient } from './client/IServiceClient';
 import { ConsignmentReader } from './consignment/ConsignmentReader';
 import type { IConsignmentReader } from './consignment/IConsignmentReader';
 import type { GasFreeConfig } from './types/GasFreeConfig';
-import { getServiceUrl } from './types/GasFreeConfig';
+import { getGasFreeServiceUrl } from './types/GasFreeConfig';
 
 import type {
   GasFreeTransferRequest,
@@ -86,7 +86,7 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
     // Store logger (create child logger with module prefix)
     this.logger = logger?.child('GasFree');
 
-    const serviceUrl = getServiceUrl();
+    const serviceUrl = getGasFreeServiceUrl(this.config.environment);
 
     this.logger?.debug('Initializing with config', {
       baseUrl: serviceUrl,

package/src/features/gas-free/types/GasFreeConfig.ts

@@ -8,13 +8,15 @@
 
 import { z } from 'zod';
 import type { IFeatureConfig } from '../../../types/IFeatureModule';
+import { Feature } from '../../../types/Feature';
+import { Environment } from '../../../types/SDKConfig';
 
 /**
  * Gas-Free feature configuration
  */
 export interface GasFreeConfig extends IFeatureConfig {
   /** Feature name (must be 'gasFree') */
-  name: 'gasFree';
+  name: Feature.GAS_FREE;
 
   /** Whether the feature is enabled */
   enabled: boolean;
@@ -48,7 +50,7 @@ export interface GasFreeConfig extends IFeatureConfig {
  * Zod schema for Gas-Free configuration validation
  */
 export const GasFreeConfigSchema = z.object({
-  name: z.literal('gasFree', {
+  name: z.literal(Feature.GAS_FREE, {
     errorMap: () => ({ message: 'Gas-Free config must have name "gasFree"' }),
   }),
   enabled: z.boolean(),
@@ -78,11 +80,6 @@ export const GasFreeConfigSchema = z.object({
   headers: z.record(z.string()).optional(),
 });
 
-/**
- * Default Gas-Free configuration (internal use)
- */
-const DEFAULT_SERVICE_URL = 'http://localhost:3000';
-
 /**
  * Default Gas-Free configuration
  */
@@ -96,10 +93,15 @@ export const DEFAULT_GAS_FREE_CONFIG: Partial<GasFreeConfig> = {
 };
 
 /**
- * Get the hardcoded service URL
+ * Get the hardcoded service URL as a function of environment
+ *
+ * @param environment - SDK environment (mainnet or testnet)
+ * @returns Service URL for the specified environment
  */
-export function getServiceUrl(): string {
-  return DEFAULT_SERVICE_URL;
+export function getGasFreeServiceUrl(environment: Environment): string {
+  return environment === Environment.MAINNET
+    ? 'https://gasfree.orbis1.io'
+    : 'https://gasfree-dev.orbis1.io';
 }
 
 /**

package/src/features/watch-tower/WatchTowerModule.ts

@@ -13,7 +13,7 @@ import type { IFeatureModule } from '../../types/IFeatureModule';
 import type { Wallet } from '../../core/Wallet';
 import type { Logger } from '../../utils/logger';
 import type { WatchTowerConfig } from './types';
-import { WATCHTOWER_URL } from './types';
+import { getWatchTowerServiceUrl } from './types/WatchTowerConfig';
 
 export class WatchTowerModule implements IFeatureModule<WatchTowerConfig> {
   readonly name = 'watchTower' as const;
@@ -39,7 +39,7 @@ export class WatchTowerModule implements IFeatureModule<WatchTowerConfig> {
     }
 
     this.client = axios.create({
-      baseURL: WATCHTOWER_URL,
+      baseURL: getWatchTowerServiceUrl(this.config.environment),
       headers: {
         'Content-Type': 'application/json',
         'Authorization': `Bearer ${this.config.apiKey}`,

package/src/features/watch-tower/index.ts

@@ -6,4 +6,3 @@
 
 export { WatchTowerModule } from './WatchTowerModule';
 export type { WatchTowerConfig } from './types';
-export { WATCHTOWER_URL } from './types';

package/src/features/watch-tower/types/WatchTowerConfig.ts

@@ -4,12 +4,24 @@
  * @module features/watch-tower/types/WatchTowerConfig
  */
 
+import type { Feature } from '../../../types/Feature';
 import type { IFeatureConfig } from '../../../types/IFeatureModule';
+import { Environment } from '../../../types/SDKConfig';
 
-export const WATCHTOWER_URL = 'https://watchtower.orbis1.io';
+/**
+ * Get the hardcoded service URL as a function of environment
+ *
+ * @param environment - SDK environment (mainnet or testnet)
+ * @returns Service URL for the specified environment
+ */
+export function getWatchTowerServiceUrl(environment: Environment): string {
+  return environment === Environment.MAINNET
+    ? 'https://watchtower.orbis1.io'
+    : 'https://watchtower-dev.orbis1.io';
+}
 
 export interface WatchTowerConfig extends IFeatureConfig {
-  name: 'watchTower';
+  name: Feature.WATCH_TOWER;
   enabled: boolean;
   apiKey: string;
 }

package/src/features/watch-tower/types/index.ts

@@ -1,2 +1 @@
 export type { WatchTowerConfig } from './WatchTowerConfig';
-export { WATCHTOWER_URL } from './WatchTowerConfig';

package/src/index.tsx

@@ -15,7 +15,7 @@ export { Orbis1SDK } from './Orbis1SDK';
 
 // Types
 export type { SDKConfig } from './types/SDKConfig';
-export { LogLevel } from './types/SDKConfig';
+export { LogLevel, Environment } from './types/SDKConfig';
 export { Feature, isValidFeature } from './types/Feature';
 export type { IFeatureModule, IFeatureConfig } from './types/IFeatureModule';
 

package/src/types/IFeatureModule.ts

@@ -9,6 +9,7 @@
 
 import type { Wallet } from '../core/Wallet';
 import type { Logger } from '../utils/logger';
+import { Environment } from './SDKConfig';
 
 /**
  * Base configuration type that all feature configs must extend
@@ -18,6 +19,8 @@ export interface IFeatureConfig {
   name: string;
   /** Whether the feature is enabled */
   enabled: boolean;
+  /** SDK environment (testnet or mainnet) */
+  environment: Environment;
 }
 
 /**

package/src/types/SDKConfig.ts

@@ -7,8 +7,7 @@
  */
 
 import { z } from 'zod';
-import type { IFeatureConfig } from './IFeatureModule';
-import type { Keys, BitcoinNetwork, AssetSchema } from '../core/Interfaces';
+import type { Keys, AssetSchema } from '../core/Interfaces';
 
 /**
  * Wallet configuration for the SDK
@@ -18,8 +17,6 @@ export interface WalletConfig {
   enabled: boolean;
   /** Wallet keys (mnemonic, xpubs, etc.) */
   keys: Keys;
-  /** Bitcoin network */
-  network?: BitcoinNetwork;
   /** Supported asset schemas */
   supportedSchemas?: AssetSchema[];
   /** Maximum allocations per UTXO */
@@ -46,11 +43,21 @@ export enum LogLevel {
   VERBOSE = 'verbose',
 }
 
+/**
+ * SDK Environment
+ * Determines which network and service endpoints to use
+ */
+export enum Environment {
+  /** Testnet4 environment */
+  TESTNET = 'testnet',
+  /** Mainnet environment (production) */
+  MAINNET = 'mainnet',
+}
+
 /**
  * Zod schema for Gas-Free feature configuration
  */
 export const GasFreeFeatureConfigSchema = z.object({
-  name: z.literal('gasFree').optional(),
   enabled: z.boolean().optional(),
   timeout: z.number().int().positive('Timeout must be positive').optional(),
 });
@@ -59,7 +66,6 @@ export const GasFreeFeatureConfigSchema = z.object({
  * Zod schema for Watch Tower feature configuration
  */
 export const WatchTowerFeatureConfigSchema = z.object({
-  name: z.literal('watchTower').optional(),
   enabled: z.boolean().optional(),
   pollingInterval: z
     .number()
@@ -88,6 +94,7 @@ export const SDKOptionsSchema = z.object({
  */
 export const SDKConfigSchema = z.object({
   apiKey: z.string().min(1, 'API key is required'),
+  environment: z.nativeEnum(Environment).default(Environment.MAINNET),
   features: z
     .object({
       gasFree: GasFreeFeatureConfigSchema.optional(),
@@ -109,9 +116,17 @@ export interface SDKConfig {
    */
   apiKey: string;
 
+  /**
+   * SDK environment (testnet or mainnet).
+   * Determines which network and service endpoints to use.
+   * Defaults to mainnet if not specified.
+   */
+  environment: Environment;
+
   /**
    * Wallet configuration.
    * Required for RGB operations and wallet-dependent features (Gas-Free).
+   * Network (testnet4 or mainnet) is determined by the environment setting.
    */
   wallet?: WalletConfig;
 
@@ -123,19 +138,23 @@ export interface SDKConfig {
    */
   features?: {
     /** Gas-Free feature configuration */
-    gasFree?: IFeatureConfig & {
+    gasFree?: {
+      /** Enable the feature */
+      enabled?: boolean;
       /** Request timeout in milliseconds */
       timeout?: number;
     };
 
     /** Watch-Tower feature configuration */
-    watchTower?: IFeatureConfig & {
+    watchTower?: {
+      /** Enable the feature */
+      enabled?: boolean;
       /** Polling interval in milliseconds */
       pollingInterval?: number;
     };
 
     /** Custom features */
-    [key: string]: IFeatureConfig | undefined;
+    [key: string]: { enabled?: boolean; [key: string]: unknown } | undefined;
   };
 
   /**
@@ -161,6 +180,7 @@ export interface SDKConfig {
  * Default SDK configuration
  */
 export const DEFAULT_SDK_CONFIG: Partial<SDKConfig> = {
+  environment: Environment.MAINNET,
   features: {},
   logging: {
     level: LogLevel.INFO,
@@ -191,6 +211,30 @@ export function validateSDKConfig(config: SDKConfig): void {
     }
     throw error;
   }
+
+  // Validate API key prefix matches environment
+  const apiKey = config.apiKey;
+  const environment = config.environment ?? Environment.MAINNET;
+
+  if (environment === Environment.TESTNET) {
+    if (!apiKey.startsWith('pk_test')) {
+      throw new Error(
+        `API key mismatch: testnet environment requires a testnet API key (prefix: pk_test), but got a key with prefix: ${apiKey.substring(
+          0,
+          7
+        )}`
+      );
+    }
+  } else if (environment === Environment.MAINNET) {
+    if (!apiKey.startsWith('sk_live')) {
+      throw new Error(
+        `API key mismatch: mainnet environment requires a production API key (prefix: sk_live), but got a key with prefix: ${apiKey.substring(
+          0,
+          7
+        )}`
+      );
+    }
+  }
 }
 
 /**
@@ -202,6 +246,7 @@ export function validateSDKConfig(config: SDKConfig): void {
 export function mergeWithDefaults(config: SDKConfig): SDKConfig {
   return {
     ...config,
+    environment: config.environment ?? Environment.MAINNET,
     features: {
       ...DEFAULT_SDK_CONFIG.features,
       ...config.features,