Documentation Index
Fetch the complete documentation index at: https://docs.stablenet.network/llms.txt
Use this file to discover all available pages before exploring further.
WKRC is pegged 1:1 to the Korean Won and is the only token you need on StableNet — for gas, transfers, and contract interactions.
On most EVM chains, gas fees fluctuate with the price of a volatile native token. StableNet removes this variable: gas is denominated in WKRC, which tracks KRW. If you know the current KRW/gas price, you can predict transaction costs without tracking a token price.
What WKRC is
WKRC (KRW-pegged) is StableNet’s native coin, exposed as a standard ERC-20 token through the NativeCoinAdapter system contract.
| Property | Value |
|---|
| Symbol | WKRC |
| Decimals | 18 |
| Peg | Korean Won (KRW), 1:1 |
| ERC-20 address | 0x0000000000000000000000000000000000001000 |
| Standard | ERC-20, FiatTokenV2_2 compatible |
balanceOf(address) reads the account’s native balance directly — there is no separate token storage. The same balance used for gas is the balance returned by the ERC-20 interface.
How gas fees work
Every transaction pays two components, both in WKRC:
| Component | How it’s set | Stability |
|---|
| Base fee | Protocol, adjusts ±2% per block | High — changes slowly |
| Priority fee (gas tip) | GovValidator governance | Fixed — same for all general accounts |
The governance-enforced tip means all general accounts pay the same priority fee. There is no gas price competition — you cannot outbid other users by raising your tip.
Base fee adjustment thresholds:
| Gas utilization | Change |
|---|
| > 20% | +2% per block |
| 6%–20% | unchanged |
| < 6% | −2% per block |
Compared to Ethereum’s ±12.5% swing, this keeps the base fee predictable across blocks. The base fee has a minimum of 20,000 gwei and a maximum of 20,000,000 gwei.
Fee calculation
effectiveGasPrice = baseFee + min(governanceTip, maxFeePerGas − baseFee)
totalCost = gasUsed × effectiveGasPrice
To avoid rejection, set maxPriorityFeePerGas to at least the governance tip. Query the current value with eth_maxPriorityFeePerGas.
const tip = await provider.send("eth_maxPriorityFeePerGas", []);
// Use this as maxPriorityFeePerGas in your transaction
Supply model
WKRC supply is not pre-minted at genesis and has no block rewards. Supply changes only through governance-approved mint/burn operations:
- Mint — when a licensed institution deposits KRW fiat
- Burn — when a holder redeems KRW fiat
The base fee collected from transactions is distributed to validators, not burned. Burning only happens at fiat redemption, preserving the 1:1 peg.
Developer benefits
- Fee estimates are stable in fiat terms — no token price volatility to account for
- Same token for gas and transfers — no separate wrapped token or bridging step
- Standard ERC-20
approve / transferFrom / balanceOf interface works as expected
- FiatTokenV2_2 compatible — existing Circle USDC tooling works without modification