solana-payments-wallet-dev

Payments and wallets

Build payment flows and wallet integrations using light-token on Solana. The light-token API matches SPL-token and extends it to include the light token program.

| Creation cost | SPL | light-token | | :---------------- | :------------------ | :------------------- | | Token Account | ~2,000,000 lamports | ~11,000 lamports |

Workflow

1. Clarify intent - Recommend plan mode, if it's not activated - Use AskUserQuestion to resolve blind spots - All questions must be resolved before execution 2. Identify references and skills - Match task to domain references below - Locate relevant documentation and examples 3. Write plan file (YAML task format) - Use AskUserQuestion for anything unclear — never guess or assume - Identify blockers: permissions, dependencies, unknowns - Plan must be complete before execution begins 4. Execute - Use Task tool with subagents for parallel research - Subagents load skills via Skill tool - Track progress with TodoWrite 5. When stuck: ask to spawn a read-only subagent with Read, Glob, Grep, and DeepWiki MCP access, loading skills/ask-mcp. Scope reads to skill references, example repos, and docs.

API overview

| Operation | SPL | light-token (action / instruction) | |-----------|-----|-------------------------------------| | Receive | getOrCreateAssociatedTokenAccount() | loadAta() / createLoadAtaInstructions() | | Transfer | createTransferInstruction() | transferInterface() / createTransferInterfaceInstructions() | | Get balance | getAccount() | getAtaInterface() | | Tx history | getSignaturesForAddress() | rpc.getSignaturesForOwnerInterface() | | Wrap from SPL | N/A | wrap() / createWrapInstruction() | | Unwrap to SPL | N/A | unwrap() / createUnwrapInstructions() | | Register SPL mint | N/A | createSplInterface() / LightTokenProgram.createSplInterface() | | Create mint | createMint() | createMintInterface() |

Plural functions (createTransferInterfaceInstructions, createUnwrapInstructions) return TransactionInstruction[][] — each inner array is one transaction. They handle loading cold accounts automatically.

Domain references

| Task | Reference | |------|-----------| | Build payment flows (receive, send, balance, history, wrap/unwrap) | payments.md | | Build wallet UI (display tokens, transfer, wrap/unwrap) | wallets.md | | Sign with Wallet Adapter or Mobile Wallet Adapter | sign-with-adapter.md | | Sign with Privy (embedded wallet provider) | sign-with-privy.md | | Prevent duplicate actions (double-spend prevention) | nullifiers.md |

Setup

npm install @lightprotocol/compressed-token@beta @lightprotocol/stateless.js@beta @solana/web3.js @solana/spl-token

import { createRpc } from "@lightprotocol/stateless.js";
import {
  createLoadAtaInstructions,
  loadAta,
  createTransferInterfaceInstructions,
  transferInterface,
  createUnwrapInstructions,
  unwrap,
  getAssociatedTokenAddressInterface,
  getAtaInterface,
  wrap,
} from "@lightprotocol/compressed-token/unified";
const rpc = createRpc(RPC_ENDPOINT);

Resources

SDK references

| Package | Link | |---------|------| | @lightprotocol/stateless.js | API docs | | @lightprotocol/compressed-token | API docs | | @lightprotocol/nullifier-program | npm |

Security

The Privy signing examples transmit secrets to an external API — review sign-with-privy.md before running.

npm install @lightprotocol/compressed-token@beta @lightprotocol/stateless.js@beta @solana/web3.js @solana/spl-token

import { createRpc } from "@lightprotocol/stateless.js";
import {
  createLoadAtaInstructions,
  loadAta,
  createTransferInterfaceInstructions,
  transferInterface,
  createUnwrapInstructions,
  unwrap,
  getAssociatedTokenAddressInterface,
  getAtaInterface,
  wrap,
} from "@lightprotocol/compressed-token/unified";
const rpc = createRpc(RPC_ENDPOINT);