Usa Oráculos en tus Aplicaciones Aptos

Esta guía de referencia presenta varios Oráculos que puedes utilizar al construir en Aptos. Los oráculos suministran datos offchain a la blockchain, permitiendo que los contratos inteligentes accedan a una amplia gama de información.

La Pyth Network es una de las redes de oráculos de primera parte más grandes, entregando datos en tiempo real a través de una gran cantidad de cadenas.

La red está compuesta por algunos de los mayores exchanges, creadores de mercado y proveedores de servicios financieros del mundo. Estos publican datos propietarios on-chain para su agregación y distribución a aplicaciones de contratos inteligentes.

Esta guía explica cómo usar datos en tiempo real de Pyth en aplicaciones Aptos.

Agrega el contrato de Pyth a las dependencias de tu proyecto en el archivo Move.toml:

[dependencies]
Pyth = { git = "https://github.com/pyth-network/pyth-crosschain.git", subdir = "target_chains/aptos/contracts", rev = "main" }

Las direcciones nombradas de pyth, wormhole y deployers deben definirse en tiempo de compilación. Estas direcciones se usan para interactuar con el contrato de Pyth en Aptos.

[addresses]
pyth = "0x7e783b349d3e89cf5931af376ebeadbfab855b3fa239b7ada8f5a92fbea6b387"
deployer = "0xb31e712b26fd295357355f6845e77c888298636609e93bc9b05f0f604049f434"
wormhole = "0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625"

Consulta Direcciones de Contrato de Aptos para la lista completa de direcciones de contrato en diferentes redes de Aptos.

El fragmento de código a continuación proporciona un módulo de ejemplo que obtiene el precio BTC/USD de los feeds de precios de Pyth:

module example::example {
    use pyth::pyth;
    use pyth::price::Price;
    use pyth::price_identifier;
    use aptos_framework::coin;

    // Agrega el argumento pyth_price_update a cualquier método en tu contrato que necesite leer el precio de Pyth.
    // Consulta https://docs.pyth.network/price-feeds/fetch-price-updates para más información sobre cómo obtener el pyth_price_update.
    public fun get_btc_usd_price(user: &signer, pyth_price_update: vector<vector<u8>>): Price {

        // Primero actualiza los feeds de precios de Pyth
        let coins = coin::withdraw(user, pyth::get_update_fee(&pyth_price_update));
        pyth::update_price_feeds(pyth_price_update, coins);

        // Lee el precio actual de un feed de precios.
        // Cada feed de precios (ej., BTC/USD) se identifica por un ID de feed de precios.
        // La lista completa de IDs de feed está disponible en https://pyth.network/developers/price-feed-ids
        // Nota: Aptos usa el ID de feed de precios de Pyth sin el prefijo `0x`.
        let btc_price_identifier = x"e62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43";
        let btc_usd_price_id = price_identifier::from_byte_vec(btc_price_identifier);
        pyth::get_price(btc_usd_price_id)
    }
}

El fragmento de código anterior hace las siguientes cosas:

1. Llama pyth::get_update_fee para obtener la tarifa requerida para actualizar los feeds de precios de Pyth.
2. Llama pyth::update_price_feeds y pasa pyth_price_update para actualizar los feeds de precios de Pyth.
3. Llama pyth::get_price para leer el precio actual, proporcionando el ID de feed de precios que deseas leer.

Puedes encontrar estos recursos adicionales útiles para desarrollar tu aplicación Aptos.

Los feeds de precios listados en la tabla a continuación están actualmente patrocinados en Aptos mainnet.

Parámetros de Actualización: 1 segundo de heartbeat o 0.5% de desviación de precio

Para más detalles sobre feeds patrocinados, consulta aquí

La referencia de API de Aptos te permite explorar interactivamente la API completa del contrato de Pyth.

• Contrato on-chain mínimo, que actualiza y devuelve el precio BTC/USD de los feeds de precios de Pyth.
• Acuñar NFT que usa feeds de precios de Pyth para acuñar un NFT.