Was nicht abgerechnet wird: Fehlercodes und Abrechnungsregeln

BlockVectra erfasst Anfragen in Compute Units (CU). JSON-RPC- und Data-API-Aufrufe werden erst abgerechnet, nachdem eine Antwort erhalten wurde. Dieser Leitfaden fasst die Regeln zur Abrechnungsermittlung über HTTP-Statuscodes, JSON-RPC-Aufrufe und die Data-API hinweg zusammen, zusammen mit empfohlenen Maßnahmen für Entwickler.

HTTP-Statuscodes und Abrechnungsregeln

Die Abrechnungsermittlung und Verhaltensregeln für Antworten auf HTTP-Ebene sind wie folgt:

Hinweis: Beim Zugriff über Cloudflare kann Cloudflare 52x- oder 1015-Fehlerseiten zurückgeben; diese werden nicht vom Dienst generiert.

Abrechnungs- und Guthaben-Response-Header: Beim Senden von x-bv-meter: 1 bei HTTP-Anfragen (gilt sowohl für JSON-RPC als auch für die Data-API) gibt eine Antwort, bei der mindestens ein Aufruf abgerechnet wurde, x-bv-cu-charged (die für diese Anfrage abgerechneten Compute Units oder die Summe über abgerechnete Aufrufe eines Batches) und x-bv-balance-units (die verbleibenden Guthabeneinheiten des Kontos direkt nach dieser Abrechnung, bei Überziehung negativ; weggelassen, wenn das Guthaben unbekannt ist) zurück. Anfragen ohne x-bv-meter: 1, Antworten, bei denen nichts abgerechnet wurde, sowie 402-, 403-, 429- oder 503-Fehlerantworten lassen beide Header weg. Diese Response-Header sind für Browser-Skripte über CORS zugänglich, während WebSocket sie nicht verwendet. Das Guthaben zieht die gesamte noch nicht abgerechnete Nutzung einmal aufgerundet auf ganze Einheiten ab; die stündliche Verrechnung rundet ab, sodass das gemeldete Guthaben nach der Verrechnung um bis zu eine Einheit steigen kann.

JSON-RPC-Fehlercodes und Abrechnungsregeln

Derselbe Fehlercode kann von der Plattform oder vom Node stammen, und die Abrechnung unterscheidet sich:

• Von der Plattform selbst generierte Fehler: werden niemals abgerechnet;
• Vom Node zurückgegebene Fehler: werden unverändert weitergeleitet und mit der Methodengewichtung abgerechnet, mit nur den unten aufgeführten Node-Fehlercodes als Ausnahmen.

Regeldetails

• Vom Node nicht abgerechnete Fehler: Die Node-Fehler -32002 (Batch-Timeout), -32003 (Batch-Antwort zu groß) und -32600 (Batch als Ganzes abgelehnt) weisen darauf hin, dass der Node den Aufruf vorzeitig abgebrochen hat; diese und alle Benachrichtigungen im selben Batch werden nicht abgerechnet. Node-Fehler -32601 (offengelegte Methode nicht implementiert) und -32603 (interner Node-Fehler) werden über HTTP oder WebSocket nicht abgerechnet und wirken sich nicht auf andere Aufrufe oder Benachrichtigungen im Batch aus. Darüber hinaus werden 4444 (bereinigter Block) und -32000 (historischer Status außerhalb des Statusverlaufsfensters des Nodes, definiert durch state_window_blocks in GET /v1/chains) nicht abgerechnet und wirken sich nicht auf andere Aufrufe im Batch aus.
• Vom Node abgerechnete Fehler: Andere vom Node zurückgegebene Fehler werden mit der Methodengewichtung abgerechnet, wenn sie das Ergebnis der Chain melden, wie z. B. execution reverted (-32000 oder 3 mit data), der eigene Node-Fehler -32602 invalid argument.
• Guthabenzulassung und Synchronisierung: -32020 weist auf unzureichendes Kontoguthaben hin und erfordert eine Aufladung; wenn das Guthaben bekannt ist, übermitteln error.data.balance_units und error.data.balance_cu den verbleibenden Restbetrag (dieser kann negativ sein). Ein neu erstellter Key kann einige Sekunden lang -32021 (503) zurückgeben; warten Sie Retry-After ab und wiederholen Sie die Anfrage.
• Upstream-Ausfälle: Ein von der Plattform aufgrund eines Upstream-Kommunikationsfehlers oder einer fehlerhaften Antwort (upstream unavailable, no response from upstream, malformed upstream response) generierter Fehler -32603 enthält data.reason: upstream_unavailable.
• Abrechnung von Benachrichtigungen: Benachrichtigungen (204) werden mit ihren Methodengewichtungen abgerechnet.

