# Bifrost Explorer

> Block explorer for the Bifrost mainnet (EVM-compatible, chain ID 3068, native coin BFC).
> The website is built for people. For machine use, prefer the JSON APIs below: they return the exact data the pages show.

Important: page HTML fetched without running JavaScript can contain loading placeholders (fake hashes, block numbers, prices, "4y ago" timestamps) in place of real values. Do not read facts from page HTML. Use the APIs.

## Network

- Chain name: Bifrost
- Chain ID: 3068 (0xbfc)
- Native coin: BFC, 18 decimals. API amounts of BFC (`value`, `fee`, `coin_balance`, ...) are integers in wei (1 BFC = 10^18 wei).
- Public JSON-RPC: https://public-01.mainnet.thebifrost.io/rpc
- Blocks are produced by validators (proof of stake). The API field for the block producer is `miner`.
- Validator set and staking live on chain in the staking contract 0x0000000000000000000000000000000000000400; the explorer shows them at https://explorer.mainnet.bifrostnetwork.com/validators

## Explorer links

Base: https://explorer.mainnet.bifrostnetwork.com

- Transaction: /tx/{transaction_hash}
- Address or contract: /address/{address_hash}
- Block: /block/{block_number_or_hash}
- Token: /token/{token_address}
- Cross-chain bridge transfer: /bridge-detail/{source_or_target_transaction_hash}
- Lists: /txs, /blocks, /tokens, /bridge, /validators
- Search: /search-results?q={query}

## Core API

Base: https://explorer-backend.mainnet.thebifrost.io/api/v2

Lists return `{ "items": [...], "next_page_params": {...} | null }`. To get the next page, repeat the request with every key of `next_page_params` added as a query parameter. `null` means the last page.

### Transactions

```bash
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions/{transaction_hash}'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions/{transaction_hash}/token-transfers'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions/{transaction_hash}/internal-transactions'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions/{transaction_hash}/logs'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions/{transaction_hash}/state-changes'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/transactions'            # latest transactions
```

Key fields of a transaction: `status` ("ok" / "error"), `result`, `block`, `timestamp`, `from.hash`, `to.hash`, `value` (wei), `fee.value` (wei), `method`, `decoded_input`, `token_transfers`, `confirmations`.

### Addresses

```bash
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}'                    # balance (coin_balance, wei), is_contract, name
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/counters'           # transactions_count, token_transfers_count, validations_count
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/transactions'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/token-transfers'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/internal-transactions'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/tokens'             # token balances
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/addresses/{address_hash}/coin-balance-history'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/smart-contracts/{contract_address}'           # verified source and ABI; 404 for non-contracts
```

### Blocks

```bash
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/blocks/{block_number_or_hash}'               # miner.hash, tx_count, gas_used
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/blocks/{block_number_or_hash}/transactions'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/blocks'                  # latest blocks
```

### Tokens

```bash
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/tokens/{token_address}'          # name, symbol, decimals, total_supply, holders
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/tokens/{token_address}/holders'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/tokens?q={name_or_symbol}'
```

Token amounts (`total.value`, `value`) are integers; divide by 10^`decimals` of the token.

### Search and network stats

```bash
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/search?q={address_hash_tx_hash_block_or_name}'
curl 'https://explorer-backend.mainnet.thebifrost.io/api/v2/stats'
curl 'https://explorer-stats.mainnet.thebifrost.io/api/v1/counters'
```

### Not available

These return an error or time out; do not rely on them:

- `/api/v2/transactions/{hash}/summary` (no transaction summaries)
- `/api/v2/token-transfers` and `/api/v2/internal-transactions` without an address or transaction
- `/api/v2/tokens/{token_address}/transfers` for tokens with very many transfers (may time out; query by address instead)

## Cross-chain bridge API

Base: https://bridge-api.thebifrost.io/mainnet

Bifrost bridges assets between this chain (3068) and other chains. A bridge transfer has a `source_hash` on the source chain and a `target_hash` on the destination chain. Look it up with either hash:

```bash
curl 'https://bridge-api.thebifrost.io/mainnet/bridge/history/tx/{source_or_target_hash}'
curl 'https://bridge-api.thebifrost.io/mainnet/bridge/history/count/20?page=1'          # latest transfers
curl -X POST 'https://bridge-api.thebifrost.io/mainnet/bridge/history/search?page=1&count=20' \
  -H 'Content-Type: application/json' \
  -d '{"from_addr": ["{address}"]}'      # every filter is a list: from_addr, to_addr, asset_symbol, source_chain, dest_chain, status
```

Response: `{ "status_list": [ ... ] }`. Fields: `source_chain`, `dest_chain` (chain IDs), `source_hash`, `target_hash`, `from`, `to`, `asset_symbol`, `amount`, `receive_amount` (decimal strings), `status` (e.g. "COMMITTED"), `action`, `start_date`, `end_date` (unix seconds).

## Common investigations

- What happened in a transaction: transaction → token-transfers → internal-transactions → logs. If the asset came from or went to another chain, also query the bridge API with the hash.
- Where funds went from an address: address → counters → token-transfers and transactions (follow `next_page_params`) → repeat for counterparties.
- Track a cross-chain transfer: bridge API with the hash you have → `status`, the other chain's hash, amounts → this chain's side in the core API (`/transactions/{hash}`) when `dest_chain` or `source_chain` is 3068.
- Who produced a block and what it contains: block → `miner.hash`, `tx_count`, `gas_used` → block transactions.
- Token overview: token → holders (top holders first).