> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Otimização de Solana RPC: Melhores Práticas de Desempenho e Custo

> Otimize o desempenho do Solana RPC, reduza custos e melhore a confiabilidade. Guia de otimização de transações, padrões de recuperação de dados e melhores práticas.

Otimizar o uso de RPC pode melhorar significativamente o desempenho, reduzir custos e aprimorar a experiência do usuário. Este guia cobre técnicas comprovadas para interações eficientes com o Solana RPC.

## Início Rápido

<CardGroup cols={2}>
  <Card title="Otimização de Transações" icon="bolt" href="#transaction-optimization">
    Otimize unidades de computação, taxas prioritárias e envio de transações
  </Card>

  <Card title="Recuperação de Dados" icon="database" href="#data-retrieval-optimization">
    Padrões eficientes para buscar dados de conta e programa
  </Card>

  <Card title="Monitoramento em Tempo Real" icon="chart-line" href="#real-time-monitoring">
    Inscrições WebSocket e otimização de dados em streaming
  </Card>

  <Card title="Melhores Práticas" icon="shield-check" href="#best-practices">
    Diretrizes de desempenho e gerenciamento de recursos
  </Card>
</CardGroup>

## Otimização de Transações

### Gerenciamento de Unidades de Computação

**1. Simular para determinar o uso real:**

```typescript theme={"system"}
const testTransaction = new VersionedTransaction(/* your transaction */);
const simulation = await connection.simulateTransaction(testTransaction, {
  replaceRecentBlockhash: true,
  sigVerify: false
});
const unitsConsumed = simulation.value.unitsConsumed;
```

**2. Definir limites apropriados com margem:**

```typescript theme={"system"}
const computeUnitLimit = Math.ceil(unitsConsumed * 1.1);
const computeUnitIx = ComputeBudgetProgram.setComputeUnitLimit({ 
  units: computeUnitLimit 
});
instructions.unshift(computeUnitIx); // Add at beginning
```

### Otimização de Taxas Prioritárias

**1. Obter estimativas dinâmicas de taxas:**

```typescript theme={"system"}
const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    method: 'getPriorityFeeEstimate',
    params: [{
      accountKeys: ['11111111111111111111111111111112'], // System Program
      options: { recommended: true }
    }]
  })
});
const { priorityFeeEstimate } = await response.json().result;
```

**2. Aplicar a taxa prioritária:**

```typescript theme={"system"}
const priorityFeeIx = ComputeBudgetProgram.setComputeUnitPrice({ 
  microLamports: priorityFeeEstimate 
});
instructions.unshift(priorityFeeIx);
```

### Melhores Práticas de Envio de Transações

<Tabs>
  <Tab title="Abordagem Padrão">
    ```typescript theme={"system"}
    // Serialize and encode
    const serializedTx = transaction.serialize();
    const signature = await connection.sendRawTransaction(serializedTx, {
      skipPreflight: true, // Saves ~100ms
      maxRetries: 0 // Handle retries manually
    });
    ```
  </Tab>

  <Tab title="Com Confirmação">
    ```typescript theme={"system"}
    // Send and confirm with custom logic
    const signature = await connection.sendRawTransaction(serializedTx);

    // Monitor confirmation
    const confirmation = await connection.confirmTransaction({
      signature,
      blockhash: latestBlockhash.blockhash,
      lastValidBlockHeight: latestBlockhash.lastValidBlockHeight
    });
    ```
  </Tab>
</Tabs>

## Otimização de Recuperação de Dados

### Métodos de Paginação Aprimorados (V2)

**Para consultas de dados em grande escala, use os novos métodos V2 com paginação baseada em cursor:**

<Card title="⚡ Aumento de Desempenho" icon="rocket" color="#E84125">
  `getProgramAccountsV2` e `getTokenAccountsByOwnerV2` fornecem melhorias significativas de desempenho para aplicações que lidam com grandes conjuntos de dados:

  * **Limites configuráveis**: 1-10.000 contas por solicitação
  * **Paginação baseada em cursor**: Evita timeouts em consultas grandes
  * **Atualizações incrementais**: Use `changedSinceSlot` para sincronização em tempo real
  * **Melhor uso de memória**: Faz streaming de dados em vez de carregar tudo de uma vez
</Card>

**Exemplo: Consulta eficiente de contas de programa**

```typescript theme={"system"}
// ❌ Old approach - could timeout with large datasets
const allAccounts = await connection.getProgramAccounts(programId, {
  encoding: 'base64',
  filters: [{ dataSize: 165 }]
});

// ✅ New approach - paginated with better performance
let allAccounts = [];
let paginationKey = null;

do {
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getProgramAccountsV2',
      params: [
        programId,
        {
          encoding: 'base64',
          filters: [{ dataSize: 165 }],
          limit: 5000,
          ...(paginationKey && { paginationKey })
        }
      ]
    })
  });
  
  const data = await response.json();
  allAccounts.push(...data.result.accounts);
  paginationKey = data.result.paginationKey;
} while (paginationKey);
```

