Bebop JAM

The following guide explains how to use Liquorice together with Bebop JAM API

1. Providing JamSettlement address in the RFQ

From the perspective of Liquorice, trade is performed with the JamSettlement contract, not directly with the trader.

Therefore, a solver must first and foremost provide the address of the JamSettlement smart contract in both trader and effectiveTrader fields of the RFQ message.

• REST API RFQ

• WS API RFQ

2. Calling JamSettlement.settle function

2.1 Solver data argument

During the settlement process, funds from the trader must first be transferred to the JamSettlement contract.

For this reason, balanceRecipient of the ExecInfo.SolverData has to be set to the address of the JamSettlement contract.

Solidity example

ExecInfo.SolverData memory solverData = ExecInfo.SolverData(<jam-settlement>, 10_000);

2.2. Jam Interactions argument

To assemble Jam Interactions, solver would need to use following fields from the Quote payload

• baseToken

• baseTokenAmount

• tx

Reference

• REST API Quote

• WS API Quote

Approval

When performing the trade, Liquorice Balance Manager contract must have a baseToken approval given by the JamSettlement contract.

Quote interactions

The rest of the interactions must be assembled from the interactions and market fields.

Solidity example

struct Transaction {
  address to;
  bytes data;
}

struct Allowance {
  address token;
  address spender;
  uint256 amount;
}

struct LiquoriceRFQQuoteLevel {
  address baseToken;
  uint256 baseTokenAmount;
  Transaction tx;
  Allowance[] allowances;
}

function getJamInteractions(LiquoriceRFQQuoteLevel calldata quoteLevel) public pure returns (JamInteraction.Data[] memory interactions) {
  uint256 allowancesLength = quoteLevel.allowances.length;
  interactions = new JamInteraction.Data[](allowancesLength + 1);

  for (uint256 i = 0; i < allowancesLength; i++) {
    interactions[i] = JamInteraction.Data(
      true,
      quoteLevel.allowances[i].token,
      0,
      abi.encodeWithSelector(IERC20.approve.selector, quoteLevel.allowances[i].spender, quoteLevel.allowances[i].amount)
    );
  }

  interactions[allowancesLength] = JamInteraction.Data(true, quoteLevel.tx.to, 0, quoteLevel.tx.data);

  return interactions;
}

2.3 Rest arguments

Remaining arguments such as hooks, signature and order provided as is.