Actions (a especificação)

Endpoints HTTP padronizados que produzem transações Solana para carteiras e Blinks.

Receita

GET  /action-info     → metadados (título, ícone, descrição)
POST /action-execute  → transação para conta conectada

Quando usar:

• Botões interoperáveis entre carteiras, Twitter e Discord.
• Interações on-chain descobríveis sem deep links customizados por carteira.
• Campanhas de marketing que precisam de links compartilháveis.

Exemplo prático

import { NextResponse } from "next/server";
 
export async function GET() {
  return NextResponse.json({
    type: "action",
    icon: "https://example.com/icon.png",
    title: "Vote on Proposal 1",
    description: "Cast your governance vote",
    label: "Vote",
  });
}
 
export async function POST(req: Request) {
  const { account } = await req.json();
  if (!account) return NextResponse.json({ error: "missing account" }, { status: 400 });
  // construa e retorne { transaction: "<base64>" }
  return NextResponse.json({ transaction: "BASE64_TX" });
}

O que isso demonstra:

• GET anuncia metadados legíveis por humanos para unfurlers.
• POST recebe a pubkey do usuário e retorna a transação serializada.
• Siga as diretrizes de CORS e segurança do Solana Actions.

Aprofundamento

Como funciona

• Clientes Blink buscam GET para o cartão de pré-visualização.
• O clique do usuário dispara POST com a pubkey da carteira.
• A carteira assina a transação retornada.
• URLs de callback opcionais reportam a conclusão para o dApp.

Campos de Resposta

Erros comuns

• HTTP não HTTPS - carteiras recusam. Correção: TLS em todos os lugares.
• CORS incorreto - carteira do navegador bloqueada. Correção: cabeçalhos da especificação em OPTIONS e POST.
• URL de ícone maliciosa - phishing. Correção: hospede em seu domínio.
• Sem validação de conta - apenas verificação de formato; ainda assim, construa instruções seguras.
• GET muta estado - envenenamento de cache. Correção: GET é apenas metadados somente leitura.

Alternativas

FAQs

Relacionados

• Construindo uma Action - implementação
• Blinks - links embutidos
• Segurança e Verificação - segurança

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x. cGJxcnRodnFyZi52YnxwdHZiMjcyfDIwMjYwNw==