@avail-project/ca-common 2.0.0 → 2.2.0

package/dist/cjs/evmabi/fibrousrouter.abi.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FibrousRouterABI = void 0;
+exports.FibrousRouterABI = [
+    {
+        inputs: [
+            {
+                components: [
+                    { internalType: "address", name: "token_in", type: "address" },
+                    { internalType: "address", name: "token_out", type: "address" },
+                    { internalType: "uint256", name: "amount_in", type: "uint256" },
+                    { internalType: "uint256", name: "amount_out", type: "uint256" },
+                    { internalType: "uint256", name: "min_received", type: "uint256" },
+                    { internalType: "address", name: "destination", type: "address" },
+                    { internalType: "uint8", name: "swap_type", type: "uint8" },
+                ],
+                internalType: "struct IFibrousRouter.RouteParam",
+                name: "route",
+                type: "tuple",
+            },
+            {
+                components: [
+                    { internalType: "address", name: "token_in", type: "address" },
+                    { internalType: "address", name: "token_out", type: "address" },
+                    { internalType: "uint32", name: "rate", type: "uint32" },
+                    { internalType: "int24", name: "protocol_id", type: "int24" },
+                    { internalType: "address", name: "pool_address", type: "address" },
+                    { internalType: "uint8", name: "swap_type", type: "uint8" },
+                    { internalType: "bytes", name: "extra_data", type: "bytes" },
+                ],
+                internalType: "struct IFibrousRouter.SwapParams[]",
+                name: "swap_parameters",
+                type: "tuple[]",
+            },
+        ],
+        name: "swap",
+        outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+        stateMutability: "payable",
+        type: "function",
+    },
+];

package/dist/cjs/evmabi/index.js

@@ -4,3 +4,4 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./erc20.abi"), exports);
 tslib_1.__exportStar(require("./vault.abi"), exports);
 tslib_1.__exportStar(require("./yakaggregator.abi"), exports);
+tslib_1.__exportStar(require("./fibrousrouter.abi"), exports);

package/dist/cjs/proto/definition.js

@@ -5,7 +5,8 @@
 //   protoc               v6.32.1
 // source: definition.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MsgDoubleCheckTx = exports.FillVEPacket = exports.DepositVEPacket = exports.MsgRefundReqResponse = exports.MsgRefundReq = exports.QueryGetPriceOracleDataResponse = exports.QueryGetPriceOracleDataRequest = exports.PriceOracleData = exports.PriceOracleDatum = exports.MsgUpdateProtocolFeesResponse = exports.MsgUpdateProtocolFees = exports.MsgCreateProtocolFeesResponse = exports.MsgCreateProtocolFees = exports.QueryGetProtocolFeesResponse = exports.QueryGetProtocolFeesRequest = exports.ProtocolFees = exports.AdminFeeRecipient = exports.FixedFeeTuple = exports.QueryRequestForFundsByAddressRequest = exports.QueryAllSettlementResponse = exports.QueryAllSettlementRequest = exports.QueryGetSettlementResponse = exports.QueryGetSettlementRequest = exports.Settlement = exports.MsgUpdateSolverDataResponse = exports.MsgUpdateSolverData = exports.MsgCreateSolverDataResponse = exports.MsgCreateSolverData = exports.QueryAllSolverDataResponse = exports.QueryAllSolverDataRequest = exports.QueryGetSolverDataResponse = exports.QueryGetSolverDataRequest = exports.SolverData = exports.SolverAddress = exports.RouteFee = exports.QueryAllRequestForFundsResponse = exports.QueryAllRequestForFundsRequest = exports.QueryGetRequestForFundsResponse = exports.QueryGetRequestForFundsRequest = exports.MsgCreateRequestForFundsResponse = exports.MsgCreateRequestForFunds = exports.RequestForFunds = exports.RFFDestinationPair = exports.SignatureDatum = exports.RFFSourcePair = exports.PageResponse = exports.PageRequest = exports.Universe = exports.RFFSourceState = exports.protobufPackage = void 0;
