orbis1-sdk-rn 0.0.10 → 0.2.1

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

@@ -15,6 +15,8 @@ export interface WalletConfig {
     enabled: boolean;
     /** Wallet keys (mnemonic, xpubs, etc.) */
     keys: Keys;
+    /** Absolute path to directory where wallet data will be stored. If not provided, defaults to app documents directory. */
+    dataDir?: string;
     /** Supported asset schemas */
     supportedSchemas?: AssetSchema[];
     /** Maximum allocations per UTXO */

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":"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"}
+{"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.10",
+  "version": "0.2.1",
   "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",
@@ -57,14 +57,14 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/orgs/Orbis-1/orbis1-sdk-rn.git"
+    "url": "git+https://github.com/Orbis-1/orbis1-sdk-rn.git"
   },
   "author": "Orbis1 <dev@orbis1.io> (https://github.com/orgs/Orbis-1)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/orgs/Orbis-1/orbis1-sdk-rn/issues"
+    "url": "https://github.com/Orbis-1/orbis1-sdk-rn/issues"
   },
-  "homepage": "https://github.com/orgs/Orbis-1/orbis1-sdk-rn#readme",
+  "homepage": "https://github.com/Orbis-1/orbis1-sdk-rn#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },

package/src/Orbis1SDK.ts

