curl --request POST \
--url https://api.biconomy.io/v1/instructions/hyperliquid/deposit \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ownerAddress": "0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a",
"mode": "smart-account",
"sourceToken": "<unknown>",
"sourceChainId": "<unknown>",
"amount": "<unknown>",
"orchestratorAddressOverride": "0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a",
"feeToken": {
"address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
"chainId": 42161
}
}
'{
"ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
"fee": {
"amount": "10000000000000000",
"token": "0x0000000000000000000000000000000000000000",
"chainId": 8453
},
"quoteType": "permit",
"quote": {
"hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
"node": "0x9876543210abcdef9876543210abcdef98765432",
"commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"paymentInfo": {
"sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"initCode": "0x1234abcd",
"nonce": "0",
"token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 1,
"shortEncoding": false,
"tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
"tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
"verificationGasLimit": "21000",
"eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"eip7702Auth": {
"address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 8453,
"nonce": 38,
"r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
"s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
"yParity": 1,
"v": "28"
},
"callGasLimit": "50000",
"sponsored": true,
"sponsorshipUrl": "https://sponsorship.abc.org",
"tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
"gasFee": "21000000000000000",
"orchestrationFee": "1000000000000000"
},
"userOps": [
{
"userOp": {
"sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"nonce": "0",
"callData": "0x1234abcd",
"callGasLimit": "21000",
"verificationGasLimit": "100000",
"preVerificationGas": "21000",
"maxFeePerGas": "1000000000",
"maxPriorityFeePerGas": "100000000",
"initCode": "0x1234abcd",
"paymasterAndData": "0x",
"signature": "0xabcdef123456"
},
"userOpHash": "0x1234abcd5678ef90",
"meeUserOpHash": "0xabcdef1234567890",
"lowerBoundTimestamp": 1710000000,
"upperBoundTimestamp": 1710003600,
"maxGasLimit": "1000000",
"maxFeePerGas": "1000000000",
"chainId": 8453,
"eip7702Auth": {
"address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 8453,
"nonce": 38,
"r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
"s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
"yParity": 1,
"v": "28"
},
"isCleanUpUserOp": false,
"shortEncoding": true
}
],
"fundingTokens": [
{
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"amount": "1000000000"
}
]
},
"payloadToSign": [
{
"signablePayload": {
"types": {},
"message": {
"owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
"value": "1000000000000000000000",
"nonce": "0",
"deadline": "1647857449"
},
"primaryType": "Permit",
"domain": {
"name": "USD Coin",
"version": "2",
"chainId": 1,
"verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
"salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
},
"metadata": {
"nonce": "0",
"name": "USD Coin",
"version": "2",
"domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
"owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
"amount": "1000000000000000000000"
}
}
]
}Build instructions for depositing USDC from Arbitrum to Hyperliquid
curl --request POST \
--url https://api.biconomy.io/v1/instructions/hyperliquid/deposit \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ownerAddress": "0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a",
"mode": "smart-account",
"sourceToken": "<unknown>",
"sourceChainId": "<unknown>",
"amount": "<unknown>",
"orchestratorAddressOverride": "0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a",
"feeToken": {
"address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
"chainId": 42161
}
}
'{
"ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
"fee": {
"amount": "10000000000000000",
"token": "0x0000000000000000000000000000000000000000",
"chainId": 8453
},
"quoteType": "permit",
"quote": {
"hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
"node": "0x9876543210abcdef9876543210abcdef98765432",
"commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
"paymentInfo": {
"sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"initCode": "0x1234abcd",
"nonce": "0",
"token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 1,
"shortEncoding": false,
"tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
"tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
"verificationGasLimit": "21000",
"eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"eip7702Auth": {
"address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 8453,
"nonce": 38,
"r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
"s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
"yParity": 1,
"v": "28"
},
"callGasLimit": "50000",
"sponsored": true,
"sponsorshipUrl": "https://sponsorship.abc.org",
"tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
"gasFee": "21000000000000000",
"orchestrationFee": "1000000000000000"
},
"userOps": [
{
"userOp": {
"sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"nonce": "0",
"callData": "0x1234abcd",
"callGasLimit": "21000",
"verificationGasLimit": "100000",
"preVerificationGas": "21000",
"maxFeePerGas": "1000000000",
"maxPriorityFeePerGas": "100000000",
"initCode": "0x1234abcd",
"paymasterAndData": "0x",
"signature": "0xabcdef123456"
},
"userOpHash": "0x1234abcd5678ef90",
"meeUserOpHash": "0xabcdef1234567890",
"lowerBoundTimestamp": 1710000000,
"upperBoundTimestamp": 1710003600,
"maxGasLimit": "1000000",
"maxFeePerGas": "1000000000",
"chainId": 8453,
"eip7702Auth": {
"address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
"chainId": 8453,
"nonce": 38,
"r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
"s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
"yParity": 1,
"v": "28"
},
"isCleanUpUserOp": false,
"shortEncoding": true
}
],
"fundingTokens": [
{
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"amount": "1000000000"
}
]
},
"payloadToSign": [
{
"signablePayload": {
"types": {},
"message": {
"owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
"value": "1000000000000000000000",
"nonce": "0",
"deadline": "1647857449"
},
"primaryType": "Permit",
"domain": {
"name": "USD Coin",
"version": "2",
"chainId": 1,
"verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
"salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
},
"metadata": {
"nonce": "0",
"name": "USD Coin",
"version": "2",
"domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
"owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
"amount": "1000000000000000000000"
}
}
]
}API Key required to access Supertransaction API. Example: mee_2w3mXCuyt4xVXDRCZ5k5Lhgs
Body
Object containing the Hyperliquid deposit request fields, including owner address, execution mode (smart-account only), source token (USDC on Arbitrum only), source chain (Arbitrum only), amount to deposit, and optional fee token.
EOA wallet address which is going to be used as a owner of orchestrator account
"0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a"
Execution mode for Hyperliquid deposits. Only smart-account mode is supported.
smart-account "smart-account"
Account address which is going to be used as orchestrator account address. If not provided, ownerAddress will be used to derive the Nexus orchestratoraccount address.
"0x742d35cc6639cb8d4b5d1c5d7b8b5e2e7c0c7a8a"
Optional fee token for the transaction. If not provided, sponsorship will be used.
Show child attributes
Contract address of the token used to pay MEE execution fees
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Chain ID where the fee token resides. Use a supported chain ID.
1
Custom gas refund address to receive remaining unspent gas. Defaults to owner address. Gas refunds are always in ETH and may be refunded on multiple chains depending on userOps involved.
"0x0a7C906832544293a6018bA25280c7f7b0Bbf120"
{
"address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
"chainId": 42161
}
Response schema for a Hyperliquid deposit quote, including MEE quote information for bridging USDC from Arbitrum to Hyperliquid.
Response schema for a Hyperliquid deposit quote, including MEE quote information for bridging USDC from Arbitrum to Hyperliquid.
Owner wallet address which will be used as a owner of orchestrator account
"0x1234567890abcdef1234567890abcdef12345678"
Fee details: amount, token address, and chain ID.
Show child attributes
Type of MEE signature: permit, onchain, simple, permit-sca, or mm-dtk.
permit, onchain, simple, permit-sca, mm-dtk "permit"
MEE network compatible quote information
Show child attributes
Supertransaction hash of the quote.
"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef"
EVM address of the node providing the quote.
"0x9876543210abcdef9876543210abcdef98765432"
Node's commitment hash for the supertransaction quote (hex string, 0x-prefixed).
"0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
Show child attributes
Sender EVM address (optional)
"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"
Init code as hex string (optional)
"0x1234abcd"
Nonce as string (optional)
"0"
Payment token address
"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"
Chain ID of the payment token
1
Short encoding flag (default: false)
false
Token value as string in USD
"1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)"
Token wei amount as string (optional)
"1000000000000000000000 (1000 ether), 250000 (0.25 USDC)"
Verification gas limit as string (optional)
"21000"
EOA address (optional)
"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"
Object containing the EIP-7702 authorization signature fields for delegation, including the signer address, chain ID, nonce, and ECDSA signature components (r, s, v/yParity). Used to prove delegation intent and validity.
Show child attributes
The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.
"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"
The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.
8453
Signature nonce
38
The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.
"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"
The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.
"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"
The y-parity value (EIP-2098) for the signature. Should be 0 or 1.
1
The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.
"28"
Call gas limit as string (optional)
"50000"
Sponsored flag (optional)
true
Sponsored ulr (optional)
"https://sponsorship.abc.org"
Token amount as string (optional)
"1000 (1000 USDC), 1 (1 ether)"
Gas fee as string (optional)
"21000000000000000"
Orchestration fee as string (optional)
"1000000000000000"
Array of MEE UserOperation objects for the quote.
Show child attributes
Object containing the fields of a UserOperation, including sender, nonce, calldata, gas limits, and signature.
Show child attributes
The address of the account initiating the user operation.
"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"
The nonce of the sender account, as a bigint.
"0"
The calldata for the user operation, as a hex string.
"0x1234abcd"
The gas limit for the call, as a bigint.
"21000"
The gas limit for verification, as a bigint.
"100000"
The gas used before verification, as a bigint.
"21000"
The maximum fee per gas, as a bigint.
"1000000000"
The maximum priority fee per gas, as a bigint.
"100000000"
The initCode for contract creation, as a hex string. Optional.
"0x1234abcd"
The paymaster and data field, as a hex string. Optional.
"0x"
The signature for the user operation, as a hex string. Optional.
"0xabcdef123456"
The hash of the user operation.
"0x1234abcd5678ef90"
The MEE-specific hash of the user operation.
"0xabcdef1234567890"
The lower bound timestamp for the user operation.
1710000000
The upper bound timestamp for the user operation.
1710003600
The maximum gas limit for the user operation.
"1000000"
The maximum fee per gas for the user operation.
"1000000000"
The chain ID for the user operation.
8453
Object containing the EIP-7702 authorization signature fields for delegation, including the signer address, chain ID, nonce, and ECDSA signature components (r, s, v/yParity). Used to prove delegation intent and validity.
Show child attributes
The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.
"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"
The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.
8453
Signature nonce
38
The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.
"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"
The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.
"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"
The y-parity value (EIP-2098) for the signature. Should be 0 or 1.
1
The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.
"28"
Whether this is a clean-up user operation.
false
Whether the user operation uses short encoding.
true
Optional array of funding tokens for token pull execution.
Show child attributes
Contract address of the token that will be deposited into the Nexus smart account.
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Chain ID where the funding token resides. Use a supported chain ID.
1
Amount of funding token in wei/smallest unit to deposit.
"1000000000"
Array of payloads to be signed, structure depends on the quoteType.
1Full EIP-712 permit signature data (payload and metadata)
Show child attributes
Payload to be signed for EIP-712 permit
Show child attributes
Show child attributes
List of fields for this struct
[
{ "name": "owner", "type": "address" },
{ "name": "spender", "type": "address" },
{ "name": "value", "type": "uint256" },
{ "name": "nonce", "type": "uint256" },
{ "name": "deadline", "type": "uint256" }
]
Key-value pairs for the EIP-712 message
Show child attributes
{
"owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
"spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
"value": "1000000000000000000000",
"nonce": "0",
"deadline": "1647857449"
}
Name of the main EIP-712 struct to sign (e.g. 'Permit')
"Permit"
EIP-712 domain object
Show child attributes
Token or contract name (e.g. 'USD Coin')
"USD Coin"
Contract version (e.g. '1')
"2"
EVM chain ID (e.g. 1 for Ethereum mainnet)
1
Address of the contract being verified
"0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B"
Optional domain salt (hex string)
"0x0000000000000000000000000000000000000000000000000000000000000000"
Extra metadata for the permit signature
Show child attributes
Permit nonce (as string)
"0"
Token or contract name
"USD Coin"
Contract version
"2"
EIP-712 domain separator (hex string)
"0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335"
Address of the permit owner
"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"
Address of the spender
"0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"
Permit amount in wei (as string)
"1000000000000000000000"