+exports.FillVEPacket = exports.DepositVEPacket = exports.MsgRefundReqResponse = exports.MsgRefundReq = exports.QueryGetPriceOracleDataResponse = exports.QueryGetPriceOracleDataRequest = exports.PriceOracleData = exports.PriceOracleDatum = exports.MsgUpdateProtocolFeesResponse = exports.MsgUpdateProtocolFees = exports.MsgCreateProtocolFeesResponse = exports.MsgCreateProtocolFees = exports.QueryGetProtocolFeesResponse = exports.QueryGetProtocolFeesRequest = exports.ProtocolFees = exports.PerChainFeeBP = exports.AdminFeeRecipient = exports.FixedFeeTuple = exports.QueryRequestForFundsByAddressRequest = exports.QueryAllSettlementResponse = exports.QueryAllSettlementRequest = exports.QueryGetSettlementResponse = exports.QueryGetSettlementRequest = exports.Settlement = exports.MsgUpdateSolverDataResponse = exports.MsgUpdateSolverData = exports.MsgCreateSolverDataResponse = exports.MsgCreateSolverData = exports.QueryAllSolverDataResponse = exports.QueryAllSolverDataRequest = exports.QueryGetSolverDataResponse = exports.QueryGetSolverDataRequest = exports.SolverData = exports.SolverAddress = exports.RouteFee = exports.QueryAllRequestForFundsResponse = exports.QueryAllRequestForFundsRequest = exports.QueryGetRequestForFundsResponse = exports.QueryGetRequestForFundsRequest = exports.MsgCreateRequestForFundsResponse = exports.MsgCreateRequestForFunds = exports.RequestForFunds = exports.RFFDestinationPair = exports.SignatureDatum = exports.RFFSourcePair = exports.PageResponse = exports.PageRequest = exports.Universe = exports.RFFSourceState = exports.protobufPackage = void 0;
+exports.MsgDoubleCheckTx = void 0;
 exports.rFFSourceStateFromJSON = rFFSourceStateFromJSON;
 exports.rFFSourceStateToJSON = rFFSourceStateToJSON;
 exports.universeFromJSON = universeFromJSON;
@@ -2779,8 +2780,91 @@ exports.AdminFeeRecipient = {
         return message;
     },
 };
