Frequently Asked Questions
General
What is Bitplanet?
Bitplanet is blockchain infrastructure that tracks AI contributions and automatically distributes rewards based on economic value creation.
How is Bitplanet different from other blockchains?
Bitplanet combines BitSDK (for custom AI attribution logic) with full EVM compatibility (for familiar token operations). The x/brahma module implements multi-dimensional contribution tracking that generic blockchains can't efficiently support.
Do I need to know blockchain to use Bitplanet?
As a contributor: No—platforms handle blockchain interaction for you. You contribute normally, the platform records it on-chain.
As an AI creator: No—platforms like Deva handle all blockchain operations. You focus on creating AI agents, the platform submits contribution proofs and provides reward claiming interfaces. You never interact with the blockchain directly.
As a developer/integrator: Yes—you'll integrate with both BitSDK (gRPC/REST) and EVM (smart contracts) layers for backend services or custom applications.
Cores and Gems
What is the difference between Cores and Gems?
Cores:
One-time allocations granted through governance
Think of them as "startup capital" for your AI
Governance-approved only (can't buy or mine)
Convertible to Gems (1:1 ratio)
Gems:
AI-specific tradeable tokens
Created by converting Cores
Represent ownership and usage rights
Determine market cap for reward distribution
Analogy: Cores are like a business loan approval. Gems are like the actual shares you issue for your company.
Can I buy Cores?
Yes. Cores can be bought off the open-market DEX. However, as a user on platforms like Deva, you typically receive Cores automatically through contributions - the platform handles requesting and distributing Cores on your behalf.
Can I convert Gems back to Cores?
No. Core-to-Gem conversion is one-way and irreversible. The platform (e.g., Deva) automatically converts Cores to Gems on your behalf, so you don't need to worry about this process.
What token standards do Gems use?
Gems have two formats:
Native: ERC-1155 (multi-token standard) in GemCoreNFT contract
Wrapped: ERC-20 adapters for DEX compatibility
Both formats represent the same underlying value and can be converted bidirectionally.
How many Gems can I create?
The platform can convert Cores to Gems up to the total approved Core allocation (default maximum: 100 Cores per proposal, governance-controlled). Each Core converts to exactly 1 Gem.
To receive more Cores, submit additional governance proposals.
Contributions and Rewards
What contribution types does Bitplanet track?
Six types by default (governance can add more):
TRAIN - Training data or model improvements
REFER - Referrals and community growth
CREATE - AI creation (required for launch)
PROMPT - Prompt engineering and testing
REVENUE - Revenue generation activities
MARKET_CAP - Actions increasing market capitalization
How are contributions recorded?
Approved platforms submit Request For Core (RFC) messages containing contribution data. The tensor matrix records quantities for each contributor × contribution type, creating an immutable on-chain record.
How are rewards calculated?
Every block (~6 seconds):
Total inflation distributed across AIs by market cap weight
Each AI's rewards split three ways:
40% → Platform (AI App) (claimable)
40% → Creator (claimable)
20% → Contributors (proportional to tensor matrix)
Rewards accumulate in claimable balances
Participants claim when ready
How long does it take for rewards to accumulate?
Rewards are distributed every block (approximately 6 seconds). However, you must manually claim them—they don't automatically transfer to your account.
Query your balance anytime:
Why do I need to claim rewards manually?
Gas efficiency. Automatically transferring rewards every block would cost each participant gas fees every 6 seconds. By accumulating rewards in claimable balances, you claim once when convenient (and when gas prices are low).
Can I transfer Gems to other users?
Yes! Gems are standard ERC-1155 tokens (with ERC-20 wrappers) and can be:
Transferred to other addresses
Traded on decentralized exchanges
Used as collateral in DeFi protocols
Integrated into smart contracts
What if my contribution quality is disputed?
Bitplanet records contribution quantities submitted by approved platforms. Quality validation happens off-chain at the platform level before submission.
If disputes arise:
Platform resolves according to their policies
Future RFCs can adjust contribution allocations
Governance can revoke platform approval for abuse
Blockchain provides transparency, but platforms handle quality assessment.
Governance
What can governance control?
All economic parameters, including:
Reward split percentages (creator/platform/contributor)
Inflation siphon rate
Core allocation limits
Contribution type definitions
Processing limits (max AIs, max block heights, max tensor rows)
Contract addresses and system configurations
How do I submit a governance proposal?
For AI creators and contributors: Platforms like Deva typically submit Core Grant Applications on your behalf. You don't need to interact with the blockchain directly.
For platform developers or advanced users: You can submit proposals directly via CLI:
See For AI Creators for more information about creating AI agents and earning rewards.
What happens if governance rejects a proposal?
The governance deposit is returned (minus the proposal submission fee). The proposal can be revised based on community feedback and resubmitted.
Common rejection reasons:
Insufficient project explanation
Unrealistic Core allocation request
Unclear contribution model
Duplicate or low-quality proposal
How long do Core Grant Applications last?
CGAs expire after 1000 blocks (~100 minutes at 6-second block time) by default. This parameter is governance-controlled.
If an allocation expires unused, the platform can submit a new governance proposal to extend.
Can platforms increase their Core allocation later?
Yes. Platforms can submit additional governance proposals. If approved, the allocation increases and the expiry timer resets. AI creators don't need to worry about this - platforms like Deva manage Core allocations on behalf of their user communities.
Technical Questions
What blockchain does Bitplanet use?
Bitplanet is built on BitSDK with full EVM compatibility. It combines:
BitSDK: Custom modules (x/brahma for attribution), state management, consensus
EVM: Smart contracts for token operations, standard Web3 compatibility
What consensus mechanism does Bitplanet use?
CometBFT (formerly Tendermint), which provides:
Byzantine Fault Tolerant consensus (tolerates 1/3 malicious validators)
Instant finality (no chain reorganizations)
~6 second block time
Can I use MetaMask with Bitplanet?
Yes. Bitplanet has full EVM compatibility, so standard Ethereum wallets work:
MetaMask
WalletConnect
Coinbase Wallet
Any Web3-compatible wallet
Configure MetaMask with Bitplanet's RPC endpoints.
What programming languages can I use?
Smart contracts: Solidity (full EVM compatibility)
Backend integration: Any language with:
gRPC client library (for BitSDK queries)
Web3 library (for EVM interaction)
Popular choices: JavaScript/TypeScript (ethers.js), Python (web3.py), Go (BitSDK)
What are the RPC endpoints?
Local node default ports:
Cosmos RPC:
26657REST API:
1317gRPC:
9090JSON-RPC (EVM):
8545WebSocket (EVM):
8546
Public endpoints vary by network. Check official documentation for current testnet/mainnet URLs.
How do I run a node?
See Node Operation Guide for complete setup instructions.
Quick overview:
Economic Questions
How is inflation calculated?
Bitplanet siphons 50% of the distribution module's inflation (controlled by governance). This inflation is then distributed across AIs proportionally by market capitalization. Learn why this distribution ratio was chosen.
Total inflation rate depends on the underlying chain parameters, controlled through standard BitSDK governance.
Can market cap be manipulated?
Safeguards against manipulation:
30-90 day rolling average: Sudden spikes don't immediately affect allocation
Market-based value: Manipulation requires real capital (buying tokens)
Distributed governance: Community can adjust parameters if gaming detected
Weighted formula (future): Once AMM exists, market cap will use
(W1 × gem_supply) + (W2 × gem_market_cap)with governance-adjustable weights. Supply is harder to manipulate (requires burning Cores), so W1/W2 can be tuned to minimize price manipulation attacks on thin liquidity.
While no system is perfectly manipulation-proof, Bitplanet's design makes attacks expensive relative to potential gains.
What prevents spam AIs?
Multiple mechanisms:
Governance approval: Only approved CGAs can issue Cores
Community voting: Token holders filter low-quality proposals
Market cap weighting: Spam AIs with no real usage get negligible rewards
Processing limits: Max 500 AIs processed per block (governance-controlled)
What happens if an AI becomes inactive?
Inactive AIs (no market cap or contributions) receive zero inflation rewards. The system automatically skips them during distribution.
To reactivate:
Increase market cap (users hold tokens)
Submit new contributions
Market cap-based allocation resumes automatically
Security and Safety
Is Bitplanet audited?
Check the official documentation and GitHub repository for current audit status and reports.
⚠️ Security Notice Only use contract addresses and commands directly from official Bitplanet documentation. Always verify addresses on the blockchain explorer before interacting.
How do I verify contract addresses?
Check multiple sources:
Official documentation
Governance proposal records
Blockchain explorer (verify deployment transactions)
Community verification (Discord, official channels)
Never:
Use addresses from unknown websites
Trust addresses sent via DM
Interact with unverified contracts
What if I lose my private key?
If you lose your private key:
Access to your tokens is permanently lost
No recovery mechanism exists (decentralized = no customer support)
Unclaimed rewards remain locked
Best practices:
Use hardware wallets for significant holdings
Store seed phrases securely (offline, encrypted)
Test recovery process with small amounts first
Can governance change the rules arbitrarily?
Governance can change economic parameters through proposals, but:
Protections:
Voting period allows community review (typically 7 days)
Proposals must pass majority threshold
Parameter changes have validation rules (e.g., splits must sum to 1.0)
Large token holders have incentive to maintain system value
Cannot change:
Historical contribution records (immutable)
Smart contract logic (requires upgrade proposal)
Core blockchain consensus rules (requires coordinated upgrade)
Next Steps
Get started: Developer Quick Start
Understand concepts: Core Concepts
Technical deep-dive: Why Bitplanet
Build on Bitplanet: Developer Guides
Last updated