spot or perp balance
to an external EVM blockchain (such as Arbitrum, Ethereum, or Base) using the
HyperCore API. Withdrawals from HyperCore to EVM chains default to the Fast
Transfer method, due to the fast finality of HyperEVM.
The withdrawal process:
- Debits your HyperCore balance (
spotorperp) - Routes through HyperEVM where USDC is burned via CCTP
- CCTP attests to the burn and mints on the destination chain
- If automatic forwarding is enabled, the recipient receives funds directly
Withdrawing using the Forwarding Service is
only available for Arbitrum. If you are withdrawing to a different chain, you
will need to fetch the attestation from the Circle API and mint the USDC on the
destination chain yourself.Withdrawals include a HyperCore fee and (if using the Forwarding Service) a CCTP
forwarding fee. Ensure your withdrawal amount exceeds combined fees depending on
your transfer.
Important considerations
Keep these things in mind when withdrawing USDC from HyperCore to EVM chains:-
Data field: If the data field is empty, the
CoreDepositWalletautomatically sets a default hook that enables automatic message forwarding on the destination blockchain, provided that the blockchain supports CCTP forwarding. If the data field is not empty, its contents are passed to the CCTP protocol as the value of thehookDatafield. -
Destination caller: The CCTP
destinationCalleris always set to the zero address. Passing your own hook data means that anyone can receive the message on the destination blockchain. -
Withdrawal fees: In addition to the
maxFeecharged by the HyperCore blockchain, an additional fixed forwarding fee may be charged by CCTP if automatic forwarding is enabled. The forwarding fee amount depends on the destination blockchain and can be viewed by querying theCoreDepositWalletsmart contract. Initially, the fee for forwarding to Arbitrum is 0.2 USDC. If the withdrawal includes custom hook data, the forwarding fee is not set and users have to receive the message on the destination blockchain themselves. - Minimum withdrawal amount: If the withdrawal amount is less than the required forwarding fee, the transaction on HyperEVM reverts. Make sure the withdrawal amount is larger than the fees.
Prerequisites
Before you begin, ensure that you’ve:- Installed Node.js v22+
- Prepared an EVM wallet with the private key available
-
Funded your HyperCore account with USDC in either
spotorperpbalance -
Created a new Node project and installed dependencies:
-
Created a
.envfile with required environment variables:
Steps
Use the following steps to withdraw USDC from HyperCore to an EVM blockchain.Step 1. Construct the sendToEvmWithData action
Create a sendToEvmWithData action object with the following parameters:
type:sendToEvmWithDatahyperliquidChain:Mainnet(orTestnetfor testnet)signatureChainId: The destination chain’s EVM chain ID in hexadecimal format (e.g.,"0xa4b1"for Arbitrum,"0x1"for Ethereum). Must match the destination chain.token:USDCamount: The amount of USDC as a string (e.g.,"10"for 10 USDC,"1.5"for 1.5 USDC)sourceDex:"spot"to withdraw from spot balance, or""forperpbalancedestinationRecipient: The recipient address on the destination blockchainaddressEncoding:hexfor EVM chains orbase58for SolanadestinationChainId: The CCTP destination domain ID (for example,3for Arbitrum,0for Ethereum,6for Base)gasLimit: Gas limit for the transaction on the destination chaindata: CCTP hook data (use"0x"for automatic forwarding)nonce: Current timestamp in milliseconds
TypeScript
Step 2. Sign the action using EIP-712
Sign the action using the EIP-712 typed data signing standard. The signature proves that you authorize this withdrawal. The signing domain should include:name:"HyperliquidSignTransaction"version:"1"chainId: The chain ID fromsignatureChainId(as a number)verifyingContract:"0x0000000000000000000000000000000000000000"
TypeScript
Step 3. Submit the signed action to the exchange API
Call the exchange endpoint with the action, nonce, and signature.TypeScript
Full example code
The following is a complete example of how to withdraw USDC from HyperCore to an external EVM blockchain. By default, it withdraws 10 USDC from your perp balance to Arbitrum testnet with automatic forwarding enabled. For other destination chains, updatedestinationChainId (CCTP domain ID) and signatureChainId
(destination chain’s EVM chain ID in hex) accordingly.
TypeScript