> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artstarex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Launchpad 申购与代币化

> ArtStar 一级市场模块介绍：从艺术品资产的首次发行到用户申购的完整流程与底层机制

## 概述

Launchpad 是 ArtStar 的一级市场模块，用于承接艺术品资产的首次发行与用户申购。用户通过稳定币支付，在满足准入条件后获得链上资产份额

代币化则是该流程的底层表达方式。它将高价值、低流动性的艺术品，转换为可计算、可追踪、可分发的链上权益单位

## 核心机制详解

<AccordionGroup>
  <Accordion title="Launchpad 的核心职责" icon="rocket">
    在 ArtStar 中，Launchpad 是平台最关键的转化入口之一，主要承担以下职责：

    * **展示信息**：展示艺术品项目详情、当前发行状态、价格和剩余额度
    * **准入判断**：判断用户是否满足申购条件
    * **交易执行**：发起稳定币授权和购买交易
    * **状态更新**：在交易完成后同步更新资产状态与用户持仓
  </Accordion>

  <Accordion title="代币化的意义" icon="coin">
    代币化不是单纯的展示包装，而是 ArtStar 产品机制的核心基础：

    * 把艺术品投资从整件持有转为份额参与
    * 为一级发行提供标准化链上表示
    * 为持仓查询和状态同步提供结构化基础
    * 为后续流动性和二级市场交易奠定前提
  </Accordion>

  <Accordion title="份额计算逻辑" icon="calculator">
    份额数量通常由支付金额和单份价格共同决定

    ```text 份额计算公式 theme={null}
    份额数量 = 支付金额 / 单份价格
    ```

    <Info>
      如果存在最小购买单位、整数份额限制或精度差异，前端展示逻辑必须与链上规则保持一致
    </Info>
  </Accordion>
</AccordionGroup>

## 申购流程指引

### 申购前置条件

用户通常需要满足以下条件，才能进入有效申购流程。任何一个不满足，都应在前端被明确拦截和提示：

<Card title="检查清单" icon="list-check">
  * 已连接钱包 \* 已完成登录或账户识别 \* 已切换到目标网络 \* 已完成 KYC \*
    满足白名单或购买资格要求 \* 钱包中持有足够稳定币 \* 稳定币授权状态满足要求
</Card>

### 两步式购买流程

<Steps>
  <Step title="第一步：Approve (授权)">
    用户先调用稳定币合约的授权方法，允许目标合约在指定额度内扣除对应资产
    <Warning>这一步的意义在于获得代币扣款权限，并不等于实际购买完成</Warning>
  </Step>

  <Step title="第二步：Mint / Purchase (申购/铸造)">
    授权成功后，用户调用目标资产合约的购买或铸造方法。合约根据支付金额、价格和规则，向用户发放对应份额。
    <Check>这个过程完成后，用户才真正完成申购并获得代币份额</Check>
  </Step>
</Steps>

## 开发与处理重点

### 前端逻辑处理

前端在申购过程中至少需要处理以下关键环节：

* **数据读取**：读取资产当前价格和剩余额度、用户稳定币余额、稳定币 allowance
* **交互控制**：根据状态控制按钮文案和可点击性，处理授权交易和购买交易的串联
* **异常处理**：捕获用户拒签、余额不足、网络错误等异常
* **状态同步**：在交易后刷新持仓与进度状态

### 常见失败原因排查

当用户在申购阶段遇到阻碍时，通常可以从以下原因中排查：

<AccordionGroup>
  <Accordion title="用户与状态类原因">
    * KYC 未通过 \* 白名单未通过 \* 项目已售罄或已结束
  </Accordion>

  <Accordion title="资产与交易类原因">
    * 稳定币余额不足 \* 授权额度不足 \* 钱包网络错误 \* 用户拒绝签名 \*
      合约执行被拒绝
  </Accordion>
</AccordionGroup>

## 避坑指南 (易错点)

<Callout type="warning" title="授权成功不代表购买成功">
  很多用户会误以为 Approve
  完成后就已经购买成功。前端需要清晰地区分“授权完成”和“申购完成”两个状态，并做好对应的引导提示
</Callout>

<Callout type="danger" title="精度处理必须统一">
  稳定币和目标资产的 `decimals`
  可能不同。展示层和合约交互层如果处理不一致，会导致 UI
  显示正常但链上实际转账金额错误
</Callout>

<Callout type="info" title="页面状态不能只依赖本地结果">
  交易发送成功后，最终状态仍依赖区块确认和后端同步。不能只根据前端本地变量判断资产已经到账，需监听链上确认或刷新接口数据
</Callout>

***

Launchpad 申购与代币化是 ArtStar 最核心的业务环节。它把用户准入、稳定币支付、链上执行和资产映射整合在一个统一流程里，是平台价值真正发生的地方