Ponzu Factory

PonzuV4Recipe is the factory contract. One craftPonzu call clones the per-project stack and registers the token with the chain-wide Ponzuki hook. The DEX pool is not created until graduation. The app factory defaults to a Ponzu Auction. The SDK encodes a Ponzu Curve. Both bind to the same Presale.

Path	Best For
ponzu.app	Founders who want a web UI
MCP Server	AI agents (Claude, Cursor, etc.)
SDK	Developers building integrations
Raw viem	Protocol engineers who want full control

Deploy via ponzu.app

No code required.

Prepare your assets

Token image (PNG or SVG) and a short description. The app handles IPFS upload.

Connect your wallet

MetaMask, WalletConnect, or any EVM wallet. Sepolia for dry runs (min ~0.1 sETH gross).

Configure your token

Name, symbol, vesting duration (10 days or 10 weeks). Pick Curve, Auction (1–10 Hours), or Auction (1–10 Days). Set Target ETH, Multiple, Start now or Start later. On a curve, set sniper tax. Add socials.

Deploy

One transaction. Creation fee from getCreationFee plus optional dev buy. The stack deploys atomically. Presale is live.

Canonical factory crafts set 69% presale / 31% LP, with treasury, team, and payment-vault bps at 0.

MCP Server (AI Agent Integration)

Add to your MCP config (Claude Desktop: claude_desktop_config.json, Cursor: .cursor/mcp.json):

{
  "mcpServers": {
    "ponzu": {
      "command": "npx",
      "args": ["-y", "@ponzu_app/mcp"],
      "env": {
        "PONZU_PRIVATE_KEY": "0x...",
        "PONZU_NETWORK": "mainnet"
      }
    }
  }
}

Deploy tokens, buy presales, swap, farm, claim rewards from conversation.

PONZU_NETWORK: mainnet | sepolia | robinhood
Omit PONZU_PRIVATE_KEY for read-only access
NPM: @ponzu_app/mcp

Using the SDK

npm install @ponzu_app/sdk viem

