Documentation
Token Lifecycle
1. Creation
Anyone with a Pentagon Games VIP2+ account can create a social token. The creation fee is pulled from the factory contract on-chain (currently 10 PC). When you create a token, the factory deploys:
- Your ERC-20 social token (100M supply)
- A bonding curve contract for public funding
- Built-in friends system (up to 5,000 friend slots)
2. Token Distribution
3. Funding (Bonding Curve)
60% of tokens are allocated to the bonding curve. Anyone can send PC to buy tokens. The price increases as more PC flows in (hyperbolic curve). Early buyers get significantly more tokens per PC.
Funds are locked in the smart contract. There is no way for the creator to withdraw funds before graduation.
4. Graduation
When the bonding curve accumulates enough PC (the graduation threshold), it automatically:
- Creates a liquidity pool on PentaSwap (Pentagon Chain DEX)
- Pairs remaining tokens with the accumulated PC
- Burns a portion of unsold tokens
- The token becomes freely tradeable on PentaSwap
Friends System
How Friend Requests Work
Each social token has a built-in friends system. When someone sends you a friend request and you approve it, they automatically receive 1,000 of your tokens.
Where Do Tokens Go?
- If the friend has a connected external wallet (MetaMask/Rabby): tokens are transferred to their external wallet automatically
- If no external wallet: tokens stay in their Pentagon internal wallet
- After graduation, tokens can be traded on PentaSwap
NFC Card Tap
Token creators can use Pentagon NFC cards for instant friend connections. When someone taps the card, the friend request is automatically created and approved, instantly airdropping tokens.
Token Ownership & Management
There are two ways to manage your social token's friend approvals:
Option A: Backend-Managed (Recommended)
Transfer your token's ownership to your Pentagon internal wallet. This allows the Pentagon backend to automatically process friend approvals when you click "Approve" on the manage page. No manual transactions needed.
transferOwnership(your_internal_wallet_address) from your current owner wallet. Your internal wallet address is shown in your Pentagon Games account settings.Option B: Self-Managed (Fully Decentralized)
Keep ownership on your personal wallet (MetaMask, Rabby, etc). Approve friends by signing transactions directly from your browser wallet. You maintain full control, no backend access to your token.
acceptFriend() transactions directly from your browser. (Coming soon)💡 For most users, Option A is easier. You click "Approve" and the backend handles everything. Option B is for users who want full decentralized control over their token.
Get PC (Pentagon Coin)
You need PC to pay gas fees and create tokens on Pentagon Chain. Here's how to get it:
1. Buy PC on Uniswap (Ethereum)
Swap ETH for PC on Uniswap. PC is listed as "Pentagon Coin" on Ethereum mainnet.
2. Bridge PC to Pentagon Chain
Use the Pentagon Bridge to transfer PC from Ethereum to Pentagon Chain. Takes ~5 minutes.
3. Claim from Faucet (VIP Only)
Pentagon Discord VIP members can claim free PC from the faucet. Join Pentagon Discord and reach VIP status.
Token Utility — What Can You Do?
Your social token is more than a tradeable asset. Here's what you and your network can do with it:
🤝 Build Your Social Network
Friends who join earn 1,000 tokens. With NFC cards, tap to instantly connect and share tokens. Your friend also gets gas (PC) sponsored by Pentagon to get started.
💰 Trade on PentaSwap
After graduation, your token trades freely on PentaSwap. Anyone can buy/sell. Price is driven by market demand.
🎁 Tip in Spatial Worlds
Your token becomes a tipping currency in Pentagon's spatial network (PenXR). Tip creators, friends, and content you love with your personal emoji token.
🤖 Power Agent Functions
Tie your token to AI agent capabilities. Holders can access exclusive agent features, tools, or content gated by your token.
👥 Follow Bonus (Coming Soon)
5% of token supply is reserved for followers. NFC card holders and VIP1+ members can follow you and earn tokens. Up to 5M followers can share this pool.
📈 Back Creators Early
Fund someone's bonding curve early to get more tokens per PC. If they succeed, your tokens increase in value. Support the people you believe in.
Token Lock & Graduation
When a token is created, 60% of the supply is locked in the bonding curve smart contract. These tokens cannot be withdrawn until the graduation threshold is reached. Once graduated, liquidity is permanently deployed to PentaSwap. The remaining ~20% owner share is also initially locked and becomes tradeable after graduation. This protects early buyers from rug pulls.
Pentagon Chain Setup
Pentagon Chain is an EVM-compatible blockchain. Add it to your wallet: