@terkoizmy/intent-sdk 1.0.0

package/dist/solver/protocols/aggregators/swing.js

@@ -0,0 +1,212 @@
+/**
+ * Swing Protocol Integration — Phase D (Live Integration)
+ *
+ * DEX/Bridge aggregator integration using Swing.xyz API.
+ * Provides quoting and transaction building for cross-chain inventory rebalancing.
+ *
+ * Phase D changes vs Phase I:
+ * - FetchHttpClient now handles HTTP 429 (rate limit) and 401 (auth) errors gracefully
+ * - Added getTokens(chainId) for on-chain token discovery from Swing API
+ * - quote() validates real Swing API v0 response shape more strictly
+ */
+import { BaseProtocol } from "../base-protocol";
+// ---------------------------------------------------------------------------
+// HTTP Client
+// ---------------------------------------------------------------------------
+export class SwingAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SwingAuthError";
+    }
+}
+export class SwingRateLimitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SwingRateLimitError";
+    }
+}
+/** Default Fetch-based HTTP Client with Phase D error handling */
+export class FetchHttpClient {
+    maxRetries;
+    constructor(maxRetries = 1) {
+        this.maxRetries = maxRetries;
+    }
+    async handleResponse(res, retryFn, attempt) {
+        if (res.status === 401) {
+            throw new SwingAuthError("Swing API key is invalid or missing. Please ensure your SWING_API_KEY is properly set.");
+        }
+        if (res.status === 429) {
+            if (attempt <= this.maxRetries) {
+                const retryAfter = res.headers.get("Retry-After");
+                const waitMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 2000;
+                console.warn(`[Swing] Rate limited (429). Retrying after ${waitMs}ms...`);
+                await new Promise(resolve => setTimeout(resolve, waitMs));
+                return retryFn();
+            }
+            throw new SwingRateLimitError("Swing API rate limit exceeded after maximum retries.");
+        }
+        if (!res.ok) {
+            let body = "";
+            try {
+                body = await res.text();
+            }
+            catch (e) { }
+            throw new Error(`HTTP Request failed: ${res.status} ${res.statusText} - ${body}`);
+        }
+        return res.json();
+    }
+    async get(url, headers, attempt = 1) {
+        const res = await fetch(url, { method: "GET", headers });
+        return this.handleResponse(res, () => this.get(url, headers, attempt + 1), attempt);
+    }
+    async post(url, body, headers, attempt = 1) {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...headers },
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(res, () => this.post(url, body, headers, attempt + 1), attempt);
+    }
+}
+// ---------------------------------------------------------------------------
+// SwingProtocol
+// ---------------------------------------------------------------------------
+export class SwingProtocol extends BaseProtocol {
+    apiKey;
+    httpClient;
+    baseUrl;
+    name = "swing";
+    type = "bridge";
+    // Currently supported common chains (1 = ETH, 137 = Polygon, 42161 = Arbitrum)
+    supportedChains = [1, 137, 42161, 10, 8453];
+    constructor(apiKey, httpClient = new FetchHttpClient(), baseUrl = "https://swap.prod.swing.xyz/v0") {
+        super();
+        this.apiKey = apiKey;
+        this.httpClient = httpClient;
+        this.baseUrl = baseUrl;
+    }
+    get headers() {
+        return {
+            "Accept": "application/json",
+            "x-swing-api-key": this.apiKey,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // getTokens (NEW — Phase D)
+    // -------------------------------------------------------------------------
+    /**
+     * Fetch the list of tokens supported by Swing for a given chain.
+     */
+    async getTokens(chainId) {
+        const url = `${this.baseUrl}/tokens?chain=${chainId}`;
+        try {
+            const data = await this.httpClient.get(url, this.headers);
+            // Note: Swing often returns an array directly, but sometimes it might be `{ tokens: [] }`
+            // Let's handle both dynamically
+            const items = Array.isArray(data) ? data : data.tokens;
+            if (!Array.isArray(items)) {
+                throw new Error(`Invalid response format from Swing tokens API for chain ${chainId}`);
+            }
+            return items.map((t) => ({
+                symbol: t.symbol,
+                address: t.address,
+                decimals: t.decimals,
+                name: t.name,
+                chainId: chainId,
+            }));
+        }
+        catch (error) {
+            if (error instanceof SwingAuthError || error instanceof SwingRateLimitError) {
+                throw error;
+            }
+            throw new Error(`Failed to fetch tokens for chain ${chainId}: ${error.message}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // quote
+    // -------------------------------------------------------------------------
+    /**
+     * Get a cross-chain quote from Swing API.
+     */
+    async quote(params) {
+        const url = new URL(`${this.baseUrl}/transfer/quote`);
+        url.searchParams.append("fromChain", params.fromChain.toString());
+        url.searchParams.append("toChain", params.toChain.toString());
+        url.searchParams.append("fromToken", params.token);
+        url.searchParams.append("toToken", params.token);
+        url.searchParams.append("amount", params.amount.toString());
+        const data = await this.httpClient.get(url.toString(), this.headers);
+        // Validate response shape
+        if (!data.routes || data.routes.length === 0) {
+            throw new Error("No bridge routes found by Swing");
+        }
+        if (data.routes.length > 1) {
+            console.info(`[SwingProtocol] ${data.routes.length} routes available, using best route`);
+        }
+        const route = data.routes[0];
+        // Defensive: validate nested shape before accessing
+        if (!route?.quote?.integration) {
+            throw new Error("Swing API returned malformed route data (missing quote.integration)");
+        }
+        return {
+            inputAmount: params.amount,
+            outputAmount: BigInt(route.quote.integration.amountOut || "0"),
+            fee: BigInt(route.quote.integration.fee || "0"),
+            estimatedTimeMs: (route.quote.integration.estimatedTime || 0) * 1000,
+            priceImpact: route.quote.integration.priceImpact || 0,
+            protocolName: this.name,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // buildTransaction
+    // -------------------------------------------------------------------------
+    /**
+     * Build the raw transaction (calldata) for the quoted route.
+     * Swing API typically returns the raw tx params we need to sign.
+     */
+    async buildTransaction(quote, params) {
+        const body = {
+            fromChain: params.fromChain.toString(),
+            toChain: params.toChain.toString(),
+            fromToken: params.token,
+            toToken: params.token,
+            amount: params.amount.toString(),
+            fromUserAddress: params.recipient || "0x", // Required by Swing to build calldata
+            toUserAddress: params.recipient || "0x",
+            route: [
+                {
+                    bridge: quote.protocolName, // Mock logic, usually from quote ID
+                }
+            ]
+        };
+        const data = await this.httpClient.post(`${this.baseUrl}/transfer/send`, body, this.headers);
+        if (!data.tx) {
+            throw new Error("Swing API did not return transaction data");
+        }
+        return [
+            {
+                to: data.tx.to,
+                data: data.tx.data,
+                value: data.tx.value || "0",
+                chainId: params.fromChain,
+                gasLimit: data.tx.gas || "3000000",
+            }
+        ];
+    }
+    // -------------------------------------------------------------------------
+    // getTransferStatus
+    // -------------------------------------------------------------------------
+    /**
+     * Get the status of an ongoing bridge transfer.
+     */
+    async getTransferStatus(transferId) {
+        const data = await this.httpClient.get(`${this.baseUrl}/transfer/status/${transferId}`, this.headers);
+        const statusStr = data.status?.toLowerCase();
+        if (statusStr === "success" || statusStr === "done")
+            return "done";
+        if (statusStr === "failed" || statusStr === "error")
+            return "failed";
+        return "pending";
+    }
+}
+//# sourceMappingURL=swing.js.map

package/dist/solver/protocols/aggregators/swing.js.map

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

package/dist/solver/protocols/base-protocol.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base Protocol — Phase I
+ *
+ * Abstract base class for all protocol integrations (Swing, Aave, etc.).
+ * Provides uniform interface for the Rebalancer and other modules
+ * to interact with heterogeneous protocols.
+ */
+import type { Transaction } from "../types/execution";
+export type ProtocolType = "bridge" | "lending" | "dex";
+export interface ProtocolQuote {
+    inputAmount: bigint;
+    outputAmount: bigint;
+    fee: bigint;
+    estimatedTimeMs: number;
+    priceImpact?: number;
+    protocolName: string;
+}
+export interface QuoteParams {
+    fromChain: number;
+    toChain: number;
+    token: string;
+    amount: bigint;
+    recipient?: string;
+}
+export declare abstract class BaseProtocol {
+    abstract readonly name: string;
+    abstract readonly type: ProtocolType;
+    abstract readonly supportedChains: number[];
+    /**
+     * Check if the protocol supports a given chainId.
+     */
+    supports(chainId: number): boolean;
+    /**
+     * Get a price/route quote. Implementation depends on protocol type.
+     */
+    abstract quote(params: QuoteParams): Promise<ProtocolQuote>;
+    /**
+     * Build one or more transactions to execute the quoted action.
+     */
+    abstract buildTransaction(quote: ProtocolQuote, params: QuoteParams): Promise<Transaction[]>;
+}
+//# sourceMappingURL=base-protocol.d.ts.map

package/dist/solver/protocols/base-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-protocol.d.ts","sourceRoot":"","sources":["../../../src/solver/protocols/base-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAAsB,YAAY;IAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAC/F"}

package/dist/solver/protocols/base-protocol.js

@@ -0,0 +1,16 @@
+/**
+ * Base Protocol — Phase I
+ *
+ * Abstract base class for all protocol integrations (Swing, Aave, etc.).
+ * Provides uniform interface for the Rebalancer and other modules
+ * to interact with heterogeneous protocols.
+ */
+export class BaseProtocol {
+    /**
+     * Check if the protocol supports a given chainId.
+     */
+    supports(chainId) {
+        return this.supportedChains.includes(chainId);
+    }
+}
+//# sourceMappingURL=base-protocol.js.map

package/dist/solver/protocols/base-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-protocol.js","sourceRoot":"","sources":["../../../src/solver/protocols/base-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,OAAgB,YAAY;IAK9B;;OAEG;IACH,QAAQ,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;CAWJ"}

package/dist/solver/protocols/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Protocols Module — Phase I
+ *
+ * Exporting all protocol integrations and registry.
+ */
+export * from "./base-protocol";
+export * from "./protocol-registry";
+export * from "./aggregators/swing";
+export * from "./lending/aave";
+//# sourceMappingURL=index.d.ts.map

package/dist/solver/protocols/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solver/protocols/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/solver/protocols/index.js

@@ -0,0 +1,10 @@
+/**
+ * Protocols Module — Phase I
+ *
+ * Exporting all protocol integrations and registry.
+ */
+export * from "./base-protocol";
+export * from "./protocol-registry";
+export * from "./aggregators/swing";
+export * from "./lending/aave";
+//# sourceMappingURL=index.js.map

package/dist/solver/protocols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/solver/protocols/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/solver/protocols/lending/aave.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Aave Protocol Integration — Phase I
+ *
+ * Lending protocol integration.
+ * Allows depositing idle inventory into Aave to earn APY, and withdrawing it
+ * when needed to fulfill intents.
+ */
+import { BaseProtocol, type ProtocolType, type ProtocolQuote, type QuoteParams } from "../base-protocol";
+import type { Transaction } from "../../types/execution";
+import type { RPCProviderManager } from "../../../shared/rpc/provider-manager";
+import type { Address } from "../../../types/common";
+export declare class AaveProtocol extends BaseProtocol {
+    /** Used for on-chain getReserveData calls to fetch APY */
+    private readonly rpcProviderManager;
+    /** Map of chainId -> Aave Pool contract address */
+    private readonly poolAddress;
+    /** Map of chainId -> Aave PoolDataProvider contract address */
+    private readonly dataProviderAddress;
+    readonly name = "aave";
+    readonly type: ProtocolType;
+    readonly supportedChains: number[];
+    constructor(
+    /** Used for on-chain getReserveData calls to fetch APY */
+    rpcProviderManager: RPCProviderManager, 
+    /** Map of chainId -> Aave Pool contract address */
+    poolAddress: Record<number, Address>, 
+    /** Map of chainId -> Aave PoolDataProvider contract address */
+    dataProviderAddress: Record<number, Address>);
+    /**
+     * Check if chain is supported and configured.
+     */
+    supports(chainId: number): boolean;
+    /**
+     * Aave supply is 1:1, fee is just gas.
+     */
+    quote(params: QuoteParams): Promise<ProtocolQuote>;
+    /**
+     * Build supply transaction(s).
+     * Retrieves two transactions: ERC-20 Approve + Aave supply()
+     */
+    buildTransaction(quote: ProtocolQuote, params: QuoteParams): Promise<Transaction[]>;
+    /**
+     * Query the current APY for supplying a specific token on a chain.
+     */
+    getAPY(token: string, chainId: number): Promise<number>;
+    /**
+     * Helper to build a withdraw transaction.
+     */
+    buildWithdraw(token: string, amount: bigint, chainId: number, toAddress: string): Promise<Transaction>;
+}
+//# sourceMappingURL=aave.d.ts.map

package/dist/solver/protocols/lending/aave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.d.ts","sourceRoot":"","sources":["../../../../src/solver/protocols/lending/aave.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA4BrD,qBAAa,YAAa,SAAQ,YAAY;IAMtC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAVxC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAa;IACxC,QAAQ,CAAC,eAAe,WAAmB;;IAGvC,0DAA0D;IACzC,kBAAkB,EAAE,kBAAkB;IACvD,mDAAmD;IAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,+DAA+D;IAC9C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKjE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAWxD;;;OAGG;IACG,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmCzF;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwD7D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAkB/G"}

package/dist/solver/protocols/lending/aave.js

@@ -0,0 +1,172 @@
+/**
+ * Aave Protocol Integration — Phase I
+ *
+ * Lending protocol integration.
+ * Allows depositing idle inventory into Aave to earn APY, and withdrawing it
+ * when needed to fulfill intents.
+ */
+import { BaseProtocol } from "../base-protocol";
+import { decodeFunctionResult } from "viem";
+const ERC20_APPROVE_SIG = "0x095ea7b3"; // approve(address,uint256)
+const AAVE_SUPPLY_SIG = "0x617ba037"; // supply(address,uint256,address,uint16)
+const AAVE_WITHDRAW_SIG = "0x69328dec"; // withdraw(address,uint256,address)
+const AAVE_DATA_PROVIDER_ABI = [{
+        "inputs": [{ "internalType": "address", "name": "asset", "type": "address" }],
+        "name": "getReserveData",
+        "outputs": [
+            { "internalType": "uint256", "name": "unbacked", "type": "uint256" },
+            { "internalType": "uint256", "name": "accruedToTreasuryScaled", "type": "uint256" },
+            { "internalType": "uint256", "name": "totalAToken", "type": "uint256" },
+            { "internalType": "uint256", "name": "totalStableDebt", "type": "uint256" },
+            { "internalType": "uint256", "name": "totalVariableDebt", "type": "uint256" },
+            { "internalType": "uint256", "name": "liquidityRate", "type": "uint256" },
+            { "internalType": "uint256", "name": "variableBorrowRate", "type": "uint256" },
+            { "internalType": "uint256", "name": "stableBorrowRate", "type": "uint256" },
+            { "internalType": "uint256", "name": "averageStableBorrowRate", "type": "uint256" },
+            { "internalType": "uint256", "name": "liquidityIndex", "type": "uint256" },
+            { "internalType": "uint256", "name": "variableBorrowIndex", "type": "uint256" },
+            { "internalType": "uint40", "name": "lastUpdateTimestamp", "type": "uint40" }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    }];
+export class AaveProtocol extends BaseProtocol {
+    rpcProviderManager;
+    poolAddress;
+    dataProviderAddress;
+    name = "aave";
+    type = "lending";
+    supportedChains = [1, 137, 42161]; // Aave v3 networks
+    constructor(
+    /** Used for on-chain getReserveData calls to fetch APY */
+    rpcProviderManager, 
+    /** Map of chainId -> Aave Pool contract address */
+    poolAddress, 
+    /** Map of chainId -> Aave PoolDataProvider contract address */
+    dataProviderAddress) {
+        super();
+        this.rpcProviderManager = rpcProviderManager;
+        this.poolAddress = poolAddress;
+        this.dataProviderAddress = dataProviderAddress;
+    }
+    /**
+     * Check if chain is supported and configured.
+     */
+    supports(chainId) {
+        return this.supportedChains.includes(chainId) && !!this.poolAddress[chainId] && !!this.dataProviderAddress[chainId];
+    }
+    /**
+     * Aave supply is 1:1, fee is just gas.
+     */
+    async quote(params) {
+        return {
+            inputAmount: params.amount,
+            outputAmount: params.amount,
+            fee: 0n, // Protocol fee is 0, user pays gas when executing Tx
+            estimatedTimeMs: 15_000,
+            priceImpact: 0,
+            protocolName: this.name,
+        };
+    }
+    /**
+     * Build supply transaction(s).
+     * Retrieves two transactions: ERC-20 Approve + Aave supply()
+     */
+    async buildTransaction(quote, params) {
+        const chainId = params.fromChain;
+        const pool = this.poolAddress[chainId];
+        if (!pool)
+            throw new Error(`Aave not configured for chain ${chainId}`);
+        // Mocking ABI encoding for simplicity. In prod use ethers.Interface
+        const paddedAmt = params.amount.toString(16).padStart(64, "0");
+        const paddedPool = pool.replace("0x", "").padStart(64, "0");
+        const approveData = `${ERC20_APPROVE_SIG}${paddedPool}${paddedAmt}`;
+        const paddedAsset = params.token.replace("0x", "").padStart(64, "0");
+        const paddedOnBehalfOf = (params.recipient || "0x0000000000000000000000000000000000000000").replace("0x", "").padStart(64, "0");
+        const paddedReferral = "0".padStart(64, "0");
+        const supplyData = `${AAVE_SUPPLY_SIG}${paddedAsset}${paddedAmt}${paddedOnBehalfOf}${paddedReferral}`;
+        return [
+            {
+                to: params.token, // Target the ERC20 contract
+                data: approveData,
+                value: "0",
+                chainId,
+                gasLimit: "50000",
+            },
+            {
+                to: pool, // Target the Aave Pool
+                data: supplyData,
+                value: "0",
+                chainId,
+                gasLimit: "250000",
+            }
+        ];
+    }
+    /**
+     * Query the current APY for supplying a specific token on a chain.
+     */
+    async getAPY(token, chainId) {
+        if (!this.supports(chainId)) {
+            throw new Error(`Aave not supported/configured for chain ${chainId}`);
+        }
+        const dataProvider = this.dataProviderAddress[chainId];
+        const provider = this.rpcProviderManager.getProvider(chainId);
+        // Function signature: getReserveData(address asset) -> 0x35ea6a75
+        const functionSelector = "0x35ea6a75";
+        const paddedToken = token.toLowerCase().replace("0x", "").padStart(64, "0");
+        const calldata = `${functionSelector}${paddedToken}`;
+        try {
+            const result = await provider.call(dataProvider, calldata);
+            if (!result || result === "0x") {
+                // Token has no reserve data on Aave for this chain
+                throw new Error("Empty response from Aave Data Provider — probably unsupported token");
+            }
+            // Decode the massive tuple using viem
+            const decoded = decodeFunctionResult({
+                abi: AAVE_DATA_PROVIDER_ABI,
+                functionName: "getReserveData",
+                data: result,
+            });
+            // decoded is an array (or object if named) of the tuple. 
+            // the 6th element (index 5) is liquidityRate (APR in ray) as per ABI outputs.
+            const liquidityRateRay = BigInt(decoded[5]);
+            if (liquidityRateRay === 0n)
+                return 0; // No liquidity
+            // Convert liquidityRate (APR in ray) to APY
+            const RAY = 1e27;
+            const SECONDS_PER_YEAR = 31536000;
+            const depositAPR = Number(liquidityRateRay) / RAY;
+            // Compound interest formula: APY = (1 + APR / SECONDS_PER_YEAR) ^ SECONDS_PER_YEAR - 1
+            const apy = (Math.pow(1 + depositAPR / SECONDS_PER_YEAR, SECONDS_PER_YEAR) - 1) * 100;
+            return apy;
+        }
+        catch (error) {
+            if (error.message.includes("execution reverted")) {
+                // Aave PoolDataProvider reverts if the token is not an active reserve
+                return 0;
+            }
+            console.error(`[Aave] Failed to fetch APY for ${token} on chain ${chainId}:`, error.message);
+            throw new Error(`Failed to fetch APY from Aave: ${error.message}`);
+        }
+    }
+    /**
+     * Helper to build a withdraw transaction.
+     */
+    async buildWithdraw(token, amount, chainId, toAddress) {
+        const pool = this.poolAddress[chainId];
+        if (!pool)
+            throw new Error(`Aave not configured for chain ${chainId}`);
+        const paddedAsset = token.replace("0x", "").padStart(64, "0");
+        const paddedAmt = amount.toString(16).padStart(64, "0");
+        const paddedTo = toAddress.replace("0x", "").padStart(64, "0");
+        const withdrawData = `${AAVE_WITHDRAW_SIG}${paddedAsset}${paddedAmt}${paddedTo}`;
+        return {
+            to: pool,
+            data: withdrawData,
+            value: "0",
+            chainId,
+            gasLimit: "250000",
+        };
+    }
+}
+//# sourceMappingURL=aave.js.map

package/dist/solver/protocols/lending/aave.js.map

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

package/dist/solver/protocols/protocol-registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Protocol Registry — Phase I
+ *
+ * Central registry for looking up available protocol integrations.
+ * Used by the Rebalancer to find the best available bridge for a given route.
+ */
+import { BaseProtocol, type ProtocolType } from "./base-protocol";
+export declare class ProtocolRegistry {
+    private protocols;
+    /**
+     * Register a new protocol instance.
+     */
+    register(protocol: BaseProtocol): void;
+    /**
+     * Get a protocol by its unique name.
+     */
+    get(name: string): BaseProtocol | undefined;
+    /**
+     * Get all registered protocols, optionally filtered by type.
+     */
+    getAll(type?: ProtocolType): BaseProtocol[];
+    /**
+     * Find the first bridge protocol that supports both the source and target chains.
+     * Uses registration order as implicit priority.
+     */
+    getBestBridge(fromChain: number, toChain: number): BaseProtocol | undefined;
+}
+//# sourceMappingURL=protocol-registry.d.ts.map

package/dist/solver/protocols/protocol-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-registry.d.ts","sourceRoot":"","sources":["../../../src/solver/protocols/protocol-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAElE,qBAAa,gBAAgB;IACzB,OAAO,CAAC,SAAS,CAAwC;IAEzD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE;IAQ3C;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAI9E"}

package/dist/solver/protocols/protocol-registry.js

@@ -0,0 +1,40 @@
+/**
+ * Protocol Registry — Phase I
+ *
+ * Central registry for looking up available protocol integrations.
+ * Used by the Rebalancer to find the best available bridge for a given route.
+ */
+export class ProtocolRegistry {
+    protocols = new Map();
+    /**
+     * Register a new protocol instance.
+     */
+    register(protocol) {
+        this.protocols.set(protocol.name, protocol);
+    }
+    /**
+     * Get a protocol by its unique name.
+     */
+    get(name) {
+        return this.protocols.get(name);
+    }
+    /**
+     * Get all registered protocols, optionally filtered by type.
+     */
+    getAll(type) {
+        const all = Array.from(this.protocols.values());
+        if (type) {
+            return all.filter((p) => p.type === type);
+        }
+        return all;
+    }
+    /**
+     * Find the first bridge protocol that supports both the source and target chains.
+     * Uses registration order as implicit priority.
+     */
+    getBestBridge(fromChain, toChain) {
+        const bridges = this.getAll("bridge");
+        return bridges.find((b) => b.supports(fromChain) && b.supports(toChain));
+    }
+}
+//# sourceMappingURL=protocol-registry.js.map

package/dist/solver/protocols/protocol-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-registry.js","sourceRoot":"","sources":["../../../src/solver/protocols/protocol-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,gBAAgB;IACjB,SAAS,GAA8B,IAAI,GAAG,EAAE,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,QAAsB;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAmB;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAAiB,EAAE,OAAe;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC;CACJ"}

package/dist/solver/settlement/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Settlement Module — Barrel Export
+ */
+export * from "./proof-generator";
+export * from "./proof-verifier";
+export * from "./settlement-manager";
+//# sourceMappingURL=index.d.ts.map