Skip to main content

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.
PropertyValue
SymbolWKRC
Decimals18
PegKorean Won (KRW), 1:1
ERC-20 address0x0000000000000000000000000000000000001000
StandardERC-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:
ComponentHow it’s setStability
Base feeProtocol, adjusts ±2% per blockHigh — changes slowly
Priority fee (gas tip)GovValidator governanceFixed — 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 utilizationChange
> 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