# Solana × AI 开发速查表


## 先分清这些对象

| 术语 | 在应用里负责什么 |
|---|---|
| Wallet 钱包 | 管理密钥、展示资产并签名；连接钱包不等于后端已验证登录 |
| Address 地址 | 定位链上账户；通常显示为一串 Base58 字符 |
| Account 账户 | 保存 SOL 余额、数据、所属程序等链上状态，不是网站用户名 |
| Program 程序 | 执行链上规则；业务数据放在相关数据账户里 |
| Owner / Authority | 账户的 owner program 与用户的操作权限不同；代币账户中还存有持有人/权限字段 |
| Instruction / Transaction | 一次程序调用 / 把一个或多个调用及签名等打包发送的交易 |
| RPC | 查询账户、提交交易和获取状态的接口 |
| SOL / lamport | Solana 原生资产及其最小计量单位；本次只用 Devnet 测试资产 |
| Mint / Token Account / ATA | 一种代币的定义 / 某持有人对这种代币的余额记录 / 标准派生地址上的代币账户 |
| PDA | 由程序 ID 与 seeds 派生、没有私钥的地址；派生地址不等于创建账户 |
| Devnet / Mainnet | 开发测试网络 / 真实资产网络；钱包、RPC 和浏览器查询须保持一致 |
| confirmed / finalized | 不同确认承诺级别；finalized 的最终性承诺更强，展示结果时说明使用哪一级 |

基本过程：网页组装操作 → 钱包持有人核对并签名 → RPC 提交 → 程序执行并更新账户 → 查询交易 → 显示业务结果。

同一交易中的业务指令一起成功或一起回滚；执行失败仍可能扣手续费。创建账户需要的最低 SOL 余额与每次交易手续费分开理解。

