@gibs/bridge-sdk 1.19.0 → 1.20.0

package/dist/cjs/swap-venues.js

@@ -2,28 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findSwapVenue = exports.resolveSwapVenues = void 0;
 const config_js_1 = require("./config.js");
-/**
- * Merges caller venues over {@link defaultSwapVenues}. A chain present in
- * `overrides` replaces the default list for that chain. A chain absent from
- * `overrides` keeps its default list. An empty list switches swaps off on
- * that chain. Neither input is changed; the result is frozen.
- *
- * @param overrides - the caller's venues, or undefined for the defaults
- * @returns the venues to use
- */
 const resolveSwapVenues = (overrides) => {
     if (overrides === undefined)
         return config_js_1.defaultSwapVenues;
     return Object.freeze({ ...config_js_1.defaultSwapVenues, ...overrides });
 };
 exports.resolveSwapVenues = resolveSwapVenues;
-/**
- * Finds the venue on a chain that has the given router.
- *
- * @param venues - the venues to search
- * @param chainId - the numeric chain id
- * @param router - the router address, in any letter case
- * @returns the venue, or null when the chain has no venue with that router
- */
 const findSwapVenue = (venues, chainId, router) => venues[chainId]?.find((venue) => venue.router.toLowerCase() === router.toLowerCase()) ?? null;
 exports.findSwapVenue = findSwapVenue;

package/dist/cjs/ton-connect.js

@@ -1,59 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTonConnectRequest = exports.encodeTonAddress = exports.parseTonAddress = exports.tonConnectDefaultValidForSeconds = exports.tonConnectMainnetNetwork = void 0;
-/**
- * Executing a deposit on The Open Network, as pure data, with no TON library.
- *
- * This module imports nothing outside the package, so it loads anywhere: a
- * browser, Node, or a React Native app under Hermes, with no `Buffer` and no
- * polyfill. It uses only `atob` and `btoa`, which Hermes provides. The one TON
- * helper that needs `@ton/core`, the TEP-467 message hash, lives in
- * `@gibs/bridge-sdk/ton` instead.
- *
- * Relay describes a deposit as a list of internal messages carrying `to`,
- * `value`, `body` and a `bounce` flag. A connected wallet, however, is driven
- * through the TON Connect protocol, whose request shape is different in one way
- * that silently loses money:
- *
- * **TON Connect has no per-message `bounce` field.** A wallet derives whether a
- * message bounces from the FORM OF THE ADDRESS — the bounceable `EQ…` prefix or
- * the non-bounceable `UQ…` one. Passing Relay's address through unchanged while
- * dropping its `bounce: false` therefore sends a deposit to the bounceable form,
- * and the depository bounces the funds straight back to the sender. The transfer
- * looks like it succeeded and the route never fills.
- *
- * {@link buildTonConnectRequest} folds `bounce` into the address so the flag
- * cannot be dropped on the way to a wallet.
- *
- * Kept free of transport and of clock reads so it is fully testable: nothing
- * here signs, fetches, or calls `Date.now`. The caller supplies the deadline and
- * performs the request.
- *
- * The rules encoded here are those of Relay's own wallet adapter, which is the
- * only reference implementation of this mapping.
- */
-/**
- * The TON Connect network identifier for mainnet. Relay bridges only mainnet, so
- * a request is always tagged with this.
- */
 exports.tonConnectMainnetNetwork = '-239';
-/** How long a request stays valid by default, in seconds, matching Relay's adapter. */
 exports.tonConnectDefaultValidForSeconds = 300;
-/** Address tag byte for the bounceable (`EQ…`) form. */
 const bounceableTag = 0x11;
-/** Address tag byte for the non-bounceable (`UQ…`) form. */
 const nonBounceableTag = 0x51;
-/** Bit set on the tag byte for testnet-only addresses (`kQ…` / `0Q…`). */
 const testnetTagFlag = 0x80;
