CHIMERA PROTOCOL / V4 SPECIFICATION

Protocol
docs.

The product, economics, contract architecture, and safety properties behind Chimera NFT + token campaigns.

NETWORKINK / CHAIN 57073STATUSPRE-DEPLOYMENTARCHITECTUREUNISWAP V4
01

Overview

Chimera launches an NFT collection and a fungible project token as one connected market. NFT mints create authenticated token buys, token output becomes an NFT-bound position, and trading fees circulate back to the platform, creator, NFT holders, and protocol-owned liquidity.

01 / LINKED ASSETSNFT ownership controls the unsold token position.

The entitlement follows the NFT through every secondary transfer.

02 / LOCKED OPENINGPublic trading begins only after NFT #1,000.

Before sellout, only authenticated mint-router curve buys can execute.

03 / PERMANENT DEPTHLiquidity can be added but never removed.

The shared LP vault owns every v4 position with no removal path.

04 / FIXED SUPPLYOne billion tokens. No reserved allocation.

100% of canonical supply enters one-sided curve inventory.

02

Architecture

The factory is the root of trust for campaign creation. Shared routers and the LP vault authorize only factory-created campaigns; campaign-specific token, entitlement, and fee vaults isolate accounting.

DEPLOYMENT ROOTChimeraFactoryV4Creates, initializes, registers
FACTORY AUTHORIZATION
CAMPAIGNCampaignV4NFT mint + lifecycle
MARKETV4 HookPhase + fee enforcement
POSITIONLP VaultAdd-only custody
ROUTINGMint RouterAuthenticated buys
ROUTINGClaim RouterEntitlement sales
ACCOUNTINGFee VaultETH-first claims
POSITIONEntitlement VaultNFT-bound backing
PRICE SAFETYOracle GuardFresh dual-feed price
UNREGISTEREDPRELAUNCH LOCKEDOPENINGLIVEPAUSED
BEACON BOUNDARY

Standard campaigns use OpenZeppelin BeaconProxy instances controlled through ChimeraCampaignBeacon. The hook is immutable and versioned; its CREATE2 address encodes the enabled v4 callback flags.

03

New collection lifecycle

01

Campaign creation

The factory deploys the NFT campaign, canonical token, entitlement vault, fee vault, SeaDrop shim, and protocol-owned v4 position.

02

Each $25 mint

$5 becomes a 50/50 platform and creator fee. The remaining $20 executes one authenticated exact-input token buy.

03

Entitlement recorded

Actual token output—not a fixed allocation—is deposited and keyed to that NFT's token ID. Earlier mints receive more tokens.

04

Sellout opens the pool

The 1,000th mint atomically opens public trading and starts the collection-wide 30-day restricted-sale fee clock.

05

Full position becomes sellable

There is no quantity vesting. The entire unsold entitlement is available through the claim router under the decaying fee.

GROSS SELLOUT$25,000
PLATFORM$2,500
CREATOR$2,500
CURVE BUYS$20,000
04

Existing collection launch

Legacy mode adds a token layer to an already deployed ERC-721 collection. It creates no new NFT, entitlement vault, lockup, or post-launch seller vesting period.

CURRENT NFT HOLDER2%

Standard fee from block one

An originating EOA holding at least one NFT from the configured collection receives the standard rate on buys and sells. Additional NFTs do not change the discount.

NON-HOLDER40% → 2%

Anti-sniper launch decay

The fee holds at 40% for three minutes, then follows interpolated three-minute halvings until reaching the permanent 2% floor near 16 minutes 12 seconds.

40%0–3M
20%6M
10%9M
5%12M
2.5%15M
2%~16M 12S
LIVE ELIGIBILITY

Holder status is read through the collection's `balanceOf` function at transaction time. There is no maintained whitelist. Reflection claims belong to whoever currently owns each NFT.

05

Fees

Every trading fee uses one split

50%Platform1.00% of a standard trade
22.5%Creator0.45% of a standard trade
17.5%NFT reflections0.35% of a standard trade
10%LP compound0.20% of a standard trade
ACTIVITYFEEDESTINATION
NFT mint20%50% platform / 50% creator
Authenticated mint buyExemptFull $20 reaches the curve
Public buy or sell2%Four-way trading split
NFT entitlement sale40% → 2%Four-way trading split
Legacy holder trade2%Four-way trading split
Legacy non-holder trade40% → 2%Four-way trading split
ENTITLEMENT SALE DECAY

Day 0.0

40.00%
OPEN / 40%DAY 30 / 2%
Platform20.000%
Creator9.000%
Reflections7.000%
LP compound4.000%
fee(day) = 40% − (38% × day / 30)
06

