Agent ID 门控内盘 — Terminal 集成指南

本文介绍 Agent ID 门控的 bonding-curve 内盘。Agent ID 是一个 ERC-721 合集，作为 agent 的链上身份凭证：持有该合集中任意 NFT 的钱包，可以在内盘交易对应 agent 的代币。门控发射还会带上按 tx.origin 计算的 2% 买入上限。适用 Portal v5.27.2，入口为 swapExactInput 使用的 Portal 代理合约。

目录

• 什么是 Agent ID
• 概览
• 1. 规则
  • 1.1 生效范围
  • 1.2 Agent ID 校验
  • 1.3 Agent ID 买入上限（仅门控发射）
  • 1.4 Agent ID 白名单
• 2. 读取接口（Portal）
• 3. 事件
• 4. 集成示例（ethers v6）
  • 4.1 检测 Agent ID 门控与用户资格
  • 4.2 报价（必须传 from）
  • 4.3 交易
  • 4.4 触顶退款
• 5. 错误
• 6. 发射编码（面向发射工具）
  • 6.1 数组形式（推荐，可与 signed-price 共存）
  • 6.2 旧版单 extension 形式
• 7. 限制与边界条件
• 8. 示例
• 链上案例（BNB Chain）
• 9. ABI 片段
  • 9.1 Human-readable
  • 9.2 JSON ABI（仅新增接口）
• 10. 集成清单
• 11. 合约地址

什么是 Agent ID

Agent ID 是一个 ERC-721 合集，用来表示 agent 的链上身份。NFT 是技术载体，agent 本身不是这个 NFT。持有该合集中至少一个 NFT，就拥有在内盘交易该 agent 代币的凭证。

• 门控是 collection-wide 的：持有该合集任意一个 NFT 即可，不校验具体 tokenId。
• 任何 ERC-721 合集都可以作为 Agent ID；Flap 只会在白名单内开启发射。ABI 继续使用 nftGate / nftWhitelisted / NFT_WHITELIST_ROLE 这些旧名字。
• 门控只作用于内盘曲线；毕业后 DEX 对所有人开放。

概览

• 发射方可为代币启用 Agent ID 门控。代币在曲线上期间，每笔买入和卖出都要求 tx.origin 持有指定 Agent ID 合集中至少 1 个 NFT。
• Agent ID 门控代币在创建时会带上 按 tx.origin 计算的 maxSupply 2% 买入上限（1B 供应量对应 20,000,000 代币）。启用门控即把初始上限设为 200 bps，不是两个独立开关。
• 额度使用 held = max(netBought, balanceOf(tx.origin))：卖出会减少计数（最低到 0），转出 不会减少 netBought，转入会通过余额占用接收方的额度。
• 卖出不受限制：卖出超过 netBought 的代币（例如别人转给你的币）是允许的，计数最低只会到 0。
• 用 nftGate(token) 检测：返回 Agent ID 合集地址；普通代币返回 address(0)。
• Agent ID 门控仅作用于曲线阶段。毕业后（status == 4）Portal 交易路径返回 TokenNotTradable， DEX 交易对所有人开放。
• quoteExactInput 会检查买入上限，但不检查 Agent ID。启用买卖按钮前请自行校验 nft.balanceOf(user)。
• 校验基于 tx.origin。EOA 直接发交易可以通过；中继器、meta-transaction 和 ERC-4337 UserOp 通常会失败，因为它们的 tx.origin 是中继器或 bundler。

1. 规则

1.1 生效范围

Agent ID 门控只作用于内盘曲线的买入和卖出，不影响 ERC-20 转账和 DEX 交易。

1.2 Agent ID 校验

Agent ID 门控代币的每笔曲线交易都要求：

nft.balanceOf(tx.origin) >= 1

• 校验对象是 tx.origin，不是 msg.sender。
• balanceOf 通过 STATICCALL 调用，gas 上限 100,000，最多读取 32 字节，避免恶意合集用超大返回值 消耗调用方 gas。
• Fail-open 边界情况： 如果 balanceOf revert、gas 不足、返回不足 32 字节，或合约自毁 / 升级后无法读取，校验会被跳过，交易继续执行。这样坏掉的 NFT 不会对曲线造成 DoS，但也意味着合集不可读时 门控不生效。
• Agent ID 合集地址在发射时校验。零地址或无代码地址返回 InvalidNFTGate()（发射侧错误）。

1.3 Agent ID 买入上限（仅门控发射）

