Ir al contenido

Codigo de Ejemplo del SDK de Rust

Para codigo de ejemplo que explica los conceptos fundamentales de como usar el SDK, consulta:

A continuacion se presentan recursos adicionales y una lista completa de ejemplos ejecutables incluidos en el repositorio del SDK.

El directorio examples en el repositorio del SDK contiene una amplia gama de ejemplos que puedes ejecutar y personalizar segun tus necesidades.

Para ejecutar un ejemplo:

Ventana de terminal
git clone https://github.com/aptos-labs/aptos-rust-sdk.git
cd aptos-rust-sdk
cargo run --example transfer --features "ed25519,faucet"

Estos ejemplos demuestran interacciones fundamentales con la blockchain de Aptos como transferir tokens, consultar saldos y obtener datos on-chain.

EjemploDescripcionFeatures
transferTransferir APT entre dos cuentas en testneted25519, faucet
balance_checkerConsultar el saldo de APT de una o mas cuentased25519
view_functionLlamar funciones de vista on-chain y parsear valores de retornoed25519
transaction_dataObtener y mostrar datos detallados de transacciones por hash o versioned25519, faucet
transaction_waitingEnviar una transaccion y esperar confirmacion con sondeo de estadoed25519, faucet

Estos ejemplos cubren la creacion de cuentas, configuraciones multi-clave y flujos de trabajo de cuentas multisig.

EjemploDescripcionFeatures
account_managementCrear, financiar y rotar claves de autenticacion para cuentased25519, faucet
multi_key_accountCrear una cuenta controlada por multiples claves con un umbral de firmaed25519, secp256k1, faucet
multi_sig_accountConfigurar y usar una cuenta multisig con multiples propietariosed25519, faucet
multisig_v2Usar el modulo multisig v2 para propuestas de estilo gobernanza on-chained25519, faucet

Estos ejemplos muestran patrones de transacciones mas sofisticados incluyendo funciones entry, simulacion, transacciones multi-agente y transacciones patrocinadas.

EjemploDescripcionFeatures
entry_functionConstruir y enviar payloads de funciones entry con argumentos tipadosed25519, faucet
advanced_transactionsDemostrar envio por lotes, ajuste de gas y control de expiracioned25519, faucet
simulationSimular una transaccion para estimar gas y verificar ejecucion sin confirmared25519, faucet
multi_agentConstruir transacciones que requieren firmas de multiples cuentas remitentesed25519, faucet
sponsored_transactionEnviar una transaccion donde una cuenta separada paga las tarifas de gased25519, faucet
script_transactionCompilar y ejecutar un script Move como payload de transaccioned25519, faucet

Estos ejemplos demuestran el despliegue de modulos Move, llamadas a funciones de contratos, lectura del estado de contratos y generacion de bindings con tipado seguro.

EjemploDescripcionFeatures
deploy_moduleCompilar y publicar un modulo Move en la blockchained25519, faucet
call_contractInvocar funciones entry en un modulo Move desplegadoed25519, faucet
read_contract_stateLeer recursos y datos almacenados por un modulo Moveed25519
contract_bindingsUsar la macro aptos_contract! para generar bindings de Rust con tipado seguro para un moduloed25519, faucet, macros
codegenAuto-generar tipos y funciones de Rust a partir de ABIs de modulos on-chained25519, macros
nft_operationsCrear colecciones, acuniar tokens y transferir activos digitalesed25519, faucet

Estos ejemplos muestran como consultar eventos y datos indexados de la red de Aptos.

EjemploDescripcionFeatures
event_queriesEscuchar y filtrar eventos on-chain por tipo y cuentaed25519
indexer_queriesConsultar el indexador de Aptos para datos agregados de tokens, monedas y transaccionesed25519, indexer
  • Codigo fuente del SDK — Explora la implementacion con documentacion y comentarios en linea.
  • Referencia en docs.rs — Documentacion completa de la API con busqueda y referencias cruzadas.
  • Tests end-to-end — El conjunto mas completo de codigo que ejercita la funcionalidad del SDK, util como referencia para patrones de uso avanzados.