History View

Each Custom Contract Workspace includes a History view for navigating how a contract evolves over time.

The History view lets you:

• Browse Contract Versions created from GitHub commits.
• View Contract Deployments for each version.
• Select an Active Deployment that is used by default across the Stagenet — for example, in address fields in the Explorer or when selecting a recipient in the Faucet.

At any given time, the Workspace is showing analytics for a specific viewed deployment. Switch this by selecting a deployment in the History view.

Contract History

The Workspace’s History view gives you a complete timeline of your contract’s lifecycle on the Stagenet — how it was compiled, versioned, and deployed over time.

Each contract imported from GitHub passes through the Stagenet’s CI/CD pipeline, which compiles the code on every push and generates new versions when its logic (bytecode) changes. A version represents a specific compilation of the contract, tied to a Git commit, and identified by its updated bytecode. When that contract is deployed — whether once or many times — each deployment is automatically associated with the version it matches.

The History view brings all of this together in one place. It shows the full sequence of versions produced for the contract, the deployments created from each version, and the compilation activity that led to them, giving you a clear picture of how the contract has evolved over time.

Active Deployment

The active deployment determines which address is used throughout the contract page and other parts of the app. The active deployment is marked with a green “Active” badge.

Versioning & Deployments (GitHub-linked contracts)

For contracts imported through the CI/CD system:

• Each uniquely named contract maps to a single Contract Workspace.
• Each update to the repository creates a new Contract Version in that Workspace.
• Each deployment of that version creates a Contract Deployment.
• All Workspace views are scoped to the currently selected deployment.
• You can switch deployments at any time through the History view.

The selected deployment’s address is always shown in the top-left of the Workspace, and analytics update instantly when switching.