A pet whose vitals are a
function of your on-chain PnL
GotchiPets is a GameFi primitive on Solana. Each pet is a wallet-bound asset whose health, hunger and mood are continuously re-derived from your wallet's realized trading performance, and whose survival gates a pro-rata claim on a creator-fee treasury.
A simulated 14 day run. Green days lift health; red days drain it.
Each realized day either feeds or starves your pet.
Share is vitality weighted across all live pets.
01Gasless authentication (SIWS)
You authenticate with Sign-In With Solana: the wallet signs a nonce-bound message and the server verifies the ed25519 signature. No transaction, no gas, no token approval, and the protocol never holds your keys. Your address is your identity; there are no passwords.
02Mint a wallet-bound pet
Adopting mints a pet keyed to your address. Its state (species, vitals, level, lifecycle) is persisted server-side and survives across sessions and devices. Each wallet can mint exactly one pet, ever, which keeps the vitality denominator honest.
03An indexer reads your trading activity
On each sync, the protocol pulls your wallet's recent performance via Birdeye and resolves balances via Helius RPC. This realized PnL is the sole input that feeds the vitals state machine, so the pet is genuinely indexed to your trading, not a random walk.
04Vitals settle deterministically
Given (previous vitals, elapsed time, PnL%), the engine settles four values:
Tracks sustained performance. Realized losses damage it; prolonged starvation drains it. Hits zero → liquidation.
Decays linearly with time. Profitable fills replenish it; losses fail to feed it.
A fast-moving reaction to your latest result, mean-reverting toward neutral.
Accrues on green sessions, unlocking a higher vitality ceiling over time.
05Vitality-weighted treasury distribution
Creator fees from the project's pump.fun token stream into the treasury, whose balance is read live on-chain via Helius. Your claim is computed as:
vitalityScore(pet) = health + level * 10
claimable(you) = treasuryBalance
* vitalityScore(yourPet)
/ Σ vitalityScore(allLivePets)The distribution re-derives on every sync, so a healthier pet always commands a larger share of the flow. Claims are gated on a live pet; a liquidated asset accrues nothing.
Composability
Because identity, vitality and treasury claims are all keyed to your Solana address rather than an internal account, a pet's on-chain track record is portable. The same wallet identity can carry into broader on-chain economies, such as Solana MMOs with dual-currency systems and player marketplaces, making GotchiPets a composable asset layer rather than a closed app.
Trust model: authentication is non-custodial. The protocol only verifies signatures and can never move your assets. Vitals are computed and persisted server-side, so pet state is tamper-resistant and cannot be edited from the client.