Agent ID 门控发射会写入按 tx.origin 计算的买入上限：200 bps = maxSupply 的 2%（1B 供应量对应 20,000,000 代币）。

非门控的可设上限代币使用纯持仓上限：

held      = token.balanceOf(tx.origin)
remaining = max(0, cap - held)

Agent ID 门控代币使用混合公式：

held      = max(netBought[token][tx.origin], token.balanceOf(tx.origin))
remaining = max(0, cap - held)           // 从 buyQuotaOf(token, origin) 读取

• netBought 在每笔曲线买入时记到 tx.origin，无论代币最后发给谁；每笔曲线卖出会减少它，最低到 0。
• 卖出不受 netBought 限制。 卖出超过 netBought 的代币（例如别人转给你的币）是允许的，计数最低只会到 0。
• 转出不会减少 netBought；它最多降低余额部分到 netBought 的底，不会恢复计数。
• 转入会增加 balanceOf(origin)，因此会占用接收方的额度（接收方在卖出或转走之前可能无法买入）。 这和非门控代币的持仓上限行为一致。
• 买入始终记在 tx.origin 名下，与代币最终到达哪个地址无关。把买入路由到另一个钱包或经辅助合约 买入，仍会消耗 origin 的 2% 额度。
• Terminal 简便算法： 如果钱包只在曲线上自行买卖（从未转出该代币、从未通过转账收到、也从未把 买入路由到其他地址），netBought 就等于其代币余额，可以放心使用 remaining = cap - balanceOf(wallet)。否则请读取 buyQuotaOf。
• remaining == 0 的 origin 再买入，返回 BuyCapExceeded(origin, held, cap)。
• remaining > 0 的 origin 买入会成交到上限为止，多余输入按原币种退回（原生币或 quote ERC-20）。
• 边界情况：remaining 只剩几 wei 代币时，买入可能不 revert 而是返回 outputAmount == 0 并全额退款。请把输出为 0 也视为"已达上限"。
• 创建者的 quoteAmt 首发买入按普通曲线买入处理：同样需要 NFT，同样受上限约束。
• 非门控代币没有自动上限，但管理员可手动设置。请始终读取 maxBuyPerOrigin，不要硬编码 2%。非门控代币的上限是基于实时余额的持仓上限（转账会影响 额度），不是净买入量。
• 如果 admin 移除了代币的 Agent ID 门控（removeTokenNFTGate），曲线对所有人开放，2% 上限改按上述基于 余额的持仓上限执行。门控只能移除，发射后不能新增或替换。请监听 FlapNFTGateUpdated。
• v5.27.2 之前发射的 legacy 代币 netBought = 0，现有余额通过 balanceOf 计入。若整个老 bag 被转出，该 origin 可以再买一次满额，之后 netBought 封顶。
• FlapBuyQuotaUpdated 只在有 cap 的买入时 emit。Agent ID 门控代币的 bought 是 mint 后的 max(netBought, balanceOf(origin))。卖出和转账会改变额度但不发这个事件；请用 TokenBought/TokenSold/Transfer 或 buyQuotaOf 重建。

1.4 Agent ID 白名单

新的 Agent ID 门控发射只接受 Portal 白名单中的合集；否则发射会返回 NFTNotWhitelisted(nft)。 发射工具可以在提交前调用 nftWhitelisted(nft) 检查。

只有经 Flap 批准的合集才能作为 Agent ID，避免发射时指向恶意的 NFT 合约。

2. 读取接口（Portal）

// address(0) = 未门控
function nftGate(address token) external view returns (address nft);

// 代币级上限；bps == 0（且 maxBuyAmount == 0）表示无上限
function maxBuyPerOrigin(address token) external view returns (uint16 bps, uint256 maxBuyAmount);

// origin 级实时额度；无上限时 remaining == type(uint256).max
function buyQuotaOf(address token, address origin)
    external view returns (uint256 bought, uint256 remaining);

// status：1 = Tradable（曲线），4 = DEX（已毕业）；其余字段不变
function getTokenV8Safe(address token) external view returns (TokenStateV8Safe memory);

// 发射白名单：true = 该合集可用于新的门控发射
function nftWhitelisted(address nft) external view returns (bool allowed);

说明：

