8283)
Prerequisites
Before you start, make sure you have:-
Node.js ≥ 18 — run
node --versionto check. Download from nodejs.org if needed. -
A funded testnet wallet. Get free WKRC from the faucet:
Faucet
Request testnet WKRC — no sign-up required.Explorer
Verify your balance before deploying.
StableNet enforces a minimum priority fee of 27,600 Gwei. All deploy and send transactions must include
maxPriorityFeePerGas at or above this value. Transactions below this threshold are rejected at the transaction pool level.Network Details
| Parameter | Value |
|---|---|
| Chain ID | 8283 |
| RPC URL | https://api.test.stablenet.network |
| Explorer | explorer.stablenet.network |
| Faucet | faucet.stablenet.network |
| WKRC Contract | 0x0000000000000000000000000000000000001000 |
| Minimum Priority Fee | 27,600 Gwei (27600000000000 wei) |
| EVM Version | shanghai (blob opcodes not supported — do not use cancun) |
Steps
Create a Hardhat project
Create a new directory, initialize a Node.js project, and install Hardhat:Then initialize a Hardhat project and select “Create a JavaScript project” when prompted:Your project structure:Install Create a
dotenv to keep your private key out of source control:.env file and add it to .gitignore:Deploy to Testnet
Run the deploy script against StableNet Testnet:Successful output:Save the deployed contract address — you will need it to interact with the contract.
Block inclusion may take up to 1–2 minutes. If the script appears to hang at
waitForDeployment(), your transaction is already in the mempool and will be confirmed shortly. Do not cancel and retry — that may cause a nonce conflict.Verify on Explorer
Open explorer.stablenet.network and search for your contract address.You should see:
- The deployment transaction with a
Contract Creationlabel - The deployer address as the transaction sender
- The contract bytecode stored on-chain
What just happened?
hardhat.config.jsconnects Hardhat to StableNet Testnet using Chain ID8283and the public RPC endpoint.evmVersion: "shanghai"ensures Solidity does not emit blob opcodes, which are not available on StableNet.maxPriorityFeePerGas: ethers.parseUnits("27600", "gwei")satisfies theGovValidator-enforced minimum. Without it, the transaction pool rejects the transaction before it reaches a block.waitForDeployment()pollseth_getTransactionReceiptuntil the deploy transaction is included in a block.- WKRC is the KRW-pegged native coin of StableNet exposed as a standard ERC-20 token via the
NativeCoinAdaptersystem contract. The same balance used for gas is the balance returned bybalanceOf().
Troubleshooting
- Transaction rejected / “fee too low” — ensure
maxPriorityFeePerGasis set to at leastethers.parseUnits("27600", "gwei")in every deploy and send call. waitForDeployment()hangs — your transaction is in the mempool. Wait up to 2 minutes; do not cancel. Block time is ~1 second but mempool propagation can add latency.- “replacement transaction underpriced” — a previous transaction with the same nonce is pending. Increase both
maxFeePerGasandmaxPriorityFeePerGasto replace it, or wait for the original to confirm. - “transfer amount exceeds balance” during a WKRC send — reduce the amount or lower gas fees to ensure your wallet balance covers both the transfer and gas cost.
BLOBHASH/BLOBBASEFEEopcode errors — you are usingevmVersion: "cancun". Change it to"shanghai"inhardhat.config.js.
maxFeePerGas defaults to 0 when omitted. Setting only maxPriorityFeePerGas leaves maxFeePerGas unset, which defaults to 0 and causes the transaction to be rejected. Specify both values explicitly in every call:
npx hardhat init is interactive-only. Hardhat v3 changed npx hardhat init to an interactive-only flow that may not work in all environments. Install Hardhat v2 to use the standard project scaffold:
Next Steps
Foundry Quickstart
Deploy the same WKRC payment contract using Foundry — includes approve and pay flow.
EVM Compatibility Reference
Supported opcodes, tool configuration snippets, fee delegation (tx type 0x16), and unsupported features.
Network Information
Full network parameters — Chain IDs, RPC endpoints, system contract addresses.
Explorer
Inspect your contract and transactions on-chain.

