PGAI Wallet Docs

Everything about the Pentagon AI wallet — from your first sign-in to the self-custody internals and developer integration. Type in the search box to filter every section on this page; it works offline once loaded.

Nothing matched. Try fewer words, or an error code like WAL-NET-OFFLINE.
New users

What is the PGAI Wallet?

The Pentagon AI wallet is your account for the Pentagon Games ecosystem. It comes in three forms that all hold the same account: a browser extension, a mobile app, and the Telegram mini-app. You sign in with your normal Pentagon Games account — if you already log in to pentagon.games, you are most of the way there.

It runs on Pentagon Chain (chain id 3344) only, and its currency is $PC. There is deliberately no chain picker and no way to import outside wallets — see Why you can't import a seed phrase. For anything on Ethereum you still use MetaMask, Rabby or another Ethereum wallet — see Which wallet for what.

New users

Which wallet for what: PGAI or MetaMask / Rabby

The PGAI Wallet is the wallet we make for you, so you can start playing without installing MetaMask or Rabby first. It is built for Pentagon Chain (chain id 3344) only. It does not work on Ethereum or any other network, by design.

You want to…Use
Play Pentagon games, hold $PC and Pentagon Chain NFTs, top up Points with $PCPGAI Wallet
Sign in to Pentagon sites with a walletEither: your PGAI Wallet, or a MetaMask / Rabby wallet already linked to your Pentagon account
Anything on Ethereum, such as buying $PC with ETH or USDC on the bridge, trading on the marketplace, or receiving a prize delivered on EthereumMetaMask, Rabby or another Ethereum wallet

Already use MetaMask or Rabby?

Keep using it. If it is linked to your Pentagon account it still signs you in, exactly as before. Nothing is removed. A PGAI Wallet adds a Pentagon Chain wallet that follows you across Telegram, the browser extension and the app, with one tap to move it to a new device.

Want your PGAI Wallet in Rabby or MetaMask too?

Export its recovery phrase from Settings and import it into the other app. It is the same wallet and the same address there, so it still signs you in to Pentagon. Keep that phrase as safe as you would any wallet's: whoever has it controls the wallet.

The PGAI app shows Pentagon Chain only. Your PGAI address is the same address on every network, so if anything is sent to it on Ethereum or another chain it does arrive, but you will only see and move it in another wallet app where you imported your recovery phrase.
Save your recovery phrase. If you lose every device and never saved it, the PGAI Wallet and its $PC are gone; nobody can restore them, not even us. Your Pentagon account and your Points are not affected: they belong to your account, not to the wallet.
New users

Your balances, explained

New users

Signing in and unlocking

First time: sign in with your Pentagon Games email/username and password (or sign up in the app). Then you create a wallet with its own account password.

After that, unlocking is signing in: enter your account password, and the wallet proves who you are to Pentagon Games with a cryptographic signature — no PG password needed again on that device.

Sign in on another device

Already signed in somewhere? Choose Sign in on another device there, and scan the code it shows with your new device. Scanned sessions can browse but can never export your account — that protection is deliberate.

Pentagon Games staff will never ask for your password or your export file. Anyone who does is trying to rob you.
New users

Sending $PC

Account → Transfer. Pick a friend (fills their address for you) or paste an address. You always see the amount, network fee and total before anything is signed, and nothing moves until you tap Sign & send.

Transfers are final. There is no undo on a blockchain. Double-check the address — and only send to Pentagon Chain (3344) addresses.

If a transfer fails you'll get a precise error code. WAL-SEND-FAIL means nothing left your account; WAL-SEND-UNCONFIRMED means it was broadcast but not yet confirmed — check your Activity before retrying so you don't pay twice.

New users

Receiving funds

Account → Receive shows your address and a scannable code. Your address is public information — safe to share with anyone.

When your PGAI wallet is empty or low on $PC, the wallet (and the browser extension) says so and highlights Receive in orange: send $PC to that address from another wallet you own on Pentagon Chain. To top up Points instead, use Top up Points on the PG Balance card.

