World Cup Viewer

Overview

WorldCupViewer is a read-only smart contract deployed on BSC mainnet that provides a clean, high-level view of 2026 FIFA World Cup match results.

Users and integrators can query WorldCupViewer to find out the winner of the entire tournament or the winner of any specific group, without needing to understand the underlying oracle structure.

Deployed address

Methods

All query methods return a MatchViewResult struct:

struct MatchViewResult {
    uint256 matchId;   // the match ID queried
    string matchName;  // human-readable name of the match
    bool isResolved;   // true if the oracle has settled this match
    uint256 teamId;    // ID of the winning team (0 if not yet resolved; 50 = draw/tie; 49 = others)
    string teamName;   // name of the winning team ("" if not yet resolved; "draw" for ties; "others" for unlisted teams)
}

getWorldCupWinner()

function getWorldCupWinner() external view returns (MatchViewResult memory);

Returns the winner of the 2026 FIFA World Cup (match ID 1).

• If isResolved = false, the tournament winner has not yet been determined.
• If isResolved = true, teamId and teamName identify the champion.

getGroupMatchWinners(uint256 matchId)

function getGroupMatchWinners(uint256 matchId) external view returns (MatchViewResult memory);

Returns the winner of a group stage match. Pass the match ID for the group you want to query (e.g., 2 for Group A, 3 for Group B, and so on up to 13 for Group L).

• If isResolved = false, the group winner has not yet been determined.
• If isResolved = true, teamId and teamName identify the group winner.

getMatchResult(uint256 matchId)

function getMatchResult(uint256 matchId) external view returns (MatchViewResult memory);

Returns the resolved result for any match ID directly from the underlying oracle mapping.

• If isResolved = false, the match is not settled yet and the result remains pending.
• If isResolved = true, teamId identifies the winning outcome mapped from oracle request IDs.
• For a draw outcome (teamId = 50), teamName is returned as a tie message in the format TeamA(teamIdA) and TeamB(teamIdB) are tied.
• For non-draw outcomes, teamName is the mapped team name for that teamId.

getTeamName(uint256 teamId)

function getTeamName(uint256 teamId) external view returns (string memory);

Looks up the name for a given teamId. The standard query range is 1-48 (listed teams). If teamId = 49, it represents "others"; if teamId = 50, it represents "draw". Unknown IDs return an empty string.

Reference data

Team ID mapping

Match ID reference

Chapter 1: winner (Match 1)

Match 1 — 2026 FIFA World Cup Winner

Resolves to the team that wins the entire 2026 FIFA World Cup. This match tracks all individually listed teams plus an "Others" catch-all for any team not given their own oracle question.

Chapter 2: group match winners (Match 2-13)

Match 2 — Group A Winner

Resolves to the team that wins Group A in the 2026 FIFA World Cup group stage.

Match 3 — Group B Winner

Resolves to the team that wins Group B in the 2026 FIFA World Cup group stage.

Match 4 — Group C Winner

Resolves to the team that wins Group C in the 2026 FIFA World Cup group stage.

Match 5 — Group D Winner

Resolves to the team that wins Group D in the 2026 FIFA World Cup group stage.

Match 6 — Group E Winner

Resolves to the team that wins Group E in the 2026 FIFA World Cup group stage.

Match 7 — Group F Winner

Resolves to the team that wins Group F in the 2026 FIFA World Cup group stage.

Match 8 — Group G Winner

Resolves to the team that wins Group G in the 2026 FIFA World Cup group stage.

Match 9 — Group H Winner

Resolves to the team that wins Group H in the 2026 FIFA World Cup group stage.

Match 10 — Group I Winner

Resolves to the team that wins Group I in the 2026 FIFA World Cup group stage.

Match 11 — Group J Winner

Resolves to the team that wins Group J in the 2026 FIFA World Cup group stage.

Match 12 — Group K Winner

Resolves to the team that wins Group K in the 2026 FIFA World Cup group stage.

Match 13 — Group L Winner

Resolves to the team that wins Group L in the 2026 FIFA World Cup group stage.

Chapter 3: group matches (Match 14-85)

Match 14 — Mexico vs. South Africa

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 15 — South Korea vs. Czechia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 16 — Canada vs. Bosnia and Herzegovina

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 17 — USA vs. Paraguay

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 18 — Qatar vs. Switzerland

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 19 — Brazil vs. Morocco

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 20 — Haiti vs. Scotland

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 21 — Australia vs. Türkiye

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 22 — Germany vs. Curaçao

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 23 — Netherlands vs. Japan

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 24 — Ivory Coast vs. Ecuador

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 25 — Sweden vs. Tunisia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 26 — Spain vs. Cape Verde

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 27 — Belgium vs. Egypt

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 28 — Saudi Arabia vs. Uruguay

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 29 — Iran vs. New Zealand

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 30 — France vs. Senegal

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 31 — Iraq vs. Norway

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 32 — Argentina vs. Algeria

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 33 — Austria vs. Jordan

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 34 — Portugal vs. DR Congo

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 35 — England vs. Croatia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 36 — Ghana vs. Panama

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 37 — Uzbekistan vs. Colombia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 38 — Czechia vs. South Africa

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 39 — Switzerland vs. Bosnia and Herzegovina

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 40 — Canada vs. Qatar

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 41 — Mexico vs. South Korea

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 42 — USA vs. Australia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 43 — Scotland vs. Morocco

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 44 — Brazil vs. Haiti

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 45 — Türkiye vs. Paraguay

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 46 — Netherlands vs. Sweden

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 47 — Germany vs. Ivory Coast

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 48 — Ecuador vs. Curaçao

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 49 — Tunisia vs. Japan

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 50 — Spain vs. Saudi Arabia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 51 — Belgium vs. Iran

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 52 — Uruguay vs. Cape Verde

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 53 — New Zealand vs. Egypt

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 54 — Argentina vs. Austria

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 55 — France vs. Iraq

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 56 — Norway vs. Senegal

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 57 — Jordan vs. Algeria

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 58 — Portugal vs. Uzbekistan

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 59 — England vs. Ghana

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 60 — Panama vs. Croatia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 61 — Colombia vs. DR Congo

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 62 — Bosnia and Herzegovina vs. Qatar

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 63 — Switzerland vs. Canada

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 64 — Morocco vs. Haiti

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 65 — Scotland vs. Brazil

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 66 — Czechia vs. Mexico

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 67 — South Africa vs. South Korea

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 68 — Curaçao vs. Ivory Coast

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 69 — Ecuador vs. Germany

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 70 — Japan vs. Sweden

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 71 — Tunisia vs. Netherlands

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 72 — Türkiye vs. USA

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 73 — Paraguay vs. Australia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 74 — Senegal vs. Iraq

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 75 — Norway vs. France

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 76 — Cape Verde vs. Saudi Arabia

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 77 — Uruguay vs. Spain

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 78 — Egypt vs. Iran

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 79 — New Zealand vs. Belgium

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 80 — Croatia vs. Ghana

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 81 — Panama vs. England

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 82 — Colombia vs. Portugal

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 83 — DR Congo vs. Uzbekistan

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 84 — Jordan vs. Argentina

Resolves to the winner of this match in the 2026 FIFA World Cup.

Match 85 — Algeria vs. Austria

Resolves to the winner of this match in the 2026 FIFA World Cup.