TypeScript SDK 快速入门

/**
 * 此示例展示如何使用 Aptos 客户端创建账户、注资并在账户间进行转账。
 */
 
import { Account, Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
 
const APTOS_COIN = "0x1::aptos_coin::AptosCoin";
const COIN_STORE = `0x1::coin::CoinStore<${APTOS_COIN}>`;
const ALICE_INITIAL_BALANCE = 100_000_000;
const BOB_INITIAL_BALANCE = 100;
const TRANSFER_AMOUNT = 100;
 
async function example() {
  console.log(
    "此示例将创建两个账户（Alice 和 Bob），为它们注资，并在它们之间进行转账。",
  );
 
  // 设置客户端
  const config = new AptosConfig({ network: Network.DEVNET });
  const aptos = new Aptos(config);
 
  // 生成两个账户凭证
  // 每个账户都有一个私钥、公钥和地址
  const alice = Account.generate();
  const bob = Account.generate();
 
  console.log("=== 地址 ===\n");
  console.log(`Alice 的地址是: ${alice.accountAddress}`);
  console.log(`Bob 的地址是: ${bob.accountAddress}`);
 
  // 使用水龙头为账户注资
  console.log("\n=== 为账户注资 ===\n");
 
  await aptos.fundAccount({
    accountAddress: alice.accountAddress,
    amount: ALICE_INITIAL_BALANCE,
  });
 
  await aptos.fundAccount({
    accountAddress: bob.accountAddress,
    amount: BOB_INITIAL_BALANCE,
  });
  console.log("Alice 和 Bob 的账户已成功注资！");
 
  // 查询新注资账户的余额
  console.log("\n=== 余额 ===\n");
  const aliceAccountBalance = await aptos.getAccountResource({
    accountAddress: alice.accountAddress,
    resourceType: COIN_STORE,
  });
  const aliceBalance = Number(aliceAccountBalance.coin.value);
  console.log(`Alice 的余额是: ${aliceBalance}`);
 
  const bobAccountBalance = await aptos.getAccountResource({
    accountAddress: bob.accountAddress,
    resourceType: COIN_STORE,
  });
  const bobBalance = Number(bobAccountBalance.coin.value);
  console.log(`Bob 的余额是: ${bobBalance}`);
 
  // 从 Alice 账户向 Bob 账户发送交易
  const txn = await aptos.transaction.build.simple({
    sender: alice.accountAddress,
    data: {
      // Aptos 上的所有交易都是通过智能合约实现的。
      function: "0x1::aptos_account::transfer",
      functionArguments: [bob.accountAddress, 100],
    },
  });
 
  console.log("\n=== 转账交易 ===\n");
  // 同时进行签名和提交
  const committedTxn = await aptos.signAndSubmitTransaction({
    signer: alice,
    transaction: txn,
  });
  // 等待 Aptos 验证并执行交易
  const executedTransaction = await aptos.waitForTransaction({
    transactionHash: committedTxn.hash,
  });
  console.log("交易哈希:", executedTransaction.hash);  console.log("\n=== 转账后余额 ===\n");
  const newAliceAccountBalance = await aptos.getAccountResource({
    accountAddress: alice.accountAddress,
    resourceType: COIN_STORE,
  });
  const newAliceBalance = Number(newAliceAccountBalance.coin.value);
  console.log(`Alice 的余额是: ${newAliceBalance}`);
 
  const newBobAccountBalance = await aptos.getAccountResource({
    accountAddress: bob.accountAddress,
    resourceType: COIN_STORE,
  });
  const newBobBalance = Number(newBobAccountBalance.coin.value);
  console.log(`Bob 的余额是: ${newBobBalance}`);
 
  // Bob 应该收到转账金额
  if (newBobBalance !== TRANSFER_AMOUNT + BOB_INITIAL_BALANCE)
    throw new Error("转账后 Bob 的余额不正确");
 
  // Alice 应该保留剩余金额减去 gas 费
  if (newAliceBalance >= ALICE_INITIAL_BALANCE - TRANSFER_AMOUNT)
    throw new Error("转账后 Alice 的余额不正确");
}
 
example();