SDK（草案）

尚未发布

Portus SDK 尚未发布，包名、版本与 API 均为待定。下面的代码只用于说明设计意图，无法运行。

项目	状态
TypeScript SDK 包名	<SDK_PACKAGE>（待定）
源码仓库	待公开
支持链	Robinhood Chain、以太坊主网（合约待部署）

用法示意（草案，不可运行）

// 草案：包名与 API 均未确定
import { PortusClient } from '<SDK_PACKAGE>'

const portus = new PortusClient({ chain: 'robinhood', rpcUrl: '<RPC_URL>' })

// 1. 创建者：发币
const { token, sale, pool } = await portus.createToken({
  name: 'Example',
  symbol: 'EXM',
  quoteAsset: '<QUOTE_ASSET_ADDRESS>',   // 必须在本链白名单内
  feeTierBps: 100,                       // 1%
  creatorShareBps: 2000,                 // 占手续费 20%（上限 4000）
  targetFdv: '4.2',                      // 以报价资产计
  incentiveBps: 0,                       // 激励池 x
  underfillRule: 'refund',               // 'refund' | 'shrink'
  saleDurationSec: 48 * 3600,            // 示例
  whitelistRoot: '<MERKLE_ROOT>',
  treasuryMode: 'buyback',               // 'buyback' | 'twabRewards'
})

// 2. 认购者：认购
await portus.subscribe({ sale, amount: '0.1', cap: '0.5', proof: ['<PROOF>'] })

// 3. 交易者：报价与交易
const quote = await portus.quote({ pool, side: 'buy', amountIn: '0.05' })
console.log(quote.fee, quote.priceImpact, quote.roundTripCost)