Skip to main content
Rails moves value through a small number of explicit settlement steps. The point is to make every transition observable and easy to debug.

​
Lifecycle

  1. A B2B integrator requests access.
  2. Rails issues an API key manually.
  3. The integrator creates an offramp order.
  4. Rails settles the value on Sui.
  5. The configured payout route completes local fiat payout.

​
First principles

  • Stablecoins enter the system.
  • Settlement is executed on Sui.
  • Route A is the configured B2B route.
  • Local fiat payout completes through the selected route.

​
Failure modes

  • Quote expires before payment
  • Fiat payout does not complete
  • Route times out
  • A retry must be issued

​
What to expect from the app layer

Your application should treat settlement as a state machine, not a single request/response call. That means you should handle:
  • pending
  • quoted
  • created
  • settling
  • settled
  • failed
  • expired