Alpha preview. Not for production use.
Working anonymously. to save your work permanently.
Reference

State Inspection

View and analyze the state stored in deployed smart contracts.

Overview

Smart contracts store data in three types of state: global state, local state, and box storage. The Explorer lets you inspect all three.

Global State

Global state is persistent storage owned by the contract itself. Any account can read it.

Viewing Global State

  1. Open a contract in the Explorer
  2. Click the State tab
  3. Global state is shown by default

Understanding the Display

  • Key - The storage key (may be decoded if ABI available)
  • Type - uint64 or bytes
  • Value - The stored value (decoded when possible)
Tip
If the contract has an ABI, state keys and values are automatically decoded using the schema information.

Local State

Local state is per-account storage. Each account that opts into the contract can have their own local state.

Viewing Local State

  1. Open the contract in Explorer
  2. Click Local State
  3. Enter an account address
  4. Click Load to view that account's local state

Common Use Cases

  • User balances in a token contract
  • Player data in a game
  • Voting records
  • User preferences

Box Storage

Box storage provides flexible, larger storage units. Contracts can create, modify, and delete boxes.

Viewing Boxes

  1. Open the contract in Explorer
  2. Click Boxes
  3. See a list of all boxes created by the contract
  4. Click a box to view its contents

Box Information

  • Name - The box identifier
  • Size - Bytes stored
  • Contents - Raw or decoded data

Box Maps

Many contracts use boxes as key-value maps with a common prefix. The Explorer groups these together when detected.

Value Decoding

State values are decoded based on available information:

With ABI Available

  • Keys decoded to human-readable names
  • Values decoded according to type (uint64, address, etc.)
  • Structs expanded to show fields

Without ABI

  • Keys shown as raw bytes (hex)
  • Values shown as raw data
  • Manual interpretation needed
Note
Link a contract to your project to enable ABI-based decoding. You can also manually import an ARC-56 specification file.

State History

View how state has changed over time:

  1. Click History in the state view
  2. See a timeline of state changes
  3. Click a change to see the transaction that caused it

Tracking Changes

  • When was state last modified?
  • What transaction made the change?
  • What was the previous value?