Class AllbridgeCoreSdk

constructor

• new AllbridgeCoreSdk(
      nodeUrls: NodeUrlsConfig | NodeRpcUrls,
      params?: AllbridgeCoreSdkOptions,
  ): AllbridgeCoreSdk

  Initializes the SDK object.

  Parameters

  • nodeUrls: NodeUrlsConfig | NodeRpcUrls

    node rpc urls for full functionality

  • params: AllbridgeCoreSdkOptions = mainnet

    Optional. If not defined, the default mainnet parameters are used.

  Returns AllbridgeCoreSdk

bridge

Readonlyparams

pool

utils

yield

aprInPercents

• aprInPercents(apr: string): string

  Convert APR to percentage view

  Parameters

  • apr: string

  Returns string

  aprPercentageView

  Deprecated

  Do not use.

calculateFeePercentOnDestinationChain

• calculateFeePercentOnDestinationChain(
      amountFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
  ): Promise<number>

  Parameters

  • amountFloat: BigSource

    initial amount of tokens to swap

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain

  • destinationChainToken: TokenWithChainDetails

    selected token on the destination chain

  Returns Promise<number>

  fee percent

  Deprecated

  Calculates the percentage of fee that is charged when swapping to the selected destination chain. The destination chain fee percent applies to the amount after the source chain fee. (Does not include fee related to the source chain. Does not include gas fee)

  See

  calculateFeePercentOnSourceChain

calculateFeePercentOnSourceChain

• calculateFeePercentOnSourceChain(
      amountFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
  ): Promise<number>

  Parameters

  • amountFloat: BigSource

    initial amount of tokens to swap

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain

  Returns Promise<number>

  fee percent

  Deprecated

  Calculates the percentage of fee from the initial amount that is charged when swapping from the selected source chain. (Does not include fee related to the destination chain. Does not include gas fee)

chainDetailsMap

• chainDetailsMap(type: "pool"): Promise<ChainDetailsMap>

  Parameters

  • type: "pool"

  Returns Promise<ChainDetailsMap>

  Deprecated

  Do not use.

• chainDetailsMap(type?: "swap"): Promise<ChainDetailsMap>

  Parameters

  • Optionaltype: "swap"

  Returns Promise<ChainDetailsMap>

  Deprecated

  Do not use.

• chainDetailsMap(type: "pool" | "swap"): Promise<ChainDetailsMap>

  Parameters

  • type: "pool" | "swap"

  Returns Promise<ChainDetailsMap>

  Deprecated

  Do not use.

checkAddress

• checkAddress(
      _chainSymbol: string,
      _recipientAddress: string,
      _tokenAddress?: string,
  ): Promise<CheckAddressResponse>

  Check address and show gas balance

  Parameters

  • _chainSymbol: string

    The symbol of the chain representing one of the supported blockchain networks (e.g., "ETH" for Ethereum). For more details, see: ChainSymbol.

  • _recipientAddress: string
  • Optional_tokenAddress: string

  Returns Promise<CheckAddressResponse>

  Deprecated

getAmountFromVUsd

• getAmountFromVUsd(
      vUsdAmount: string,
      destToken: TokenWithChainDetails,
  ): Promise<AmountFormatted>

  Parameters

  • vUsdAmount: string

    amount of vUsd, int format

  • destToken: TokenWithChainDetails

    selected token on the destination chain

  Returns Promise<AmountFormatted>

  amount of destToken

  Deprecated

  Do not use.

getAmountToBeReceived

• getAmountToBeReceived(
      amountToSendFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: LegacyMessenger,
  ): Promise<string>

  Parameters

  • amountToSendFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: LegacyMessenger

  Returns Promise<string>

  Deprecated

  Do not use.

• getAmountToBeReceived(
      amountToSendFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: ActiveMessenger,
  ): Promise<string>

  Parameters

  • amountToSendFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: ActiveMessenger

  Returns Promise<string>

  Deprecated

  Do not use.

getAmountToBeReceivedAndGasFeeOptions