@@ -69,6 +69,7 @@ export class Orbis1SDK {
           : BitcoinNetwork.TESTNET4;
 
       this.wallet = new Wallet(this.config.wallet.keys, {
+        dataDir: this.config.wallet.dataDir,
         network,
         supportedSchemas: this.config.wallet.supportedSchemas,
         maxAllocationsPerUtxo: this.config.wallet.maxAllocationsPerUtxo,

package/src/core/NativeRgb.ts

@@ -31,6 +31,7 @@ export interface Spec extends TurboModule {
   }>;
   restoreBackup(path: string, password: string): Promise<void>;
   initializeWallet(
+    dataDir: string | null,
     network: string,
     accountXpubVanilla: string,
     accountXpubColored: string,

package/src/core/Wallet.ts

@@ -2,6 +2,7 @@ import Rgb from './NativeRgb';
 import * as Interfaces from './Interfaces';
 
 export interface WalletOptions {
+  dataDir?: string;
   network?: Interfaces.BitcoinNetwork;
   supportedSchemas?: Interfaces.AssetSchema[];
   maxAllocationsPerUtxo?: number;
@@ -11,6 +12,7 @@ export interface WalletOptions {
 export class Wallet {
   private walletId: number | null = null;
   private keys: Interfaces.Keys;
+  private dataDir?: string;
   private network: Interfaces.BitcoinNetwork;
   private supportedSchemas: Interfaces.AssetSchema[];
   private maxAllocationsPerUtxo: number;
@@ -21,6 +23,7 @@ export class Wallet {
    * Creates a new Wallet instance with the provided keys and configuration.
    * @param keys - The cryptographic keys required for wallet operations (mnemonic, master fingerprint, xPubs)
    * @param options - Optional wallet configuration settings
+   * @param options.dataDir - Absolute path to directory where wallet data will be stored (optional, defaults to app documents directory)
    * @param options.network - The Bitcoin network to use (defaults to 'TESTNET4')
    * @param options.supportedSchemas - List of RGB asset schemas the wallet supports (defaults to CFA, NIA, UDA)
    * @param options.maxAllocationsPerUtxo - Maximum number of RGB allocations allowed per UTXO (defaults to 1)
@@ -28,6 +31,7 @@ export class Wallet {
    */
   constructor(keys: Interfaces.Keys, options?: WalletOptions) {
     this.keys = keys;
+    this.dataDir = options?.dataDir;
     this.network = options?.network || Interfaces.BitcoinNetwork.TESTNET4;
     this.supportedSchemas = options?.supportedSchemas || [
       Interfaces.AssetSchema.CFA,
@@ -57,6 +61,7 @@ export class Wallet {
     // Start initialization
     this.initializationPromise = (async () => {
       this.walletId = await Rgb.initializeWallet(
+        this.dataDir || null,
         this.network,
         this.keys.accountXpubVanilla,
         this.keys.accountXpubColored,

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

@@ -31,7 +31,7 @@ import type {
   TransferState,
 } from './types';
 import { GasFreeError, GasFreeErrorCode } from './errors/GasFreeError';
-import type { AssignmentType, InvoiceData } from '../../core/Interfaces';
+import type { AssignmentType } from '../../core/Interfaces';
 import { Feature } from '../../types/Feature';
 
 /**
@@ -169,24 +169,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
       throw GasFreeError.notInitialized();
     }
 
-    // Decode the recipient invoice up-front so we can inspect the seal type.
-    // This also validates the invoice format before touching the backend.
-    const decodedRecipientInvoice = await this.wallet!.decodeInvoice(
-      request.recipientInvoice
-    );
-
-    // Witness-output invoices (wvout:) are not yet supported for gas-free
-    // transfers because sendEnd requires additional changes to handle the
-    // extra Bitcoin output they introduce. Reject early so no backend call
-    // is made and the user gets a clear actionable message.
-    if (this.isWitnessRecipient(decodedRecipientInvoice)) {
-      throw new GasFreeError(
-        'Witness invoices (wvout) are not yet supported for gas-free transfers. ' +
-          'Please ask the recipient to generate a blinded-UTXO invoice instead.',
-        GasFreeErrorCode.INVALID_REQUEST
-      );
-    }
-
     // Reset state
     this.currentState = { status: 'idle' };
 
@@ -279,7 +261,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
       const submitResult = await this.submitPSBT(
         feeQuote.quoteId,
         psbtResult,
-        feeQuote.serviceFeeInvoice,
         request.assetId
       );
 
@@ -291,9 +272,7 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
         submitResult.signedPsbtBase64
       );
 
-      // Step 4: Notify service of successful broadcast.
-      // The service uses txid to confirm the transaction landed in mempool
-      // and calls its own wallet.refresh() to claim the RGB service fee.
+      // Step 4: Notify service of successful broadcast
       await this.verifyTransfer(feeQuote.quoteId, txid, userSignedPsbt);
 
       // Mark as verified
@@ -359,6 +338,7 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
       assetId: request.assetId,
       numInputs: request.numInputs || 1, // defaults to 1 inputs if not provided (1 user input)
       numOutputs: request.numOutputs || 2, // defaults to 2 outputs if not provided (1 OP_RETURN, 1 user change <equal val as input>)
+      recipientInvoice: request.recipientInvoice,
     });
 
     // Check quote expiration
@@ -457,14 +437,17 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
       service: decodedServiceInvoice,
     });
 
+    const recipientIsWitness = feeQuote.witnessUtxoFundingSats > 0;
+
     // Build recipient map for sendBegin
-    // Note: Recipient requires assignment field with type and amount
+    // Note: Recipient requires assignment field with type and amount.
     // Important: Decoded invoices may have 'ANY' type (wildcard), but sendBegin
     // requires a concrete assignment type. Always use 'FUNGIBLE' for asset transfers.
     const recipientMap: Record<
       string,
       Array<{
         recipientId: string;
+        witnessData?: { amountSat: number; blinding?: number };
         assignment: { type: AssignmentType; amount: number };
         transportEndpoints: string[];
       }>
@@ -473,6 +456,12 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
         {
           // Recipient 1: The actual transfer to the merchant / end recipient
           recipientId: decodedRecipientInvoice.recipientId,
+          ...(recipientIsWitness && {
+            witnessData: {
+              amountSat: feeQuote.witnessUtxoFundingSats,
+              blinding: 0, // Default blinding factor (rgb-lib requires this field)
+            },
+          }),
           assignment: {
             // Use FUNGIBLE type for asset transfers (invoice may have 'ANY' wildcard type)
             type: 'FUNGIBLE',
@@ -534,7 +523,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
    *
    * @param quoteId - Quote ID from the fee quote
    * @param psbtResult - PSBT build result from buildPSBT()
-   * @param serviceFeeInvoice - Service fee RGB invoice from the quote
    * @param assetId - Asset ID being transferred
    * @returns Submit result with service-signed PSBT
    *
@@ -543,7 +531,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
    * const submitResult = await gasFree.submitPSBT(
    *   quote.quoteId,
    *   psbtResult,
-   *   quote.serviceFeeInvoice,
    *   request.assetId
    * );
    * console.log('Service signed PSBT:', submitResult.signedPsbtBase64);
@@ -552,7 +539,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
   async submitPSBT(
     quoteId: string,
     psbtResult: PSBTBuildResult,
-    serviceFeeInvoice: string,
     assetId: string
   ): Promise<PSBTSubmitResult> {
     this.logger?.debug('Step 3: Reading consignment and submitting to service');
@@ -566,7 +552,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
       quoteId,
       psbtBase64: psbtResult.unsignedPsbt,
       consignmentBase64,
-      rgbInvoice: serviceFeeInvoice,
     });
 
     this.currentState.status = 'submitted';
@@ -638,7 +623,7 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
    *
    * @param quoteId - Quote ID from the fee quote
    * @param txid - Transaction ID from broadcastTransfer()
-   * @param signedPsbtBase64 - Fully-signed PSBT from broadcastTransfer()
+   * @param signedPsbtBase64 - Base64-encoded signed PSBT
    * @returns Verification result from the service
    *
    * @example
@@ -646,7 +631,7 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
    * const verifyResult = await gasFree.verifyTransfer(
    *   quote.quoteId,
    *   broadcastResult.txid,
-   *   broadcastResult.userSignedPsbt
+   *   signedPsbtBase64
    * );
    * console.log('Verification status:', verifyResult.status);
    * console.log('In mempool:', verifyResult.inMempool);
@@ -662,8 +647,8 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
     const verifyResult = await this.serviceClient!.verifyTransfer({
       quoteId,
       transferSuccess: true,
-      signedPsbtBase64,
       txid,
+      signedPsbtBase64,
     });
 
     this.logger?.debug('Transfer verified', {
@@ -676,19 +661,6 @@ export class GasFreeModule implements IFeatureModule<GasFreeConfig> {
     return verifyResult;
   }
 
-  /**
-   * Returns true if a decoded invoice targets a witness output (`wvout:`) seal.
-   *
-   * The `recipientId` returned by `decodeInvoice` for witness invoices follows
-   * the pattern `{network}:wvout:{sealData}` (e.g. `tb4:wvout:BYrJtiVZ-…`).
-   * Splitting on `:` and checking the second segment is more reliable than
-   * searching the raw invoice string.
-   */
-  private isWitnessRecipient(decoded: InvoiceData): boolean {
-    const parts = decoded.recipientId.split(':');
-    return parts[1] === 'wvout';
-  }
-
   /**
    * Validate configuration
    */

package/src/features/gas-free/client/ServiceClient.ts

@@ -197,12 +197,6 @@ export class ServiceClient implements IServiceClient {
       ]);
     }
 
-    if (!request.rgbInvoice || request.rgbInvoice.trim().length === 0) {
-      throw new InvalidPSBTError('RGB invoice is required', [
-        'rgbInvoice cannot be empty',
-      ]);
-    }
-
     // Make API request with retry
     try {
       return await retryWithBackoff(async () => {

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

@@ -50,10 +50,12 @@ export interface FeeQuote {
   serviceFeeAmount: number;
   /** Asset type for service fee */
   assetType?: string;
+  /** Satoshi amount needed to fund witness UTXO (0 for blinded invoices, typically 1000 for witness invoices) */
+  witnessUtxoFundingSats: number;
   /** Mining UTXO provided by backend */
   miningUTXO: MiningUTXO;
-  /** Mining change UTXO details */
-  miningChangeUTXO: MiningChangeUTXO;
+  /** Mining change UTXO details (undefined if entire mining UTXO is consumed) */
+  miningChangeUTXO?: MiningChangeUTXO;
   /** RGB invoice for service fee payment */
   serviceFeeInvoice: string;
   /** Service fee recipient ID (utxob) */
@@ -78,6 +80,8 @@ export interface FeeQuoteRequest {
   numInputs: number;
   /** Number of USER's transaction outputs (INCLUDES OP_RETURN, must be >= 2) */
   numOutputs: number;
+  /** RGB invoice for the recipient (mandatory) */
+  recipientInvoice: string;
 }
 
 /**

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

@@ -20,7 +20,7 @@ export interface GasFreeTransferRequest {
   /** Amount of RGB asset to send */
   amount: string;
 
-  /** Recipient RGB invoice (blinded UTXO) */
+  /** Recipient RGB invoice (blinded UTXO or witness output) */
   recipientInvoice: string;
 
   /** Transport endpoints for RGB transfer (e.g., ['rpc://...']) */

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

@@ -16,8 +16,6 @@ export interface SubmitPSBTRequest {
   psbtBase64: string;
   /** Base64-encoded RGB consignment file (.rgbc) */
   consignmentBase64: string;
-  /** RGB invoice string for service fee payment */
-  rgbInvoice: string;
 }
 
 /**

package/src/features/gas-free/utils/validation.ts

@@ -66,8 +66,12 @@ export const FeeQuoteSchema = z.object({
     .number()
     .nonnegative('Service fee amount must be non-negative'),
   assetType: z.string().optional(),
+  witnessUtxoFundingSats: z
+    .number()
+    .int()
+    .nonnegative('Witness UTXO funding sats must be non-negative'),
   miningUTXO: MiningUTXOSchema,
-  miningChangeUTXO: MiningChangeUTXOSchema,
+  miningChangeUTXO: MiningChangeUTXOSchema.optional(),
   serviceFeeInvoice: z.string().min(1, 'Service fee invoice must not be empty'),
   serviceFeeRecipientId: z
     .string()
@@ -88,16 +92,21 @@ export const FeeQuoteRequestSchema = z.object({
     .number()
     .int()
     .min(2, 'Number of outputs must be at least 2 (includes OP_RETURN)'),
+  recipientInvoice: z
+    .string()
+    .min(1, 'Recipient invoice cannot be empty')
+    .regex(/^rgb1?:/, 'Recipient invoice must start with rgb: or rgb1:'),
 }) satisfies z.ZodType<FeeQuoteRequest>;
 
 /**
  * Schema for Submit PSBT Request
  */
 export const SubmitPSBTRequestSchema = z.object({
-  quoteId: z.string().min(1, 'Quote ID must not be empty'),
-  psbtBase64: z.string().min(1, 'PSBT base64 must not be empty'),
-  consignmentBase64: z.string().min(1, 'Consignment base64 must not be empty'),
-  rgbInvoice: z.string().min(1, 'RGB invoice must not be empty'),
+  quoteId: z.string().uuid('Quote ID must be a valid UUID'),
+  psbtBase64: z.string().min(1, 'PSBT cannot be empty'),
+  consignmentBase64: z
+    .string()
+    .min(1, 'Consignment data is required (base64-encoded)'),
 }) satisfies z.ZodType<SubmitPSBTRequest>;
 
 /**

package/src/types/SDKConfig.ts

@@ -17,6 +17,8 @@ export interface WalletConfig {
   enabled: boolean;
   /** Wallet keys (mnemonic, xpubs, etc.) */
   keys: Keys;
+  /** Absolute path to directory where wallet data will be stored. If not provided, defaults to app documents directory. */
+  dataDir?: string;
   /** Supported asset schemas */
   supportedSchemas?: AssetSchema[];
   /** Maximum allocations per UTXO */