Tabelle der JSON-RPC-Fehlercodes

Data-API-Abrechnungsregeln

Die Data-API kapselt schreibgeschützte Chain-Daten in REST-Endpunkten. Ihre Abrechnung und Fehlerbehandlung folgen diesen Regeln:

Regeldetails

• Nur 2xx-Erfolgsantworten werden abgerechnet.
• Nicht verfügbare Operationen außerhalb der Abdeckung (wie z. B. nicht unterstützte Chains oder Blöcke außerhalb der Trace-Abdeckung) geben HTTP 422 no_coverage zurück, was nicht abgerechnet wird, aber für Rate-Limits zählt.
• HTTP 401-, 402-, 404- und 429-Antworten werden nicht abgerechnet. Für Response-Header (x-bv-meter: 1) siehe HTTP-Statuscodes und Abrechnungsregeln.

Tabelle der Data-API-Statuscodes

Guthaben abfragen (GET /v1/account)

Ein Inhaber eines API keys kann Guthaben- und Key-Kontingentdetails direkt überprüfen, ohne dass Kosten anfallen oder Compute Units (CU) abgezogen werden:

curl -H "x-api-key: $BLOCKVECTRA_API_KEY" https://api.blockvectra.com/v1/account

• Kostenlos und nicht abgerechnet: GET /v1/account ist kostenlos. Es wird niemals abgerechnet, zieht keine CU ab und gibt HTTP 200 mit dem aktuellen Guthaben zurück, selbst wenn dieses null oder negativ ist (es gibt niemals 402 zurück).
• Authentifizierung: Die Key-Authentifizierung verwendet ausschließlich den Header x-api-key (Pfad-Keys und Bearer-Token werden nicht akzeptiert). Ein fehlender Header gibt 401 missing_api_key zurück; ungültige oder widerrufene Keys geben 401 invalid_api_key zurück. (Abgelaufene Keys geben 403 key_expired zurück; vorübergehende Dienstausfälle geben 503 auth_unavailable oder billing_unavailable mit Retry-After zurück.)
• Rate-Limiting: Hat ein unabhängiges Limit von 5 Anfragen pro Sekunde pro Key-ID, unabhängig von der CU-Messung und Abrechnung. Ein Überschreiten des Limits gibt HTTP 429 rate_limited mit einem Retry-After-Header zurück.

Antwortfelder:

• key_id: Der Bezeichner-String des API keys.
• plan: Tariftyp des Kontos (free, wenn das Konto über ein Freikontingent für die Aufrufrate verfügt; andernfalls paid).
• balance_units: Verbleibendes Kontoguthaben in Einheiten (kann null oder negativ sein).
• balance_cu: Verbleibendes Guthaben umgerechnet in Compute Units (CU).
• balance_as_of_age_ms: Millisekunden, die vergangen sind, seit das Guthaben aus seiner Datenquelle gelesen wurde.
• key: Key-spezifische Limits und Kontingentdetails:
  • cu_per_sec: Wiederauffüllrate des Token-Buckets in CU pro Sekunde.
  • burst_cu: Burst-Kapazität des Token-Buckets in CU.
  • cu_cap: Lebenslange CU-Obergrenze für diesen Key oder null, wenn unbegrenzt.
  • cu_cap_remaining: Verbleibende CU unter cu_cap oder null, wenn unbegrenzt (kann null oder negativ sein).
  • expires_at: RFC 3339-Ablaufzeitstempel oder null, wenn der Key niemals abläuft.

Beispielantwort:

{
  "key_id": "<key_id>",
  "plan": "<plan>",
  "balance_units": <integer>,
  "balance_cu": <integer>,
  "balance_as_of_age_ms": <integer>,
  "key": {
    "cu_per_sec": <integer>,
    "burst_cu": <integer>,
    "cu_cap": <integer_or_null>,
    "cu_cap_remaining": <integer_or_null>,
    "expires_at": "<expires_at_or_null>"
  }
}

Preise und Upgrades

Die spezifischen Kosten für alle abgerechneten Aufrufe werden durch veröffentlichte CU-Gewichtungen bestimmt:

