Class Checkout

constructor

• new Checkout(config?): checkout.Checkout

• Constructs a new instance of the CheckoutModule class.

  Parameters

  • Optional config: checkout.CheckoutModuleConfiguration

    The configuration object for the CheckoutModule.

  Returns checkout.Checkout

Readonly config

Readonly fiatRampService

Readonly availability

Optional Readonly passport

Static isWeb3Provider

• isWeb3Provider(web3Provider): boolean

• Checks if the given object is a Web3 provider.

  Parameters

  • web3Provider: Web3Provider

    The object to check.

  Returns boolean

  • True if the object is a Web3 provider, false otherwise.

widgets

• widgets(init): Promise<WidgetsFactory>

• Loads the widgets bundle and initiate the widgets factory.

  Parameters

  • init: WidgetsInit

    The initialisation parameters for loading the widgets bundle and applying configuration

  Returns Promise<WidgetsFactory>

createProvider

• createProvider(params): Promise<checkout.CreateProviderResult>

• Creates a provider using the given parameters.

  Parameters

  • params: checkout.CreateProviderParams

    The parameters for creating the provider.

  Returns Promise<checkout.CreateProviderResult>

  A promise that resolves to the created provider.

getInjectedProviders

• getInjectedProviders(): readonly checkout.EIP6963ProviderDetail[]

• Returns a list of EIP-6963 injected providers and their metadata.

  Returns readonly checkout.EIP6963ProviderDetail[]

findInjectedProvider

• findInjectedProvider(args): undefined | checkout.EIP6963ProviderDetail

• Finds an injected provider by its RDNS.

  Parameters

  • args: {
        rdns: string;
    }

    The parameters for finding the injected provider.

    • rdns: string

  Returns undefined | checkout.EIP6963ProviderDetail

  • The found provider and metadata or undefined.

onInjectedProvidersChange

• onInjectedProvidersChange(listener): (() => void)

• Subscribes to changes in the injected providers.

  Parameters

  • listener: ((providers) => void)

    The listener to be called when the injected providers change.

    • • (providers): void

      • Parameters

        • providers: checkout.EIP6963ProviderDetail[]

        Returns void

  Returns (() => void)

  • • (): void

    • Subscribes to changes in the injected providers.

      Returns void

checkIsWalletConnected

• checkIsWalletConnected(params): Promise<checkout.CheckConnectionResult>

• Checks if a wallet is connected to the specified provider.

  Parameters

  • params: checkout.CheckConnectionParams

    The parameters for checking the wallet connection.

  Returns Promise<checkout.CheckConnectionResult>

  • A promise that resolves to the result of the check.

connect

• connect(params): Promise<checkout.ConnectResult>

• Connects to a blockchain network using the specified provider.

  Parameters

  • params: checkout.ConnectParams

    The parameters for connecting to the network.

  Returns Promise<checkout.ConnectResult>

  A promise that resolves to an object containing the provider and network information.

  Throws

  If the provider is not valid or if there is an error connecting to the network.

addNetwork

• addNetwork(params): Promise<any>

• Adds the network for the current wallet provider.

  Parameters

  • params: AddNetworkParams

    The parameters for adding the network.

  Returns Promise<any>

  • A promise that resolves to the result of adding the network.

switchNetwork

• switchNetwork(params): Promise<checkout.SwitchNetworkResult>

• Switches the network for the current wallet provider.

  Parameters

  • params: checkout.SwitchNetworkParams

    The parameters for switching the network.

  Returns Promise<checkout.SwitchNetworkResult>

  • A promise that resolves to the result of switching the network.

getTokenInfo

• getTokenInfo(params): Promise<checkout.TokenInfo>

• Retrieves the token information given the token address. This function makes RPC calls to ERC20 contracts to fetch the main contract information (e.g. symbol).

  Parameters

  • params: checkout.GetTokenInfoParams

    The parameters for retrieving the token information.

  Returns Promise<checkout.TokenInfo>

  • A promise that resolves to the token info request.

getBalance

• getBalance(params): Promise<checkout.GetBalanceResult>

• Retrieves the balance of a wallet address.

  Parameters

  • params: checkout.GetBalanceParams

    The parameters for retrieving the balance.

  Returns Promise<checkout.GetBalanceResult>

  • A promise that resolves to the balance result.

getAllBalances

• getAllBalances(params): Promise<checkout.GetAllBalancesResult>

• Retrieves the balances of all tokens for a given wallet address on a specific chain.

  Parameters

  • params: checkout.GetAllBalancesParams

    The parameters for retrieving the balances.

  Returns Promise<checkout.GetAllBalancesResult>

  • A promise that resolves to the result of retrieving the balances.

getNetworkAllowList

• getNetworkAllowList(params): Promise<checkout.GetNetworkAllowListResult>

