Errors

Most failed requests are fee mismatches or missing reveals. The contract does not keep a wrong payment and it does not invent a random word when the keeper is late.

Revert table

InsufficientFeemsg.value does not equal required fee. Underpay and overpay both revert.
NoSuchProviderProvider address is not registered.
NoSuchRequestSequence number does not exist or is no longer active.
IncorrectRevelationReveal preimage does not match the stored commitment.
OutOfRandomnessHash chain is exhausted. Provider must register a new chain.
MaxGasLimitExceededRequested callback gas limit exceeds MAX_GAS_LIMIT.

Failed-request economics

  • A refund returns the exact request fee. Transaction gas is never refunded.
  • The requester pays gas for the original request and for refundRequest.
  • Torinox retains no fee from an unrevealed, refunded request.
  • If no reveal transaction was submitted, Torinox has no direct reveal-transaction gas for that request.
  • If a reveal transaction was submitted and reverted, Torinox bears that gas.

Refund delay is refundDelayBlocks = 6 L1 blocks (~60-90s on Robinhood / Arbitrum Nitro, where block.number tracks L1).

Integration samples: /docs/quickstart/.

Home · RNG for Robinhood Chain · Docs · Architecture · Security · SDK · x402 · GitHub