Advanced Technical Details

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 API cost ceiling (maxApiCost). 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. Execution stopped to prevent overcharge. Current: $X.XXXX, attempted: $Y.YYYY

The circuit breaker governs outbound and declared costs. Inbound API cost on a platform-provided credential is bounded separately by the platform's per-call cap, not the declared maxApiCost.

Monetary Precision

Precision Standard

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

$1 = 1,000,000 µ (6-decimal precision, matching the underlying USDC reserve for gas efficiency)

Rounding Strategy

• Toward zero for refunds (favors user)
• Rounded up (ceiling) to the next micro-USD for charges — provider/API cost is the single float→int boundary, via Math.ceil

Storage Limits

Rate Limits

Platform-enforced webhook rate limits are in place to protect against abuse. If you need higher throughput for a production use case, contact support.

Error Handling

Retry Policy

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

Log Retention

Related

• Technical Architecture Overview
• Known Limitations