Transações Versionadas (v0)

Q: Qual versão do Solana CLI devo usar?

Use Solana CLI 3.0.10, que combina com Agave 4.1.1. Instale com agave-install init 4.1.1 (ou arquivo pin da equipe), depois verifique com solana --version e agave-install --version.

Q: Devo usar @solana/kit ou web3.js?

Use @solana/kit 7.0.0 para novo TypeScript - métodos RPC tipados, API menor, e exemplos nesta página já usam Kit. Mantenha web3.js apenas para bases legadas; migre chamadas RPC e construção de transação incrementalmente.

Q: Qual nível de commitment é recomendado?

Simule em confirmed, depois faça poll em getSignatureStatuses em confirmed para velocidade. Use finalized antes de tratar movimentos de token como liquidados.

Q: Funciona em devnet?

Sim - aponte CLI e RPC para https://api.devnet.solana.com. Comportamento corresponde à mainnet; apenas dados de conta e economia diferem.

Q: Qual é o padrão Anchor 0.32.1?

Anchor 0.32.1 usa #[program], Context e #[derive(Accounts)] com constraints mut/signer explícitas - execute anchor build e anchor test em 0.32.1 via avm use 0.32.1.

Q: Como testar com Surfpool 0.12.0?

Execute anchor test com Surfpool 0.12.0 para simular transações completas contra fork mainnet - especialmente caminhos de taxa de prioridade e v0/ALT.

O formato v0 e por que importa. Este guia mira validators Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1 e clientes @solana/kit 7.0.0.

Receita

Cartão de receita de referência rápida.

solana config set --url devnet
solana balance

import { createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc("https://api.devnet.solana.com");

Quando usar isso:

Implementar ou depurar transações versionadas (v0) em caminhos de produção
Ensinar o conceito a engenheiros novos em Solana
Auditar se sua stack corresponde ao comportamento da era Agave 4.1

Exemplo de Trabalho

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const slot = await rpc.getSlot().send();
 
const sig = "PASTE_SIGNATURE_AFTER_YOUR_TX";
const tx = await rpc
  .getTransaction(sig, { encoding: "json", maxSupportedTransactionVersion: 0 })
  .send();
 
console.log({ slot, err: tx?.meta?.err, cu: tx?.meta?.computeUnitsConsumed });

use anchor_lang::prelude::*;
#[program]
pub mod demo {
    use super::*;
    pub fn log_slot(_ctx: Context<LogSlot>) -> Result<()> {
        let clock = Clock::get()?;
        msg!("slot: {}", clock.slot);
        Ok(())
    }
}
#[derive(Accounts)]
pub struct LogSlot {}

O que isso demonstra:

Padrões de acesso RPC com @solana/kit 7.0.0
Leitura de metadados de execução (erros, CU) de transações confirmadas
Acesso a sysvar on-chain em programas Anchor 0.32.1

Deep Dive

Como Funciona

O formato v0 e por que importa.
O modelo de contas da Solana exige listas explícitas de contas por instrução
Sealevel executa transações sem conflito em paralelo

Notas Agave 4.1.1

Semântica de confirmação segue votação TowerBFT com ordenação PoH
Alpenglow (Votor + Rotor) está sendo implantado para finalidade mais rápida - veja seção Consensus
Desenvolvimento local: Surfpool 0.12.0 e LiteSVM 0.6.x

Notas Rust

// Use matemática verificada e constraints explícitas em programas
require!(amount > 0, MyError::InvalidAmount);

Armadilhas

Snippets legados web3.js v1 - API difere do Kit. Correção: use @solana/kit 7.0.0.
Cluster errado - mismatch devnet vs mainnet. Correção: alinhe CLI, RPC, carteira, explorer.
Amounts SOL em float - perda de precisão. Correção: lamports bigint ponta a ponta.
Blockhash expirado - txs descartadas. Correção: busque blockhash novamente e reassine.
CU insuficiente - OOM ou orçamento excedido. Correção: otimize programa + defina Compute Budget.
Checks de owner ausentes - exploits de conta writable. Correção: constraints Anchor em toda conta mut.

Alternativas

Alternativa	Use Quando	Não Use Quando
@solana/kit 7.0.0	Novos clientes TypeScript	Manter código legado temporariamente
Solana CLI 3.0.10	Ops e sondagens rápidas	Assinatura de transação em produção em escala
Surfpool 0.12.0	Testes de integração Anchor	Deploy de produção
LiteSVM 0.6.x	Testes unitários rápidos	Validação de comportamento de rede completo

FAQs

Como isso se aplica no Agave 4.1.1?

Agave 4.1.1 suporta totalmente transações v0 - carteiras e RPCs devem definir maxSupportedTransactionVersion: 0 ao buscar.

Qual versão do Solana CLI devo usar?

Use Solana CLI 3.0.10, que combina com Agave 4.1.1. Instale com agave-install init 4.1.1 (ou arquivo pin da equipe), depois verifique com solana --version e agave-install --version.

Devo usar @solana/kit ou web3.js?

Use @solana/kit 7.0.0 para novo TypeScript - métodos RPC tipados, API menor, e exemplos nesta página já usam Kit. Mantenha web3.js apenas para bases legadas; migre chamadas RPC e construção de transação incrementalmente.

Qual nível de commitment é recomendado?

Simule em confirmed, depois faça poll em getSignatureStatuses em confirmed para velocidade. Use finalized antes de tratar movimentos de token como liquidados.

Como depurar falhas relacionadas?

Parsers legados que assumem transações legacy falham em v0 - habilite versão 0 em chamadas RPC e deserializadores @solana/kit.

Funciona em devnet?

Sim - aponte CLI e RPC para https://api.devnet.solana.com. Comportamento corresponde à mainnet; apenas dados de conta e economia diferem.

Como compute units afetam isso?

v0 não reduz CU; reduz tamanho serializado para caber mais contas e instruções por tx.

Qual é o padrão Anchor 0.32.1?

Anchor 0.32.1 usa #[program], Context<T> e #[derive(Accounts)] com constraints mut/signer explícitas - execute anchor build e anchor test em 0.32.1 via avm use 0.32.1.

Como testar com Surfpool 0.12.0?

Execute anchor test com Surfpool 0.12.0 para simular transações completas contra fork mainnet - especialmente caminhos de taxa de prioridade e v0/ALT.

LiteSVM 0.6.x cobre isso?

LiteSVM 0.6.x suporta v0 quando você inclui contas de lookup table no harness de teste.

O que mudou na era Agave?

O cliente validator foi rebrandizado para Agave (4.1.1), CLI 3.0.10 alinha com ele, e trabalho Alpenglow está mudando finalidade - fixe versões e leia release notes a cada upgrade.

Onde encontro métodos RPC relacionados?

getTransaction e simulateTransaction precisam de maxSupportedTransactionVersion: 0 para txs v0.

Relacionado

Navegue outras páginas na seção transactions-instructions-fees para tópicos complementares
Noções Básicas de Solana - orientação de contas e transações

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.

Receita

Cartão de receita de referência rápida.

solana config set --url devnet
solana balance

import { createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc("https://api.devnet.solana.com");

Quando usar isso:

Implementar ou depurar transações versionadas (v0) em caminhos de produção
Ensinar o conceito a engenheiros novos em Solana
Auditar se sua stack corresponde ao comportamento da era Agave 4.1

Exemplo de Trabalho

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const slot = await rpc.getSlot().send();
 
const sig = "PASTE_SIGNATURE_AFTER_YOUR_TX";
const tx = await rpc
  .getTransaction(sig, { encoding: "json", maxSupportedTransactionVersion: 0 })
  .send();
 
console.log({ slot, err: tx?.meta?.err, cu: tx?.meta?.computeUnitsConsumed });

use anchor_lang::prelude::*;
#[program]
pub mod demo {
    use super::*;
    pub fn log_slot(_ctx: Context<LogSlot>) -> Result<()> {
        let clock = Clock::get()?;
        msg!("slot: {}", clock.slot);
        Ok(())
    }
}
#[derive(Accounts)]
pub struct LogSlot {}

O que isso demonstra:

Padrões de acesso RPC com @solana/kit 7.0.0
Leitura de metadados de execução (erros, CU) de transações confirmadas
Acesso a sysvar on-chain em programas Anchor 0.32.1

Deep Dive

Como Funciona

O formato v0 e por que importa.
O modelo de contas da Solana exige listas explícitas de contas por instrução
Sealevel executa transações sem conflito em paralelo

Notas Agave 4.1.1

Semântica de confirmação segue votação TowerBFT com ordenação PoH
Alpenglow (Votor + Rotor) está sendo implantado para finalidade mais rápida - veja seção Consensus
Desenvolvimento local: Surfpool 0.12.0 e LiteSVM 0.6.x

Notas Rust

// Use matemática verificada e constraints explícitas em programas
require!(amount > 0, MyError::InvalidAmount);

Armadilhas

Snippets legados web3.js v1 - API difere do Kit. Correção: use @solana/kit 7.0.0.
Cluster errado - mismatch devnet vs mainnet. Correção: alinhe CLI, RPC, carteira, explorer.
Amounts SOL em float - perda de precisão. Correção: lamports bigint ponta a ponta.
Blockhash expirado - txs descartadas. Correção: busque blockhash novamente e reassine.
CU insuficiente - OOM ou orçamento excedido. Correção: otimize programa + defina Compute Budget.
Checks de owner ausentes - exploits de conta writable. Correção: constraints Anchor em toda conta mut.

Alternativas

Alternativa	Use Quando	Não Use Quando
@solana/kit 7.0.0	Novos clientes TypeScript	Manter código legado temporariamente
Solana CLI 3.0.10	Ops e sondagens rápidas	Assinatura de transação em produção em escala
Surfpool 0.12.0	Testes de integração Anchor	Deploy de produção
LiteSVM 0.6.x	Testes unitários rápidos	Validação de comportamento de rede completo

FAQs

Como isso se aplica no Agave 4.1.1?

Agave 4.1.1 suporta totalmente transações v0 - carteiras e RPCs devem definir maxSupportedTransactionVersion: 0 ao buscar.

Qual versão do Solana CLI devo usar?

Use Solana CLI 3.0.10, que combina com Agave 4.1.1. Instale com agave-install init 4.1.1 (ou arquivo pin da equipe), depois verifique com solana --version e agave-install --version.

Devo usar @solana/kit ou web3.js?

Qual nível de commitment é recomendado?

Simule em confirmed, depois faça poll em getSignatureStatuses em confirmed para velocidade. Use finalized antes de tratar movimentos de token como liquidados.

Como depurar falhas relacionadas?

Parsers legados que assumem transações legacy falham em v0 - habilite versão 0 em chamadas RPC e deserializadores @solana/kit.

Funciona em devnet?

Sim - aponte CLI e RPC para https://api.devnet.solana.com. Comportamento corresponde à mainnet; apenas dados de conta e economia diferem.

Como compute units afetam isso?

v0 não reduz CU; reduz tamanho serializado para caber mais contas e instruções por tx.

Qual é o padrão Anchor 0.32.1?

Anchor 0.32.1 usa #[program], Context<T> e #[derive(Accounts)] com constraints mut/signer explícitas - execute anchor build e anchor test em 0.32.1 via avm use 0.32.1.

Como testar com Surfpool 0.12.0?

Execute anchor test com Surfpool 0.12.0 para simular transações completas contra fork mainnet - especialmente caminhos de taxa de prioridade e v0/ALT.

LiteSVM 0.6.x cobre isso?

LiteSVM 0.6.x suporta v0 quando você inclui contas de lookup table no harness de teste.

O que mudou na era Agave?

O cliente validator foi rebrandizado para Agave (4.1.1), CLI 3.0.10 alinha com ele, e trabalho Alpenglow está mudando finalidade - fixe versões e leia release notes a cada upgrade.

Onde encontro métodos RPC relacionados?

getTransaction e simulateTransaction precisam de maxSupportedTransactionVersion: 0 para txs v0.

Relacionado

Navegue outras páginas na seção transactions-instructions-fees para tópicos complementares
Noções Básicas de Solana - orientação de contas e transações

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.

Transações Versionadas (v0)

Buscar na documentação

Transações Versionadas (v0)