Every maker quote is an EIP-712 v2 secp256k1 signature over the SignQuote typed-data payload. The contract verifies that signature during settlement.
This guide is EIP-712 v2 only. Quote payloads must include sign_mode: "v2" and evm_chain_id. Do not sign JSON strings, eth_sign messages, or generic wallet typed-data payloads unless you have reproduced the exact digest used by the protocol.
There are two different chain IDs in every v2 quote. EIP-712 uses a field named chainId, but that value is the numeric EVM chain ID: 1439 on testnet or 1776 on mainnet. The MakerStream quote payload uses snake_case: chain_id is the Cosmos chain ID, and evm_chain_id is the numeric EVM chain ID. Passing 1439 or 1776 as quote.chain_id is invalid.
1. Decide whether to quote
For each request, decide:
- whether your maker is willing to fill it,
- how much quantity and margin to provide,
- what price to quote,
- how long the quote remains valid,
- and which maker subaccount nonce backs the quote.
Direction is from the taker’s perspective:
| Taker direction | Maker exposure |
|---|
long | Maker fills the short side |
short | Maker fills the long side |
margin and quantity may be smaller than the taker’s request for partial fills.
2. Canonicalize decimals
Decimal fields are signed as exact UTF-8 strings. These are different signed messages:
"14.85""14.850""14.8500"
Apply one canonicalization helper to every decimal field before signing and sending: price, taker margin, taker quantity, maker margin, maker quantity, minimum fill quantity, trigger price, and worst price.
from decimal import Decimal, ROUND_DOWN
def to_canonical(x, tick) -> str:
"""Quantize x to the market tick and emit a plain decimal string."""
return format(
Decimal(str(x)).quantize(
Decimal(str(tick)),
rounding=ROUND_DOWN,
).normalize(),
"f",
)
# "4.50" -> "4.5"
# "76462.0" -> "76462" # integer-tick market
# "110.00" -> "110"
3. EIP-712 domain
Quotes use this EIP-712 domain:
| Field | Value |
|---|
name | "RFQ" |
version | "1" |
chainId testnet | 1439 |
chainId mainnet | 1776 |
verifyingContract | EVM address derived from the RFQ contract bech32 address |
chainId is the EVM chain ID. It is not the Cosmos chain ID. This is the main naming collision in RFQ: chainId in the EIP-712 domain is not the same field as quote.chain_id in the MakerStream payload.
| Context | Testnet | Mainnet |
|---|
EIP-712 domain chainId | 1439 | 1776 |
Quote payload evm_chain_id | 1439 | 1776 |
Quote payload chain_id | injective-888 | injective-1 |
inj1qw7jk82hjvf79tnjykux6zacuh9gl0z0wl3ruk
4. SignQuote typed-data layout
The SignQuote message has 16 fields. Field order matters.
| # | Field | Type | Encoding |
|---|
| 1 | evmChainId | uint64 | Same EVM chain ID used in the domain and quote evm_chain_id |
| 2 | marketId | string | keccak256(utf8(s)) |
| 3 | rfqId | uint64 | Big-endian integer word |
| 4 | taker | address | 20-byte EVM address from taker inj1... |
| 5 | takerDirection | uint8 | 0 for long, 1 for short |
| 6 | takerMargin | string | keccak256(utf8(s)) |
| 7 | takerQuantity | string | keccak256(utf8(s)) |
| 8 | maker | address | 20-byte EVM address from maker inj1... |
| 9 | makerSubaccountNonce | uint32 | Big-endian integer word |
| 10 | makerQuantity | string | keccak256(utf8(s)) |
| 11 | makerMargin | string | keccak256(utf8(s)) |
| 12 | price | string | keccak256(utf8(s)); must be tick-quantized |
| 13 | expiryKind | uint8 | 0 for timestamp ms, 1 for block height |
| 14 | expiryValue | uint64 | Timestamp ms or block height |
| 15 | minFillQuantity | string | Use "0" when absent; never empty string |
| 16 | bindingKind | uint8 | 1 for current taker-bound RFQ quotes |
keccak256(0x19 || 0x01 || domainSeparator || keccak256(typeHash || encoded SignQuote fields))
bindingKind from whether taker is present. For current maker integrations, pass the taker address from the RFQ request. Do not add bindingKind to the quote payload, and do not pass a binding-kind helper argument for live taker-bound RFQs.
5. Sign with the helper
Use sign_quote_v2 from injective-rfq-toolkit.
import time
from rfq_test.crypto.eip712 import sign_quote_v2
expiry_ms = int(time.time() * 1000) + 2_000 # must be at least now + 1500ms
sig = sign_quote_v2(
private_key=MM_PRIVATE_KEY,
evm_chain_id=1439,
verifying_contract_bech32="inj1qw7jk82hjvf79tnjykux6zacuh9gl0z0wl3ruk",
market_id=MARKET.id,
rfq_id=int(rfq_id),
taker=taker_addr,
direction="long",
taker_margin="100",
taker_quantity="10",
maker=mm_addr,
maker_subaccount_nonce=0,
maker_margin="100",
maker_quantity="10",
price="14.85",
expiry_ms=expiry_ms,
min_fill_quantity=None,
)
0x-prefixed 65-byte signature (r || s || v) with compact y-parity v=0/1.
6. Send the same values
Send the exact strings and numbers you signed.
ack = await mm_ws.send_quote({
"chain_id": "injective-888",
"contract_address": "inj1qw7jk82hjvf79tnjykux6zacuh9gl0z0wl3ruk",
"rfq_id": int(rfq_id),
"market_id": MARKET.id,
"taker_direction": "long",
"margin": "100",
"quantity": "10",
"price": "14.85",
"expiry": expiry_ms,
"maker": mm_addr,
"maker_subaccount_nonce": 0,
"taker": taker_addr,
"signature": sig,
"sign_mode": "v2",
"evm_chain_id": 1439,
}, wait_for_response=True, response_timeout=5.0)
chain_id is still the Cosmos chain ID. evm_chain_id is the EVM chain ID embedded in the EIP-712 domain. Do not send 1439 or 1776 in chain_id.
Common failures
| Symptom | Fix |
|---|
sign_mode required or empty signing mode | Include "sign_mode": "v2" on every quote payload |
| Wrong chain ID | Use 1439 / 1776 in EIP-712 domain chainId and quote evm_chain_id; use injective-888 / injective-1 in quote chain_id |
invalid_signature | Check field order, EVM-form verifying contract, compact v=0/1, exact decimal strings, and maker_subaccount_nonce |
| Non-canonical price | Strip trailing zeros after quantizing; send "76462" for integer-tick markets, not "76462.0" |
| Digest mismatch on minimum fill | Use None in the helper or "0" in the signed field; never "" |
| Quote accepted by indexer but skipped onchain | Check expiry, worst_price, mark-band validation, maker registration, and maker margin |
