Skip to content
You are reading Pantheon development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Overview

Access the Pantheon API using:

Information applying to JSON-RPC, RPC Pub/Sub, and GraphQL is included below.

Enabling API Access

Use the --rpc-http-enabled, --ws-http-enabled, and --graphql-http-enabled options to enable API access.

Service Hosts

Use the --rpc-http-host, --rpc-ws-host, and --graphql-http-host options to specify the host on which the API service listens. The default host is 127.0.0.1.

Set the host to 0.0.0.0 to allow remote connections.

Caution

Setting the host to 0.0.0.0 exposes the API service connection on your node to any remote connection. In a production environment, ensure you use a firewall to avoid exposing your node to the internet.

Service Ports

Use the --rpc-http-port, --rpc-ws-port, and --graphql-http-port options to specify the port on which the API service listens.

The default ports are:

  • 8545 for JSON-RPC over HTTP
  • 8546 for JSON-RPC over WebSockets
  • 8547 for GraphQL over HTTP

Ports must be exposed appropriately.

Host Whitelist

To prevent DNS rebinding, incoming HTTP requests, WebSockets connections, and GraphQL requests are only accepted from hostnames specified using the --host-whitelist option. By default, localhost and 127.0.0.1 are accepted.

If your application publishes RPC ports, specify the hostnames when starting Pantheon.

Example

pantheon --host-whitelist=example.com

Specify “*” for --host-whitelist to effectively disable host protection.

Caution

Specifying “*” for --host-whitelist is not recommended for production code.

Not Supported by Pantheon

Account Management

Account management relies on private key management in the client which is not implemented by Pantheon.

Use eth_sendRawTransaction to send signed transactions; eth_sendTransaction is not implemented.

Use third-party wallets for account management.

Protocols

Pantheon does not implement the Whisper and Swarm protocols.

Questions or feedback? You can discuss issues and obtain free support on Pantheon Gitter channel.
For paid professional support by PegaSys, contact us at [email protected]