brawny 0.1.13__py3-none-any.whl → 0.1.22__py3-none-any.whl

brawny/metrics.py

@@ -424,20 +424,38 @@ JOBS_TRIGGERED = "brawny_jobs_triggered_total"
 INTENTS_CREATED = "brawny_intents_created_total"
 INTENT_TRANSITIONS = "brawny_intent_transitions_total"
 INTENT_RETRY_ATTEMPTS = "brawny_intent_retry_attempts_total"
+EXECUTOR_STAGE_STARTED = "brawny_executor_stage_started_total"
+EXECUTOR_STAGE_OUTCOME = "brawny_executor_stage_outcome_total"
+EXECUTOR_STAGE_TIMEOUTS = "brawny_executor_stage_timeouts_total"
 INTENT_CLAIMED = "brawny_intent_claimed_total"
 INTENT_RELEASED = "brawny_intent_released_total"
+CLAIM_RELEASED_PRE_ATTEMPT = "brawny_claim_released_pre_attempt_total"
+CLAIM_RELEASE_SKIPPED = "brawny_claim_release_skipped_total"
+CLAIM_RECLAIM_SKIPPED = "brawny_claim_reclaim_skipped_total"
+INTENT_COOLDOWN_SKIPPED = "brawny_intent_cooldown_skipped_total"
+INTENT_COOLDOWN_ERRORS = "brawny_intent_cooldown_errors_total"
 INTENT_STATE_INCONSISTENT = "brawny_intent_state_inconsistent_total"
 INTENT_SENDING_STUCK = "brawny_intent_sending_stuck_total"
+BACKGROUND_TASK_ERRORS = "brawny_background_task_errors_total"
+ALERTS_ENQUEUED = "brawny_alerts_enqueued_total"
+ALERTS_DROPPED = "brawny_alerts_dropped_total"
+ALERTS_SENT = "brawny_alerts_sent_total"
+ALERTS_RETRIED = "brawny_alerts_retried_total"
+ALERTS_LAST_SUCCESS_TIMESTAMP = "brawny_alerts_last_success_timestamp"
+ALERTS_LAST_ERROR_TIMESTAMP = "brawny_alerts_last_error_timestamp"
+ALERTS_WORKER_ALIVE = "brawny_alerts_worker_alive"
+ALERTS_OLDEST_QUEUED_AGE_SECONDS = "brawny_alerts_oldest_queued_age_seconds"
 TX_BROADCAST = "brawny_tx_broadcast_total"
 TX_CONFIRMED = "brawny_tx_confirmed_total"
 TX_FAILED = "brawny_tx_failed_total"
 TX_REPLACED = "brawny_tx_replaced_total"
 RPC_REQUESTS = "brawny_rpc_requests_total"
 RPC_ERRORS = "brawny_rpc_errors_total"
+RPC_CALL_TIMEOUTS = "brawny_rpc_call_timeouts_total"
 RPC_REQUESTS_BY_JOB = "brawny_rpc_requests_by_job_total"
-RPC_RATE_LIMITED = "brawny_rpc_rate_limited_total"
 RPC_FAILOVERS = "brawny_rpc_failovers_total"
-ALERTS_SENT = "brawny_alerts_sent_total"
+RPC_ERROR_CLASSIFIED = "brawny_rpc_error_classified_total"
+RPC_ERROR_UNKNOWN = "brawny_rpc_error_unknown_total"
 JOB_CHECK_TIMEOUTS = "brawny_job_check_timeouts_total"
 JOB_BUILD_TIMEOUTS = "brawny_job_build_timeouts_total"
 REORGS_DETECTED = "brawny_reorg_detected_total"
@@ -446,14 +464,17 @@ SIMULATION_REVERTED = "brawny_simulation_reverted_total"
 SIMULATION_NETWORK_ERRORS = "brawny_simulation_network_errors_total"
 SIMULATION_RETRIES = "brawny_simulation_retries_total"
 BROADCAST_ATTEMPTS = "brawny_broadcast_attempts_total"
-NONCE_SERIALIZATION_RETRIES = "brawny_nonce_serialization_retries_total"
-ATTEMPT_WRITE_FAILURES = "brawny_attempt_write_failures_total"
+NETWORK_GUARD_ALLOW = "brawny_network_guard_allow_total"
+NETWORK_GUARD_VIOLATION = "brawny_network_guard_violation_total"
+NONCE_GAP_DETECTED = "brawny_nonce_gap_detected_total"
+NONCE_FORCE_RESET = "brawny_nonce_force_reset_total"
 
 # Gauges
 LAST_PROCESSED_BLOCK = "brawny_last_processed_block"
 PENDING_INTENTS = "brawny_pending_intents"
 INTENTS_BACKING_OFF = "brawny_intents_backing_off"
 ACTIVE_WORKERS = "brawny_active_workers"
