Zap withdraw

Continuing from #id-4.-select-an-use-case.

Zap withdraw enables users to withdraw an asset and swap it for any token in one transaction.

• Source token: the token to be withdrawn from a lending protocol.

• Destination token: the token that the user receives.

5. Preview the estimated post-zap-withdraw portfolio

By specifying the source token, the source token amount, and the destination token, the function will return the destination token amount, the updated user portfolio, and the logics to be executed.

// User obtains a quotation for zap withdraw
const srcToken = mainnetTokens.WBTC;
const srcAmount = '1';
const destToken = mainnetTokens.USDC;
const zapWithdrawInfo = await adapter.zapWithdraw({
  account,
  portfolio,
  srcToken,
  srcAmount,
  destToken
});

The logic should include:

1. Withdraw the source token

2. Swap the source token to the destination token

6. Obtain the required approval permission and send the router transaction

To perform the logics, certain approvals need to be processed. You may refer to Estimate Router Data and Send Router Transaction for more details.

// User needs to permit the Protocolink user agent to borrow for the user
const estimateResult = await apisdk.estimateRouterData(
  { chainId, account, logics: zapWithdrawInfo.logics }
);

// User obtains a zap withdraw transaction request
const routerData: apisdk.RouterData = {
  chainId,
  account,
  logics: zapWithdrawInfo.logics
};
const transactionRequest = await apisdk.buildRouterTransactionRequest(routerData);