{"uid":"cap_7INonYiPQqt2nyuqDMrNa","slug":"chainhilt-bridge-execute-55b1ffa9","name":"ChainHilt Bridge Execute","description":"Prepare the selected bridge route as ordered unsigned transactions: an exact-amount ERC-20 approval when needed (after an approval to 0 for tokens like Ethereum USDT), then the bridge transaction. Pass the minTargetAmount and maxNativeFee the user accepted; if the fresh quote delivers less or charges more native fee, it returns 409 with quote { adapter, estimatedTargetAmount, minTargetAmount, nativeFee } and no actions. Send the actions before expiresAt.","url":"https://chainhilt.ai/api/v1/bridge/execute?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"adapterId":{"enum":["across","circleCctp","debridge","layerzero","relay","socket"],"type":"string","description":"The chosen route's adapter from bridge/simulate."},"targetType":{"enum":["hyperCore","hyperEvm"],"type":"string","description":"HyperEVM targets only. hyperCore credits the recipient's HyperCore USDC balance; hyperEvm delivers the token on HyperEVM. Defaults to hyperCore for HyperEVM USDC or when hyperCoreBalance is set, otherwise hyperEvm."},"sourceToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Source token; the zero address (or 0xEeee…EEeE) bridges the chain's native token."},"targetToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Target token. It may differ from sourceToken, in which case the route swaps across tokens."},"maxNativeFee":{"type":"string","pattern":"^[0-9]{1,78}$","description":"The most the user accepted paying in native fees on top of sourceAmount, in base units of the source chain's native token: the sum of the chosen route's fees with paidFrom native plus headroom (about 20%, since message fees follow gas prices), 0 when it has none. If the new route's native fees are higher, execute returns 409 with no actions."},"sourceAmount":{"type":"string","pattern":"^[0-9]+$","maxLength":78,"description":"Exact base-unit amount that leaves the wallet. Every fee except native ones comes out of it."},"senderAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that signs and sends the bridge; every returned action is from it."},"sourceChainId":{"type":"integer","description":"EVM chain id the tokens leave from.","exclusiveMinimum":0},"targetChainId":{"type":"integer","description":"EVM chain id the tokens arrive on; HyperCore deliveries use HyperEVM's chain id. Both chains must be mainnets or both testnets.","exclusiveMinimum":0},"minTargetAmount":{"type":"string","pattern":"^[0-9]+$","maxLength":78,"description":"The least the user accepted receiving, in targetToken base units: the minTargetAmount of the route they chose, usually less a small margin (about 0.5%) since it moves between calls. Execute quotes again, and if the new route could deliver less, it returns 409 with the new amounts and no actions so the user can decide again."},"excludedAdapters":{"type":"array","items":{"enum":["across","circleCctp","debridge","layerzero","relay","socket"],"type":"string"},"description":"Adapter ids to skip, as listed by GET /bridge/adapters."},"hyperCoreBalance":{"enum":["perps","spot"],"type":"string","description":"HyperCore targets only. Defaults to perps."},"recipientAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Must equal senderAddress."}}},"responseSchema":{"type":"json","example":{"response":{"errors":[],"actions":[{"data":{"to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","data":"0x095ea7b3","from":"0xE4934BB19E0B97109033dBfDcCc6957E32F9Cc60","value":"0"},"type":"transaction","chainId":8453},{"data":{"to":"0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64","data":"0xad5425c6","from":"0xE4934BB19E0B97109033dBfDcCc6957E32F9Cc60","value":"0"},"type":"transaction","chainId":8453}],"warnings":[]},"execution":{"fees":[{"kind":"bridge","token":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"amount":"5900","paidFrom":"input"}],"adapter":"across","approval":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","spender":"0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64"},"expiresAt":1790870627,"targetType":"hyperCore","adapterName":"Across","providerRef":"lh5r9-1790867234078-e436362840a7","sourceToken":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"targetToken":{"symbol":"USDC","address":"0xb88339CB7199b77E23DB6E890353E22632Ba630f","chainId":999,"decimals":6},"sourceAmount":"10000000","minTargetAmount":"9994056","hyperCoreBalance":"perps","estimatedTargetAmount":"9994056","estimatedDurationSeconds":2}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BZcAuC1Yc-QC3IgLNlQMU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prepares unsigned ERC-20 approval and bridge transactions for a cross-chain token transfer, validating fee/amount constraints and returning ready-to-sign actions","exampleAgentPrompt":"Prepare the unsigned bridge transactions to move 10 USDC from Base (chain 8453) to Hyperliquid HyperCore (chain 999) using the Across adapter, from my wallet 0xE4934BB19E0B97109033dBfDcCc6957E32F9Cc60, accepting at least 9.99 USDC on the other side and no more than 500000 wei in native fees.","exampleUseCases":[{"title":"USDC bridge to Hyperliquid perps balance","prompt":"I want to move 50 USDC from my Base wallet 0xE4934BB19E0B97109033dBfDcCc6957E32F9Cc60 to my HyperCore perps balance using the Across adapter — give me the unsigned approval and bridge transactions, I'll accept at least 49.97 USDC delivered and up to 300000 wei in native fees."},{"title":"Cross-chain token swap via deBridge","prompt":"Prepare bridge transactions using the debridge adapter to send 100 USDC from Arbitrum (chain 42161) to Optimism (chain 10), from wallet 0xAbc123...def456, with a minimum target amount of 99500000 and max native fee of 1000000000000000 wei."},{"title":"ETH native token bridge to HyperEVM","prompt":"Generate unsigned bridge transactions to move 0.5 ETH (using the zero address as source token) from Ethereum mainnet (chain 1) to HyperEVM (chain 999) via the Relay adapter, targeting hyperEvm delivery, from my wallet 0xDead...Beef, accepting at least 0.499 ETH on arrival and no more than 2000000000000000 wei in native fees."}],"resultDescription":"Returns a list of unsigned EVM transactions (typically an ERC-20 approval-to-zero followed by a real approval, then the bridge call) with their chain IDs, sender addresses, and calldata, plus execution metadata including fee breakdown, adapter used, approval spender, expiry timestamp, estimated and minimum target amounts, and an optional targetType. If the refreshed quote delivers less than minTargetAmount or charges more than maxNativeFee, returns HTTP 409 with the new quote details and no actions.","failureModes":["409 Conflict: fresh quote delivers less than minTargetAmount or charges more native fee than maxNativeFee — returns updated quote object with no actions","Invalid adapterId: must be one of across, circleCctp, debridge, layerzero, relay, socket","Mismatched chain environments: mixing mainnet and testnet chain IDs returns an error","Invalid token address format: must be 0x-prefixed 40-hex-character address","Source amount or fee fields must be non-negative integer strings","Expired actions: transactions must be submitted before expiresAt timestamp"],"whenToPreferThis":"Use this endpoint when you have already simulated a bridge route via /bridge/simulate, the user has accepted the quoted fees and minimum target amount, and you need ready-to-sign unsigned transactions to execute the bridge. This is the execution step, not a quoting or discovery step — prefer it over generic bridge APIs when you need built-in fee guardrails (409 on stale quotes), HyperCore/HyperEVM targeting, and support for USDT-style double-approval patterns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:38:27.741Z","isFirstParty":false,"canonicalSlug":"chainhilt-bridge-execute-55b1ffa9"}