Overview
Three ways to integrate: embed in the App Store iframe, hit the REST API, or talk to contracts directly. For full code, see GitHub.Architecture
Integration Options
| Method | Use Case | Complexity |
|---|---|---|
| App Store Embed | Run app in Elata iframe | Low |
| REST API | Read app data, metadata | Medium |
| Smart Contracts | Direct blockchain interaction | High |
App Store API
The App Store provides REST endpoints for reading data.Base URL
Endpoints
Get All Apps
Get Single App
- Basic metadata
- Social links
- Team members
- Artifacts (game files)
Get Prices
Smart Contracts
For direct blockchain interaction, these are the key contracts:Core Contracts
| Contract | Purpose |
|---|---|
| ELTA | Main protocol token |
| VeELTA | Vote-escrowed staking |
| AppFactory | Creates new apps |
| AppFactoryViews | Read app data |
Per-App Contracts
| Contract | Purpose |
|---|---|
| AppToken | Individual app token |
| AppBondingCurve | Price discovery |
| AppStakingVault | Staking for rewards |
| AppAccess1155 | NFT items |
| Tournament | Competition infrastructure |
Contract Addresses
See Resources → Contracts for deployed addresses.Reading On-Chain Data
Using wagmi/viem (Recommended)
Key Read Functions
| Contract | Function | Returns |
|---|---|---|
| AppFactory | apps(uint256) | App tuple (creator, token, vault, curve, etc.) |
| AppFactory | appCount() | Total apps launched |
| AppToken | balanceOf(address) | User token balance |
| AppStakingVault | balanceOf(address) | User staked balance |
| AppBondingCurve | getPrice() | Current curve price |
| VeELTA | balanceOf(address) | User veELTA balance |
Writing Transactions
App Launch
Buy on Bonding Curve
Stake Tokens
Embedding in Iframe
Apps run inside an iframe on the Elata App Store. Your app can:Communicate with Parent
Access User Data
When embedded, your app receives:- Connected wallet address
- App token balance
- Staked amount
- Owned items
Webhooks (Coming Soon)
Future webhook support for:- New token purchases
- Staking events
- Tournament entries
- Item purchases
SDKs & Libraries
Official Packages
| Package | Purpose | Status |
|---|---|---|
@elata/sdk | TypeScript SDK | Planned |
@elata/react | React hooks | Planned |
Current Approach
Use the App Store source as reference:- elata-appstore - Frontend code
- elata-protocol - Smart contracts
Useful Hooks from App Store
The App Store includes React hooks you can reference:ABIs
Contract ABIs are available in the App Store repository:Rate Limits
API Limits
| Endpoint | Limit |
|---|---|
| Read endpoints | 100 req/min |
| Heavy queries | 10 req/min |