• getAmountToBeReceivedAndGasFeeOptions(
      amountToSendFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
  ): Promise<AmountsAndGasFeeOptions>

  Calculates the amount of tokens to be received as a result of transfer and fetches GasFeeOptions which contains available ways to pay the gas fee.

  Parameters

  • amountToSendFloat: BigSource

    the amount of tokens that will be sent

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain

  • destinationChainToken: TokenWithChainDetails

    selected token on the destination chain

  • messenger: Messenger

  Returns Promise<AmountsAndGasFeeOptions>

  Deprecated

  Use getGasFeeOptions and separately call one of: getAmountToBeReceived, getAmountToBeReceivedFromChain, or getAmountToBeReceivedFromPools.

getAmountToBeReceivedFromChain

• getAmountToBeReceivedFromChain(
      amountToSendFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
      sourceProvider?: Provider,
      destinationProvider?: Provider,
  ): Promise<string>

  Parameters

  • amountToSendFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: Messenger
  • OptionalsourceProvider: Provider
  • OptionaldestinationProvider: Provider

  Returns Promise<string>

  Deprecated

  Do not use.

getAmountToBeReceivedFromPools

• getAmountToBeReceivedFromPools(
      amountToSendFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      sourcePool: PoolInfo,
      destinationPool: PoolInfo,
      messenger: ALLBRIDGE | WORMHOLE | CCTP | CCTP_V2 | X_RESERVE,
  ): string

  Parameters

  • amountToSendFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • sourcePool: PoolInfo
  • destinationPool: PoolInfo
  • messenger: ALLBRIDGE | WORMHOLE | CCTP | CCTP_V2 | X_RESERVE

  Returns string

  Deprecated

  Do not use.

getAmountToSend

• getAmountToSend(
      amountToBeReceivedFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: LegacyMessenger,
  ): Promise<string>

  Parameters

  • amountToBeReceivedFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: LegacyMessenger

  Returns Promise<string>

  Deprecated

  Do not use.

• getAmountToSend(
      amountToBeReceivedFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: ActiveMessenger,
  ): Promise<string>

  Parameters

  • amountToBeReceivedFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: ActiveMessenger

  Returns Promise<string>

  Deprecated

  Do not use.

getAmountToSendAndGasFeeOptions

• getAmountToSendAndGasFeeOptions(
      amountToBeReceivedFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
  ): Promise<AmountsAndGasFeeOptions>

  Calculates the amount of tokens to send based on requested tokens amount be received as a result of transfer. and fetches GasFeeOptions which contains available ways to pay the gas fee.

  Parameters

  • amountToBeReceivedFloat: BigSource

    the amount of tokens that should be received

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain

  • destinationChainToken: TokenWithChainDetails

    selected token on the destination chain

  • messenger: Messenger

  Returns Promise<AmountsAndGasFeeOptions>

  Deprecated

  Use getGasFeeOptions and separately call one of: getAmountToSend, getAmountToSendFromChain, or getAmountToSendFromPools.

getAmountToSendFromChain

• getAmountToSendFromChain(
      amountToBeReceivedFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
      sourceProvider?: Provider,
      destinationProvider?: Provider,
  ): Promise<string>

  Parameters

  • amountToBeReceivedFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: Messenger
  • OptionalsourceProvider: Provider
  • OptionaldestinationProvider: Provider

  Returns Promise<string>

  Deprecated

  Do not use.

getAmountToSendFromPools

• getAmountToSendFromPools(
      amountToBeReceivedFloat: BigSource,
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      sourcePool: PoolInfo,
      destinationPool: PoolInfo,
      messenger: ALLBRIDGE | WORMHOLE | CCTP | CCTP_V2 | X_RESERVE,
  ): string

  Parameters

  • amountToBeReceivedFloat: BigSource
  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • sourcePool: PoolInfo
  • destinationPool: PoolInfo
  • messenger: ALLBRIDGE | WORMHOLE | CCTP | CCTP_V2 | X_RESERVE

  Returns string

  Deprecated

  Do not use.