• Um die Gewichtungen für alle Methoden und Operationen einzusehen, siehe die Methodengewichtungstabelle und die JSON-RPC-CU-Abrechnungsregeln.
• Einzelheiten zu Tarifpreisen und Verrechnung finden Sie auf der Preisseite.
• Upgrade auf einen kostenpflichtigen Tarif: Eine bezahlte Aufladung hebt das Limit für Aufrufe pro Sekunde des kostenlosen Tarifs auf; jeder Key unterliegt weiterhin den CU-Rate- und Burst-Limits.

On-Chain-Aufladeprozess

Wenn Ihr Kontoguthaben unzureichend ist oder Sie einen höheren Durchsatz benötigen, laden Sie in der Konsole On-Chain anhand dieser Schritte auf:

1. In der Konsole anmelden: Melden Sie sich in der BlockVectra-Konsole an.
2. Zur Abrechnungsseite navigieren: Gehen Sie zur Abrechnungsseite.
3. Ihre dedizierte Adresse abrufen: Kopieren Sie auf der Karte für die On-Chain-Aufladung die dedizierte Aufladeadresse Ihres Kontos oder scannen Sie den QR-Code.
4. Guthaben überweisen: Überweisen Sie ausschließlich unter Verwendung der auf der Seite aufgeführten unterstützten Netzwerke und USDC / USDT / USDG. Unterstützte Netzwerke und Mindestaufladebeträge werden in der Konsole angezeigt.
5. Automatische Gutschrift: Sobald sie On-Chain erkannt wurden, werden Transaktionen als „Processing“ angezeigt; nach der Gutschrift wird das Guthaben automatisch Ihrem Saldo hinzugefügt.

Wichtige Hinweise:

• Verwenden Sie ausschließlich die in der Konsole ausdrücklich aufgeführten Netzwerke und Token. Überweisungen auf nicht unterstützten Chains oder mit falschen Token können nicht automatisch gutgeschrieben werden.
• Stellen Sie sicher, dass jede Überweisung den in der Konsole angegebenen Mindestaufladebetrag erreicht.
• Sobald Ihre erste bezahlte Aufladung gutgeschrieben ist, wird Ihr Konto auf ein kostenpflichtiges Konto hochgestuft, wodurch das Limit für Aufrufe pro Sekunde des kostenlosen Tarifs aufgehoben wird.

Agent- oder Serverprogramme können Auflade-Endpunkte direkt über einen API key aufrufen; siehe den Leitfaden zur programmatischen Agent-Aufladung.

Webhook-Push-Abrechnung

Push verfügt über separate Gewichtungen für zugestellte Datenereignisse, erfolgreiche Verlaufsabfragen und abrechenbare Adresstage. Verwaltungsaufrufe außer dem Ereignisverlauf, fehlgeschlagene Zustellversuche, automatische Wiederholungsversuche und Steuerereignisse sind kostenlos. Jedes zugestellte Ereignis wird einmal abgerechnet; Kunden-Wiederholungen und kanonische Ereignisse, die nach einem Reorg erneut zugestellt werden, sind neue abgerechnete Zustellungen. Adressgebühren verwenden die maximale Adressanzahl jedes Abonnements während des UTC-Tages, während es online ist; der Freibetrag für Adressen des Kontos wird über Abonnements hinweg geteilt, wobei ältere Abonnements ihn zuerst nutzen. Eine Adresse in zwei Abonnements wird doppelt gezählt; das Hinzufügen von Chains ändert die Ereignisgebühren, nicht die Adressgebühren.

Siehe den Blockchain-Webhook-API-Leitfaden für die Einrichtung, Signaturprüfung und Zustellungs-Wiederherstellung. Der Stablecoin-Zahlungsleitfaden behandelt die Receipt-Validierung und das Polling-Backfill; WebSocket-Abonnements verwenden ihre eigene Verbindungs- und Benachrichtigungsmessung. Anfragefehler sind in der Fehlerreferenz aufgeführt. Die folgenden Gewichtungen stammen aus GET /v1/plans.

Nächste Schritte

• Datensatzverzeichnis durchsuchen, um jeden von BlockVectra indizierten Datensatz einzusehen.
• Kostenlosen Tarif und Preise ansehen, um zu prüfen, was Ihr Konto beinhaltet.
• In der Konsole anmelden, um einen API key zu erstellen.