Skip to main content

Link.deposit

Link reference tool

Check out our Link reference tool to understand how Link methods work without having to write any code.

SDK v1.3.30+ used with Link UI supports different ways to deposit ETH and whitelisted ERC20 tokens, for example, USDC, GODS or IMX tokens.

Currency support

Right now, Immutable X only supports ETH and whitelisted ERC20 tokens.

Immutable X is not prescriptive in how marketplaces handle the deposit process. There are several optional parameters you can use for your marketplace, to influence the user journey for the deposit.

Available parameters:

{
type: ETH,
amount?: PositiveNumberStringC
}

{
amount: PositiveNumberStringC
}

{
type: ERC20,
tokenAddress: EthAddress,
symbol: string,
amount?: PositiveNumberStringC
}

Usage

If a marketplace provides only amount, or ETH type with amount, the system will deposit in ETH. This can be used when a marketplace only wants to allow deposits in ETH and / or wants to style the deposit form with their own branding.

link.deposit({
amount: '0.1',
});

// or

link.deposit({
type: 'ETH',
amount: '0.1',
});

Deposit ETH Amount

If a marketplace provides token information and amount, users will be asked to confirm the deposit. This can be used when users are provided with a shortcut like "deposit 1 GODS token", or if the marketplace wants to style the deposit form for branding purposes.

link.deposit({
amount: '10',
type: 'ERC20',
symbol: 'USDC',
tokenAddress: '0x07865c6e87b9f70255377e024ace6630c1eaa37f',
});

Deposit USDC Amount

If a marketplace provides only token information, users will be asked to provide an amount and confirm the deposit. This can be used when users are provided with a shortcut like "deposit GODS" or, again, to add brand-specific styling to the form.

link.deposit({
type: 'ERC20',
symbol: 'GODS',
tokenAddress: '0x4c04c39fb6d2b356ae8b06c47843576e32a1963e',
});

Deposit Token Provided

If a marketplace provides no parameters, users will be asked to select a currency and the amount before confirming the deposit. This can be used if marketplaces prefer to rely on currencies and forms with Immutable branding.

link.deposit();

Deposit Without Params

Errors

See error responses here.

IMX Whitepaper IMX Tokenomics Block Explorer Careers Contact Us