Conceptos básicos de la red

fuente de la imagen: Blog de Hiro

Tokens

Los tokens Stacks (STX) son los tokens nativos en la blockchain de Stacks. La fracción más pequeña es un micro-STX. 1.000.000 de micro-STX constituyen un Stacks (STX).

Las cantidades de STX deben almacenarse como enteros (de 8 bytes de longitud) y representan la cantidad de micro-STX.

Comisiones

Las comisiones se usan para incentivar a los mineros a confirmar transacciones en la blockchain de Stacks. La comisión se calcula en función de la tasa de comisión estimada y del tamaño de la transacción sin procesar en bytes. La tasa de comisión es una variable determinada por el mercado. Para la testnet, se establece en 1 micro-STX.

Las estimaciones de comisiones se pueden obtener a través del GET /v2/fees/transfer endpoint de la API.

Tenga en cuenta que este ejemplo usa una herramienta externa, Hiro's Stacks API. También puede usar la Stacks API nativa si prefiere ejecutar su propio nodo o conectarse a uno.

terminal

# para mainnet, reemplace `testnet` por `mainnet`
curl 'https://api.testnet.hiro.so/v2/fees/transfer'

La API responderá con la tasa de comisión (como entero):

1

La biblioteca Stacks Transactions JS admite estimación de comisiones para:

• transferencias de tokens (estimateTransfer)

• implementaciones de contratos (estimateContractDeploy)

• llamadas a contratos no de solo lectura (estimateContractFunctionCall)

Para una implementación usando un lenguaje distinto a JavaScript, por favor revise esta implementación de referencia.

Nonces

Cada cuenta tiene una propiedad nonce que indica el número de transacciones procesadas para la cuenta dada. Los nonces son códigos de un solo uso, que comienzan en 0 para cuentas nuevas, y se incrementan en 1 en cada transacción.

Los nonces se añaden a todas las transacciones y ayudan a identificarlas para asegurar que las transacciones se procesen en orden y para evitar procesamientos duplicados.

El mecanismo de consenso también asegura que las transacciones no sean "reproducidas" de dos maneras. Primero, los nodos consultan sus salidas de transacciones no gastadas (UTXOs) para satisfacer sus condiciones de gasto en una nueva transacción. Segundo, los mensajes enviados entre nodos revisan números de secuencia.

Cuando se construye una nueva transacción de transferencia de tokens, es necesario obtener y establecer el nonce más reciente de la cuenta.

La API proporciona un endpoint para simplificar el manejo de nonces.

Consulta

Los detalles de la red Stacks se pueden consultar usando la Stacks Blockchain API.

Comprobación de estado

El verificador de estado es un servicio que proporciona una interfaz de usuario para revisar rápidamente la salud de la blockchain de Stacks.

Información de la red

La información de la red se puede obtener usando el GET /v2/info endpoint:

curl (testnet)

# para mainnet, reemplace `testnet` por `mainnet`
curl 'https://api.testnet.hiro.so/v2/info'

Respuesta de ejemplo:

{
    "peer_version": 385875968,
    "burn_consensus": "826401d65cf3671210a3fb135d827d549c0b4d37",
    "burn_block_height": 1972,
    "stable_burn_consensus": "e27ea23f199076bc41a729d76a813e125b725f64",
    "stable_burn_block_height": 1971,
    "server_version": "blockstack-core 0.0.1 => 23.0.0.0 (master:bdd042242+, release build, linux [x86_64]",
    "network_id": 2147483648,
    "parent_network_id": 3669344250,
    "stacks_tip_height": 933,
    "stacks_tip": "1f601823fbcc5b6b2215b2ff59d2818fba61ee4a3cea426d8bc3dbb268005d8f",
    "stacks_tip_burn_block": "54c56a9685545c45accf42b5dcb2787c97eda8185a1c794daf9b5a59d4807abc",
    "unanchored_tip": "71948ee211dac3b241eb65d881637f649d0d49ac08ee4a41c29217d3026d7aae",
    "exit_at_block_height": 28160
}