Contract Workspaces

A Contract Workspace is a dedicated environment for analysing and testing any smart contract on your Stagenet — whether it is your own contract imported from GitHub or an existing mainnet contract that your application interacts with.

Workspaces unify contract analytics into a single place with activity, state, balances, TVL, and history, and give you tools to track and graph contract data (function outputs, balances, TVL) as it evolves over time.

Creating a Contract Workspace

There are two ways to create a Contract Workspace:

1. From your GitHub repository (recommended)

Connect a GitHub repository containing your project’s smart contracts. Each uniquely named contract automatically gets its own Workspace via the Stagenet’s contract CI/CD pipeline.

To get started, follow the quickstart for your framework:

• Foundry
• Hardhat v2
• Hardhat v3

As contract source code changes are pushed, new Contract Versions are created automatically. When those versions are deployed to your Stagenet, new Contract Deployments appear in the Workspace — giving you a full versioned history with deployment tracking.

At a given time, the Workspace is scoped to single tracked deployment, termed its Active Deployment. This deployment’s address is always shown in the top-left of the Workspace, You can switch deployments at any time through the History view.

2. By entering an address

You can also create a Workspace for any existing contract on the replicated chain.

1. Go to Workspaces → Contracts.
2. Click Add Mainnet Contract.
3. Enter the contract address.
4. If its a publicly verified contract, its Workspace is created automatically.
5. If not verified, provide the ABI to complete setup.

This is ideal for analysing third-party contracts your app uses — e.g. a Uniswap pool, price feed, vault, or any protocol dependency.

Views & Analytics

Every Contract Workspace exposes a set of tabbed Views that organise analytics and devtools around the selected contract deployment or on-chain instance.

Core Views

• Overview
  Inspect activity, storage variables, and TVL. Call contract functions directly.

• Transactions
  A contract-scoped explorer showing every transaction interacting with the contract.

• Assets
  View token balances (native + ERC-20) and track USD TVL over time.

• Data Tracking
  Track and graph contract function return values, asset balances, and TVL across blocks.

• Source Code
  Browse the contract’s Solidity source code.

In addition to the core views, certain contracts have additional views.

GitHub-Imported Contracts

• History
  Browse contract versions and deployments, or switch between multiple deployed instances.

ERC-20 Contracts

• Token Stats
  Displays token-level analytics showing how it is used across Stagenet transactions.

Typical Workflow

A typical workflow when developing custom contracts with Contract Workspaces:

1. Link a GitHub repository containing your contracts.
2. Create Workspace(s) automatically via CI/CD.
3. Deploy to your Stagenet.
4. Use the Workspace to inspect behaviour: transactions, TVL, storage, balances, DeFi activity.
5. Push updates to GitHub to create new versions.
6. Redeploy and compare behaviour across deployments.
7. Track state changes and economic performance block-by-block.