BASE VAULT
DOCUMENTATION // BASE CHAIN
← App

01 · Overview

Base Vault is an on-chain mystery puzzle game built on Base. Players crack ciphers and answer cryptic challenges across escalating tiers to earn rare, non-purchasable NFTs. Everything — progression, payments, and rewards — is recorded on Base mainnet.

The core idea: every reward is earned, not bought. Only players who prove their skill across all three tiers can claim a Vault Legend.

02 · How to Play

A wallet on Base is required to play and track progress.

  • > TIER 1 — Free. Solve 3 terminal ciphers (Caesar, binary, logic, crypto, math). 3 wrong answers locks the wallet for a short cooldown.
  • > TIER 2 — Mint the Vault Key NFT (33 USDC) to unlock the next chamber.
  • > TIER 3 — Mint the Master Key NFT (66 USDC) for the final descent.
  • > CLAIM — Complete all tiers, get allowlisted, and mint your Vault Legend (gas only).

The game UI is available in English, German, Arabic, Chinese and Japanese — puzzles and AI hints included.

03 · Rewards & NFTs

  • 👑 Vault Legend — the grand prize. Only 333 will ever exist, across 3 phases: Early (1–33), Core (34–133), Final (134–333). Cannot be bought, traded for, or gifted into — only earned.
  • 🔑 Vault Key / Master Key — tiered access NFTs that gate Tier 2 and Tier 3.
  • 💎 Vault Points (VP) — an ERC-20 reward token earned on tier completion.
  • 📊 Vault Leaderboard — completion scores recorded on-chain.

04 · Vault Shop — x402 Payments

Stuck on a cipher? The Vault Shop sells premium hints for 0.01 USDC, paid instantly with the x402 protocol on Base — no checkout, no account.

  • 1. The client signs an EIP-3009 transferWithAuthorization (gasless) — one wallet signature, no gas.
  • 2. The server returns HTTP 402 with payment requirements, then verifies and settles the payment.
  • 3. Settlement runs through the Coinbase CDP facilitator for real USDC settlement on Base mainnet.
  • 4. The hint unlocks. A Builder Code attribution is declared on the resource server.

05 · Vault Guardian — AgentKit AI

The Vault Guardian is an AgentKit agent (ViemWalletProvider on Base mainnet, with wallet + ERC-20 action providers) wired to Claude. It gives cryptic, adaptive hints that grow more helpful the more you struggle — without ever revealing the answer.

The Guardian replies in the player's selected language, matching the rest of the UI.

06 · Smart Contracts

07 · Tech Stack

  • · Next.js (App Router) · TypeScript · Tailwind
  • · wagmi + viem + RainbowKit (multi-RPC fallback on Base)
  • · Solidity (ERC-721 / ERC-20), verified on Basescan
  • · x402 + @coinbase/x402 (CDP facilitator) for payments
  • · @coinbase/agentkit + Claude for the Vault Guardian
  • · Farcaster Mini App · IPFS (Pinata) for NFT metadata
BASE VAULT // ON-CHAIN MYSTERY // BUILT ON BASE