getAverageTransferTime

• getAverageTransferTime(
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
  ): number | null

  Gets the average time in ms to complete a transfer for given tokens and messenger.

  Parameters

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain.

  • destinationChainToken: TokenWithChainDetails

    selected token on the destination chain.

  • messenger: Messenger

  Returns number | null

  Average transfer time in milliseconds or null if a given combination of tokens and messenger is not supported.

getExtraGasMaxLimits

• getExtraGasMaxLimits(
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: LegacyMessenger,
  ): Promise<ExtraGasMaxLimitResponse>

  Parameters

  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: LegacyMessenger

  Returns Promise<ExtraGasMaxLimitResponse>

  Deprecated

  Do not use.

• getExtraGasMaxLimits(
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: ActiveMessenger,
  ): Promise<ExtraGasMaxLimitResponse>

  Parameters

  • sourceChainToken: TokenWithChainDetails
  • destinationChainToken: TokenWithChainDetails
  • messenger: ActiveMessenger

  Returns Promise<ExtraGasMaxLimitResponse>

  Deprecated

  Do not use.

getGasBalance

• getGasBalance(chainSymbol: string, address: string): Promise<GasBalanceResponse>

  Get gas balance

  Parameters

  • chainSymbol: string

    The symbol of the chain representing one of the supported blockchain networks (e.g., "ETH" for Ethereum). For more details, see: ChainSymbol.

  • address: string

  Returns Promise<GasBalanceResponse>

getGasFeeOptions

• getGasFeeOptions(
      sourceChainToken: TokenWithChainDetails,
      destinationChainToken: TokenWithChainDetails,
      messenger: Messenger,
  ): Promise<GasFeeOptions>

  Fetches possible ways to pay the transfer gas fee.

  Parameters

  • sourceChainToken: TokenWithChainDetails

    selected token on the source chain

  • destinationChainToken: TokenWithChainDetails

    selected token on the destination chain

  • messenger: Messenger

  Returns Promise<GasFeeOptions>

  GasFeeOptions

getNativeTokenBalance

• getNativeTokenBalance(
      params: GetNativeTokenBalanceParams,
      provider?: Provider,
  ): Promise<AmountFormatted>

  Get native (gas) token balance

  Parameters

  • params: GetNativeTokenBalanceParams
  • Optionalprovider: Provider

  Returns Promise<AmountFormatted>

  Token balance

getPendingStatusInfo

• getPendingStatusInfo(
      amount: string,
      amountFormat: AmountFormat,
      sourceToken: TokenWithChainDetails,
      destToken: TokenWithChainDetails,
  ): Promise<PendingStatusInfoResponse>

  Returns information about pending transactions for the same destination chain and the amount of tokens can be received as a result of transfer considering pending transactions.

  Parameters

  • amount: string

    the amount of tokens that will be sent

  • amountFormat: AmountFormat

    amount format

  • sourceToken: TokenWithChainDetails

    selected token transfer from

  • destToken: TokenWithChainDetails

    selected token transfer to

  Returns Promise<PendingStatusInfoResponse>

  range of possible amount based on already pending transactions

  Deprecated

  Do not use.

getPoolInfoByToken

• getPoolInfoByToken(token: TokenWithChainDetails): Promise<PoolInfo>

  Gets information about the poolInfo by token

  Parameters

  • token: TokenWithChainDetails

  Returns Promise<PoolInfo>

  poolInfo

  Deprecated

  Do not use.

getSendAmountDetails

• getSendAmountDetails(
      amount: string,
      amountFormat: AmountFormat,
      sourceToken: TokenWithChainDetails,
      destToken: TokenWithChainDetails,
  ): Promise<SendAmountDetails>

  Show amount changes (fee and amount adjustment) during send through pools on source and destination chains

  Parameters

  • amount: string
  • amountFormat: AmountFormat
  • sourceToken: TokenWithChainDetails
  • destToken: TokenWithChainDetails

  Returns Promise<SendAmountDetails>

  Deprecated

  Do not use.

getTokenBalance