Your address accepts funds on Pentagon Chain (3344) only. Funds sent from other chains will not arrive.
New users

Friends and “My card”

Friends are other Pentagon Games players. Adding one lets you send $PC by name — no address copying — and appear in each other's games.

My card is your shareable QR code: anyone who scans it adds you as a friend and opens your agent, exactly like tapping your physical Pentagon NFC card. Each code works once and refreshes every ~30 seconds, so an old screenshot of it is useless.

Friends you met in person — by tapping Pentagon cards or scanning a card in person — show a 🤝 Met in person badge. Friends added by username show without it.

New users

Collectibles (NFTs) and trading

Account → Collectibles shows your items and the market13 marketplace. Each trade carries a 2.5% marketplace fee — buyers pay it on top, sellers receive the price minus it — plus a small network fee. Every price and fee is shown for confirmation before anything is signed.

Some prices are in WPC (wrapped $PC): it is always worth exactly 1 $PC = 1 WPC — a technical wrapper the marketplace uses for offers, not a different token with a different price.

New users

Topping up Points

On the PG Balance card, tap Top up Points. It opens the official pentagon.games top-up page already signed in as you (inside Telegram, Stars packs are right on the card). How many Points you get depends on the pack — packs can carry bonus Points. Points live on your PG Balance and are spent inside Pentagon games.

What you’re buying: everything bought here is Points, a non-transferable credit to spend in Pentagon games. It is not a crypto purchase. The Pentagon AI wallet holds your Points and also works as your crypto wallet.

More ways to top up: with $PC

Under the packs, open More ways to top up. After you tick the agreement there are two routes, and both end with $PC arriving in your Points account, where it shows as Points:

What you agree to: it is one way, so $PC sent to your Points account stays there as Points; and Points can’t be transferred or cashed out. You spend them across Pentagon games and redeem rewards with them.

New users

Signing in with Telegram

Inside Telegram, opening the wallet is signing up: your Telegram account becomes your Pentagon account on first open — no email, no password to invent. If an email already belongs to a Pentagon account, you'll see a masked hint and can sign in to link the two rather than creating a duplicate.

A Telegram session works like an email magic-link session: it can play, spend Points and top up. Moving value out of self-custody — sending from your PGAI wallet or binding a new external wallet — always asks for your wallet password. Under Complete your profile you can add and verify an email so the account is yours even outside Telegram.

New users

Telegram Stars and the $1 starter pack

Inside Telegram, the Points packs on the Account tab are paid with Telegram Stars, without leaving the app. The cheapest is the $1 starter — 25 Points; it's shown once per account and disappears after you've taken it. On iOS and Android, if you don't have Stars yet, Telegram asks you to buy them first. If you close that sheet, a Pay by card instead button appears right above the packs with the same pack preselected; it opens the web top-up page in your browser, already signed in, so a Telegram-only account can finish by card without an email or password. Points arrive within a minute or two of a successful payment.

On Telegram Desktop (and the Telegram web apps) Telegram can't sell you Stars from inside an app — a Telegram limitation, not ours — but paying with Stars you already have works. If you already have Points and nothing sent you here short of any, the desktop screen just says so, with an Add more Points with Stars button that unfolds the packs. The packs each carry a ⭐ Get N Stars button: it opens your @PentaPetsBot chat, where a button takes you to Telegram's own Stars top-up for exactly that amount (the same page as Telegram → Settings → My Stars → Top Up Balance; a walkthrough with screenshots is one tap away in the wallet). Come back, tap Pay N ⭐ here, and your Stars pay for the pack. Already have enough Stars? Telegram's page says so — just come back and pay. Or open the wallet from Telegram on your phone — same account, same Points, one tap. Card on pentagon.games stays as the last option.

The card button hands you to the website with a one-time link that works once and for 60 seconds. If the browser was slow to open, the page says the link expired and offers a button back to the Telegram wallet; one more tap makes a fresh link. Nothing is ever charged by an expired link.

