EVM Contract Status Lifecycle

This lifecycle tracks the status of the off-chain contract record in our database as it moves from creation to deployment and finally to an archived state.

Lifecycle Diagram

PENDING_DEPLOYMENT → DEPLOYMENT_IN_PROGRESS → ACTIVE → ARCHIVED

Status Definitions

Status	Description
PENDING_DEPLOYMENT	The Offer has been approved, and a contract record has been created, but it has not yet been sent to the blockchain.
DEPLOYMENT_IN_PROGRESS	A deployment transaction has been broadcast to the network. The system is awaiting confirmation.
ACTIVE	The contract is successfully deployed, its address is confirmed, and it is fully operational.
ARCHIVED	The underlying Offer has been completed (EXITED/REPAID), and this contract record is now archived.

Key Transitions

• Deploy Contract (PENDING_DEPLOYMENT → DEPLOYMENT_IN_PROGRESS)

  • Trigger: An administrator initiates the deployment for a legally approved Offer.

  • Action: The system broadcasts the deployment transaction to the specified network, stores the resulting deployment_tx_hash, and updates the status.

• Confirm Deployment (DEPLOYMENT_IN_PROGRESS → ACTIVE)

  • Trigger: A background service (blockchain listener) confirms the deployment transaction has been successfully mined.

  • Action: The system parses the transaction receipt to get the contract address, stores it, and updates the status to ACTIVE.

• Archive Contract (ACTIVE → ARCHIVED)

  • Trigger: The linked Offer's status changes to EXITED/REPAID.

  • Action: The system automatically updates the contract record's status to ARCHIVED.