# Signet

> Signet is a pragmatic Ethereum rollup with sustainable economic incentives. Signet is an Ethereum rollup that enables cross-chain settlement in the same block.

For complete documentation with full page content, see: https://test.signet.sh/llms-full.txt

## Network Configuration (Testnet: Parmigiana Testnet)

- Chain ID: 88888
- RPC URL: https://rpc.parmigiana.signet.sh
- Host RPC URL: https://host-rpc.parmigiana.signet.sh
- Explorer: https://explorer.parmigiana.signet.sh

### Key Contracts (Host Chain)

- Zenith: `0x143A5BE4E559cA49Dbf0966d4B9C398425C5Fc19`
- HostOrders: `0x96f44ddc3Bc8892371305531F1a6d8ca2331fE6C`
- Passage: `0x28524D2a753925Ef000C3f0F811cDf452C6256aF`
- Transactor: `0x0B4fc18e78c585687E01c172a1087Ea687943db9`

### Key Contracts (Rollup)

- RollupOrders: `0x000000000000007369676e65742d6f7264657273`
- RollupPassage: `0x0000000000007369676e65742d70617373616765`
- WUSD: `0x0000000000000000007369676e65742D77757364`

## Key Constraints & Requirements

- Signet is an EVM-compatible Ethereum L2 rollup — all standard Solidity contracts and EVM tooling work without modification
- Uses based sequencing: the Ethereum L1 host chain proposes and validates rollup blocks via the Zenith contract
- Cross-chain operations (bridging, orders) require interaction with host chain system contracts (Passage, HostOrders, Transactor)
- Settlement is atomic with Ethereum — rollup state transitions are finalized in the same L1 block
- The native currency on the rollup is USD (wrapped as WUSD); the host chain uses ETH
- All system contracts are predeployed at deterministic addresses (see contract addresses above)

## Integrations

- **Ethereum tooling**: viem, ethers.js, web3.js, and wagmi work out of the box — connect to Signet RPC like any EVM chain
- **Wallets**: MetaMask and any EVM-compatible wallet can be configured with the Signet RPC URL and chain ID
- **Smart contracts**: Deploy and interact with Solidity or Vyper contracts using Hardhat, Foundry, or Remix
- **Block explorers**: Signet provides a block explorer at https://explorer.parmigiana.signet.sh

## Quick Example

Connect to Signet and read the latest block number using viem:

```javascript
import { createPublicClient, http } from "viem";

const client = createPublicClient({
  chain: {
    id: 88888,
    name: "Parmigiana Testnet",
    nativeCurrency: { name: "USD", symbol: "USD", decimals: 18 },
    rpcUrls: { default: { http: ["https://rpc.parmigiana.signet.sh"] } },
  },
  transport: http(),
});

const blockNumber = await client.getBlockNumber();
```

