Configuration

Each CLI uses environment variables for API keys and optional service overrides. Set only what you need for the CLIs you use.

Assembly CLI

Assembly CLI works out of the box with no required configuration — it connects to Abstract's public RPC.

Variable	Required	Description
ABSTRACT_RPC_URL	No	Override the default Abstract RPC endpoint
ASSEMBLY_INDEXER_URL	No	Optional indexer for faster members list queries (falls back to onchain events)

Etherscan CLI

Variable	Required	Description
ETHERSCAN_API_KEY	Yes	API key from etherscan.io/myapikey. Works across all supported chains via Etherscan V2.

export ETHERSCAN_API_KEY="your-etherscan-api-key"

X API CLI

Variable	Required	Description
X_BEARER_TOKEN	For read-only access	App bearer token for search, profiles, timelines, lists, and trends
X_ACCESS_TOKEN	For write access	OAuth 2.0 user token for creating/deleting posts and sending DMs. Also used for reads when set.

# Read-only access
export X_BEARER_TOKEN="your-x-bearer-token"

# Full access (read + write)
export X_ACCESS_TOKEN="your-x-access-token"

TIP

If both tokens are set, X_ACCESS_TOKEN is preferred for all requests.

ERC-8004 CLI preview

Variable	Required	Description
ABSTRACT_RPC_URL	No	Override the default Abstract RPC endpoint
PRIVATE_KEY	For write commands	0x-prefixed signing key for registration, reputation, and validation transactions
IDENTITY_REGISTRY_ADDRESS	No	Override the identity registry contract address
REPUTATION_REGISTRY_ADDRESS	No	Override the reputation registry contract address
VALIDATION_REGISTRY_ADDRESS	No	Override the validation registry contract address
IPFS_GATEWAY	No	Gateway for resolving ipfs:// metadata (default: https://ipfs.io)

Observability (OpenTelemetry)

All spectra-tools CLIs include optional OpenTelemetry (OTEL) instrumentation for distributed tracing and metrics. When enabled, every CLI command automatically produces trace spans — including HTTP requests to upstream APIs.

When OTEL is not configured, the instrumentation is completely inert: no OTEL modules are loaded, no spans are created, and there is zero runtime overhead.

Environment variables

Variable	Required	Description
OTEL_EXPORTER_OTLP_ENDPOINT	No	OTLP collector endpoint (e.g. http://localhost:4318). Setting this enables telemetry automatically.
SPECTRA_OTEL_ENABLED	No	Explicitly enable (true) or keep disabled (any other value). Telemetry is enabled if this is true or OTEL_EXPORTER_OTLP_ENDPOINT is set.
OTEL_SERVICE_NAME	No	Override the service name reported in traces (default: spectra-<cli-name>).

Example: local collector

Run a local OpenTelemetry Collector or Jaeger instance:

# Start Jaeger all-in-one (includes OTLP receiver on port 4318)
docker run -d --name jaeger \
  -p 16686:16686 \
  -p 4318:4318 \
  jaegertracing/jaeger:latest

# Point CLIs at the collector
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

# Run a command — traces will appear in Jaeger UI at http://localhost:16686
etherscan-cli account balance 0x742d35cc6634c0532925a3b844bc454e4438f44e

Example: Grafana Cloud

export OTEL_EXPORTER_OTLP_ENDPOINT="https://otlp-gateway-prod-us-east-0.grafana.net/otlp"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Basic <base64-encoded-instance-id:api-key>"

What gets traced

• Command spans — each CLI command invocation creates a root span (cli.command.<name>) with sanitized arguments as attributes.
• HTTP spans — every API request made via the shared HTTP client creates a child span with method, URL, status code, and content length.
• Error recording — failed commands and HTTP errors are recorded as span events with stack traces.

Sensitive values (API keys, passwords, private keys, mnemonics) are automatically stripped from span attributes.

Security best practices

• Never commit API keys or private keys to version control
• Store secrets in environment variables or a secrets manager
• Prefer short-lived tokens when possible (especially X_ACCESS_TOKEN)
• For CI/CD, use your platform's secret management (GitHub Secrets, etc.)

Full example

# ~/.bashrc or ~/.zshrc

# Assembly (optional overrides)
export ABSTRACT_RPC_URL="https://api.mainnet.abs.xyz"

# Etherscan
export ETHERSCAN_API_KEY="your-etherscan-key"

# X API
export X_BEARER_TOKEN="your-x-bearer-token"
export X_ACCESS_TOKEN="your-x-access-token"

# ERC-8004 (preview)
export PRIVATE_KEY="0x..."