four-flap-meme-sdk 4.1.1 → 4.2.0

package/dist/chains/robinhood/pons-v2/encode.d.ts

@@ -0,0 +1,62 @@
+/**
+ * pons v2 发币编码
+ *
+ * 对齐 https://docs.ponsfamily.com/v2：launchToken / launchAndBuy。
+ */
+export declare const PONS_V2_TOKEN_LAUNCHED_TOPIC: string;
+export interface PonsV2Socials {
+    twitter: string;
+    telegram: string;
+    discord: string;
+    website: string;
+    farcaster: string;
+}
+export interface PonsV2TokenParams {
+    name: string;
+    symbol: string;
+    logo?: string;
+    description?: string;
+    socials?: Partial<PonsV2Socials>;
+    creatorFeeRecipient?: string;
+    creatorTaxBps?: number;
+    buybackEnabled?: boolean;
+    expectedEconomics: string;
+    salt?: string;
+}
+export interface PonsV2LaunchCall {
+    to: string;
+    data: string;
+    value: bigint;
+}
+export declare function randomPonsV2Salt(): string;
+export declare function toPonsV2TokenTuple(params: PonsV2TokenParams, options?: {
+    requireCreatorFeeRecipient?: boolean;
+}): {
+    name: string;
+    symbol: string;
+    logo: string;
+    description: string;
+    socials: PonsV2Socials;
+    creatorFeeRecipient: string;
+    creatorTaxBps: number;
+    buybackEnabled: boolean;
+    expectedEconomics: string;
+    salt: string;
+};
+export declare function encodePonsV2LaunchToken(params: PonsV2TokenParams, launchConfigId: bigint, pairToken?: string, snipeTaxExemptions?: string[]): string;
+export declare function encodePonsV2LaunchAndBuy(params: PonsV2TokenParams, launchConfigId: bigint, pairToken: string, quoteIn: bigint, minTokensOut: bigint, recipient: string, snipeTaxExemptions?: string[]): string;
+export declare function encodePonsV2PreviewLaunchEconomics(launchConfigId: bigint, pairToken: string): string;
+export declare function parsePonsV2TokenFromLogs(logs: ReadonlyArray<{
+    topics: readonly string[];
+    address: string;
+}>, factory?: string): string | undefined;
+export declare function buildPonsV2LaunchCall(params: {
+    token: PonsV2TokenParams;
+    launchConfigId: bigint;
+    pairToken?: string;
+    launchFee: bigint;
+    quoteIn?: bigint;
+    minTokensOut?: bigint;
+    recipient?: string;
+    snipeTaxExemptions?: string[];
+}): PonsV2LaunchCall;

package/dist/chains/robinhood/pons-v2/encode.js

