# FAQ & Troubleshooting

## General Questions

### Why Telegram first?

**90% mobile reach, no extra install required.** Telegram Mini-Apps provide instant access without app store friction. Users can submit ideas, receive scores, and earn rewards directly within their messaging app. This eliminates the adoption barriers that traditional mobile apps face.

### How is creativity scored?

**Vector originality + fact-checking + complexity analysis.** Our AI system:

1. Converts your idea to a semantic vector
2. Compares against our database of existing ideas
3. Verifies factual accuracy using knowledge bases
4. Evaluates complexity and innovation potential
5. Generates a composite score (0-100)

### What data do you store?

**Minimal personal data, maximum content protection:**

* **On-chain**: IPFS content hash, creativity score, reward amount
* **Off-chain**: Encrypted idea content, user Telegram ID, submission timestamp
* **Not stored**: Personal messages, contact lists, or private information

### How are rewards calculated?

**Score-based with multipliers:**

```
Base Reward = 50 $AION
Multiplier = (Score / 100) ^ 1.5
Final Reward = Base × Multiplier
Bonus = 20% for scores > 90
```

### Can I submit ideas in other languages?

**Currently English only, expanding Q4 2025.** Our AI models are trained primarily on English content for optimal accuracy. Multi-language support is planned for the ecosystem expansion phase.

## Technical Issues

### Mini-App won't load

**Common Solutions:**

1. **Update Telegram**: Ensure you're using the latest version
2. **Clear Cache**: Settings → Data and Storage → Clear Cache
3. **Restart App**: Force close and reopen Telegram
4. **Check Network**: Stable internet connection required
5. **Try Desktop**: Use Telegram Web if mobile fails

### Authentication errors

**If you see "Invalid auth" messages:**

1. **Logout/Login**: Re-authenticate with Telegram
2. **Check Permissions**: Allow Mini-App access
3. **Clear Browser Data**: If using Telegram Web
4. **Contact Support**: `@AltarSupport` if issues persist

### Scoring takes too long

**Expected processing time: <2 minutes**

* **Normal**: Complex ideas may take longer
* **Retry**: Refresh after 3 minutes
* **Network**: Check connection stability
* **Report**: Submit timeout issues to support

### Wallet connection issues

**Troubleshooting steps:**

1. **MetaMask**: Ensure extension is updated
2. **Network**: Switch to correct blockchain
3. **Telegram Wallet**: Use built-in wallet as fallback
4. **Browser**: Try different browser if on desktop

## Mini-App Specific

### How to enable fullscreen mode?

**Automatic in most cases:**

* **Mobile**: Tap the expand button in top-right
* **Desktop**: Click fullscreen icon
* **Telegram Web**: May require manual expansion

### Theme doesn't match Telegram

**Currently using dark theme only:**

* System follows Telegram's dark mode
* Light theme support planned for Q4 2025
* Custom themes for premium users

### Notifications not working

**Enable in Telegram settings:**

1. Settings → Notifications and Sounds
2. Find "Altar of Creativity Bot"
3. Enable all notification types
4. Check Do Not Disturb settings

### Sharing submissions

**Privacy controls:**

* **Private**: Only you can see (default)
* **Friends**: Share with Telegram contacts
* **Public**: Community leaderboard
* **Guild**: Share within your creative guild

## Scoring & Rewards

### My score seems low

**Common reasons:**

* **Similarity**: Idea too similar to existing submissions
* **Factual errors**: Incorrect information detected
* **Complexity**: Simple ideas receive lower scores
* **Clarity**: Poorly written ideas score lower

### Reward didn't arrive

**Check these steps:**

1. **Wallet address**: Verify correct address provided
2. **Network**: Check correct blockchain
3. **Confirmation**: Wait for blockchain confirmation
4. **Support**: Contact if >24 hours delayed

### Can I dispute a score?

**Community review process (Q1 2026):**

* Currently: No dispute mechanism
* Future: Stake tokens to request peer review
* Appeal process through guild governance

## Community & Governance

### How to join a guild?

**Guild system launches Q4 2025:**

* Minimum stake requirement
* Application process
* Reputation requirements
* Specialized scoring focus

### Governance voting

**Token holders can vote on:**

* Scoring algorithm changes
* Reward distribution adjustments
* New feature implementations
* Community guidelines updates

### Reporting inappropriate content

**Community standards:**

1. Use in-app report button
2. Contact `@AltarSupport`
3. Describe violation clearly
4. Provide submission reference

## Development & Contributing

### How to contribute code?

**Open source participation:**

1. Check [GitHub repository](https://github.com/altar-of-creativity)
2. Review contribution guidelines
3. Submit pull requests
4. Join developer Discord

### Feature requests

**Suggest improvements:**

* Submit via `/feedback` command
* Post in community Telegram group
* Create GitHub issues
* Participate in governance voting

### Bug reports

**Help us improve:**

1. Describe steps to reproduce
2. Include screenshots if possible
3. Mention device/browser info
4. Use `@AltarSupport` for urgent issues

## Error Messages

### "Submission failed"

* **Cause**: Network timeout or server error
* **Solution**: Retry submission, check connection

### "Invalid content"

* **Cause**: Content contains prohibited material
* **Solution**: Review community guidelines, modify content

### "Insufficient balance"

* **Cause**: Not enough $AION for staking
* **Solution**: Acquire tokens or reduce stake amount

### "Rate limit exceeded"

* **Cause**: Too many submissions in short time
* **Solution**: Wait 10 minutes before retrying

***

**Still need help?** Contact `@AltarSupport` or join our [community chat](https://t.me/altarofcreativity)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://project-49.gitbook.io/alter-of-creativity/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.