avalanche

AvaKit 🔺

面向 Avalanche 的开源、AI 原生开发者工具包。

快速搭建可部署的社交登录 dapp，并内置 Agent 上下文。一个核心，四种界面。无需助记词，无需样板代码。

avakit.dev · 文档 · 模板

▶ 观看 90 秒演示 — 只需一条命令，即可构建可运行的 Avalanche 社交登录 dapp：使用 Google 登录、在浏览器中部署 NFT，并在 Fuji 上铸造。

npm create avalanche-app@latest

就是这么简单。使用社交登录连接、读取余额，并在几分钟内于 Avalanche 上发送你的第一笔交易。

接下来，在浏览器中直接部署 NFT 合约并在 Fuji 上铸造：

已在 Fuji 上验证运行。 片段中的铸造是真实的链上交易；在 Snowtrace 上查看（合约 0x7612…7786）。无需 Foundry，也无需后端：字节码已打包，并从用户的钱包部署。

---

为什么选择 AvaKit

Avalanche 的 C-Chain 兼容 EVM，终端用户引导也已有成熟方案（Core 钱包的无助记词社交登录）。剩下的阻碍在于开发者一侧：搭建一个集成了用户引导的现代 dapp 仍需数小时。AvaKit 消除了这一阻碍。

• 零配置引导：浏览器中会出现一个临时钱包，新用户无需安装任何东西即可尝试真实的 Fuji 交易；社交登录（Google，无需助记词）或 Core/MetaMask 则是升级选项——使用这些方式时，密钥会保存在服务提供商的 HSM 中，AvaKit 不会接触密钥。（临时钱包例外：它会将密钥保存在 localStorage 中，详见 SECURITY.md。）
• 默认采用 AI 原生设计：每个生成的应用都附带 CLAUDE.md、llms.txt 和 .cursor/rules，而 @avakit/mcp 可让 Claude Code / Cursor 为你搭建、部署应用并读取链上状态。
• 主题化 shadcn/ui：从第一天起就配备简洁的设计系统，支持深色和浅色模式。组件可直接复制，无厂商锁定。
• 可直接部署：合约会编译为打包的字节码，因此你可以直接从浏览器部署。默认使用 Fuji 测试网。
• 安全默认设置：优先使用测试网，主网需明确选择启用，密钥保存在环境变量中。
• 封装，而非重写：基于 viem、Web3Auth 和 Foundry 构建，并经过打包，提供出色的开发者体验。

Packages

Package	说明
@avakit/core	与框架无关的内核：viem 客户端、钱包适配器、部署辅助工具、链数据
@avakit/react	基于 shadcn/ui 构建的 <ConnectAvalanche> 社交登录组件、<TransactionButton> 和钩子
create-avalanche-app	开箱即用的脚手架工具（8 个模板）
@avakit/mcp	MCP 服务：通过 Claude Code / Cursor 搭建脚手架、部署和读取 Avalanche
@avakit/studio	本地开发仪表板：启动开发网、发送 Interchain 消息、检查数据（npx @avakit/studio）；也是一个 MCP 服务

Templates

npm create avalanche-app@latest my-app -- --template nft-mint

Template	可获得的内容
minimal	社交登录钱包、余额和首笔交易
nft-mint	在浏览器中部署 ERC-721，然后铸造 NFT
token-gated-app	为访问通行证 NFT 持有者解锁内容
erc20-token	部署 ERC-20、铸造代币并转账
icm-messenger	在单命令启动的本地开发网上，通过 Interchain Messaging 在两个 Avalanche L1 之间发送消息
eerc-token	注册、铸造并私密转账代币，余额不可见（Encrypted ERC）
l1-launch	通过一条命令启动自己的 Avalanche L1，然后在内置仪表板中探索
token-bridge	使用 Interchain Token Transfer（ICTT）在两个 Avalanche L1 之间跨链转移 ERC-20

每个模板都附带社交登录钱包、shadcn/ui（黑白配色，支持深色/浅色模式）和 AI 上下文文件。

在现有应用中使用

npm install @avakit/react @avakit/core viem

"use client";
import { injectedAdapter } from "@avakit/core";
import { fuji } from "@avakit/core/chains";
import { AvaKitProvider, ConnectAvalanche } from "@avakit/react";

export function App() {
  return (
    <AvaKitProvider chains={[fuji]} adapters={[injectedAdapter()]}>
      <ConnectAvalanche />
    </AvaKitProvider>
  );
}

安装 @web3auth/modal 并传入 web3authAdapter({ clientId })（来自 @avakit/core/web3auth），即可添加社交登录。

@avakit/core 和 @avakit/react 仅支持 ESM（使用 import，而非 require；Node ≥ 20.11）。

使用 AI Agent 构建

将 MCP 服务添加到 Claude Code、Cursor 或 Claude Desktop：

{
  "mcpServers": {
    "avakit": { "command": "npx", "args": ["-y", "@avakit/mcp"] }
  }
}

然后只需提出请求："搭建一个 nft-mint dapp，并将其部署到 Fuji。 "

仓库结构

packages/
  core/                 @avakit/core
  react/                @avakit/react
  mcp/                  @avakit/mcp
  studio/               @avakit/studio (local dashboard + MCP)
  create-avalanche-app/ scaffolder + 8 templates
apps/web/               the avakit.dev site (EN + TR)
examples/               live demo dapps (hello-avax, web3auth-demo)
docs/                   planning, PRD, architecture, ADRs, specs, security review

贡献

pnpm install
pnpm build       # all packages (Turborepo)
pnpm test        # Vitest
pnpm lint        # Biome
pnpm typecheck   # TypeScript

要求：Node ≥ 20.11、pnpm ≥ 10。请参阅 CONTRIBUTING.md 和 docs/ 中的设计文档。规范：全程使用英语，仅使用 shadcn/ui，使用 Framer Motion / GSAP 制作动画，并采用最新稳定版本。

许可证

MIT © AvaKit 贡献者

---

_{基于 viem、Web3Auth、Foundry 和 shadcn/ui 构建。优先使用测试网（Fuji）；主网需选择启用。}