Introduction

Environment variables

Below you can find a list of supported variables. These are listed by category:

General

VariableDescriptionRequiredDefault value
DATABASE_URLPostgresql database URIYes(empty)
SECRET_KEYShared key used for JWTYes(empty)
BLOBSCAN_API_PORTBlobscan API will listen on this portNo3001
FEEDBACK_WEBHOOK_URLFeedback webhook URLNo(empty)

Network

VariableDescriptionRequiredDefault value
BEACON_NODE_ENDPOINTBeacon node endpointYes(empty)
EXECUTION_NODE_ENDPOINTExecution node endpointYes(empty)
CHAIN_IDEVM chain idYes1
NETWORK_NAMENetwork's nameYesethereum
NEXT_PUBLIC_SUPPORTED_NETWORKSLink to other pages from the Network menuNo[{"label":"Mainnet","href":"https://blobscan.com/"},{"label":"Holesky","href":"https://holesky.blobscan.com/"},{"label":"Sepolia","href":"https://sepolia.blobscan.com/"}]
NEXT_PUBLIC_BEACON_BASE_URLBeacon explorer URLYeshttps://beaconcha.in/
NEXT_PUBLIC_EXPLORER_BASE_URLBlock explorer URLYeshttps://etherscan.io

Blob storages

Blobscan can be configured to use any of the following blob storages:

  • Postgres
  • Google Cloud Storage
  • Ethereum Swarm

At the moment Postgres is the default storage and Blobscan won't be able to run if you disable it. Other storages are optional.

Postgres

VariableDescriptionRequiredDefault value
POSTGRES_STORAGE_ENABLEDStore blobs in postgres database (default storage)Notrue

Google Cloud Storage

VariableDescriptionRequiredDefault value
GOOGLE_STORAGE_ENABLEDStore blobs in GCSNofalse
GOOGLE_STORAGE_BUCKET_NAMEGCS bucket nameNo(empty)
GOOGLE_STORAGE_PROJECT_IDGCS project IDNo(empty)
GOOGLE_SERVICE_KEYGoogle Cloud service keyNo(empty)
GOOGLE_STORAGE_API_ENDPOINTGoogle Cloud API endpoint (for development)No(empty)

Ethereum Swarm

VariableDescriptionRequiredDefault value
SWARM_STORAGE_ENABLEDStore blobs in SwarmNofalse
SWARM_BATCH_IDSwarm address of the stampIf SWARM_STORAGE_ENABLED=true(empty)
SWARM_STAMP_CRON_PATTERNCron pattern for swarm jobNo*/15 * * * *
BEE_ENDPOINTBee endpointNo(empty)
BEE_DEBUG_ENDPOINTBee debug endpointNo(empty)

Blob propagator

VariableDescriptionRequiredDefault value
BLOB_PROPAGATOR_ENABLEDEnable blob propagationNofalse
REDIS_URIRedis hostNoredis://localhost:6379/1

Indexer

VariableDescriptionRequiredDefault value
BLOBSCAN_API_ENDPOINTBlobscan API endpointYes(empty)
RUST_LOGConfigure loggerNoblob-indexer=INFO
SENTRY_DSN_INDEXERSentry SDNNo(empty)

Telemetry

VariableDescriptionRequiredDefault value
METRICS_ENABLEDExpose the /metrics endpointNofalse
TRACES_ENABLEDEnable instrumentation of functions and sending traces to a collectorNofalse
OTLP_AUTH_USERNAMEUsername for basic authentication. E.g. Grafana Cloud IDNo(empty)
OTLP_AUTH_PASSWORDPassword for basic authentication. E.g. Grafana Cloud TokenNo(empty)
OTEL_EXPORTER_OTLP_PROTOCOLOTLP transport protocol to be used for all telemetry data.No(empty)
OTEL_EXPORTER_OTLP_ENDPOINTBase endpoint URL for any signal type, with an optionally-specified port numberNo(empty)
Previous
Installation