search-aptos-examples

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Search Aptos Examples Skill

搜索Aptos示例Skill

Overview

概述

This skill helps you find relevant examples in official Aptos repositories before writing new contracts. Always search examples first to follow established patterns.

Repositories:

aptos-labs/aptos-core/aptos-move/move-examples/
— 53+ official Move examples demonstrating best practices
aptos-labs/daily-move/snippets/
— 17 curated educational examples covering design patterns, Move 2 features, composable NFTs, and more

本Skill可帮助你在编写新合约前在Aptos官方仓库中查找相关示例。请务必优先搜索示例，遵循已验证的开发模式。

涉及仓库：

aptos-labs/aptos-core/aptos-move/move-examples/
— 53+个官方Move示例，展示最佳开发实践
aptos-labs/daily-move/snippets/
— 17个精选的教学示例，覆盖设计模式、Move 2特性、可组合NFT等内容

Core Workflow

核心工作流

Step 1: Identify What You're Building

步骤1：明确开发内容

Categorize your contract:

NFTs/Tokens: NFT collections, digital assets, collectibles
Fungible Assets: Coins, tokens, currencies
DeFi: DEXs, AMMs, lending, staking
Governance: DAOs, voting, proposals
Marketplace: Trading, escrow, auctions
Gaming: Items, characters, game logic
Infrastructure: Registries, configs, utilities

对你的合约进行分类：

NFTs/Tokens：NFT合集、数字资产、收藏品
Fungible Assets：代币、通证、货币
DeFi：DEX、AMM、借贷、质押
Governance：DAO、投票、提案
Marketplace：交易、托管、拍卖
Gaming：道具、角色、游戏逻辑
Infrastructure：注册表、配置、工具类

Step 2: Search Relevant Examples

步骤2：搜索相关示例

Priority Examples by Category:

按分类排序的优先级示例：

NFTs & Token Objects

NFT与Token对象

token_objects/
- Modern object-based tokens (V2 pattern)
mint_nft/
- NFT minting patterns
nft_dao/
- NFT-gated governance
collection_manager/
- Collection management
(daily-move)
composable-nfts/
- NFTs that contain other NFTs
(daily-move)
modifying-nfts/
- Mutable NFT metadata patterns
(daily-move)
parallel-nfts/
- Concurrent NFT minting
(daily-move)
liquid-nfts/
- Fractionalized/liquid NFTs

When to use: Building NFT collections, digital collectibles, tokenized assets

token_objects/
- 基于对象的现代化代币（V2模式）
mint_nft/
- NFT铸造模式
nft_dao/
- NFT门控治理
collection_manager/
- 合集管理
(daily-move)
composable-nfts/
- 可嵌套其他NFT的可组合NFT
(daily-move)
modifying-nfts/
- 可变NFT元数据模式
(daily-move)
parallel-nfts/
- 并发NFT铸造
(daily-move)
liquid-nfts/
- 碎片化/流动型NFT

适用场景： 开发NFT合集、数字收藏品、通证化资产

Fungible Assets

同质化资产

fungible_asset/
- Modern fungible token standard
coin/
- Basic coin implementation
managed_fungible_asset/
- Controlled fungible assets
(daily-move)
fa-lockup-example/
- FA lockup and escrow patterns
(daily-move)
fractional-token/
- Fractional token ownership
(daily-move)
controlled-mint/
- Controlled minting with access control

When to use: Creating tokens, currencies, reward points

fungible_asset/
- 现代化同质化代币标准
coin/
- 基础代币实现
managed_fungible_asset/
- 受管控的同质化资产
(daily-move)
fa-lockup-example/
- 同质化资产锁仓与托管模式
(daily-move)
fractional-token/
- 碎片化代币所有权
(daily-move)
controlled-mint/
- 带访问控制的受控铸造

适用场景： 创建代币、货币、奖励积分

DeFi & Trading

DeFi与交易

marketplace/
- NFT marketplace patterns
swap/
- Simple token swap
liquidity_pool/
- AMM pool implementation
staking/
- Staking mechanisms

When to use: Building DEXs, marketplaces, trading platforms