• Agent ID 门控代币上，buyQuotaOf.bought 是 max(netBought, balanceOf(origin))。netBought 在买入和 卖出时变化（最低到 0）；余额部分会随转账变化。转入会占用额度；转出不会减少 netBought（最多 降低余额部分）。对只在曲线上自行买卖的钱包，它等于 balanceOf(wallet)；否则请读取 buyQuotaOf。
• 非门控的有上限代币上，buyQuotaOf.bought 就是 balanceOf(origin)。
• buyQuotaOf.remaining == type(uint256).max 表示未配置上限。
• 示例 Agent ID 合集：Binance Agent ID（0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F）。
• v5.27.0 之前的实现没有 nftGate 这个 selector，调用会 revert。请做特性探测：

async function readNftGate(portal: Contract, token: string): Promise<string | null> {
  try {
    return await portal.nftGate(token);
  } catch {
    return null; // 当前 Portal 实现不支持该接口
  }
}

3. 事件

• FlapNFTGated：发射时配置门控则触发一次。没有 indexed 字段，从 data 中解码 (token, nft)。
• FlapTokenMaxBuyPerOriginSet：发射时仅在 bps > 0 时触发；bps == 0（无上限）不触发。 以 maxBuyPerOrigin 的返回值为准。
• LaunchedToDEX：毕业事件。此后停止应用门控，切换到 DEX 路由。
• FlapNFTWhitelistUpdated：admin 增加或移除白名单合集时发出。
• FlapBuyQuotaUpdated：有上限的代币每次曲线买入后发出。Agent ID 门控代币上 bought 是本次买入后 max(netBought, balanceOf(origin))。卖出和转账时不会发出，之后请调用 buyQuotaOf（或自行 跟踪 TokenBought/TokenSold/Transfer）刷新 remaining。
• FlapNFTGateUpdated：admin 移除代币的 Agent ID 门控时发出，newNft 始终为 address(0)。此后按非门控 代币处理。
• TokenBought / TokenSold 不变。

4. 集成示例（ethers v6）

4.1 检测 Agent ID 门控与用户资格

const portal = new ethers.Contract(PORTAL_ADDRESS, PORTAL_ABI, provider);

const [state, nft, cap] = await Promise.all([
  portal.getTokenV8Safe(token),
  portal.nftGate(token).catch(() => ethers.ZeroAddress), // v5.27.0 之前的 Portal
  portal.maxBuyPerOrigin(token),
]);

const onCurve = state.status === 1n; // Tradable
const isGated = onCurve && nft !== ethers.ZeroAddress;

let userHoldsNft = true;
let remaining = ethers.MaxUint256;
if (isGated) {
  const erc721 = new ethers.Contract(nft, ["function balanceOf(address) view returns (uint256)"], provider);
  userHoldsNft = (await erc721.balanceOf(user)) > 0n;
  [, remaining] = await portal.buyQuotaOf(token, user);
}

const canBuy = !isGated || (userHoldsNft && remaining > 0n);
// 卖出仅需 Agent ID holder 校验

4.2 报价（必须传 from）

买入上限按 tx.origin 计算，eth_call 必须把 from 设为真实交易者。不传 from 时 tx.origin 是 address(0)，余额和 netBought 都是 0，报价会按完整上限估算。

const params = {
  inputToken: ethers.ZeroAddress, // 原生 BNB/ETH
  outputToken: token,
  inputAmount: parseEther("1"),
};
const out = await portal.quoteExactInput.staticCall(params, { from: user });

• quoteExactInput 不检查 Agent ID。非持有者也能拿到报价，UI 需用 4.1 的 balanceOf 控制。
• 用户已达或超过上限时，报价返回 BuyCapExceeded，按"已达买入上限"处理。
• 输入超过剩余额度时，报价对应上限内的实际成交量，多余输入在执行时退回。报价只返回代币输出量， 不返回退款金额。

4.3 交易

交易 ABI 不变：

struct ExactInputParams {
    address inputToken;     // address(0) = 原生币
    address outputToken;    // address(0) = 原生币
    uint256 inputAmount;
    uint256 minOutputAmount;
    bytes permitData;
}

function swapExactInput(ExactInputParams calldata params)
    external payable returns (uint256 outputAmount);

原生币买入：inputToken = address(0)，outputToken = token，msg.value = inputAmount。 卖出：inputToken = token，outputToken = address(0)，先对 Portal 做 approve 或 permit。

const tx = await portal.swapExactInput(
  {
    inputToken: ethers.ZeroAddress,
    outputToken: token,
    inputAmount: parseEther("1"),
    minOutputAmount: (out * 99n) / 100n,
    permitData: "0x",
  },
  { value: parseEther("1") }
);