+ALERTS_QUEUE_DEPTH = "brawny_alerts_queue_depth"
 RPC_ENDPOINT_HEALTH = "brawny_rpc_endpoint_health"
 DB_CIRCUIT_BREAKER_STATE = "brawny_db_circuit_breaker_open"
 
@@ -479,8 +500,11 @@ INVARIANT_ORPHANED_NONCES = "brawny_invariant_orphaned_nonces"
 BLOCK_PROCESSING_SECONDS = "brawny_block_processing_seconds"
 TX_CONFIRMATION_SECONDS = "brawny_tx_confirmation_seconds"
 RPC_REQUEST_SECONDS = "brawny_rpc_request_seconds"
+EXECUTOR_ATTEMPT_DURATION_SECONDS = "brawny_executor_attempt_duration_seconds"
 JOB_CHECK_SECONDS = "brawny_job_check_seconds"
 BROADCAST_LATENCY_SECONDS = "brawny_broadcast_latency_seconds"
+RUNTIME_CONTROL_ACTIVE = "brawny_runtime_control_active"
+RUNTIME_CONTROL_TTL_SECONDS = "brawny_runtime_control_ttl_seconds"
 
 # Metric label schema (fixed, low-cardinality)
 METRIC_LABELS = {
@@ -489,19 +513,31 @@ METRIC_LABELS = {
     INTENTS_CREATED: ["chain_id", "job_id"],
     INTENT_TRANSITIONS: ["chain_id", "from_status", "to_status", "reason"],
     INTENT_RETRY_ATTEMPTS: ["chain_id", "reason"],
+    EXECUTOR_STAGE_STARTED: ["stage"],
+    EXECUTOR_STAGE_OUTCOME: ["stage", "outcome"],
+    EXECUTOR_STAGE_TIMEOUTS: ["stage"],
     INTENT_CLAIMED: ["chain_id"],
     INTENT_RELEASED: ["chain_id", "reason"],
+    CLAIM_RELEASED_PRE_ATTEMPT: ["stage"],
+    CLAIM_RELEASE_SKIPPED: ["stage"],
+    CLAIM_RECLAIM_SKIPPED: ["chain_id"],
+    INTENT_COOLDOWN_SKIPPED: ["chain_id"],
+    INTENT_COOLDOWN_ERRORS: ["chain_id"],
     INTENT_STATE_INCONSISTENT: ["chain_id", "reason"],
     INTENT_SENDING_STUCK: ["chain_id", "age_bucket"],
+    BACKGROUND_TASK_ERRORS: ["task"],
+    ALERTS_ENQUEUED: [],
+    ALERTS_DROPPED: ["reason", "channel"],
+    ALERTS_SENT: [],
+    ALERTS_RETRIED: [],
     TX_BROADCAST: ["chain_id", "job_id"],
     TX_CONFIRMED: ["chain_id", "job_id"],
     TX_FAILED: ["chain_id", "job_id", "reason"],
     TX_REPLACED: ["chain_id", "job_id"],
     RPC_REQUESTS: ["chain_id", "method", "rpc_category", "rpc_host"],
     RPC_ERRORS: ["chain_id", "method", "rpc_category", "rpc_host"],
+    RPC_CALL_TIMEOUTS: ["chain_id", "method", "rpc_category", "rpc_host"],
     RPC_REQUESTS_BY_JOB: ["chain_id", "job_id", "rpc_category"],
-    RPC_RATE_LIMITED: ["endpoint"],
-    ALERTS_SENT: ["chain_id", "channel"],
     JOB_CHECK_TIMEOUTS: ["chain_id", "job_id"],
     JOB_BUILD_TIMEOUTS: ["chain_id", "job_id"],
     REORGS_DETECTED: ["chain_id"],
@@ -510,12 +546,21 @@ METRIC_LABELS = {
     SIMULATION_NETWORK_ERRORS: ["chain_id", "job_id"],
     SIMULATION_RETRIES: ["chain_id", "job_id"],
     BROADCAST_ATTEMPTS: ["chain_id", "job_id", "broadcast_group", "result"],
-    NONCE_SERIALIZATION_RETRIES: [],
-    ATTEMPT_WRITE_FAILURES: ["stage"],
+    RPC_ERROR_CLASSIFIED: ["kind", "method", "source"],
+    RPC_ERROR_UNKNOWN: ["method", "exception_type", "provider", "http_status", "jsonrpc_code"],
+    NETWORK_GUARD_ALLOW: ["reason"],
+    NETWORK_GUARD_VIOLATION: ["context", "caller_module"],
+    NONCE_GAP_DETECTED: ["chain_id", "signer"],
+    NONCE_FORCE_RESET: ["chain_id", "signer", "source"],
     LAST_PROCESSED_BLOCK: ["chain_id"],
     PENDING_INTENTS: ["chain_id"],
     INTENTS_BACKING_OFF: ["chain_id"],
     ACTIVE_WORKERS: ["chain_id"],
+    ALERTS_QUEUE_DEPTH: [],
+    ALERTS_LAST_SUCCESS_TIMESTAMP: [],
+    ALERTS_LAST_ERROR_TIMESTAMP: [],
+    ALERTS_WORKER_ALIVE: [],
+    ALERTS_OLDEST_QUEUED_AGE_SECONDS: [],
     RPC_ENDPOINT_HEALTH: ["endpoint"],
     DB_CIRCUIT_BREAKER_STATE: ["db_backend"],
     OLDEST_PENDING_INTENT_AGE_SECONDS: ["chain_id"],
@@ -528,8 +573,11 @@ METRIC_LABELS = {
     BLOCK_PROCESSING_SECONDS: ["chain_id"],
     TX_CONFIRMATION_SECONDS: ["chain_id"],
     RPC_REQUEST_SECONDS: ["chain_id", "method", "rpc_category", "rpc_host"],
+    EXECUTOR_ATTEMPT_DURATION_SECONDS: ["stage"],
     JOB_CHECK_SECONDS: ["chain_id", "job_id"],
     BROADCAST_LATENCY_SECONDS: ["chain_id", "job_id", "broadcast_group"],
+    RUNTIME_CONTROL_ACTIVE: ["control"],
+    RUNTIME_CONTROL_TTL_SECONDS: ["control"],
     # Invariants (Phase 2)
     INVARIANT_STUCK_CLAIMED: ["chain_id"],
     INVARIANT_NONCE_GAP_AGE: ["chain_id"],
@@ -544,19 +592,35 @@ METRIC_DESCRIPTIONS = {
     INTENTS_CREATED: "Total intents created",
     INTENT_TRANSITIONS: "Total intent status transitions",
     INTENT_RETRY_ATTEMPTS: "Total intent retry attempts",
+    EXECUTOR_STAGE_STARTED: "Total executor stages started",
+    EXECUTOR_STAGE_OUTCOME: "Total executor stage outcomes",
+    EXECUTOR_STAGE_TIMEOUTS: "Total executor stage timeouts",
     INTENT_CLAIMED: "Total intents claimed",
     INTENT_RELEASED: "Total intents released",
+    CLAIM_RELEASED_PRE_ATTEMPT: "Total claims released before attempts exist",
+    CLAIM_RELEASE_SKIPPED: "Total claim releases skipped (token mismatch or attempts)",
+    CLAIM_RECLAIM_SKIPPED: "Expired claims skipped due to attempts",
+    INTENT_COOLDOWN_SKIPPED: "Intents skipped due to cooldown",
+    INTENT_COOLDOWN_ERRORS: "Cooldown check errors",
     INTENT_STATE_INCONSISTENT: "Total inconsistent intent state detections",
     INTENT_SENDING_STUCK: "Total intents detected stuck in sending",
+    BACKGROUND_TASK_ERRORS: "Total background loop errors",
+    ALERTS_ENQUEUED: "Total alerts enqueued for delivery",
+    ALERTS_DROPPED: "Total alerts dropped before sending",
+    ALERTS_SENT: "Total alerts delivered successfully",
+    ALERTS_RETRIED: "Total alert send retries",
+    ALERTS_LAST_SUCCESS_TIMESTAMP: "Unix timestamp of last alert success",
+    ALERTS_LAST_ERROR_TIMESTAMP: "Unix timestamp of last alert error",
+    ALERTS_WORKER_ALIVE: "Alert worker alive state (1=alive, 0=dead)",
+    ALERTS_OLDEST_QUEUED_AGE_SECONDS: "Age in seconds of oldest queued alert",
     TX_BROADCAST: "Total transactions broadcast",
     TX_CONFIRMED: "Total transactions confirmed",
     TX_FAILED: "Total transactions failed",
     TX_REPLACED: "Total transactions replaced",
     RPC_REQUESTS: "Total RPC requests",
     RPC_ERRORS: "Total RPC errors (failed attempts)",
+    RPC_CALL_TIMEOUTS: "Total RPC call timeouts",
     RPC_REQUESTS_BY_JOB: "RPC requests attributed to jobs",
-    RPC_RATE_LIMITED: "RPC requests delayed by rate limiting",
-    ALERTS_SENT: "Total alerts sent",
     JOB_CHECK_TIMEOUTS: "Total job check timeouts",
     JOB_BUILD_TIMEOUTS: "Total job build_intent timeouts",
     REORGS_DETECTED: "Total reorgs detected",
@@ -565,12 +629,17 @@ METRIC_DESCRIPTIONS = {
     SIMULATION_NETWORK_ERRORS: "Total simulation network errors (after all retries)",
     SIMULATION_RETRIES: "Total simulation retry attempts",
     BROADCAST_ATTEMPTS: "Total broadcast attempts by result (success, unavailable, fatal, recoverable)",
-    NONCE_SERIALIZATION_RETRIES: "Number of serialization conflict retries during nonce reservation",
-    ATTEMPT_WRITE_FAILURES: "Number of failed attempt record writes",
+    RPC_ERROR_CLASSIFIED: "Total RPC errors classified by the new classifier",
+    RPC_ERROR_UNKNOWN: "Total RPC errors that are unknown to the new classifier",
+    NETWORK_GUARD_ALLOW: "Network guard allowlist escapes (approved wrappers)",
+    NETWORK_GUARD_VIOLATION: "Network guard blocked direct network calls",
+    NONCE_GAP_DETECTED: "Nonce gap detected (chain_pending < db_next_nonce) - observability only, no auto-reset",
+    NONCE_FORCE_RESET: "Explicit nonce force reset (CLI or allow_unsafe_nonce_reset config)",
     LAST_PROCESSED_BLOCK: "Last processed block",
     PENDING_INTENTS: "Pending intents",
     INTENTS_BACKING_OFF: "Intents in backoff window (retry_after in future)",
     ACTIVE_WORKERS: "Active worker threads",
+    ALERTS_QUEUE_DEPTH: "Alert queue depth",
     RPC_ENDPOINT_HEALTH: "RPC endpoint health (1=healthy, 0=unhealthy)",
     DB_CIRCUIT_BREAKER_STATE: "Database circuit breaker open state (1=open, 0=closed)",
     OLDEST_PENDING_INTENT_AGE_SECONDS: "Age in seconds of oldest pending intent (CREATED, PENDING, CLAIMED, SENDING)",
@@ -583,8 +652,11 @@ METRIC_DESCRIPTIONS = {
     BLOCK_PROCESSING_SECONDS: "Block processing duration in seconds",
     TX_CONFIRMATION_SECONDS: "Transaction confirmation duration in seconds",
     RPC_REQUEST_SECONDS: "RPC request duration in seconds",
+    EXECUTOR_ATTEMPT_DURATION_SECONDS: "Executor stage duration in seconds",
     JOB_CHECK_SECONDS: "Job check duration in seconds",
     BROADCAST_LATENCY_SECONDS: "Broadcast transaction latency in seconds",
+    RUNTIME_CONTROL_ACTIVE: "Runtime control active state (1=active, 0=inactive)",
+    RUNTIME_CONTROL_TTL_SECONDS: "Runtime control TTL remaining in seconds",
     # Invariants (Phase 2)
     INVARIANT_STUCK_CLAIMED: "Intents stuck in claimed status > threshold minutes",
     INVARIANT_NONCE_GAP_AGE: "Age in seconds of oldest nonce gap (reserved below chain nonce)",

brawny/model/contexts.py

@@ -8,15 +8,18 @@ Each phase gets only what it needs:
 Contract access is explicit and block-aware:
 - at_block(name, addr, block): Pinned reads for check()
 - at(name, addr): Latest reads for build/alerts
+
+Lifecycle hooks (on_trigger, on_success, on_failure) have ctx.alert() for
+sending alerts to job destinations. See AlertMixin for details.
 """
 
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Protocol
 
 from brawny.model.events import DecodedEvent
-from brawny.model.errors import FailureType
+from brawny.model.errors import FailureType, FailureStage
 
 if TYPE_CHECKING:
     from brawny.jobs.kv import KVReader, KVStore
@@ -28,6 +31,70 @@ if TYPE_CHECKING:
     import structlog
 
 
+# =============================================================================
+# Alert Sender Protocol + Mixin
+# =============================================================================
+
+
+class AlertSender(Protocol):
+    """Protocol for alert sending. Injected into lifecycle contexts."""
+
+    def send(
+        self,
+        message: str,
+        *,
+        to: str | list[str] | None = None,
+        parse_mode: str | None = None,
+    ) -> None:
+        """Send alert to configured destinations.
+
+        Args:
+            message: Alert text
+            to: Override routing (name, ID, or list). None = job's default.
+            parse_mode: "Markdown", "MarkdownV2", "HTML", or None
+        """
+        ...
+
+
+class AlertMixin:
+    """Mixin providing ctx.alert() for lifecycle hooks.
+
+    Targets job alert destinations (job._alert_to or telegram.default).
+    For health/operator alerts, use health_alert() directly.
+
+    This mixin expects the class to have an `_alert_sender` attribute
+    that implements the AlertSender protocol.
+    """
+
+    _alert_sender: AlertSender | None
+
+    def alert(
+        self,
+        message: str,
+        *,
+        to: str | list[str] | None = None,
+        parse_mode: str | None = None,
+    ) -> None:
+        """Send alert to job destinations.
+
+        Usage:
+            def on_success(self, ctx):
+                ctx.alert(f"Confirmed: {ctx.receipt.transactionHash.hex()}")
+
+        Routing:
+            - Uses job's configured alert destinations (job._alert_to)
+            - Falls back to telegram.default if not set
+            - Respects config parse_mode and rate limiting
+
+        Args:
+            message: Alert text (up to 4096 characters)
+            to: Override routing target (name, ID, or list). None = job's default.
+            parse_mode: "Markdown", "MarkdownV2", "HTML", or None for config default
+        """
+        if self._alert_sender is not None:
+            self._alert_sender.send(message, to=to, parse_mode=parse_mode)
+
+
 # =============================================================================
 # Contract Factory Protocol
 # =============================================================================
@@ -94,6 +161,20 @@ class BlockContext:
     chain_id: int
 
 
+class CancellationToken:
+    """Cooperative cancellation marker for runner-owned deadlines."""
+
+    def __init__(self) -> None:
+        self._cancelled = False
+
+    def cancel(self) -> None:
+        self._cancelled = True
+
+    @property
+    def cancelled(self) -> bool:
+        return self._cancelled
+
+
 # =============================================================================
 # Check Context
 # =============================================================================
@@ -112,9 +193,11 @@ class CheckContext:
     block: BlockContext
     kv: KVStore  # Read+write allowed
     job_id: str
-    rpc: Any  # RPCManager or similar
+    rpc: Any  # ReadClient/BroadcastClient or similar
+    http: Any  # ApprovedHttpClient
     logger: "structlog.stdlib.BoundLogger"
     contracts: ContractFactory
+    cancellation_token: CancellationToken | None = None
     _db: Any = None  # Internal: for log()
 
     def log(self, level: str = "info", **fields: Any) -> None:
@@ -152,7 +235,8 @@ class BuildContext:
     trigger: "Trigger"
     job_id: str
     signer_address: str  # Signer belongs here, not on RPC
-    rpc: Any  # RPCManager or similar
+    rpc: Any  # ReadClient/BroadcastClient or similar
+    http: Any  # ApprovedHttpClient
     logger: "structlog.stdlib.BoundLogger"
     contracts: ContractFactory
     kv: KVReader  # Read-only
@@ -184,6 +268,7 @@ class AlertContext:
     logger: "structlog.stdlib.BoundLogger"
     contracts: ContractFactory
     kv: KVReader  # Read-only
+    http: Any | None = None  # ApprovedHttpClient (optional)
 
     @property
     def has_receipt(self) -> bool:
@@ -214,7 +299,7 @@ class AlertContext:
 
 
 @dataclass(frozen=True)
-class TriggerContext:
+class TriggerContext(AlertMixin):
     """Passed to on_trigger. Trigger still exists here.
 
     Use for:
@@ -224,12 +309,15 @@ class TriggerContext:
 
     Note: No intent exists yet. After this hook, trigger is gone -
           only intent.metadata persists.
+
+    Alert routing: ctx.alert() → job._alert_to → telegram.default
     """
 
     trigger: "Trigger"
     block: BlockContext
     kv: "KVStore"  # Read+write (pre-intent)
     logger: "structlog.stdlib.BoundLogger"
+    http: Any  # ApprovedHttpClient
     # Alert routing
     job_id: str
     job_name: str
@@ -239,14 +327,18 @@ class TriggerContext:
     # Optional telegram fields
     telegram_bot: "TelegramBot | None" = None
     job_alert_to: list[str] | None = None
+    # Alert sender (injected by lifecycle dispatcher)
+    _alert_sender: AlertSender | None = field(default=None, repr=False)
 
 
 @dataclass(frozen=True)
-class SuccessContext:
+class SuccessContext(AlertMixin):
     """Passed to on_success. No trigger - use intent.metadata.
 
     ctx.intent.metadata["reason"] = original trigger.reason
     ctx.intent.metadata[...] = your custom data from build_tx()
+
+    Alert routing: ctx.alert() → job._alert_to → telegram.default
     """
 
     intent: "TxIntent"
@@ -255,6 +347,7 @@ class SuccessContext:
     block: BlockContext
     kv: "KVReader"  # Read-only
     logger: "structlog.stdlib.BoundLogger"
+    http: Any  # ApprovedHttpClient
     # Alert routing
     job_id: str
     job_name: str
@@ -264,16 +357,20 @@ class SuccessContext:
     # Optional telegram fields
     telegram_bot: "TelegramBot | None" = None
     job_alert_to: list[str] | None = None
+    # Alert sender (injected by lifecycle dispatcher)
+    _alert_sender: AlertSender | None = field(default=None, repr=False)
 
 
 @dataclass(frozen=True)
-class FailureContext:
+class FailureContext(AlertMixin):
     """Passed to on_failure. Intent may be None for pre-intent failures.
 
     Pre-intent failures include:
     - check() exception
     - build_tx() exception
     - intent creation failure
+
+    Alert routing: ctx.alert() → job._alert_to → telegram.default
     """
 
     intent: "TxIntent | None"  # None for pre-intent failures
@@ -284,6 +381,7 @@ class FailureContext:
     block: BlockContext
     kv: "KVReader"  # Read-only (no side effects during failure handling)
     logger: "structlog.stdlib.BoundLogger"
+    http: Any  # ApprovedHttpClient
     # Alert routing
     job_id: str
     job_name: str
@@ -293,6 +391,8 @@ class FailureContext:
     # Optional telegram fields
     telegram_bot: "TelegramBot | None" = None
     job_alert_to: list[str] | None = None
+    # Alert sender (injected by lifecycle dispatcher)
+    _alert_sender: AlertSender | None = field(default=None, repr=False)
 
 
 # =============================================================================
@@ -301,9 +401,9 @@ class FailureContext:
 
 # These are validated in tests to prevent gradual re-growth into god object:
 # - BlockContext: <= 5 fields
-# - CheckContext: <= 7 fields
+# - CheckContext: <= 8 fields
 # - BuildContext: <= 9 fields
-# - AlertContext: <= 10 fields
+# - AlertContext: <= 11 fields
 
 
 __all__ = [
@@ -316,4 +416,6 @@ __all__ = [
     "FailureContext",
     "ContractFactory",
     "ContractHandle",
+    "AlertSender",
+    "AlertMixin",
 ]

brawny/model/enums.py

@@ -19,6 +19,7 @@ class AttemptStatus(str, Enum):
     """Transaction attempt status."""
 
     SIGNED = "signed"
+    PENDING_SEND = "pending_send"
     BROADCAST = "broadcast"
     PENDING = "pending"
     CONFIRMED = "confirmed"

brawny/model/errors.py

@@ -98,6 +98,18 @@ class DatabaseError(BrawnyError):
     pass
 
 
+class TransactionFailed(DatabaseError):
+    """Transaction marked rollback-only due to an inner failure."""
+
+    pass
+
+
+class InvariantViolation(DatabaseError):
+    """Internal invariant violated."""
+
+    pass
+
+
 class NonceError(BrawnyError):
     """Nonce management error."""
 
@@ -180,6 +192,12 @@ class DatabaseCircuitBreakerOpenError(BrawnyError):
     pass
 
 
+class CancelledCheckError(BrawnyError):
+    """Check was cancelled by the runner; intent creation should not proceed."""
+
+    pass
+
+
 class SimulationReverted(BrawnyError):
     """Transaction would revert on-chain. Permanent failure - do not retry or broadcast."""