跳到主要内容

Aptos 开发文档

欢迎来到Aptos开发文档！这里包含了完整的Aptos区块链开发指南，从基础概念到高级应用。

📚 文档结构​

1. 账户管理​

2. 代币操作​

3. NFT功能​

4. 多重签名​

5. 交易处理​

🚀 快速开始​

环境准备​

# 安装依赖
npm install aptos

# 或者使用yarn
yarn add aptos

创建账户​

import { AptosAccount } from "aptos";

// 创建新账户
const account = new AptosAccount();
console.log('Address:', account.address().hex());
console.log('Private Key:', account.toPrivateKeyObject());

连接网络​

import { AptosClient } from "aptos";

const NODE_URL = "https://fullnode.devnet.aptoslabs.com";
const client = new AptosClient(NODE_URL);

// 获取链信息
const chainId = await client.getChainId();
console.log('Chain ID:', chainId);

查询余额​

import { CoinClient } from "aptos";

const coinClient = new CoinClient(client);
const balance = await coinClient.checkBalance(account);
console.log('Balance:', balance);

发送交易​

import { FaucetClient } from "aptos";

const FAUCET_URL = "https://faucet.devnet.aptoslabs.com";
const faucetClient = new FaucetClient(NODE_URL, FAUCET_URL);

// 资助账户
await faucetClient.fundAccount(account.address(), 100_000_000);

// 转账
const txnHash = await coinClient.transfer(
  account, 
  receiverAccount, 
  1000, 
  { gasUnitPrice: BigInt(100) }
);

// 等待交易确认
await client.waitForTransaction(txnHash);

🔧 开发工具​

  • Aptos SDK - 官方TypeScript/JavaScript SDK
  • Move - 智能合约开发语言
  • Aptos CLI - 命令行工具
  • Aptos Explorer - 区块链浏览器
  • Aptos Faucet - 测试网代币获取

🌐 网络环境​

网络RPC URLFaucet URL状态
主网https://fullnode.mainnet.aptoslabs.com-✅ 活跃
测试网https://fullnode.testnet.aptoslabs.comhttps://faucet.testnet.aptoslabs.com✅ 活跃
开发网https://fullnode.devnet.aptoslabs.comhttps://faucet.devnet.aptoslabs.com🔧 可配置

📖 核心概念​

账户模型​

Aptos使用基于资源的账户模型，每个账户都有：

  • 唯一的地址
  • 认证密钥
  • 资源存储
  • 模块代码

资源系统​

Move语言中的资源是：

  • 不可分割的数据单元
  • 具有类型安全
  • 支持所有权转移
  • 防止资源丢失

交易结构​

每个Aptos交易包含：

  • 发送者地址
  • 序列号
  • 有效载荷
  • 最大gas费用
  • gas单价
  • 过期时间
  • 链ID

多重签名​

支持多种签名方案：

  • Ed25519单签
  • MultiEd25519多签
  • 可配置阈值
  • 位图签名验证

🎯 最佳实践​

  1. 错误处理: 始终检查交易状态和错误
  2. Gas估算: 合理设置gas限制和价格
  3. 资源管理: 正确管理Move资源生命周期
  4. 安全考虑: 使用安全的密钥管理方案
  5. 测试: 在开发网充分测试后再部署主网

📚 学习资源​

开始构建你的Aptos应用吧！