@ordanetwork/sdk 1.0.1 → 1.1.0

package/README.md

@@ -11,28 +11,29 @@ TypeScript SDK for cross-chain cryptocurrency payments with smart wallet support
 ```bash
 npm install @ordanetwork/sdk
 # or
-yarn add @ordaordanetwork/sdk
+yarn add @ordanetwork/sdk
 # or
-pnpm add @ordaordanetwork/sdk
+pnpm add @ordanetwork/sdk
 ```
 
 ### Requirements
 
+- **Node.js**: Version 18.0.0 or higher
 - **TypeScript**: Version 5.0.0 or higher (if using TypeScript)
-- **viem**: Required peer dependency for blockchain interactions
 
 ## Features
 
-- 🔐 **HMAC Authentication**: Secure API authentication
-- 🚀 **Zero Dependencies**: Pure TypeScript implementation, no runtime dependencies
-- 📦 **Tree-shakeable**: Optimized for minimal bundle size
-- 🔄 **Async/Await**: Modern promise-based API
-- 💱 **Multi-chain Support**: Cross-chain transfers, off-ramp, and on-ramp operations
-- 🔑 **Smart Wallets**: Integrated Alchemy Account Kit support for UserOperations
+- **Dual Authentication**: HMAC (server-side) and JWT (client-side) authentication
+- **Multi-chain Support**: Cross-chain transfers, off-ramp, and on-ramp operations
+- **Smart Wallets**: Integrated Alchemy Account Kit support for UserOperations
+- **Module Formats**: ESM and CommonJS
+- **TypeScript**: Full type definitions included
 
 
 ## Quick Start
 
+### Server-Side (HMAC Authentication)
+
 ```typescript
 import { OrdaSDK } from '@ordanetwork/sdk';
 
@@ -40,26 +41,48 @@ const orda = new OrdaSDK({
   clientId: 'your-client-id',
   clientSecret: 'your-client-secret'
 });
+```
+
+### Client-Side (JWT Authentication)
+
+```typescript
+import { OrdaSDK } from '@ordanetwork/sdk';
+
+const orda = new OrdaSDK({
+  token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+});
+
+// Create a recipient with smart wallet (no toAddress)
+const recipientWithSmartWallet = await orda.recipients.create({
+  name: 'Test Recipient',
+  cryptoSettlementDetails: {
+    toChain: '8453',
+    toToken: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
+    // No toAddress - will generate smart wallet
+  }
+});
+console.log('Smart wallet:', recipientWithSmartWallet.smartWallet?.address);
 
-// Create a recipient
-const recipient = await orda.recipients.create({
+// Create a recipient with specific address
+const recipientWithAddress = await orda.recipients.create({
   name: 'Test Recipient',
   cryptoSettlementDetails: {
-    toChain: '8453'
-    toToken: '0x4200000000000000000000000000000000000006'
+    toChain: '8453',
+    toToken: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+    toAddress: '0xYourRecipientAddress'
   }
 });
 
 // Request a quote
 const quote = await orda.quote.request({
-  fromChain: '1', // Ethereum
-  fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+  fromChain: '1', // Ethereum mainnet
+  fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
   fromAddress: '0xYourAddress',
   intent: {
     method: 'usd',
     value: '100'
   },
-  recipientId: recipient.recipientId
+  recipientId: recipientWithSmartWallet.recipientId
 });
 ```
 
@@ -77,11 +100,11 @@ const { OrdaSDK } = require('@ordanetwork/sdk');
 import { OrdaSDK } from '@ordanetwork/sdk';
 ```
 
-## Security Considerations
+## Authentication Methods
 
-⚠️ **CRITICAL SECURITY WARNING** ⚠️
+### HMAC Authentication (Server-Side)
 
-**Never expose your API credentials in frontend code!** Your `clientId` and `clientSecret` should always be kept secure on your backend server.
+Use HMAC authentication for server-to-server communication. This method should only be used in secure backend environments.
 
 ```javascript
 const { OrdaSDK } = require('@ordanetwork/sdk');
@@ -90,16 +113,47 @@ const orda = new OrdaSDK({
   clientId: process.env.ORDA_CLIENT_ID,
   clientSecret: process.env.ORDA_CLIENT_SECRET
 });
