Robinhood Chain Integration Guide

TL;DR for terminal/bot integrators — everything you need is in the table below. Skip the rest of the doc unless you need more context.

Quick Reference

Deployed contract addresses (Robinhood Chain)

Full cross-chain address list: Deployed Contract Addresses.

Bonding curve parameters

Native ETH (address(0)) is currently the only enabled quote token on Robinhood Chain, for both token types. Always confirm live config before integrating (see §2 below).

Required launch params by token type

1. Token Versions & Launch Details

Non-Tax Token

The only entry point that reaches the non-tax implementation on Robinhood Chain is:

function newTokenV5(NewTokenV5Params calldata params) external payable returns (address token);

IPortalTypes.NewTokenV5Params memory p;
p.name = "My Token";
p.symbol = "MTK";
p.meta = "";
p.dexThresh = IPortalCommonTypes.DexThreshType.FOUR_FIFTHS;
p.salt = salt; // vanity salt targeting the 8888 suffix
p.taxRate = 0;
p.migratorType = IPortalTypes.MigratorType.V2_MIGRATOR;
p.quoteToken = address(0);
p.quoteAmt = 0;
p.beneficiary = msg.sender;
p.dexId = IPortalTypes.DEXId.DEX0;
p.lpFeeProfile = IPortalTypes.V3LPFeeProfile.LP_FEE_PROFILE_STANDARD;
p.antiFarmerDuration = 1 days;

address token = portal.newTokenV5(p);

Public interface:

interface IFlapNonTaxToken {
    function initialize(InitParams memory params) external;
    function removeTransferConstraints() external;      // owner-only, called by the migrator
    function metaURI() external view returns (string memory);
    function maxSupply() external view returns (uint256); // 1,000,000,000 ether for all launches
    function pools() external view returns (address v2, address v3);
    function antiFarmerExpirationTime() external view returns (uint256);
}

Tax Token V3

function newTokenV6(NewTokenV6Params calldata params) external payable returns (address token);

Robinhood Chain only accepts tokenVersion == TOKEN_TAXED_V3 with migratorType == V2_MIGRATOR on this entry point — any other combination reverts with FeatureDisabled().

2. Curve

Verify the live configuration on-chain before integrating (applies to both token types, since both currently use the same native-ETH quote config):

IPortalTypes.QuoteTokenConfiguration memory config = portal.getQuoteTokenConfiguration(address(0));
require(config.enabled == 1, "native ETH quote not enabled");
require(
    uint8(config.defaultCurve) == uint8(IPortalCommonTypes.CurveType.CURVE_RH_TOSHI_5ETH),
    "unexpected curve"
);

Bonding curve lifecycle (pre-graduation)

While a token is in its pre-graduation phase, all transfers to or from any registered pool are blocked. Only wallet-to-wallet transfers are allowed — this prevents any DEX liquidity provisioning or direct pool interaction before the token has graduated.

Buys and sells go through the standard Portal trade path:

uint256 tokensOut = portal.swapExactInput{value: ethIn}(
    IPortalTradeV2.ExactInputParams({
        inputToken: address(0),
        outputToken: token,
        inputAmount: ethIn,
        minOutputAmount: 0,
        permitData: ""
    })
);

Graduation occurs automatically once the configured DexThreshType supply fraction has been sold on the curve (default FOUR_FIFTHS, i.e. 80% of supply):

IPortalTypes.TokenStateV8Safe memory state = portal.getTokenV8Safe(token);
bool graduated = state.status == IPortalTypes.TokenStatus.DEX;

Observed graduation depth for the non-tax token (verified against the live Robinhood RPC, 1 ETH buy steps): graduation consistently occurs at the 6th buy round, just above 5 ETH cumulative spend.

3. Migration

Both supported token types (Non-Tax, Tax V3) migrate exclusively to Uniswap V2 via V2_MIGRATOR — no other migrator type is accepted on this chain.

Why the non-tax token is V2-only: its mainPool is set to the Uniswap V2 pair address at initialization. During the post-graduation anti-farmer window, only mainPool is exempt from the pool-transfer block (see below). A V3/V4 migration would need to LP into a different, non-exempt pool address, which the anti-farmer check would then block — causing the migration itself to revert.

Migration flow (non-tax token)

1. Graduation trigger — once bonding-curve supply crosses the DEX threshold, the Portal migrates the token's liquidity to a Uniswap V2 pool.
2. Transfer-constraint release — the migrator calls IFlapNonTaxToken(token).removeTransferConstraints() (owner-only). This starts the anti-farmer expiry countdown (antiFarmerExpirationTime = now + antiFarmerDuration).
3. LP provisioning — the remaining token balance and collected ETH reserve are added to the Uniswap V2 pair (mainPool), which is exempt from the anti-farmer block.

Anti-farmer enforcement (non-tax token, post-graduation)

This is a hard revert, not a tax — the non-tax token has no fee mechanism at all.

uint256 expiry = IFlapNonTaxToken(token).antiFarmerExpirationTime();
bool antiFarmerActive = expiry != 0 && block.timestamp <= expiry;

(address v2Pool, address v3Pool) = IFlapNonTaxToken(token).pools();

Scope limitation: the block only applies to pools registered at initialization time — an address outside that set is not tracked and is not blocked. Anti-farmer here raises friction on the known/expected venues; it does not prevent farming through arbitrary unlisted pools.

Trading after graduation

Once the anti-farmer window has expired (or when routing through mainPool, which is always exempt), trading is a normal Uniswap V2 swap. Continuing to route through the Portal also works:

uint256 tokensOut = portal.swapExactInput{value: ethIn}(
    IPortalTradeV2.ExactInputParams({
        inputToken: address(0),
        outputToken: token,
        inputAmount: ethIn,
        minOutputAmount: 0,
        permitData: ""
    })
);

Reference

• Deployed addresses: Deployed Contract Addresses