import { deploy } from '@ponzu_app/sdk'
import { parseEther, createWalletClient, createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount('0xYOUR_PRIVATE_KEY')
const wallet  = createWalletClient({ account, chain: mainnet, transport: http() })
const client  = createPublicClient({ chain: mainnet, transport: http() })

const result = await deploy(
  {
    owner:          account.address,
    tokenName:      'My Token',
    tokenSymbol:    'MYTKN',
    metadata:       'ipfs://Qm...',   // JSON: { image, description, socials }
    targetEthRaise: parseEther('5'),  // clamped to the network's grossed minRaise
  },
  wallet,
  client,
  'mainnet', // 'sepolia' | 'robinhood'
)

const tokenAddress    = result.addresses.token
const presaleAddress  = result.addresses.presale   // also the bottle NFT collection
const farmAddress     = result.addresses.farm      // zero if farmEnabled was false; SDK leaves farm on
const hookAddress     = result.addresses.hook      // chain-wide Ponzuki
const launcherAddress = result.addresses.launcher

The SDK encodes a Ponzu Curve, reads getCreationFee, and decodes PonzuCrafted. Image lives in the metadata JSON, not as a separate craftPonzu field.

Using Raw viem (No SDK)

import { decodeEventLog, encodeAbiParameters, keccak256, parseAbi, toBytes, zeroAddress } from 'viem'

const PONZU_RECIPE = '0xCF3c37C0aD2Fd94368921ff570d100119072E826' // mainnet PonzuV4Recipe

const RECIPE_ABI = parseAbi([
  'function craftPonzu((address owner, address keyContract, address transferKey, uint256 initialBuyAmount, uint256 vestingDuration, bytes32 pricingStrategyTemplate, bytes pricingStrategyData, bytes feeStrategyData, string tokenName, string tokenSymbol, string metadata, address teamAddress, uint16 paymentVaultBps, uint16 teamTokenBps, uint16 presaleBps, uint16 treasuryBps, address platformReferrer, address orderReferrer, uint128 activationRate, bool farmEnabled, bool futarchyEnabled, uint256 minRaise) params) payable',
  'function getCreationFee(bytes feeStrategyData) view returns (address feeToken, uint256 feeAmount)',
])

const PONZU_CRAFTED_ABI = parseAbi([
  'event PonzuCrafted(address indexed owner, string tokenName, string tokenSymbol, (address governor, address project, address operator, address lpVault, address memberCard, address membersVault, address token, address presale, address launcher, address distributor, address farm, address hook, address paymentVault, address teamVault, address workLock) addresses, (uint256 poolId, address pricingStrategy, address protocolFeeRecipient, address ethRewarder, bytes32 pricingStrategyTemplate, uint256 vestingDuration, uint256 presaleAllocation, uint256 midRaise, uint256 minRaise, uint256 maxBonusMultiplier, bytes pricingStrategyData) terms)',
])

Pricing Configuration

Total supply: 1,000,000. Canonical crafts sell 690,000 (69%) in presale and seed 310,000 (31%) into DEX liquidity at launch.

Ponzu Auction
Ponzu Curve

Factory default for timed sales. Caller encodes (duration, startTime, requestedBonus). The recipe fills in the rest.

const auctionDuration  = 36000n   // 3600 (1h) / 36000 (10h) / 864000 (10d)
const presaleStartTime = 0n       // 0 = start now, or a future unix second
const requestedBonus   = 5n * 10n ** 18n  // 5×; recipe binds to bonusMultiplierCap

const pricingStrategyTemplate = keccak256(toBytes('HyperbolicPricingStrategy')) // Ponzu Auction
const pricingStrategyData = encodeAbiParameters(
  [{ type: 'uint256' }, { type: 'uint256' }, { type: 'uint256' }],
  [auctionDuration, presaleStartTime, requestedBonus],
)

The target raise falls toward the floor over the duration. The sale launches when raised ETH catches that target, not when a token count sells out.

SDK default. Caller encodes (startPrice, finishPrice, startTime, snipeTaxBps). The recipe injects allocation.

const PRESALE_SUPPLY = 690_000n // when presaleBps = 6900
const targetRaise   = parseEther('5')
const endPriceWei   = (targetRaise * 20n) / (11n * PRESALE_SUPPLY)
const startPriceWei = endPriceWei / 10n

const pricingStrategyTemplate = keccak256(toBytes('LinearPricingStrategy')) // Ponzu Curve
const pricingStrategyData = encodeAbiParameters(
  [{ type: 'uint256' }, { type: 'uint256' }, { type: 'uint256' }, { type: 'uint256' }],
  [startPriceWei, endPriceWei, 0n, 0n], // startTime 0 = now; snipeTaxBps 0 = no opening premium
)

Launch on full sellout.

Deploy Transaction

const feeStrategyData = '0x' as `0x${string}`
const [, feeAmount] = await publicClient.readContract({
  address: PONZU_RECIPE,
  abi: RECIPE_ABI,
  functionName: 'getCreationFee',
  args: [feeStrategyData],
})

const params = {
  owner: account.address,
  keyContract: zeroAddress,
  transferKey: zeroAddress,
  initialBuyAmount: 0n,
  vestingDuration: 864000n, // 10 days — must be on the recipe allowlist
  pricingStrategyTemplate,
  pricingStrategyData,
  feeStrategyData,
  tokenName: 'My Token',
  tokenSymbol: 'MYTKN',
  metadata: 'ipfs://Qm...',
  teamAddress: zeroAddress,
  paymentVaultBps: 0,
  teamTokenBps: 0,
  presaleBps: 6900,
  treasuryBps: 0,
  platformReferrer: zeroAddress,
  orderReferrer: zeroAddress,
  activationRate: 0n,
  farmEnabled: true,
  futarchyEnabled: false,
  minRaise: 3_990_000_000_000_000_000n, // net floor; recipe rejects below minEthRaise
}

const hash = await wallet.writeContract({
  address: PONZU_RECIPE,
  abi: RECIPE_ABI,
  functionName: 'craftPonzu',
  args: [params],
  value: feeAmount,
})

Parse Deployed Addresses

const receipt = await publicClient.waitForTransactionReceipt({ hash })
for (const log of receipt.logs) {
  try {
    const decoded = decodeEventLog({ abi: PONZU_CRAFTED_ABI, data: log.data, topics: log.topics })
    if (decoded.eventName === 'PonzuCrafted') {
      const { token, presale, farm, hook, launcher } = decoded.args.addresses
    }
  } catch { /* not PonzuCrafted */ }
}

hook in that tuple is the chain-wide Ponzuki. The Presale is the bottle NFT collection. Liquidity cards are embedded in the Farm.

Metadata

The contract accepts any URI string — IPFS, Arweave, or https://. Image lives in the metadata JSON, not as a separate craftPonzu field. ponzu.app handles uploads automatically. For SDK or raw deploys, host these yourself.

// { image: 'ipfs://…', description: string, socials: { twitter?, discord?, website? } }
const metadata = 'ipfs://Qm...'

ABI Reference

Contract ABIs for presale, swap, farming, and factory deployment.

Getting Started

Mechanisms

Ponzu Kioke

Protocol

Legal

Deploy via ponzu.app

MCP Server (AI Agent Integration)

Using the SDK

Using Raw viem (No SDK)

Pricing Configuration

Deploy Transaction

Parse Deployed Addresses

Metadata

ABI Reference

​Deploy via ponzu.app

​MCP Server (AI Agent Integration)

​Using the SDK

​Using Raw viem (No SDK)

​Pricing Configuration

​Deploy Transaction

​Parse Deployed Addresses

​Metadata

ABI Reference

Deploy via ponzu.app

MCP Server (AI Agent Integration)

Using the SDK

Using Raw viem (No SDK)

Pricing Configuration

Deploy Transaction

Parse Deployed Addresses

Metadata