**Atualizações incrementais para aplicações em tempo real:**

```typescript theme={"system"}
// Get only accounts modified since a specific slot
const incrementalUpdate = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getProgramAccountsV2',
    params: [
      programId,
      {
        encoding: 'jsonParsed',
        limit: 1000,
        changedSinceSlot: lastProcessedSlot // Only get recent changes
      }
    ]
  })
});
```

## Otimização de Recuperação de Dados

### Consultas de Contas Eficientes

<Tabs>
  <Tab title="Conta Única">
    ```typescript theme={"system"}
    // Use dataSlice to reduce payload size
    const accountInfo = await connection.getAccountInfo(pubkey, {
      encoding: 'base64',
      dataSlice: { offset: 0, length: 100 }, // Only get needed data
      commitment: 'confirmed'
    });
    ```
  </Tab>

  <Tab title="Múltiplas Contas">
    ```typescript theme={"system"}
    // Batch multiple account queries
    const accounts = await connection.getMultipleAccountsInfo([
      pubkey1, pubkey2, pubkey3
    ], {
      encoding: 'base64',
      commitment: 'confirmed'
    });
    ```
  </Tab>

  <Tab title="Contas de Programa">
    ```typescript theme={"system"}
    // Use filters to reduce data transfer
    const accounts = await connection.getProgramAccounts(programId, {
      filters: [
        { dataSize: 165 }, // Token account size
        { memcmp: { offset: 0, bytes: mintAddress }}
      ],
      encoding: 'jsonParsed'
    });
    ```
  </Tab>
</Tabs>

### Consultas de Saldo de Token

<CodeGroup>
  ```typescript ❌ Inefficient theme={"system"}
  // Don't do this - requires N+1 RPC calls
  const tokenAccounts = await connection.getTokenAccountsByOwner(owner, {
    programId: TOKEN_PROGRAM_ID
  });
  const balances = await Promise.all(
    tokenAccounts.value.map(acc => 
      connection.getTokenAccountBalance(acc.pubkey)
    )
  );
  // ~500ms + (100ms * N accounts)
  ```

  ```typescript ✅ Optimized theme={"system"}
  // Single call with parsed data
  const tokenAccounts = await connection.getTokenAccountsByOwner(owner, {
    programId: TOKEN_PROGRAM_ID
  }, { encoding: 'jsonParsed' });

  const balances = tokenAccounts.value.map(acc => ({
    mint: acc.account.data.parsed.info.mint,
    amount: acc.account.data.parsed.info.tokenAmount.uiAmount
  }));
  // ~500ms total - 95% reduction for large wallets
  ```
</CodeGroup>

### Histórico de Transações

Para histórico completo de endereços, use [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress) — um método exclusivo do Helius que retorna dados completos de transações, incluindo atividade de conta de token associada, em uma única chamada:

<CodeGroup>
  ```typescript ❌ Inefficient theme={"system"}
  // Avoid sequential transaction fetching
  const signatures = await connection.getSignaturesForAddress(address, { limit: 100 });
  const transactions = await Promise.all(
    signatures.map(sig => connection.getTransaction(sig.signature))
  );
  // ~1s + (200ms * 100 txs) = ~21s
  // Also note: getSignaturesForAddress doesn't include token account transactions
  ```

  ```typescript ✅ Fast (Helius Exclusive) theme={"system"}
  // Use getTransactionsForAddress for full history including token accounts
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'getTransactionsForAddress',
      params: [
        address,
        {
          transactionDetails: 'full',
          limit: 100,
          filters: { tokenAccounts: 'balanceChanged' }
        }
      ]
    })
  });
  // ~100ms total - includes complete token history in one call
  ```
</CodeGroup>

### Histórico de Transferências

Quando você só precisa de movimentação de token ou SOL — pagamentos, atividade de portfólio, reconciliação de saldos — use [`getTransfersByAddress`](/docs/pt-BR/rpc/gettransfersbyaddress) (exclusivo do Helius, requer um [Plano de Desenvolvedor](/docs/pt-BR/billing/plans) ou superior). Ele retorna objetos de transferência analisados e legíveis, com proprietários, mentes, quantidades e decimais já resolvidos, para que você evite a análise de transações por completo:

```typescript theme={"system"}
// Parsed USDC transfers received by a wallet - no manual parsing needed
const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransfersByAddress',
    params: [
      address, // Wallet owner address, not a token account
      {
        mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
        direction: 'in',
        limit: 100
      }
    ]
  })
});
// Each transfer includes parsed sender, recipient, amount, decimals, and uiAmount
```