-/** A friendly address is a 36-byte structure: tag, workchain, hash, checksum. */
 const friendlyAddressByteLength = 36;
-/** An account identifier is always 32 bytes, in every address form. */
 const accountHashByteLength = 32;
-/**
- * Cyclic redundancy check (16-bit, the XModem variant) over an address body.
- * The Open Network appends it to every friendly address, and a re-encoded
- * address whose checksum is not recomputed is rejected by wallets as malformed.
- */
 const checksum = (data) => {
     let remainder = 0;
     for (const byte of data) {
@@ -65,7 +19,6 @@ const checksum = (data) => {
     }
     return remainder;
 };
-/** Decodes the url-safe base64 alphabet the friendly address form uses. */
 const decodeBase64Url = (value) => {
     const standard = value.replaceAll('-', '+').replaceAll('_', '/');
     const padded = standard.padEnd(Math.ceil(standard.length / 4) * 4, '=');
@@ -77,7 +30,6 @@ const decodeBase64Url = (value) => {
         return null;
     }
 };
-/** Encodes bytes back into the url-safe, unpadded base64 form. */
 const encodeBase64Url = (bytes) => {
     let binary = '';
     for (const byte of bytes) {
@@ -103,7 +55,6 @@ const parseRawAddress = (value) => {
         }
         hash[index] = byte;
     }
-    // The raw form carries no network tag, so mainnet is the only safe assumption.
     return { workchain, hash, testOnly: false };
 };
 const parseFriendlyAddress = (value) => {
@@ -112,8 +63,6 @@ const parseFriendlyAddress = (value) => {
         return null;
     }
     const body = bytes.subarray(0, friendlyAddressByteLength - 2);
-    // Every index below is in range: the length was checked to be exactly
-    // `friendlyAddressByteLength` above, so the non-null assertions are sound.
     const stated = (bytes[friendlyAddressByteLength - 2] << 8) | bytes[friendlyAddressByteLength - 1];
     if (checksum(body) !== stated) {
         return null;
@@ -125,30 +74,13 @@ const parseFriendlyAddress = (value) => {
     }
     const workchainByte = bytes[1];
     return {
-        // The masterchain is workchain -1, which travels as the byte 0xff.
         workchain: workchainByte === 0xff ? -1 : workchainByte,
         hash: bytes.slice(2, 2 + accountHashByteLength),
         testOnly: (tag & testnetTagFlag) !== 0,
     };
 };
-/**
- * Parses either address form The Open Network uses.
- *
- * @param value - a friendly (`EQ…`/`UQ…`) or raw (`0:…`) address
- * @returns the address parts, or null when it is neither form or fails its checksum
- */
 const parseTonAddress = (value) => value.includes(':') ? parseRawAddress(value) : parseFriendlyAddress(value);
 exports.parseTonAddress = parseTonAddress;
-/**
- * Re-encodes an address into the friendly form matching a bounce setting.
- *
- * This is the whole point of the module: the bounce flag has nowhere else to
- * live in a TON Connect request, so it has to be carried by the address itself.
- *
- * @param address - the address in either form
- * @param options.bounceable - whether the message may bounce back to the sender
- * @returns the friendly address, or null when the input cannot be parsed
- */
 const encodeTonAddress = (address, { bounceable }) => {
     const parsed = (0, exports.parseTonAddress)(address);
     if (parsed === null) {
@@ -165,17 +97,6 @@ const encodeTonAddress = (address, { bounceable }) => {
     return encodeBase64Url(bytes);
 };
 exports.encodeTonAddress = encodeTonAddress;
-/**
- * Builds the TON Connect request for a deposit.
- *
- * @param deposit - the parsed origin deposit
- * @param options.validUntil - unix seconds after which the request expires.
- *   Supplied by the caller rather than read from a clock here so the transform
- *   stays pure; {@link tonConnectDefaultValidForSeconds} is the usual offset.
- * @returns the request, or null when the deposit carries no messages or any
- *   destination address cannot be re-encoded — never a request whose bounce
- *   setting has been silently dropped
- */
 const buildTonConnectRequest = (deposit, { validUntil }) => {
     if (deposit.messages.length === 0) {
         return null;
@@ -183,8 +104,6 @@ const buildTonConnectRequest = (deposit, { validUntil }) => {
     const messages = [];
     for (const message of deposit.messages) {
         const address = (0, exports.encodeTonAddress)(message.to, { bounceable: message.bounce });
-        // Refuse rather than fall back to the unencoded address: the fallback is
-        // exactly the bounce-losing behaviour this module exists to prevent.
         if (address === null) {
             return null;
         }
@@ -194,7 +113,6 @@ const buildTonConnectRequest = (deposit, { validUntil }) => {
             ...(message.body ? { payload: message.body } : {}),
         });
     }
-    // `messages[0]` is present: the empty case returned null above.
     const from = deposit.messages[0].from;
     return {
         validUntil,

package/dist/cjs/ton-execution.js

@@ -14,10 +14,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * The original name of `@gibs/bridge-sdk/ton`, kept so existing imports work.
- *
- * @deprecated Import from `@gibs/bridge-sdk/ton` for the full TON surface, or
- * from `@gibs/bridge-sdk/ton-connect` for the helpers that need no TON library.
- */
 __exportStar(require("./ton.js"), exports);

package/dist/cjs/ton.js

@@ -16,59 +16,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tonExternalMessageHash = void 0;
 const core_1 = require("@ton/core");
-/**
- * Everything the bridge SDK offers for The Open Network, in one entry point.
- *
- * It re-exports the pure TON Connect helpers from `./ton-connect.js` and adds
- * {@link tonExternalMessageHash}, the only helper that needs `@ton/core`.
- *
- * Kept apart from the root entry point on purpose. `@ton/core` uses Node's
- * `Buffer`, and its `@ton/crypto` dependency resolves, under React Native, to a
- * build that requires `expo-crypto`. An application that bridges only between
- * Ethereum-style chains never imports this file, so it never pays for either.
- */
 __exportStar(require("./ton-connect.js"), exports);
-/**
- * Derives the transaction identifier from a wallet's `sendTransaction` response.
- *
- * A wallet answers with a `boc`: the base64 bag-of-cells of the signed
- * external-in message it broadcast — NOT the resulting transaction, and NOT a
- * hash. The identifier explorers and indexers (toncenter, TonAPI) resolve a
- * transaction by is the hash of that external message, but it must be the
- * NORMALIZED hash of TEP-467, not the hash of the bytes the wallet happened to
- * send.
- *
- * The distinction is the whole point, and getting it wrong loses a resume record
- * for real funds. An external-in message can be serialized several equivalent
- * ways — a wallet may or may not include its own `src`, may set a non-zero
- * `import_fee`, may attach a `stateInit`, may store the body inline or as a
- * reference. The raw cell hash changes with each of those wallet-specific
- * choices, so it frequently does NOT match what an indexer keyed the same
- * transaction under. TEP-467 rebuilds the message with those variable fields
- * stripped (`src` to none, `import_fee` to zero, `init` dropped, body forced to a
- * reference) so the hash is stable across wallets and matches the indexers.
- *
- * @param boc - the wallet's base64 `boc` field from `sendTransaction`
- * @returns the 64-character hex normalized hash, or null when the input is not a
- *   parseable external-in message
- */
 const tonExternalMessageHash = (boc) => {
     try {
         const message = (0, core_1.loadMessage)(core_1.Cell.fromBase64(boc).beginParse());
-        // Only an external-in message has a normalized form; an internal message or
-        // a bare cell is not the wallet's broadcast envelope and cannot be keyed.
         if (message.info.type !== 'external-in') {
             return null;
         }
         const normalized = {
             ...message,
-            // Dropped by TEP-467 so a wallet-attached stateInit does not move the hash.
             init: null,
-            // `src` to addr_none (undefined) and the fee to zero: both are the sender's
-            // to choose and neither is part of what identifies the message.
             info: { ...message.info, src: undefined, importFee: 0n },
         };
-        // `forceRef` stores the body as a reference, as the normalized form requires.
         return (0, core_1.beginCell)()
             .store((0, core_1.storeMessage)(normalized, { forceRef: true }))
             .endCell()
@@ -76,7 +35,6 @@ const tonExternalMessageHash = (boc) => {
             .toString('hex');
     }
     catch {
-        // A malformed base64 payload or a cell tree that is not a message at all.
         return null;
     }
 };

package/dist/cjs/tron-execution.js

@@ -1,72 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readBroadcastResponse = exports.readTriggerSmartContractResponse = exports.tronErrorMessage = exports.buildTriggerSmartContractRequest = exports.isSameTronAccount = exports.normalizeTronHexAddress = exports.maximumTronFeeLimitSun = exports.defaultTronFeeLimitSun = exports.tronTriggerSmartContractPath = void 0;
-/**
- * Executing a deposit on Tron, as pure data.
- *
- * Relay does not return a broadcastable Tron transaction. It returns the
- * *parameters* of a `TriggerSmartContract` call — owner, contract, call value
- * and calldata — and nothing else. A Tron transaction additionally needs a
- * reference block, an expiration and a fee limit, none of which Relay supplies.
- * Those are produced by asking a full node to build the transaction, which is
- * what {@link buildTriggerSmartContractRequest} constructs the body for. The
- * node answers with an UNSIGNED transaction; the wallet signs it and a second
- * call broadcasts it.
- *
- * Three details of that exchange lose money or mislead if handled naively:
- *
- * **The `visible` flag defaults to true.** A node reads addresses as base58
- * unless told otherwise, but Relay returns them as hex with Tron's `41` prefix.
- * Omitting the flag therefore hands base58-parsing a hex string. The request
- * built here always states `visible: false` rather than relying on a default
- * that is the opposite of what the payload contains.
- *
- * **`fee_limit` is required and Relay omits it.** It caps the energy the caller
- * will pay for. Set too low, the call runs out of energy, reverts, and the
- * energy already burned is NOT refunded — the deposit fails and costs the user
- * anyway.
- *
- * **A rejected call still answers HTTP 200**, with the reason hex-encoded in
- * `result.message`. Reading the status code alone reports a failed deposit as a
- * success, and printing the message unmodified shows the user a wall of hex.
- * {@link tronErrorMessage} decodes it.
- *
- * Kept free of transport and of clock reads so it is fully testable: nothing
- * here signs, fetches, or calls `Date.now`. The caller performs the requests.
- */
-/** Path of the full-node endpoint that builds an unsigned contract call. */
 exports.tronTriggerSmartContractPath = '/wallet/triggersmartcontract';
-/**
- * The fee limit used when a caller states none, in sun (1 TRX = 1,000,000 sun).
- *
- * Thirty TRX, matching Relay's own wallet adapter, which is the only reference
- * implementation of this deposit path. It is an upper bound rather than a
- * charge: unused energy is not taken, so the cost of setting it generously is
- * only that the wallet shows a larger worst case.
- */
 exports.defaultTronFeeLimitSun = 30_000_000;
-/**
- * The largest fee limit a node accepts, in sun — 15,000 TRX. Documented as a
- * hard protocol cap, so a request above it is rejected outright rather than
- * clamped.
- */
 exports.maximumTronFeeLimitSun = 15_000_000_000;
-/**
- * Tron's `41` address prefix, the hex form's equivalent of the base58 `T`.
- */
 const tronHexAddressPrefix = '41';
-/** A hex address is the prefix byte plus a twenty-byte account identifier. */
 const tronHexAddressLength = 42;
-/**
- * Normalizes a Tron hex address for comparison.
- *
- * Wallets and quotes disagree on casing, and Relay's payload is not guaranteed
- * to match what a wallet reports even when both name the same account.
- *
- * @param value - an address in Tron's `41`-prefixed hex form, in any casing,
- *   optionally written with a `0x` prefix
- * @returns the lowercase `41` form, or null when the value is not that form
- */
 const normalizeTronHexAddress = (value) => {
     const withoutPrefix = value.trim().replace(/^0x/i, '').toLowerCase();
     if (withoutPrefix.length !== tronHexAddressLength) {
@@ -78,51 +17,14 @@ const normalizeTronHexAddress = (value) => {
     return /^[0-9a-f]+$/.test(withoutPrefix) ? withoutPrefix : null;
 };
 exports.normalizeTronHexAddress = normalizeTronHexAddress;
-/**
- * Whether two Tron hex addresses name the same account.
- *
- * Used to check a deposit's owner against the connected wallet before signing.
- * A mismatch means the quote was built for a different account, and signing it
- * would spend from an account the user did not choose — or simply fail after
- * the user has already approved.
- *
- * @param left - an address in Tron's `41`-prefixed hex form
- * @param right - an address in the same form
- * @returns true only when both parse and name the same account
- */
 const isSameTronAccount = (left, right) => {
     const normalizedLeft = (0, exports.normalizeTronHexAddress)(left);
     const normalizedRight = (0, exports.normalizeTronHexAddress)(right);
     return normalizedLeft !== null && normalizedLeft === normalizedRight;
 };
 exports.isSameTronAccount = isSameTronAccount;
-/**
- * Strips the `0x` prefix Tron calldata never carries.
- *
- * Relay documents this field as bare hex, but its own adapter strips the prefix
- * defensively, and a prefixed value is parsed by a node as calldata beginning
- * with the bytes `0x` rather than being rejected — a silently wrong call.
- */
 const bareHex = (value) => value.replace(/^0x/i, '').toLowerCase();
-/**
- * Whether a numeric amount survives the trip through JSON as an exact integer.
- *
- * Sun amounts are 64-bit on the wire but JSON carries them as doubles, so a
- * large enough value would be silently rounded — into a different amount of
- * money than the one that was quoted.
- */
 const isExactInteger = (value) => value >= 0n && value <= BigInt(Number.MAX_SAFE_INTEGER);
-/**
- * Builds the body that asks a full node to construct the unsigned deposit.
- *
- * @param deposit - the parsed origin deposit
- * @param options.feeLimitSun - the energy spending cap in sun; defaults to
- *   {@link defaultTronFeeLimitSun}
- * @returns the request body, or null when the deposit names an address that is
- *   not Tron hex, carries a call value that cannot be represented exactly, or
- *   the fee limit is outside what a node accepts — never a body that would be
- *   built against a default `visible` the payload contradicts
- */
 const buildTriggerSmartContractRequest = (deposit, { feeLimitSun = exports.defaultTronFeeLimitSun } = {}) => {
     const ownerAddress = (0, exports.normalizeTronHexAddress)(deposit.ownerAddress);
     const contractAddress = (0, exports.normalizeTronHexAddress)(deposit.contractAddress);
@@ -145,14 +47,6 @@ const buildTriggerSmartContractRequest = (deposit, { feeLimitSun = exports.defau
     };
 };
 exports.buildTriggerSmartContractRequest = buildTriggerSmartContractRequest;
-/**
- * Decodes a node's hex-encoded failure message.
- *
- * A node reports why it refused a call in `result.message`, hex-encoded — the
- * bytes `4e6f20636f6e7472616374…` rather than "No contract or not a valid smart
- * contract". Broadcast failures report plain text in the same field, so both
- * are handled and a value that is not hex is passed through unchanged.
- */
 const decodeTronMessage = (value) => {
     const trimmed = value.trim();
     if (trimmed.length === 0 || trimmed.length % 2 !== 0 || !/^[0-9a-fA-F]+$/.test(trimmed)) {
@@ -162,26 +56,16 @@ const decodeTronMessage = (value) => {
     for (let index = 0; index < trimmed.length; index += 2) {
         decoded += String.fromCharCode(Number.parseInt(trimmed.slice(index, index + 2), 16));
     }
-    // A hex string that decodes to control characters was a number, not a
-    // message — return the original rather than a string of unprintable bytes.
     return /^[\x20-\x7e]*$/.test(decoded) ? decoded : trimmed;
 };
 const asRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value)
     ? value
     : null;
-/**
- * Extracts a node's failure reason from either endpoint's response.
- *
- * @param payload - the parsed response body
- * @returns the decoded message, or null when the response reports no failure
- */
 const tronErrorMessage = (payload) => {
     const body = asRecord(payload);
     if (body === null) {
         return null;
     }
-    // The build endpoint nests its outcome under `result`; the broadcast endpoint
-    // reports at the top level.
     const nested = asRecord(body.result);
     const message = nested?.message ?? body.message;
     if (typeof message !== 'string') {
@@ -191,17 +75,6 @@ const tronErrorMessage = (payload) => {
     return decoded.length === 0 ? null : decoded;
 };
 exports.tronErrorMessage = tronErrorMessage;
-/**
- * Reads the unsigned transaction out of a build response.
- *
- * The response carries the transaction at the top level alongside a `result`
- * object stating whether the build succeeded, so the presence of a `txID` is
- * not on its own evidence of success.
- *
- * @param payload - the parsed `/wallet/triggersmartcontract` response
- * @returns the unsigned transaction to hand a wallet, or null when the node
- *   refused the call
- */
 const readTriggerSmartContractResponse = (payload) => {
     const body = asRecord(payload);
     if (body === null) {
@@ -218,24 +91,6 @@ const readTriggerSmartContractResponse = (payload) => {
     return transaction;
 };
 exports.readTriggerSmartContractResponse = readTriggerSmartContractResponse;
-/**
- * Reads the transaction identifier out of a broadcast response.
- *
- * GOTCHA: a rejected broadcast answers HTTP 200, and `result` is OMITTED rather
- * than set to false. Testing `result === false` therefore never fires, and
- * trusting the status code records a deposit that never entered a block. Only
- * an explicit `result: true` is accepted here.
- *
- * The identifier is read from `txid` where a node reports it, falling back to
- * the echoed transaction's `txID`. The two spellings differ by casing and by
- * position: a node answers `txid`, while a wallet library that echoes the
- * transaction it broadcast carries `txID` inside it. Accepting only the first
- * would report an accepted broadcast as a failure whenever the caller is one of
- * those libraries.
- *
- * @param payload - the parsed `/wallet/broadcasttransaction` response
- * @returns the transaction identifier, or null when the broadcast was refused
- */
 const readBroadcastResponse = (payload) => {
     const body = asRecord(payload);
     if (body === null || body.result !== true) {

package/dist/claims.js

@@ -1,12 +1,6 @@
 import { encodeFunctionData, isHex, numberToHex } from 'viem';
 import * as abis from './abis.js';
 const strip0x = (input) => input.replace(/^0x/, '');
-/**
- * Splits one 65-byte validator signature into its `v`, `r` and `s` parts.
- *
- * @param rawSignature - the signature as the indexer stores it, with or without a `0x` prefix
- * @returns the three parts, hex without prefixes
- */
 export const signatureToVRS = (rawSignature) => {
     const signature = strip0x(rawSignature);
     const word = 32;
@@ -17,13 +11,6 @@ export const signatureToVRS = (rawSignature) => {
     const v = signature.slice(word4);
     return { v, r, s };
 };
-/**
- * Packs signatures in the layout the bridge's `executeSignatures` reads: one
- * count byte, then every `v`, then every `r`, then every `s`.
- *
- * @param signatures - the split signatures, in the order the validators signed
- * @returns the packed signatures as one hex string
- */
 export const packSignatures = (signatures) => {
     const length = strip0x(numberToHex(signatures.length));
     const countByte = length.length === 1 ? `0${length}` : length;
@@ -32,43 +19,16 @@ export const packSignatures = (signatures) => {
     const s = signatures.map((signature) => signature.s).join('');
     return `0x${countByte}${v}${r}${s}`;
 };
-/**
- * The calldata for a release that pays no delivery tip: a direct call to the
- * destination bridge.
- *
- * @param options.encodedData - the bridge message, `UserRequest.encodedData`
- * @param options.encodedSignatures - the output of {@link packSignatures}
- * @returns the calldata for `safeExecuteSignaturesWithAutoGasLimit`
- */
 export const encodeReleaseWithoutTipData = ({ encodedData, encodedSignatures, }) => encodeFunctionData({
     abi: abis.relayTokensDirect,
     functionName: 'safeExecuteSignaturesWithAutoGasLimit',
     args: [encodedData, encodedSignatures],
 });
-/**
- * The calldata for a release sent through the pathway's destination output
- * router, the path a fee-director (delivery) request uses.
- *
- * @param options.validator - the pathway's validator contract
- * @param options.encodedData - the bridge message, `UserRequest.encodedData`
- * @param options.encodedSignatures - the output of {@link packSignatures}
- * @returns the calldata for the router's `safeExecuteSignaturesWithAutoGasLimit`
- */
 export const encodeReleaseToRouterData = ({ validator, encodedData, encodedSignatures, }) => encodeFunctionData({
     abi: abis.outputRouter,
     functionName: 'safeExecuteSignaturesWithAutoGasLimit',
     args: [validator, encodedData, encodedSignatures],
 });
-/**
- * The one place a claim's target and calldata come from. The interface's
- * release hook and {@link buildClaimTransaction} both call it.
- *
- * @param options.encodedData - the bridge message
- * @param options.signatures - the raw validator signatures, in signing order
- * @param options.destinationAmbAddress - the destination bridge, used by the `direct` route
- * @param options.via - which contract receives the claim
- * @returns the target contract and the calldata
- */
 export const claimCall = ({ encodedData, signatures, destinationAmbAddress, via, }) => {
     const encodedSignatures = packSignatures(signatures.map(signatureToVRS));
     if (via.kind === 'router') {
@@ -81,24 +41,6 @@ export const claimCall = ({ encodedData, signatures, destinationAmbAddress, via,
 };
 const isSignatureList = (value) => Array.isArray(value) && value.every((entry) => typeof entry === 'string' && isHex(entry));
 const refused = (refusal) => ({ kind: 'refused', refusal });
-/**
- * Builds the manual-claim transaction for one bridge request, or refuses with
- * a typed reason.
- *
- * The checks run in this order: request type, delivery, signing, then the
- * stored signature count. A delivered request is refused before the signing
- * check, because delivery also sets `finishedSigning`.
- *
- * ASSUMPTION: the signatures are only complete when every validator sent
- * `submitSignature` directly to the home bridge. The indexer drops a
- * signature sent any other way; see this module's head note. This builder
- * catches the drop by comparing the stored list with the required-signature
- * threshold, or with `confirmedSignatures` when the record carries no threshold.
- *
- * @param options.request - the indexer's `UserRequest` record
- * @param options.via - the claim target; see {@link ClaimRoute}
- * @returns a `claim` plan whose transaction runs on the destination chain, or a refusal
- */
 export const buildClaimTransaction = ({ request, via, }) => {
     if (request.type !== 'signature')
         return refused({ reason: 'wrong-type', type: request.type });
@@ -131,8 +73,6 @@ export const buildClaimTransaction = ({ request, via, }) => {
             to,
             data,
             value: 0n,
-            // The calldata itself asks the bridge to pick its own gas limit
-            // (`safeExecuteSignaturesWithAutoGasLimit`); the wallet estimates the rest.
             gasLimit: null,
             waitForReceipt: false,
         },