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 athttps://app.elata.bio/api.
The full operation reference, request/response schemas, and status of each endpoint (stable vs proposed) live in the API Reference tab, which is generated from a single OpenAPI 3.1 spec at api-reference/openapi.yaml.
Currently stable endpoints
| Method | Path | Reference |
|---|---|---|
| GET | /apps | List apps |
| GET | /apps/{tokenAddress} | Get app |
| GET | /prices | Get prices |
Proposed builder endpoints
The OpenAPI spec also definesproposed endpoints for app discovery (search, holders, activity), launch preflight, market data (snapshots, candles, curves, leaderboards), portfolio (holdings, history, P&L), rewards (claimable, programs, claim payloads), and runtime config (contracts, chains, feature flags). See the API Reference tab for the full list and the status legend.
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 ERC-20 token |
| AppBondingCurve | Price discovery via ELTA curve |
| AppVestingWallet | 25% supply — cliff + linear vest |
| AppEcosystemVault | 25% supply — admin-controlled |
| FeeCollector | Collects and routes protocol fees |
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, curve, etc.) |
| AppFactory | appCount() | Total apps launched |
| AppToken | balanceOf(address) | User token balance |
| AppBondingCurve | getPrice() | Current curve price |
| AppVestingWallet | releasable() | Vested tokens available to release |
| AppEcosystemVault | balance() | Vault token balance |
| VeELTA | balanceOf(address) | User veELTA balance |
Writing Transactions
App Launch (Two-Phase)
Buy on Bonding Curve
Lock ELTA as veELTA
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
- veELTA balance
Webhooks (Coming Soon)
Future webhook support for:- New token purchases
- Fee collection events
SDKs & Libraries
Elata Bio SDK
| Package | Purpose | Docs |
|---|---|---|
@elata-biosciences/eeg-web | EEG signal processing via WASM | SDK — eeg-web |
@elata-biosciences/eeg-web-ble | Web Bluetooth headband connection | SDK — eeg-web-ble |
@elata-biosciences/rppg-web | Camera-based heart rate (rPPG) | SDK — rppg-web |
App Store Source
Use the App Store codebase as an integration reference:- elata-appstore — Frontend code
- elata-protocol — Smart contracts
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 |
RPC Limits
Use your own RPC provider for production:Example: Price Display Widget
Resources
App Store Repo
Frontend implementation reference
Protocol Repo
Smart contract source code
Contract Addresses
Deployed contract addresses
Discord
Developer support channel