Loyalty Point-to-Token Bridge Executor

WHAT IT DOES

The Loyalty Point-to-Token Bridge Executor enables users to convert loyalty points into ERC-20 tokens through a bridge contract. It reads loyalty points contract state, token contract state, user address, wallet balance, and user point balance. The tool fetches the conversion rate, bridge fee, minimum and maximum conversion amounts, and bridge limits. It reads token minting eligibility, token supply, token cap, gas price, block timestamp, chain ID, transaction nonce, approval state, contract owner state, and bridge status. The tool supports bridgePointsToToken for standard conversions, bridgeWithFee for fee-inclusive bridging, and batchBridge for multiple recipients.

HOW TO USE

Connect your wallet, select the target network, and enter the loyalty points contract address and the token contract address. Specify the amount of loyalty points to bridge. Optionally set a bridge fee amount if the contract requires it. The tool will fetch conversion rate, your points balance, token balance, bridge limits, and active status. It calculates the tokens you will receive based on the current rate and displays all parameters for review. Once confirmed, it submits the appropriate bridge transaction—bridgePointsToToken for standard conversion, bridgeWithFee when a fee is specified, or batchBridge for multiple recipients.

TECHNICAL MECHANISM

Unlike simple transfer tools, this bridge executor interacts with a purpose-built bridge contract that handles the conversion logic. It first reads the bridge's conversionRate() to determine the exchange ratio between points and tokens. The tool then checks your points balance via the points contract and verifies allowance to ensure the bridge can spend your points. If allowance is insufficient, it prompts and executes an approve transaction. The tool reads minBridgeAmount() and maxBridgeAmount() to validate that the requested amount is within limits, and checks isActive() to ensure the bridge is operational. For fee handling, it reads bridgeFee() or accepts a user-provided fee and uses bridgeWithFee() when applicable. The tool calculates the estimated tokens to receive using the rate and displays it before signing. It also reads token decimals and points decimals to format balances correctly. Gas costs are calculated using receipt.effectiveGasPrice for accurate post-EIP-1559 fee accounting. The bridgeStatus is read to display whether the bridge is paused or active.

WHAT IT CANNOT SEE

This tool cannot verify the actual value or utility of the tokens being bridged to beyond what is represented on-chain. It cannot detect inflation risks, tokenomics manipulation, or off-market liquidity issues. It also cannot validate that the loyalty points were earned legitimately or that the bridge rate is fair. The tool cannot detect if the bridge contract has been compromised or if the token contract has been upgraded. It also cannot verify that the token received has any market value or liquidity.

PLEASE NOTE

This tool supports EVM-compatible chains. Bridging points to tokens is irreversible—verify the conversion rate, fee, and amount carefully before signing. The caller must have sufficient points balance and allowance. The bridge may have minimum and maximum limits; amounts outside these ranges will fail. Fees are paid in native currency unless otherwise specified. This tool does not handle reverse bridging (tokens to points)—for that, use the Token-to-Points Bridge Executor.