@gibs/bridge-sdk 1.18.0 → 1.20.0

package/dist/cjs/origin-deposit.js

@@ -1,36 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.depositFamilyOf = exports.isUnreservedDeposit = exports.isDepositAddressDeposit = exports.isHyperliquidDeposit = exports.isTonDeposit = exports.isTronDeposit = exports.isBitcoinDeposit = exports.isSolanaSerializedDeposit = exports.isSolanaInstructionsDeposit = exports.isSolanaDeposit = exports.isEvmDeposit = void 0;
-/**
- * The ecosystem whose signer a deposit needs, or null for a deposit that needs
- * no signer at all.
- *
- * THE ONE PLACE THE ECOSYSTEM TAG IS READ. A {@link DepositAddressDeposit} has
- * no `ecosystem`, so every guard below asks through this instead of reading the
- * field directly — which also means no ecosystem guard can ever answer true for
- * a deposit the reader pays by hand.
- *
- * TYPED `Ecosystem | null`, NOT `string | null`. A `string` return let a typo
- * such as `signerEcosystemOf(deposit) === 'hypvm'` compile silently — the
- * comparison is just false forever, so `isHyperliquidDeposit` would always
- * answer false and every Hyperliquid deposit would fall through to the
- * Ethereum branch. Typed on the union, the same typo fails to compile instead.
- */
 const signerEcosystemOf = (deposit) => 'ecosystem' in deposit ? deposit.ecosystem : null;
 const isEvmDeposit = (deposit) => signerEcosystemOf(deposit) === 'evm';
 exports.isEvmDeposit = isEvmDeposit;
 const isSolanaDeposit = (deposit) => signerEcosystemOf(deposit) === 'svm';
 exports.isSolanaDeposit = isSolanaDeposit;
-/**
- * Narrows a Solana deposit to the instruction form, which must be compiled
- * before it can be signed.
- */
 const isSolanaInstructionsDeposit = (deposit) => deposit.form === 'instructions';
 exports.isSolanaInstructionsDeposit = isSolanaInstructionsDeposit;
-/**
- * Narrows a Solana deposit to the pre-compiled form, which must be signed
- * as-is.
- */
 const isSolanaSerializedDeposit = (deposit) => deposit.form === 'serialized';
 exports.isSolanaSerializedDeposit = isSolanaSerializedDeposit;
 const isBitcoinDeposit = (deposit) => signerEcosystemOf(deposit) === 'bvm';
@@ -41,42 +18,9 @@ const isTonDeposit = (deposit) => signerEcosystemOf(deposit) === 'tonvm';
 exports.isTonDeposit = isTonDeposit;
 const isHyperliquidDeposit = (deposit) => signerEcosystemOf(deposit) === 'hypevm';
 exports.isHyperliquidDeposit = isHyperliquidDeposit;
-/**
- * Narrows a deposit to the pay-by-hand shape: an address, an amount, and
- * nothing to sign.
- *
- * THE GUARD EVERY EXECUTION PATH MUST ASK FIRST. A surface that falls through
- * to a signer with one of these has no transaction to give it, and a surface
- * that asks the reader to connect a wallet is asking for one that does not
- * exist for this chain.
- *
- * @param deposit - any origin deposit
- * @returns whether the reader pays this one by hand
- */
 const isDepositAddressDeposit = (deposit) => 'kind' in deposit && deposit.kind === 'deposit-address';
 exports.isDepositAddressDeposit = isDepositAddressDeposit;
-/**
- * Narrows a deposit to the priced-but-not-reserved shape: a route on display,
- * with nothing to pay until a live quote replaces it.
- *
- * @param deposit - any origin deposit
- * @returns whether the route must be quoted live before anything is paid
- */
 const isUnreservedDeposit = (deposit) => 'kind' in deposit && deposit.kind === 'unreserved';
 exports.isUnreservedDeposit = isUnreservedDeposit;