@@ -0,0 +1,115 @@
+/**
+ * pons v2 发币编码
+ *
+ * 对齐 https://docs.ponsfamily.com/v2：launchToken / launchAndBuy。
+ */
+import { getAddress, hexlify, id, Interface, randomBytes, ZeroAddress } from 'ethers';
+import { PONS_V2_FACTORY, PONS_V2_LAUNCH_AND_BUY, PONS_V2_LAUNCH_AND_BUY_ABI } from '../constants.js';
+const SOCIALS_TUPLE = 'tuple(string twitter, string telegram, string discord, string website, string farcaster)';
+const TOKEN_PARAMS_TUPLE = `tuple(string name, string symbol, string logo, string description, ${SOCIALS_TUPLE} socials, address creatorFeeRecipient, uint16 creatorTaxBps, bool buybackEnabled, bytes32 expectedEconomics, bytes32 salt)`;
+const launchTokenIface = new Interface([
+    `function launchToken(${TOKEN_PARAMS_TUPLE} params, uint256 launchConfigId, address pairToken) payable returns (address token, address curve)`,
+]);
+const launchTokenExemptIface = new Interface([
+    `function launchToken(${TOKEN_PARAMS_TUPLE} params, uint256 launchConfigId, address pairToken, address[] snipeTaxExemptions) payable returns (address token, address curve)`,
+]);
+const previewIface = new Interface([
+    'function previewLaunchEconomics(uint256 launchConfigId, address pairToken) view returns (bytes32)',
+]);
+const launchAndBuyIface = new Interface(PONS_V2_LAUNCH_AND_BUY_ABI);
+export const PONS_V2_TOKEN_LAUNCHED_TOPIC = id('TokenLaunched(address,address,address,address,uint256,uint256)');
+function emptySocials() {
+    return { twitter: '', telegram: '', discord: '', website: '', farcaster: '' };
+}
+export function randomPonsV2Salt() {
+    return hexlify(randomBytes(32));
+}
+export function toPonsV2TokenTuple(params, options) {
+    const recipient = params.creatorFeeRecipient?.trim()
+        ? getAddress(params.creatorFeeRecipient)
+        : ZeroAddress;
+    if (options?.requireCreatorFeeRecipient && recipient === ZeroAddress) {
+        throw new Error('pons launchAndBuy requires an explicit creatorFeeRecipient');
+    }
+    const socials = { ...emptySocials(), ...params.socials };
+    return {
+        name: params.name,
+        symbol: params.symbol,
+        logo: params.logo ?? '',
+        description: params.description ?? '',
+        socials,
+        creatorFeeRecipient: recipient,
+        creatorTaxBps: params.creatorTaxBps ?? 0,
+        buybackEnabled: params.buybackEnabled ?? true,
+        expectedEconomics: params.expectedEconomics,
+        salt: params.salt ?? randomPonsV2Salt(),
+    };
+}
+export function encodePonsV2LaunchToken(params, launchConfigId, pairToken = ZeroAddress, snipeTaxExemptions) {
+    const tuple = toPonsV2TokenTuple(params);
+    const pair = pairToken === ZeroAddress ? ZeroAddress : getAddress(pairToken);
+    if (snipeTaxExemptions && snipeTaxExemptions.length > 0) {
+        if (snipeTaxExemptions.length > 32) {
+            throw new Error('pons snipe tax exemption list exceeds 32');
+        }
+        return launchTokenExemptIface.encodeFunctionData('launchToken', [
+            tuple,
+            launchConfigId,
+            pair,
+            snipeTaxExemptions.map((a) => getAddress(a)),
+        ]);
+    }
+    return launchTokenIface.encodeFunctionData('launchToken', [tuple, launchConfigId, pair]);
+}
+export function encodePonsV2LaunchAndBuy(params, launchConfigId, pairToken, quoteIn, minTokensOut, recipient, snipeTaxExemptions = []) {
+    const tuple = toPonsV2TokenTuple(params, { requireCreatorFeeRecipient: true });
+    const pair = pairToken === ZeroAddress ? ZeroAddress : getAddress(pairToken);
+    if (snipeTaxExemptions.length > 32) {
+        throw new Error('pons snipe tax exemption list exceeds 32');
+    }
+    return launchAndBuyIface.encodeFunctionData('launchAndBuy', [
+        tuple,
+        launchConfigId,
+        pair,
+        quoteIn,
+        minTokensOut,
+        getAddress(recipient),
+        snipeTaxExemptions.map((a) => getAddress(a)),
+    ]);
+}
+export function encodePonsV2PreviewLaunchEconomics(launchConfigId, pairToken) {
+    const pair = pairToken === ZeroAddress ? ZeroAddress : getAddress(pairToken);
+    return previewIface.encodeFunctionData('previewLaunchEconomics', [launchConfigId, pair]);
+}
+export function parsePonsV2TokenFromLogs(logs, factory = PONS_V2_FACTORY) {
+    const factoryAddr = getAddress(factory);
+    for (const log of logs) {
+        if (log.topics[0] !== PONS_V2_TOKEN_LAUNCHED_TOPIC || log.topics.length < 2)
+            continue;
+        if (getAddress(log.address) !== factoryAddr && getAddress(log.address) !== getAddress(PONS_V2_LAUNCH_AND_BUY)) {
+            // TokenLaunched is emitted by the factory; router path still originates there.
+        }
+        return getAddress(`0x${log.topics[1].slice(26)}`);
+    }
+    return undefined;
+}
+export function buildPonsV2LaunchCall(params) {
+    const pairToken = params.pairToken ?? ZeroAddress;
+    const quoteIn = params.quoteIn ?? 0n;
+    if (quoteIn > 0n) {
+        if (!params.recipient) {
+            throw new Error('pons launchAndBuy needs a recipient');
+        }
+        const nativePair = pairToken === ZeroAddress;
+        return {
+            to: PONS_V2_LAUNCH_AND_BUY,
+            data: encodePonsV2LaunchAndBuy(params.token, params.launchConfigId, pairToken, quoteIn, params.minTokensOut ?? 0n, params.recipient, params.snipeTaxExemptions ?? []),
+            value: nativePair ? params.launchFee + quoteIn : params.launchFee,
+        };
+    }
+    return {
+        to: PONS_V2_FACTORY,
+        data: encodePonsV2LaunchToken(params.token, params.launchConfigId, pairToken, params.snipeTaxExemptions),
+        value: params.launchFee,
+    };
+}

