Nad.fun 代币创建流程

前置条件：monad-development 技能

在继续之前，请检查是否已安装 monad-development 技能。如果未安装，请使用 ClawHub 进行安装：

bash
clawhub search monad

从搜索结果中找到并安装 monad-development 技能。该技能用于第3步和第4步中的钱包管理和链上操作。

API 基础 URL

生产环境： https://api.nadapp.net

合约地址

BondingCurveRouter = 0x6F6B8F1a20703309951a5127c45B49b1CD981A22
Lens = 0x7e78A8DE94f21804F7a17F4E8BF9EC2c872187ea

第1步：上传图片

POST /agent/token/image

• - Content-Type： image/png、image/jpeg、image/webp 或 image/svg+xml
• 请求体： 原始二进制图片数据（最大5MB）
• 返回： imageuri（CDN URL）和 isnsfw（布尔值）

js
const imageResponse = await fetch(https://api.nadapp.net/agent/token/image, {
method: POST,
headers: { Content-Type: imageFile.type },
body: imageFile,
});
const { imageuri, isnsfw } = await imageResponse.json();

错误码

状态码	描述
400	图片格式无效或缺少图片
413

图片超过5MB限制 |

第2步：上传元数据

POST /agent/token/metadata

• - Content-Type： application/json
• 需要： 第1步中的 image_uri

请求体

必填字段：

可选字段：

js
const metadataResponse = await fetch(https://api.nadapp.net/agent/token/metadata, {
method: POST,
headers: { Content-Type: application/json },
body: JSON.stringify({
image_uri,
name: My Token,
symbol: MTK,
description: An awesome token for the Nad.fun,
website: https://mytoken.com,
twitter: https://x.com/mytoken,
telegram: https://t.me/mytoken,
}),
});
const { metadata_uri } = await metadataResponse.json();

错误码

状态码	描述
400	NSFW 状态未知、数据无效或验证失败
500

上传到存储或数据库失败 |

第3步：挖掘盐值

POST /agent/salt

• - Content-Type： application/json
• 需要： 第2步中的 metadata_uri
• 生成以 7777 结尾的虚荣代币地址

请求体

js
const saltResponse = await fetch(https://api.nadapp.net/agent/salt, {
method: POST,
headers: { Content-Type: application/json },
body: JSON.stringify({
creator: walletAddress,
name: My Token,
symbol: MTK,
metadata_uri: metadataUri,
}),
});
const { salt, address } = await saltResponse.json();

• - 返回： salt（bytes32 十六进制）和 address（以 7777 结尾的代币地址）

错误码

状态码	描述
400	参数无效
408

超时 - 达到最大迭代次数 |

第4步：链上创建代币

使用前几步的数据调用 BondingCurveRouter.create()。

TokenCreationParams

solidity
struct TokenCreationParams {
string name;
string symbol;
string tokenURI; // 第2步中的 metadata_uri
uint256 amountOut; // 0 表示不进行初始购买，或使用 Lens.getInitialBuyAmountOut(amountIn)
bytes32 salt; // 第3步中的 salt
uint8 actionId; // 始终为 1（升级到 Capricorn V3）
}

solidity
function create(TokenCreationParams calldata params) external payable returns (address token, address pool);

选项 A：不进行初始购买创建

仅发送部署费用作为 msg.value。

js
const curve = new ethers.Contract(BONDINGCURVEADDRESS, BONDINGCURVEABI, signer);
const [deployFee,,] = await curve.feeConfig();

const params = {
name, symbol,
tokenURI: metadata_uri,
amountOut: 0,
salt,
actionId: 1,
};

const tx = await router.create(params, { value: deployFee });
await tx.wait();

选项 B：进行初始购买创建

发送 deployFee + amountIn 作为 msg.value。使用 Lens.getInitialBuyAmountOut(amountIn) 获取 amountOut。

js
const lens = new ethers.Contract(LENSADDRESS, LENSABI, signer);
const expectedAmountOut = await lens.getInitialBuyAmountOut(amountIn);

const [deployFee,,] = await curve.feeConfig();

const params = {
name, symbol,
tokenURI: metadata_uri,
amountOut: expectedAmountOut,
salt,
actionId: 1,
};

const tx = await router.create(params, { value: deployFee + amountIn });
await tx.wait();

链上操作的钱包

对于第3步（盐值挖掘）和第4步（链上部署），请使用 monad-development 技能中的钱包。该技能处理所有钱包配置、私钥管理和 RPC 设置。在调用盐值 API（creator 字段）和发送 BondingCurveRouter.create() 交易时，使用它提供的签名者和钱包地址。

重要规则

1. 1. 顺序流程 - 每一步都依赖于上一步的输出。
2. NSFW 验证 - 第1步中自动检查图片；该标志会传递到元数据中。
3. URL 验证 - 所有 URL 必须使用 HTTPS。Twitter 必须使用 x.com，Telegram 必须使用 t.me。
4. 图片域名限制 - 元数据中仅接受 https://storage.nadapp.net/ 的图片 URI。
5. 盐值挖掘 - 如果在迭代限制内找不到虚荣地址模式，可能会超时。
6. actionId - 始终使用 1（升级到 Capricorn V3）。

生成代码时

• - 默认使用 ethers v6 语法，除非用户另有指定。
• 在进行下一步之前，始终处理每个 API 调用的错误。
• 第4步需要第3步的 salt 和第2步的 metadata_uri。
• 对于初始购买，始终查询 Lens.getInitialBuyAmountOut() 以获取正确的 amountOut。