Free 30-min Web3 Consultation
Book Now
Smart Contract Security Audits
Learn More
Custom DeFi Protocol Development
Explore
Full-Stack Web3 dApp Development
View Services
Free 30-min Web3 Consultation
Book Now
Smart Contract Security Audits
Learn More
Custom DeFi Protocol Development
Explore
Full-Stack Web3 dApp Development
View Services
Free 30-min Web3 Consultation
Book Now
Smart Contract Security Audits
Learn More
Custom DeFi Protocol Development
Explore
Full-Stack Web3 dApp Development
View Services
Free 30-min Web3 Consultation
Book Now
Smart Contract Security Audits
Learn More
Custom DeFi Protocol Development
Explore
Full-Stack Web3 dApp Development
View Services
LABS
Glossary

Asset Class ID

An Asset Class ID is a unique identifier (a uint256) that defines a specific fungible token type within an ERC-1155 multi-token smart contract.
Chainscore © 2026
definition
BLOCKCHAIN GLOSSARY

What is Asset Class ID?

A precise identifier for categorizing digital assets on a blockchain, enabling systematic tracking and interoperability.

An Asset Class ID is a unique, standardized identifier used within a blockchain protocol to categorize and differentiate distinct types of digital assets, such as fungible tokens, non-fungible tokens (NFTs), or semi-fungible tokens. This identifier is a fundamental component of token standards and asset management systems, allowing smart contracts, wallets, and explorers to programmatically recognize an asset's inherent properties and behavior. For example, in the Cosmos SDK, the ClassId is a core concept within the Inter-Blockchain Communication (IBC) protocol's ICS-721 standard for NFTs, enabling the secure transfer of NFT collections across sovereign blockchains.

The primary function of an Asset Class ID is to establish a namespace for a collection of assets that share common logic and metadata. Unlike a specific token's unique ID (e.g., TokenId), the Class ID refers to the entire collection or class. This separation is critical for interoperability and composability, as it allows decentralized applications (dApps) to interact with entire asset families through a single, consistent identifier. On a technical level, the Class ID is often a human-readable string (like cryptopunks) or a derived hash that is permanently mapped to the smart contract or module that governs the minting and rules for assets of that class.

Implementations vary by ecosystem. In Cosmos, the ClassId is a crucial part of the IBC NFT standard, prefixed with the issuing chain's identifier (e.g., {chain}-{identifier}). In other frameworks, similar concepts exist under different names, such as a Collection ID or a contract address that inherently defines a class. The use of Asset Class IDs prevents collision between assets from different origins and forms the basis for advanced functionalities like cross-chain asset verification, fractionalization protocols, and unified marketplaces that can index and display all assets belonging to a specific class, regardless of their individual traits or ownership.

how-it-works
BLOCKCHAIN IDENTIFIER

How Asset Class IDs Work

A technical explanation of the unique identifiers used to classify and manage digital assets on distributed ledgers.

An Asset Class ID is a unique, standardized identifier used within a blockchain protocol or application to categorize and differentiate distinct types of digital assets, such as fungible tokens, non-fungible tokens (NFTs), or other on-chain value representations. This identifier functions as a primary key within the system's data model, enabling smart contracts, wallets, and explorers to correctly interpret and handle the asset's properties and rules. Unlike a token's contract address, which points to its code, the Asset Class ID specifies the type of asset governed by that contract, allowing multiple asset classes to exist under a single smart contract umbrella.

The structure and generation of an Asset Class ID are defined by the underlying protocol. In systems like Stellar or Ripple, the ID is often a composite key combining the asset's issuer address and a short asset code. For Ethereum-based standards like ERC-1155, the ID is a single uint256 integer defined within the contract, where each unique ID represents a different asset class (e.g., ID #1 for "Gold Sword," ID #2 for "Health Potion"). This design is crucial for batch operations, where a single transaction can transfer multiple asset types by referencing their respective IDs, significantly improving efficiency and reducing gas costs.

From a technical perspective, the Asset Class ID is the linchpin for metadata resolution and behavioral logic. When a wallet or dApp queries an asset, it uses this ID to look up off-chain metadata (like name, image, and attributes) typically stored in a decentralized file system or an oracle. Furthermore, the smart contract's logic uses the ID to apply specific rules—such as transfer restrictions, royalty schemes, or crafting recipes—tailored to that asset class. This separation of identifier, metadata, and logic is fundamental to building scalable and interoperable digital asset ecosystems.

key-features
CORE PROPERTIES

Key Features of Asset Class IDs

