@ordanetwork/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 orda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,315 @@
+# orda TypeScript SDK
+
+[![npm version](https://badge.fury.io/js/@ordanetwork%2Fsdk.svg)](https://www.npmjs.com/package/@ordanetwork/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@ordanetwork/sdk.svg)](https://nodejs.org)
+
+Universal TypeScript SDK for cross-chain cryptocurrency payments with smart wallet support. Works seamlessly in both Node.js (18+) and browser environments.
+
+## Installation
+
+```bash
+npm install @ordanetwork/sdk
+# or
+yarn add @ordaordanetwork/sdk
+# or
+pnpm add @ordaordanetwork/sdk
+```
+
+### Requirements
+
+- **Node.js**: Version 18.0.0 or higher (for native fetch API support)
+- **TypeScript**: Version 5.0.0 or higher (if using TypeScript)
+- **viem**: Required peer dependency for blockchain interactions
+
+## Features
+
+- 🌐 **Universal Compatibility**: Works in both browser and Node.js environments
+- 🔐 **HMAC Authentication**: Secure API authentication with Web Crypto API
+- 🚀 **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
+
+
+## Quick Start
+
+```typescript
+import { OrdaSDK } from '@ordanetwork/sdk';
+
+const orda = new OrdaSDK({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret'
+});
+
+// Create a recipient
+const recipient = await orda.recipients.create({
+  name: 'Test Recipient',
+  cryptoSettlementDetails: {
+    toChain: '8453'
+    toToken: '0x4200000000000000000000000000000000000006'
+  }
+});
+
+// Request a quote
+const quote = await orda.quote.request({
+  fromChain: '1', // Ethereum
+  fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+  fromAddress: '0xYourAddress',
+  intent: {
+    method: 'usd',
+    value: '100'
+  },
+  recipientId: recipient.recipientId
+});
+```
+
+## Module Formats
+
+The SDK supports multiple module formats for maximum compatibility:
+
+### CommonJS (Node.js)
+```javascript
+const { OrdaSDK } = require('@ordanetwork/sdk');
+```
+
+### ES Modules (Modern JavaScript)
+```javascript
+import { OrdaSDK } from '@ordanetwork/sdk';
+```
+
+### Browser (via CDN)
+```html
+<script src="https://unpkg.com/@ordanetwork/sdk/dist/browser/index.js"></script>
+```
+
+## Browser Security
+
+⚠️ **CRITICAL SECURITY WARNING** ⚠️
+
+**Never expose your API credentials in browser code!** Your `clientId` and `clientSecret` will be visible to anyone who inspects the browser's JavaScript.
+
+### ❌ Insecure (DO NOT DO THIS)
+```javascript
+// This exposes your credentials to everyone!
+const orda = new OrdaSDK({
+  clientId: 'your-client-id',      // VISIBLE IN BROWSER!
+  clientSecret: 'your-client-secret' // VISIBLE IN BROWSER!
+});
+```
+
+### ✅ Secure (Recommended Approach)
+
+Implement a backend proxy that handles API authentication:
+
+**Backend (Node.js Express example):**
+```javascript
+// server.js - Keep credentials secure on the server
+const express = require('express');
+const { OrdaSDK } = require('@ordanetwork/sdk');
+
+const app = express();
+const orda = new OrdaSDK({
+  clientId: process.env.ORDA_CLIENT_ID,
+  clientSecret: process.env.ORDA_CLIENT_SECRET
+});
+
+app.post('/api/orda/quote', async (req, res) => {
+  try {
+    // Authenticate the user first!
+    const userId = authenticateUser(req);
+
+    // Then proxy the request to orda
+    const quote = await orda.quote.request(req.body);
+    res.json(quote);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+```
+
+**Frontend (Browser):**
+```javascript
+// Safe - credentials stay on your server
+const response = await fetch('/api/orda/quote', {
+  method: 'POST',
+  headers: {
+    'Authorization': `Bearer ${userToken}`,
+    'Content-Type': 'application/json'
+  },
+  body: JSON.stringify(quoteRequest)
+});
+const quote = await response.json();
+```
+
+## API Documentation
+
+### Initialize SDK
+
+```typescript
+const orda = new OrdaSDK({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+  debug: true
+});
+```
+
+### Recipients API
+
+```typescript
+// Create recipient
+await orda.recipients.create({
+  name: string,
+  cryptoSettlementDetails?: CryptoSettlementDetails,
+  fiatSettlementDetails?: FiatSettlementDetails,
+  kycInformation?: KYCInformation
+});
+
+// Update recipient
+await orda.recipients.updateSettlement({
+  recipientId: string,
+  cryptoSettlementDetails?: CryptoSettlementDetails,
+  fiatSettlementDetails?: FiatSettlementDetails,
+  kycInformation?: KYCInformation
+});
+
+// Deactivate recipient
+await orda.recipients.deactivate({
+  recipientId: string
+});
+```
+
+### Quote API
+
+```typescript
+// Request quote
+await orda.quote.request({
+  fromChain: string,
+  fromToken: string,
+  fromAddress: string,
+  intent: {
+    method: 'usd' | 'fromAmount' | 'toAmount',
+    value: string
+  },
+  recipientId?: string,
+  timeout?: number
+});
+```
+
+### Transaction API
+
+```typescript
+// Get transaction status
+await orda.transactions.getStatus({
+  transactionId?: string,
+  sourceHash?: string,
+  destinationHash?: string
+});
+
+// Get successful transactions
+await orda.transactions.getSuccessfulTransactions();
+
+// Wait for transaction completion with polling
+await orda.transactions.waitForCompletion(transactionId, {
+  intervalMs: 5000,
+  timeoutMs: 600000,
+  onStatusUpdate: (status) => console.log(status)
+});
+```
+
+### Off-Ramp API (Crypto to Fiat)
+
+```typescript
+// Request off-ramp quote
+await orda.offRamp.requestQuote({
+  fromChain: string,
+  fromToken: string,
+  fromAddress: string,
+  intent: Intent,
+  recipientId?: string,
+  kycInformation?: KYCInformation,
+  fiatSettlementDetails?: FiatSettlementDetails
+});
+
+// Get off-ramp status
+await orda.offRamp.getStatus(transactionId);
+
+// Wait for completion
+await orda.offRamp.waitForCompletion(transactionId, options);
+```
+
+### On-Ramp API (Fiat to Crypto)
+
+```typescript
+// Request on-ramp quote
+await orda.onRamp.requestQuote({
+  fromCurrency: string,
+  intent: Intent,
+  recipientId: string
+});
+
+// Get on-ramp status
+await orda.onRamp.getStatus(transactionId);
+
+// Wait for completion
+await orda.onRamp.waitForCompletion(transactionId, options);
+```
+
+#
+
+## Browser Usage
+
+```html
+<script src="https://unpkg.com/@ordanetwork/sdk/dist/browser/index.js"></script>
+<script>
+  const orda = new OrdaSDK.OrdaSDK({
+    clientId: 'your-client-id',
+    clientSecret: 'your-client-secret'
+  });
+
+  // Use the SDK
+  orda.recipients.create({...}).then(console.log);
+</script>
+```
+
+## Security Considerations
+
+⚠️ **Important**: Never expose your API credentials in client-side code for production applications. Use a backend proxy to keep your credentials secure.
+
+### Recommended Architecture
+
+```
+Browser → Your Backend Proxy → orda API
+```
+
+## TypeScript Support
+
+The SDK is written in TypeScript and provides full type definitions out of the box.
+
+```typescript
+import {
+  OrdaSDK,
+  QuoteRequestParams,
+  TransactionStatus,
+  OrdaError
+} from '@ordanetwork/sdk';
+```
+
+## Error Handling
+
+```typescript
+try {
+  const quote = await orda.quote.request({...});
+} catch (error) {
+  if (error instanceof OrdaError) {
+    console.error('Status Code:', error.statusCode);
+    console.error('Error Code:', error.code);
+    console.error('Details:', error.details);
+  }
+}
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,45 @@
+import { UniversalHttpClient } from '../http/client';
+import { OffRampQuoteParams, OffRampQuoteResponse, OffRampStatusResponse, OffRampStatusType } from '../types/offramp';
+/**
+ * Polling options for off-ramp operations
+ */
+export interface OffRampPollingOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onStatusUpdate?: (status: OffRampStatusType) => void;
+}
+/**
+ * API wrapper for off-ramp (crypto to fiat) operations
+ */
+export declare class OffRampAPI {
+    private httpClient;
+    constructor(httpClient: UniversalHttpClient);
+    /**
+     * Requests a quote for off-ramping crypto to fiat
+     * @param params Off-ramp quote parameters
+     * @returns Off-ramp quote response
+     */
+    requestQuote(params: OffRampQuoteParams): Promise<OffRampQuoteResponse>;
+    /**
+     * Gets the status of an off-ramp transaction
+     * @param transactionId The transaction ID
+     * @returns Off-ramp transaction status
+     */
+    getStatus(transactionId: string): Promise<OffRampStatusResponse>;
+    /**
+     * Waits for off-ramp completion using polling
+     * @param transactionId The transaction ID to monitor
+     * @param options Polling configuration
+     * @returns Final off-ramp status
+     */
+    waitForCompletion(transactionId: string, options?: OffRampPollingOptions): Promise<OffRampStatusResponse>;
+    /**
+     * Checks if a status is terminal
+     */
+    private isTerminalStatus;
+    /**
+     * Helper to sleep for a given duration
+     */
+    private sleep;
+}
+//# sourceMappingURL=OffRampAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OffRampAPI.d.ts","sourceRoot":"","sources":["../../../src/api/OffRampAPI.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,UAAU;IACT,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI7E;;;;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/browser/api/OffRampAPI.js

@@ -0,0 +1,73 @@
+/**
+ * API wrapper for off-ramp (crypto to fiat) operations
+ */
+export class OffRampAPI {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Requests a quote for off-ramping crypto to fiat
+     * @param params Off-ramp quote parameters
+     * @returns Off-ramp quote response
+     */
+    async requestQuote(params) {
+        return this.httpClient.post('/offramp/quote', params);
+    }
+    /**
+     * Gets the status of an off-ramp transaction
+     * @param transactionId The transaction ID
+     * @returns Off-ramp transaction status
+     */
+    async getStatus(transactionId) {
+        return this.httpClient.get('/offramp/status', { transactionId });
+    }
+    /**
+     * Waits for off-ramp completion using polling
+     * @param transactionId The transaction ID to monitor
+     * @param options Polling configuration
+     * @returns Final off-ramp status
+     */
+    async waitForCompletion(transactionId, options) {
+        const intervalMs = options?.intervalMs || 10000; // 10 seconds
+        const timeoutMs = options?.timeoutMs || 1800000; // 30 minutes default
+        const startTime = Date.now();
+        let lastStatus = null;
+        while (true) {
+            if (Date.now() - startTime > timeoutMs) {
+                throw new Error(`Off-ramp polling timeout after ${timeoutMs}ms. Last status: ${lastStatus}`);
+            }
+            try {
+                const response = await this.getStatus(transactionId);
+                const currentStatus = response.status;
+                if (currentStatus !== lastStatus && options?.onStatusUpdate) {
+                    options.onStatusUpdate(currentStatus);
+                }
+                lastStatus = currentStatus;
+                if (this.isTerminalStatus(currentStatus)) {
+                    return response;
+                }
+                await this.sleep(intervalMs); // wait before next poll
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.includes('network')) {
+                    await this.sleep(intervalMs);
+                    continue; // continue polling on error
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Checks if a status is terminal
+     */
+    isTerminalStatus(status) {
+        return ['Completed', 'Failed', 'Refunded'].includes(status);
+    }
+    /**
+     * Helper to sleep for a given duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=OffRampAPI.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OffRampAPI.js","sourceRoot":"","sources":["../../../src/api/OffRampAPI.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,OAAO,UAAU;IACrB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,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/browser/api/OnRampAPI.d.ts

@@ -0,0 +1,42 @@
+import { UniversalHttpClient } from '../http/client';
+import { OnRampQuoteParams, OnRampQuoteResponse, OnRampStatusResponse } from '../types/onramp';
+export interface OnRampPollingOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onStatusUpdate?: (status: string) => void;
+}
+/**
+ * API wrapper for on-ramp (fiat to crypto) operations
+ */
+export declare class OnRampAPI {
+    private httpClient;
+    constructor(httpClient: UniversalHttpClient);
+    /**
+     * Requests a quote for on-ramping fiat to crypto
+     * @param params On-ramp quote parameters
+     * @returns On-ramp quote response with deposit instructions
+     */
+    requestQuote(params: OnRampQuoteParams): Promise<OnRampQuoteResponse>;
+    /**
+     * Gets the status of an on-ramp transaction
+     * @param transactionId The transaction ID
+     * @returns On-ramp transaction status
+     */
+    getStatus(transactionId: string): Promise<OnRampStatusResponse>;
+    /**
+     * Waits for on-ramp completion using polling
+     * @param transactionId The transaction ID to monitor
+     * @param options Polling configuration
+     * @returns Final on-ramp status
+     */
+    waitForCompletion(transactionId: string, options?: OnRampPollingOptions): Promise<OnRampStatusResponse>;
+    /**
+     * Checks if a status is terminal
+     */
+    private isTerminalStatus;
+    /**
+     * Helper to sleep for a given duration
+     */
+    private sleep;
+}
+//# sourceMappingURL=OnRampAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OnRampAPI.d.ts","sourceRoot":"","sources":["../../../src/api/OnRampAPI.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,SAAS;IACR,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI3E;;;;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/browser/api/OnRampAPI.js

@@ -0,0 +1,73 @@
+/**
+ * API wrapper for on-ramp (fiat to crypto) operations
+ */
+export class OnRampAPI {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Requests a quote for on-ramping fiat to crypto
+     * @param params On-ramp quote parameters
+     * @returns On-ramp quote response with deposit instructions
+     */
+    async requestQuote(params) {
+        return this.httpClient.post('/onramp/quote', params);
+    }
+    /**
+     * Gets the status of an on-ramp transaction
+     * @param transactionId The transaction ID
+     * @returns On-ramp transaction status
+     */
+    async getStatus(transactionId) {
+        return this.httpClient.get('/onramp/status', { transactionId });
+    }
+    /**
+     * Waits for on-ramp completion using polling
+     * @param transactionId The transaction ID to monitor
+     * @param options Polling configuration
+     * @returns Final on-ramp status
+     */
+    async waitForCompletion(transactionId, options) {
+        const intervalMs = options?.intervalMs || 15000; // 15 secs
+        const timeoutMs = options?.timeoutMs || 3600000; // 60 mins for PIX
+        const startTime = Date.now();
+        let lastStatus = null;
+        while (true) {
+            if (Date.now() - startTime > timeoutMs) {
+                throw new Error(`On-ramp polling timeout after ${timeoutMs}ms. Last status: ${lastStatus}`);
+            }
+            try {
+                const response = await this.getStatus(transactionId);
+                const currentStatus = response.status;
+                if (currentStatus !== lastStatus && options?.onStatusUpdate) {
+                    options.onStatusUpdate(currentStatus);
+                }
+                lastStatus = currentStatus;
+                if (this.isTerminalStatus(currentStatus)) {
+                    return response;
+                }
+                await this.sleep(intervalMs); // wait before next poll
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.includes('network')) {
+                    await this.sleep(intervalMs);
+                    continue; // continue polling on error
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Checks if a status is terminal
+     */
+    isTerminalStatus(status) {
+        return ['Completed', 'Failed', 'Cancelled', 'Refunded'].includes(status);
+    }
+    /**
+     * Helper to sleep for a given duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=OnRampAPI.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OnRampAPI.js","sourceRoot":"","sources":["../../../src/api/OnRampAPI.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,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

@@ -0,0 +1,16 @@
+import { UniversalHttpClient } from '../http/client';
+import { QuoteRequestParams, QuoteResponse } from '../types';
+/**
+ * API wrapper for quote operations
+ */
+export declare class QuoteAPI {
+    private httpClient;
+    constructor(httpClient: UniversalHttpClient);
+    /**
+     * Requests a quote for a cross-chain transfer
+     * @param params Quote request parameters
+     * @returns Quote response with transaction ID and transfer details
+     */
+    request(params: QuoteRequestParams): Promise<QuoteResponse>;
+}
+//# sourceMappingURL=QuoteAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteAPI.d.ts","sourceRoot":"","sources":["../../../src/api/QuoteAPI.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,QAAQ;IACP,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,mBAAmB;IAEnD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;CAGlE"}

package/dist/browser/api/QuoteAPI.js

@@ -0,0 +1,17 @@
+/**
+ * API wrapper for quote operations
+ */
+export class QuoteAPI {
+    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) {
+        return this.httpClient.post('/quote', params);
+    }
+}
+//# sourceMappingURL=QuoteAPI.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteAPI.js","sourceRoot":"","sources":["../../../src/api/QuoteAPI.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACnB,YAAoB,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAA0B;QACtC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAgB,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+import { UniversalHttpClient } from '../http/client';
+import { CreateRecipientParams, UpdateRecipientSettlementParams, DeactivateRecipientParams, CreateRecipientResponse, UpdateRecipientResponse, DeactivateRecipientResponse } from '../types';
+export declare class RecipientAPI {
+    private httpClient;
+    constructor(httpClient: UniversalHttpClient);
+    /**
+     * Creates a new recipient
+     * @param params Recipient creation parameters
+     * @returns Recipient response with ID and optional smart wallet
+     */
+    create(params: CreateRecipientParams): Promise<CreateRecipientResponse>;
+    /**
+     * Updates recipient settlement details
+     * @param params Update parameters including recipient ID
+     * @returns Update response
+     */
+    updateSettlement(params: UpdateRecipientSettlementParams): Promise<UpdateRecipientResponse>;
+    /**
+     * Deactivates a recipient
+     * @param params Deactivation parameters
+     * @returns Deactivation response
+     */
+    deactivate(params: DeactivateRecipientParams): Promise<DeactivateRecipientResponse>;
+}
+//# sourceMappingURL=RecipientAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecipientAPI.d.ts","sourceRoot":"","sources":["../../../src/api/RecipientAPI.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,YAAY;IACX,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"}