Agent ID 校验在付款和原生币↔quote 兑换之前执行，门控失败时 revert 且不动用资金。买入上限校验在 曲线计算内部执行，其 revert 同样会回滚整笔交易。

4.4 触顶退款

未达上限的买入会成交到上限为止，多余输入按原币种退给 msg.sender：

• 原生币输入 → 原生币退款。
• ERC-20 quote 输入 → quote 代币退款。

输入超过剩余额度时，不要按完整输入推算 minOutputAmount：实际成交量更小，最小值设得过高会返回 SlippageTooHigh。请用 from = user 报价，并以该结果设置最小值。如需精确的退款预估，可模拟交易并 对比调用者的原生币或 quote 余额（eth_simulateV1、trace 或本地 fork）；否则显示"最多退回 X"的近似值。

5. 错误

ethers v6 解码：

try {
  await portal.swapExactInput(params, { value });
} catch (e: any) {
  const data = e?.data ?? e?.info?.error?.data;
  const selector = data?.slice(0, 10);
  if (selector === "0xf38fb4a7") showNftGateModal();
  if (selector === "0xc866db66") showCapModal();
}

6. 发射编码（面向发射工具）

Agent ID 门控通过现有的 extensionID / extensionData 发射字段传递，支持两种编码。

EXTENSION_ARRAY_ID         = keccak256("flap.extensions.v1")
                           = 0xc87a159bf445e83477134d6374216c321695c2f3e23ee3351c8d3df6ec740253
NFT_GATED_EXTENSION_ID     = keccak256("flap.extension.nft_gated.v1")
                           = 0x9c312f81d9a1b68ba5472ca93c5447d57f897fbf4a8c468b315a67fe8016d1ab
CURVE_AUTH_EXTENSION_ID_V2 = keccak256("flap.curve.auth.v2")
                           = 0x0f1f338177d85790dd81a6e795b59ae3a205cb498e034240ce2261bf753f13a4

6.1 数组形式（推荐，可与 signed-price 共存）

struct Extension {
    bytes32 extensionId;
    bytes extensionData;
}

Extension[] memory exts = new Extension[](1);
exts[0] = Extension({
    extensionId: NFT_GATED_EXTENSION_ID,
    extensionData: abi.encode(nftAddress)
});

params.extensionID = EXTENSION_ARRAY_ID;
params.extensionData = abi.encode(exts);

TypeScript（viem）：

import { encodeAbiParameters, keccak256, toHex } from "viem";

const NFT_GATED_ID = keccak256(toHex("flap.extension.nft_gated.v1"));
const ARRAY_ID = keccak256(toHex("flap.extensions.v1"));

const extensionData = encodeAbiParameters(
  [{ type: "tuple[]", components: [
      { name: "extensionId", type: "bytes32" },
      { name: "extensionData", type: "bytes" },
  ]}],
  [[{
    extensionId: NFT_GATED_ID,
    extensionData: encodeAbiParameters([{ type: "address" }], [nft]),
  }]]
);
// params.extensionID = ARRAY_ID; params.extensionData = extensionData;

6.2 旧版单 extension 形式

params.extensionID = NFT_GATED_EXTENSION_ID;
params.extensionData = abi.encode(nftAddress);

规则：

• nftAddress 在发射时必须有代码；零地址或无代码返回 InvalidNFTGate()。
• 新发射的 nftAddress 必须在发射白名单中；否则返回 NFTNotWhitelisted(nft)。
• 只使用第一个匹配 NFT_GATED_EXTENSION_ID 的条目。
• 两种编码都不带的发射：nftGate == address(0)，无自动上限。
• Agent ID 门控发射写入 maxBuyBpsPerOrigin = 200（2%）。创建者的 quoteAmt 首发买入同样需要 NFT， 同样受 max(netBought, balanceOf(origin)) 上限约束。

7. 限制与边界条件

1. tx.origin 身份。 Agent ID 门控假设由 EOA 直接调用 Portal。
   • 后端中继器 / meta-transaction：tx.origin 是中继器。
   • ERC-4337 UserOp：tx.origin 是 bundler EOA。
   • Safe / 智能账户经中继器执行：同样受限。
   • 上述场景下，真实持有者的交易会返回 NFTGatedOnly。
   • EIP-7702 委托后的 EOA：tx.origin 仍是该 EOA，校验正常。
