88 lines
6.7 KiB
Markdown
88 lines
6.7 KiB
Markdown
# Build on Igneum
|
|
|
|
This file is the source of [igneum.network/build](https://igneum.network/build). The site build renders it as the page. The other files in this directory are the walkthrough, the RPC list, the faucet, the verifier and the grants.
|
|
|
|
## What is different
|
|
|
|
**Every block is built to be proven.** A chain block carries a zero-knowledge proof of its execution. The miners are the provers: the same cards that find blocks prove them, in shards. On Devnet 3 a share of blocks carries a proof today; the live page shows the share and the lag, and the design target at launch is under a minute. Full nodes execute every block themselves, so a bad proof is a light-client problem and never a chain split.
|
|
|
|
**A lock in minutes, not an hour of confirmations.** Miners sign a checkpoint every 30 seconds. When two thirds of the mining weight of the last 30 days have signed, the checkpoint is locked. Weight is blocks mined, nothing else. The lock lands in about two minutes. The [litepaper](/litepaper) has the rule.
|
|
|
|
**Nothing to stake.** No validator set, no delegation, no slashing, no bonded class above the miners. Finality comes from mining weight alone. Nobody holds a key that the chain depends on.
|
|
|
|
**The EVM you already know.** Solidity deploys unchanged. Standard JSON-RPC, EIP-1559 transactions, the chain id in the signature, `cancun` as the EVM version. Gas has two dimensions on Igneum, execution and proving, and the node folds the second into the price it quotes, so `eth_estimateGas` and `eth_gasPrice` work as they do on Ethereum.
|
|
|
|
## Networks
|
|
|
|
| | Devnet 3 | Testnet | Mainnet |
|
|
|---|---|---|---|
|
|
| Chain id | 4463 (`0x116f`) | 4462 (`0x116e`) | 4461 (`0x116d`) |
|
|
| Network id | `igneum-devnet-3` | `igneum-testnet-1` | not started |
|
|
| RPC | `https://rpc.devnet.igneum.network` (a node you run serves `http://127.0.0.1:26790`) | `https://rpc.testnet.igneum.network` (answers; nothing mines there yet, so a transaction waits) | none |
|
|
| Coins | no value, resets without notice | no value, resets with notice | not started |
|
|
| Symbol, decimals | IGN, 18 | IGN, 18 | IGN, 18 |
|
|
|
|
Devnet 3 is where you build today. It is a developer network: it resets without notice and its coins have no value. Its public RPC takes the read methods, `eth_sendRawTransaction` and a wRPC websocket at `/ws`, at 20 requests a second per address. The public testnet exists, its RPC answers, and no blocks are being produced on it until it opens. Mainnet has no date. Devnet 3 answers chain id 4463 until its class v5 floor, then 4464.
|
|
|
|
## Endpoints and tools
|
|
|
|
- **Wallet.** Any Ethereum wallet. [Add Igneum to MetaMask](/metamask) with one click, or the [Igneum wallet](/wallet).
|
|
- **Faucet.** [10 IGN of Devnet 3 coin](/faucet) per address per day. No account.
|
|
- **Explorer.** [The explorer](/explorer) shows blocks, the DAG, miners and addresses. The EVM views, transactions and contracts, are being built and link from the same page as they land.
|
|
- **Swap.** [The swap](/swap): test tokens on Devnet 3, every swap in a proven block.
|
|
- **Source.** [git.igneum.network/igneum-network/igneum](https://git.igneum.network/igneum-network/igneum): the node, the miner, the site, and these pages under `docs/build/`.
|
|
|
|
## Your first contract in five minutes
|
|
|
|
With [Foundry](https://getfoundry.sh). Tested end to end on Devnet 3 on a build box; the full walkthrough with the expected output is [docs/build/first-contract.md](https://git.igneum.network/igneum-network/igneum/src/branch/master/docs/build/first-contract.md).
|
|
|
|
```
|
|
curl -L https://foundry.paradigm.xyz | bash && foundryup
|
|
export RPC=https://rpc.devnet.igneum.network
|
|
cast wallet new # an address and a private key, for the devnet only
|
|
```
|
|
|
|
Paste the address into [the faucet](/faucet). Then:
|
|
|
|
```
|
|
export PK=0x... # the private key cast printed
|
|
cast balance $(cast wallet address $PK) --rpc-url $RPC --ether
|
|
forge init counter && cd counter
|
|
forge create src/Counter.sol:Counter --rpc-url $RPC --private-key $PK --broadcast
|
|
```
|
|
|
|
`forge create` prints `Deployed to: 0x...`. Call it:
|
|
|
|
```
|
|
cast send 0xDEPLOYED "increment()" --rpc-url $RPC --private-key $PK
|
|
cast call 0xDEPLOYED "number()(uint256)" --rpc-url $RPC
|
|
```
|
|
|
|
The call answers `1`. Paste the transaction hash into [the explorer](/explorer). Hardhat, ethers and viem work the same way: chain id 4463, the RPC above.
|
|
|
|
## The RPC the node serves
|
|
|
|
Read from a Devnet 3 node, not from a spec. `web3_clientVersion` answers `igneumd/2.1.0/execution-layer-v3`. The full list, served and not served, with the probe that produced it: [docs/build/rpc.md](https://git.igneum.network/igneum-network/igneum/src/branch/master/docs/build/rpc.md).
|
|
|
|
- **Served.** `eth_chainId`, `eth_blockNumber`, `eth_getBalance`, `eth_getTransactionCount`, `eth_getCode`, `eth_getStorageAt`, `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_getBlockReceipts`, `eth_getLogs`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`, `eth_sendRawTransaction`, `eth_syncing`, `eth_accounts`, `net_version`, `net_peerCount`, `net_listening`, `web3_clientVersion`.
|
|
- **Igneum's own.** `igneum_getExecStatus`, `igneum_getProvingStatus`, `igneum_getShardPlan`, `igneum_getProofRecords`, `igneum_getTransactionStatus`, `igneum_estimateGas`, `igneum_getBudgets` and the segment and proof calls. `igneum_estimateGas` returns both gas dimensions and whether a call exceeds the proving limit.
|
|
- **Not served.** Filters and subscriptions (`eth_newFilter`, `eth_subscribe`), `txpool_*`, `debug_*`, `trace_*`, `eth_sendTransaction`, `eth_sign`, `eth_getProof`, the uncle calls. Poll `eth_blockNumber` and `eth_getLogs`. Sign on your side.
|
|
|
|
## Verify a block in your browser
|
|
|
|
The site ships a light client. Your browser fetches the latest certified checkpoint from `/api/checkpoint` and verifies the BLS aggregate signature, the voter weights and the header chain itself, in the tab. Nothing is trusted from the server but the data. The example, in twelve lines, is [docs/build/verify-a-block.md](https://git.igneum.network/igneum-network/igneum/src/branch/master/docs/build/verify-a-block.md); the live run is [verify/test.html](/verify/test.html), genuine and tampered cases side by side.
|
|
|
|
```
|
|
import { fetchCheckpoint, verify } from 'https://igneum.network/verify/verify.js';
|
|
const data = await fetchCheckpoint('https://igneum.network/api/checkpoint');
|
|
const r = verify(data);
|
|
console.log(r.verified, r.signers, 'of', r.voters, 'voters', r.ms, 'ms');
|
|
```
|
|
|
|
## Where to ask
|
|
|
|
- An issue on [the repository](https://git.igneum.network/igneum-network/igneum/issues).
|
|
- [Discord](https://discord.gg/igneum), the builders channel.
|
|
- [Grants](/grants) for tooling, reference apps, infrastructure and research.
|
|
|
|
Devnet and testnet coins have no value. Nothing on this page is an offer to sell anything.
|