Skip to main content
Create an RPC endpoint in the Metal console. An endpoint is the URL your application uses to send requests to Metal. The gateway uses its endpoint ID to apply your access settings and track usage. Use Foundry’s cast to read the chain ID, block height, and finalized head.

Network details

1. Install cast

cast is Foundry’s command-line tool for EVM networks. Check whether it is already installed:
If the command is unavailable, install Foundry with its official installer:
Restart your terminal, then install the Foundry tools:
On Windows, run the installer from Git Bash or WSL. See the Foundry installation guide for other installation methods.

2. Create an RPC endpoint

  1. Sign in to the Metal console.
  2. Complete billing setup using the test card shown in the console. Testnet uses sandbox billing and grants $50 of RPC credit after setup.
  3. Open Endpoints and select + New endpoint.
  4. Give it a name, and select the testnet network.
  5. Select Create endpoint, then copy the Endpoint URL.
RPC credit pays for requests through your endpoint. It stays in the console’s billing account. Fund your blockchain address separately with test *USDZ from the faucet to pay for transfers and transaction gas. Sandbox billing uses test cards and makes no real charges.
The console generates the endpoint ID and includes it in the URL. Copy the whole URL into METAL_RPC_URL, replacing the placeholder below:

3. Verify the connection

Read the chain ID:
A healthy connection returns chain ID: 63825. Then read the current block number:
Run the block-number command again after a few seconds. A healthy connection returns an advancing block number.

4. Read finality

Metal exposes its finalized block through consensus_status:
The response includes head and finalized block pointers. You will use the finalized block to confirm settlement after sending your first transfer.

5. Verify with curl

Any JSON-RPC client can connect:
The result should be 0xf951.

Make your first transfer

Create test accounts, get *USDZ, and send a transfer through your endpoint.