Asset Class IDs are unique, on-chain identifiers that standardize the classification of digital assets. They enable composability and programmability across DeFi protocols by providing a common data layer for risk, compliance, and financial logic.

01

Standardized Classification

An Asset Class ID provides a universal, machine-readable label for an asset's financial and technical characteristics. This replaces ambiguous, protocol-specific naming conventions (e.g., 'stablecoin', 'blue-chip') with a precise, on-chain identifier. Key attributes encoded can include:

  • Asset type (e.g., fungible token, NFT, LP position)
  • Underlying collateral and risk profile
  • Regulatory status and compliance flags
  • Protocol of origin and technical standard (ERC-20, ERC-721)
02

On-Chain Verifiability

Unlike off-chain labels or API data, an Asset Class ID's properties are immutably stored and verifiable on-chain, typically within a smart contract or registry. This ensures that any protocol or wallet reading the ID receives the same, tamper-proof definition. It creates a single source of truth for asset metadata, eliminating discrepancies between different platforms' internal classification systems and enabling trustless interoperability.

03

Composability Driver

By providing a shared semantic layer, Asset Class IDs are a fundamental primitive for DeFi composability. A lending protocol can use the ID to automatically apply risk parameters, a DEX can route liquidity based on asset type, and a portfolio manager can rebalance according to predefined strategies—all without prior integration. This turns ad-hoc, bilateral integrations into permissionless, multi-party coordination based on a common understanding of what an asset represents.

04

Programmable Financial Logic

Smart contracts can execute logic conditionally based on an asset's class. For example:

  • A money market can assign loan-to-value ratios and liquidation thresholds automatically.
  • A yield aggregator can select optimal strategies for 'stablecoin' vs. 'volatile crypto' classes.
  • A cross-chain bridge can enforce different security models for 'governance token' vs. 'wrapped asset' transfers. This moves financial rule-sets from hardcoded, administrative updates to dynamic, data-driven configurations.
05

Risk & Compliance Layer

Asset Class IDs embed critical data for automated risk management and regulatory compliance. They can signal if an asset is a security, a privacy coin subject to travel rule, or a stablecoin with specific reserve attestations. This allows protocols to:

  • Enforce geofencing or user accreditation requirements.
  • Calculate protocol-level risk exposure to specific asset categories.
  • Generate audit trails for regulatory reporting based on asset provenance.
06

Example: ERC-7641 Standard

ERC-7641 is a proposed Ethereum standard for Intrinsic Tokenized Assets (ITAs), which defines a canonical structure for Asset Class IDs. An ITA ID is a bytes32 identifier derived from a hash of the asset's core properties. It enables:

  • Deterministic derivation: The same asset properties always produce the same ID.
  • Registry-based resolution: A global registry maps IDs to their full metadata.
  • Backward compatibility: Existing ERC-20s can be wrapped into an ITA to receive a standardized class ID.
technical-details
ASSET CLASS ID

Technical Details & Structure

An in-depth look at the technical specification and structural role of the Asset Class ID within the Chainscore protocol.

An Asset Class ID is a unique, protocol-level identifier that categorizes a digital asset (e.g., a token) into a specific risk and behavioral class within the Chainscore ecosystem. This identifier is a core data primitive, analogous to a fungible token standard like ERC-20, but designed for on-chain reputation and risk assessment. It acts as a key that maps an asset to a predefined set of scoring models, parameters, and historical data templates used by the Chainscore Oracle to generate a consistent and comparable reputation score.

The structure of an Asset Class ID is deterministic and derived from the asset's on-chain properties, such as its contract address and the blockchain it resides on. This ensures that the same asset will always resolve to the same ID across the network, providing a globally consistent reference. The classification logic evaluates technical attributes—including tokenomics, issuance schedule, governance mechanisms, and historical liquidity patterns—to assign the asset to the most appropriate class, such as stablecoin, governance_token, or liquid_staking_token.

From a system architecture perspective, the Asset Class ID functions as a critical lookup key within the Chainscore data model. It enables the oracle to efficiently retrieve the correct scoring algorithm and historical data slices needed for computation. This separation of classification from raw scoring allows for scalable model updates; modifying the parameters for an entire asset class (e.g., all decentralized_exchange tokens) automatically applies to every asset within that class, ensuring system-wide consistency and simplifying maintenance.

For developers and integrators, interacting with the Asset Class ID is fundamental. When querying the Chainscore Oracle for an asset's reputation score, the request must include or resolve this ID. Smart contracts that consume scores use the ID to verify they are receiving data for the correct asset class, a crucial check for composability and security in DeFi applications like lending protocols or cross-chain bridges, where risk parameters differ drastically between a volatile meme coin and a collateralized stablecoin.