marketplace/
- NFT交易市场模式
swap/
- 简单代币兑换
liquidity_pool/
- AMM流动池实现
staking/
- 质押机制

适用场景： 开发DEX、交易市场、交易平台

Governance & DAOs

治理与DAO

dao/
- DAO governance patterns
voting/
- Voting mechanisms
multisig/
- Multi-signature accounts

When to use: Building DAOs, governance systems, voting

dao/
- DAO治理模式
voting/
- 投票机制
multisig/
- 多签账户

适用场景： 开发DAO、治理系统、投票功能

Basic Patterns

基础模式

hello_blockchain/
- Module structure basics
message_board/
- Simple state management
resource_account/
- Resource patterns (legacy - avoid for new code)
(daily-move)
error-codes/
- Error code conventions and patterns
(daily-move)
private-vs-public/
- Function visibility and access
(daily-move)
objects/
- Object model fundamentals

When to use: Learning Move basics, simple contracts

hello_blockchain/
- 模块结构基础
message_board/
- 简单状态管理
resource_account/
- 资源模式（已过时，新代码请勿使用）
(daily-move)
error-codes/
- 错误码规范与模式
(daily-move)
private-vs-public/
- 函数可见性与访问控制
(daily-move)
objects/
- 对象模型基础

适用场景： 学习Move基础、开发简单合约

Advanced Patterns

高级模式

object_playground/
- Object model exploration
capability/
- Capability-based security
upgradeable/
- Upgradeable contracts
(daily-move)
design-patterns/
- Autonomous objects and other design patterns
(daily-move)
struct-capabilities/
- Struct-based capability patterns
(daily-move)
move-2/
- Move 2 language features and idioms
(daily-move)
storage/
- Storage layout and optimization patterns
(daily-move)
data-structures/
- Heap data structure implementation

When to use: Complex architectures, security patterns

object_playground/
- 对象模型探索
capability/
- 基于能力的安全机制
upgradeable/
- 可升级合约
(daily-move)
design-patterns/
- 自治对象及其他设计模式
(daily-move)
struct-capabilities/
- 基于结构体的能力模式
(daily-move)
move-2/
- Move 2语言特性与惯用写法
(daily-move)
storage/
- 存储布局与优化模式
(daily-move)
data-structures/
- 堆数据结构实现

适用场景： 复杂架构、安全模式开发

Gaming

游戏

(daily-move)
lootbox/
- Randomized loot box mechanics

When to use: Building games, randomized rewards, loot systems

(daily-move)
lootbox/
- 随机盲盒机制

适用场景： 开发游戏、随机奖励、战利品系统

Step 3: Review Example Code

步骤3：审查示例代码

What to look for:

Module Structure:
- How are imports organized?
- What structs are defined?
- How are error codes structured?
Object Creation:
- How are objects created?
- Which refs are generated?
- How is ownership managed?
Access Control:
- How is signer authority verified?
- How is object ownership checked?
- What roles/permissions exist?
Operations:
- How are transfers handled?
- How are updates secured?
- What validations are performed?
Testing:
- What test patterns are used?
- How is coverage achieved?

重点关注内容：

模块结构：
- 导入是如何组织的？
- 定义了哪些结构体？
- 错误码是如何组织的？
对象创建：
- 对象是如何创建的？
- 生成了哪些引用？
- 所有权是如何管理的？
访问控制：
- 签名者权限是如何验证的？
- 对象所有权是如何检查的？
- 存在哪些角色/权限？
操作逻辑：
- 转账是如何处理的？
- 更新操作是如何保障安全的？
- 执行了哪些校验？
测试逻辑：
- 使用了哪些测试模式？
- 如何实现测试覆盖？

Step 4: Adapt Patterns to Your Use Case

步骤4：适配模式到你的业务场景

Don't copy blindly - adapt:

Understand the pattern: Why is it structured this way?
Identify core concepts: What security checks are critical?
Adapt to your needs: Modify for your specific requirements
Maintain security: Keep all security checks intact
Test thoroughly: Ensure 100% coverage

不要盲目复制 — 按需适配：

理解模式： 为什么要这么设计结构？
识别核心概念： 哪些安全检查是关键的？
按需适配： 根据你的具体需求进行修改
保留安全性： 完整保留所有安全检查逻辑
充分测试： 确保100%测试覆盖