• getTokenBalance(
      params: GetTokenBalanceParams,
      provider?: Provider,
  ): Promise<string>

  Get token balance

  Parameters

  • params: GetTokenBalanceParams
  • Optionalprovider: Provider

  Returns Promise<string>

  Token balance

getTransferStatus

• getTransferStatus(
      chainSymbol: string,
      txId: string,
  ): Promise<TransferStatusResponse>

  Fetches information about tokens transfer by chosen chainSymbol and transaction Id from the Allbridge Core API.

  Parameters

  • chainSymbol: string

    The symbol of the chain representing one of the supported blockchain networks (e.g., "ETH" for Ethereum). For more details, see: ChainSymbol.

  • txId: string

  Returns Promise<TransferStatusResponse>

getVUsdFromAmount

• getVUsdFromAmount(
      amount: string,
      amountFormat: AmountFormat,
      sourceToken: TokenWithChainDetails,
  ): Promise<AmountFormatted>

  Parameters

  • amount: string

    amount

  • amountFormat: AmountFormat

    AmountFormat

  • sourceToken: TokenWithChainDetails

    selected token on the source chain

  Returns Promise<AmountFormatted>

  virtual amount

  Deprecated

  Do not use.

refreshPoolInfo

• refreshPoolInfo(
      tokens?: TokenWithChainDetails | TokenWithChainDetails[],
  ): Promise<void>

  Forces refresh of cached information about the state of liquidity pools. Outdated cache leads to calculated amounts being less accurate. The cache is invalidated at regular intervals, but it can be forced to be refreshed by calling this method.+

  Parameters

  • Optionaltokens: TokenWithChainDetails | TokenWithChainDetails[]

    if present, the corresponding liquidity pools will be updated

  Returns Promise<void>

  Deprecated

  Do not use.

swapAndBridgeFeeCalculation

• swapAndBridgeFeeCalculation(
      amountInTokenPrecision: string,
      sourceToken: TokenWithChainDetails,
      destToken: TokenWithChainDetails,
  ): Promise<SwapAndBridgeCalculationData>

  Parameters

  • amountInTokenPrecision: string
  • sourceToken: TokenWithChainDetails
  • destToken: TokenWithChainDetails

  Returns Promise<SwapAndBridgeCalculationData>

  Deprecated

  Use getSendAmountDetails

swapAndBridgeFeeCalculationReverse

• swapAndBridgeFeeCalculationReverse(
      amountInTokenPrecision: string,
      sourceToken: TokenWithChainDetails,
      destToken: TokenWithChainDetails,
  ): Promise<SwapAndBridgeCalculationData>

  Parameters

  • amountInTokenPrecision: string
  • sourceToken: TokenWithChainDetails
  • destToken: TokenWithChainDetails

  Returns Promise<SwapAndBridgeCalculationData>

  Deprecated

  Use getAmountToBeReceived and then getSendAmountDetails

tokens

• tokens(type: "pool"): Promise<TokenWithChainDetails[]>

  Parameters

  • type: "pool"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.

• tokens(type?: "swap"): Promise<TokenWithChainDetails[]>

  Parameters

  • Optionaltype: "swap"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.

• tokens(type: "pool" | "swap"): Promise<TokenWithChainDetails[]>

  Parameters

  • type: "pool" | "swap"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.

tokensByChain

• tokensByChain(
      chainSymbol: string,
      type: "pool",
  ): Promise<TokenWithChainDetails[]>

  Parameters

  • chainSymbol: string
  • type: "pool"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.

• tokensByChain(
      chainSymbol: string,
      type?: "swap",
  ): Promise<TokenWithChainDetails[]>

  Parameters

  • chainSymbol: string
  • Optionaltype: "swap"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.

• tokensByChain(
      chainSymbol: string,
      type: "pool" | "swap",
  ): Promise<TokenWithChainDetails[]>

  Parameters

  • chainSymbol: string
  • type: "pool" | "swap"

  Returns Promise<TokenWithChainDetails[]>

  Deprecated

  Do not use.