Integration guide

Connect a wallet

The app wraps its tree in the Solana wallet adapter providers and opens a single picker for every supported wallet. Components read the connection with the useWallet hook.

import { useWallet } from '@solana/wallet-adapter-react'

export function Account() {
  const { publicKey, connected, disconnect } = useWallet()
  if (!connected || !publicKey) return null
  return <button onClick={() => disconnect()}>{publicKey.toBase58()}</button>
}

Read a VIVI balance

VIVI is a Token-2022 token, so the associated token address must be derived with the Token-2022 program ID. A missing account means the wallet holds none.

import { getAccount, getAssociatedTokenAddressSync, TOKEN_2022_PROGRAM_ID } from '@solana/spl-token'

const ata = getAssociatedTokenAddressSync(mint, owner, false, TOKEN_2022_PROGRAM_ID)
const account = await getAccount(connection, ata, 'confirmed', TOKEN_2022_PROGRAM_ID)
const balance = Number(account.amount) / 10 ** 9

Staking calls

Staking, unstaking, claiming and delegation are exposed as async functions that return a signature. Until the program is deployed they resolve with a simulated signature prefixed SIMULATED so they can never be mistaken for a real transaction.

Safety checklist

• Verify the mint address before any transaction and fail closed if it is not configured.
• Simulate every transaction and show the user the result before they sign.
• Validate amounts on the client and again in the program. Never trust a client-side balance.
• Use idempotent flows and surface failures; never silently retry a signed transaction.