CoreDepositWallet contract deployed on HyperEVM. The CoreDepositWallet
handles depositing and withdrawing USDC between HyperEVM and HyperCore. This
topic explains how the HyperCore workflow works and covers HyperCore-specific
considerations.
Note: HyperCore balances reflect protocol-level credits, not Circle-issued
USDC. Native USDC remains in the
CoreDepositWallet contract on HyperEVM and
withdrawals are required to
redeem native USDC from HyperEVM.How it works
The HyperCore workflow from source chains that are not HyperEVM is a two-step process: funds are transferred in the standard CCTP workflow to HyperEVM, then forwarded to HyperCore by depositing them into theCoreDepositWallet contract.
The burn transaction uses one of two contracts depending on the source chain:
TokenMessengerV2contractCctpExtensioncontract
CctpForwarder contract on
HyperEVM to forward the USDC to the recipient address on HyperCore.
Here’s how the HyperCore workflow works:
- Check the CCTP API for fees. Fast transfers from Arbitrum have no fees.
- Calculate the USDC amounts minus fees. Forwarding to HyperCore has a small, fixed forwarding fee.
- Approve the contract to spend the amount of USDC you want to burn. If you are
interacting with the
TokenMessengerV2contract, you can do this with a call to theapprovefunction on the USDC contract. If you are interacting with theCctpExtensioncontract, you sign aReceiveWithAuthorizationmessage. - Sign and broadcast a burn transaction. The type depends on the source domain:
- CctpExtension contract: Sign and broadcast a
batchDepositForBurnWithAuthtransaction. Set HyperEVM as the destination. Include hook data to call theCctpForwardercontract on HyperEVM. - TokenMessengerV2 contract: Sign and broadcast a
depositForBurntransaction. Set HyperEVM as the destination. Include hook data to call theCctpForwardercontract on HyperEVM.
- CctpExtension contract: Sign and broadcast a
Important considerations
Keep these things in mind when using CCTP with HyperCore.Testnet recipient address limitations
When you test USDC transfers to HyperCore on testnet, the recipient address has limits:- The recipient address must already exist on HyperCore mainnet.
- Addresses that already exist on mainnet can only receive up to $1000 testnet USDC.
- Transfers to addresses without mainnet state fail silently.
Account creation fees on HyperCore
When you transfer USDC from HyperEVM to a new HyperCore address, the protocol creates the account automatically. The protocol takes 1 USDC from the deposit as an account creation fee. This means:- Direct transfers from HyperEVM below 1 USDC to a new account will fail.
- Deposits from other blockchains to new accounts must be large enough. They must cover both the 1 USDC account creation fee and the CCTP forwarding fee. If not, the deposit will fail.
Best practices for account creation fees
Make sure the first transfer to a new HyperCore account includes:- Greater than 1 USDC
- The CCTP forwarding fee (if using the
CctpForwardercontract) - The amount of USDC you want the recipient to receive
Multiple transfers to new accounts in the same block
The HyperEVM execution environment reads a snapshot of the HyperCore state for the entire block. If you send multiple transfers to a new HyperCore account in the same block, each transfer treats the account as new and tries to create it. The protocol takes the 1 USDC account creation fee for every transfer.Best practices for first deposits
When you deposit to a new account on HyperCore, make sure you:- Only send one transfer to the new account in a block
- Wait until the account is created before sending more transfers