keyring-agent-core 0.1.0

package/dist/services/swap/DebridgeAdapter.d.ts

@@ -0,0 +1,20 @@
+import { BaseSwapService } from './BaseSwapService';
+import type { CheckApprovalParams, CheckApprovalResult, ExecuteSwapParams, ExecuteSwapResult, ProviderName, SwapQuoteParams, SwapQuoteResult, SwapServiceConfig, TrackTransactionParams, TrackTransactionResult } from './types';
+/**
+ * deBridge DLN adapter. Same-chain swap uses /chain/transaction; cross-chain
+ * uses /dln/order/create-tx. Approval is NOT integrated — caller must check
+ * on-chain allowance against `tx.to` separately.
+ */
+export declare class DebridgeAdapter extends BaseSwapService {
+    private readonly apiBaseUrl;
+    private readonly accessToken;
+    constructor(config?: SwapServiceConfig);
+    getProviderName(): ProviderName;
+    hasIntegratedApproval(): boolean;
+    getQuote(params: SwapQuoteParams): Promise<SwapQuoteResult>;
+    checkApproval(params: CheckApprovalParams): Promise<CheckApprovalResult>;
+    executeSwap(params: ExecuteSwapParams): Promise<ExecuteSwapResult>;
+    trackTransaction(params: TrackTransactionParams): Promise<TrackTransactionResult>;
+    private get;
+}
+//# sourceMappingURL=DebridgeAdapter.d.ts.map

package/dist/services/swap/DebridgeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebridgeAdapter.d.ts","sourceRoot":"","sources":["../../../src/services/swap/DebridgeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAIjB;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,GAAE,iBAAsB;IAM1C,eAAe,IAAI,YAAY;IAI/B,qBAAqB,IAAI,OAAO;IAI1B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAmG3D,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiBxE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUlE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAuCzE,GAAG;CAWlB"}

