Giwapad docs
Giwapad is a token launchpad for GIWA, the Ethereum layer 2. It has two parts: a launchpad where anyone can launch and trade tokens, and 4,000 passes whose holders share 40% of every fee the launchpad takes.
Giwapad runs on GIWA Sepolia, the testnet. GIWA's mainnet was not live when this was written (November 2026). Test ETH and testnet passes have no value. Everything below describes what the contracts do; nothing here promises a return.
Overview
- The Giwapad Pass. An ERC-721 with a fixed supply of 4,000 and one design, drawn on chain. Free to mint on the testnet, one per wallet.
- The fee share. Every buy and sell on the launchpad pays a 1% fee. 40% of each fee is sent to the pass contract inside the same transaction and split equally over the passes that exist.
- Half fee. A wallet that holds a pass pays 0.5% instead of 1%.
- Mainnet allowlist. Each testnet pass in a wallet at the snapshot is one allowlist spot for the mainnet pass.
- The launchpad. One transaction creates a token with a supply of one billion, all of it on a curve in the contract. No presale, no creator allocation, no liquidity that anyone can remove.
The pass
| Property | Value |
|---|---|
| Standard | ERC-721, with ERC-2981 royalties (5%) |
| Supply | 4,000, fixed in the contract |
| Design | One card for every pass. Only the serial number (No. 0001 to 4000) and the edition (TESTNET or MAINNET) differ. No traits, no rarity. |
| Art | An animated SVG built by the PassArt contract: nothing is hosted anywhere |
| Testnet mint | Free (gas only), one per wallet, public |
| Mainnet mint | Allowlist from the testnet snapshot first, then public if any are left. The price is set by the owner before the mint opens and can then be locked. |
The card floats, tilts and shimmers because the SVG animates itself (SMIL), so it moves in wallets and on marketplaces that show SVG images. The website draws it with the same code the contract uses; the repository tests that the two are identical byte for byte.
The fee share
On every trade the launchpad calls distribute() on the pass contract with 40% of the fee. The pass contract keeps one number, accPerPass: how much every pass has earned since the start.
on each fee: accPerPass += amount / totalSupply a pass earns: accPerPass - (accPerPass when that pass was last settled)
- Equal split. Each fee is divided by the number of passes that exist at that moment. While the mint is still going, fewer passes share each fee; once all 4,000 exist, each pass gets 1/4,000.
- Claiming.
claim(ids)pays you what your passes earned. Nothing expires; you can claim once a day or once a year. - Selling or sending. When a pass moves, the contract settles it first: what it earned so far is credited to the wallet it leaves, and stays claimable there. The new holder earns from that moment.
- New passes. A pass minted later doesn't receive fees paid before it existed.
What that means in numbers
With all 4,000 passes minted, one pass receives volume x 1% x 40% / 4,000, which is one millionth of the volume traded at the full fee (half that on trades by pass holders).
| Launchpad volume | Fees (1%) | To all holders (40%) | Per pass |
|---|---|---|---|
| 100 ETH | 1 ETH | 0.4 ETH | 0.0001 ETH |
| 1,000 ETH | 10 ETH | 4 ETH | 0.001 ETH |
| 10,000 ETH | 100 ETH | 40 ETH | 0.01 ETH |
These are arithmetic, not forecasts. If nobody trades, the share is zero.
The launchpad
create(name, symbol, about, minTokens) deploys a new ERC-20 with a supply of 1,000,000,000 and puts all of it on a curve inside the launchpad contract. If you send ETH with the call, it buys from the curve in the same transaction.
- No allocation. The creator gets no tokens. Like everyone else, they buy from the curve.
- No pool to pull. The curve is the pool. There are no LP tokens and no function that removes liquidity, for the creator or for the team.
- Always sellable. The curve always holds the ETH that its sold tokens are worth, so every token bought can be sold back. The tests check this with random sequences of trades.
- No approval to sell. A launched token lets the launchpad move tokens without an allowance, and the launchpad's code only does that inside
sell, for the seller's own tokens. Between wallets it's an ordinary ERC-20. - Plain tokens. No owner, no mint function, no pause, no transfer tax.
Fees
| Share of each fee | How it's paid | |
|---|---|---|
| Pass holders | 40% | Sent to the pass contract in the same transaction; holders claim |
| The token's creator | 20% | Accrues in the launchpad; the creator calls claimCreatorFees() |
| The team | 40% | Anyone can call withdrawTeam(): 80% to the artist, 20% to the treasury |
The fee is 1% of the ETH in a buy and of the ETH out of a sell; 0.5% when the trader holds a pass. Launching a token costs only gas.
The roof
When the ETH in a token's curve first reaches the roof amount (0.1 ETH on the testnet), the token is marked roofed. It's a badge. Trading doesn't change and nothing migrates anywhere.
The curve
Each token has two numbers: the ETH in its curve and the tokens left in it. The curve adds a fixed virtual amount of ETH (0.05 ETH on the testnet) so that the price starts above zero.
price = (virtualEth + ethInCurve) / tokensLeft buying x ETH = tokensLeft * x / (virtualEth + ethInCurve + x) (x after the fee) selling n = (virtualEth + ethInCurve) * n / (tokensLeft + n) (before the fee)
That is a constant-product pool. With the testnet's 0.05 virtual ETH:
| ETH in the curve | Market cap | Sold from the curve |
|---|---|---|
| 0 | 0.05 ETH | 0% |
| 0.01 | 0.072 ETH | 16.7% |
| 0.05 | 0.2 ETH | 50% |
| 0.1 (roofed) | 0.45 ETH | 66.7% |
| 0.5 | 6.05 ETH | 90.9% |
A first buy of 0.001 ETH (after the 1% fee, 0.00099 ETH) gets about 19.4 million tokens: 1.94% of the supply. Large buys move the price a lot; the site shows the amount you will get before you send, and reverts if it would be more than 2% worse.
Testnet to mainnet
- Testnet. Mint the pass on GIWA Sepolia and use the launchpad with test ETH.
- Snapshot. At a block that will be announced before it happens, the list of testnet holders is read from the chain: one allowlist spot per pass held.
- Allowlist. The list becomes a Merkle root in the mainnet pass contract. The full list and every wallet's proof are published with the site, so anyone can check them against the testnet.
- Mainnet mint. Allowlisted wallets mint first; a public mint follows if passes are left. The mainnet pass works the same way as the testnet pass, with real ETH.
What isn't known yet: when GIWA's mainnet goes live, the snapshot block, and the mainnet mint price. They will be announced on the project's own channels. A testnet pass that you sell or send away before the snapshot takes its allowlist spot with it.
Contracts
| Contract | What it does | Address |
|---|---|---|
GiwaPass | The pass: mint, the fee share, claims | not deployed yet |
GiwaPad | The launchpad: create, buy, sell, fee split | not deployed yet |
PassArt | Draws the pass and its metadata | not deployed yet |
PadToken | The ERC-20 each launch deploys | one per token |
What is fixed
4,000 passes · the 1% fee and the 0.5% holder fee · the 40 / 20 / 40 split · the team's own 80 / 20 split · one billion tokens per launch · the curve's formula and its virtual ETH. These are constants or set once at deployment. No upgrade mechanism exists.
What the owner can do
- Pass: open and close the mint; set the mint price and the allowlist root until they call
lockSale(), after which neither can change; change the two addresses the team's money goes to. - Launchpad: change the two addresses the team's money goes to. Nothing else.
The owner cannot mint passes for free, take holders' fees, change the split, pause trading, block a token or touch any curve.
Unaudited. The contracts have tests (unit, fuzz and an end-to-end run) but no independent audit. Read the code, and don't use more than you can afford to lose.
Network
| GIWA Sepolia (testnet) | |
|---|---|
| Chain ID | 91342 |
| RPC | https://sepolia-rpc.giwa.io/ |
| Explorer | https://sepolia-explorer.giwa.io/ |
| Currency | ETH (test ETH) |
| Faucets | GIWA Faucet · Nodit Faucet |
Values from GIWA's own docs (docs.giwa.io), checked in November 2026. The public RPC is rate-limited. Always check network details against the official docs before you add a network to your wallet.
FAQ
Is the testnet pass the real pass?
It's the same contract on the test network. It earns its share of the testnet launchpad's fees (in test ETH) and it is your way onto the mainnet allowlist. It has no monetary value.
How many passes can I mint?
One per wallet on the testnet. On mainnet, one per testnet pass you held at the snapshot, plus the public mint's limit if it opens.
Do I need a pass to use the launchpad?
No. Anyone can launch and trade. Without a pass you pay 1% instead of 0.5%, and you don't share the fees.
Who gets the creator's 20%?
The wallet that called create, for trades of that token only. It accrues in the launchpad until that wallet claims it.
Can a token be removed?
Not from the chain. The website may hide tokens that impersonate real projects or break the terms; the contract treats all tokens alike.
Why "Giwa"?
GIWA is the name of the chain. A giwa is a traditional roof tile, which is why the pass and the site are covered in them, and why a busy token gets a roof.
Risks
Short version: unaudited contracts; a fee share that depends entirely on trading volume and can be zero; user-made tokens that can go to zero; a new chain; a mainnet whose date isn't known. The risk page has the long version, and the terms apply to using this site.