convertEURToToken (Off-Ramp)

Get EUR to token quote.

convertEURToToken method returns a calculated token amount to match provided (expected) EUR amount.

This method also returns transferData, a structured object that can contain token-specific transfer, unwrap, or swap data and is passed unchanged into the off-ramp transaction.

Usage

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...',
  tokenAddress: '0x...',
  tokenDecimals: 6,
  amount: '9.99',
  network: Network.ethereum,
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',
  tokenAddress: '...',
  tokenDecimals: 6,
  amount: '9.99',
  network: SolanaNetwork.Mainnet,
});

Parameters

Parameter	Type	Required	Description
walletAddress	string	Yes	The wallet address initiating the transaction (EVM or Solana).
tokenAddress	string	Yes	Contract address of the token to receive.
tokenDecimals	number	Yes	Number of decimal places for the token (e.g. 6 for USDC, 18 for ETH).
amount	string	Yes	Target EUR amount, as a decimal string (e.g. "9.99" for 9.99 EUR).
network	Network | SolanaNetwork	Yes	The chain the token lives on. Must match tokenAddress.

walletAddress

Wallet address

• Type: string

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...', 
  tokenAddress: '0x...',
  tokenDecimals: 6,
  amount: '9.99',
  network: Network.ethereum,
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',  
  tokenAddress: '...',
  tokenDecimals: 6,
  amount: '9.99',
  network: SolanaNetwork.Mainnet,
});

tokenAddress

Token address

• Type: string

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...',
  tokenAddress: '0x...', 
  tokenDecimals: 6,
  amount: '9.99',
  network: Network.ethereum,
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',
  tokenAddress: '...', 
  tokenDecimals: 6,
  amount: '9.99',
  network: SolanaNetwork.Mainnet,
});

tokenDecimals

Token decimals

• Type: Number

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...',
  tokenAddress: '0x...',
  tokenDecimals: 6, 
  amount: '9.99',
  network: Network.ethereum,
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',
  tokenAddress: '...',
  tokenDecimals: 6, 
  amount: '9.99',
  network: SolanaNetwork.Mainnet,
});

amount

EUR amount

• Type: String

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...',
  tokenAddress: '0x...',
  tokenDecimals: 6,
  amount: '9.99', 
  network: Network.ethereum,
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',
  tokenAddress: '...',
  tokenDecimals: 6,
  amount: '9.99', 
  network: SolanaNetwork.Mainnet,
});

network

Token network

• Type: Network | SolanaNetwork

EVM

import { Network } from '@holyheld/sdk';

const data = await holyheldSDK.evm.offRamp.convertEURToToken({
  walletAddress: '0x...',
  tokenAddress: '0x...',
  tokenDecimals: 6,
  amount: '9.99',
  network: Network.ethereum, 
});

Solana

import { SolanaNetwork } from '@holyheld/sdk';

const data = await holyheldSDK.solana.offRamp.convertEURToToken({
  walletAddress: '...',
  tokenAddress: '...',
  tokenDecimals: 6,
  amount: '9.99',
  network: SolanaNetwork.Mainnet, 
});

Returns

Returns a Promise<ConvertTopUpData> with the required token amount and routing data for the transaction.

EVM

import type { TransferDataEVM } from '@holyheld/sdk';

type ConvertTopUpDataEVM = {
  tokenAmount: string;
  EURAmount: string;
  transferData?: TransferDataEVM;
}

Solana

import type { TransferDataSolana } from '@holyheld/sdk';

type ConvertTopUpDataSolana = {
  tokenAmount: string;
  EURAmount: string;
  transferData?: TransferDataSolana;
}

tokenAmount

Calculated token amount equivalent to the requested EUR amount

• Type: String
• Example: 1.99

EVM

import type { TransferDataEVM } from '@holyheld/sdk';

type ConvertTopUpDataEVM = {
  tokenAmount: string; 
  EURAmount: string;
  transferData?: TransferDataEVM;
}

Solana

import type { TransferDataSolana } from '@holyheld/sdk';

type ConvertTopUpDataSolana = {
  tokenAmount: string; 
  EURAmount: string;
  transferData?: TransferDataSolana;
}

EURAmount

EUR valuation of the token amount provided

• Type: String
• Example: 314.25

EVM

import type { TransferDataEVM } from '@holyheld/sdk';

type ConvertTopUpDataEVM = {
  tokenAmount: string;
  EURAmount: string; 
  transferData?: TransferDataEVM;
}

Solana

import type { TransferDataSolana } from '@holyheld/sdk';

type ConvertTopUpDataSolana = {
  tokenAmount: string;
  EURAmount: string; 
  transferData?: TransferDataSolana;
}

transferData (optional)

Data to be passed in sending transaction for this specific token (and amount)

• Type: TransferDataEVM | TransferDataSolana

EVM

import type { TransferDataEVM } from '@holyheld/sdk';

type ConvertTopUpDataEVM = {
  tokenAmount: string;
  EURAmount: string;
  transferData?: TransferDataEVM; 
}

Solana

import type { TransferDataSolana } from '@holyheld/sdk';

type ConvertTopUpDataSolana = {
  tokenAmount: string;
  EURAmount: string;
  transferData?: TransferDataSolana; 
}