The evolution of Asset Class IDs is managed through Chainscore's governance. As new asset types emerge (e.g., real-world asset (RWA) tokens or novel DeFi primitives), the protocol can define new classes via community proposal and voting. This extensible structure ensures the system remains relevant and can accurately model the risk profiles of future financial instruments without requiring a fundamental overhaul of the core oracle infrastructure.

COMPARISON

Asset Class ID vs. Other Token Identifiers

A technical comparison of key properties for different token identification standards.

FeatureAsset Class ID (ERC-7579)Token ID (ERC-721/1155)Contract Address

Primary Purpose

Identifies a fungible asset class across contracts

Identifies a unique token or token type within a contract

Identifies a single smart contract

Scope & Granularity

Cross-contract, protocol-level

Intra-contract, instance-level

Single deployment, contract-level

Fungibility Guarantee

Guarantees fungibility for all tokens of the class

ERC-721: Non-fungible. ERC-1155: Can be fungible per ID

Depends on the contract's token standard implementation

Composability Layer

Native standard for cross-protocol asset logic (e.g., indexing, risk)

Used within application-specific logic

Foundation for all contract interactions

Decentralized Identifier (DID)

Yes, a DID method for fungible assets (did:assetclass:*)

No standard DID method

Can be used as a controller for DIDs (e.g., did:ethr)

Relationship Mapping

One-to-many with Token IDs and Contract Addresses

Many-to-one with a Contract Address

One-to-many with Token IDs

Example Use Case

Unified liquidity risk score for all USDC across chains

Proving ownership of CryptoPunk #7804

Interacting with the main USDC contract on Ethereum

examples
ASSET CLASS ID

Real-World Examples

An Asset Class ID is a standardized identifier used to categorize and track different types of digital assets on-chain. These examples illustrate how they function in major protocols.

ecosystem-usage
ASSET CLASS ID

Ecosystem Usage

An Asset Class ID is a standardized identifier used to categorize and manage different types of digital assets within a blockchain ecosystem, enabling interoperability across protocols and applications.

01

Core Purpose & Standardization

The primary function of an Asset Class ID is to provide a common language for protocols to identify asset types, such as fungible tokens, NFTs, or liquidity pool (LP) tokens. This standardization is crucial for:

  • Automated portfolio tracking across DeFi platforms.
  • Risk assessment engines to apply correct valuation models.
  • Cross-protocol composability, allowing dApps to understand and interact with any asset.
02

Implementation in DeFi Protocols

Leading DeFi protocols use Asset Class IDs to manage collateral and asset logic. For example:

  • Aave & Compound use them to determine which assets are eligible as collateral and their respective loan-to-value (LTV) ratios.
  • Yearn Finance vaults use IDs to categorize the underlying strategy assets (e.g., stablecoins, LP tokens, yield-bearing tokens).
  • Chainlink oracles may reference these IDs to fetch the correct price feed for a specific asset class.
03

Interoperability & Cross-Chain Use

