delegate.md

Delegate

Delegate is a contract that allows users to set on-chain trading rules that accept and execute AirSwap orders that meet price criteria. In terms of the underlying SwapERC20 protocol, a trader setting rules is authorizing the Delegate to act as sender on its behalf. The trader interfacing with the delegate is the signer of each order. Delegate acts as an on-chain intermediary for cases where a Trader does not have an immediate counterparty or wishes to make an order publicly available.

See the deployments page for latest deployed Delegate contract addresses.

Rules

To enable Delegate call the setRule function. Token approvals must be set up by senderWallet on the senderToken to allow Delegate to act as a spender.

function setRule(
  address senderWallet,
  address senderToken,
  uint256 senderAmount,
  address signerToken,
  uint256 signerAmount,
  uint256 expiry
) external;

Rules can be updated using setRule again or deleted using unsetRule.

function unsetRule(
  address senderWallet,
  address senderToken,
  address signerToken
) external;

Swaps

To trade with Delegate, query event logs SetRule and UnsetRule for pricing information. With price in hand, create and sign an order at any time and call swap on the Delegate contract. Upon success, Delegate emits a DelegateSwap event.

function swap(
  address senderWallet,
  uint256 nonce,
  uint256 expiry,
  address signerWallet,
  address signerToken,
  uint256 signerAmount,
  address senderToken,
  uint256 senderAmount,
  uint8 v,
  bytes32 r,
  bytes32 s
) external

Delegate uses SwapERC20 swapLight behind the scenes to complete the swap.

Managers

A wallet usually manages its own rules. A wallet may authorize another wallet to manage rules on its behalf; for example, a cold wallet may authorize a hot wallet. To authorize a manager, call the authorize function on the Delegate.

function authorize(address manager) external

Delegate will emit an Authorize event. To revoke an existing authorization, call revoke on the Delegate.

function revoke() external

Delegate will emit a Revoke event.