Basic Transactions

This section covers the basic transaction types that can be built and submitted to the Aptos blockchain.

1. Set up your AptosClient

   Set up your Aptos client by adding the Aptos namespace and instantiating an AptosClient. You can use a predefined configuration from Networks or configuring your own.

   using Aptos;
   
   class Program
   {
       static void Main(string[] args)
       {
           var config = new AptosConfig(Aptos.Networks.Mainnet);
           var client = new AptosClient(config);
       }
   }

2. Set up an Account

   To create a transaction, you will need an account to sign the transaction. This can be done using a private key, mnemonic, or a combination of both. In this example, we will generate a random new account.

   using Aptos;
   
   class Program
   {
       static void Main(string[] args)
       {
           var config = new AptosConfig(Aptos.Networks.Devnet);
           var client = new AptosClient(config);
   
           // 1. Create an account and fund it.
           var account = Account.Generate();
           await client.Faucet.FundAccount(account.Address, 100_000_000);
       }
   }

3. Build the Transaction

   To interact with the blockchain, you will need to build a transaction. The AptosClient can be used to build a transaction payload that can be signed and submitted to chain. In the transaction, we can specify the sender, entry function, and arguments.

   using Aptos;
   
   class Program
   {
       static void Main(string[] args)
       {
           var config = new AptosConfig(Aptos.Networks.Devnet);
           var client = new AptosClient(config);
   
           var account = Account.Generate();
   
           // 2. Build the transaction
           var transaction = await client.Transaction.Build(
               sender: account,
               data: new GenerateEntryFunctionPayloadData(
                   function: "0x1::aptos_account::transfer_coins",
                   typeArguments: ["0x1::aptos_coin::AptosCoin"],
                   functionArguments: [account.Address, "100000"]
               )
           );
       }
   }

4. Sign and Submit Transactions

   Once the transaction is built, it can be signed and submitted to the blockchain. The AptosClient can be used to sign and submit the transaction.

   using Aptos;
   
   class Program
   {
       static void Main(string[] args)
       {
           var config = new AptosConfig(Aptos.Networks.Devnet);
           var client = new AptosClient(config);
   
           var account = Account.Generate();
   
           var transaction = await client.Transaction.Build(
               sender: account,
               data: new GenerateEntryFunctionPayloadData(
                   function: "0x1::aptos_account::transfer_coins",
                   typeArguments: ["0x1::aptos_coin::AptosCoin"],
                   functionArguments: [account.Address, "100000"]
               )
           );
   
           // 3. Sign the transaction
           var submittedTransaction = await client.Transaction.SignAndSubmitTransaction(signer, transaction);
       }
   }

5. (Optional) Wait for the Transaction to Execute

   After the transaction has been submitted, it will have to process before its committed to the blockchain. The AptosClient can be used to wait for the transaction to be processed and executed.

   using Aptos;
   
   class Program
   {
       static void Main(string[] args)
       {
           var config = new AptosConfig(Aptos.Networks.Devnet);
           var client = new AptosClient(config);
   
           var account = Account.Generate();
   
           var transaction = await client.Transaction.Build(
               sender: account,
               data: new GenerateEntryFunctionPayloadData(
                   function: "0x1::aptos_account::transfer_coins",
                   typeArguments: ["0x1::aptos_coin::AptosCoin"],
                   functionArguments: [account.Address, "100000"]
               )
           );
   
           var submittedTransaction = await client.Transaction.SignAndSubmitTransaction(account, transaction);
   
           // 4. Wait for the transaction to be processed
           var transactionResult = await client.Transaction.WaitForTransaction(submittedTransaction.Hash);
       }
   }