2. 买入始终计入 tx.origin。 经辅助合约买入或把代币发到另一个钱包，即使 origin 从未持有这些 代币，也会消耗 origin 的 2% 额度。
3. 门控代币是混合额度。 held = max(netBought, balanceOf(origin))。只有曲线买入和卖出会改变 netBought；转出不会释放计数，转入会通过余额占用额度。用户可能没有买入也被空投/转账推到上限 之上。升级前已转走的老 bag 不计入 netBought，该 origin 可以再买一次满额。
4. 卖出不受 netBought 限制。 卖出超过 netBought 的代币（例如别人转入的代币）是允许的，计数最低 到 0。接收方之后卖出也不会减少 sender 的 netBought。
5. Agent ID 转出后无法在曲线上卖出。 代币转账仍然可用；持有者需重新取得 Agent ID 或等待毕业。
6. balanceOf 有 gas 上限。 调用上限为 100,000 gas。若合集的 balanceOf revert、gas 不足、 返回值不足 32 字节，或合约自毁，门控会 fail open，交易继续执行。标准 ERC-721 实现不受影响。
7. 报价不等于门控。 quoteExactInput 从不检查 Agent ID，只检查买入上限。UI 需自行校验，并用 from = user 模拟。

8. 示例

• 示例 Agent ID 合集：Binance Agent ID（0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F）。
• maxSupply = 1e27（1B 代币，18 位小数）；门控上限 = 1e27 * 200 / 10000 = 2e25 （20,000,000 代币）。
• Alice 持有 Agent ID，余额 0，用 100 BNB 买入：
  • 成交到 20,000,000 代币为止；多余 BNB 退回。
  • buyQuotaOf(token, alice) → bought = 2e25（netBought = 2e25），remaining = 0。
• Alice 把 5,000,000 代币转到另一个钱包：
  • netBought 仍是 20,000,000；held = max(2e25, 1.5e25) = 2e25；remaining 仍为 0。
  • 接收方余额 5,000,000 会占用接收方自己的额度。
• Alice 把 10,000,000 代币卖回曲线：
  • netBought = 1e25；余额 5,000,000；held = max(1e25, 5e24) = 1e25；
  • remaining = 1e25（还可买入 10,000,000）。她持有 5,000,000。
• Bob 买入 20,000,000 代币并全部转给 Alice：
  • Alice 余额 25,000,000；netBought 10,000,000；held = 2.5e25 > cap；remaining = 0。
  • Alice 卖出 25,000,000 代币：netBought 归 0，额度恢复到 2e25。
  • Bob 的 netBought 仍为 2e25：把代币送出并不会释放他的额度。
• Alice 转出 Agent ID：
  • 代币仍可转账，但曲线卖出返回 NFTGatedOnly(alice)。
• 代币毕业（LaunchedToDEX，status == 4）：
  • Portal 交易路径关闭；在 DEX 交易，Flap 侧不再有 NFT 要求。

链上案例（BNB Chain）

9. ABI 片段

9.1 Human-readable

function nftGate(address token) view returns (address nft)
function maxBuyPerOrigin(address token) view returns (uint16 bps, uint256 maxBuyAmount)
function buyQuotaOf(address token, address origin) view returns (uint256 bought, uint256 remaining)
function nftWhitelisted(address nft) view returns (bool allowed)

event FlapNFTGated(address token, address nft)
event FlapNFTWhitelistUpdated(address nft, bool allowed)
event FlapTokenMaxBuyPerOriginSet(address indexed token, uint16 bps, uint256 maxBuyAmount)
event LaunchedToDEX(address token, address pool, uint256 amount, uint256 eth)
event FlapBuyQuotaUpdated(address indexed token, address indexed origin, uint256 bought, uint256 remaining)
event FlapNFTGateUpdated(address token, address oldNft, address newNft)

error NFTGatedOnly(address wallet)
error NFTNotWhitelisted(address nft)
error BuyCapExceeded(address origin, uint256 held, uint256 cap)
error InvalidNFTGate()

9.2 JSON ABI（仅新增接口）

