Products
SWSS Explorer
Pre-launch
Section
Products
Documentation category
Type
Guide
Technical reference
Summary
The public block explorer for SwssChain mainnet and testnet: what it makes checkable, and how its API is reached.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

SWSS Explorer is the public block explorer for SwssChain, on both networks: mainnet 122605 at swssscan.swss.io and testnet 122606 at testnet.swssscan.swss.io. It is a read-only record of what settled.

Reading the Record Is Not Network Access

The explorer is open to browse and requires no SWSS account. That is deliberate and it is not in tension with the network being permissioned: a settlement layer that asks to be believed about its own settlement volume has not understood what it is for. Submitting to either network still requires credentials issued through SWSS DevHub: see Developer and Validator Access.

What It Makes Checkable

ObjectWhat the explorer shows
DEED-1 settlementThe transaction that settled it, its block, its deed class and asset reference
Finality CertificateThe certificate covering a settlement, and the validators that attested it
Governance proposalType, tier, votes, status and the events behind each transition
Validator admissionAdmissions and rotations as they execute
Chain statusHeight, block production and the active validator set

Deed badges and deed metadata come from the Deed Indexer, which decodes fields the explorer's own transaction view cannot see: they are carried in the transaction at the wire level rather than in event logs.

Block Explorer Capabilities

The SwssChain Explorer provides complete transparency into all on-chain activity. The following data is queryable directly from the explorer interface:

  • Blocks: Block height, timestamp, producer node, gas used, gas limit, transaction count, and block reward.
  • Transactions: Hash, sender, recipient, value, gas price, gas used, input data, and decoded function call where ABI is available.
  • Deed Settlements: Deed type, property identifier, parcel reference, settlement value, seller and buyer addresses, and Finality Certificate hash.
  • Finality Certificates: Full multi-validator signature set, certificate creation timestamp, and associated settlement record.
  • Settlement Combustion Model: Live Transactional Settlement Levy (TSL) rate, cumulative supply retirement figures, and Ecosystem Revenue Recirculation Protocol (ERRP) distribution history.
  • Addresses: SWSS Coin balance, transaction history, deployed contracts, and Deed participation history.
  • Contracts: Verified source code, ABI, read/write interface, and event log stream.

Explorer API

The explorer exposes a REST API for programmatic access to indexed chain data. It is separate from the JSON-RPC node API and is optimised for analytics-style queries rather than real-time transaction submission. The base URL and key are issued with your SWSS DevHub credentials.

SWSS_EXPLORER_API=   # issued by SWSS DevHub

# Latest blocks
curl "$SWSS_EXPLORER_API/v1/blocks?limit=10" -H "X-API-Key: $SWSS_EXPLORER_KEY"

# Block by number
curl "$SWSS_EXPLORER_API/v1/blocks/1000000" -H "X-API-Key: $SWSS_EXPLORER_KEY"

# Transactions for an address
curl "$SWSS_EXPLORER_API/v1/addresses/0xYourAddress/transactions?page=1&limit=25" -H "X-API-Key: $SWSS_EXPLORER_KEY"

# Deed settlements by asset reference
curl "$SWSS_EXPLORER_API/v1/deeds?assetRef=YOUR-ASSET-REF" -H "X-API-Key: $SWSS_EXPLORER_KEY"

See Authentication and API Keys for how the key is presented, and the API Reference for the full endpoint set.

Verifying a Settlement Without Us

Everything the explorer displays can be reconstructed from the chain directly. A Finality Certificate can be fetched over JSON-RPC with swss_getFinalityCertificate and verified against the attesting validator set without involving the explorer at all: see How to Verify a Finality Certificate. The explorer is a convenience over public data, never the authority for it.

Next Steps