Networks

Pocket Network runs several separate environments — distinct copies of the entire system, each serving a different purpose. This is similar to how a software company might have production, staging, and local development environments.

Each network is completely independent. Tokens on one network have no value or meaning on another. An account can exist on multiple networks, but its balance and activity are separate on each.

Network Overview

MainNet

MainNet is the live, production network. This is where real economic activity happens — real POKT tokens are staked, real data requests are served, and real rewards are earned.

When to use: When you are ready to participate for real — staking tokens, serving data, or accessing blockchain services in production.

Key facts: Chain ID is pocket, block time is approximately 1 minute, and tokens have real economic value.

Explorers

Block explorers let you browse blockchain activity in a user-friendly way — look up any account’s balance, view transactions, see who is staked:

• StakeNodes Explorer
• PoktScan Explorer
• BlockVal Explorer

A GraphQL playground is also available for advanced queries.

Faucet

The MainNet faucet distributes MACT (Migration Account Claim Tokens) for participants migrating from Morse. Available at faucet.pocket.network or through pocketd.

Beta TestNet

A fully functional copy of Pocket Network that uses worthless test tokens. Think of it as a flight simulator — everything works the same as MainNet, but nothing is at stake. Ideal for:

• Learning the protocol before committing real tokens
• Testing configurations for Suppliers, Gateways, or Applications
• Experimenting with new features as they are released
• Debugging issues in a safe environment

Key facts: Chain ID is pocket-lego-testnet (renamed from pocket-beta in v0.1.31), block time is approximately 5 minutes.

Explorers

• StakeNodes Explorer
• PoktScan Explorer

A GraphQL playground is available.

Faucets

TestNet tokens are free — anyone can request them:

• POKT: faucet.beta.testnet.pokt.network/pokt/
• MACT: faucet.beta.testnet.pokt.network/mact/

LocalNet

A miniature Pocket Network that runs on a single computer. You have full control — start, stop, reset, and configure it however you like. Primarily used by developers building on the protocol or testing complex multi-actor scenarios.

Key facts: Chain ID is pocket, runs entirely on your machine, pre-funded test accounts available automatically.

Connecting to a Network

What Are RPC Endpoints?

To interact with any blockchain, your software needs a connection point. An RPC endpoint is a network address that accepts requests and returns responses — like a phone number for the network.

Pocket Network provides three types of endpoints, all accessing the same blockchain data:

• RPC — The standard way to send transactions and query the chain. Most tools use this by default.
• gRPC — A high-performance alternative used by backend systems and infrastructure operators.
• REST — A web-friendly interface accessible from any HTTP client or browser.

Automatic Connection

The pocketd CLI simplifies connections with a --network flag. Instead of specifying endpoint URLs and chain IDs manually, just tell it which network: main, beta, or local. Browser wallets like Keplr and Soothe Vault handle connections through their own interfaces.

Token Denominations

upokt is the base unit the blockchain uses internally. Most user-facing tools display balances in POKT for readability, but staking configs and on-chain parameters are often expressed in upokt.

Choosing the Right Network

Network Overview

MainNet

Endpoints

Explorers

• StakeNodes · PoktScan · BlockVal
• Soothe GraphQL Playground

Faucet (MACT)

• Web: faucet.pocket.network
• CLI:

pocketd faucet fund mact myWallet --network=main

Connecting to MainNet

Using the --network flag:

pocketd query bank balance pokt1youraddress upokt --network=main

Query a specific block:

pocketd query block --type=height 69 --network=main

Using curl directly:

curl -X POST https://sauron-rpc.infra.pocket.network/block

Override with a custom RPC node:

pocketd query bank balance pokt1youraddress upokt \
  --chain-id=pocket \
  --node=https://rpc-pocket.blockval.io

Genesis

The MainNet genesis file is at pokt-network/pocket-network-genesis.

Beta TestNet

Endpoints

Explorers

• StakeNodes · PoktScan
• Soothe GraphQL Playground

Faucets

• POKT (web): faucet.beta.testnet.pokt.network/pokt/
• MACT (web): faucet.beta.testnet.pokt.network/mact/
• CLI:

pocketd faucet fund upokt myWallet --network=beta
pocketd faucet fund mact myWallet --network=beta

By address instead of key name:

pocketd faucet fund upokt pokt1youraddress --network=beta

Connecting to Beta TestNet

pocketd query bank balance pokt1youraddress upokt --network=beta

Query a block:

pocketd query block --type=height 0 --network=beta

Using curl:

curl -X POST https://sauron-rpc.beta.infra.pocket.network/block

Genesis

The Beta TestNet genesis file is at pokt-network/pocket-network-genesis.

LocalNet

Endpoints

Starting LocalNet

From a checkout of the poktroll repository:

make localnet_up

Stop:

make localnet_down

Reset and restart:

make localnet_reset

Querying LocalNet

pocketd query bank balance pokt1youraddress upokt --network=local

Since local is the default when no --network flag is provided:

pocketd query bank balance pokt1youraddress upokt

LocalNet Faucet

The local faucet server runs at http://localhost:8080:

pocketd faucet fund upokt myWallet --network=local

How the —network Flag Works

The --network flag sets multiple connection flags at once:

You can override any individual flag while using --network:

pocketd query bank balance pokt1youraddress upokt \
  --network=beta \
  --node=https://my-custom-rpc.example.com

Quick Reference Commands

# Check balance on MainNet
pocketd query bank balance pokt1abc123 upokt --network=main

# Send tokens on Beta TestNet
pocketd tx bank send myWallet pokt1recipient 5000000upokt \
  --network=beta --gas=auto --fees=1upokt

# Query application parameters on MainNet
pocketd query application params --network=main

# List all suppliers on Beta TestNet
pocketd query supplier list-supplier --network=beta