## Quickstart
- [Getting started](https://test.signet.sh/docs/build-on-signet/getting-started/index.md): Install dependencies and configure clients for Signet development.

## Building on Signet

## Understanding Signet

## Reference
- [FAQ](https://test.signet.sh/docs/more-info/faq/index.md): Frequently asked questions about Signet

- [Glossary](https://test.signet.sh/docs/more-info/glossary/index.md): Definitions of key terms and concepts in Signet

## Optional (skip unless specifically relevant)
- [Authentication](https://test.signet.sh/docs/block-builders/run-a-builder/authentication/index.md): How to configure OAuth2 authentication for sequencer co-signatures and bundle relay access.

- [Build from source](https://test.signet.sh/docs/block-builders/run-a-builder/install-and-run-a-node/build-from-source/index.md): How to clone, compile, and run the Signet node from source code.

- [Environment variables](https://test.signet.sh/docs/block-builders/run-a-builder/environment-variables/index.md): Configuration reference for all environment variables used by the Signet builder.

- [Fetching transactions](https://test.signet.sh/docs/searchers/fetching-transactions/index.md): How to fetch transactions stored on Signet's transaction cache.

- [Getting transactions and bundles](https://test.signet.sh/docs/block-builders/customizing-a-builder/getting-transactions-and-bundles-for-a-block/index.md): How to retrieve transactions and bundles from the transaction cache for block building.

- [Bundle guarantees](https://test.signet.sh/docs/block-builders/customizing-a-builder/bundle-guarantees/index.md): Ordering, atomicity, and revertibility guarantees for Flashbots-style transaction bundles.

- [Docker](https://test.signet.sh/docs/block-builders/run-a-builder/install-and-run-a-node/docker/index.md): How to run the Signet node using the official Docker image.

- [Signed orders](https://test.signet.sh/docs/searchers/signed-orders/index.md): How to construct token transfers using Permit2 integration with intent-based orders and user signatures.

- [Compiled binaries](https://test.signet.sh/docs/block-builders/run-a-builder/install-and-run-a-node/compiled-binaries/index.md): How to install and run the Signet node from pre-compiled binaries.

- [Filler](https://test.signet.sh/docs/searchers/filler/index.md): Build an order filler bot using the signet-orders crate

- [Environment variables](https://test.signet.sh/docs/block-builders/run-a-builder/install-and-run-a-node/environment-variables/index.md): Configuration reference for all environment variables used by the Signet node client.

- [Getting a sequencer signature](https://test.signet.sh/docs/block-builders/customizing-a-builder/getting-a-sequencer-signature/index.md): How to obtain a sequencer co-signature for your block using the Sequencer API.

- [Parmigiana quickstart](https://test.signet.sh/docs/build-on-signet/parmigiana/index.md): How to build on Signet’s latest public testnet (Parmigiana).

- [Chain configuration](https://test.signet.sh/docs/block-builders/run-a-builder/install-and-run-a-node/chain-configuration/index.md): Network configuration values and contract addresses for Parmigiana testnet.

- [Submitting a block to Ethereum](https://test.signet.sh/docs/block-builders/customizing-a-builder/submitting-a-block-to-ethereum/index.md): How to submit rollup blocks to Ethereum using EIP-4844 blobs and the Zenith contract.

- [Enter Signet](https://test.signet.sh/docs/build-on-signet/transfers/enter-signet/index.md): Move ETH and ERC-20 tokens from Ethereum to Signet via Passage

- [Execute from Ethereum](https://test.signet.sh/docs/build-on-signet/advanced/execute-from-ethereum/index.md): Execute transactions from Ethereum to Signet with guaranteed inclusion

- [Simplifying the rollup](https://test.signet.sh/docs/learn-about-signet/simplifying-the-rollup/index.md): An introduction to Signet, init4, and the Signet ecosystem.

- [Bundles](https://test.signet.sh/docs/build-on-signet/advanced/bundles/index.md): How to create and submit transaction bundles that execute atomically across Ethereum and Signet.

- [Exit Signet](https://test.signet.sh/docs/build-on-signet/transfers/exit-signet/index.md): Move assets from Signet back to Ethereum

- [No proofs or state roots](https://test.signet.sh/docs/learn-about-signet/no-proofs-or-state-roots/index.md): How Signet eliminates proving overhead for better performance

- [Permissioned roles](https://test.signet.sh/docs/more-info/permissioned-roles/index.md): Overview of permissioned roles in Signet smart contracts

- [Simple sequencing](https://test.signet.sh/docs/learn-about-signet/simple-sequencing/index.md): Signet's approach to transaction ordering and inclusion

- [Simulating bundles](https://test.signet.sh/docs/build-on-signet/advanced/simulating-bundles/index.md): How to simulate Signet bundles before submission using the RPC method.

- [Swap within Signet](https://test.signet.sh/docs/build-on-signet/transfers/swap-within-signet/index.md): Trade tokens on Signet without exiting to Ethereum

- [System transactions](https://test.signet.sh/docs/build-on-signet/system-transactions/index.md): How events on Ethereum produce transactions on Signet, including asset minting and host-originated execution.

- [Cross-chain transfers](https://test.signet.sh/docs/learn-about-signet/cross-chain-transfers/index.md): How assets move seamlessly between chains

- [Troubleshooting](https://test.signet.sh/docs/build-on-signet/advanced/troubleshooting/index.md): Common errors, how to handle them, and debugging tips for Signet development.

- [Key concepts](https://test.signet.sh/docs/learn-about-signet/key-concepts/index.md): The building blocks you'll use when developing on Signet.

- [Application controlled execution](https://test.signet.sh/docs/learn-about-signet/application-controlled-execution/index.md): How applications coordinate atomic cross-chain execution between Signet and Ethereum

- [Brand kit](https://test.signet.sh/docs/more-info/brand-kit/index.md): Visual identity essentials for Signet

- [How orders work](https://test.signet.sh/docs/learn-about-signet/how-orders-work/index.md): The cross-chain order system that powers exits, swaps, and settlement on Signet

- [EVM behavior](https://test.signet.sh/docs/learn-about-signet/evm-behavior/index.md): EVM modifications and differences between Signet and Mainnet EVM.

- [Clone and build](https://test.signet.sh/docs/block-builders/run-a-builder/clone-and-build/index.md): Prerequisites, system requirements, and instructions for cloning and building the Signet builder.

- [Introduction](https://test.signet.sh/docs/block-builders/introduction/index.md): Overview of Signet block building, including key features, quickstart steps, and documentation structure.

## Recent Updates
- [Building with Orders](https://test.signet.sh/updates/building-with-orders/index.md): A practical guide to placing and filling cross-chain orders on Signet
- [The Filler Economy](https://test.signet.sh/updates/the-filler-economy/index.md): How Signet turns MEV extractors into service providers
- [How Signet Works](https://test.signet.sh/updates/how-signet-works/index.md): The three pieces that make cross-chain execution feel like one chain
- [Rebased Optimism](https://test.signet.sh/updates/rebased-optimism/index.md)
- [Optimistic Thinking](https://test.signet.sh/updates/optimistic-thinking/index.md)