Vai al contenuto
Crypto.world

The Ledger

Helius lancia un’API server-side per la scansione degli eventi su Solana

Helius ha presentato Parsed Events Scan, un’API che cerca nelle cronologie degli indirizzi Solana usando filtri per programmi, istruzioni e mint di token. Le richieste costano 10 crediti più un credito ogni 1.000 transazioni esaminate.

Helius lancia un’API server-side per la scansione degli eventi su Solana

Il 3 novembre Helius ha presentato la sua API Parsed Events Scan, che offre agli sviluppatori un modo per cercare attività specifiche nelle cronologie degli indirizzi Solana lato server e ricevere risultati interpretati. L’endpoint filtra le transazioni per programma, istruzione, mint di token o combinazioni di questi criteri. Può restituire transazioni interpretate, firme o un conteggio delle attività corrispondenti.

I filtri operano sulla cronologia degli indirizzi

Prima dell’introduzione dell’endpoint, gli sviluppatori alla ricerca di un evento specifico dovevano recuperare pagine di firme, richiedere le transazioni singolarmente, decodificarle, applicare i filtri e ripetere il processo. Helius afferma che l’endpoint di scansione gestisce la ricerca nella cronologia e l’interpretazione dei dati sul server, restituendo solo le transazioni che corrispondono alla richiesta.

Gli sviluppatori possono specificare i nomi delle istruzioni presenti nell’IDL di un programma o usare i discriminatori dei dati grezzi delle istruzioni per i programmi privi di istruzioni con nome. Una singola richiesta può includere fino a 20 programmi. L’API supporta anche limiti per slot, tempo e firma, oltre a filtri per stato della transazione, commitment, ordine di presentazione e account di token.

Per le ricerche di token, l’API controlla i saldi precedenti e successivi alla transazione. Helius afferma che gli sviluppatori che esaminano un wallet dovrebbero impostare tokenAccounts su balanceChanged per includere i casi in cui un trasferimento interessa l’account di token del wallet anziché il wallet stesso. Per SOL nativo si usano le variazioni del saldo in lamport anziché i saldi dei token; l’endpoint esclude da tale corrispondenza la commissione di transazione pagata dall’indirizzo esaminato.

Limiti e costi della scansione

Ogni richiesta costa 10 crediti più un credito per ogni pagina di cronologia esaminata, con un massimo di 1.000 transazioni per pagina. Una richiesta che usa il budget predefinito di 10.000 transazioni costa al massimo 20 crediti, secondo Helius. Il metodo comparabile getTransactionsForAddress costa 100 crediti per pagina.

In un esempio, l’endpoint ha cercato le 10 richieste più recenti di riscossione delle commissioni dei creator tra 3.402 transazioni Pump.fun in 182 millisecondi, al costo di 14 crediti. Helius confronta questo risultato con i 350 crediti necessari per recuperare la stessa cronologia tramite getTransactionsForAddress. In un altro esempio relativo a Pump.fun, una scansione ha esaminato 261 record e restituito 100 corrispondenze di acquisto o vendita in 182 millisecondi, per 11 crediti.

Ogni richiesta può esaminare fino a 10.000 transazioni e restituire fino a 100 corrispondenze. Questi controlli sono separati: una richiesta può esaminare migliaia di transazioni e restituire solo poche corrispondenze. Gli sviluppatori possono usare limiti temporali o di slot e selezionare un indirizzo più circoscritto per limitare le scansioni non necessarie, afferma Helius.

Paginazione e transizione da Enhanced Transactions

Le risposte includono un riepilogo della scansione con il numero di transazioni esaminate e corrispondenti, l’ultimo slot e l’ora dell’ultimo blocco esaminati, il costo in crediti e il motivo per cui la scansione si è interrotta. Quando una risposta include un token di paginazione, gli sviluppatori possono inviarlo con la richiesta successiva. Helius avverte che un risultato vuoto può significare che la scansione ha raggiunto il budget di transazioni prima di trovare una corrispondenza, anziché che non esistano corrispondenze successive.

L’API Parsed Events succede all’API Enhanced Transactions di Helius, che secondo l’azienda è ora in modalità di manutenzione e non riceverà nuovi tipi di parser né nuove funzionalità. Durante la migrazione, le integrazioni esistenti devono tenere conto di uno schema di risposta diverso. Helius afferma che i suoi SDK TypeScript e Rust supportano l’endpoint di scansione, disponibile anche tramite la sua CLI e il suo MCP.

Fonti

  1. Fonte originale · Post del blog Helius helius.dev

Notizie correlate

Esplora

Altri articoli