2.9 KiB
description: Pantheon API
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
bash 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.