Example Discovery Table

示例查找对照表

Building	Search For	Source	Key Files
NFT Collection	`token_objects` , `mint_nft`	aptos-core	`token_objects/sources/token.move`
Fungible Token	`fungible_asset`	aptos-core	`fungible_asset/sources/fungible_asset.move`
Marketplace	`marketplace`	aptos-core	`marketplace/sources/marketplace.move`
DAO	`dao` , `voting`	aptos-core	`dao/sources/dao.move`
Token Swap	`swap` , `liquidity_pool`	aptos-core	`swap/sources/swap.move`
Staking	`staking`	aptos-core	`staking/sources/staking.move`
Simple Contract	`hello_blockchain` , `message_board`	aptos-core	`hello_blockchain/sources/hello.move`
Object Patterns	`object_playground`	aptos-core	`object_playground/sources/playground.move`
Composable NFTs	`composable-nfts`	daily-move	`snippets/composable-nfts/`
FA Lockup/Escrow	`fa-lockup-example`	daily-move	`snippets/fa-lockup-example/`
Design Patterns	`design-patterns`	daily-move	`snippets/design-patterns/`
Move 2 Features	`move-2`	daily-move	`snippets/move-2/`
Data Structures	`data-structures`	daily-move	`snippets/data-structures/`
Storage Patterns	`storage`	daily-move	`snippets/storage/`
Loot Box Patterns	`lootbox`	daily-move	`snippets/lootbox/`

开发内容	搜索关键词	来源	核心文件
NFT合集	`token_objects` , `mint_nft`	aptos-core	`token_objects/sources/token.move`
同质化代币	`fungible_asset`	aptos-core	`fungible_asset/sources/fungible_asset.move`
交易市场	`marketplace`	aptos-core	`marketplace/sources/marketplace.move`
DAO	`dao` , `voting`	aptos-core	`dao/sources/dao.move`
代币兑换	`swap` , `liquidity_pool`	aptos-core	`swap/sources/swap.move`
质押	`staking`	aptos-core	`staking/sources/staking.move`
简单合约	`hello_blockchain` , `message_board`	aptos-core	`hello_blockchain/sources/hello.move`
对象模式	`object_playground`	aptos-core	`object_playground/sources/playground.move`
可组合NFT	`composable-nfts`	daily-move	`snippets/composable-nfts/`
同质化资产锁仓/托管	`fa-lockup-example`	daily-move	`snippets/fa-lockup-example/`
设计模式	`design-patterns`	daily-move	`snippets/design-patterns/`
Move 2特性	`move-2`	daily-move	`snippets/move-2/`
数据结构	`data-structures`	daily-move	`snippets/data-structures/`
存储模式	`storage`	daily-move	`snippets/storage/`
盲盒模式	`lootbox`	daily-move	`snippets/lootbox/`

How to Access Examples

如何访问示例

Option 1: GitHub Web Interface

方案1：GitHub网页界面

https://github.com/aptos-labs/aptos-core/tree/main/aptos-move/move-examples

Browse online and read source files directly.

https://github.com/aptos-labs/aptos-core/tree/main/aptos-move/move-examples

直接在线浏览阅读源代码文件。

Option 2: Clone Repository (Recommended)

方案2：克隆仓库（推荐）

bash

undefined

bash

undefined

Clone Aptos core

克隆Aptos core仓库

git clone https://github.com/aptos-labs/aptos-core.git

Navigate to examples

进入示例目录

cd aptos-core/aptos-move/move-examples

List all examples

列出所有示例

ls -la

View specific example

查看指定示例

cd token_objects cat sources/token.move

undefined

cd token_objects cat sources/token.move

undefined

Option 3: daily-move Repository

方案3：daily-move仓库

Browse online:

https://github.com/aptos-labs/daily-move/tree/main/snippets

Clone locally:

bash

git clone https://github.com/aptos-labs/daily-move.git
cd daily-move/snippets
ls -la

在线浏览：

https://github.com/aptos-labs/daily-move/tree/main/snippets

克隆到本地：

bash

