tradeAsset

Function Signature

public func tradeAsset(params: LifiTradeAssetParams) async throws -> LifiTradeAssetResult

Description Executes a complete Li.Fi bridge or swap: discovers routes, selects one, then for each step builds the transaction, signs and broadcasts it, waits for on-chain confirmation, and polls Li.Fi until that step reaches a terminal state before moving to the next. Steps run sequentially. Signing and confirmation for each step happen on that step’s own chain, resolved from the step itself, so a multi-chain route is handled without the caller switching networks. Confirmation is strict — every step must confirm on-chain before the next begins. A revert or a confirmation timeout aborts the trade and throws. There is no optimistic fallback. Unlike the React Native and Web SDKs, there is no second options argument. The signer and confirmation hooks are injected when the Lifi instance is constructed, and Portal wires both automatically. Parameters LifiTradeAssetParams:

Parameter	Type	Required	Description
`fromChain`	`String`	Yes	Source chain, CAIP-2 (`"eip155:8453"`).
`toChain`	`String`	Yes	Destination chain, CAIP-2.
`fromToken`	`String`	Yes	Source token contract address or symbol.
`toToken`	`String`	Yes	Destination token contract address or symbol.
`amount`	`String`	Yes	Amount in the token’s base units, as an integer string.
`fromAddress`	`String?`	No, but pass it	Sending wallet address. Forwarded to Li.Fi as given; the SDK does not resolve it for you.
`toAddress`	`String?`	No	Receiving wallet address. Falls back to `fromAddress`.
`routeIndex`	`Int?`	No	Which discovered route to execute. Default `0`.
`onProgress`	`LifiProgressHandler?`	No	Callback fired at each stage of execution.

Omitting fromAddress means routes are quoted without a sender while the transaction is still signed by your Portal wallet, so the quote may not match what executes. Pass it explicitly.

Returns LifiTradeAssetResult:

Property	Type	Description
`hashes`	`[String]`	One transaction hash per executed step, in execution order.
`steps`	`[LifiStep]`	The enriched steps that were executed, with `transactionRequest` populated.
`route`	`LifiRoute`	The route that was selected and executed.

Throws Throws LifiTradeAssetError:

Case	When
`missingSigner`	No signing closure on the `Lifi` instance. Cannot occur on `portal.trading.lifi`.
`missingConfirmation`	No confirmation closure on the `Lifi` instance. Cannot occur on `portal.trading.lifi`.
`noRoutesFound`	Li.Fi returned no routes for the requested trade.
`routeIndexOutOfBounds`	`routeIndex` is negative or beyond the number of discovered routes.
`routeHasNoSteps`	The selected route contains no steps.
`missingTransactionRequest`	A step came back without a transaction request to sign.
`invalidTransactionRequest`	A step’s transaction request was malformed.
`transactionConfirmationFailed(String)`	The step’s transaction reverted on-chain. Carries the transaction hash.
`transactionConfirmationTimedOut(String)`	Confirmation could not be determined before timing out. Carries the transaction hash.
`lifiTransferFailed(String)`	Li.Fi reported a `FAILED` terminal state.
`pollTimeout`	Status polling exceeded the configured timeout.

Also throws CancellationError if the surrounding Task is cancelled. In that case no .failed progress event is emitted — handle cancellation separately from failure. Example Usage

import PortalSwift

do {
    let fromAddress = try await portal.getAddress("eip155:8453")

    let result = try await portal.trading.lifi.tradeAsset(
        params: LifiTradeAssetParams(
            fromChain: "eip155:8453",
            toChain: "eip155:42161",
            fromToken: "ETH",
            toToken: "USDC",
            amount: "1000000000000",
            fromAddress: fromAddress,
            onProgress: { status, data in
                print("[Li.Fi] \(status.rawValue) \(data.txHash ?? "")")
            }
        )
    )

    print("Hashes: \(result.hashes)")
    print("Executed steps: \(result.steps.count)")
} catch let LifiTradeAssetError.transactionConfirmationFailed(txHash) {
    print("Transaction reverted on-chain: \(txHash)")
} catch {
    print("tradeAsset failed: \(error)")
}

Related Documentation

Getting Started

SDKs

APIs

Integrations

Resources