-/**
- * Names a deposit's family for a message shown to someone: its ecosystem, or
- * its `kind` for a deposit that has none — a {@link DepositAddressDeposit}
- * reads as `"deposit-address"`, an {@link UnreservedDeposit} as `"unreserved"`.
- *
- * THE ONE COPY. The same `'ecosystem' in deposit ? deposit.ecosystem :
- * deposit.kind` expression used to be written out separately in
- * `consolidated-quote.ts` and in the interface's `consolidated-execute.ts`;
- * each copy was a chance for the two to describe the same deposit
- * differently. Import this instead of restating the expression.
- *
- * @param deposit - any origin deposit
- * @returns the ecosystem name, or the deposit's `kind` when it has none
- */
 const depositFamilyOf = (deposit) => 'ecosystem' in deposit ? deposit.ecosystem : deposit.kind;
 exports.depositFamilyOf = depositFamilyOf;

package/dist/cjs/pre-quote.js

@@ -5,49 +5,14 @@ const url_1 = require("@gibs/common/url");
 const consolidated_quote_js_1 = require("./consolidated-quote.js");
 const referral_js_1 = require("./referral.js");
 const relay_quote_js_1 = require("./relay-quote.js");
-/**
- * Plain LI.FI swap quote endpoint (forward-solving), re-exported from
- * `consolidated-quote.js` rather than redeclared here — both modules must
- * agree on the same address, and a second literal would be free to drift from
- * it.
- */
 var consolidated_quote_js_2 = require("./consolidated-quote.js");
 Object.defineProperty(exports, "lifiQuoteUrl", { enumerable: true, get: function () { return consolidated_quote_js_2.lifiQuoteUrl; } });
 Object.defineProperty(exports, "lifiRequestHeaders", { enumerable: true, get: function () { return consolidated_quote_js_2.lifiRequestHeaders; } });