package/dist/chains/robinhood/pons-v2/index.d.ts

@@ -0,0 +1,2 @@
+export { PONS_V2_TOKEN_LAUNCHED_TOPIC, randomPonsV2Salt, toPonsV2TokenTuple, encodePonsV2LaunchToken, encodePonsV2LaunchAndBuy, encodePonsV2PreviewLaunchEconomics, parsePonsV2TokenFromLogs, buildPonsV2LaunchCall, type PonsV2Socials, type PonsV2TokenParams, type PonsV2LaunchCall, } from './encode.js';
+export { getPonsV2LaunchFee, previewPonsV2LaunchEconomics, canPonsV2Launch, listOpenPonsV2LaunchConfigs, signPonsV2Launch, type PonsV2LaunchConfig, type PonsV2LaunchParams, type PonsV2LaunchSignResult, } from './launch.js';

package/dist/chains/robinhood/pons-v2/index.js

@@ -0,0 +1,2 @@
+export { PONS_V2_TOKEN_LAUNCHED_TOPIC, randomPonsV2Salt, toPonsV2TokenTuple, encodePonsV2LaunchToken, encodePonsV2LaunchAndBuy, encodePonsV2PreviewLaunchEconomics, parsePonsV2TokenFromLogs, buildPonsV2LaunchCall, } from './encode.js';
+export { getPonsV2LaunchFee, previewPonsV2LaunchEconomics, canPonsV2Launch, listOpenPonsV2LaunchConfigs, signPonsV2Launch, } from './launch.js';

package/dist/chains/robinhood/pons-v2/launch.d.ts

@@ -0,0 +1,48 @@
+/**
+ * pons v2 发币：读 launchFee + expectedEconomics，再签 launchToken 或 launchAndBuy
+ */
+import { type RobinhoodSignedTx } from '../sign.js';
+export interface PonsV2LaunchConfig {
+    id: bigint;
+    supply: bigint;
+    curveFeeBps: bigint;
+    phantomQuote: bigint;
+    graduationThreshold: bigint;
+    poolFee: number;
+    tickSpacing: number;
+    enabled: boolean;
+}
+export interface PonsV2LaunchParams {
+    rpcUrl?: string;
+    privateKey: string;
+    name: string;
+    symbol: string;
+    logo?: string;
+    description?: string;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+    creatorFeeRecipient?: string;
+    creatorTaxBps?: number;
+    buybackEnabled?: boolean;
+    launchConfigId?: bigint;
+    pairToken?: string;
+    quoteIn?: bigint;
+    minTokensOut?: bigint;
+    snipeTaxExemptions?: string[];
+    salt?: string;
+    gasPrice?: bigint;
+    nonce?: number;
+}
+export interface PonsV2LaunchSignResult extends RobinhoodSignedTx {
+    launchFee: bigint;
+    expectedEconomics: string;
+    salt: string;
+    to: string;
+    value: bigint;
+}
+export declare function getPonsV2LaunchFee(rpcUrl?: string): Promise<bigint>;
+export declare function previewPonsV2LaunchEconomics(launchConfigId: bigint, pairToken?: string, rpcUrl?: string): Promise<string>;
+export declare function canPonsV2Launch(account: string, rpcUrl?: string): Promise<boolean>;
+export declare function listOpenPonsV2LaunchConfigs(rpcUrl?: string): Promise<PonsV2LaunchConfig[]>;
+export declare function signPonsV2Launch(params: PonsV2LaunchParams): Promise<PonsV2LaunchSignResult>;

package/dist/chains/robinhood/pons-v2/launch.js

