> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thebingofi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Web3 on TheBingoFi

> Where the blockchain fits in, why it's there, and how to set up a wallet.

## Where is the web3?

Only in **skills**. Every match runs on the game server, so there is no wallet, no transaction and no gas fee while you play. The blockchain is used for one thing: Skill cards are NFTs that you hold in your own wallet.

## Why put skills on-chain?

> **You own them**
>
> Your skills live in your wallet, not in our database. You can see them on the block explorer.

> **Open supply**
>
> Each skill has a fixed maximum supply written into the contract, so anyone can check how many exist.

> **Always optional**
>
> You never need a wallet to play. Web3 is only for collecting and using skills.

## The GIWA testnet

TheBingoFi runs on **GIWA Sepolia**, the test network of GIWA, an Ethereum layer 2. On a testnet you use **test ETH**: it's free from a faucet and has no real-world value.

## Set up in four steps

**1. Get a wallet**

Install a browser wallet such as [MetaMask](https://metamask.io) or [Rabby](https://rabby.io).

**2. Add GIWA Sepolia**

| Setting | Value |
| - | - |
| Network name | GIWA Sepolia |
| RPC URL | `https://sepolia-rpc.giwa.io/` |
| Chain ID | `91342` |
| Currency symbol | ETH |
| Block explorer | [sepolia-explorer.giwa.io](https://sepolia-explorer.giwa.io) |

**3. Claim free test ETH**

Use the official faucet at [faucet.giwa.io](https://faucet.giwa.io) (0.005 ETH every 24 hours) or the backup at [faucet.lambda256.io/giwa-sepolia](https://faucet.lambda256.io/giwa-sepolia) (0.01 ETH every 24 hours). One claim is enough for your first skill.

**4. Connect and buy**

In the app, press **Connect Wallet** and link it. Open the [Market](https://app.thebingofi.xyz/market), pick a skill and press **Buy**. Then add it to your loadout before a Standard match.

> [!WARNING]
>
> TheBingoFi will never ask for your seed phrase or private key. Your wallet only signs in and approves the purchases you choose.

## Prices

Each skill has a base price in test ETH. The price goes up a little as a skill sells out and drifts down when nobody has bought it for a while. The Market always shows the current price and how many are left.

## Contracts

All contracts are deployed and verified on GIWA Sepolia.

> **Contract addresses**
>
> | Contract | What it does | Address |
> | - | - | - |
> | SkillCollection | The Skill NFTs (ERC-1155) | [0xA7D7...4DAB](https://sepolia-explorer.giwa.io/address/0xA7D707b9434B59132f0c5fCeE23C489564dB4DAB) |
> | Marketplace | Sells skills | [0x5392...aC82](https://sepolia-explorer.giwa.io/address/0x53926A22912Afa178b7D6BfC2181D9FE2616aC82) |
> | SkillRegistry | The skill catalog | [0x8177...3F54](https://sepolia-explorer.giwa.io/address/0x81776A9D532B3e4Cc79f4A2D16f20285f0Ec3F54) |
> | SkillFactory | Releases new skills | [0xE917...3B1C](https://sepolia-explorer.giwa.io/address/0xE917b2aAE8Cc651CCCe507FC2D29492D8F263B1C) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.