Advanced Technical Details

Circuit breaker, precision, rate limits, storage limits, and error handling details

Written By pvdyck

Last updated 1 day ago

Advanced Technical Details

This page covers details for advanced Builders and Producers who want a deeper understanding of platform behavior.

Circuit Breaker

The circuit breaker stops execution if costs exceed the user-defined maximum (maxExecutionPrice). The check is strict: if the next API call would push the total over the ceiling, the call is rejected and execution stops.

When the circuit breaker triggers, you see:

Cost ceiling reached ($X.XXXX). Execution stopped to prevent overcharge. Current: $Y.YYYY, attempted: $Z.ZZZZ

Legacy workflows (pre-circuit-breaker) do not have maxExecutionPrice validation. Migration is recommended.

Monetary Precision

Precision Standard

All monetary values use 6-decimal precision to avoid rounding errors:

1 InUSD = 1,000,000 units (6-decimal precision, like cents to dollars)

OperationPrecisionNotes
Price storage6 decimalsFixed-point in contracts
Cost tracking9 decimalsNanodollar precision during execution
Settlement6 decimalsBatched every 5 minutes
Display2 decimalsRounded for UI (e.g., $0.10)

Rounding Strategy

  • Toward zero for refunds (favors user)
  • Ceiling for charges (prevents undercharging)
  • Banker's rounding for ties (.5 rounds to nearest even)

Storage Limits

ItemLimit
Credential or execution state1 MB
Workflow JSON1 MB (uncompressed)
File attachment50 MB per file
Webhook URL length512 characters

Rate Limits

OperationLimitWindow
Webhook triggers100/IP/hourRolling window
API calls10,000/user/hourRolling window
Credential updates100/user/hourRolling window

Error Handling

Retry Policy

Error TypeRetried?Details
Transient platform errorsYesUp to 3 attempts with exponential backoff
API timeout (external provider)No—
Circuit breakerNo—
Out of budgetNo—

Failed payment operations are logged and retried automatically only for transient errors. Persistent failures are flagged for review.

Log Retention

Log TypeRetention
Execution logs24 hours
Settlement records30 days