MagicWebb

MagicWebb — Frequently Asked Questions

A non-custodial NFT marketplace on the Flare network. This FAQ answers the questions new users and traders ask most, in the same spirit as OpenSea, Blur, Magic Eden, and other marketplaces — adapted to how MagicWebb actually works.


General

What is MagicWebb?

A non-custodial marketplace for buying, selling, auctioning, and making offers on ERC-721 and ERC-1155 NFTs. Listings, auctions, bids, and offers are all settled on-chain by smart contracts that no role can pause, censor or reprice. The contracts stay upgradeable by a per-network admin key until that key is renounced, which makes the network permanently immutable — see IMMUTABILITY_TRANSITION.md. MagicWebb never takes custody of your NFTs or funds — the contracts move assets directly between buyer and seller.

What network does it run on?

Three networks, one site each. You can trade on Flare mainnet (chain ID 14, real FLR) and on the Coston2 testnet (chain ID 114, free test tokens). Songbird (chain ID 19) is browse-only.

Why can I only browse on Songbird? What does “browse-only” mean?

Each network runs its own copy of the marketplace with its own database. On Flare and Coston2 the trading contracts are live. On Songbird they are not deployed, by the owner’s decision, so the Songbird site is browse-only: you can browse listings and collections, search, see activity, connect your wallet and view your profile and balance, but buying, listing, auctions, bids and offers are switched off, because there is no marketplace contract on Songbird for them to use. Nothing is wrong with your wallet or your NFTs.

To trade, open Flare (real FLR) or Coston2 (free test tokens; the flows are identical) from the network menu, which always shows which networks trade. Switching network opens a different site, so you connect your wallet again there. NFTs on Songbird stay on Songbird: they cannot be listed from the Flare or Coston2 site. Trading on Songbird would open only if its contracts were deployed.

What wallet do I need?

Any EVM wallet that supports Flare/Coston2 — MetaMask or WalletConnect-compatible wallets. You sign in with your wallet (Sign-In-with-Ethereum); there is no email or password and no account to create. The site never remembers your wallet: it stays connected only in the browser tab you connected it in, a new tab or a fresh visit starts disconnected, and closing the browser ends your sign-in.

Is it custodial? Can MagicWebb freeze or take my NFT?

No. The contracts have no pause switch and no admin override over any trade or escrow. Your NFT stays in your wallet until a sale settles; offers escrow only the bidder’s funds in the contract, refundable until accepted.


Fees

What does it cost to use MagicWebb?

Action Cost
List an NFT (fixed price) Free
Create an auction Free
Place a bid Free
Make an offer Free
Successful sale 2%, paid by the seller (1.5% platform + 0.5% keeper gas fund)

You only ever pay network gas for the transaction itself. There are no listing fees, no bidding fees, and no offer fees.

Who pays the platform fee?

The seller. On any successful sale — a fixed-price buy, a settled auction, or an accepted offer — a flat 2% is deducted (1.5% to the platform wallet, 0.5% to the network’s keeper bot to fund its settlement gas) from the seller’s proceeds. The seller receives 98% of the sale price, minus the creator royalty when the collection sets one (see below). Buyers pay exactly the listed price.

Are bids and offers really free?

Yes. You send only the bid or offer amount; it’s held in escrow by the contract. If you’re outbid, your bid is refunded in full. If your offer is rejected or expires, your principal is refunded in full. Nothing is kept by the platform unless a sale completes.

Are there royalties to creators?

Yes, for collections that declare one. At the moment of every sale — a fixed-price buy, a settled auction, or an accepted offer — the marketplace asks the collection contract for its EIP-2981 royalty (royaltyInfo) at the actual sale price and pays it to the receiver the collection names, in the same transaction.

  • The seller pays it, like the platform fee. The buyer, bidder, or offerer pays exactly the listed price, winning bid, or offer amount — never more. The seller receives price − 2% platform fee − royalty. The 2% fee is always taken on the full price.
  • Capped at 10%. A collection that asks for more than 10% of the sale price is paid 10%; the sale still goes through.
  • No EIP-2981, no royalty. Collections that don’t implement the standard (or answer with nothing usable) pay no royalty, and the sale works exactly as before. A collection cannot use its royalty answer to block a sale.
  • A receiver that refuses the payment can’t block the sale either. The royalty is then held for that receiver in the marketplace contract, and they claim it with withdrawRefund() (it shows on their profile’s Refunds card).
  • Where you see it. Before you sign, the confirmation shows a “Creator royalty X% → 0x…” line and the seller’s net amount whenever the collection’s royalty is not zero. The figure is a preview: the sale pays whatever the collection answers at that moment, still capped at 10%.
  • Networks. The same rule applies on every network that has marketplace contracts (Flare and Coston2). Songbird is browse-only (no contracts deployed), so nothing trades there.