Asset Class IDs enable seamless asset recognition across different blockchain networks via bridges and messaging layers.

  • Wormhole and LayerZero can map an asset's class from one chain (e.g., Ethereum's ERC-20) to another (e.g., Solana's SPL token).
  • This allows cross-chain dApps and aggregators to maintain a consistent view of a user's portfolio and risk exposure, regardless of the underlying chain.
04

Regulatory & Reporting Frameworks

For institutional adoption, Asset Class IDs provide a technical foundation for compliance. They help in:

  • Automating tax reporting by clearly distinguishing between capital assets, income-generating assets, and commodities.
  • Applying regulatory treatment, as securities, utilities, or commodities may be defined by their on-chain class identifier.
  • Audit trails that categorize transaction types based on the assets involved.
05

Examples in Token Standards

While not explicitly named "Asset Class ID," the concept is embedded in various token standards and metadata schemas:

  • ERC-20 (decimals, symbol) for fungible tokens.
  • ERC-721 & ERC-1155 for non-fungible and semi-fungible tokens.
  • EIP-4626 (Tokenized Vault Standard) explicitly defines a vault's asset class via its underlying token address.
  • Cosmos SDK's Coin type includes a denom that acts as a class identifier.
06

Role in Risk Management

Asset Class IDs are critical inputs for on-chain and off-chain risk engines. They allow systems to:

  • Group assets by volatility profile (e.g., stablecoin vs. governance token).
  • Calculate correlated risk across a portfolio.
  • Trigger automated safeguards, like pausing borrowing for a specific asset class if its oracle price becomes unstable or its underlying protocol is exploited.
security-considerations
ASSET CLASS ID

Security Considerations

Asset Class IDs are critical for programmatic risk assessment and compliance. Their security implications extend from smart contract integrity to cross-protocol interoperability.

01

Standardization & Interoperability

A lack of standardized Asset Class ID definitions across protocols creates security risks. Inconsistent mappings can lead to:

  • Misclassification: A protocol mislabeling a high-risk asset as low-risk, leading to improper collateral valuation.
  • Bridge Vulnerabilities: Cross-chain bridges using different ID schemes may incorrectly wrap or transfer assets, creating arbitrage or exploit opportunities.
  • Oracle Disagreement: Price oracles referencing different underlying assets for the same ID can cause liquidation errors or manipulation.
02

Smart Contract Logic Reliance

DeFi protocols hardcode Asset Class ID checks into their permissionless smart contract logic. Key risks include:

  • Immutable Errors: An incorrect or outdated ID mapping cannot be easily patched if the contract is not upgradeable.
  • Logic Flaws: Access control or fee logic based on asset class can be bypassed if an attacker finds an asset that shares an ID but has different properties.
  • Integration Risk: Newly listed assets with a 'safe' ID but novel behavior (e.g., rebasing, fee-on-transfer) can break core protocol assumptions.
03

Governance & Centralization Risk

The process for assigning and updating Asset Class IDs often involves privileged actors, introducing centralization vectors.

  • Admin Keys: A multisig or DAO controlling the ID registry becomes a high-value attack target.
  • Governance Attacks: An attacker gaining protocol governance could maliciously reclassify assets to destabilize the system (e.g., marking stablecoins as volatile).
  • Opaque Criteria: Lack of transparent, on-chain rules for ID assignment can lead to arbitrary decisions and reduced trust in the risk framework.
04

Data Integrity & Oracle Security

Asset Class IDs are foundational for risk oracles and data feeds. Compromising an ID's meaning can poison downstream systems.

  • Oracle Manipulation: If an ID's definition can be changed, it could affect the risk score or loan-to-value (LTV) ratio for thousands of positions simultaneously.
  • Data Source Compromise: A malicious or faulty data provider reporting incorrect classifications for an ID could trigger systemic liquidations or prevent them when necessary.
  • Time-of-Check vs Time-of-Use: An asset's class could be changed between the time a transaction is submitted and executed, leading to unexpected behavior.
05

Composability and Systemic Risk

In DeFi's composable ecosystem, a single Asset Class ID failure can propagate risk.

  • Contagion: A misclassified asset in a major money market (like Aave or Compound) can be used as collateral across dozens of integrated protocols, spreading insolvency risk.
  • Aggregator Reliance: Yield aggregators and vaults that automatically allocate based on asset class could concentrate funds into a vulnerable category.
  • Regulatory Perimeter: For protocols implementing compliance (e.g., whitelists for licensed assets), an incorrect ID could lead to servicing unauthorized jurisdictions.
ASSET CLASS ID

Common Misconceptions

Clarifying frequent misunderstandings about Asset Class IDs, a core concept for tokenizing real-world assets on blockchains.

No, an Asset Class ID is a fundamental, immutable identifier for a category of assets, while a token ticker is a human-readable symbol for a specific token instance. The Asset Class ID is defined in the token's smart contract (e.g., as a bytes32 value) and is used to programmatically enforce rules and permissions for all assets in that class, such as transfer restrictions or compliance checks. A ticker like "USDC" or "RWAGOLD" is simply a label for user interfaces and exchanges. Multiple token contracts with different tickers can share the same underlying Asset Class ID if they represent the same regulated asset type.

ASSET CLASS ID

Frequently Asked Questions

Asset Class ID is a fundamental concept for categorizing and managing digital assets on-chain. These questions address its purpose, technical implementation, and practical applications.

An Asset Class ID is a unique, on-chain identifier used to categorize a distinct group of fungible tokens, typically within a single smart contract. It functions as a primary key that groups all tokens sharing the same core properties, such as name, symbol, and metadata schema. This concept is central to token standards like ERC-1155, where a single contract can manage multiple token types, each identified by its own uint256 ID. The ID enables efficient batch operations, as users can query balances or transfer multiple token types from the same class in a single transaction. It is the foundational layer for inventory systems, gaming assets, and multi-token DeFi applications.

ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected direct pipeline