git clone https://github.com/aptos-labs/daily-move.git
cd daily-move/snippets
ls -la

Option 4: Search Aptos Documentation

方案4：搜索Aptos文档

https://aptos.dev/build/smart-contracts

Many examples are documented with explanations.

https://aptos.dev/build/smart-contracts

很多示例都附带文档说明。

Common Patterns from Examples

示例中的通用模式

Pattern 1: Object Creation (from token_objects)

模式1：对象创建（来自token_objects）

move

// From: token_objects/sources/token.move
public entry fun create_token(
    creator: &signer,
    collection_name: String,
    description: String,
    name: String,
    uri: String,
) {
    let constructor_ref = token::create_named_token(
        creator,
        collection_name,
        description,
        name,
        option::none(),
        uri,
    );
    // ... additional setup
}

Takeaway: Use named tokens for collections, create_object for unique items.

move

// 来源: token_objects/sources/token.move
public entry fun create_token(
    creator: &signer,
    collection_name: String,
    description: String,
    name: String,
    uri: String,
) {
    let constructor_ref = token::create_named_token(
        creator,
        collection_name,
        description,
        name,
        option::none(),
        uri,
    );
    // ... 额外设置逻辑
}

要点： 合集使用命名代币，独立道具使用create_object创建。

Pattern 2: Access Control (from dao)

模式2：访问控制（来自dao）

move

// From: dao/sources/dao.move
public entry fun execute_proposal(
    proposer: &signer,
    proposal_id: u64
) acquires DAO, Proposal {
    let dao = borrow_global_mut<DAO>(@dao_addr);
    let proposal = vector::borrow_mut(&mut dao.proposals, proposal_id);

    // Verify proposal passed
    assert!(proposal.votes_for > proposal.votes_against, E_PROPOSAL_NOT_PASSED);

    // Execute actions
    // ...
}

Takeaway: Verify state conditions before executing critical operations.

move

// 来源: dao/sources/dao.move
public entry fun execute_proposal(
    proposer: &signer,
    proposal_id: u64
) acquires DAO, Proposal {
    let dao = borrow_global_mut<DAO>(@dao_addr);
    let proposal = vector::borrow_mut(&mut dao.proposals, proposal_id);

    // 验证提案已通过
    assert!(proposal.votes_for > proposal.votes_against, E_PROPOSAL_NOT_PASSED);

    // 执行操作
    // ...
}

要点： 执行关键操作前先验证状态条件。

Pattern 3: Transfer Control (from fungible_asset)

模式3：转账控制（来自fungible_asset）

move

// From: fungible_asset/sources/fungible_asset.move
public fun transfer<T: key>(
    from: &signer,
    to: address,
    amount: u64
) acquires FungibleStore {
    // Verify sender has sufficient balance
    let from_store = borrow_global_mut<FungibleStore<T>>(signer::address_of(from));
    assert!(from_store.balance >= amount, E_INSUFFICIENT_BALANCE);

    // Deduct from sender
    from_store.balance = from_store.balance - amount;

    // Add to recipient
    let to_store = borrow_global_mut<FungibleStore<T>>(to);
    to_store.balance = to_store.balance + amount;
}

Takeaway: Check-effects-interactions pattern (verify, deduct, add).

move

// 来源: fungible_asset/sources/fungible_asset.move
public fun transfer<T: key>(
    from: &signer,
    to: address,
    amount: u64
) acquires FungibleStore {
    // 验证发送方余额充足
    let from_store = borrow_global_mut<FungibleStore<T>>(signer::address_of(from));
    assert!(from_store.balance >= amount, E_INSUFFICIENT_BALANCE);

    // 扣除发送方余额
    from_store.balance = from_store.balance - amount;

    // 增加接收方余额
    let to_store = borrow_global_mut<FungibleStore<T>>(to);
    to_store.balance = to_store.balance + amount;
}

要点： 遵循检查-效应-交互模式（先校验，再修改状态，最后执行交互）。

ALWAYS Rules

必须遵守的规则

✅ ALWAYS search examples before writing new contracts
✅ ALWAYS check both aptos-core (canonical) and daily-move (educational) repositories
✅ ALWAYS understand patterns before copying
✅ ALWAYS adapt patterns to your use case
✅ ALWAYS maintain security checks from examples
✅ ALWAYS reference which example you adapted from
✅ ALWAYS test adapted code thoroughly