• Retrieves the supported networks based on the provided parameters.

  Parameters

  • params: checkout.GetNetworkAllowListParams

    The parameters for retrieving the network allow list.

  Returns Promise<checkout.GetNetworkAllowListResult>

  • A promise that resolves to the network allow list result.

getTokenAllowList

• getTokenAllowList(params): Promise<checkout.GetTokenAllowListResult>

• Retrieves the supported tokens based on the provided parameters.

  Parameters

  • params: checkout.GetTokenAllowListParams

    The parameters for retrieving the token allow list.

  Returns Promise<checkout.GetTokenAllowListResult>

  • A promise that resolves to the token allow list result.

getWalletAllowList

• getWalletAllowList(params): Promise<checkout.GetWalletAllowListResult>

• Retrieves the default supported wallets based on the provided parameters.

  Parameters

  • params: checkout.GetWalletAllowListParams

    The parameters for retrieving the wallet allow list.

  Returns Promise<checkout.GetWalletAllowListResult>

  • A promise that resolves to the wallet allow list result.

sendTransaction

• sendTransaction(params): Promise<checkout.SendTransactionResult>

• Sends a transaction using the specified provider and transaction parameters.

  Parameters

  • params: checkout.SendTransactionParams

    The parameters for sending the transaction.

  Returns Promise<checkout.SendTransactionResult>

  A promise that resolves to the result of the transaction.

providerCall

• providerCall<T>(web3Provider, block): Promise<T>

• Wraps a Web3Provider call to validate the provider and handle errors.

  Type Parameters

  • T

  Parameters

  • web3Provider: Web3Provider

    The provider to connect to the network.

  • block: ((web3Provider) => Promise<T>)

    The block executing the provider call.

    • • (web3Provider): Promise<T>

      • Parameters

        • web3Provider: Web3Provider

        Returns Promise<T>

  Returns Promise<T>

  Returns the result of the provided block param.

getNetworkInfo

• getNetworkInfo(params): Promise<checkout.NetworkInfo>

• Retrieves network information using the specified provider.

  Parameters

  • params: checkout.GetNetworkParams

    The parameters for retrieving network information.

  Returns Promise<checkout.NetworkInfo>

  A promise that resolves to the network information.

buy

• buy(params): Promise<checkout.BuyResult>

• Determines the requirements for performing a buy.

  Parameters

  • params: checkout.BuyParams

    The parameters for the buy.

  Returns Promise<checkout.BuyResult>

  Deprecated

  Please use orderbook.fulfillOrder or orderbook.fulfillBulkOrders instead. The smartCheckout method can still be used to ensure the transaction requirements are met before preparing the order fulfillment

sell

• sell(params): Promise<checkout.SellResult>

• Determines the requirements for performing a sell.

  Parameters

  • params: checkout.SellParams

    The parameters for the sell. Only currently actions the first order in the array until we support batch processing. Only currently actions the first fee in the fees array of each order until we support multiple fees.

  Returns Promise<checkout.SellResult>

  Deprecated

  Please use orderbook.prepareListing or orderbook.prepareBulkListing instead. The smartCheckout method can still be used to ensure the transaction requirements are met before preparing the listing

cancel

• cancel(params): Promise<checkout.CancelResult>

• Cancels a sell.

  Parameters

  • params: checkout.CancelParams

    The parameters for the cancel.

  Returns Promise<checkout.CancelResult>

  Deprecated

  Please use orderbook.prepareOrderCancellations instead.

smartCheckout

• smartCheckout(params): Promise<checkout.SmartCheckoutResult>

• Determines the transaction requirements to complete a purchase.

  Parameters

  • params: checkout.SmartCheckoutParams

  Returns Promise<checkout.SmartCheckoutResult>

  Params

  params - The parameters for smart checkout.

gasEstimate

• gasEstimate(params): Promise<checkout.GasEstimateSwapResult | checkout.GasEstimateBridgeToL2Result>

• Estimates the gas required for a swap or bridge transaction.

  Parameters

  • params: checkout.GasEstimateParams

    The parameters for the gas estimation.

  Returns Promise<checkout.GasEstimateSwapResult | checkout.GasEstimateBridgeToL2Result>

  • A promise that resolves to the gas estimation result.

createFiatRampUrl

• createFiatRampUrl(params): Promise<string>

• Creates and returns a URL for the fiat ramp widget.

  Parameters

  • params: checkout.FiatRampParams

    The parameters for creating the url.

  Returns Promise<string>

  • A promise that resolves to a string url.

getExchangeFeeEstimate

• getExchangeFeeEstimate(): Promise<checkout.OnRampProviderFees>

• Fetches fiat ramp fee estimations.

  Returns Promise<checkout.OnRampProviderFees>

  • A promise that resolves to OnRampProviderFees.

isSwapAvailable

• isSwapAvailable(): Promise<boolean>

• Fetches Swap widget availability.

  Returns Promise<boolean>

  • A promise that resolves to a boolean.