+```
+
+**CRITICAL**: Never expose `clientSecret` in frontend code.
+
+### JWT Authentication (Client-Side)
+
+Use JWT authentication for client-side applications. Generate tokens on your backend and pass them to your frontend.
+
+**Backend (Node.js):**
+```typescript
+import { OrdaSDK } from '@ordanetwork/sdk';
+
+const orda = new OrdaSDK({
+  clientId: process.env.ORDA_CLIENT_ID,
+  clientSecret: process.env.ORDA_CLIENT_SECRET
+});
+
+const { token, expiresAt } = await orda.jwt.generate({
+  clientId: process.env.ORDA_CLIENT_ID,
+  clientSecret: process.env.ORDA_CLIENT_SECRET,
+  expiresIn: 3600,
+  permissions: ['quotes:read', 'offramp:read', 'onramp:read', 'transactions:read']
+});
+
+res.json({ token, expiresAt });
+```
+
+**Frontend (React/Vue/etc):**
+```typescript
+import { OrdaSDK } from '@ordanetwork/sdk';
+
+const response = await fetch('/api/auth/token');
+const { token } = await response.json();
+
+const orda = new OrdaSDK({ token });
 
-// Use the SDK to make API calls
 const quote = await orda.quote.request({
   fromChain: '1',
   fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
-  fromAddress: '0xYourAddress',
-  intent: {
-    method: 'usd',
-    value: '100'
-  },
+  fromAddress: userWalletAddress,
+  intent: { method: 'usd', value: '100' },
   recipientId: 'recipient-id'
 });
 ```
@@ -108,14 +162,51 @@ const quote = await orda.quote.request({
 
 ### Initialize SDK
 
+**HMAC Mode (Server-Side):**
 ```typescript
 const orda = new OrdaSDK({
   clientId: 'your-client-id',
   clientSecret: 'your-client-secret',
-  debug: true
+  requestTimeout: 30000,
+  debug: false
+});
+```
+
+**JWT Mode (Client-Side):**
+```typescript
+const orda = new OrdaSDK({
+  token: 'your-jwt-token',
+  requestTimeout: 30000,
+  debug: false
 });
 ```
 
+### JWT API
+
+Generate JWT tokens for client-side authentication.
+
+```typescript
+const { token, expiresAt } = await orda.jwt.generate({
+  clientId: string,
+  clientSecret: string,
+  expiresIn?: number,
+  permissions?: JWTPermission[]
+});
+```
+
+**Available Permissions:**
+- `quotes:read`
+- `offramp:read`
+- `onramp:read`
+- `transactions:read`
+- `recipients:read`
+- `recipients:write`
+
+**Default Permissions:**
+`['quotes:read', 'offramp:read', 'onramp:read', 'transactions:read', 'recipients:read']`
+
+**Note:** HMAC authentication bypasses permission checks and has full access to all operations.
+
 ### Recipients API
 
 ```typescript