✅ 编写新合约前务必先搜索示例
✅ 务必同时检查aptos-core（官方标准）和daily-move（教学内容）两个仓库
✅ 复制代码前务必先理解模式逻辑
✅ 务必根据你的业务场景适配模式
✅ 务必保留示例中的所有安全检查逻辑
✅ 务必在代码中注明你适配的来源示例
✅ 适配后的代码务必进行充分测试

NEVER Rules

禁止行为

❌ NEVER copy code without understanding it
❌ NEVER skip security checks from examples
❌ NEVER use deprecated patterns (resource accounts, address-based)
❌ NEVER assume examples are always up-to-date (verify against docs)
❌ NEVER mix V1 and V2 patterns
❌ NEVER include real private keys or credentials when adapting examples — use
```
"0x..."
```
placeholders

❌ 不要不理解代码逻辑就直接复制
❌ 不要省略示例中的安全检查逻辑
❌ 不要使用已过时的模式（资源账户、基于地址的模式）
❌ 不要假设示例永远是最新的（请对照文档验证）
❌ 不要混用V1和V2模式
❌ 适配示例时不要包含真实私钥或凭证 — 使用
```
"0x..."
```
占位符

Search Checklist

搜索检查清单

Example Adaptation Workflow

示例适配工作流

Step-by-Step: Building NFT Collection

分步指南：开发NFT合集

Search: Find
```
token_objects
```
example

Review Structure:

token_objects/
├── sources/
│   ├── collection.move  # Collection management
│   ├── token.move       # Token operations
│   └── property_map.move # Metadata handling
└── tests/
    └── token_tests.move

Identify Key Patterns:
- Collection creation with
```
create_collection
```
- Token minting with
```
create_named_token
```
- Metadata storage using
```
PropertyMap
```
- Transfer control with
```
TransferRef
```
Adapt to Your Needs:
- Keep object creation pattern
- Keep security checks
- Add your custom fields
- Add your business logic
- Write comprehensive tests

Reference in Code:

move

// Adapted from: aptos-core/move-examples/token_objects
module my_addr::custom_nft {
    // ... your implementation
}

搜索： 找到
```
token_objects
```
示例

审查结构：

token_objects/
├── sources/
│   ├── collection.move  # 合集管理
│   ├── token.move       # 代币操作
│   └── property_map.move # 元数据处理
└── tests/
    └── token_tests.move

识别核心模式：
- 使用
```
create_collection
```
  创建合集
- 使用
```
create_named_token
```
  铸造NFT
- 使用
```
PropertyMap
```
  存储元数据
- 使用
```
TransferRef
```
  控制转账
按需适配：
- 保留对象创建模式
- 保留安全检查逻辑
- 添加自定义字段
- 添加业务逻辑
- 编写完善的测试用例

代码中注明来源：

move

// 适配自: aptos-core/move-examples/token_objects
module my_addr::custom_nft {
    // ... 你的实现代码
}

References

参考资料

Official Examples:

aptos-core: https://github.com/aptos-labs/aptos-core/tree/main/aptos-move/move-examples
daily-move: https://github.com/aptos-labs/daily-move/tree/main/snippets
Documentation: https://aptos.dev/build/smart-contracts

Related Skills:

```
write-contracts
```
- Apply patterns after searching
```
security-audit
```
- Verify security of adapted code
```
generate-tests
```
- Test adapted patterns

Remember: Search examples first. Understand patterns. Adapt securely. Test thoroughly.

官方示例：

aptos-core: https://github.com/aptos-labs/aptos-core/tree/main/aptos-move/move-examples
daily-move: https://github.com/aptos-labs/daily-move/tree/main/snippets
文档: https://aptos.dev/build/smart-contracts

相关Skill：

```
write-contracts
```
- 搜索示例后应用模式编写合约
```
security-audit
```
- 验证适配后代码的安全性
```
generate-tests
```
- 为适配后的模式编写测试

谨记： 先搜索示例，理解模式，安全适配，充分测试。