Context - Startale Documentation

Context is the runtime data the host environment makes available to your app at run time. In Startale Mini Apps, context is how you read user and session-scoped information without building your own identity layer inside the Mini App.

What Startale adds

When your Mini App runs inside the Startale App, the host augments the Mini App SDK context with Startale-specific fields under sdk.context.startale, including:

STAR Points: The user’s current STAR Points balance.
Linked EOAs: Wallet addresses the user has verified as linked to their Startale account.
Legacy address: The user’s smart account address from before an account upgrade, with a signature proving the legacy account approved the upgrade. Present only for users who have completed one.

How you read it

import { sdk } from '@farcaster/miniapp-sdk'

const context = await sdk.context
const starPoints = context.startale?.starPoints ?? 0
const eoaWallets = context.startale?.eoaWallets ?? []

Read the full runtime context reference

This page is intentionally brief. For the full field shape, constraints (including what works in the sandbox), and end-to-end examples, see Runtime context.