- Config: endpoint, contract, Cosmos chain ID, EIP-712 chain ID.
- Maker readiness: whitelist, subaccount nonce, margin, authz.
- Stream health: service path, ping/pong, MakerStream auth challenge.
- Signing: exact field order and exact decimal strings.
- Settlement: expiry,
worst_price, margin, authz, market rules.
Connectivity and stream auth
| Symptom | Likely cause | Fix |
|---|---|---|
WebSocket 503 or immediate close | Wrong public service path | Use wss://testnet.rfq.ws.injective.network/injective_rfq_rpc.InjectiveRfqRPC/MakerStream or /TakerStream. |
| Stream connects and pongs but maker receives no requests | Maker did not answer MakerChallenge | Configure MakerStreamClient with auth_private_key, auth_evm_chain_id, and auth_contract_address. |
| Stream closes after auth reply | Challenge signature mismatch | Sign StreamAuthChallenge with the same EIP-712 domain used for quotes; use raw challenge nonce bytes and reply before expiry. |
| Taker receives no quote messages | Collecting with wrong rfq_id or wrong request_address | Use the ACK-returned rfq_id; connect TakerStream with the taker’s Injective address. |
| Maker sees unrelated requests | MakerStream broadcasts eligible flow to whitelisted makers | Filter by target taker plus rfq_id, then market and side, before signing. |
Whitelist, authz, and balances
| Symptom | Likely cause | Fix |
|---|---|---|
| Maker is “not registered” but admin says it is | First-page list_makers query missed the address | Page through list_makers with start_after or use ContractClient.is_maker_registered(). |
not_whitelisted | Maker address not registered on the RFQ contract | Complete Maker whitelist, then re-query. |
authorization not found or unauthorized | Missing or expired authz grant | Re-run Authorization setup; verify the RFQ contract is the grantee. |
account sequence mismatch while granting authz | Multiple grant transactions broadcast too quickly | Submit grants sequentially and wait around 3 seconds between broadcasts. |
insufficient funds | Bank gas balance or exchange subaccount margin is too low | Fund INJ for gas and USDC margin in the settlement subaccount. |
No quote was filled with otherwise valid quote | Maker subaccount nonce mismatch | Query list_makers and use its registered subaccount_nonce; if it is null, use 0. |
Signing and quote validation
| Error / symptom | Likely cause | Fix |
|---|---|---|
invalid_signature | Signed fields differ from sent fields | Log the typed-data message and wire payload side by side; every signed decimal string must match exactly. |
Signature rejected after adding evm_chain_id | EVM chain ID placed in quote.chain_id or wrong domain | Use quote.chain_id="injective-888" on testnet and evm_chain_id=1439 for EIP-712. |
quote.chain_id is 1439 or 1776 | chainId from the EIP-712 domain was copied into the quote wire field | Put the numeric ID in quote.evm_chain_id; put injective-888 or injective-1 in quote.chain_id. |
| Signature works locally but fails at settlement | Wrong contract address in the EIP-712 domain | Use the active RFQ contract address from Testnet configuration. |
| BTC quotes fail tick or signature checks | Integer-tick price sent as "76462.0" | Canonicalize integer ticks as "76462" before signing and sending. |
| Quote expires before settlement | Expiry too close, clock drift, or slow post-RFQ work | Use NTP and avoid slow calls after RFQ receipt. Live quotes must be at least now_ms + 1_500; longer expiries improve match odds but increase stale-price risk. |
worst price exceeds limit | Price or mark/index value read with the wrong scale | Use human-scale prices returned by v2 endpoints; do not apply 1e18 scaling. |
| Retail collects zero quotes | Maker quote was rejected, expired, or for a different rfq_id | Check maker logs for quote_ack, quote error responses, and rfq_id correlation. |
Settlement behavior
Do makers submit an onchain transaction for every trade?
Do makers submit an onchain transaction for every trade?
No. Makers sign quotes offchain and send them to the indexer. The taker submits
AcceptQuote; the contract verifies the maker signature and settles atomically if the quote is still valid.Does quote_ack mean the taker filled my quote?
Does quote_ack mean the taker filled my quote?
No.
quote_ack.status="success" only means the indexer accepted and routed the quote. A fill is confirmed by onchain settlement or by a maker-side settlement_update.Can the taker partially fill my quote?
Can the taker partially fill my quote?
Yes. The taker can submit multiple quotes, and the contract may skip invalid quotes while filling valid ones. Your quote also controls
maker_quantity, maker_margin, and optional min_fill_quantity.What happens if I do not respond to an RFQ?
What happens if I do not respond to an RFQ?
No quote means no trade for you and no onchain penalty. Response-rate metrics may still affect maker standing.
How are positions represented after settlement?
How are positions represented after settlement?
Settlement creates or updates derivative positions in the Injective exchange module for both parties’ subaccounts. Margin, PnL, liquidation, and funding then follow exchange-module rules.
How do reduce-only quotes work?
How do reduce-only quotes work?
Send
margin: "0". No separate reduce-only flag is required; zero margin means the fill can only close or shrink existing exposure.Signed-intent and TP/SL failures
| Error / symptom | Likely cause | Fix |
|---|---|---|
| TakerStream rejects conditional order | Missing v2 fields | Send conditional_order_sign_mode="v2" and conditional_order_evm_chain_id; the toolkit sets them when sign_mode and evm_chain_id are passed. |
invalid_intent_signature | Signed intent fields differ from submitted fields | Keep deadline_ms, worst_price, trigger_type, trigger_price, epoch, and lane_version identical between signing and submission. |
trigger_not_satisfied | Mark-price condition was not true at execution | Re-check trigger type and trigger price against current mark price. |
intent expired | deadline_ms passed before relay | Submit a fresh intent with a new deadline. |
rfq_id mismatch | Executor paired the intent with a quote for another RFQ | Re-request RFQ liquidity for the exact taker plus rfq_id embedded in the signed intent. |
| Intent was cancelled but still submitted | epoch or lane_version changed | Read current counters before signing new intents after CancelAllIntents or CancelIntentLane. |
| Conditional order accepted but never fires | Trigger not reached, executor unavailable, or no executable RFQ quote | Check trigger source, executor logs, and RFQ quote availability. |
Fast triage checklist
- Check Testnet configuration values first.
- Confirm maker whitelist with a paginated helper, not only the first
list_makerspage. - Confirm authz grants for both maker and taker.
- Confirm maker subaccount nonce and USDC margin.
- Confirm MakerStream auth challenge is answered before waiting for RFQs.
- Confirm quotes use
sign_mode="v2"andevm_chain_id=1439on testnet. - Confirm
quote.chain_idremainsinjective-888, not1439, and raw JSON uses snake_case field names. - Confirm the taker collects quotes for the ACK-returned
rfq_id. - Confirm quote expiry is still in the future at settlement time.
- Confirm
worst_price, tick size, and signed decimal strings all match the selected market.