TRC-950: TRON Chain ID Definition

Abierto Apto para principiantes
#950 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
68/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo

Línea de trabajo

Empieza leyendo el texto de la propuesta en esta issue junto con TIP-174 y TIP-474, a los que hace referencia. Comprueba que la derivación del Chain ID y los valores de Mainnet, Shasta y Nile se indiquen de forma coherente; el trabajo estará terminado cuando la definición independiente y los valores decimales sean claros y precisos.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

tip: 950
title: TRON Chain ID Definition
author: yanghang8612
discussions-to: https://github.com/tronprotocol/tips/issues/950
status: Draft
type: Standards Track
category: TRC
created: 2026-11-19
requires: 174, 474

Simple Summary

Define the TRON chain ID, its derivation rule, and the decimal values identifying the standard TRON networks.

Abstract

The chain ID, referred to as chainId, is a non-negative integer used to identify a TRON network.

This TIP provides a standalone definition of chainId, specifies its derivation from the genesis block ID, and documents the chain IDs of Mainnet, Shasta, and Nile. All chain ID values in this TIP are expressed in decimal notation.

Motivation

TIP-174 introduced the CHAINID instruction in TVM, and TIP-474 subsequently optimized its return value.

These proposals primarily specify instruction behavior. A standalone definition of the TRON chain ID provides a common reference for wallets, SDKs, applications, and other ecosystem specifications.

Specification

The key word MUST in this document is to be interpreted as described in RFC 2119.

Chain ID

The TRON chain ID is a non-negative integer derived from the genesis block ID of a TRON network.

Its value MUST be determined as follows:

  1. Obtain the block ID of the genesis block at block height 0.
  2. Extract the last four bytes of that block ID.
  3. Interpret those bytes as an unsigned big-endian integer.

The resulting integer is the network's chainId. Its value is between 0 and 4294967295, inclusive.

For a given genesis block ID, the derived chain ID remains constant.

Standard Network Values
Network Chain ID
Mainnet 728126428
Shasta 2494104990
Nile 3448148188

These values follow the derivation rule specified above.

Rationale

Deriving the chain ID from the genesis block ID provides a deterministic definition consistent with TIP-474.

A standalone definition and a common decimal presentation allow ecosystem specifications and integration documentation to reference the same network values consistently.

Backwards Compatibility

This TIP defines the network identifier without changing historical or current TVM instruction behavior. Existing activation conditions remain unchanged.

No hard fork or on-chain migration is required.

Implementation

The derivation rule is based on TIP-474. This TIP establishes a reference definition and does not require changes to consensus or TVM execution.

Copyright

Copyright and related rights waived via CC0.

Lenguaje dominante
Sin datos de lenguaje
Estrellas
341
Forks
347
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de tronprotocol/tips

Todos los issues de tronprotocol/tips

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.