logo

Conectarse a una red Sui

Sui tiene redes Mainnet, Devnet y Testnet disponibles. Puedes usar uno de las redes de prueba, Devnet o Testnet, para experimentar con la versión de Sui corriendo en esa red. También puede activar una [red Sui local] (https://docs.sui.io/build/sui-local-network) para el desarrollo local.
Las redes Sui Testnet y Devnet consisten en:
  • Cuatro nodos validadores operados por Mysten Labs. Los clientes envían transacciones y solicitudes de lectura a través de este punto final: https://fullnode.<SUI-NETWORK-VERSION>.sui.io:443 usando [JSON-RPC](https://docs.sui.io/build/ json-rpc).
  • Una red pública Sui Explorer para navegar por el historial de transacciones.
Puede solicitar tokens SUI de prueba a través de Sui [devnet-faucet](https://discordapp.com/ canales/916379725201563759/971488439931392130) y testnet-faucet Canales de discordia, según la versión de la red que utilice. Si conectado a Localnet, use cURL para solicitar tokens de su faucet local. Las monedas en estas redes no tienen valor financiero. Por razones obvias, no hay servicio de faucet para Mainnet.
Vea anuncios sobre Sui en el #anuncios canal de Discord.
Consulte los [términos de servicio] (https://sui.io/terms/) para usar las redes Sui.

Herramientas

Sui proporciona las siguientes herramientas para interactuar con las redes de Sui:

Configuración del entorno

Primero, Instalar Sui. Después de instalar Sui, solicitar tokens de prueba SUI a través de Discord para la red que está utilizando: [Devnet](https ://discordapp.com/channels/916379725201563759/971488439931392130) o Testnet. Si está conectado a Localnet, use cURL para solicitar tokens de su [faucet local] (https://docs.sui.io/build/sui-local-network#use-the-local-faucet).
Para verificar si Sui ya está instalado, ejecute el siguiente comando:
plain text
which sui
  • Copiar
Si Sui está instalado, el comando devuelve la ruta al binario de Sui. Si Sui no está instalado, devuelve sui not found.
Consulte la página Versiones de Sui para ver los cambios en cada versión de Sui.

Configure el cliente Sui

Si anteriormente ejecutó sui genesis para crear una red local, creó un archivo de configuración de cliente Sui (client.yaml) que se conecta a localhost en http://0.0.0.0:9000. Consulte Conectarse al extremo de RPC personalizado para actualizar el archivo client.yaml.
Para conectar el cliente Sui a una red, ejecute el siguiente comando:
plain text
sui client
  • Copiar
Si recibe la salida de ayuda sui-client en la consola, ya tiene un archivo client.yaml. Consulte Conectarse al extremo de RPC personalizado para agregar un nuevo alias de entorno o cambiar la red actualmente activa.
La primera vez que inicia el cliente Sui sin tener un archivo client.yaml, la consola muestra el siguiente mensaje:
plain text
Config file ["<PATH-TO-FILE>/client.yaml"] doesn't exist, do you want to connect to a Sui Full node server [y/N]?
  • Copiar
Presione y y luego presione Entrar. Luego, el proceso solicita la URL del servidor RPC:
plain text
Sui Full node server URL (Defaults to Sui Devnet if not specified) :
  • Copiar
Presione Entrar para conectarse a Sui Devnet. para usar un servidor RPC personalizado, Sui Testnet o Sui Mainnet, ingrese la URL al punto final RPC correcto y luego presione Enter.
Si ingresa una URL, el proceso solicita un alias para el entorno:
plain text
Environment alias for [<URL-ENTERED>] :
  • Copy
Type an alias name and press Enter.
plain text
Select key scheme to generate keypair (0 for ed25519, 1 for secp256k1, 2 for secp256r1):
  • Copy
Press 0, 1, or 2 to select a key scheme and the press Enter.
Sui returns a message similar to the following (depending on the key scheme you selected) that includes the address and 24-word recovery phrase for the address:
plain text
Generated new keypair for address with scheme "ed25519" [0xb9c83a8b40d3263c9ba40d551514fbac1f8c12e98a4005a0dac072d3549c2442] Secret Recovery Phrase : [cap wheat many line human lazy few solid bored proud speed grocery raise erode there idea inform culture cousin shed sniff author spare carpet]
  • Copy

Connect to a custom RPC endpoint#

If you previously used sui genesis with the force option (-f or --force), your client.yaml file already includes two RPC endpoints: localnet at http://0.0.0.0:9000 and devnet at https://fullnode.devnet.sui.io:443. You can view the defined environments with the sui client envs command, and switch between them with the sui client switch command.
If you previously installed a Sui client that connected to a Sui network, or created a local network, you can modify your existing client.yaml file to change the configured RPC endpoint. The sui client commands that relate to environments read from and write to the client.yaml file.
To check currently available environment aliases, run the following command:
plain text
sui client envs
  • Copy
The command outputs the available environment aliases, with (active) denoting the currently active network.
plain text
localnet => http://0.0.0.0:9000 (active) devnet => https://fullnode.devnet.sui.io:443
  • Copy
To add a new alias for a custom RPC endpoint, run the following command. Replace values in < > with values for your installation:
plain text
sui client new-env --alias <ALIAS> --rpc <RPC-SERVER-URL>
  • Copy
To switch the active network, run the following command:
plain text
sui client switch --env <ALIAS>
  • Copy
If you encounter an issue, delete the Sui configuration directory (~/.sui/sui_config) and reinstall the latest Sui binaries.

Validating#

In the following sections, the object IDs, addresses, and authority signatures used are example values only. Sui generates unique values for each of these, so you see different values when you run the commands.

Request test tokens#

  1. Join Discord.
If you try to join the Sui Discord channel using a newly created Discord account you may need to wait a few days for validation.
  1. Get your Sui client address: sui client active-address
  1. Request test SUI tokens in the Sui #devnet-faucet or #testnet-faucet Discord channel. Send the following message to the relevant channel with your client address: !faucet <YOUR-CLIENT-ADDRESS>. If you have a local network, programmatically request tokens from your local faucet.

Publish a Move module#

This section describes how to publish a sample Move package using code developed in the Sui Move tutorial. The instructions assume that you installed Sui in the default location.
plain text
sui client publish <your-sui-repo>/sui_programmability/examples/move_tutorial --gas-budget 30000
  • Copy
The response resembles the following:
plain text
INCLUDING DEPENDENCY Sui INCLUDING DEPENDENCY MoveStdlib BUILDING MyFirstPackage Successfully verified dependencies on-chain against source. ----- Transaction Digest ---- 7xQeJg5MVE186VaR1a5CCqvfb9eRmXNfDjpNMrTeM6HV ----- Transaction Data ---- Transaction Signature: [Signature(Ed25519SuiSignature(Ed25519SuiSignature([0, 248, 176, 107, 234, 50, 201, 78, 231, 28, 11, 201, 64, 80, 7, 211, 47, 106, 34, 107, 188, 125, 175, 79, 66, 191, 133, 122, 215, 138, 29, 0, 144, 69, 203, 13, 190, 225, 222, 151, 27, 76, 239, 210, 114, 205, 25, 5, 140, 116, 171, 90, 55, 148, 255, 41, 145, 148, 73, 198, 244, 106, 63, 65, 1, 198, 105, 207, 220, 225, 156, 27, 143, 143, 103, 80, 186, 158, 114, 177, 254, 3, 59, 146, 37, 220, 209, 19, 199, 189, 131, 122, 244, 243, 74, 19, 121])))] Transaction Kind : Programmable Inputs: [Pure(SuiPureValue { value_type: Some(Address), value: "0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be" })] Commands: [ Publish(_,,0x00000000000000000000000000000000000000000000000000000000000000010x0000000000000000000000000000000000000000000000000000000000000002), TransferObjects([Result(0)],Input(0)), ] Sender: 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be Gas Payment: Object ID: 0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de, version: 0x4, digest: HvsUbUj7mgDd8tDUbvrhywsaUfsCAp1DkhYyQ9qJhxUz Gas Owner: 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be Gas Price: 1 Gas Budget: 10000 ----- Transaction Effects ---- Status : Success Created Objects: - ID: 0x0c1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a , Owner: Immutable - ID: 0x72ba48a19cbde3aefce5a7408c0a1c15dd7656ee224adc0a6bc465a4f358a860 , Owner: Account Address ( 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be ) - ID: 0xa8e06fa6a7e0abc7bca7df78ce7414459c034a56e6a8a08add0999bc72d3d0a9 , Owner: Account Address ( 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be ) Mutated Objects: - ID: 0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de , Owner: Account Address ( 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be ) ----- Events ---- Array [] ----- Object changes ---- Array [ Object { "type": String("mutated"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "objectType": String("0x2::coin::Coin<0x2::sui::SUI>"), "objectId": String("0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de"), "version": Number(5), "previousVersion": Number(4), "digest": String("FmzCSQC1dGHcQRZjFrqF4JnoyuVcgriRXsuNLe64FGRg"), }, Object { "type": String("published"), "packageId": String("0x0c1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a"), "version": Number(1), "digest": String("BTakV197w43hoXXQZQzo3wczMyzDCyTfGt4dRHubWj1X"), "modules": Array [ String("my_module"), ], }, Object { "type": String("created"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "objectType": String("0x2::package::UpgradeCap"), "objectId": String("0x72ba48a19cbde3aefce5a7408c0a1c15dd7656ee224adc0a6bc465a4f358a860"), "version": Number(5), "digest": String("FRSNipvHZMTeUGpAv14aYrt3eBeexe6TjPkjJ1ZA4phA"), }, Object { "type": String("created"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "objectType": String("0xc1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a::my_module::Forge"), "objectId": String("0xa8e06fa6a7e0abc7bca7df78ce7414459c034a56e6a8a08add0999bc72d3d0a9"), "version": Number(5), "digest": String("CSWeoFXAf7kMrSQqT6fivWThHgvHbKXzwyjst44vas8b"), }, ] ----- Balance changes ---- Array [ Object { "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "coinType": String("0x2::sui::SUI"), "amount": String("-1121"), }, ]
  • Copy
The package publish operation creates several objects:
  • A package object (with ID 0x0c1c...305a in the example output).
  • A Forge object (with ID 0xa8e0...d0a9 in the example output) as a result of running a module initializer for the one (and only) module of this package.
  • An UpgradeCap object (with ID 0x72ba...a860 in the example output) for use in future package upgrades.
You can check the details of each object using the sui client object <OBJECT-ID> command or by using the Sui Explorer.
When you publish a package, the IDs for the objects the compiler creates are different than the ones displayed in this example. The remainder of this topic uses <PACKAGE-ID> and <FORGE-ID> to represent the IDs for the created objects (except for console output examples). You must replace these with the values for your package.

Make a Move call#

This section describes how to call into functions defined in the package published in the previous section. Use the (<PACKAGE-ID>) and (<FORGE-ID>) values from your package to create swords and transfer them to other players.
To demonstrate this, <PLAYER-ADDRESS> represents the address of the player to receive a sword. You can use an address of someone you know, or create another address for testing with the following Sui Client CLI command:
plain text
sui client new-address ed25519
  • Copy
The command returns the following message and a 24-word recovery phrase for the address:
plain text
Created new keypair for address with scheme ED25519: [0xa01cd0c520f12a1e9d57bf3cc6ea0f8cf93e81e9fe46f7b4916c310a809dfddd] Secret Recovery Phrase : [sunny tip element salad frequent february amount notice chair kite race push noise ketchup that same cannon bench mirror please dinosaur indicate violin sunset]
  • Copy
To create a sword and transfer it to another player, use the following command to call the sword_create function in the my_module module of the package you previously published.
You must use the same format for the command and function parameters as the example shown.
plain text
sui client call --function sword_create --module my_module --package 0x<PACKAGE-ID> --args \"0x<FORGE-ID>\" 42 7 \"0x<PLAYER-ADDRESS>\" --gas-budget 30000
  • Copy
The response resembles the following:
plain text
----- Transaction Digest ---- 5JqthvBVVWgCaDy77G1XSjZjw6eysx6WVrcLYrKPDtmK ----- Transaction Data ---- Transaction Signature: [Signature(Ed25519SuiSignature(Ed25519SuiSignature([0, 4, 117, 62, 101, 51, 245, 143, 229, 126, 215, 58, 173, 66, 58, 216, 191, 47, 107, 5, 20, 78, 67, 167, 206, 93, 99, 163, 224, 152, 16, 12, 131, 121, 160, 87, 201, 27, 26, 62, 228, 185, 73, 28, 228, 98, 8, 253, 199, 218, 215, 165, 235, 231, 127, 220, 20, 189, 72, 19, 164, 201, 191, 213, 12, 198, 105, 207, 220, 225, 156, 27, 143, 143, 103, 80, 186, 158, 114, 177, 254, 3, 59, 146, 37, 220, 209, 19, 199, 189, 131, 122, 244, 243, 74, 19, 121])))] Transaction Kind : Programmable Inputs: [Object(ImmOrOwnedObject { object_id: 0xa8e06fa6a7e0abc7bca7df78ce7414459c034a56e6a8a08add0999bc72d3d0a9, version: SequenceNumber(5), digest: o#CSWeoFXAf7kMrSQqT6fivWThHgvHbKXzwyjst44vas8b }), Pure(SuiPureValue { value_type: Some(U64), value: "42" }), Pure(SuiPureValue { value_type: Some(U64), value: "7" }), Pure(SuiPureValue { value_type: Some(Address), value: "0x72ba48a19cbde3aefce5a7408c0a1c15dd7656ee224adc0a6bc465a4f358a860" })] Commands: [ MoveCall(0x0c1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a::my_module::sword_create(,Input(0),Input(1),Input(2)Input(3))), ] Sender: 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be Gas Payment: Object ID: 0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de, version: 0x5, digest: FmzCSQC1dGHcQRZjFrqF4JnoyuVcgriRXsuNLe64FGRg Gas Owner: 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be Gas Price: 1 Gas Budget: 30000 ----- Transaction Effects ---- Status : Success Created Objects: - ID: 0x896ecfe58c9c6326284be0ce554a12b0d14158f6f7b4e3d5137ebe77488ccba6 , Owner: Account Address ( 0x72ba48a19cbde3aefce5a7408c0a1c15dd7656ee224adc0a6bc465a4f358a860 ) Mutated Objects: - ID: 0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de , Owner: Account Address ( 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be ) - ID: 0xa8e06fa6a7e0abc7bca7df78ce7414459c034a56e6a8a08add0999bc72d3d0a9 , Owner: Account Address ( 0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be ) ----- Events ---- Array [] ----- Object changes ---- Array [ Object { "type": String("mutated"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "objectType": String("0x2::coin::Coin<0x2::sui::SUI>"), "objectId": String("0x2750aed381dbb8cb6908cb1c0a977afe2b4fa5f6aa50f8fa146078a70fcad6de"), "version": Number(6), "previousVersion": Number(5), "digest": String("DTjcskKvVbd6xtuFac8iimQrD3msfj2MoZ1RssfqLPNC"), }, Object { "type": String("mutated"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "objectType": String("0xc1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a::my_module::Forge"), "objectId": String("0xa8e06fa6a7e0abc7bca7df78ce7414459c034a56e6a8a08add0999bc72d3d0a9"), "version": Number(6), "previousVersion": Number(5), "digest": String("GXCT1KohW18DkGFTcgMFoWioMumnNmMGdR3m6BjMq8qw"), }, Object { "type": String("created"), "sender": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), "owner": Object { "AddressOwner": String("0x72ba48a19cbde3aefce5a7408c0a1c15dd7656ee224adc0a6bc465a4f358a860"), }, "objectType": String("0xc1c0e82873b745509cecf62c341679cb5b543b866b7c8defcb38bb04089305a::my_module::Sword"), "objectId": String("0x896ecfe58c9c6326284be0ce554a12b0d14158f6f7b4e3d5137ebe77488ccba6"), "version": Number(6), "digest": String("7Ti1xqneQ1Pg2mEv8rW7Fd28gjH1jCTtSomzJYbQHg4J"), }, ] ----- Balance changes ---- Array [ Object { "owner": Object { "AddressOwner": String("0xb0f74e94014954b5c8a3abccbcfde2bf014c906a3fec1bb9736928f415a1f0be"), }, "coinType": String("0x2::sui::SUI"), "amount": String("-1018"), }, ]
  • Copy
Go to the Sui Explorer to observe a newly created object. You should see a sword object created with Magic property of 42 and Strength property of 7 and transferred to the new owner.
Image without caption
Explorer view of example sword object
To see your object in the current Sui Explorer, paste the object ID of the created object you observed in your own command output in the search field and press Enter. If your Sui Explorer doesn't find your object, make sure it's pointing to the right network.