One recipient
One LinkedIn or GitHub profile per new token.
Create a token, name one recipient, verify a profile and receive creator revenue. A complete user guide with technical details and API reference.
PaidIn lets communities direct creator revenue toward builders: an early startup, an open-source developer, a robotics team member or someone building a useful product. The launcher chooses one LinkedIn or individual GitHub profile. That recipient verifies ownership and binds a payout wallet when ready.
One LinkedIn or GitHub profile per new token.
The default allocation of collected creator revenue.
Supports operations and sponsored payouts.
New launches use Four.meme on BNB Chain and pump.fun on Solana. The form offers the networks this deployment can use. “Soon” means a route is not available yet. Read the final allocation before approving: EVM values come from the registry; Solana uses the platform allocation described here.
Revenue depends on eligible activity and collection. Token creation, volume or market cap does not guarantee income. The token does not represent equity in the recipient’s company or grant rights to its products.
Swipe sideways to read the full table.
| Role | What you need | What you control |
|---|---|---|
| Launcher | EVM wallet with BNB, or Solana wallet with SOL for network costs. | Token details, recipient at launch and your project proposal after wallet proof. |
| Recipient | Named LinkedIn/GitHub account and compatible payout wallet. | Profile, payout wallet, privacy, statement and updates. |
| Trader / visitor | Wallet to trade; no profile login to browse. | Your trading decisions. Inspect addresses, allocation and project material. |
Launching does not require social sign-in. Wallet connection and profile verification are separate: a connected trading wallet does not prove ownership of a social account.
PaidIn prepares a Four.meme tax token with founder revenue directed to a dedicated PaidIn vault. The vault records the beneficiary and platform allocation before token creation. The token follows Four.meme’s bonding curve and migration lifecycle.
The login message is not token creation. The vault and token calls are transactions. PaidIn checks token details, tax recipient, first buy and launch fee. Simulation reduces avoidable errors but does not guarantee execution or resolve wallet security alerts.
A vault can exist while token creation is incomplete. Prepared-launch recovery refreshes the request only after checking the original creator, token details and on-chain allocation. Resume that launch; another beneficiary cannot repurpose its vault.
Four.meme controls tax collection, conversion and dispatch. Upstream revenue is not immediately claimable from PaidIn. BNB and WBNB received by the vault follow its accounting; WBNB is unwrapped on payout.
Solana uses pump.fun with SOL or USDC as quote asset. Revenue routes to the recipient’s PaidIn escrow and platform account. GitHub recipients use this same escrow route, not pump.fun’s separate social-account claim product.
Coin creation and revenue locking have separate completion states. A pending lock is shown on the token page with a retry. Retrying uses the recorded allocation; it does not create another token or beneficiary.
Pre-lock fees remain attributable to the launch creator account. Recovery routes them to the recorded accounts after locking. Scheduled and claim-time collection distribute protocol revenue. Trading may occur before an escrow balance appears.
The route covers the graduated market when the relevant collection/distribution instructions succeed. Revenue waiting inside the protocol differs from funds already in the recipient escrow.
Swipe sideways to read the full table.
| Term | Meaning |
|---|---|
| Volume | Total traded amount; not the recipient payout amount. |
| Creator revenue | Protocol creator fees or configured founder tax revenue. |
| Routed revenue | Revenue recognized or delivered through the recorded route; collection may follow the trade. |
| Recipient allocation | Recorded beneficiary portion; default 90%. |
| Platform allocation | Default 10% to PaidIn, separate from network and protocol fees. |
| Claimable | Currently payable vault/escrow balance, subject to wallet state, minimums and execution. |
BNB revenue waits in the token vault. Solana distributions pay a recipient escrow that gathers the profile’s revenue. Unverified ownership or a missing wallet does not redirect it to the launcher.
The beneficiary reference and allocation are fixed. Page editing, account verification and wallet changes cannot select another beneficiary. Existing tokens keep their recorded allocations.
A public username lookup is designation, not proof. Usernames can change or be reused; the numeric ID preserves the same account’s reference after renaming.
Login requests public data only, with no private repository/private email access. The OAuth token is not retained after checking the user. Organization and repository recipients are unsupported; choose an individual maintainer.
Sign-in identifies the account but does not itself confirm the public profile URL a launcher entered. Review establishes that relationship. Display-name/email matching is insufficient; LinkedIn and GitHub identities are not automatically merged.
Swipe sideways to read the full table.
| State | Meaning |
|---|---|
| Provisional | Named, ownership not verified; not a participation badge. |
| Connected / Verified owner | Control matched to the signed-in account. |
| Review pending | LinkedIn claim awaiting review. |
| Not joined | No recipient participation published, even if ownership is verified. |
The payout wallet receives fees and may differ from launcher/trading wallets. Sign in as verified owner, select Bind a payout wallet, choose the network and connect a wallet you control. Read the address, profile, network and expiry before signing; wait for confirmation.
The EIP-712 message contains reference, wallet, registry, chain, nonce and expiry. The identity server provides a separate signature; the registry checks both. PaidIn’s relayer pays for binding. One registry’s signature is not universal network authorization.
Swipe sideways to read the full table.
| Network | First binding | Change | Cancel |
|---|---|---|---|
| BNB / EVM | Successful registry transaction. | Registry delay shown in app; payments may pause. | Use current bound wallet. Cancellation is a transaction and may cost gas. |
| Solana | Accepted signed message. | Different wallet waits 24 hours. | Bind current wallet again during the waiting period. |
Claim can finalize an EVM change after its delay. Freeze or forced-rebind states may still block payment. The app checks actual registry state.
Email alerts require an available email and configured notification service. GitHub login collects no private email, so GitHub recipients must not rely on email wallet-change alerts.
The server checks ownership, confirmed launch, vault allocation and registry wallet, simulates the claim and estimates gas. The current sponsored minimum is five times estimated gas cost. Smaller balances remain recorded.
PaidIn collects/distributes eligible revenue, resolves the effective wallet and transfers escrow balances. Minimums are currently 0.001 SOL or 1 USDC per asset. A USDC associated account may need setup.
Solana escrow keys are held by PaidIn’s server, requiring trust in key management and service availability. EVM balances remain in contracts following vault/registry rules. These custody models differ.
Pending/failed requests and “nothing waiting” are not proof of payment. Verify amount and destination in the confirmed record. Operation locks and recorded intents protect against duplicate in-flight requests.
Launcher proposals and recipient statements are distinct contributions. A proposal can precede recipient participation; the page shows that status clearly.
Swipe sideways to read the full table.
| Area | Editor | Content |
|---|---|---|
| Proposal | Recorded launcher after wallet proof. | Headline, summary, story, funding plan, YouTube and images. |
| Statement | Verified owner. | Their explanation and optional joining. |
| Updates | Verified recipient who joined. | Dated progress posts. |
| Allocation / address | Recorded launch and chain state. | Page editing cannot change beneficiary, allocation, wallet or contract. |
Choose “I created this token · edit” and sign with the recorded creator wallet. The message names the site, token, network, wallet, nonce and expiry. It authorizes one hour of editing, not a payment. The challenge expires after five minutes and is single-use.
Published material is saved on the server and loads in future editor sessions. Version checks prevent a stale form from silently overwriting a newer revision.
Paste a valid HTTPS YouTube video link. PaidIn normalizes its ID and embeds the player, not arbitrary HTML. Removed, restricted or embedding-disabled videos may not play.
Upload up to four PNG/JPG/GIF/WebP images, at most 4 MB each. Captions are optional. File bytes/formats are validated; external image URLs do not replace uploads.
After verification, use Manage my statement. Joining requires a statement; updates belong to that account. Claiming does not require joining, agreeing with the launcher’s story or posting updates.
Use the full address, network, explorer and launchpad links on a confirmed token page. Names/tickers are not unique identifiers.
Before Four.meme migration, trading follows its curve. The app links to that market if a DEX chart is unavailable. DexScreener charts require an indexed supported pair. A missing chart does not automatically mean launch failure.
Graduation and third-party indexing are separate. PaidIn cannot guarantee terminal listing speed or availability. “Liquidity data unavailable — trade blocked” means a route’s liquidity was not established; it does not describe recipient fee balances.
Quotes, cap, volume and progress may be delayed/unavailable. A dash means missing data; zero is numeric. Revenue and volume measure different things.
Show me in discovery controls public name/photo and profile search. Allow new launches to name me controls future designation. Neither rewrites transactions or cancels recorded revenue.
LinkedIn provides account identity, name, photo and email through configured permissions. GitHub provides public ID, username, name and avatar. Verified identity authorizes profile changes and claims.
The chain stores an internal-ID-derived reference, not name/email. Public pages may associate it with a profile; it does not make participation anonymous. Wallets/transactions remain public and third-party copies may persist. Read Terms & privacy.
Swipe sideways to read the full table.
| Request | Purpose | Check |
|---|---|---|
| Four.meme login | Authenticate preparation. | Expected message and wallet. |
| Token/vault transaction | Create token or vault. | Network, destination, value, details, allocation. |
| Payout-wallet message | Authorize your destination. | Profile reference, address, registry, expiry. |
| Editor message | Temporary editing. | Site, token, network, wallet, purpose. |
Ownership verification is not a project audit or endorsement. A wallet alert can concern site, address or behavior; simulation and official addresses do not clear it. Cancel a flagged request, inspect its details and report incorrect classification through your wallet. No warning-free guarantee is made.
PaidIn manages matching, signer/relayer keys, deployment settings, abuse review and sponsored operations. EVM administration manages signers, admin settings, delays and emergency controls according to the contract; it cannot edit locked vault beneficiaries/allocations.
Solana operations manage creator setup, distributions and escrow keys. Service/RPC outages can delay refreshes or payments. Address publication is not an independent audit certificate.
The Four.meme factory creates a dedicated vault recording beneficiary and platform allocations. It accepts BNB/WBNB revenue and reads the registry for the effective wallet. Use the token page’s confirmed vault links.
The registry tracks binding, nonce, pending wallet and emergency state. Its EIP-712 domain isolates chain/registry authorization. A reference is keccak256(abi.encode("paidin.ref.v1", recipientId)).
PaidIn addresses come from this server. Compare them with GET /api/v1/chains and the launch review.
Swipe sideways to read the full table.
| Network | Purpose | Address |
|---|---|---|
| BNB | PaidIn Four.meme registry | 0x2e99d9dee89388a88e3792b99125f0410ae3896d ↗ |
| BNB | PaidIn vault factory | 0x36C9BF1140E89Da99BC93fD9c9eEED8F47e2Ae0e ↗ |
| BNB | Four.meme TokenManager | 0x5c952063c7fc8610ffdb798152d69f0b9550762b ↗ |
| BNB | WBNB | 0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c ↗ |
| Solana | pump.fun program | 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P ↗ |
| Solana | Pump Fees program | pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ ↗ |
Existing Flap/Clanker tokens keep their protocol, vault and registry. They do not become Four.meme tokens. Inspect their actual page and addresses. Legacy endpoints may remain present while new launches are disabled; endpoint presence is not launch availability.
Paths are relative to /api/v1. JSON writes use Content-Type: application/json; uploads/launch forms use multipart. Protected writes require session, proof and same-site checks. Secrets, signing keys and relayer keys belong only on the server.
Swipe sideways to read the full table.
| Endpoint | Access | Purpose / input |
|---|---|---|
GET /chains | Public | Network addresses, launch/wallet readiness, platform allocation and rebind delay. |
GET /me | Public / session | Current identity, verified profiles and available sign-in providers. |
GET /auth/{linkedin|github}/start?next=/claim | Public | Start sign-in. Return paths must belong to this site. |
GET /auth/{linkedin|github}/callback | OAuth callback | Validate sign-in state and create a session; do not open manually to start login. |
POST /auth/logout | Session | End the profile session. |
POST /recipients/resolve | Public | Resolve { input, provider }. Provider is LINKEDIN or GITHUB; omitted provider defaults to LINKEDIN. |
GET /recipients/search?q=… | Public | Find discoverable profiles; public lookup does not prove ownership. |
GET /recipients/{id} | Public | Public information allowed by privacy settings. |
POST /recipients/claim | LinkedIn session | Request review with { input }. GitHub matches during sign-in. |
POST /recipients/{id}/preferences | Owner session | Update discovery and new-launch consent with { hidden?, acceptNewLaunches? }. |
POST /launch/four/nonce | Launcher wallet | Request the Four.meme login message with { wallet }. |
POST /launch/four/prepare | Launcher signature | Multipart form: one recipient, image, token details, loginMessage and loginSignature. Returns vault and token calls. |
POST /launch/four/confirm | Receipt validation | Verify { chain, launchId, txHash } against token, vault and recorded allocation. |
POST /launch/pump/prepare | Launcher wallet | Multipart form: one recipient, image, details, quote and optional initial buy. Builds and simulates the launch. |
POST /launch/pump/submit | Signed transaction | Send { launchId, transaction }; transaction is base64. Validate and submit the prepared transaction, then attempt the revenue lock. |
POST /launch/pump/lock | Public retry | Retry the recorded lock with { launchId } or { token }, without choosing a new recipient. |
POST /wallet/bind/prepare | Owner session | Prepare EVM binding with { chain, recipientId, wallet }. |
POST /wallet/bind/submit | Owner + wallet signature | Submit the ticket and wallet signature; relayer sponsors the registry transaction. |
GET /wallet/bind/status | Owner session | Current, pending and frozen binding state for chain and recipientId. |
POST /wallet/solana/prepare · /submit | Owner + wallet signature | Prepare/verify the Solana binding message and record its effective time. |
GET /earnings | Owner session | Named tokens, available revenue, wallet status and escrow balances. |
POST /earnings/claim | Owner session | Claim an EVM share with { launchId, idx }; destination comes from the registry. |
POST /earnings/claim-solana | Owner session | Claim the owned Solana escrow with { recipientId }. |
GET /projects/{chain}/{address} | Public / session | Read proposal, statement and visitor editing permissions. |
POST /projects/{chain}/{address} | Role-dependent | Actions: challenge, verify, proposal and member. Each action checks its required proof. |
POST /projects/{chain}/{address}/images | Launcher editor | Upload a validated project image. |
POST /api/v1/recipients/resolve
Content-Type: application/json
{ "provider": "GITHUB", "input": "username" }
// JSON string in the multipart launch form:
recipients = [{ "id": "resolved-recipient-id", "bps": 9000 }]This uses the default 90% in basis points; read the selected network’s allocation. Resolution returns id, refHash, provider, URL and public connection state, not claim/edit authorization. Do not alter prepared destinations, values or parameters; confirmation checks actual chain results. Administrative/scheduled endpoints require service authorization.
Swipe sideways to read the full table.
| Item | Limit |
|---|---|
| Recipient | One LinkedIn or individual GitHub profile. |
| Four.meme name | 20 characters. |
| Solana name | 32 characters. |
| Ticker | 1–10 letters/digits. |
| Launch description | 256 characters plus attribution metadata. |
| Image | PNG/JPG/GIF/WebP, 4 MB. |
| Project images | Four, 4 MB each; captions 160 characters. |
| Proposal | Headline 100; summary 220; story 5,000; funding 2,000; YouTube URL 500 characters. |
| Editor | Five-minute challenge; one-hour session. |
| Wallet request | Ten-minute expiry. |
| Launch preparation | Six per ten minutes per visitor. |
| EVM claims | Twenty/hour/identity; minimum five times gas cost. |
| Solana claims | Ten/hour/identity; minimum 0.001 SOL or 1 USDC per asset. |
| LinkedIn review | Ten requests/hour/identity. |
Network fees, rent and protocol charges change; inspect the prepared request and wallet review. Production rate counters use the shared database; local development has a fallback. Limits do not guarantee transaction success.
Swipe sideways to read the full table.
| What you see | Next step |
|---|---|
| Soon | Use an available network; this deployment cannot prepare that route. |
| Provisional | Connect the correct GitHub account or complete LinkedIn review. |
| GitHub not found | Use an individual username/profile URL, not repository/organization. |
| Wrong account | Switch profile or sign out and choose the named account. |
| Expired signing request | Prepare fresh authorization; do not reuse the ticket. |
| Wallet change pending | Wait for effective time or cancel with the current-wallet flow. |
| No earnings | Check beneficiary, collection state and prior payouts. |
| Too small | Allow revenue to reach the applicable minimum. |
| Vault only | Resume the original prepared Four.meme launch. |
| Solana lock pending | Retry its recorded lock and check confirmation. |
| No chart/listing | Check full address, launchpad market, migration and indexing. |
| Save conflict | Load the latest revision and reapply edits. |
| Payout hold | Inspect binding state and seek review; repeated clicks cannot bypass a freeze. |
Errors return an error message: 401 sign in; 403 forbidden; 404 unknown record; 409 conflict/pending; 410 expired; 413 too large; 422 invalid input; 429 rate limit; 502/503 service/upstream unavailable.
Report page URL, network, token address, public transaction hash and visible error. Never include private keys, OAuth codes, secrets, session cookies or recovery phrases.
Yes; launching uses your wallet. The beneficiary verifies their account to claim.
No; provisional designation can precede registration. Verification and a payout wallet are required to claim.
No. A wallet change updates the same recipient’s destination.
No; choose an individual maintainer’s GitHub account.
No; ownership and project participation are separate.
No; the verified recipient controls it.
Yes, if valid and available for embedding.
No; participation and updates are optional.
Volume is traded amount; earnings are eligible revenue collected/distributed.
No; revenue depends on protocol activity and collection.
Launch confirmation and external indexing are separate.
Their recorded protocol, allocations and payout rules remain in effect.
This guide describes PaidIn. Upstream references explain protocol mechanisms; they do not verify ownership or certify a PaidIn deployment.