Skip to Content
UsageMapDocs

Smart contracts

Register your Soroban contracts and see their daily on-chain usage next to your website and API numbers.

UsageMap can count how often your contracts are used on the Stellar network: daily invocations, successful invocations and distinct callers, on mainnet. It reads public ledger data; you don't install anything.

Prove you own a Stellar account

In your project, open Verification and link the Stellar account that deployed (or administers) your contracts, by signing a message with it.

Register your contracts

Open Set-up wizard → Stellar contracts (or Register your Stellar contracts) and add each contract ID (C…) with its network, mainnet or testnet. A contract is verified when its deployer or admin is one of your linked accounts.

No contracts? Choose no footprint so the dashboard stops asking.

See the numbers

The Overview tile On-chain invocations shows the last 30 days for your verified mainnet contracts, and the website's Wallets tab shows the same counts next to the wallet funnel.

Counting has to be switched on

On-chain counting is off until a project owner or admin turns it on. There is no switch in the app yet: send PATCH /v1/tenants/{project_id} with {"onchain_correlation_enabled": true} while signed in. The project's Overview shows whether it is on.

On-chain counts are shown next to your web and wallet numbers, never joined with them: UsageMap does not know which visitor made which transaction, by design.

Only contract IDs can be registered today. Issuing accounts, app accounts and WASM hashes aren't supported yet.

On this page