@@ -0,0 +1,107 @@
+/**
+ * pons v2 发币：读 launchFee + expectedEconomics，再签 launchToken 或 launchAndBuy
+ */
+import { Contract, JsonRpcProvider, Wallet, ZeroAddress } from 'ethers';
+import { PONS_V2_FACTORY, PONS_V2_FACTORY_ABI, PONS_V2_LAUNCH_GAS_LIMIT, ROBINHOOD_CHAIN_ID, ROBINHOOD_RPC_URL, } from '../constants.js';
+import { signRobinhoodTx } from '../sign.js';
+import { buildPonsV2LaunchCall, encodePonsV2PreviewLaunchEconomics, randomPonsV2Salt, } from './encode.js';
+export async function getPonsV2LaunchFee(rpcUrl = ROBINHOOD_RPC_URL) {
+    const provider = new JsonRpcProvider(rpcUrl, ROBINHOOD_CHAIN_ID, { staticNetwork: true });
+    const factory = new Contract(PONS_V2_FACTORY, PONS_V2_FACTORY_ABI, provider);
+    return factory.launchFee();
+}
+export async function previewPonsV2LaunchEconomics(launchConfigId, pairToken = ZeroAddress, rpcUrl = ROBINHOOD_RPC_URL) {
+    const provider = new JsonRpcProvider(rpcUrl, ROBINHOOD_CHAIN_ID, { staticNetwork: true });
+    const data = encodePonsV2PreviewLaunchEconomics(launchConfigId, pairToken);
+    return provider.call({ to: PONS_V2_FACTORY, data });
+}
+export async function canPonsV2Launch(account, rpcUrl = ROBINHOOD_RPC_URL) {
+    const provider = new JsonRpcProvider(rpcUrl, ROBINHOOD_CHAIN_ID, { staticNetwork: true });
+    const factory = new Contract(PONS_V2_FACTORY, PONS_V2_FACTORY_ABI, provider);
+    return factory.canLaunch(account);
+}
+export async function listOpenPonsV2LaunchConfigs(rpcUrl = ROBINHOOD_RPC_URL) {
+    const provider = new JsonRpcProvider(rpcUrl, ROBINHOOD_CHAIN_ID, { staticNetwork: true });
+    const factory = new Contract(PONS_V2_FACTORY, PONS_V2_FACTORY_ABI, provider);
+    const count = Number(await factory.launchConfigCount());
+    const configs = [];
+    for (let id = 0; id < count; id++) {
+        const row = (await factory.getLaunchConfig(BigInt(id)));
+        const enabled = Boolean(row.enabled);
+        if (!enabled)
+            continue;
+        configs.push({
+            id: BigInt(id),
+            supply: row.supply,
+            curveFeeBps: row.curveFeeBps,
+            phantomQuote: row.phantomQuote,
+            graduationThreshold: row.graduationThreshold,
+            poolFee: Number(row.poolFee),
+            tickSpacing: Number(row.tickSpacing),
+            enabled,
+        });
+    }
+    return configs;
+}
+export async function signPonsV2Launch(params) {
+    const rpcUrl = params.rpcUrl ?? ROBINHOOD_RPC_URL;
+    const wallet = new Wallet(params.privateKey);
+    const pairToken = params.pairToken ?? ZeroAddress;
+    const launchConfigId = params.launchConfigId ?? 0n;
+    const salt = params.salt ?? randomPonsV2Salt();
+    const creatorFeeRecipient = params.creatorFeeRecipient?.trim()
+        ? params.creatorFeeRecipient
+        : wallet.address;
+    const allowed = await canPonsV2Launch(wallet.address, rpcUrl);
+    if (!allowed) {
+        throw new Error('pons factory is not allowing this wallet to launch');
+    }
+    const [launchFee, expectedEconomics] = await Promise.all([
+        getPonsV2LaunchFee(rpcUrl),
+        previewPonsV2LaunchEconomics(launchConfigId, pairToken, rpcUrl),
+    ]);
+    const token = {
+        name: params.name,
+        symbol: params.symbol,
+        logo: params.logo,
+        description: params.description,
+        socials: {
+            twitter: params.twitter ?? '',
+            telegram: params.telegram ?? '',
+            website: params.website ?? '',
+        },
+        creatorFeeRecipient,
+        creatorTaxBps: params.creatorTaxBps,
+        buybackEnabled: params.buybackEnabled,
+        expectedEconomics,
+        salt,
+    };
+    const call = buildPonsV2LaunchCall({
+        token,
+        launchConfigId,
+        pairToken,
+        launchFee,
+        quoteIn: params.quoteIn,
+        minTokensOut: params.minTokensOut,
+        recipient: wallet.address,
+        snipeTaxExemptions: params.snipeTaxExemptions,
+    });
+    const signed = await signRobinhoodTx({
+        rpcUrl,
+        privateKey: params.privateKey,
+        to: call.to,
+        data: call.data,
+        value: call.value,
+        gasLimit: PONS_V2_LAUNCH_GAS_LIMIT,
+        gasPrice: params.gasPrice,
+        nonce: params.nonce,
+    });
+    return {
+        ...signed,
+        launchFee,
+        expectedEconomics,
+        salt,
+        to: call.to,
+        value: call.value,
+    };
+}