[
  {
    "type": "function",
    "name": "nftGate",
    "stateMutability": "view",
    "inputs": [{ "name": "token", "type": "address" }],
    "outputs": [{ "name": "nft", "type": "address" }]
  },
  {
    "type": "function",
    "name": "maxBuyPerOrigin",
    "stateMutability": "view",
    "inputs": [{ "name": "token", "type": "address" }],
    "outputs": [
      { "name": "bps", "type": "uint16" },
      { "name": "maxBuyAmount", "type": "uint256" }
    ]
  },
  {
    "type": "function",
    "name": "buyQuotaOf",
    "stateMutability": "view",
    "inputs": [
      { "name": "token", "type": "address" },
      { "name": "origin", "type": "address" }
    ],
    "outputs": [
      { "name": "bought", "type": "uint256" },
      { "name": "remaining", "type": "uint256" }
    ]
  },
  {
    "type": "function",
    "name": "nftWhitelisted",
    "stateMutability": "view",
    "inputs": [{ "name": "nft", "type": "address" }],
    "outputs": [{ "name": "allowed", "type": "bool" }]
  },
  {
    "type": "event",
    "name": "FlapNFTGated",
    "inputs": [
      { "name": "token", "type": "address", "indexed": false },
      { "name": "nft", "type": "address", "indexed": false }
    ]
  },
  {
    "type": "event",
    "name": "FlapNFTWhitelistUpdated",
    "inputs": [
      { "name": "nft", "type": "address", "indexed": false },
      { "name": "allowed", "type": "bool", "indexed": false }
    ]
  },
  {
    "type": "event",
    "name": "FlapTokenMaxBuyPerOriginSet",
    "inputs": [
      { "name": "token", "type": "address", "indexed": true },
      { "name": "bps", "type": "uint16", "indexed": false },
      { "name": "maxBuyAmount", "type": "uint256", "indexed": false }
    ]
  },
  {
    "type": "error",
    "name": "NFTGatedOnly",
    "inputs": [{ "name": "wallet", "type": "address" }]
  },
  {
    "type": "error",
    "name": "NFTNotWhitelisted",
    "inputs": [{ "name": "nft", "type": "address" }]
  },
  {
    "type": "error",
    "name": "BuyCapExceeded",
    "inputs": [
      { "name": "origin", "type": "address" },
      { "name": "held", "type": "uint256" },
      { "name": "cap", "type": "uint256" }
    ]
  },
  {
    "type": "event",
    "name": "FlapBuyQuotaUpdated",
    "inputs": [
      { "name": "token", "type": "address", "indexed": true },
      { "name": "origin", "type": "address", "indexed": true },
      { "name": "bought", "type": "uint256", "indexed": false },
      { "name": "remaining", "type": "uint256", "indexed": false }
    ]
  },
  {
    "type": "event",
    "name": "FlapNFTGateUpdated",
    "inputs": [
      { "name": "token", "type": "address", "indexed": false },
      { "name": "oldNft", "type": "address", "indexed": false },
      { "name": "newNft", "type": "address", "indexed": false }
    ]
  }
]

getTokenV8Safe、quoteExactInput、swapExactInput、TokenBought、TokenSold 均未变化， 继续使用现有 ABI。

10. 集成清单

• 用 try/catch 探测 nftGate，兼容 v5.27.0 之前的 Portal。
• 加载代币时读取 getTokenV8Safe.status、nftGate、maxBuyPerOrigin 和 buyQuotaOf(token, user)。
• status == 1 且 nftGate != 0 时，显示 Agent ID 提示、合集及用户持有状态。
• nft.balanceOf(user) == 0 或 remaining == 0 时禁用买入。
• nft.balanceOf(user) == 0 时禁用卖出；卖出不受 netBought 上限限制。
• 报价时传 from = user 以得到准确的上限结果；记住报价不检查 NFT。
• 门控交易由 EOA 直接发送，避免中继器和 4337 bundler。
• 处理 NFTGatedOnly、BuyCapExceeded、SlippageTooHigh 和 TokenNotTradable。ABI 继续使用 NFT 旧名，Agent ID 是产品术语。
• 展示实时上限进度（bought / cap、remaining），曲线买入、卖出和转账后刷新。
• 发射工具在提交前检查 nftWhitelisted(nft)（Agent ID 合集）；处理 NFTNotWhitelisted。
• 监听 FlapNFTWhitelistUpdated。
• 收到 LaunchedToDEX 或 status == 4 后切换到 DEX 路由并移除门控 UI。
• 索引 FlapNFTGated，在用户打开代币前就知道它是否 Agent ID 门控；并索引 FlapNFTGateUpdated， 在 admin 移除门控后撤下 Agent ID UI。

11. 合约地址

其他链使用不同的 Portal 代理，请从 Flap 的已部署合约地址页面获取。各链的 ABI 与本文语义完全一致。