Regra geral: use `getTransactionsForAddress` quando precisar de cargas úteis completas de transações ou atividade não relacionada a transferências, e `getTransfersByAddress` quando precisar de registros de transferências limpos para livros-razão e acompanhamento de pagamentos.

## Monitoramento em Tempo Real

### Inscrições de Contas

<CodeGroup>
  ```typescript ❌ Polling theme={"system"}
  // Avoid polling - wastes resources
  setInterval(async () => {
    const accountInfo = await connection.getAccountInfo(pubkey);
    // Process updates...
  }, 1000);
  ```

  ```typescript ✅ WebSocket theme={"system"}
  // Use WebSocket subscriptions for real-time updates
  const subscriptionId = connection.onAccountChange(
    pubkey,
    (accountInfo, context) => {
      // Handle real-time updates
      console.log('Account updated:', accountInfo);
    },
    'confirmed',
    { encoding: 'base64', dataSlice: { offset: 0, length: 100 }}
  );
  ```
</CodeGroup>

### Monitoramento de Contas de Programa

```typescript theme={"system"}
// Monitor specific program accounts with filters
connection.onProgramAccountChange(
  programId,
  (accountInfo, context) => {
    // Handle program account changes
  },
  'confirmed',
  {
    filters: [
      { dataSize: 1024 },
      { memcmp: { offset: 0, bytes: ACCOUNT_DISCRIMINATOR }}
    ],
    encoding: 'base64'
  }
);
```

### Monitoramento de Transações

```typescript theme={"system"}
// Subscribe to transaction logs for real-time monitoring
const ws = new WebSocket(`wss://mainnet.helius-rpc.com/?api-key=${API_KEY}`);

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'logsSubscribe',
    params: [
      { mentions: [programId] },
      { commitment: 'confirmed' }
    ]
  }));
});

ws.on('message', (data) => {
  const message = JSON.parse(data);
  if (message.params) {
    const signature = message.params.result.value.signature;
    // Process transaction signature
  }
});
```

## Padrões Avançados

### Lógica de Retentativa Inteligente

```typescript theme={"system"}
class RetryManager {
  private backoff = new ExponentialBackoff({
    min: 100,
    max: 5000,
    factor: 2,
    jitter: 0.2
  });

  async executeWithRetry<T>(operation: () => Promise<T>): Promise<T> {
    while (true) {
      try {
        return await operation();
      } catch (error) {
        if (error.message.includes('429')) {
          // Rate limit - wait and retry
          await this.backoff.delay();
          continue;
        }
        throw error;
      }
    }
  }
}
```

### Processamento Eficiente em Memória

```typescript theme={"system"}
// Process large datasets in chunks
function chunk<T>(array: T[], size: number): T[][] {
  return Array.from({ length: Math.ceil(array.length / size) }, (_, i) =>
    array.slice(i * size, i * size + size)
  );
}

// Process program accounts in batches
const allAccounts = await connection.getProgramAccounts(programId, {
  dataSlice: { offset: 0, length: 32 }
});

const chunks = chunk(allAccounts, 100);
for (const batch of chunks) {
  const detailedAccounts = await connection.getMultipleAccountsInfo(
    batch.map(acc => acc.pubkey)
  );
  // Process batch...
}
```

### Pooling de Conexão

```typescript theme={"system"}
class ConnectionPool {
  private connections: Connection[] = [];
  private currentIndex = 0;

  constructor(rpcUrls: string[]) {
    this.connections = rpcUrls.map(url => new Connection(url));
  }

  getConnection(): Connection {
    const connection = this.connections[this.currentIndex];
    this.currentIndex = (this.currentIndex + 1) % this.connections.length;
    return connection;
  }
}

const pool = new ConnectionPool([
  'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY',
  'https://mainnet-backup.helius-rpc.com/?api-key=YOUR_API_KEY'
]);
```

## Monitoramento de Desempenho

### Acompanhar Uso de RPC

```typescript theme={"system"}
class RPCMonitor {
  private metrics = {
    calls: 0,
    errors: 0,
    totalLatency: 0
  };

  async monitoredCall<T>(operation: () => Promise<T>): Promise<T> {
    const start = Date.now();
    this.metrics.calls++;
    
    try {
      const result = await operation();
      this.metrics.totalLatency += Date.now() - start;
      return result;
    } catch (error) {
      this.metrics.errors++;
      throw error;
    }
  }