Points are a spending balance inside Pentagon games, not a token: they can't be swapped for $PC, cashed out or transferred. How many Points a pack gives you depends on the pack, and packs can carry bonus Points.

New users

Invite people (referrals)

Under Invite people on the Account tab you'll find your invite links. If your account has a private referral code — an 8-character code that is yours for good — you get two links that carry it: a Telegram link (t.me/PentaPetsBot/pal?startapp=<code>) and a website link (pentagon.games/join/<code>). Every account also has links that carry its username (pentagon.games/sign-up/<username>, and a Telegram version where the username allows it). Inside Telegram the card shows your Telegram links; in the web wallet and the extension it shows the website links too.

The card tells you which links count. Anyone who creates their account through a link that counts is recorded as your referral, permanently, and appears in your list. Links that don't count yet are still shown, and the card says so until they do. Links you shared before keep working. First come, first counted: whoever invited someone first keeps them; you can't refer yourself, and two accounts can't refer each other.

Rewards come only from what the people you invited top up — never for merely signing up — and are paid in Points. The Invite people card shows whether rewards apply to your account and your share. Shares are for members (Bronze Key and up) and come only from people who join through your private link; people who join through a username link are still recorded as yours, but don't earn a share.

New users

Add to your home screen

In Telegram, the Account tab offers Add to home screen. It uses Telegram's own install prompt, so one tap puts Pentagon AI on your phone's home screen — opening straight into your account, no searching for the chat. Dismiss it once and it stays out of the way.

New users

The AI companion

The Agent tab is your own AI companion for the Pentagon ecosystem — a 3D character that idles on the tab, and a chat bar that stays pinned at the bottom. It knows your account: your Points, which games you've played, and what your next step is (top up, secure your account with an email, create your PGAI wallet). Greetings and common asks answer instantly; it only ever offers things it can actually do — open a game, open top-up, the Marketplace, Members — and does them in one tap. You can change which character represents you under About this agent.

Two honest rules:

Only you can talk to the agent in your wallet. The agent on your NFC card is the public version that greets people who tap your card.

New users

Error codes & getting help

Every error in the wallet carries a code like WAL-SEND-FAIL. If something keeps failing, join our Discord — discord.gg/pentagongamesxp — and file a ticket including the code. That code tells the team exactly which path failed.

Common codes

CodeWhat it meansWhat to do
WAL-NET-OFFLINEYour device has no internet.Reconnect and retry. Your funds are safe.
WAL-NET-FAILCouldn't reach Pentagon servers.Retry shortly; it's usually momentary.
WAL-LOGIN-FAILSign-in was refused.Check credentials; use the password reset on pentagon.games.
WAL-UNLOCK-BADPASSWrong account password.Check caps lock; try again — there is no lockout.
WAL-RPC-UNREACHABLEPentagon Chain couldn't be read.Balance display only — funds unchanged. Refresh.
WAL-WALLETINFO-FAILPG Balance couldn't load.Your Points are unchanged; tap Retry.
WAL-SEND-FAILTransfer failed before broadcast.Nothing left your account. Check balance covers amount + fee.
WAL-SEND-UNCONFIRMEDBroadcast, confirmation timed out.Check Activity/Explorer before retrying — it may still complete.
WAL-SEND-ESTIMATEFee couldn't be estimated.Network unreachable, or amount exceeds balance.
WAL-ACTIVITY-LOADActivity list couldn't load.Explorer hiccup — display only, retry.
WAL-TOPUP-OPENTop-up page couldn't open.Retry; if persistent, top up at pentagon.games directly.
WAL-LOGIN-QR / WAL-LOGIN-NOTOKENQR sign-in / session issue.Show a fresh code and rescan; retry sign-in.
WAL-SYNC-TIMEOUT / WAL-SYNC-MISMATCHDevice-sync problems.Restart the sync on both devices; codes must match.
Advanced

Custody model — what's yours, what's managed

Advanced

How your key is protected (the vault)