package/dist/chains/robinhood/robinhood.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/chains/robinhood/robinhood.test.js

@@ -0,0 +1,103 @@
+import { id, Interface, keccak256, toUtf8Bytes, ZeroAddress } from 'ethers';
+import { describe, expect, it } from 'vitest';
+import { ADDRESSES, CHAINS, isRobinhoodChain } from '../../core/constants/index.js';
+import { encodeLongetfDeployVault, encodeLongetfRegister, longetfEffectiveSalt, longetfVaultInitCodeHash, mineLongetfVaultSalt, parseLongetfTokenFromLogs, patchLongetfLaunchCalldata, predictLongetfVault, } from './longetf/encode.js';
+import { LONGETF_LAUNCH_TEMPLATE } from './longetf/assets.js';
+import { encodePonsV2LaunchAndBuy, encodePonsV2LaunchToken, parsePonsV2TokenFromLogs, PONS_V2_TOKEN_LAUNCHED_TOPIC, } from './pons-v2/encode.js';
+import { LONGETF_FACTORY, LONG_XYZ_PROTOCOL_BENEFICIARY, PONS_V2_FACTORY, PONS_V2_LAUNCH_AND_BUY, } from './constants.js';
+describe('Robinhood LONGETF / pons v2 launch encoding', () => {
+    const creator = '0x1111111111111111111111111111111111111111';
+    it('exposes Robinhood chain id 4663', () => {
+        expect(CHAINS.ROBINHOOD.chainId).toBe(4663);
+        expect(isRobinhoodChain(4663)).toBe(true);
+        expect(ADDRESSES.ROBINHOOD.LongetfFactory.toLowerCase()).toBe(LONGETF_FACTORY.toLowerCase());
+    });
+    it('mines a vault that sorts above the long.xyz protocol beneficiary', () => {
+        const mined = mineLongetfVaultSalt(creator);
+        expect(predictLongetfVault(mined.salt, creator)).toBe(mined.vault);
+        expect(BigInt(mined.vault) > BigInt(LONG_XYZ_PROTOCOL_BENEFICIARY)).toBe(true);
+        expect(longetfEffectiveSalt(mined.salt, creator)).toMatch(/^0x[0-9a-f]{64}$/);
+        expect(longetfVaultInitCodeHash()).toMatch(/^0x[0-9a-f]{64}$/);
+    });
+    it('encodes deployVault / register with the live selectors', () => {
+        const salt = '0x' + '11'.repeat(32);
+        const deploy = encodeLongetfDeployVault(salt, creator);
+        expect(deploy.slice(0, 10)).toBe(id('deployVault(bytes32,address,bytes)').slice(0, 10));
+        const token = '0x2222222221111111111111111111111111111111';
+        const register = encodeLongetfRegister(token, creator);
+        expect(register.slice(0, 10)).toBe(id('register(address,address)').slice(0, 10));
+    });
+    it('patches long.xyz create() template name, ticker, anchor and vault', () => {
+        const vault = '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
+        const anchor = '0xaf3d76f1834a1d425780943c99ea8a608f8a93f9';
+        const data = patchLongetfLaunchCalldata({
+            name: 'TestCoin',
+            symbol: 'HOOD',
+            anchor,
+            vault,
+            metaUri: '',
+            launchSalt: '0x' + '22'.repeat(32),
+        });
+        expect(data.startsWith('0x882db707')).toBe(true);
+        expect(data.length).toBe(LONGETF_LAUNCH_TEMPLATE.length);
+        expect(data.toLowerCase()).toContain(vault.slice(2).toLowerCase());
+        expect(data.toLowerCase()).toContain(anchor.slice(2).toLowerCase());
+        expect(data).toContain('484f4f44');
+    });
+    it('rejects illegal LONGETF tickers', () => {
+        expect(() => patchLongetfLaunchCalldata({
+            name: 'X',
+            symbol: 'H00D',
+            anchor: creator,
+            vault: creator,
+        })).toThrow(/letters only/i);
+    });
+    it('parses a mint Transfer as the LONGETF token', () => {
+        const token = '0x3333333333333333333333333333333333333333';
+        const topic = keccak256(toUtf8Bytes('Transfer(address,address,uint256)'));
+        const parsed = parseLongetfTokenFromLogs([
+            {
+                address: token,
+                topics: [topic, '0x' + '00'.repeat(32), '0x' + creator.slice(2).padStart(64, '0')],
+            },
+        ]);
+        expect(parsed?.toLowerCase()).toBe(token);
+    });
+    it('encodes pons v2 launchToken and launchAndBuy', () => {
+        const economics = '0x' + 'ab'.repeat(32);
+        const launch = encodePonsV2LaunchToken({
+            name: 'Example',
+            symbol: 'EXMPL',
+            expectedEconomics: economics,
+            salt: '0x' + '33'.repeat(32),
+        }, 0n, ZeroAddress);
+        expect(launch.startsWith('0x')).toBe(true);
+        expect(launch.length).toBeGreaterThan(10);
+        const buy = encodePonsV2LaunchAndBuy({
+            name: 'Example',
+            symbol: 'EXMPL',
+            expectedEconomics: economics,
+            salt: '0x' + '33'.repeat(32),
+            creatorFeeRecipient: creator,
+        }, 0n, ZeroAddress, 10n ** 16n, 0n, creator, []);
+        expect(buy.startsWith('0x')).toBe(true);
+        expect(PONS_V2_LAUNCH_AND_BUY.toLowerCase()).toMatch(/^0x[0-9a-f]{40}$/);
+        expect(PONS_V2_FACTORY.toLowerCase()).toMatch(/^0x[0-9a-f]{40}$/);
+    });
+    it('requires creatorFeeRecipient on launchAndBuy', () => {
+        expect(() => encodePonsV2LaunchAndBuy({ name: 'A', symbol: 'B', expectedEconomics: '0x' + '00'.repeat(32) }, 0n, ZeroAddress, 1n, 0n, creator)).toThrow(/creatorFeeRecipient/);
+    });
+    it('parses TokenLaunched topic0 as the pons token', () => {
+        const token = '0x4444444444444444444444444444444444444444';
+        const parsed = parsePonsV2TokenFromLogs([
+            {
+                address: PONS_V2_FACTORY,
+                topics: [PONS_V2_TOKEN_LAUNCHED_TOPIC, '0x' + token.slice(2).padStart(64, '0')],
+            },
+        ]);
+        expect(parsed?.toLowerCase()).toBe(token);
+        expect(PONS_V2_TOKEN_LAUNCHED_TOPIC).toBe(new Interface([
+            'event TokenLaunched(address indexed token, address indexed curve, address indexed deployer, address pairToken, uint256 launchConfigId, uint256 graduationThreshold)',
+        ]).getEvent('TokenLaunched').topicHash);
+    });
+});