-/**
- * Builds the Relay EXACT_INPUT swap pre-quote body for a fixed input. NO `txs`
- * are attached: Relay solves FORWARD and reports the delivered anchor amount.
- *
- * `recipient` and `refundTo` name TWO DIFFERENT chains and must never be
- * conflated. `refundTo` is always the user's OWN origin-chain address — Relay
- * refunds a failed (or, here, never-run) swap on the origin chain, and an
- * Ethereum fallback address could not receive one there. `recipient` names
- * where the swap lands on the ENTRY chain (`toChainId`), which is always
- * Ethereum Virtual Machine — for an Ethereum origin the user's own address
- * already satisfies that and is the default; for a non-Ethereum origin
- * (Solana base58, Bitcoin bech32, ...) it does NOT, and Relay's `/quote/v2`
- * validates the recipient's FORMAT against `toChainId` even though this
- * pre-quote never executes. Sending the origin account there — as an earlier
- * version of this builder did, reasoning that an unexecuted quote's recipient
- * is "informational" — gets Relay's `400 INVALID_ADDRESS` on every
- * non-Ethereum-origin pre-quote, which starves `fetchBestEntryAnchorPreQuote`
- * of its only capable provider and surfaces as "No route available" for the
- * whole non-Ethereum-origin flow. `request.recipient` (an explicit
- * Ethereum-format address the caller supplies) is therefore REQUIRED for a
- * non-Ethereum origin; without it this returns null.
- *
- * @param request - the provider-agnostic pre-quote request
- * @returns the request body, or null when the input amount is non-positive or
- *   a non-Ethereum origin has no explicit Ethereum-format `recipient`
- */
 const buildRelayPreQuoteRequest = (request) => {
     if (request.amount <= 0n) {
         return null;
     }
     const nonEthereumOrigin = (0, consolidated_quote_js_1.isNonEthereumVirtualMachineOrigin)(request);
-    // A non-Ethereum origin's own address cannot stand in for an entry-chain
-    // recipient; it must be supplied explicitly. An Ethereum origin's own
-    // address already IS a valid entry-chain address, so it remains the default.
     const recipient = nonEthereumOrigin ? request.recipient : (request.recipient ?? request.fromAddress);
     if (recipient === undefined) {
         return null;
@@ -61,10 +26,6 @@ const buildRelayPreQuoteRequest = (request) => {
         amount: request.amount.toString(),
         tradeType: 'EXACT_INPUT',
         recipient,
-        // Relay always refunds on the ORIGIN chain, so the origin's own address
-        // is the correct refund target regardless of ecosystem — unlike
-        // `recipient` above, this one is deliberately NOT Ethereum-format for a
-        // non-Ethereum origin.
         refundTo: request.fromAddress,
         ...(0, relay_quote_js_1.relayReferrerField)(request),
         ...(request.slippage === undefined
@@ -73,17 +34,6 @@ const buildRelayPreQuoteRequest = (request) => {
     };
 };
 exports.buildRelayPreQuoteRequest = buildRelayPreQuoteRequest;
-/**
- * Builds the plain LI.FI swap pre-quote as a query string for `GET /v1/quote`.
- * LI.FI's plain `/quote` is forward-solving by construction (`fromAmount` in,
- * `estimate.toAmount` out), so no trade-type flag is needed.
- *
- * Returns null for a non-Ethereum origin (LI.FI cannot bridge across
- * virtual-machine ecosystems) and for a non-positive input amount.
- *
- * @param request - the provider-agnostic pre-quote request
- * @returns the URL query string (without a leading `?`), or null
- */
 const buildLifiPreQuoteRequest = (request) => {
     if (request.amount <= 0n) {
         return null;
@@ -91,9 +41,6 @@ const buildLifiPreQuoteRequest = (request) => {
     if ((0, consolidated_quote_js_1.isNonEthereumVirtualMachineOrigin)(request)) {
         return null;
     }
-    // Left out or `null` OMITS the query parameter (LI.FI's own schema marks it
-    // optional); a string is sent as-is. No package default: attribution is the
-    // caller's to choose. See `PreQuoteRequest.lifiIntegrator`'s doc.
     const integrator = (0, referral_js_1.resolveAttribution)(request.lifiIntegrator, undefined);
     return (0, url_1.buildQuery)({
         fromChain: request.fromChainId.toString(),
@@ -102,7 +49,6 @@ const buildLifiPreQuoteRequest = (request) => {
         toToken: request.toTokenAddress,
         fromAmount: request.amount.toString(),
         fromAddress: request.fromAddress,
-        // Each optional parameter is left out when it is undefined.
         integrator,
         slippage: request.slippage?.toString(),
     });
@@ -114,11 +60,6 @@ const asRecord = (value) => {
     }
     return value;
 };
-/**
- * Parses a decimal-string amount into a bigint.
- *
- * @returns the bigint value, or null when the input is not a parseable amount
- */
 const parseAmount = (value) => {
     if (typeof value !== 'string' || value === '') {
         return null;
@@ -130,13 +71,6 @@ const parseAmount = (value) => {
         return null;
     }
 };
-/**
- * Assembles the expected/minimum pair, defaulting the minimum to the expected
- * amount when the provider omits a guaranteed floor. Shared by both parsers so
- * the fallback rule lives in exactly one place.
- *
- * @returns the result, or null when the expected amount is absent
- */
 const toPreQuoteResult = (expected, minimum) => {
     const expectedAmount = parseAmount(expected);
     if (expectedAmount === null) {
@@ -148,13 +82,6 @@ const toPreQuoteResult = (expected, minimum) => {
         minimumAmount: minimumAmount ?? expectedAmount,
     };
 };
-/**
- * Parses a Relay EXACT_INPUT pre-quote response. The delivered anchor figures
- * live under `details.currencyOut`: `amount` (expected) and `minimumAmount`
- * (guaranteed slippage floor). Verified live against `api.relay.link/quote/v2`.
- *
- * @returns the delivered amounts, or null when the payload shape is unexpected
- */
 const parseRelayPreQuote = (payload) => {
     const currencyOut = asRecord(asRecord(asRecord(payload)?.details)?.currencyOut);
     if (!currencyOut) {
@@ -163,13 +90,6 @@ const parseRelayPreQuote = (payload) => {
     return toPreQuoteResult(currencyOut.amount, currencyOut.minimumAmount);
 };
 exports.parseRelayPreQuote = parseRelayPreQuote;
-/**
- * Parses a plain LI.FI `/quote` response. The delivered anchor figures live
- * under `estimate`: `toAmount` (expected) and `toAmountMin` (guaranteed minimum
- * after slippage) — the same estimate shape the route-step normalizer reads.
- *
- * @returns the delivered amounts, or null when the payload shape is unexpected
- */
 const parseLifiPreQuote = (payload) => {
     const estimate = asRecord(asRecord(payload)?.estimate);
     if (!estimate) {

package/dist/cjs/prices.js

@@ -3,54 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sameChainWrappedNative = exports.resolveTokenPriceUsd = exports.computeUsdPriceFromAmountsOut = exports.pulsexPricePaths = exports.pulsechainOriginAddress = exports.isPulsechain = exports.lifiPriceKey = exports.lowercaseAddress = exports.WPLS_ADDRESS = exports.PULSECHAIN_USD_ANCHOR_DECIMALS = exports.PULSECHAIN_USD_ANCHOR_ADDRESS = exports.PULSECHAIN_TESTNET_CHAIN_ID = exports.PULSECHAIN_CHAIN_ID = void 0;
 const viem_1 = require("viem");
 const config_js_1 = require("./config.js");
-/**
- * PulseChain mainnet numeric chain id (`Chains.PLS` = `0x171`). Tokens on this
- * chain (and its testnet sibling below) are priced on-chain via PulseX rather
- * than from an off-chain price feed.
- */
 exports.PULSECHAIN_CHAIN_ID = Number(config_js_1.Chains.PLS);
-/**
- * PulseChain V4 testnet numeric chain id (`Chains.V4PLS` = `0x3af`). Shares the
- * PulseX on-chain pricing path with mainnet.
- */
 exports.PULSECHAIN_TESTNET_CHAIN_ID = Number(config_js_1.Chains.V4PLS);
-/**
- * Bridged DAI on PulseChain (18 decimals) — the USD anchor stablecoin for
- * on-chain PulseX pricing. One token's `getAmountsOut` ending in this address
- * yields that token's USD price directly (DAI is treated as exactly $1).
- *
- * Kept as an exported constant so the anchor can be swapped without touching the
- * pricing math. Mirrors `DAI_ADDRESS` in `packages/tx-report/src/server/prices.ts`.
- */
 exports.PULSECHAIN_USD_ANCHOR_ADDRESS = '0xefd766ccb38eaf1dfd701853bfce31359239f305';
-/** Decimals of the {@link PULSECHAIN_USD_ANCHOR_ADDRESS} stablecoin. */
 exports.PULSECHAIN_USD_ANCHOR_DECIMALS = 18;
-/** Wrapped PLS on PulseChain — the routing intermediary for PulseX paths. */
 exports.WPLS_ADDRESS = config_js_1.nativeAssetOut[config_js_1.Chains.PLS];
-/** The native (gas) token sentinel address used across the dapp. */
 const NATIVE_TOKEN_ADDRESS = '0x0000000000000000000000000000000000000000';
-/** Lowercases an address for case-insensitive map keys and comparisons. */
 const lowercaseAddress = (address) => address.toLowerCase();
 exports.lowercaseAddress = lowercaseAddress;
-/** True when two addresses are equal ignoring case (and 0x-checksum casing). */
 const sameAddress = (left, right) => (0, exports.lowercaseAddress)(left) === (0, exports.lowercaseAddress)(right);
-/**
- * Map key for a foreign (LI.FI-priced) token: `${chainId}-${lowercased address}`.
- * Matches the key the UI builds when assembling the LI.FI price map.
- */
 const lifiPriceKey = (chainId, address) => `${chainId}-${(0, exports.lowercaseAddress)(address)}`;
 exports.lifiPriceKey = lifiPriceKey;
-/** True when a chain id is priced on-chain via PulseX (mainnet or V4 testnet). */
 const isPulsechain = (chainId) => chainId === exports.PULSECHAIN_CHAIN_ID || chainId === exports.PULSECHAIN_TESTNET_CHAIN_ID;
 exports.isPulsechain = isPulsechain;
-/**
- * The PulseChain-origin address a bridged token backs out to, when the token's
- * `extensions.bridgeInfo` records a PulseChain counterpart. Bridged tokens are
- * 1:1 with their origin, so the origin's PulseX price is the token's USD value.
- *
- * @param token - the token whose PulseChain-origin link to resolve
- * @returns the PulseChain origin address, or null when the token has no such link
- */
 const pulsechainOriginAddress = (token) => {
     const link = token.extensions?.bridgeInfo?.[exports.PULSECHAIN_CHAIN_ID];
     if (!link) {
@@ -59,22 +24,6 @@ const pulsechainOriginAddress = (token) => {
     return link.tokenAddress;
 };
 exports.pulsechainOriginAddress = pulsechainOriginAddress;
-/**
- * The set of PulseX swap paths to price one whole unit of `token` into the USD
- * anchor stablecoin. Edge cases collapse to shorter paths:
- *
- * - `token` is the stablecoin itself -> no swap needed (priced as exactly 1).
- * - `token` is WPLS (or the native zero-address) -> `[WPLS, stable]` only.
- * - otherwise -> both `[token, WPLS, stable]` and `[token, stable]`.
- *
- * Returned addresses are always concrete (the native sentinel is rewritten to
- * WPLS) so they can be fed straight into `getAmountsOut`.
- *
- * @param options.token - the token (only its address is read) to build paths for
- * @param options.wpls - the wrapped-native intermediary (defaults to {@link WPLS_ADDRESS})
- * @param options.stable - the USD anchor (defaults to {@link PULSECHAIN_USD_ANCHOR_ADDRESS})
- * @returns `{ paths }` — the candidate paths; empty when the token is the stablecoin
- */
 const pulsexPricePaths = ({ token, wpls = exports.WPLS_ADDRESS, stable = exports.PULSECHAIN_USD_ANCHOR_ADDRESS, }) => {
     const address = sameAddress(token.address, NATIVE_TOKEN_ADDRESS) ? wpls : token.address;
     if (sameAddress(address, stable)) {
@@ -91,11 +40,6 @@ const pulsexPricePaths = ({ token, wpls = exports.WPLS_ADDRESS, stable = exports
     };
 };
 exports.pulsexPricePaths = pulsexPricePaths;
-/**
- * The final output amount of one `getAmountsOut` result, or null when the call
- * failed (Hex) or returned an empty array. The last element of a `bigint[]`
- * `getAmountsOut` is the output-token amount.
- */
 const finalOutput = (result) => {
     if (typeof result === 'string') {
         return null;
@@ -105,16 +49,6 @@ const finalOutput = (result) => {
     }
     return result[result.length - 1];
 };
-/**
- * Reduces every `getAmountsOut` result (across all paths and all routers for one
- * token) to a single USD price by taking the MAX final output, then scaling out
- * of the stablecoin's decimals. Failed/empty results are dropped; when none
- * succeed the price is null (no liquidity).
- *
- * @param options.results - the `getAmountsOut` outcomes for the token's paths/routers
- * @param options.stableDecimals - decimals of the anchor (defaults to {@link PULSECHAIN_USD_ANCHOR_DECIMALS})
- * @returns the USD price as a number, or null when no path produced a value
- */
 const computeUsdPriceFromAmountsOut = ({ results, stableDecimals = exports.PULSECHAIN_USD_ANCHOR_DECIMALS, }) => {
     const outputs = results.flatMap((result) => {
         const output = finalOutput(result);
@@ -130,22 +64,6 @@ const computeUsdPriceFromAmountsOut = ({ results, stableDecimals = exports.PULSE
     return Number((0, viem_1.formatUnits)(maxOutput, stableDecimals));
 };
 exports.computeUsdPriceFromAmountsOut = computeUsdPriceFromAmountsOut;
-/**
- * Resolves a token's USD price using pre-fetched price maps, following the
- * co-designed precedence:
- *
- * 1. PulseChain (mainnet or V4 testnet): the token's own PulseX price.
- * 2. Bridged PulseChain-origin token: the origin's PulseX price (1:1 value).
- * 3. Genuinely foreign token: the LI.FI inline price.
- *
- * The stablecoin anchor itself resolves to exactly 1. All address lookups are
- * case-insensitive (maps are keyed by lowercased address).
- *
- * @param token - the token to price
- * @param options.pulsexPrices - lowercased PulseChain address -> USD price
- * @param options.lifiPrices - `${chainId}-${lowercased address}` -> USD price
- * @returns the USD price as a number, or null when no source can price it
- */
 const resolveTokenPriceUsd = (token, { pulsexPrices, lifiPrices, }) => {
     const wrappedNative = (0, exports.sameChainWrappedNative)(token);
     if (wrappedNative !== null) {
@@ -154,15 +72,6 @@ const resolveTokenPriceUsd = (token, { pulsexPrices, lifiPrices, }) => {
     return resolveOwnPriceUsd(token, { pulsexPrices, lifiPrices });
 };
 exports.resolveTokenPriceUsd = resolveTokenPriceUsd;
-/**
- * The chain's canonical wrapped native address when `token` is the native
- * coin (zero address) or that wrapper itself, and null for every other token.
- * Only the SAME chain's pair is returned: a bridged copy of a wrapper on
- * another chain is a different token and keeps its own price.
- *
- * @param token - the token to test
- * @returns the wrapped native address on the token's own chain, or null
- */
 const sameChainWrappedNative = (token) => {
     const wrapped = config_js_1.nativeAssetOut[(0, config_js_1.toChain)(token.chainId)];
     if (wrapped === undefined) {
@@ -172,22 +81,6 @@ const sameChainWrappedNative = (token) => {
     return isNativeCoin || sameAddress(token.address, wrapped) ? wrapped : null;
 };
 exports.sameChainWrappedNative = sameChainWrappedNative;
-/**
- * One price for a native coin and its canonical wrapper. The contract wraps
- * and unwraps 1:1, so two prices would show a value loss on a wrap step that
- * loses nothing.
- *
- * Off PulseChain the native coin's market feed (LI.FI) wins. The wrapper's
- * own price there is the PulseX price of its bridged copy (it carries a
- * PulseChain origin link), which is a derivative market with its own
- * premium or discount. The coin's feed prices the underlying asset. When the
- * feed has no native price, the wrapper's feed price, then its own resolved
- * price, stand in.
- *
- * On PulseChain both are priced by PulseX through the WPLS path, so the
- * wrapper's entry is used and the coin's entry stands in when the wrapper was
- * not in the priced set.
- */
 const resolveNativeFamilyPriceUsd = (token, wrappedNative, maps) => {
     const wrapped = { ...token, address: wrappedNative };
     if ((0, exports.isPulsechain)(token.chainId)) {
@@ -198,7 +91,6 @@ const resolveNativeFamilyPriceUsd = (token, wrappedNative, maps) => {
         maps.lifiPrices.get((0, exports.lifiPriceKey)(token.chainId, wrappedNative)) ??
         resolveOwnPriceUsd(wrapped, maps));
 };
-/** The token's price by its own address, with no native-wrapper pairing. */
 const resolveOwnPriceUsd = (token, { pulsexPrices, lifiPrices, }) => {
     if ((0, exports.isPulsechain)(token.chainId)) {
         if (sameAddress(token.address, exports.PULSECHAIN_USD_ANCHOR_ADDRESS)) {
@@ -211,11 +103,6 @@ const resolveOwnPriceUsd = (token, { pulsexPrices, lifiPrices, }) => {
         if (sameAddress(origin, exports.PULSECHAIN_USD_ANCHOR_ADDRESS)) {
             return 1;
         }
-        // Prefer the bridged origin's on-chain PulseX price. Fall back to the token's
-        // OWN home-chain LI.FI inline price when PulseX cannot price it — a bridged
-        // major (e.g. wrapped ether / wrapped binance coin) whose PulseChain pool path
-        // returns nothing would otherwise resolve to null despite a well-known market
-        // price on its home chain.
         return (pulsexPrices.get((0, exports.lowercaseAddress)(origin)) ??
             lifiPrices.get((0, exports.lifiPriceKey)(token.chainId, token.address)) ??
             null);

package/dist/cjs/providers.js

@@ -10,11 +10,9 @@ const lifiDescriptor = {
     id: 'lifi',
     label: 'LI.FI',
     supportedSourceEcosystems: ['evm'],
-    // Its contract-calls endpoint exists to deliver and then call something.
     executesDestinationCalls: true,
     destinationCallOriginChainIds: [Number(config_js_1.Chains.ETH)],
     destinationCallCarriesNativeValue: false,
-    // Its quote names the Diamond as `estimate.approvalAddress`.
     originTokenSpend: 'allowance',
     preQuote: {
         method: 'GET',
@@ -30,15 +28,10 @@ const lifiDescriptor = {
 const relayDescriptor = {
     id: 'relay',
     label: 'Relay',
-    // Relay carries every origin family the registry models. Listed explicitly
-    // rather than derived from the registry so that registering a future
-    // ecosystem does not silently claim Relay support the integration lacks.
     supportedSourceEcosystems: ['evm', 'svm', 'bvm', 'tvm', 'tonvm', 'hypevm'],
-    // Its solver performs the `txs` attached to a quote on arrival.
     executesDestinationCalls: true,
     destinationCallOriginChainIds: 'any',
     destinationCallCarriesNativeValue: true,
-    // Its quote carries an approve step; the parser lifts its spender.
     originTokenSpend: 'allowance',
     preQuote: {
         method: 'POST',
@@ -54,21 +47,10 @@ const relayDescriptor = {
 const nearIntentsDescriptor = {
     id: 'near-intents',
     label: 'NEAR Intents',
-    // ETHEREUM ORIGINS, AND THE CHAINS A READER PAYS BY HAND. The service
-    // carries Solana, Bitcoin, Tron, The Open Network and more, but it returns a
-    // deposit ADDRESS and no transaction. For a wallet-connected origin the
-    // transfer that funds a route has to be composed on this side, and only the
-    // Ethereum one is composed today (`nearIntentsOriginDeposit`); claiming a
-    // family whose transfer nothing here can build would offer a route that
-    // dead-ends at the signing step. A pay-by-hand chain needs nothing composed:
-    // the address and the amount ARE the deposit (`DepositAddressDeposit`).
     supportedSourceEcosystems: ['evm', 'zcash'],
-    // The measured answer, and the reason this provider's routes take two
-    // signatures. See the head of `near-intents.ts`.
     executesDestinationCalls: false,
     destinationCallOriginChainIds: [],
     destinationCallCarriesNativeValue: false,
-    // The reader sends the token to a deposit address.
     originTokenSpend: 'transfer',
     preQuote: {
         method: 'POST',
@@ -81,39 +63,14 @@ const nearIntentsDescriptor = {
         parse: near_intents_js_1.parseNearIntentsQuote,
     },
 };
-/**
- * Every integrated provider. LI.FI is first: the interface preserves this order
- * in its active lists, and LI.FI-first is the existing tie-break that prefers
- * the verified provider on an equal-cost quote. NEAR Intents is last, so it
- * wins a tie against neither — appropriate for the one provider whose route
- * costs the reader a second signature.
- */
 exports.providerRegistry = [
     lifiDescriptor,
     relayDescriptor,
     nearIntentsDescriptor,
 ];
 const byId = new Map(exports.providerRegistry.map((descriptor) => [descriptor.id, descriptor]));
-/**
- * Looks up a provider descriptor for ANY carrier id, answering null for an id
- * the registry does not hold. The route-search engine carries hops for
- * carriers that are not providers at all (a local wrap, a pool swap, a
- * host's own plug-in), so a caller holding an open carrier id must ask this,
- * never cast the id to {@link ProviderId} and call {@link providerById}, which
- * throws for such an id.
- *
- * @param id - any carrier id
- * @returns the descriptor, or null when no provider is registered under `id`
- */
 const findProviderById = (id) => byId.get(id) ?? null;
 exports.findProviderById = findProviderById;
-/**
- * Looks up a provider descriptor. Total over the `ProviderId` union; throws only
- * if the registry is left incomplete.
- *
- * @param id - the provider key
- * @returns the descriptor whose `id` equals `id`
- */
 const providerById = (id) => {
     const descriptor = byId.get(id);
     if (descriptor === undefined) {
@@ -122,50 +79,10 @@ const providerById = (id) => {
     return descriptor;
 };
 exports.providerById = providerById;
-/**
- * The providers that can originate a route from `ecosystem`, in registry order.
- * This is the data that used to be the hand-written capability conditional.
- *
- * @param ecosystem - the source ecosystem
- * @returns the descriptors whose `supportedSourceEcosystems` include `ecosystem`
- */
 const providersForOrigin = (ecosystem) => exports.providerRegistry.filter((descriptor) => descriptor.supportedSourceEcosystems.includes(ecosystem));
 exports.providersForOrigin = providersForOrigin;
-/**
- * The providers that may bid in the entry-anchor pre-quote for an origin.
- *
- * A STRICTER LIST THAN {@link providersForOrigin}, AND THE DIFFERENCE IS NOT
- * COSMETIC. The pre-quote exists for one purpose: to learn, for the reader's
- * fixed input, how much anchor an entry really delivers, so that figure can
- * become the exact-output target of the execution quote. The winner is whoever
- * delivers MOST.
- *
- * A provider that cannot execute the entry call can still win that comparison —
- * it has one less thing to pay for. Its number then becomes a target handed to
- * the providers that must actually fill it, and they cannot, so the whole entry
- * produces no route. The failure is silent and looks like an absent quote.
- *
- * So the pre-quote is restricted to providers that execute. This is not a
- * judgement about quality; it is that a pre-quote and an execution quote have
- * to be answerable by the same provider for the handoff between them to mean
- * anything.
- *
- * @param ecosystem - the source ecosystem
- * @returns the descriptors that may pre-quote this origin, in registry order
- */
 const preQuoteProvidersForOrigin = (ecosystem) => (0, exports.providersForOrigin)(ecosystem).filter((descriptor) => descriptor.executesDestinationCalls);
 exports.preQuoteProvidersForOrigin = preQuoteProvidersForOrigin;
-// A request with no origin family is the existing-caller shape and is treated as
-// Ethereum, preserving the original single-ecosystem default.
 const ecosystemOf = (request) => request.originVmType ?? 'evm';
-/**
- * Whether a provider can quote a request's origin ecosystem, derived from the
- * registry. Equivalent to `providersForOrigin(...).some(...)`, kept as a named
- * predicate for the call sites that ask about one provider at a time.
- *
- * @param provider - the aggregator under consideration
- * @param request - the request whose origin is being checked
- * @returns true when the provider supports the request's origin ecosystem
- */
 const providerSupportsOrigin = (provider, request) => (0, exports.providerById)(provider).supportedSourceEcosystems.includes(ecosystemOf(request));
 exports.providerSupportsOrigin = providerSupportsOrigin;