  getStats() {
    return {
      ...this.metrics,
      averageLatency: this.metrics.totalLatency / this.metrics.calls,
      errorRate: this.metrics.errors / this.metrics.calls
    };
  }
}
```

## Melhores Práticas

### Níveis de Comprometimento

<Tabs>
  <Tab title="processed">
    * **Uso para**: Inscrições WebSocket, atualizações em tempo real
    * **Latência**: \~400ms
    * **Confiabilidade**: Bom para a maioria das aplicações
  </Tab>

  <Tab title="confirmed">
    * **Uso para**: Consultas gerais, informações de contas
    * **Latência**: \~1s
    * **Confiabilidade**: Recomendado para a maioria dos casos de uso
  </Tab>

  <Tab title="finalized">
    * **Uso para**: Liquidação final, operações irreversíveis
    * **Latência**: \~32s
    * **Confiabilidade**: Máxima certeza
  </Tab>
</Tabs>

### Gerenciamento de Recursos

<CheckboxList>
  * Use `dataSlice` para limitar tamanhos de carga
  * Implemente filtragem do lado do servidor com `memcmp` e `dataSize`
  * Agrupe operações para reduzir idas e voltas
  * Armazene em cache resultados para evitar chamadas redundantes
  * Feche inscrições WebSocket quando terminar
  * Implemente disjuntores para tratamento de erros
</CheckboxList>

### Tratamento de Erros

```typescript theme={"system"}
// Implement robust error handling
async function robustRPCCall<T>(operation: () => Promise<T>): Promise<T> {
  try {
    return await operation();
  } catch (error) {
    if (error.code === -32602) {
      // Invalid params - fix request
      throw new Error('Invalid RPC parameters');
    } else if (error.code === -32005) {
      // Node behind - retry with different node
      throw new Error('Node synchronization issue');
    } else if (error.message.includes('429')) {
      // Rate limit - implement backoff
      throw new Error('Rate limited');
    }
    throw error;
  }
}
```

## Armadilhas Comuns a Evitar

<Warning>
  **Evite estes erros comuns:**

  * Fazer polling em vez de usar inscrições WebSocket
  * Buscar dados completos de conta quando apenas dados parciais são necessários
  * Não usar operações em lote para múltiplas consultas
  * Ignorar limites de taxa e não implementar lógica de retentativa adequada
  * Usar `finalized` comprometimento quando `confirmed` é suficiente
  * Não fechar inscrições, levando a vazamentos de memória
</Warning>

## Métodos Relacionados

As técnicas de otimização neste guia referenciam os seguintes métodos WebSocket e RPC:

<CardGroup cols={2}>
  <Card title="getTransactionsForAddress" href="/docs/pt-BR/rpc/gettransactionsforaddress">
    Histórico completo de transações com filtragem, ordenação e suporte a conta de token (exclusivo do Helius)
  </Card>

  <Card title="getTransfersByAddress" href="/docs/pt-BR/rpc/gettransfersbyaddress">
    Histórico de transferências de token e SOL analisado para pagamentos e reconciliação (exclusivo do Helius)
  </Card>

  <Card title="getTransaction" href="/docs/pt-BR/api-reference/rpc/http/gettransaction">
    Recupere detalhes completos da transação por assinatura
  </Card>

  <Card title="getProgramAccounts" href="/docs/pt-BR/api-reference/rpc/http/getprogramaccounts">
    Busque todas as contas pertencentes a um programa
  </Card>

  <Card title="getTokenAccountsByOwner" href="/docs/pt-BR/api-reference/rpc/http/gettokenaccountsbyowner">
    Obtenha contas de token para uma carteira
  </Card>

  <Card title="getMultipleAccountsInfo" href="/docs/pt-BR/api-reference/rpc/http/getmultipleaccounts">
    Busca em lote de múltiplos detalhes de contas
  </Card>

  <Card title="getAccountInfo" href="/docs/pt-BR/api-reference/rpc/http/getaccountinfo">
    Obtenha informações sobre uma única conta
  </Card>

  <Card title="accountSubscribe" href="/docs/pt-BR/api-reference/rpc/websocket/accountsubscribe">
    Inscreva-se para mudanças de conta via WebSocket
  </Card>

  <Card title="programSubscribe" href="/docs/pt-BR/api-reference/rpc/websocket/programsubscribe">
    Inscreva-se para mudanças de conta de programa via WebSocket
  </Card>

  <Card title="logsSubscribe" href="/docs/pt-BR/api-reference/rpc/websocket/logssubscribe">
    Inscreva-se para logs de transações via WebSocket
  </Card>
</CardGroup>

## Resumo

Implementando essas técnicas de otimização, você pode alcançar:

* **Redução de 60-90%** no volume de chamadas de API
* **Latência significativamente menor** para operações em tempo real
* **Redução no uso de banda larga** através de consultas direcionadas
* **Melhor resiliência a erros** com lógica de retentativa inteligente
* **Custos operacionais mais baixos** através do uso eficiente de recursos

<Card title="Próximos Passos" icon="arrow-right">
  Pronto para implementar essas otimizações? Confira nosso [Guia de Otimização de Transações](/docs/pt-BR/sending-transactions/optimizing-transactions) para melhores práticas específicas de transações.
</Card>