package/dist/chains/robinhood/sign.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Robinhood Chain EIP-1559 签名
+ */
+export interface RobinhoodSignParams {
+    rpcUrl?: string;
+    privateKey: string;
+    to: string;
+    data: string;
+    value?: bigint;
+    gasLimit: bigint;
+    gasPrice?: bigint;
+    nonce?: number;
+}
+export interface RobinhoodSignedTx {
+    signedTx: string;
+    from: string;
+    nonce: number;
+    hash: string;
+}
+export declare function signRobinhoodTx(params: RobinhoodSignParams): Promise<RobinhoodSignedTx>;

package/dist/chains/robinhood/sign.js

@@ -0,0 +1,31 @@
+/**
+ * Robinhood Chain EIP-1559 签名
+ */
+import { JsonRpcProvider, Transaction, Wallet } from 'ethers';
+import { ROBINHOOD_CHAIN_ID, ROBINHOOD_RPC_URL } from './constants.js';
+export async function signRobinhoodTx(params) {
+    const rpcUrl = params.rpcUrl ?? ROBINHOOD_RPC_URL;
+    const provider = new JsonRpcProvider(rpcUrl, ROBINHOOD_CHAIN_ID, { staticNetwork: true });
+    const wallet = new Wallet(params.privateKey, provider);
+    const nonce = params.nonce ?? (await wallet.getNonce());
+    const feeData = await provider.getFeeData();
+    const maxFeePerGas = params.gasPrice ?? feeData.maxFeePerGas ?? feeData.gasPrice ?? 1000000000n;
+    const signedTx = await wallet.signTransaction({
+        to: params.to,
+        value: params.value ?? 0n,
+        data: params.data,
+        nonce,
+        chainId: ROBINHOOD_CHAIN_ID,
+        type: 2,
+        maxFeePerGas,
+        maxPriorityFeePerGas: feeData.maxPriorityFeePerGas ?? 0n,
+        gasLimit: params.gasLimit,
+    });
+    const tx = Transaction.from(signedTx);
+    return {
+        signedTx,
+        from: wallet.address,
+        nonce,
+        hash: tx.hash ?? '',
+    };
+}

