# ChainHilt Bridge Execute

> ChainHilt Bridge Execute is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Prepares unsigned ERC-20 approval and bridge transactions for a cross-chain token transfer, validating fee/amount constraints and returning ready-to-sign actions

## Facts

- Endpoint: POST https://chainhilt.ai/api/v1/bridge/execute?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-bridge-execute-55b1ffa9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7INonYiPQqt2nyuqDMrNa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainhilt-bridge-execute-55b1ffa9 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainhilt-bridge-execute-55b1ffa9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