Your key is sealed in a local vault: the password is stretched with PBKDF2 (600,000 iterations, SHA-256) and the key material encrypted with AES-256-GCM. Unlocking happens in memory only; locking wipes it. The vault never leaves your device except in the device-to-device sync, where it is re-sealed to the receiving device's key and rejected unless it derives the same address.

There is no server escrow and no recovery: lose the password on every device and the account is gone. That is the self-custody trade — the same property that means nobody else can take it.

Advanced

Why you can't import a seed phrase

By design the wallet creates keys, never imports them. Imported phrases have unknowable histories — pasted into sites, stored in notes apps, phished. Refusing import means every PGAI account key was born inside the app's vault and has never existed in plaintext anywhere else. To use an existing external wallet, connect it to your PG account and it appears watch-only.

Advanced

Signature auto-login

After the first sign-in, your wallet key doubles as your credential: unlocking signs a time-stamped challenge (Sign up to Pentagon Games,<unix>) which the backend verifies against your registered address. No PG password is stored on the device; the session token lives in memory only.

Advanced

Moving to a new device (sync)

Device sync transfers your sealed account device-to-device with a number-match confirmation on both screens. The payload is sealed to an ephemeral key of the receiving device and is rejected unless it derives to your registered address. The old device becomes retired: it can still send its remaining balance out, but new rewards go to the current device. QR-delegated sessions can never be a sync source.

Advanced

Pentagon Chain parameters

ParameterValue
Chain ID3344 (hex 0xd10)
Native currency$PC
ExplorerPentagon Explorer (linked from every transaction in the app)
Wrapped tokenWPC — always 1:1 with $PC
Developers

Connecting your dapp (EIP-6963)

The browser extension announces itself via EIP-6963 — no window.ethereum squatting:

Any 6963-aware stack (wagmi v2, RainbowKit v2, viem) discovers it automatically. Users approve each site once (connect approval), and every signature or transaction request is approved per-request in the wallet UI. Pentagon Chain (3344) only — requests for other chains are refused.

Full integration guide with a wallet-picker snippet: see WALLET-INTEGRATION.md in the wallet repository, or ask in the developer channel on Discord.

Developers

Sign in with Pentagon (overlay)

Add a Pentagon sign-in to any page on pentagon.games. It opens as an overlay over your page, like Stripe Checkout: our sign-in in a frame, your page stays put, and the user never leaves. It authenticates only: no seed, no wallet setup, no signature. The session can spend Points (signed server-side) but holds no key.

Drop-in

<script src="/pgai/web-local-app/pg-signin.js" defer></script>

<a href="/pgai/web-local-app/?continue=home2" data-pg-signin>Log in</a>

<script>
document.addEventListener('click', function (e) {
  var a = e.target.closest && e.target.closest('[data-pg-signin]')
  if (!a || !window.PGSignIn) return
  e.preventDefault()
  PGSignIn.open().then(function (r) { if (r.ok) location.reload() })
})
</script>

The href is the fallback: if the script fails, the link still signs the user in full-page and returns them to the page (allowlisted keys: home2, redeem).

Using the login

const token = PGSignIn.token()  // localStorage.pg_token
fetch('https://api.account.pentagon.games/user/info', {
  headers: { Authorization: 'Bearer ' + token },
})  // 401 -> PGSignIn.signOut(), show Log in again
CallWhat it does
PGSignIn.open()Overlay. Resolves { ok, reason? }; reason: 'cancelled' on ✕, Escape or outside click.
PGSignIn.openPopup()Same flow in a popup window.
PGSignIn.redirect(key)Full page, returns to an allowlisted page.
PGSignIn.token() / signOut()Read or remove the login token in this browser.

How it stays safe

Developers

Resolving addresses to PG identities

Ecosystem services can resolve a Pentagon Chain address to a PG username via the identity backend's address-lookup endpoint (API-key gated; covers connected, PGAI and managed addresses). This is what powers “sending to @name” in the wallet. Request access through the Pentagon developer channel.