Contract Workspaces

Stagenets provide a built-in system to manage and develop your project's smart contracts. Each contract in your project is given its own dedicated Contract Workspace. This Workspace acts as the central hub for its contract’s tools and analytics. Within it, you can:

• View transaction activity involving the contract
• Check its USD TVL and asset balances (ETH and ERC20)
• Inspect the current values of its storage variables
• Browse contract history through a GitHub-synced Version and Deployment Manager
• Set up custom analytics to record and graph any of the contract's data
• Configure custom analytics to visualize any contract data — state, token balances, and more.

Contract Workspaces are found in the Contracts section of the app, accessible via the sidebar.

GitHub Sync

The Contract Workspaces system is designed to work alongside a GitHub repository containing your project’s smart contracts. Once connected, the Stagenet automatically creates a Contract Workspace for each contract in the repository. It will then continuously listen for new or updated contracts pushed to the repository, creating new Workspaces or adding new Versions to existing ones as needed.

Workspace Setup

To get started with workspaces, all you need to do is link a repository then deploy its contracts onto your Stagenet. First, connect your repository — this creates Pending Contract Workspaces for each of its contracts. Pending Workspaces represent contracts that have been imported from the repository but not yet deployed to the Stagenet.

After importing, deploy the repository’s contracts to the Stagenet. Each deployment transitions its corresponding Contract Workspace from Pending to Active. This means the deployed contract has been registered in the Workspace’s Version and Deployment Manager, and all of its tools and analytics are now ready to use.