Dart and Flutter client

pina_amm is the Dart client for the Pina AMM, generated from the program’s IDL for solana_kit. It works in Flutter apps and Dart servers alike.

dependencies:
  pina_amm: ^0.1.0
  solana_kit: ^0.10.0
  solana_kit_rpc_api: ^0.10.0 # for GetTransactionConfig

import 'package:pina_amm/pina_amm.dart';
import 'package:solana_kit/solana_kit.dart';

What is exported

Kind	Examples
Program	pinaAmmProgramAddress, ParsedPinaAmmInstruction
Instructions	getSwapExactInInstruction, getCreatePoolInstruction, getDepositInstruction, …
Accounts	Pool, AmmConfig, decodePool, getPoolDecoder, …
PDAs	findAmmConfigPda, findPoolPda, findPoolVaultPda, findPoolLpMintPda
Events	parsePinaAmmEventsFromLogs, PinaAmmEvent subclasses
Errors	pinaAmmErrorSlippageExceeded and the other code constants

Find a pool

final (ammConfig, _) = await findAmmConfigPda(
  seeds: AmmConfigSeeds(index: 0),
  programAddress: pinaAmmProgramAddress,
);
final (pool, _) = await findPoolPda(
  seeds: PoolSeeds(ammConfig: ammConfig, mint0: mint0, mint1: mint1),
  programAddress: pinaAmmProgramAddress,
);

mint0 must be the mint whose 32 address bytes sort first. Compare getAddressEncoder().encode(address) byte by byte; do not compare base58 strings.

Read a pool

final account = switch (await fetchEncodedAccount(rpc, pool)) {
  ExistingAccount(:final account) => account,
  NonExistingAccount() => throw StateError('no account at $pool'),
};
if (account.programAddress != pinaAmmProgramAddress) {
  throw StateError('not a Pina AMM account');
}
final state = decodePool(account).data;
print('lp supply ${state.lpSupply}');

Generated decoders check the discriminator and schema version but not the owner, so always check programAddress first when an address comes from outside your app.

Swap

final instruction = getSwapExactInInstruction(
  programAddress: pinaAmmProgramAddress,
  trader: wallet.address,
  pool: pool,
  inputToken: walletToken0,
  outputToken: walletToken1,
  inputVault: state.vault0,
  outputVault: state.vault1,
  inputTokenProgram: tokenProgramAddress,
  outputTokenProgram: tokenProgramAddress,
  amountIn: BigInt.from(1000000),
  minimumAmountOut: minimumOut,
);

Selling token 1 swaps the token accounts, vaults, and token programs, and the reserves you quote with: token 1’s reserve becomes the input reserve x. getSwapExactOutInstruction takes amountOut and maximumAmountIn. Quote with the formulas in Math, or simulate the transaction and read the Swapped event.

Events

import 'package:solana_kit_rpc_api/solana_kit_rpc_api.dart';

final response = await rpc
    .getTransaction(
      signature,
      const GetTransactionConfig(maxSupportedTransactionVersion: 0),
    )
    .send();
final logs = switch (response) {
  {'meta': {'logMessages': final List<Object?> lines}} =>
    lines.whereType<String>().toList(),
  _ => const <String>[],
};
final events = parsePinaAmmEventsFromLogs(logs);
for (final event in events) {
  switch (event) {
    case SwappedEvent(:final amountIn, :final amountOut):
      print('$amountIn in, $amountOut out');
    default:
      break;
  }
}

solana_kit returns the raw getTransaction result, so the log lines are read from its meta. Pass every log line of one transaction, in order, so records are attributed only to the AMM.

Flutter notes

• Keep BigInt end to end; token amounts exceed JavaScript-safe and Dart int ranges on the web.
• Show users the quote and the minimum they will accept, derived with the same slippage rule the CLI uses: minimum = quote * (10000 - bps) ~/ 10000.
• Map error codes such as pinaAmmErrorSlippageExceeded to product language in your app; the generated messages are written for developers.