14 June: Web2 API Updates
Introducing new fee management capabilities that make revenue sharing more flexible and user-friendly.
What's New
A new endpoint for the Create a Fee Split Manager which allows you to create a reuseable contract to receive fees to multiple addresses, and an update to the existing Launch Token endpoint allowing you to pass an existing manager or an array of addresses to create a manager on the fly.
New Fee Split Recipients
Fee split managers can now be created to share the revenue between multiple wallets. Pass an array of addresses, or an array of objects with email/twitter/farcaster.
Custom Fee Split Percentages
Either pass no split percentages to have the API calculate an even split between addresses, or specify an ahoc split between them (precision up to 5 decimal places)
Multi-Format Fee Recipients
The fee split manager now supports three flexible input formats:
Legacy Format (Still Supported)
{
"treasuryType": "fee_split_manager",
"feeRecipients": [
"0x1234567890123456789012345678901234567890",
"0x0987654321098765432109876543210987654321"
]
}
// Result: 50% each
New Enhanced Format
{
"treasuryType": "fee_split_manager",
"feeRecipients": [
{ "type": "email", "id": "[email protected]" },
{ "type": "twitter", "id": "bob_crypto" },
{ "type": "farcaster", "id": "charlie.eth" },
{ "type": "wallet", "id": "0x1234...7890" }
]
}
// Result: 25% each
{
"feeRecipients": [
{ "type": "email", "id": "[email protected]", "split": "6000000" },
{ "type": "twitter", "id": "marketing_lead", "split": "2500000" },
{ "type": "wallet", "id": "0x...", "split": "1500000" }
]
}
// Result: 60%, 25%, 15% respectively
Supported Account Types:
Email: Any valid email address,
Twitter: Twitter username (with or without @),
Farcaster: Farcaster username or .eth domain,
Wallet: Ethereum wallet address (0x format)
Split Format: Percentages are specified in "micro-percentages" where:
"10000000"
= 100.00000%,"5000000"
= 50.00000%,"3333333"
= 33.33333%,
Validation Rules
The system enforces intelligent validation:
Mixed Splits Not Allowed: If ANY recipient has a custom split, ALL recipients must have splits
Perfect Sum Required: Custom splits must sum to exactly 100.00000% (10,000,000 micro-percentage units)
Recipient Limit: Maximum of 100 fee split recipients
Account Resolution: All social accounts are automatically resolved to wallet addresses via Privy.
Benefits
For Project Creators
Simplified Collaboration: Invite team members using their social accounts,
Flexible Revenue Sharing: Customize splits based on contribution levels,
Reduced Friction: No need to collect wallet addresses upfront,
Professional Management: Automated resolution and validation,
For Recipients,
Easy Onboarding: Receive revenue shares using existing social accounts,
Transparent Distribution: Clear visibility into split percentages,
Automatic Setup: Wallet addresses resolved automatically via Privy,
For Developers
Backward Compatibility: Existing integrations continue to work,
Better Error Handling: Detailed validation messages for troubleshooting,
Last updated
Was this helpful?