概念来源：[账户](https://solana.com/zh/docs/core/accounts)、[交易](https://solana.com/zh/docs/core/transactions)、[代币账户](https://solana.com/zh/docs/tokens)、[PDA](https://solana.com/zh/docs/core/pda)、[确认级别](https://solana.com/docs/rpc)。

## 开发顺序

1. 写清一个用户、一个需求、一条操作路径。
2. 让 AI 读取正确来源的 Skill、模板说明和项目依赖版本。
3. 先运行模板，再增加一个功能；优先复用已有程序与代码。
4. 在 Devnet 验证真实操作，核对交易记录与业务条件。
5. 读取 Cloudflare Skill，按项目选发布方式，完成登录和授权。
6. 打开实际公网网址，在另一台设备复测；保留交易链接和错误信息。

给 AI 的需求应包含：用户、操作、网络、现有项目、范围、成功条件、失败时应显示什么。Skill 提供开发参考；CLI 或 MCP 执行操作；账号仍需登录授权。

## 开始开发和发布

| 资料 | 入口 |
|---|---|
| Solana 中文快速开始 | [中文入门](https://solana.com/zh/docs/intro/quick-start) |
| Solana 官方 Skill | [中文入口与安装指引](https://solana.com/zh/skills) · [官方仓库](https://github.com/solana-foundation/solana-dev-skill) |
| Starter templates | [官方模板目录](https://solana.com/developers/templates) · [Next.js Kit 模板](https://solana.com/developers/templates/nextjs) |
| 本课开发参考 | [前端与钱包](https://github.com/solana-foundation/solana-dev-skill/blob/main/skills/solana-dev/references/frontend.md) · [支付与订单](https://github.com/solana-foundation/solana-dev-skill/blob/main/skills/solana-dev/references/payments.md) |
| Phantom | [官方下载](https://phantom.com/download) |
| Devnet 测试币 | [Solana Faucet](https://faucet.solana.com/) |
| 交易与账户查询 | [Solana Explorer：Devnet](https://explorer.solana.com/?cluster=devnet) |
| Cloudflare 的 AI 开发配置 | [按工具配置 Skill / MCP](https://developers.cloudflare.com/agent-setup/) · [官方 Skills](https://github.com/cloudflare/skills) |
| Cloudflare Next.js 发布 | [按当前项目检查兼容性和部署路径](https://developers.cloudflare.com/workers/framework-guides/web-apps/nextjs/) |

Cloudflare 托管网页和链下服务；链上程序运行在 Solana。安装 Skill、构建通过或部署命令成功，都不能单独证明线上应用可用。

## 从 Solana 的能力，找到产品方向

先看一项能力怎样被已有产品使用，再挑一个小需求。下面既有已使用多年的能力，也有新的接入方式；它们不全是 Solana 原生功能或独占功能。

| 能力 → 方向 | 已有案例做了什么 | 可以尝试什么 |
|---|---|---|
| 稳定币 + HTTP 付费 → 支付、AI 服务 | [PayAI / Corbits](https://solana.com/x402)：处理 Solana x402 付款，或把 API / 数据端点接成按使用付费 | 付费 AI 报告、按次付费的数据接口；付款核验后交付内容 |
| Token Extensions + 协议组合 → RWA、金融应用 | [xStocks](https://solana.com/news/case-study-xstocks)：用代币扩展表达资产规则，并接入 Jupiter、Kamino 等应用 | 资产条款与权限查询、持仓风险提醒；保留数据来源和更新时间 |
| 压缩 NFT → 设备与大量资产记录 | [Helium](https://docs.helium.com/network-data/solana/compression-nfts/)：用压缩 NFT 表示热点设备；无线服务在现实中运行 | 设备所有权与状态看板、贡献结算记录；区分真实设备数据和模拟数据 |
| 手机钱包与应用分发 → 移动消费 | [Seeker 的 Seed Vault Wallet](https://solanamobile.com/blog/introducing-the-usdc-earn-vault-in-seed-vault-wallet)：接入 Kamino 的 USDC 借贷产品 | 手机分账、活动票券；在真手机走通付款或一次性核销 |
| ER / Private ER / VRF → 实时和隐藏信息的交互 | [Mempire](https://mempire.fun/docs/magicblock)：使用 MagicBlock ER 处理对局日志；目前是 Devnet 案例 | 双人对战、隐藏出招；核对双方状态、数据访问和揭晓规则 |

进一步了解新的支持：[Payment Channels](https://solana.com/payment-channels)展示“先授权预算、按使用计量、再统一结算”；[Solana Mobile Stack](https://solanamobile.com/blog/sms-goes-global-and-season-2-wrapup)向 Android 手机厂商提供钱包与应用分发技术栈。前者不等于每次调用都上链，后者不等于所有 Android 手机已经集成。

案例依据是项目/官方资料，未在本课逐一实测，也不构成用户量或市场份额排名。x402 不是 Solana 独有；MagicBlock 是生态扩展；链上设备凭证不能单独证明现实数据真实。代币的具体权益、权限和使用地区仍需读发行资料。

## 再找支撑应用的基础设施

| 需求 | 资料 |
|---|---|
| RPC、账户查询、交易与数据接口 | [Helius](https://www.helius.dev/docs) · [QuickNode（多链服务商）](https://www.quicknode.com/docs/solana) |
| 付款请求与扫码收款 | [Solana Pay](https://solana.com/docs/tools/solana-pay) |
| 数字凭证 / NFT | [Metaplex Core](https://www.metaplex.com/docs/smart-contracts/core) |
| 代币报价与兑换 | [Jupiter](https://developers.jup.ag/docs/get-started) |
| 外部市场价格 | [Pyth](https://docs.pyth.network/) |
| 实时应用、隐私扩展、VRF | [MagicBlock 文档](https://docs.magicblock.gg/) · [AI Dev Skill 指引](https://docs.magicblock.gg/pages/overview/additional-information/ai-dev-skill)；按应用需要选用 |

选工具前确认目标网络、API Key、额度及当前接口。不要假定所有生态服务都有 Devnet；只读主网数据、模拟数据和真实交易要分别标明。

## 需要具体开发需求时，再查项目卡

[可选选题库与 AI 起始需求](ideas.md)保留 32 个项目起点，每题说明第一版范围、接入方式、成功条件和失败条件。先沿上面的能力与案例选择方向，再用项目卡缩小范围；目录分类不等于官方奖项赛道。

先检查必要数据、测试环境和示例代码能否取得。合约、托管或专项集成项目先跑通最小示例；接口缺失就缩小为明确标注的只读/模拟版本，或更换题目。完整应用、手机网页与应用商店上架是不同交付范围。

## 出错先看哪里

| 现象 | 先检查 |
|---|---|
| 钱包有钱，应用却显示余额为零 | 钱包、RPC、Explorer 的网络和查询地址是否一致 |
| 已有交易签名，页面却未到账 | 查询执行结果，再核对地址、金额与订单关联；提交不等于成功 |
| RPC 超时或限流 | 保留待核验状态，检查接口再重试查询；先查旧交易，避免重复付款 |
| 本地正常，公网不工作 | 线上控制台、环境变量、域名/RPC 限制和实际部署运行时 |

不购买 SOL 也可做本次 Devnet 演示。助记词和私钥不要交给 AI、发群或提交 GitHub；服务密钥不要放入前端公开代码。

## 找队友与继续参赛

- [MagicBlock Builder Directory](https://build.magicblock.app/builders)：填写角色和作品，寻找队友。
- [Solana Blitz v9 报名与说明](https://luma.com/832wilvl)：奖金条目合计 1,000 USDC。当前报名页明确奖金面向使用 Ephemeral Rollups 或 Private ERs 的项目；仅使用 VRF 的奖金资格需向主办方确认。
- [MagicBlock Build / Blitz 提交](https://build.magicblock.app/?stage=blitz#submit)：查看当期截止时间和提交要求；不要套用另一赛事的截止时间。
- [Crypto World's Fair](https://colosseum.com/worldsfair)：官方规则中的截止为 2026-10-12 23:59 PT，即北京时间 2026-10-13 14:59。成员注册与团队提交要求见[官方规则](https://colosseum.com/legal/Crypto%20World%27s%20Fair%20Hackathon%20Rules.pdf)。

同一项目参加两个活动时，分别检查资格、注册和提交；一次提交不会自动完成另一活动的报名。