NFT-bound entitlements

ERC—721#042Current ownership key
ENTITLEMENT POSITION
ORIGINAL8.4M
SOLD1.7M
REMAINING6.7M
  • 01

    Actual curve output is recorded when the NFT is minted.

  • 02

    Canonical backing remains in the entitlement vault until sold.

  • 03

    The current NFT owner controls release through the claim router.

  • 04

    Partial sales permanently debit the token ID's remaining balance.

  • 05

    Unsold tokens follow the NFT without restarting the 30-day decay clock.

  • 06

    No detachable or transferable claim token exists.

canonical balance
  ≥ total recorded entitlement
  − total sold entitlement
07

Liquidity + claims

LP COMPOUNDING

Trading makes the market deeper.

Ten percent of each trading fee accumulates as WETH. A guarded creator or guardian call releases a selected amount, swaps half into project tokens, and adds both assets to the original v4 position.

LP WETH50% TOKEN+50% WETHPOSITION
FEE CLAIMS

Recipients receive native ETH.

Fees accrue in WETH for deterministic accounting. Platform, creator, and reflection claims unwrap at payout. A recipient contract that rejects ETH automatically receives WETH instead.

WETHUNWRAPETH/WETH FALLBACK
24H

Reflection streaming period

New NFTs checkpoint a cumulative per-NFT index so later mints cannot claim historical value. Legacy launches divide by the launch-time collection supply, with each current token owner controlling that token ID's claim.

08

Safety properties

POOLLiquidity removal and donations always revert.beforeRemoveLiquidity → REVERT
PRELAUNCHOnly exact-input WETH buys from the mint router execute.sender == mintRouter
SWAPSExact-output is rejected until gross-up logic is separately audited.amountSpecified < 0
FEESEvery WETH fee removed from a swap must reach the fee vault.swap delta == vault receipt
ENTITLEMENTDebited entitlement, released backing, and swap input are equal.debit == release == input
ORACLEMints and compounding require fresh, agreeing price feeds.primary ≈ fallback
9Hardhat tests
13Forge tests
10KRuns / fuzz test
100KInvariant calls
0Production audit vulnerabilities
MAINNET GATE

Automated tests are not an external audit. Production deployment remains blocked pending an independent hook/economic audit, confirmed OpenSea production configuration, and final governance, treasury, timelock, and signer inputs.

09

Contract reference

DEPLOYMENT

ChimeraFactoryV4

Creates standard and legacy campaigns and registers their v4 pools.

contracts/ChimeraFactoryV4.sol
CAMPAIGN

ChimeraCampaignV4

ERC-721 mint lifecycle, authenticated buys, opening, royalties, and compounding.

contracts/ChimeraCampaignV4.sol
CAMPAIGN

ChimeraLegacyCampaignV4

Immediate-live token campaign attached to an existing ERC-721 collection.

contracts/ChimeraLegacyCampaignV4.sol
MARKET

ChimeraV4Hook

Pool phases, router authorization, fee selection, and fee collection.

contracts/ChimeraV4Hook.sol
CUSTODY

ChimeraLPVault

Permanent add-only ownership of every protocol v4 liquidity position.

contracts/ChimeraLPVault.sol
ROUTING

ChimeraMintRouter

Factory-authorized exact-input curve buys during NFT minting.

contracts/router/ChimeraMintRouter.sol
ROUTING

ChimeraClaimRouter

NFT-owner authorized sales of remaining entitlement positions.

contracts/router/ChimeraClaimRouter.sol
ACCOUNTING

ChimeraEntitlementVault

Canonical backing and NFT-token-ID-specific remaining balances.

contracts/primitives/ChimeraEntitlementVault.sol
ACCOUNTING

ChimeraFeeVault

Trading split, LP accrual, reflections, and ETH-first claims.

contracts/primitives/ChimeraFeeVault.sol
SAFETY

ChimeraOracleGuard

Fresh dual-feed pricing, deviation checks, and sequencer health.

contracts/primitives/ChimeraOracleGuard.sol
10

Deployment status

NO PUBLIC DEPLOYMENT RECORDED

Contracts are tested.
The mainnet gate remains closed.

The deployment script requires canonical WETH, oracle, SeaDrop, treasury, governance, and timelock addresses. It mines the hook permission-bit address, freezes configuration, transfers shared component ownership to the factory, and writes a network-specific manifest.

External auditPENDINGProduction SeaDrop policyPENDINGGovernance recipientsPENDINGFactory deployment manifestPENDING