+function createBasePerChainFeeBP() {
+    return { universe: 0, chainID: new Uint8Array(0), feeBP: long_1.default.UZERO };
+}
+exports.PerChainFeeBP = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.universe !== 0) {
+            writer.uint32(8).int32(message.universe);
+        }
+        if (message.chainID.length !== 0) {
+            writer.uint32(18).bytes(message.chainID);
+        }
+        if (!message.feeBP.equals(long_1.default.UZERO)) {
+            writer.uint32(24).uint64(message.feeBP.toString());
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBasePerChainFeeBP();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.universe = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.chainID = reader.bytes();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.feeBP = long_1.default.fromString(reader.uint64().toString(), true);
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            universe: isSet(object.universe) ? universeFromJSON(object.universe) : 0,
+            chainID: isSet(object.chainID) ? bytesFromBase64(object.chainID) : new Uint8Array(0),
+            feeBP: isSet(object.feeBP) ? long_1.default.fromValue(object.feeBP) : long_1.default.UZERO,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.universe !== 0) {
+            obj.universe = universeToJSON(message.universe);
+        }
+        if (message.chainID.length !== 0) {
+            obj.chainID = base64FromBytes(message.chainID);
+        }
+        if (!message.feeBP.equals(long_1.default.UZERO)) {
+            obj.feeBP = (message.feeBP || long_1.default.UZERO).toString();
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.PerChainFeeBP.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBasePerChainFeeBP();
+        message.universe = object.universe ?? 0;
+        message.chainID = object.chainID ?? new Uint8Array(0);
+        message.feeBP = (object.feeBP !== undefined && object.feeBP !== null) ? long_1.default.fromValue(object.feeBP) : long_1.default.UZERO;
+        return message;
+    },
+};
 function createBaseProtocolFees() {
-    return { feeBP: long_1.default.UZERO, collectionFees: [], fulfilmentFees: [], admin: "", feeRecipients: [] };
+    return { feeBP: long_1.default.UZERO, collectionFees: [], fulfilmentFees: [], admin: "", feeRecipients: [], perChainFeeBP: [] };
 }
 exports.ProtocolFees = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -2799,6 +2883,9 @@ exports.ProtocolFees = {
         for (const v of message.feeRecipients) {
             exports.AdminFeeRecipient.encode(v, writer.uint32(42).fork()).join();
         }
+        for (const v of message.perChainFeeBP) {
+            exports.PerChainFeeBP.encode(v, writer.uint32(50).fork()).join();
+        }
         return writer;
     },
     decode(input, length) {
@@ -2843,6 +2930,13 @@ exports.ProtocolFees = {
                     message.feeRecipients.push(exports.AdminFeeRecipient.decode(reader, reader.uint32()));
                     continue;
                 }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.perChainFeeBP.push(exports.PerChainFeeBP.decode(reader, reader.uint32()));
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -2864,6 +2958,9 @@ exports.ProtocolFees = {
             feeRecipients: globalThis.Array.isArray(object?.feeRecipients)
                 ? object.feeRecipients.map((e) => exports.AdminFeeRecipient.fromJSON(e))
                 : [],
+            perChainFeeBP: globalThis.Array.isArray(object?.perChainFeeBP)
+                ? object.perChainFeeBP.map((e) => exports.PerChainFeeBP.fromJSON(e))
+                : [],
         };
     },
     toJSON(message) {
@@ -2883,6 +2980,9 @@ exports.ProtocolFees = {
         if (message.feeRecipients?.length) {
             obj.feeRecipients = message.feeRecipients.map((e) => exports.AdminFeeRecipient.toJSON(e));
         }
+        if (message.perChainFeeBP?.length) {
+            obj.perChainFeeBP = message.perChainFeeBP.map((e) => exports.PerChainFeeBP.toJSON(e));
+        }
         return obj;
     },
     create(base) {
@@ -2895,6 +2995,7 @@ exports.ProtocolFees = {
         message.fulfilmentFees = object.fulfilmentFees?.map((e) => exports.FixedFeeTuple.fromPartial(e)) || [];
         message.admin = object.admin ?? "";
         message.feeRecipients = object.feeRecipients?.map((e) => exports.AdminFeeRecipient.fromPartial(e)) || [];
+        message.perChainFeeBP = object.perChainFeeBP?.map((e) => exports.PerChainFeeBP.fromPartial(e)) || [];
         return message;
     },
 };
@@ -2989,7 +3090,14 @@ exports.QueryGetProtocolFeesResponse = {
     },
 };
 function createBaseMsgCreateProtocolFees() {
-    return { creator: "", feeBP: long_1.default.UZERO, collectionFees: [], fulfilmentFees: [], feeRecipients: [] };
+    return {
+        creator: "",
+        feeBP: long_1.default.UZERO,
+        collectionFees: [],
+        fulfilmentFees: [],
+        feeRecipients: [],
+        perChainFeeBP: [],
+    };
 }
 exports.MsgCreateProtocolFees = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -3008,6 +3116,9 @@ exports.MsgCreateProtocolFees = {
         for (const v of message.feeRecipients) {
             exports.AdminFeeRecipient.encode(v, writer.uint32(42).fork()).join();
         }
+        for (const v of message.perChainFeeBP) {
+            exports.PerChainFeeBP.encode(v, writer.uint32(50).fork()).join();
+        }
         return writer;
     },
     decode(input, length) {
@@ -3052,6 +3163,13 @@ exports.MsgCreateProtocolFees = {
                     message.feeRecipients.push(exports.AdminFeeRecipient.decode(reader, reader.uint32()));
                     continue;
                 }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.perChainFeeBP.push(exports.PerChainFeeBP.decode(reader, reader.uint32()));
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -3073,6 +3191,9 @@ exports.MsgCreateProtocolFees = {
             feeRecipients: globalThis.Array.isArray(object?.feeRecipients)
                 ? object.feeRecipients.map((e) => exports.AdminFeeRecipient.fromJSON(e))
                 : [],
+            perChainFeeBP: globalThis.Array.isArray(object?.perChainFeeBP)
+                ? object.perChainFeeBP.map((e) => exports.PerChainFeeBP.fromJSON(e))
+                : [],
         };
     },
     toJSON(message) {
@@ -3092,6 +3213,9 @@ exports.MsgCreateProtocolFees = {
         if (message.feeRecipients?.length) {
             obj.feeRecipients = message.feeRecipients.map((e) => exports.AdminFeeRecipient.toJSON(e));
         }
+        if (message.perChainFeeBP?.length) {
+            obj.perChainFeeBP = message.perChainFeeBP.map((e) => exports.PerChainFeeBP.toJSON(e));
+        }
         return obj;
     },
     create(base) {
@@ -3104,6 +3228,7 @@ exports.MsgCreateProtocolFees = {
         message.collectionFees = object.collectionFees?.map((e) => exports.FixedFeeTuple.fromPartial(e)) || [];
         message.fulfilmentFees = object.fulfilmentFees?.map((e) => exports.FixedFeeTuple.fromPartial(e)) || [];
         message.feeRecipients = object.feeRecipients?.map((e) => exports.AdminFeeRecipient.fromPartial(e)) || [];
+        message.perChainFeeBP = object.perChainFeeBP?.map((e) => exports.PerChainFeeBP.fromPartial(e)) || [];
         return message;
     },
 };
@@ -3145,7 +3270,14 @@ exports.MsgCreateProtocolFeesResponse = {
     },
 };
 function createBaseMsgUpdateProtocolFees() {
-    return { creator: "", feeBP: long_1.default.UZERO, collectionFees: [], fulfilmentFees: [], feeRecipients: [] };
+    return {
+        creator: "",
+        feeBP: long_1.default.UZERO,
+        collectionFees: [],
+        fulfilmentFees: [],
+        feeRecipients: [],
+        perChainFeeBP: [],
+    };
 }
 exports.MsgUpdateProtocolFees = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -3164,6 +3296,9 @@ exports.MsgUpdateProtocolFees = {
         for (const v of message.feeRecipients) {
             exports.AdminFeeRecipient.encode(v, writer.uint32(42).fork()).join();
         }
+        for (const v of message.perChainFeeBP) {
+            exports.PerChainFeeBP.encode(v, writer.uint32(50).fork()).join();
+        }
         return writer;
     },
     decode(input, length) {
@@ -3208,6 +3343,13 @@ exports.MsgUpdateProtocolFees = {
                     message.feeRecipients.push(exports.AdminFeeRecipient.decode(reader, reader.uint32()));
                     continue;
                 }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.perChainFeeBP.push(exports.PerChainFeeBP.decode(reader, reader.uint32()));
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -3229,6 +3371,9 @@ exports.MsgUpdateProtocolFees = {
             feeRecipients: globalThis.Array.isArray(object?.feeRecipients)
                 ? object.feeRecipients.map((e) => exports.AdminFeeRecipient.fromJSON(e))
                 : [],
+            perChainFeeBP: globalThis.Array.isArray(object?.perChainFeeBP)
+                ? object.perChainFeeBP.map((e) => exports.PerChainFeeBP.fromJSON(e))
+                : [],
         };
     },
     toJSON(message) {
@@ -3248,6 +3393,9 @@ exports.MsgUpdateProtocolFees = {
         if (message.feeRecipients?.length) {
             obj.feeRecipients = message.feeRecipients.map((e) => exports.AdminFeeRecipient.toJSON(e));
         }
+        if (message.perChainFeeBP?.length) {
+            obj.perChainFeeBP = message.perChainFeeBP.map((e) => exports.PerChainFeeBP.toJSON(e));
+        }
         return obj;
     },
     create(base) {
@@ -3260,6 +3408,7 @@ exports.MsgUpdateProtocolFees = {
         message.collectionFees = object.collectionFees?.map((e) => exports.FixedFeeTuple.fromPartial(e)) || [];
         message.fulfilmentFees = object.fulfilmentFees?.map((e) => exports.FixedFeeTuple.fromPartial(e)) || [];
         message.feeRecipients = object.feeRecipients?.map((e) => exports.AdminFeeRecipient.fromPartial(e)) || [];
+        message.perChainFeeBP = object.perChainFeeBP?.map((e) => exports.PerChainFeeBP.fromPartial(e)) || [];
         return message;
     },
 };

package/dist/cjs/xcs/autochoice.js

@@ -3,9 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutoSelectionError = void 0;
 exports.aggregateAggregators = aggregateAggregators;
 exports.autoSelectSourcesV2 = autoSelectSourcesV2;
+exports.autoSelectSourcesV2ByRecipient = autoSelectSourcesV2ByRecipient;
 exports.determineDestinationSwaps = determineDestinationSwaps;
 exports.liquidateInputHoldings = liquidateInputHoldings;
+exports.liquidateInputHoldingsByRecipient = liquidateInputHoldingsByRecipient;
 exports.destinationSwapWithExactIn = destinationSwapWithExactIn;
+exports.getDestinationExactOutSwap = getDestinationExactOutSwap;
+exports.getDestinationExactInSwap = getDestinationExactInSwap;
+exports.liquidateSourceHoldings = liquidateSourceHoldings;
+exports.autoSelectSources = autoSelectSources;
 const tslib_1 = require("tslib");
 const es_toolkit_1 = require("es-toolkit");
 const viem_1 = require("viem");
@@ -108,7 +114,18 @@ cots = [(1 COT, 1), (1 COT, 4)]
     break
 5. return quotes and assets used.
 */
+/**
+ * @deprecated Use {@link autoSelectSources} (object args; per-holding `takerAddress` and
+ * `receiverAddress` on each `HoldingWithSwapAddresses`).
+ */
 async function autoSelectSourcesV2(userAddress, holdings, outputRequired, aggregators, commonCurrencyID = data_1.CurrencyID.USDC) {
+    return autoSelectSourcesV2ByRecipient(holdings.map((holding) => ({ ...holding, recipient: userAddress })), outputRequired, aggregators, commonCurrencyID);
+}
+/**
+ * @deprecated Use {@link autoSelectSources} (object args; per-holding `takerAddress` and
+ * `receiverAddress` on each `HoldingWithSwapAddresses`).
+ */
+async function autoSelectSourcesV2ByRecipient(holdings, outputRequired, aggregators, commonCurrencyID = data_1.CurrencyID.USDC) {
     // Assumption: Holding is already sorted in usage priority
     console.debug("XCS | SSV2:", {
         holdings,
@@ -142,7 +159,10 @@ async function autoSelectSourcesV2(userAddress, holdings, outputRequired, aggreg
         else {
             fullLiquidationQuotes.push({
                 req: {
-                    userAddress,
+                    userAddress: holding.recipient,
+                    // New wrappers thread per-holding receiver via this field. Falls back to taker
+                    // (`recipient`) when absent — preserves legacy positional-call behavior.
+                    receiverAddress: holding.receiverAddress,
                     type: iface_1.QuoteType.EXACT_IN,
                     chain: chain.ChainID,
                     inputToken: holding.tokenAddress,
@@ -326,7 +346,11 @@ async function autoSelectSourcesV2(userAddress, holdings, outputRequired, aggreg
     console.log("final_quotes", { quotes: final, cots: usedCOTs });
     return { quoteResponses: final, usedCOTs };
 }
-async function determineDestinationSwaps(userAddress, requirement, aggregators, commonCurrencyID = data_1.CurrencyID.USDC) {
+/**
+ * @deprecated Use {@link getDestinationExactOutSwap} (object args; explicit `takerAddress` and
+ * `receiverAddress`, both required).
+ */
+async function determineDestinationSwaps(userAddress, requirement, aggregators, commonCurrencyID = data_1.CurrencyID.USDC, receiverAddress) {
     const chaindata = data_1.ChaindataMap.get(requirement.chainID);
     if (chaindata == null) {
         throw new AutoSelectionError("Chain not found");
@@ -341,6 +365,7 @@ async function determineDestinationSwaps(userAddress, requirement, aggregators,
         type: iface_1.QuoteType.EXACT_IN,
         chain: requirement.chainID,
         userAddress,
+        receiverAddress,
         inputToken: requirement.tokenAddress,
         outputToken: COT.tokenAddress,
         inputAmount: requirement.amountRaw,
@@ -364,6 +389,7 @@ async function determineDestinationSwaps(userAddress, requirement, aggregators,
             {
                 type: iface_1.QuoteType.EXACT_IN,
                 userAddress,
+                receiverAddress,
                 chain: requirement.chainID,
                 inputToken: COT.tokenAddress,
                 outputToken: requirement.tokenAddress,
@@ -395,7 +421,18 @@ async function determineDestinationSwaps(userAddress, requirement, aggregators,
         }
     }
 }
-async function liquidateInputHoldings(userAddress, holdings, aggregators, commonCurrencyID = data_1.CurrencyID.USDC) {
+/**
+ * @deprecated Use {@link liquidateSourceHoldings} (object args; per-holding `takerAddress`
+ * and `receiverAddress` on each `HoldingWithSwapAddresses`).
+ */
+async function liquidateInputHoldings(userAddress, holdings, aggregators, commonCurrencyID = data_1.CurrencyID.USDC, receiverAddress) {
+    return liquidateInputHoldingsByRecipient(holdings.map((holding) => ({ ...holding, recipient: userAddress })), aggregators, commonCurrencyID, receiverAddress);
+}
+/**
+ * @deprecated Use {@link liquidateSourceHoldings} (object args; per-holding `takerAddress`
+ * and `receiverAddress` on each `HoldingWithSwapAddresses`).
+ */
+async function liquidateInputHoldingsByRecipient(holdings, aggregators, commonCurrencyID = data_1.CurrencyID.USDC, receiverAddress) {
     console.debug("XCS | LIH | Holdings:", holdings);
     const groupedByChainID = (0, es_toolkit_1.groupBy)(holdings, (h) => (0, viem_1.bytesToHex)(h.chainID.toBytes()));
     const fullLiquidationQuotes = [];
@@ -419,7 +456,10 @@ async function liquidateInputHoldings(userAddress, holdings, aggregators, common
             }
             fullLiquidationQuotes.push({
                 req: {
-                    userAddress,
+                    userAddress: holding.recipient,
+                    // Per-holding receiver wins (set by the new wrappers); shared param is the legacy
+                    // positional-call fallback.
+                    receiverAddress: holding.receiverAddress ?? receiverAddress,
                     type: iface_1.QuoteType.EXACT_IN,
                     chain: chain.ChainID,
                     inputToken: holding.tokenAddress,
@@ -448,7 +488,11 @@ async function liquidateInputHoldings(userAddress, holdings, aggregators, common
     }
     return quotes;
 }
-async function destinationSwapWithExactIn(userAddress, omniChainID, inputAmount, outputToken, aggregators, inputCurrency = data_1.CurrencyID.USDC) {
+/**
+ * @deprecated Use {@link getDestinationExactInSwap} (object args; explicit `takerAddress`
+ * and `receiverAddress`, both required).
+ */
+async function destinationSwapWithExactIn(userAddress, omniChainID, inputAmount, outputToken, aggregators, inputCurrency = data_1.CurrencyID.USDC, receiverAddress) {
     const chaindata = data_1.ChaindataMap.get(omniChainID);
     if (chaindata == null) {
         throw new AutoSelectionError("Chain not found");
@@ -462,6 +506,7 @@ async function destinationSwapWithExactIn(userAddress, omniChainID, inputAmount,
             type: iface_1.QuoteType.EXACT_IN,
             chain: omniChainID,
             userAddress,
+            receiverAddress,
             inputToken: COT.tokenAddress,
             outputToken: outputToken,
             inputAmount: inputAmount,
@@ -486,3 +531,40 @@ async function destinationSwapWithExactIn(userAddress, omniChainID, inputAmount,
         },
     };
 }
+// =====================================================================================
+// Object-arg wrappers around the legacy positional functions above.
+//
+// Aggregator vocabulary:
+//   takerAddress    — on-chain executor of the swap (drives aggregator simulation /
+//                     permit / approval routing). On 7702 chains this is the ephemeral; on
+//                     non-Pectra chains it's the deployed Safe. Maps to the underlying
+//                     QuoteRequest's `userAddress`.
+//   receiverAddress — recipient of the swap output. Maps to the underlying QuoteRequest's
+//                     `receiverAddress`. Required on all 4 wrappers — the GS013-class bug we
+//                     fixed came from forgetting this and silently defaulting to the wrong
+//                     address. Even on source side (where it equals the taker today), require
+//                     it explicitly so the type system forces every call site to acknowledge
+//                     both roles.
+//
+// Wrap-only: each wrapper delegates to the deprecated positional fn. No business logic added.
+// =====================================================================================
+async function getDestinationExactOutSwap(args) {
+    return determineDestinationSwaps(args.takerAddress, args.requirement, args.aggregators, args.commonCurrencyID, args.receiverAddress);
+}
+async function getDestinationExactInSwap(args) {
+    return destinationSwapWithExactIn(args.takerAddress, args.chain, args.inputAmount, args.outputToken, args.aggregators, args.inputCurrency, args.receiverAddress);
+}
+async function liquidateSourceHoldings(args) {
+    return liquidateInputHoldingsByRecipient(args.holdings.map((h) => ({
+        ...h,
+        recipient: h.takerAddress,
+        receiverAddress: h.receiverAddress,
+    })), args.aggregators, args.commonCurrencyID);
+}
+async function autoSelectSources(args) {
+    return autoSelectSourcesV2ByRecipient(args.holdings.map((h) => ({
+        ...h,
+        recipient: h.takerAddress,
+        receiverAddress: h.receiverAddress,
+    })), args.outputRequired, args.aggregators, args.commonCurrencyID);
+}

package/dist/cjs/xcs/bebop-agg.js

@@ -14,17 +14,11 @@ const ChainNameMapping = new Map(Object.entries({
     arbitrum: 42161,
     optimism: 10,
     base: 8453,
-    taiko: 167000,
     bsc: 56,
-    monadtestnet: 10143,
-    megaethtestnet: 6342,
-    berachain: 80094,
+    avalanche: 43114,
     polygon: 137,
-    zksync: 324,
-    blast: 81457,
-    mode: 34443,
     scroll: 534352,
-    superseed: 5330,
+    hyperevm: 999,
 }).map(([k, v]) => [(0, viem_1.bytesToHex)((0, data_1.encodeChainID36)(definition_1.Universe.ETHEREUM, v)), k]));
 class BebopAggregator {
     static BASE_URL = "https://api.bebop.xyz/router";
@@ -56,6 +50,9 @@ class BebopAggregator {
             const inputTokenAddr = (0, viem_1.getAddress)((0, viem_1.bytesToHex)(r.inputToken.subarray(12)));
             const outputTokenAddr = (0, viem_1.getAddress)((0, viem_1.bytesToHex)(r.outputToken.subarray(12)));
             const userAddrHex = (0, viem_1.getAddress)((0, viem_1.bytesToHex)(r.userAddress.subarray(12)));
+            const receiverAddrHex = r.receiverAddress != null
+                ? (0, viem_1.getAddress)((0, viem_1.bytesToHex)(r.receiverAddress.subarray(12)))
+                : userAddrHex;
             switch (r.type) {
                 case iface_1.QuoteType.EXACT_IN: {
                     respPromise = this.axios({
@@ -65,6 +62,7 @@ class BebopAggregator {
                             sell_tokens: inputTokenAddr,
                             buy_tokens: outputTokenAddr,
                             taker_address: userAddrHex,
+                            receiver_address: receiverAddrHex,
                             sell_amounts: r.inputAmount.toString(),
                             ...BebopAggregator.COMMON_OPTIONS,
                         },
@@ -79,6 +77,7 @@ class BebopAggregator {
                             sell_tokens: inputTokenAddr,
                             buy_tokens: outputTokenAddr,
                             taker_address: userAddrHex,
+                            receiver_address: receiverAddrHex,
                             buy_amounts: r.outputAmount.toString(),
                             ...BebopAggregator.COMMON_OPTIONS,
                         },