@ordanetwork/sdk 1.0.2 → 1.1.0

package/README.md

@@ -23,7 +23,7 @@ pnpm add @ordanetwork/sdk
 
 ## Features
 
-- **HMAC Authentication**: Secure API authentication
+- **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
@@ -32,6 +32,8 @@ pnpm add @ordanetwork/sdk
 
 ## Quick Start
 
+### Server-Side (HMAC Authentication)
+
 ```typescript
 import { OrdaSDK } from '@ordanetwork/sdk';
 
@@ -39,6 +41,16 @@ 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({
@@ -88,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');
@@ -101,15 +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 });
 
 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'
 });
 ```
@@ -118,13 +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',
+  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
@@ -153,7 +235,7 @@ await orda.recipients.deactivate({
 ### Quote API
 
 ```typescript
-// Request quote
+// Request quote with recipient
 await orda.quote.request({
   fromChain: string,
   fromToken: string,
@@ -162,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
 });
 ```
@@ -191,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,
-  kycInformation?: KYCInformation,
-  fiatSettlementDetails?: FiatSettlementDetails
+  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,
+  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
@@ -212,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);
 
@@ -236,7 +367,10 @@ import {
   OrdaSDK,
   QuoteRequestParams,
   TransactionStatus,
-  OrdaError
+  OrdaError,
+  JWTPermission,
+  GenerateJWTRequest,
+  GenerateJWTResponse
 } from '@ordanetwork/sdk';
 ```
 
@@ -305,7 +439,7 @@ async function main() {
   });
   console.log('Smart wallet:', recipient.smartWallet?.address);
 
-  // Request cross-chain quote
+  // Request cross-chain quote with recipient
   const quote = await orda.quote.request({
     fromChain: '1', // Ethereum
     fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
@@ -317,6 +451,22 @@ async function main() {
     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,
@@ -350,6 +500,27 @@ async function main() {
     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',
@@ -360,6 +531,21 @@ async function main() {
     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);

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":"AAiBA;;GAEG;AACH,MAAM,OAAO,OAAO;IAClB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,wEAAwE;QACxE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QAC5C,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEhF,IAAI,cAAc,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAuB,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,aAAqB;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAwB,iBAAiB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,aAAqB,EACrB,OAA+B;QAE/B,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC,CAAC,aAAa;QAC9D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC,qBAAqB;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,UAAU,GAA6B,IAAI,CAAC;QAEhD,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,kCAAkC,SAAS,oBAAoB,UAAU,EAAE,CAC5E,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;gBACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAEtC,IAAI,aAAa,KAAK,UAAU,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;oBAC5D,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;gBACxC,CAAC;gBACD,UAAU,GAAG,aAAa,CAAC;gBAE3B,IAAI,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;oBACzC,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAChE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC7B,SAAS,CAAC,4BAA4B;gBACxC,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAyB;QAChD,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

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"}

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

@@ -1,7 +1,7 @@
 /**
  * API wrapper for on-ramp (fiat to crypto) operations
  */
-export class OnRampAPI {
+export class OnRamp {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
@@ -11,6 +11,13 @@ export class OnRampAPI {
      * @returns On-ramp quote response with deposit instructions
      */
     async requestQuote(params) {
+        // mutual exclusivity: either recipientId OR settlementDetails, not both
+        if (params.recipientId && params.settlementDetails) {
+            throw new Error('Cannot provide both recipientId and settlementDetails');
+        }
+        if (!params.recipientId && !params.settlementDetails) {
+            throw new Error('Must provide either recipientId or settlementDetails');
+        }
         return this.httpClient.post('/onramp/quote', params);
     }
     /**
@@ -70,4 +77,4 @@ export class OnRampAPI {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
 }
-//# sourceMappingURL=OnRampAPI.js.map
+//# sourceMappingURL=OnRamp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OnRamp.js","sourceRoot":"","sources":["../../../src/api/OnRamp.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,MAAM;IACjB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,wEAAwE;QACxE,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAsB,eAAe,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,aAAqB;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAuB,gBAAgB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,aAAqB,EACrB,OAA8B;QAE9B,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC,CAAC,UAAU;QAC3D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC,kBAAkB;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,UAAU,GAAkB,IAAI,CAAC;QAErC,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,oBAAoB,UAAU,EAAE,CAAC,CAAC;YAC9F,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;gBACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAEtC,IAAI,aAAa,KAAK,UAAU,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;oBAC5D,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;gBACxC,CAAC;gBACD,UAAU,GAAG,aAAa,CAAC;gBAE3B,IAAI,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;oBACzC,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAChE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC7B,SAAS,CAAC,4BAA4B;gBACxC,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAc;QACrC,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/browser/api/{QuoteAPI.d.ts → Quote.d.ts}

@@ -3,7 +3,7 @@ import { QuoteRequestParams, QuoteResponse } from '../types';
 /**
  * API wrapper for quote operations
  */
-export declare class QuoteAPI {
+export declare class Quote {
     private httpClient;
     constructor(httpClient: UniversalHttpClient);
     /**
@@ -13,4 +13,4 @@ export declare class QuoteAPI {
      */
     request(params: QuoteRequestParams): Promise<QuoteResponse>;
 }
-//# sourceMappingURL=QuoteAPI.d.ts.map
+//# sourceMappingURL=Quote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Quote.d.ts","sourceRoot":"","sources":["../../../src/api/Quote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;CAWlE"}

package/dist/browser/api/Quote.js

@@ -0,0 +1,24 @@
+/**
+ * API wrapper for quote operations
+ */
+export class Quote {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Requests a quote for a cross-chain transfer
+     * @param params Quote request parameters
+     * @returns Quote response with transaction ID and transfer details
+     */
+    async request(params) {
+        // mutual exclusivity: either recipientId OR settlementDetails, not both
+        if (params.recipientId && params.settlementDetails) {
+            throw new Error('Cannot provide both recipientId and settlementDetails');
+        }
+        if (!params.recipientId && !params.settlementDetails) {
+            throw new Error('Must provide either recipientId or settlementDetails');
+        }
+        return this.httpClient.post('/quote', params);
+    }
+}
+//# sourceMappingURL=Quote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Quote.js","sourceRoot":"","sources":["../../../src/api/Quote.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,KAAK;IAChB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAA0B;QACtC,wEAAwE;QACxE,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAgB,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/{esm/api/RecipientAPI.d.ts → browser/api/Recipient.d.ts}

@@ -1,6 +1,6 @@
 import { UniversalHttpClient } from '../http/client';
 import { CreateRecipientParams, UpdateRecipientSettlementParams, DeactivateRecipientParams, CreateRecipientResponse, UpdateRecipientResponse, DeactivateRecipientResponse } from '../types';
-export declare class RecipientAPI {
+export declare class Recipient {
     private httpClient;
     constructor(httpClient: UniversalHttpClient);
     /**
@@ -22,4 +22,4 @@ export declare class RecipientAPI {
      */
     deactivate(params: DeactivateRecipientParams): Promise<DeactivateRecipientResponse>;
 }
-//# sourceMappingURL=RecipientAPI.d.ts.map
+//# sourceMappingURL=Recipient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Recipient.d.ts","sourceRoot":"","sources":["../../../src/api/Recipient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB,qBAAa,SAAS;IACR,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI7E;;;;OAIG;IACG,gBAAgB,CACpB,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAG1F"}

package/dist/browser/api/{RecipientAPI.js → Recipient.js}

@@ -1,4 +1,4 @@
-export class RecipientAPI {
+export class Recipient {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
@@ -27,4 +27,4 @@ export class RecipientAPI {
         return this.httpClient.put('/deactivate-recipient', params);
     }
 }
-//# sourceMappingURL=RecipientAPI.js.map
+//# sourceMappingURL=Recipient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Recipient.js","sourceRoot":"","sources":["../../../src/api/Recipient.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,SAAS;IACpB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAA6B;QACxC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAA0B,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAAuC;QAEvC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAA0B,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAAiC;QAChD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAA8B,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/dist/{esm/api/TransactionAPI.d.ts → browser/api/Transaction.d.ts}

@@ -5,7 +5,7 @@ export interface PollingOptions {
     timeoutMs?: number;
     onStatusUpdate?: (status: TransactionStatus) => void;
 }
-export declare class TransactionAPI {
+export declare class Transaction {
     private httpClient;
     constructor(httpClient: UniversalHttpClient);
     /**
@@ -32,4 +32,4 @@ export declare class TransactionAPI {
     private isTerminalStatus;
     private sleep;
 }
-//# sourceMappingURL=TransactionAPI.d.ts.map
+//# sourceMappingURL=Transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../../src/api/Transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACtD;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAIpF;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAIjE;;;;;OAKG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,yBAAyB,CAAC;IAqCrC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,KAAK;CAGd"}