package/dist/core/constants/addresses.d.ts

@@ -138,6 +138,24 @@ export declare const ADDRESSES: {
         readonly IroSwapV2Router: "0x93b1199fA96f6b9b1f993AA0226eB6076968a9BF";
         readonly IroSwapV2Factory: "0xdE4360F6Cd386FD70Db1386F920138177e3967df";
     };
+    readonly ROBINHOOD: {
+        readonly WETH: "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73";
+        readonly Multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11";
+        /** LONGETF factory — deployVault / register */
+        readonly LongetfFactory: "0xd2ba46aeffec4bfddde62c2dd3e8c76c5c9aeedc";
+        /** long.xyz Airlock launcher create() */
+        readonly LongXyzLauncher: "0x22e99278308B393ea1260859B181AD7E78f5eeED";
+        /** long.xyz pool hook — getBeneficiaries / updateBeneficiary */
+        readonly LongXyzHook: "0x4e3468951d49f2eea976ed0d6e75ffcb44a9a544";
+        /** long.xyz 5% protocol fee recipient; vault CREATE2 must sort above this */
+        readonly LongXyzProtocolBeneficiary: "0x21e2ce70511e4fe542a97708e89520471daa7a66";
+        /** pons v2 factory — launchToken */
+        readonly PonsV2Factory: "0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e";
+        /** pons v2 launch-and-buy router */
+        readonly PonsV2LaunchAndBuy: "0xe33E9E479dF8802cb0866d5d05258bEc4cF62948";
+        readonly PonsV2MemeHook: "0xE5e702641Ea86F4ae6cC3cDaeD2B886f976Be044";
+        readonly PonsV2Locker: "0x267444D099b10fB5Ed7c3Cc7B7c767AdcA574952";
+    };
 };
 export declare const ENI_SPENDERS: {
     /** Phase 1 Direct 模式: 需要 approve 3 个 spender (含 IROSwap) */

package/dist/core/constants/addresses.js

@@ -202,6 +202,27 @@ export const ADDRESSES = {
         IroSwapV2Router: '0x93b1199fA96f6b9b1f993AA0226eB6076968a9BF',
         IroSwapV2Factory: '0xdE4360F6Cd386FD70Db1386F920138177e3967df',
     },
+    // ========================================================================
+    // Robinhood Chain (Chain ID: 4663)
+    // ========================================================================
+    ROBINHOOD: {
+        WETH: '0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73',
+        Multicall3: '0xcA11bde05977b3631167028862bE2a173976CA11',
+        /** LONGETF factory — deployVault / register */
+        LongetfFactory: '0xd2ba46aeffec4bfddde62c2dd3e8c76c5c9aeedc',
+        /** long.xyz Airlock launcher create() */
+        LongXyzLauncher: '0x22e99278308B393ea1260859B181AD7E78f5eeED',
+        /** long.xyz pool hook — getBeneficiaries / updateBeneficiary */
+        LongXyzHook: '0x4e3468951d49f2eea976ed0d6e75ffcb44a9a544',
+        /** long.xyz 5% protocol fee recipient; vault CREATE2 must sort above this */
+        LongXyzProtocolBeneficiary: '0x21e2ce70511e4fe542a97708e89520471daa7a66',
+        /** pons v2 factory — launchToken */
+        PonsV2Factory: '0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e',
+        /** pons v2 launch-and-buy router */
+        PonsV2LaunchAndBuy: '0xe33E9E479dF8802cb0866d5d05258bEc4cF62948',
+        PonsV2MemeHook: '0xE5e702641Ea86F4ae6cC3cDaeD2B886f976Be044',
+        PonsV2Locker: '0x267444D099b10fB5Ed7c3Cc7B7c767AdcA574952',
+    },
 };
 // ============================================================================
 // ENI Spender 配置（一键授权用）
@@ -262,6 +283,8 @@ export function getWrappedNativeAddress(chainId) {
             return ADDRESSES.BASE.WETH;
         case 173:
             return ADDRESSES.ENI.WEGAS;
+        case 4663:
+            return ADDRESSES.ROBINHOOD.WETH;
         default:
             return undefined;
     }

package/dist/core/constants/chains.d.ts

@@ -104,6 +104,18 @@ export declare const CHAINS: {
         readonly explorer: "https://scan.eniac.network";
         readonly confirmationTimeout: 60000;
     };
