Examples

Vertex executes EIP712 typed data examples

The following are full examples of EIP12 typed data for each of Vertex's executes. Each execute includes a sender field which is a solidity bytes32 . There are two components to this field:

• an address that is a bytes20

• a subaccount identifier that is a bytes12

For example, if your address was 0x7a5ec2748e9065794491a8d29dcf3f9edb8d7c43, and you wanted to use the default subaccount identifier (i.e: an empty identifier "") you can set sender to 0x7a5ec2748e9065794491a8d29dcf3f9edb8d7c43000000000000000000000000 , which sets all bytes of the subaccount identifier to 0.

Note: a bytes32 representation of the sender must used when signing the request.

See below a sample util to convert a hex to a bytes32:

Python

def hex_to_bytes32(hex_string):
    if hex_string.startswith("0x"):
        hex_string = hex_string[2:]
    data_bytes = bytes.fromhex(hex_string)
    padded_data = data_bytes + b"\x00" * (32 - len(data_bytes))
    return padded_data

sender = hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000')

Typescript

import { arrayify } from 'ethers/lib/utils';

export function hexToBytes32(subaccount: string) {
  const subaccountBytes = arrayify(subaccount);
  const bytes32 = new Uint8Array(32);
  for (let i = 0; i < Math.min(subaccountBytes.length, 32); i++) {
    bytes32[i] = subaccountBytes[i];
  }
  return bytes32;
}

const sender = hexToBytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000')

EIP712 Typed data examples

Place Order

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'Order': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'priceX18', 'type': 'int128'},
            {'name': 'amount', 'type': 'int128'},
            {'name': 'expiration', 'type': 'uint64'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'Order',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xf03f457a30e598d5020164a339727ef40f2b8fbc'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'priceX18': 28898000000000000000000,
        'amount': -10000000000000000,
        'expiration': 4611687701117784255,
        'nonce': 1764428860167815857,
    },
}

Cancel Orders

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'Cancellation': [
            { 'name': 'sender', 'type': 'bytes32' },
            { 'name': 'productIds', 'type': 'uint32[]'},
            { 'name': 'digests', 'type': 'bytes32[]'},
            { 'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'Cancellation',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'productIds': [4],
        'digests': [hex_to_bytes32('0x51ba8762bc5f77957a4e896dba34e17b553b872c618ffb83dba54878796f2821')],
        'nonce': 1,
    },
}

Cancel Product orders

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'CancellationProducts': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'productIds', 'type': 'uint32[]'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'CancellationProducts',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'productIds': [2, 4],
        'nonce': 1,
    },
}

Link Signer

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'LinkSigner': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'signer', 'type': 'bytes32'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'LinkSigner',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'signer': hex_to_bytes32('0x12a0b4888021576eb10a67616dd3dd3d9ce206b664656661756c740000000000'),
        'nonce': 1,
    },
}

Withdraw Collateral

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'WithdrawCollateral': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'productId', 'type': 'uint32'},
            {'name': 'amount', 'type': 'uint128'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'WithdrawCollateral',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'productId': 2,
        'amount': 10000000000000000,
        'nonce': 1
    },
}

Liquidate Subaccount

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'LiquidateSubaccount': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'liquidatee', 'type': 'bytes32'},
            {'name': 'productId', 'type': 'uint32'},
            {'name': 'isEncodedSpread', 'type': 'bool'},
            {'name': 'amount', 'type': 'int128'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'LiquidateSubaccount',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'liquidatee': hex_to_bytes32('0x12a0b4888021576eb10a67616dd3dd3d9ce206b664656661756c740000000000'),
        'productId': 1,
        'isEncodedSpread': false,
        'amount': 10000000000000000,
        'nonce': 1,
    },
}

Mint LP

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'MintLp': [
            {'name': 'sender', 'type': 'bytes32' },
            {'name': 'productId', 'type': 'uint32'},
            {'name': 'amountBase', 'type': 'uint128'},
            {'name': 'quoteAmountLow', 'type': 'uint128'},
            {'name': 'quoteAmountHigh', 'type': 'uint128'},
            {'name': 'nonce', 'type': 'uint64' },
        ],
    },
    'primaryType': 'MintLp',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'productId': 1,
        'amountBase': 1000000000000000000,
        'quoteAmountLow': 20000000000000000000000,
        'quoteAmountHigh': 40000000000000000000000,
        'nonce': 1,
    },
}

Burn LP

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'BurnLp': [
            {'name': 'sender', 'type': 'bytes32'},
            {'name': 'productId', 'type': 'uint32'},
            {'name': 'amount', 'type': 'uint128'},
            {'name': 'nonce', 'type': 'uint64'},
        ],
    },
    'primaryType': 'BurnLp',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'productId': 1,
        'amount': 1000000000000000000,
        'nonce': 1,
    },
}

List Trigger Orders

{
    'types': {
        'EIP712Domain': [
            {'name': 'name', 'type': 'string'},
            {'name': 'version', 'type': 'string'},
            {'name': 'chainId', 'type': 'uint256'},
            {'name': 'verifyingContract', 'type': 'address'}
        ],
        'ListTriggerOrders': [
            {'name': 'sender', 'type': 'bytes32' },
            {'name': 'recvTime', 'type': 'uint64' }
        ],
    },
    'primaryType': 'WithdrawCollateral',
    'domain': {
        'name': 'Vertex',
        'version': '0.0.1',
        'chainId': 421613,  
        'verifyingContract': '0xbf16e41fb4ac9922545bfc1500f67064dc2dcc3b'
    },
    'message': {
        'sender': hex_to_bytes32('0x841fe4876763357975d60da128d8a54bb045d76a64656661756c740000000000'),
        'recvTime': 1688939576000
    },
}