@@ -144,7 +235,7 @@ await orda.recipients.deactivate({
 ### Quote API
 
 ```typescript
-// Request quote
+// Request quote with recipient
 await orda.quote.request({
   fromChain: string,
   fromToken: string,
@@ -153,7 +244,24 @@ await orda.quote.request({
     method: 'usd' | 'fromAmount' | 'toAmount',
     value: string
   },
-  recipientId?: string,
+  recipientId: string,
+  timeout?: number
+});
+
+// OR request quote with inline settlement (no recipient needed)
+await orda.quote.request({
+  fromChain: string,
+  fromToken: string,
+  fromAddress: string,
+  intent: {
+    method: 'usd' | 'fromAmount' | 'toAmount',
+    value: string
+  },
+  settlementDetails: {
+    toChain: string,
+    toToken: string,
+    toAddress: string
+  },
   timeout?: number
 });
 ```
@@ -182,15 +290,36 @@ await orda.transactions.waitForCompletion(transactionId, {
 ### Off-Ramp API (Crypto to Fiat)
 
 ```typescript
-// Request off-ramp quote
+// Request off-ramp quote with recipient
+await orda.offRamp.requestQuote({
+  fromChain: string,
+  fromToken: string,
+  fromAddress: string,
+  intent: Intent,
+  recipientId: string
+});
+
+// OR request off-ramp quote with inline KYC/settlement (no recipient needed)
 await orda.offRamp.requestQuote({
   fromChain: string,
   fromToken: string,
   fromAddress: string,
   intent: Intent,
-  recipientId?: string,
-  kycInformation?: KYCInformation,
-  fiatSettlementDetails?: FiatSettlementDetails
+  kycInformation: {
+    taxId: string,
+    taxIdCountry: string,
+    email: string,
+    name: string
+  },
+  fiatSettlementDetails: {
+    toCurrency: string,
+    pixKey?: string,
+    bankAccount?: string,
+    bankBranch?: string,
+    bankAccountType?: string,
+    iban?: string,
+    cbuCvu?: string
+  }
 });
 
 // Get off-ramp status
@@ -203,13 +332,24 @@ await orda.offRamp.waitForCompletion(transactionId, options);
 ### On-Ramp API (Fiat to Crypto)
 
 ```typescript
-// Request on-ramp quote
+// Request on-ramp quote with recipient
 await orda.onRamp.requestQuote({
   fromCurrency: string,
   intent: Intent,
   recipientId: string
 });
 
+// OR request on-ramp quote with inline settlement (no recipient needed)
+await orda.onRamp.requestQuote({
+  fromCurrency: string,
+  intent: Intent,
+  settlementDetails: {
+    toChain: string,
+    toToken: string,
+    toAddress: string
+  }
+});
+
 // Get on-ramp status
 await orda.onRamp.getStatus(transactionId);
 
@@ -227,7 +367,10 @@ import {
   OrdaSDK,
   QuoteRequestParams,
   TransactionStatus,
-  OrdaError
+  OrdaError,
+  JWTPermission,
+  GenerateJWTRequest,
+  GenerateJWTResponse
 } from '@ordanetwork/sdk';
 ```
 
@@ -245,6 +388,179 @@ try {
 }
 ```
 
+## Smart Wallet Support
+
+The SDK includes integrated support for Alchemy Account Kit smart wallets:
+
+```typescript
+// Generate a new private key
+const { privateKey, address } = await orda.smartWallets.generatePrivateKey();
+
+// Validate private key
+const isValid = orda.smartWallets.validatePrivateKey(privateKey);
+
+// Get address from private key
+const address = await orda.smartWallets.getAddressFromPrivateKey(privateKey);
+
+// Create project wallet
+const wallet = await orda.smartWallets.createProjectWallet(
+  projectId,
+  privateKey,
+  chainId
+);
+
+// Create recipient wallet
+const recipientWallet = await orda.smartWallets.createRecipientWallet(
+  recipientId,
+  privateKey,
+  chainId
+);
+```
+
+## Complete Example
+
+```javascript
+const { OrdaSDK } = require('@ordanetwork/sdk');
+
+async function main() {
+  const orda = new OrdaSDK({
+    clientId: process.env.ORDA_CLIENT_ID,
+    clientSecret: process.env.ORDA_CLIENT_SECRET,
+    debug: true,
+  });
+
+  // Create recipient with smart wallet
+  const recipient = await orda.recipients.create({
+    name: 'Test Recipient',
+    cryptoSettlementDetails: {
+      toChain: '8453', // Base
+      toToken: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913', // USDC
+    },
+  });
+  console.log('Smart wallet:', recipient.smartWallet?.address);
+
+  // Request cross-chain quote with recipient
+  const quote = await orda.quote.request({
+    fromChain: '1', // Ethereum
+    fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+    fromAddress: '0xYourAddress',
+    intent: {
+      method: 'usd',
+      value: '100',
+    },
+    recipientId: recipient.recipientId,
+  });
+
+  // OR request cross-chain quote with inline settlement (no recipient needed)
+  const inlineQuote = await orda.quote.request({
+    fromChain: '1', // Ethereum
+    fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+    fromAddress: '0xYourAddress',
+    intent: {
+      method: 'fromAmount',
+      value: '100000000', // 100 USDC (6 decimals)
+    },
+    settlementDetails: {
+      toChain: '137', // Polygon
+      toToken: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174', // USDC on Polygon
+      toAddress: '0xRecipientAddress',
+    },
+  });
+
+  // Monitor transaction
+  await orda.transactions.waitForCompletion(quote.transactionId, {
+    intervalMs: 10000,
+    timeoutMs: 600000,
+    onStatusUpdate: (status) => console.log('Status:', status),
+  });
+
+  // Off-ramp example (Crypto to Fiat)
+  const offRampRecipient = await orda.recipients.create({
+    name: 'Fiat Recipient',
+    fiatSettlementDetails: {
+      toCurrency: 'BRL',
+      pixKey: 'user@example.com',
+    },
+    kycInformation: {
+      taxId: '12345678901',
+      taxIdCountry: 'BRA',
+      email: 'user@example.com',
+      name: 'User Name',
+    },
+  });
+
+  const offRampQuote = await orda.offRamp.requestQuote({
+    fromChain: '8453',
+    fromToken: '0xE9185Ee218cae427aF7B9764A011bb89FeA761B4', // BRZ
+    fromAddress: '0xYourAddress',
+    intent: {
+      method: 'fromAmount',
+      value: '10000000000000000000', // 10 BRZ
+    },
+    recipientId: offRampRecipient.recipientId,
+  });
+
+  // OR off-ramp with inline KYC/settlement (no recipient needed)
+  const inlineOffRampQuote = await orda.offRamp.requestQuote({
+    fromChain: '8453',
+    fromToken: '0xE9185Ee218cae427aF7B9764A011bb89FeA761B4', // BRZ
+    fromAddress: '0xYourAddress',
+    intent: {
+      method: 'fromAmount',
+      value: '10000000000000000000', // 10 BRZ
+    },
+    kycInformation: {
+      taxId: '12345678901',
+      taxIdCountry: 'BRA',
+      email: 'user@example.com',
+      name: 'User Name',
+    },
+    fiatSettlementDetails: {
+      toCurrency: 'BRL',
+      pixKey: 'user@example.com',
+    },
+  });
+
+  // On-ramp example (Fiat to Crypto)
+  const onRampQuote = await orda.onRamp.requestQuote({
+    fromCurrency: 'BRL',
+    intent: {
+      method: 'fromAmount',
+      value: '100.00',
+    },
+    recipientId: recipient.recipientId,
+  });
+  console.log('PIX payment key:', onRampQuote.depositInstructions.pixKey);
+
+  // OR on-ramp with inline settlement (no recipient needed)
+  const inlineOnRampQuote = await orda.onRamp.requestQuote({
+    fromCurrency: 'BRL',
+    intent: {
+      method: 'fromAmount',
+      value: '100.00',
+    },
+    settlementDetails: {
+      toChain: '8453', // Base
+      toToken: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913', // USDC
+      toAddress: '0xRecipientAddress',
+    },
+  });
+  console.log('PIX payment key:', inlineOnRampQuote.depositInstructions.pixKey);
+}
+
+main().catch(console.error);
+```
+
+## Dependencies
+
+The SDK uses the following runtime dependencies:
+
+- `@aa-sdk/core` - Alchemy Account Abstraction SDK core
+- `@account-kit/core` - Account Kit core functionality
+- `@account-kit/infra` - Account Kit infrastructure
+- `@account-kit/smart-contracts` - Smart contract implementations
+- `viem` - TypeScript interface for Ethereum
+
 ## License
 
 MIT

package/dist/browser/api/JWT.d.ts

@@ -0,0 +1,41 @@
+import { UniversalHttpClient } from '../http/client';
+import { GenerateJWTRequest, GenerateJWTResponse } from '../types/jwt';
+/**
+ * API wrapper for JWT authentication operations
+ *
+ * Handles generation of JWT tokens for client-side authentication.
+ * Note: "token" in this context refers to JWT (authentication), not ERC-20 tokens (assets).
+ */
+export declare class JWT {
+    private httpClient;
+    constructor(httpClient: UniversalHttpClient);
+    /**
+     * Generates a JWT for authentication using project credentials
+     *
+     * This endpoint does NOT use HMAC authentication - it directly validates
+     * the clientId and clientSecret to generate a JWT.
+     *
+     * @param params JWT generation parameters
+     * @returns JWT string and expiration timestamp
+     *
+     * @example
+     * ```typescript
+     * // Create an unauthenticated client
+     * const client = new UniversalHttpClient('https://api.orda.network/v1');
+     *
+     * // Generate a JWT
+     * const jwtApi = new JWT(client);
+     * const { token, expiresAt } = await jwtApi.generate({
+     *   clientId: 'proj_xxx',
+     *   clientSecret: 'secret_yyy',
+     *   expiresIn: 3600,
+     *   permissions: ['quotes:read', 'transactions:read']
+     * });
+     *
+     * // Use the JWT with SDK
+     * const sdk = new OrdaSDK({ token });
+     * ```
+     */
+    generate(params: GenerateJWTRequest): Promise<GenerateJWTResponse>;
+}
+//# sourceMappingURL=JWT.d.ts.map

package/dist/browser/api/JWT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JWT.d.ts","sourceRoot":"","sources":["../../../src/api/JWT.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,GAAG;IACF,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAuBzE"}

package/dist/browser/api/JWT.js

@@ -0,0 +1,59 @@
+/**
+ * API wrapper for JWT authentication operations
+ *
+ * Handles generation of JWT tokens for client-side authentication.
+ * Note: "token" in this context refers to JWT (authentication), not ERC-20 tokens (assets).
+ */
+export class JWT {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Generates a JWT for authentication using project credentials
+     *
+     * This endpoint does NOT use HMAC authentication - it directly validates
+     * the clientId and clientSecret to generate a JWT.
+     *
+     * @param params JWT generation parameters
+     * @returns JWT string and expiration timestamp
+     *
+     * @example
+     * ```typescript
+     * // Create an unauthenticated client
+     * const client = new UniversalHttpClient('https://api.orda.network/v1');
+     *
+     * // Generate a JWT
+     * const jwtApi = new JWT(client);
+     * const { token, expiresAt } = await jwtApi.generate({
+     *   clientId: 'proj_xxx',
+     *   clientSecret: 'secret_yyy',
+     *   expiresIn: 3600,
+     *   permissions: ['quotes:read', 'transactions:read']
+     * });
+     *
+     * // Use the JWT with SDK
+     * const sdk = new OrdaSDK({ token });
+     * ```
+     */
+    async generate(params) {
+        const { clientId, clientSecret, expiresIn, permissions } = params;
+        const body = {};
+        if (expiresIn) {
+            body.expiresIn = expiresIn;
+        }
+        if (permissions) {
+            body.permissions = permissions;
+        }
+        const response = await this.httpClient.request({
+            path: '/tokens',
+            method: 'POST',
+            headers: {
+                'x-client-id': clientId,
+                'x-client-secret': clientSecret
+            },
+            body: Object.keys(body).length > 0 ? body : undefined
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=JWT.js.map

package/dist/browser/api/JWT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JWT.js","sourceRoot":"","sources":["../../../src/api/JWT.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,GAAG;IACd,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA0B;QACvC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAElE,MAAM,IAAI,GAAwB,EAAE,CAAC;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QACjC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAsB;YAClE,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,QAAQ;gBACvB,iBAAiB,EAAE,YAAY;aAChC;YACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACtD,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/browser/api/{OffRampAPI.d.ts → OffRamp.d.ts}

@@ -11,7 +11,7 @@ export interface OffRampPollingOptions {
 /**
  * API wrapper for off-ramp (crypto to fiat) operations
  */
-export declare class OffRampAPI {
+export declare class OffRamp {
     private httpClient;
     constructor(httpClient: UniversalHttpClient);
     /**
@@ -42,4 +42,4 @@ export declare class OffRampAPI {
      */
     private sleep;
 }
-//# sourceMappingURL=OffRampAPI.d.ts.map
+//# sourceMappingURL=OffRamp.d.ts.map

package/dist/browser/api/OffRamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffRamp.d.ts","sourceRoot":"","sources":["../../../src/api/OffRamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiB7E;;;;OAIG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAItE;;;;;OAKG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;IAqCjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/{esm/api/OffRampAPI.js → browser/api/OffRamp.js}

@@ -1,7 +1,7 @@
 /**
  * API wrapper for off-ramp (crypto to fiat) operations
  */
-export class OffRampAPI {
+export class OffRamp {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
@@ -11,6 +11,15 @@ export class OffRampAPI {
      * @returns Off-ramp quote response
      */
     async requestQuote(params) {
+        // mutual exclusivity: either recipientId OR settlementDetails, not both
+        const hasRecipientId = !!params.recipientId;
+        const hasInlineData = !!(params.kycInformation && params.fiatSettlementDetails);
+        if (hasRecipientId && hasInlineData) {
+            throw new Error('Cannot provide both recipientId and inline KYC/settlement details');
+        }
+        if (!hasRecipientId && !hasInlineData) {
+            throw new Error('Must provide either recipientId OR both kycInformation and fiatSettlementDetails');
+        }
         return this.httpClient.post('/offramp/quote', params);
     }
     /**
@@ -70,4 +79,4 @@ export class OffRampAPI {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
 }
-//# sourceMappingURL=OffRampAPI.js.map
+//# sourceMappingURL=OffRamp.js.map

package/dist/browser/api/OffRamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffRamp.js","sourceRoot":"","sources":["../../../src/api/OffRamp.ts"],"names":[],"mappings":"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"}

package/dist/{esm/api/OnRampAPI.d.ts → browser/api/OnRamp.d.ts}

@@ -8,7 +8,7 @@ export interface OnRampPollingOptions {
 /**
  * API wrapper for on-ramp (fiat to crypto) operations
  */
-export declare class OnRampAPI {
+export declare class OnRamp {
     private httpClient;
     constructor(httpClient: UniversalHttpClient);
     /**
@@ -39,4 +39,4 @@ export declare class OnRampAPI {
      */
     private sleep;
 }
-//# sourceMappingURL=OnRampAPI.d.ts.map
+//# sourceMappingURL=OnRamp.d.ts.map

package/dist/browser/api/OnRamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnRamp.d.ts","sourceRoot":"","sources":["../../../src/api/OnRamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG/F,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY3E;;;;OAIG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE;;;;;OAKG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAmChC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}