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.
All StableNet system contracts are deployed at fixed genesis addresses and are identical on every network.
System Contracts
Five governance contracts are deployed at genesis. They have no owner and can only be upgraded via hard fork.
| Contract | Address | Purpose |
|---|
| NativeCoinAdapter | 0x0000000000000000000000000000000000001000 | ERC-20 wrapper for WKRC (KRW-pegged). Mint/burn entry point. |
| GovValidator | 0x0000000000000000000000000000000000001001 | Validator set management, BLS key registration, gas tip governance. |
| GovMasterMinter | 0x0000000000000000000000000000000000001002 | Approved minter registry and global mint allowance caps. |
| GovMinter | 0x0000000000000000000000000000000000001003 | Mint/burn proposal creation, voting, and execution. |
| GovCouncil | 0x0000000000000000000000000000000000001004 | Blacklist and Authorized account management. |
NativeCoinAdapter (WKRC)
0x0000000000000000000000000000000000001000
| Property | Value |
|---|
| Symbol | WKRC |
| Decimals | 18 |
| Peg | Korean Won (KRW) |
| Standard | ERC-20, FiatTokenV2_2 |
balanceOf(address) reads the account’s native balance directly — no separate token storage- Transfers modify native balances (same balance used for gas)
- Allowances are stored in contract storage via
approve() / transferFrom()
- Emits standard ERC-20 events:
Transfer, Approval, Mint, Burn
Governance Contracts
GovValidator — 0x…1001
Manages the active validator set and the governance-enforced gas tip (gasTip). Validators register an operator address, consensus address, and BLS public key. Set changes take effect at epoch boundaries.
GovMasterMinter — 0x…1002
Maintains the list of approved minters and their global maximum mint allowance. Only registered minters can call mint() on NativeCoinAdapter.
GovMinter — 0x…1003
Handles the proposal lifecycle for minting and burning WKRC. Proposals require quorum voting before execution.
GovCouncil — 0x…1004
Manages two account flags stored in the account’s Extra field:
| Flag | Effect |
|---|
| Blacklisted | All transfers blocked |
| Authorized | Exempt from governance gas tip enforcement |
EVM Precompiles
Standard precompiles are available at their canonical addresses:
| Address | Name | EIP |
|---|
0x01 | ecRecover | — |
0x02 | SHA-256 | — |
0x03 | RIPEMD-160 | — |
0x04 | Identity | — |
0x05 | ModExp | EIP-198 |
0x06 | ecAdd | EIP-196 |
0x07 | ecMul | EIP-196 |
0x08 | ecPairing | EIP-197 |
0x09 | Blake2f | EIP-152 |
0xb00001 | blsPoP | Anzeon — BLS Proof-of-Possession |