package/dist/services/swap/DebridgeAdapter.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebridgeAdapter = void 0;
+const BaseSwapService_1 = require("./BaseSwapService");
+const affiliate_1 = require("./affiliate");
+const DEFAULT_BASE_URL = 'https://dln.debridge.finance/v1.0';
+/**
+ * deBridge DLN adapter. Same-chain swap uses /chain/transaction; cross-chain
+ * uses /dln/order/create-tx. Approval is NOT integrated — caller must check
+ * on-chain allowance against `tx.to` separately.
+ */
+class DebridgeAdapter extends BaseSwapService_1.BaseSwapService {
+    apiBaseUrl;
+    accessToken;
+    constructor(config = {}) {
+        super(config);
+        this.apiBaseUrl = config.apiBaseUrl ?? DEFAULT_BASE_URL;
+        this.accessToken = config.accessToken ?? 'd6c45897b8f6';
+    }
+    getProviderName() {
+        return 'debridge';
+    }
+    hasIntegratedApproval() {
+        return false;
+    }
+    async getQuote(params) {
+        const { srcChainId, srcTokenAddress, srcTokenAmount, dstChainId, dstTokenAddress, recipientAddress, senderAddress, slippage, isCrossChain, } = params;
+        const crossChain = isCrossChain ?? srcChainId !== dstChainId;
+        const affiliate = await (0, affiliate_1.getAffiliateFee)(this.getProviderName(), srcChainId);
+        try {
+            if (crossChain) {
+                const query = {
+                    srcChainId: String(srcChainId),
+                    srcChainTokenIn: srcTokenAddress,
+                    srcChainTokenInAmount: srcTokenAmount,
+                    dstChainId: String(dstChainId),
+                    dstChainTokenOut: dstTokenAddress,
+                    dstChainTokenOutRecipient: recipientAddress,
+                    srcChainOrderAuthorityAddress: senderAddress,
+                    dstChainOrderAuthorityAddress: recipientAddress,
+                    accesstoken: this.accessToken,
+                };
+                if (affiliate) {
+                    query.affiliateFeeRecipient = affiliate.affiliateFeeRecipient;
+                    query.affiliateFeePercent = affiliate.affiliateFeePercent;
+                }
+                const res = await this.get(`${this.apiBaseUrl}/dln/order/create-tx`, query);
+                if (res.error || res.errorMessage) {
+                    return {
+                        success: false,
+                        error: res.error ?? res.errorMessage,
+                        errorMessage: res.errorMessage ?? 'deBridge quote failed',
+                    };
+                }
+                return {
+                    success: true,
+                    provider: 'debridge',
+                    tx: res.tx,
+                    estimation: res.estimation,
+                    isCrossChain: true,
+                    srcChainId,
+                    dstChainId,
+                    raw: res,
+                };
+            }
+            const swapQuery = {
+                chainId: String(srcChainId),
+                tokenIn: srcTokenAddress,
+                tokenInAmount: srcTokenAmount,
+                tokenOut: dstTokenAddress,
+                tokenOutRecipient: recipientAddress,
+                accesstoken: this.accessToken,
+            };
+            if (affiliate) {
+                swapQuery.affiliateFeeRecipient = affiliate.affiliateFeeRecipient;
+                swapQuery.affiliateFeePercent = affiliate.affiliateFeePercent;
+            }
+            if (slippage !== undefined)
+                swapQuery.slippage = slippage;
+            const res = await this.get(`${this.apiBaseUrl}/chain/transaction`, swapQuery);
+            if (res.error || res.errorMessage) {
+                return {
+                    success: false,
+                    error: res.error ?? res.errorMessage,
+                    errorMessage: res.errorMessage ?? 'deBridge quote failed',
+                };
+            }
+            return {
+                success: true,
+                provider: 'debridge',
+                tx: res.tx,
+                isCrossChain: false,
+                srcChainId,
+                dstChainId: srcChainId,
+                raw: res,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error,
+                errorMessage: error instanceof Error ? error.message : 'Failed to fetch quote',
+            };
+        }
+    }
+    async checkApproval(params) {
+        const contractAddress = params.quoteData?.tx?.to;
+        if (!contractAddress) {
+            return { isNeeded: false, error: 'No contract address found in quote' };
+        }
+        // On-chain allowance check is intentionally left to the caller — the agent
+        // core has no signer/RPC client wired in. Surface what the caller needs.
+        return {
+            isNeeded: true,
+            integrated: false,
+            contractAddress,
+            message: 'deBridge requires a separate allowance check against tx.to before executing the swap.',
+        };
+    }
+    async executeSwap(params) {
+        const { quoteData } = params;
+        return {
+            success: true,
+            provider: 'debridge',
+            txData: quoteData.tx ?? undefined,
+            estimation: quoteData.estimation,
+        };
+    }
+    async trackTransaction(params) {
+        const { requestIdOrTxHash } = params;
+        try {
+            const orderInfo = await this.get(`${this.apiBaseUrl}/dln/tx/${requestIdOrTxHash}/order-ids`, { accesstoken: this.accessToken });
+            if (!orderInfo.orderIds?.length) {
+                return { success: false, status: 'PENDING' };
+            }
+            const orderId = orderInfo.orderIds[0];
+            const orderStatusRes = await this.get(`${this.apiBaseUrl}/dln/order/${orderId}/status`, {
+                accesstoken: this.accessToken,
+            });
+            const status = (orderStatusRes.status ?? '').toUpperCase();
+            switch (status) {
+                case 'FULFILLED':
+                case 'SENTUNLOCK':
+                case 'CLAIMEDUNLOCK':
+                    return { success: true, status: 'COMPLETED' };
+                case 'ORDERCANCELLED':
+                case 'SENTORDERCANCEL':
+                case 'CLAIMEDORDERCANCEL':
+                    return { success: true, status: 'FAILED' };
+                default:
+                    return { success: true, status: 'PENDING' };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                status: 'ERROR',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async get(url, query) {
+        const qs = Object.entries(query)
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+            .join('&');
+        const fullUrl = qs ? `${url}?${qs}` : url;
+        const res = await fetch(fullUrl, {
+            method: 'GET',
+            headers: { Accept: 'application/json' },
+        });
+        return (await res.json());
+    }
+}
+exports.DebridgeAdapter = DebridgeAdapter;
+//# sourceMappingURL=DebridgeAdapter.js.map

package/dist/services/swap/DebridgeAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebridgeAdapter.js","sourceRoot":"","sources":["../../../src/services/swap/DebridgeAdapter.ts"],"names":[],"mappings":";;;AAAA,uDAAoD;AACpD,2CAA8C;AAc9C,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAE7D;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,iCAAe;IACjC,UAAU,CAAS;IACnB,WAAW,CAAS;IAErC,YAAY,SAA4B,EAAE;QACxC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,gBAAgB,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC;IAC1D,CAAC;IAED,eAAe;QACb,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,qBAAqB;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAuB;QACpC,MAAM,EACJ,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,YAAY,GACb,GAAG,MAAM,CAAC;QAEX,MAAM,UAAU,GAAG,YAAY,IAAI,UAAU,KAAK,UAAU,CAAC;QAE7D,MAAM,SAAS,GAAG,MAAM,IAAA,2BAAe,EAAC,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAoC;oBAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;oBAC9B,eAAe,EAAE,eAAe;oBAChC,qBAAqB,EAAE,cAAc;oBACrC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;oBAC9B,gBAAgB,EAAE,eAAe;oBACjC,yBAAyB,EAAE,gBAAgB;oBAC3C,6BAA6B,EAAE,aAAa;oBAC5C,6BAA6B,EAAE,gBAAgB;oBAC/C,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC;gBACF,IAAI,SAAS,EAAE,CAAC;oBACd,KAAK,CAAC,qBAAqB,GAAG,SAAS,CAAC,qBAAqB,CAAC;oBAC9D,KAAK,CAAC,mBAAmB,GAAG,SAAS,CAAC,mBAAmB,CAAC;gBAC5D,CAAC;gBAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,GAAG,IAAI,CAAC,UAAU,sBAAsB,EAAE,KAAK,CAAC,CAAC;gBAErG,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;oBAClC,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,YAAY;wBACpC,YAAY,EAAG,GAAG,CAAC,YAAuB,IAAI,uBAAuB;qBACtE,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,UAAU;oBACpB,EAAE,EAAE,GAAG,CAAC,EAA2B;oBACnC,UAAU,EAAE,GAAG,CAAC,UAAqC;oBACrD,YAAY,EAAE,IAAI;oBAClB,UAAU;oBACV,UAAU;oBACV,GAAG,EAAE,GAAG;iBACT,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAoC;gBACjD,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;gBAC3B,OAAO,EAAE,eAAe;gBACxB,aAAa,EAAE,cAAc;gBAC7B,QAAQ,EAAE,eAAe;gBACzB,iBAAiB,EAAE,gBAAgB;gBACnC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC;YACF,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,qBAAqB,GAAG,SAAS,CAAC,qBAAqB,CAAC;gBAClE,SAAS,CAAC,mBAAmB,GAAG,SAAS,CAAC,mBAAmB,CAAC;YAChE,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS;gBAAE,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAE1D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,GAAG,IAAI,CAAC,UAAU,oBAAoB,EAAE,SAAS,CAAC,CAAC;YAEvG,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,YAAY;oBACpC,YAAY,EAAG,GAAG,CAAC,YAAuB,IAAI,uBAAuB;iBACtE,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,UAAU;gBACpB,EAAE,EAAE,GAAG,CAAC,EAA2B;gBACnC,YAAY,EAAE,KAAK;gBACnB,UAAU;gBACV,UAAU,EAAE,UAAU;gBACtB,GAAG,EAAE,GAAG;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK;gBACL,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;aAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,MAAM,eAAe,GAAI,MAAM,CAAC,SAAS,EAAE,EAAkC,EAAE,EAAE,CAAC;QAElF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QAC1E,CAAC;QAED,2EAA2E;QAC3E,yEAAyE;QACzE,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,eAAe;YACf,OAAO,EAAE,uFAAuF;SACjG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,SAAS;YACjC,UAAU,EAAE,SAAS,CAAC,UAAU;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAA8B;QACnD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAC9B,GAAG,IAAI,CAAC,UAAU,WAAW,iBAAiB,YAAY,EAC1D,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAClC,CAAC;YAEF,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/C,CAAC;YAED,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,GAAG,CAAsB,GAAG,IAAI,CAAC,UAAU,cAAc,OAAO,SAAS,EAAE;gBAC3G,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,WAAW,CAAC;gBACjB,KAAK,YAAY,CAAC;gBAClB,KAAK,eAAe;oBAClB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBAChD,KAAK,gBAAgB,CAAC;gBACtB,KAAK,iBAAiB,CAAC;gBACvB,KAAK,oBAAoB;oBACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAC7C;oBACE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAsC;QACtE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5E,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YAC/B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;CACF;AAlMD,0CAkMC"}

package/dist/services/swap/RelayAdapter.d.ts

@@ -0,0 +1,19 @@
+import { BaseSwapService } from './BaseSwapService';
+import type { CheckApprovalParams, CheckApprovalResult, ExecuteSwapParams, ExecuteSwapResult, ProviderName, SwapQuoteParams, SwapQuoteResult, SwapServiceConfig, TrackTransactionParams, TrackTransactionResult } from './types';
+/**
+ * Relay.link adapter. Relay bundles approval + swap into a single quote (one
+ * "approve" step + one "swap"/"deposit" step), so `hasIntegratedApproval` is true.
+ */
+export declare class RelayAdapter extends BaseSwapService {
+    private readonly apiBaseUrl;
+    private readonly apiKey?;
+    constructor(config?: SwapServiceConfig);
+    getProviderName(): ProviderName;
+    hasIntegratedApproval(): boolean;
+    getQuote(params: SwapQuoteParams): Promise<SwapQuoteResult>;
+    checkApproval(params: CheckApprovalParams): Promise<CheckApprovalResult>;
+    executeSwap(params: ExecuteSwapParams): Promise<ExecuteSwapResult>;
+    trackTransaction(params: TrackTransactionParams): Promise<TrackTransactionResult>;
+    private request;
+}
+//# sourceMappingURL=RelayAdapter.d.ts.map

package/dist/services/swap/RelayAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelayAdapter.d.ts","sourceRoot":"","sources":["../../../src/services/swap/RelayAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAuCjB;;;GAGG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,GAAE,iBAAsB;IAM1C,eAAe,IAAI,YAAY;IAI/B,qBAAqB,IAAI,OAAO;IAI1B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiG3D,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqBxE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBlE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAuBzE,OAAO;CAuBtB"}

package/dist/services/swap/RelayAdapter.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayAdapter = void 0;
+const BaseSwapService_1 = require("./BaseSwapService");
+const affiliate_1 = require("./affiliate");
+const DEFAULT_BASE_URL = 'https://api.relay.link';
+/** Relay uses its own Solana chain id; keep this mapping isolated to the adapter. */
+function convertChainId(chainId) {
+    if (chainId === 7565164 || chainId === '7565164')
+        return 792703809;
+    return chainId;
+}
+/**
+ * Relay.link adapter. Relay bundles approval + swap into a single quote (one
+ * "approve" step + one "swap"/"deposit" step), so `hasIntegratedApproval` is true.
+ */
+class RelayAdapter extends BaseSwapService_1.BaseSwapService {
+    apiBaseUrl;
+    apiKey;
+    constructor(config = {}) {
+        super(config);
+        this.apiBaseUrl = config.apiBaseUrl ?? DEFAULT_BASE_URL;
+        this.apiKey = config.apiKey;
+    }
+    getProviderName() {
+        return 'relay';
+    }
+    hasIntegratedApproval() {
+        return true;
+    }
+    async getQuote(params) {
+        const { srcChainId, srcTokenAddress, srcTokenAmount, dstChainId, dstTokenAddress, recipientAddress, senderAddress, slippage, } = params;
+        const affiliate = await (0, affiliate_1.getAffiliateFee)(this.getProviderName(), srcChainId);
+        const body = {
+            user: recipientAddress || senderAddress,
+            originChainId: convertChainId(srcChainId),
+            destinationChainId: convertChainId(dstChainId),
+            originCurrency: srcTokenAddress,
+            destinationCurrency: dstTokenAddress,
+            amount: srcTokenAmount,
+            recipient: recipientAddress || senderAddress,
+            tradeType: 'EXACT_INPUT',
+        };
+        if (affiliate) {
+            body.appFees = [
+                {
+                    recipient: affiliate.affiliateFeeRecipient,
+                    fee: Math.floor(affiliate.affiliateFeePercent * 100),
+                },
+            ];
+        }
+        if (typeof slippage === 'number' && Number.isFinite(slippage)) {
+            body.slippageTolerance = Math.floor(slippage * 100).toString();
+        }
+        // slippage === 'auto' (or undefined): omit the field, Relay applies its server-side default.
+        try {
+            const res = await this.request('/quote/v2', 'POST', body);
+            if (!res || res.error) {
+                return {
+                    success: false,
+                    error: res?.error ?? 'Unknown error',
+                    errorMessage: res?.message ?? 'Failed to fetch quote from Relay',
+                };
+            }
+            const approveStep = res.steps?.find((s) => s.id === 'approve');
+            const swapStep = res.steps?.find((s) => s.id === 'swap' || s.id === 'deposit');
+            const swapTxData = swapStep?.items?.[0]?.data;
+            const isSolanaTx = Array.isArray(swapTxData?.instructions);
+            const tx = swapTxData
+                ? isSolanaTx
+                    ? {
+                        data: {
+                            instructions: swapTxData.instructions ?? [],
+                            addressLookupTableAddresses: swapTxData.addressLookupTableAddresses ?? [],
+                        },
+                        chainId: swapTxData.chainId,
+                    }
+                    : {
+                        from: swapTxData.from,
+                        to: swapTxData.to,
+                        data: swapTxData.data,
+                        value: swapTxData.value,
+                        chainId: swapTxData.chainId,
+                        maxFeePerGas: swapTxData.maxFeePerGas,
+                        maxPriorityFeePerGas: swapTxData.maxPriorityFeePerGas,
+                    }
+                : null;
+            return {
+                success: true,
+                provider: 'relay',
+                tx,
+                isCrossChain: srcChainId !== dstChainId,
+                srcChainId,
+                dstChainId,
+                raw: {
+                    steps: res.steps,
+                    fees: res.fees,
+                    details: res.details,
+                    approveStep,
+                    requestId: swapStep?.requestId,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error,
+                errorMessage: error instanceof Error ? error.message : 'Failed to fetch quote',
+            };
+        }
+    }
+    async checkApproval(params) {
+        const approveStep = params.quoteData?.raw?.approveStep;
+        if (approveStep) {
+            const approvalTxData = approveStep.items?.[0]?.data;
+            return {
+                isNeeded: true,
+                integrated: true,
+                approvalData: approvalTxData,
+                contractAddress: approvalTxData?.to,
+                message: 'Approval step is included in quote and will be executed first.',
+            };
+        }
+        return {
+            isNeeded: false,
+            integrated: true,
+            message: 'No approval needed or already approved',
+        };
+    }
+    async executeSwap(params) {
+        const { quoteData } = params;
+        const raw = quoteData.raw;
+        if (!raw?.steps) {
+            return { success: false, error: 'Invalid quote data' };
+        }
+        return {
+            success: true,
+            provider: 'relay',
+            steps: raw.steps,
+            estimation: quoteData.estimation,
+        };
+    }
+    async trackTransaction(params) {
+        try {
+            const res = await this.request('/intents/status/v3', 'GET', {
+                requestId: params.requestIdOrTxHash,
+            });
+            const status = res.status ?? '';
+            if (status === 'success' || status === 'refunded') {
+                return { success: true, status: 'COMPLETED' };
+            }
+            if (status === 'failure' || status === 'expired') {
+                return { success: true, status: 'FAILED' };
+            }
+            return { success: true, status: 'PENDING' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                status: 'ERROR',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async request(endpoint, method, payload) {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey)
+            headers['x-api-key'] = this.apiKey;
+        let url = `${this.apiBaseUrl}${endpoint}`;
+        const init = { method, headers };
+        if (method === 'GET' && payload) {
+            const qs = Object.entries(payload)
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+                .join('&');
+            url = `${url}?${qs}`;
+        }
+        else if (method === 'POST' && payload) {
+            init.body = JSON.stringify(payload);
+        }
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            const errorData = (await response.json().catch(() => ({})));
+            throw new Error(errorData.message ?? `HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+}
+exports.RelayAdapter = RelayAdapter;
+//# sourceMappingURL=RelayAdapter.js.map

package/dist/services/swap/RelayAdapter.js.map

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

package/dist/services/swap/SwapServiceFactory.d.ts

@@ -0,0 +1,24 @@
+import type { BaseSwapService } from './BaseSwapService';
+import type { ExchangeProviderConfig, ProviderName } from './types';
+/**
+ * Picks the right swap adapter based on the source chain.
+ *
+ * Resolution: query the exchange settings API's `bridgeProviderByChain` map.
+ * Falls back to `DEFAULT_PROVIDER` when the API is unreachable or the chain
+ * has no mapping. Adapter instances are cached per provider name.
+ */
+export declare class SwapServiceFactory {
+    private readonly providerConfig;
+    private readonly isProduction;
+    private readonly cache;
+    constructor(providerConfig?: ExchangeProviderConfig, isProduction?: boolean);
+    getService(srcChainId?: number | string | null): Promise<BaseSwapService>;
+    getActiveProvider(srcChainId?: number | string | null): Promise<ProviderName>;
+    isProviderActive(name: ProviderName, srcChainId?: number | string | null): Promise<boolean>;
+    getAvailableProviders(): ProviderName[];
+    clearCache(): void;
+    private createService;
+}
+/** Default singleton. */
+export declare const swapServiceFactory: SwapServiceFactory;
+//# sourceMappingURL=SwapServiceFactory.d.ts.map

package/dist/services/swap/SwapServiceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapServiceFactory.d.ts","sourceRoot":"","sources":["../../../src/services/swap/SwapServiceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAWpE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;gBAEtD,cAAc,GAAE,sBAA6C,EAAE,YAAY,UAAO;IAKxF,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAUzE,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAO7E,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjG,qBAAqB,IAAI,YAAY,EAAE;IAIvC,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,aAAa;CAatB;AAED,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/services/swap/SwapServiceFactory.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swapServiceFactory = exports.SwapServiceFactory = void 0;
+const DebridgeAdapter_1 = require("./DebridgeAdapter");
+const RelayAdapter_1 = require("./RelayAdapter");
+const affiliate_1 = require("./affiliate");
+const config_1 = require("./config");
+const SOLANA_CHAIN_ID = 7565164;
+function normalizeChainId(chainId) {
+    if (chainId === null || chainId === undefined)
+        return null;
+    if (chainId === 'solana' || chainId === 'SOLANA')
+        return SOLANA_CHAIN_ID;
+    const n = typeof chainId === 'number' ? chainId : Number(chainId);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Picks the right swap adapter based on the source chain.
+ *
+ * Resolution: query the exchange settings API's `bridgeProviderByChain` map.
+ * Falls back to `DEFAULT_PROVIDER` when the API is unreachable or the chain
+ * has no mapping. Adapter instances are cached per provider name.
+ */
+class SwapServiceFactory {
+    providerConfig;
+    isProduction;
+    cache = new Map();
+    constructor(providerConfig = config_1.SWAP_PROVIDER_CONFIG, isProduction = true) {
+        this.providerConfig = providerConfig;
+        this.isProduction = isProduction;
+    }
+    async getService(srcChainId) {
+        const provider = await this.getActiveProvider(srcChainId);
+        const cached = this.cache.get(provider);
+        if (cached)
+            return cached;
+        const service = this.createService(provider);
+        this.cache.set(provider, service);
+        return service;
+    }
+    async getActiveProvider(srcChainId) {
+        const src = normalizeChainId(srcChainId);
+        if (src === null)
+            return config_1.DEFAULT_PROVIDER;
+        const mapped = await (0, affiliate_1.getProviderByChain)(src, this.isProduction);
+        return mapped ?? config_1.DEFAULT_PROVIDER;
+    }
+    async isProviderActive(name, srcChainId) {
+        return (await this.getActiveProvider(srcChainId)) === name;
+    }
+    getAvailableProviders() {
+        return Object.keys(this.providerConfig);
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    createService(name) {
+        const cfg = this.providerConfig[name] ?? {};
+        switch (name) {
+            case 'debridge':
+                return new DebridgeAdapter_1.DebridgeAdapter(cfg);
+            case 'relay':
+                return new RelayAdapter_1.RelayAdapter(cfg);
+            default: {
+                const exhaustive = name;
+                throw new Error(`Unknown swap provider: ${String(exhaustive)}`);
+            }
+        }
+    }
+}
+exports.SwapServiceFactory = SwapServiceFactory;
+/** Default singleton. */
+exports.swapServiceFactory = new SwapServiceFactory();
+//# sourceMappingURL=SwapServiceFactory.js.map

package/dist/services/swap/SwapServiceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapServiceFactory.js","sourceRoot":"","sources":["../../../src/services/swap/SwapServiceFactory.ts"],"names":[],"mappings":";;;AACA,uDAAoD;AACpD,iDAA8C;AAC9C,2CAAiD;AACjD,qCAAkE;AAGlE,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,SAAS,gBAAgB,CAAC,OAA2C;IACnE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC;IACzE,MAAM,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAa,kBAAkB;IACZ,cAAc,CAAyB;IACvC,YAAY,CAAU;IACtB,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IAElE,YAAY,iBAAyC,6BAAoB,EAAE,YAAY,GAAG,IAAI;QAC5F,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAmC;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAAmC;QACzD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,yBAAgB,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAChE,OAAO,MAAM,IAAI,yBAAgB,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAkB,EAAE,UAAmC;QAC5E,OAAO,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7D,CAAC;IAED,qBAAqB;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAmB,CAAC;IAC5D,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEO,aAAa,CAAC,IAAkB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU;gBACb,OAAO,IAAI,iCAAe,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,OAAO;gBACV,OAAO,IAAI,2BAAY,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,UAAU,GAAU,IAAI,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;CACF;AApDD,gDAoDC;AAED,yBAAyB;AACZ,QAAA,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/services/swap/addresses.d.ts

@@ -0,0 +1,3 @@
+export declare function getGatewayAddress(chainId: string, isProduction: boolean): Promise<string | undefined>;
+export declare function getPositionManagerAddress(chainId: string, isProduction: boolean): Promise<string | undefined>;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/services/swap/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../src/services/swap/addresses.ts"],"names":[],"mappings":"AAmEA,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE3G;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEnH"}

package/dist/services/swap/addresses.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGatewayAddress = getGatewayAddress;
+exports.getPositionManagerAddress = getPositionManagerAddress;
+const PROD_URL = 'https://api.coinpool.app/config/addresses';
+const DEV_URL = 'https://coinpool-api-op.bacoor-test001.xyz/config/addresses';
+const cache = {
+    prod: null,
+    dev: null,
+};
+const pending = {
+    prod: null,
+    dev: null,
+};
+async function fetchAddresses(isProduction) {
+    const key = isProduction ? 'prod' : 'dev';
+    if (cache[key])
+        return cache[key];
+    if (pending[key])
+        return pending[key];
+    const url = isProduction ? PROD_URL : DEV_URL;
+    pending[key] = (async () => {
+        try {
+            const res = await fetch(url, {
+                method: 'GET',
+                headers: { Accept: 'application/json' },
+            });
+            const json = (await res.json());
+            cache[key] = json?.data ?? null;
+            return cache[key];
+        }
+        catch {
+            return null;
+        }
+        finally {
+            pending[key] = null;
+        }
+    })();
+    return pending[key];
+}
+/** Normalize a hex chain id ("0x2105") or decimal string to a decimal string key. */
+function toDecimalChainKey(chainId) {
+    const trimmed = chainId.trim();
+    if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {
+        const n = Number.parseInt(trimmed, 16);
+        return Number.isFinite(n) ? String(n) : null;
+    }
+    return /^\d+$/.test(trimmed) ? trimmed : null;
+}
+async function getAddressFor(key, chainId, isProduction) {
+    const data = await fetchAddresses(isProduction);
+    if (!data)
+        return undefined;
+    const decimal = toDecimalChainKey(chainId);
+    if (!decimal)
+        return undefined;
+    const entry = data[key]?.[decimal];
+    if (Array.isArray(entry))
+        return entry[0];
+    return typeof entry === 'string' ? entry : undefined;
+}
+async function getGatewayAddress(chainId, isProduction) {
+    return getAddressFor('createPoolProxyV3', chainId, isProduction);
+}
+async function getPositionManagerAddress(chainId, isProduction) {
+    return getAddressFor('nftPositionUniswap', chainId, isProduction);
+}
+//# sourceMappingURL=addresses.js.map

package/dist/services/swap/addresses.js.map

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

package/dist/services/swap/affiliate.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderName } from './types';
+export interface AffiliateFee {
+    affiliateFeeRecipient: string;
+    affiliateFeePercent: number;
+}
+/**
+ * Returns the active provider for `chainId` from the coinpool config API, or
+ * `null` when the API is unreachable or the chain has no mapping (caller should
+ * fall back to a default).
+ */
+export declare function getProviderByChain(chainId: number | string, isProduction: boolean): Promise<ProviderName | null>;
+/**
+ * Returns the affiliate fee tuple for the given provider+chain, or `null` when
+ * no fee should be attached (missing recipient or percent <= 0).
+ */
+export declare function getAffiliateFee(provider: ProviderName, chainId: number | string): Promise<AffiliateFee | null>;
+//# sourceMappingURL=affiliate.d.ts.map

package/dist/services/swap/affiliate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"affiliate.d.ts","sourceRoot":"","sources":["../../../src/services/swap/affiliate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAqB5C,MAAM,WAAW,YAAY;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAyFD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI9B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqBpH"}