Buying

How do I buy a fixed-price NFT?

Open the token page, connect your wallet, and click Buy Now. You send exactly the listed price. The NFT transfers to you and the seller receives the price minus the 2% fee and any creator royalty — atomically, in one transaction.

What happens if two people try to buy the same NFT?

First settle wins. The marketplace is non-exclusive: the same NFT can be listed, in an auction, and have offers at once. The first transaction to settle takes the NFT; later attempts revert because the token has moved. No fee is taken on a reverted purchase.


Selling

How do I list an NFT?

Approve the marketplace contract for your collection once, then list with a price and expiry (one of 15 fixed durations: 1min, 3min, 5min, 10min, 15min, 30min, 45min, 1hr, 2hr, 4hr, 8hr, 12hr, 16hr, 20hr, or 24hr). Listing is free. You keep the NFT in your wallet until someone buys it.

How much do I receive on a sale?

98% of the sale price, minus the collection’s creator royalty if it sets one (at most 10%). The 2% platform fee and the royalty are deducted at settlement; the listing form and the confirmation show the exact amount before you sign.

Can I cancel a listing?

Yes, anytime before it sells, for the cost of gas.


Auctions

How do auctions work?

English (ascending) auctions, up to 24 hours (one of 15 fixed durations, 1min–24hr). The seller sets a reserve. Bidders bid for free; bids must overtake the current leader by at least +1 native token (FLR/SGB/C2FLR). Losers can withdraw early; keeper auto-settles instantly.

What is anti-snipe protection?

A bid placed within the final 3 minutes extends the auction end time by 3 minutes, so late snipes can’t end an auction before others can respond.

Who settles an auction?

The platform’s keeper bot settles instantly the moment the auction expires — you normally never have to do anything. If the keeper hasn’t settled yet, the auction winner or the seller can call settle themselves. Apart from addresses holding the platform’s KEEPER_ROLE, no one else can settle someone else’s auction. The NFT goes to the winner, and the seller receives the winning bid minus the 2% fee. If the seller has moved the NFT or revoked approval, the winner is refunded in full and the auction finalises without a sale.

Can an auction get stuck? Can the seller cancel it?

No, and no. Once any bid clears the reserve the seller can never cancel it through the contract. A met reserve is still not a binding promise to sell, though: the NFT stays in the seller’s wallet until settlement, so a seller who moves it or revokes the marketplace’s approval can back out at no cost beyond gas. No bidder loses money when that happens. The leading bidder does not have to wait for the end: claimSellerDefault returns their whole bid at once (no fee), but only when the collection shows that the seller no longer holds the NFT or no longer approves the marketplace. Every other bidder gets their escrow back in full through refundLosers, which the keeper runs automatically. And an auction can never be stuck: losing bidders can withdraw at any time before settlement (and are refunded through refundLosers after it), and if the keeper never settles, after 3 days the seller or the winning bidder can call forceCancel to unlock every bidder’s escrow (only those parties and the keeper may trigger it — no outsider can force-cancel someone else’s auction). Nothing on the protocol is pausable, so no one can freeze an auction either.


Offers

How do offers work?

Make an offer on any NFT in an offer-enabled collection (the collection owner opts in) with an amount and an expiry (one of 15 fixed durations: 1min–24hr). The offer amount is escrowed in the contract — it’s free to make and fully refundable. You hold one offer per NFT: offering again replaces it — the new amount becomes your whole offer and the old amount is refunded in the same transaction, so send the full amount you want, not a top-up. Editing does not refresh the expiry timer and cannot change the number of ERC-1155 units (cancel and offer again for that).

When am I charged?

Never as an offerer. If the owner accepts your offer, you receive the NFT and the seller receives your offer amount minus the 2% fee. If they reject it or it expires, you get your full principal back.

Can I withdraw an offer early?

