---
title: "Documentazione dell'endpoint RPC di Arc"
description: "Usa ERPC come endpoint RPC di Arc Network per richieste HTTP JSON-RPC."
canonical: "https://erpc.global/it/doc/arc-rpc/general/"
locale: "it"
---

# Documentazione dell'endpoint RPC di Arc

## Documentazione dell'endpoint RPC di Arc

Usa ERPC come tuo endpoint RPC di Arc™ per richieste HTTP JSON-RPC. Arc RPC fa parte delle RPC APIs di ERPC all'interno della nostra Global Edge Blockchain Infrastructure, e la chiave API può essere gestita dalla ERPC Web Dashboard.

Puoi usare la stessa chiave RPC di Solana, Ethereum e Avalanche.

Passa la tua chiave API nel parametro di query `api-key`, oppure inviala come `Authorization: Bearer <YOUR_API_KEY>`. Se sono presenti entrambi, viene usato il parametro di query.

### Endpoint

Invia richieste JSON-RPC 2.0 come HTTP POST a:

```text
https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>
```

oppure all'host dedicato:

```text
https://arc.erpc.global?api-key=<YOUR_API_KEY>
```

Le richieste sono accettate solo su `/`.

### Esempi

Ecco un esempio di richiesta HTTP con la chiave API nel parametro di query.

```bash
curl 'https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

Ecco la stessa richiesta con la chiave API nell'header `Authorization`.

```bash
curl 'https://edge.erpc.global/arc' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/it)

### Richieste in batch

Sono supportati batch JSON-RPC da 1 a 100 chiamate per richiesta HTTP. Ogni chiamata deve avere un proprio `id`, e i valori di `id` non devono ripetersi all'interno di un batch. Ogni chiamata in un batch viene misurata come chiamata a sé stante. Il corpo della richiesta può arrivare a 1 MiB.

### Utilizzo dei token

L'utilizzo viene misurato in token, e la tariffa in token può variare in base al metodo. Ogni chiamata in un batch HTTP viene misurata separatamente.

### Limiti del piano Free

Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi. Il limite viene conteggiato per account, non per endpoint, quindi anche una richiesta a un'altra chain può rientrare nel conteggio. Una richiesta inviata prima riceve una risposta HTTP `429`, e l'header `retry-after` indica l'attesa in secondi.

Con il piano Free, una richiesta che contiene due o più chiamate JSON-RPC riceve una risposta HTTP `429`, e nessuna delle sue chiamate viene inviata: ogni chiamata riceve un errore JSON-RPC con codice `-32041`. Invia invece queste chiamate una alla volta.

### Metodi supportati

L'endpoint serve questi 38 metodi, raggruppati per namespace.

- `eth_*` (24): `eth_blockNumber`, `eth_call`, `eth_chainId`, `eth_estimateGas`, `eth_feeHistory`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByHash`, `eth_getBlockByNumber`, `eth_getBlockReceipts`, `eth_getBlockTransactionCountByHash`, `eth_getBlockTransactionCountByNumber`, `eth_getCode`, `eth_getLogs`, `eth_getProof`, `eth_getStorageAt`, `eth_getTransactionByBlockHashAndIndex`, `eth_getTransactionByBlockNumberAndIndex`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_maxPriorityFeePerGas`, `eth_sendRawTransaction`, `eth_syncing`
- `net_*` (3): `net_listening`, `net_peerCount`, `net_version`
- `web3_*` (2): `web3_clientVersion`, `web3_sha3`
- `txpool_*` (3): `txpool_content`, `txpool_inspect`, `txpool_status`
- `debug_*` (4): `debug_traceBlockByHash`, `debug_traceBlockByNumber`, `debug_traceCall`, `debug_traceTransaction`
- `trace_*` (2): `trace_block`, `trace_transaction`

Un metodo o un percorso non elencato riceve una risposta HTTP `400`.

### Codici di stato della risposta

| Stato HTTP | Significato |
| --- | --- |
| 200 | Risposta JSON-RPC upstream. Anche un errore JSON-RPC viene restituito con HTTP `200`: mantiene l'`id` della richiesta e l'`error.code`, il suo `error.message` è `ERPC upstream error`, e `error.data` non viene restituito. |
| 400 | Un metodo o un percorso al di fuori dell'elenco dei metodi supportati, una richiesta JSON-RPC non valida, un batch vuoto o con più di 100 chiamate, un `id` duplicato in un batch, o un corpo superiore a 1 MiB. |
| 401 | Chiave API mancante o non valida, oppure non è soddisfatta una restrizione di IP o di Origin impostata sulla chiave. |
| 405 | Un metodo di richiesta diverso da POST. |
| 426 | È stato richiesto un WebSocket Upgrade. L'endpoint supporta solo HTTP. |
| 429 | Rate limitato, compresi i limiti del piano Free indicati sopra: più di una richiesta ogni 10 secondi, oppure due o più chiamate in una richiesta. Se è presente un header `retry-after`, attendi il numero di secondi indicato. |
| 502 | La richiesta upstream non è stata completata: una risposta upstream non riuscita, una risposta superiore a 8 MiB, o nessuna risposta entro 30 secondi. |
| 503 | Il servizio è temporaneamente non disponibile. |

### Metodi RPC di Arc e documentazione

La documentazione di Arc descrive i metodi JSON-RPC standard di Ethereum su Arc e, per i parametri, rimanda alla relativa documentazione di riferimento. Un metodo assente dall'elenco qui sopra riceve una risposta HTTP `400`, anche se la documentazione di Arc lo elenca.

[https://docs.arc.io/arc/references/rpc-endpoints](https://docs.arc.io/arc/references/rpc-endpoints)

Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates.