+    readonly ROBINHOOD: {
+        readonly chainId: 4663;
+        readonly name: "Robinhood Chain";
+        readonly nativeCurrency: "ETH";
+        readonly wrappedNative: "WETH";
+        readonly rpcUrls: {
+            readonly default: "https://rpc.mainnet.chain.robinhood.com";
+        };
+        readonly blockTime: 250;
+        readonly explorer: "https://robinhoodchain.blockscout.com";
+        readonly confirmationTimeout: 120000;
+    };
 };
 export declare const CHAIN_ID_MAP: Record<string, number>;
 export type ChainKey = keyof typeof CHAINS;
@@ -140,6 +152,10 @@ export declare function isMonadChain(chainId: number): boolean;
  * 判断是否为 ENI 链
  */
 export declare function isEniChain(chainId: number): boolean;
+/**
+ * 判断是否为 Robinhood Chain
+ */
+export declare function isRobinhoodChain(chainId: number): boolean;
 /**
  * 获取确认超时时间
  */

package/dist/core/constants/chains.js

@@ -107,6 +107,18 @@ export const CHAINS = {
         explorer: 'https://scan.eniac.network',
         confirmationTimeout: 60000,
     },
+    ROBINHOOD: {
+        chainId: 4663,
+        name: 'Robinhood Chain',
+        nativeCurrency: 'ETH',
+        wrappedNative: 'WETH',
+        rpcUrls: {
+            default: 'https://rpc.mainnet.chain.robinhood.com',
+        },
+        blockTime: 250,
+        explorer: 'https://robinhoodchain.blockscout.com',
+        confirmationTimeout: 120000,
+    },
 };
 // ============================================================================
 // Chain ID 映射表（用于快速查找）
@@ -120,9 +132,11 @@ export const CHAIN_ID_MAP = {
     MORPH: CHAINS.MORPH.chainId,
     ETHEREUM: CHAINS.ETHEREUM.chainId,
     ENI: CHAINS.ENI.chainId,
+    ROBINHOOD: CHAINS.ROBINHOOD.chainId,
     // 别名
     'X Layer': CHAINS.XLAYER.chainId,
     'Arbitrum One': CHAINS.ARBITRUM_ONE.chainId,
+    'Robinhood Chain': CHAINS.ROBINHOOD.chainId,
     ETH: CHAINS.ETHEREUM.chainId,
 };
 // ============================================================================
@@ -176,6 +190,12 @@ export function isMonadChain(chainId) {
 export function isEniChain(chainId) {
     return chainId === CHAINS.ENI.chainId;
 }
+/**
+ * 判断是否为 Robinhood Chain
+ */
+export function isRobinhoodChain(chainId) {
+    return chainId === CHAINS.ROBINHOOD.chainId;
+}
 /**
  * 获取确认超时时间
  */

package/dist/core/constants/gas.d.ts

@@ -43,6 +43,14 @@ export declare const GAS_LIMITS: {
     readonly AA_PRE_VERIFICATION: 60000n;
     /** AA 默认 Call Gas Limit */
     readonly AA_CALL_GAS_LIMIT: 800000n;
+    /** LONGETF deployVault（页面固定 3,000,000） */
+    readonly ROBINHOOD_LONGETF_DEPLOY_VAULT: 3000000n;
+    /** LONGETF long.xyz create() */
+    readonly ROBINHOOD_LONGETF_LAUNCH: 3000000n;
+    /** LONGETF factory register */
+    readonly ROBINHOOD_LONGETF_REGISTER: 500000n;
+    /** pons v2 launchToken / launchAndBuy */
+    readonly ROBINHOOD_PONS_LAUNCH: 3000000n;
 };
 export declare const GAS_CONFIG: {
     /** Gas 估算安全余量（20%） */

package/dist/core/constants/gas.js

@@ -52,6 +52,15 @@ export const GAS_LIMITS = {
     AA_PRE_VERIFICATION: 60000n,
     /** AA 默认 Call Gas Limit */
     AA_CALL_GAS_LIMIT: 800000n,
+    // ==================== Robinhood Chain 发币 ====================
+    /** LONGETF deployVault（页面固定 3,000,000） */
+    ROBINHOOD_LONGETF_DEPLOY_VAULT: 3000000n,
+    /** LONGETF long.xyz create() */
+    ROBINHOOD_LONGETF_LAUNCH: 3000000n,
+    /** LONGETF factory register */
+    ROBINHOOD_LONGETF_REGISTER: 500000n,
+    /** pons v2 launchToken / launchAndBuy */
+    ROBINHOOD_PONS_LAUNCH: 3000000n,
 };
 // ============================================================================
 // Gas 相关配置