Yes. Bidders can cancel their own offer before expiry via cancelOffer() for a full principal refund. Once expired, the keeper auto-refunds. The seller can also reject at any time.


Safety & Trust

Is MagicWebb finished? What does the “still in development” banner mean?

No. MagicWebb is in active development on every network — Coston2 (testnet), Flare and Songbird. The banner at the top of each site is there so nobody mistakes the current build for a finished product: features, screens and rules can still change between releases, the contracts have had no independent third-party audit yet, and anything you do on a mainnet (Flare; Songbird is browse-only) is at your own risk with real funds. You can dismiss the banner for the current browser tab; it comes back on the next visit and on every other network, because each network is its own site. Flows are the same everywhere, so practise on Coston2 with free test tokens first.

Are the contracts audited?

The contracts pass a full automated test suite and static analysis (Slither). No independent third-party audit has been completed yet; all reviews so far are internal or AI-assisted (contracts/AUDIT_REPORT.md). There is no bug bounty yet.

What protections are built in?

  • Reentrancy guards on every state-changing function (checks-effects-interactions).
  • Pull-payment fallback: if a push refund or payout fails, funds are parked for manual withdrawal rather than locked.
  • The fee rate is a compile-time constant — it cannot be changed on any deployment.
  • No pause switch — no entry or exit path has a halt function.
  • Every network (Coston2, Songbird, Flare) deploys unsealed with a single per-network admin whose only powers are instant contract upgrades, keeper replacement and rotating/renouncing its own key — it can never touch funds. It is root upgrade authority until sealed, though: an admin-signed manager upgrade can stop new sales. Exits stay open regardless, and renounceAdmin() ends the power for good. Immutability is a later, explicit per-network step: on the owner’s order the admin calls renounceAdmin(), after which there are no admin keys, no upgrades, and the fee recipient and single keeper are fixed forever.

What happens to my funds if something fails mid-transaction?

Transactions are atomic: either the whole trade completes or it reverts with no fee taken. Escrowed bids and offer principals are always recoverable via refund or the pull-withdrawal fallback.

Trust & safety

What does the ✓ checkmark on an NFT mean?

“This NFT fully works on MagicWebb.” Four facts, all checked automatically and re-checked as the indexer runs — no human curation, no application form:

  1. Its collection contract answers ERC-165 supportsInterface() as a standard ERC-721 or ERC-1155 NFT and its metadata has resolved (the collection-level “Verified”).
  2. The token has a name (its metadata could be read).
  3. Its image is stored on the marketplace itself (or is embedded in the metadata), so it renders reliably.
  4. Its current owner is known.

Tap the checkmark to see which checks passed. A missing checkmark names the check that has not passed yet — often just a brand-new collection whose metadata has not loaded. It does not mean MagicWebb vouches for the art, the creator, or the seller. Anyone can list from any collection either way.

Collection and token headers also show the collection’s own tier: Listed collection (tracked, still being checked) → Verified (standard contract + metadata) → Authentic (verified and the creator’s address is known).

What does the “★ Creator” badge mean?

It marks the creator: the on-chain owner of the collection contract (ERC-173 owner() — or the deployer), detected automatically. It shows in exactly three places: the creator’s own profile (“Creator of …”), the collection page, and an NFT that the creator still holds and originally minted. A collector who bought that NFT never gets the star — they show their own profile tag and the NFT’s ✓ instead. Every NFT also carries a “Created by …” link to the creator’s profile. Like the checkmark, it is computed from on-chain facts — not a curation or endorsement.

What is the collector badge next to an owner’s name?

A fun, deterministic label (e.g. SharinganHodl, PirateKingHodl) derived purely from the wallet address — the same wallet always gets the same name. It carries no on-chain meaning, no privileges, and no judgement; it just makes owners easier to recognise.

Why did my listing, auction or offer need a duration instead of a date?

The contracts accept fifteen fixed durations (1 min – 24 h) and compute the expiry on-chain from the block that mines your transaction. Picking a duration is the only way a wallet can satisfy that rule; the exact expiry is shown once the transaction confirms.

Where do refunds go?

If you are outbid, an offer you made is declined, or a payment could not be delivered, the amount is held for you in the contract. Your profile shows “Refunds waiting for you” with a one-tap Withdraw. Nothing expires and nothing is taken.