{"id":31528952,"url":"https://github.com/gosunuts/builderism","last_synced_at":"2025-10-04T01:00:12.374Z","repository":{"id":227440678,"uuid":"771430239","full_name":"gosunuts/builderism","owner":"gosunuts","description":"build your mainnet using op stack!","archived":false,"fork":false,"pushed_at":"2025-09-26T05:59:39.000Z","size":553,"stargazers_count":30,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-26T06:23:53.078Z","etag":null,"topics":["l2","op-stack","optimism","optimism-tutorial","rollup"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gosunuts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-03-13T09:34:52.000Z","updated_at":"2025-09-26T05:59:43.000Z","dependencies_parsed_at":"2024-03-28T12:50:31.743Z","dependency_job_id":"916d6767-93b9-4dd6-aa5d-1fbc4a259c1f","html_url":"https://github.com/gosunuts/builderism","commit_stats":null,"previous_names":["gokch/optimism_node","gokch/optimism_builder","rabbitprincess/optimism_builder","rabbitprincess/optimism-builder","rabbitprincess/builderism","gosunuts/builderism"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/gosunuts/builderism","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gosunuts%2Fbuilderism","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gosunuts%2Fbuilderism/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gosunuts%2Fbuilderism/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gosunuts%2Fbuilderism/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gosunuts","download_url":"https://codeload.github.com/gosunuts/builderism/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gosunuts%2Fbuilderism/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278250087,"owners_count":25955842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["l2","op-stack","optimism","optimism-tutorial","rollup"],"created_at":"2025-10-04T01:00:08.998Z","updated_at":"2025-10-04T01:00:12.364Z","avatar_url":"https://github.com/gosunuts.png","language":"Shell","readme":"# Builderism\r\n**User-friendly builder for launch your optimism node**\r\n\r\nIt support 4 steps to operate OP Stack node\r\n|  Name      | Description                                                                   | Command      |\r\n| :--------: | ----------------------------------------------------------------------------- | ------------ |\r\n|  `init`    | deploy bridge contracts and generate l2 configs.                              | `make init`  |\r\n|  `run`     | run sequencer or replica node                                                 | `make run`   |\r\n|  `scan`    | run blockchain explorer using [op-scan](https://github.com/walnuthq/op-scan). | `make scan`  |\r\n|  `bridge`  | transfer eth and tokens between L1 and L2.                                    | `make bridge`|\r\n\r\n## Prerequisite\r\n- makefile, docker, docker-compose\r\n- L1 RPC and Beacon endpoint (use PublicNode experimentally)\r\n- faucet private key (for charging eth to proposer, batcher, admin)\r\n\r\n## Quick Start\r\n1. Clone this repository `git clone https://github.com/rabbitprincess/builderism.git`\r\n2. Check and select chain configuration in `common.env` and `/envs/{server}.env`\r\n3. Run Command in sequence to `make init`, `make run`, `make scan`, `make bridge`\r\n\r\n## Supported Replica Networks\r\n|                    | Available     | Superchain Registry  | Snapshot Support     |\r\n|--------------------|---------------|----------------------|----------------------|\r\n| op-mainnet         | ✅            | ✅                  | ✅                  | \r\n| op-sepolia         | ✅            | ✅                  | ✅                  | \r\n| base-mainnet       | ✅            | ✅                  | ✅                  | \r\n| base-sepolia       | ✅            | ✅                  | ✅                  | \r\n| worldchain-mainnet | ✅            | ❌                  | ❌                  | \r\n| worldchain-sepolia | ✅            | ❌                  | ❌                  | \r\n| unichain-mainnet   | ❌            | ❌                  | ❌                  | \r\n| unichain-sepolia   | ✅            | ❌                  | ❌                  |\r\n\r\n## Frequently Asked Questions\r\n**Q. I don`t have enough fee for faucet**\r\n- You can take some eth from faucet\r\n  - [sepolia pow faucet](https://sepolia-faucet.pk910.de/)\r\n  - [holesky pow faucet](https://holesky-faucet.pk910.de/)\r\n- You can adjust faucet amount. If basefee is 3~4 gwei, Deploying cost is ~0.1 eth.\r\n- Sometimes sepolia gas price can be too high. You can also use Holskey testnet.\r\n\r\n**Q. How long time does init take?**\r\n- Currently, it takes ~1 hour, so please be patient!\r\n- Most of time is spent on contract deployment.\r\n- If you see `[all process is done! check config files.]` message, init process is successfully done.\r\n\r\n**Q. I want to change configuration not in ENV files.**\r\n- you can modify all `entrypoint` as needed.\r\n- all script is mounted in docker volume, so there is no need to rebuild docker images.\r\n\r\n**Q. How can run replica node?**\r\n- If run Superchain Network, just use env file in /envs.\r\n- If run not Superchain node, you should set `rollup.json` and `genesis.json` in `config` directory.\r\n\r\n**Q. When will additional features be supported?**\r\n- `ALT DA` is enabled. Set `ALT_DA_SERVER` to your alt-da server url.\r\n- `Custom Gas Token` is also enabled. Change branch to `feature/custom-gas-token` and set `GAS_TOKEN_ADDRESS` to your token address.\r\n- `L3 Chain` is not suported yet.\r\n\r\n## Configuration\r\n### Directory\r\n- `CONFIG_DIR`: Path to store config files (default `../config`)\r\n- `GETH_DATA_DIR`: Path to store geth data (default `../data-geth`)\r\n- `SCAN_DATA_DIR`: Path to store explorer data (default `../data-scan`)\r\n\r\n### L1 chain\r\n- `L1_CHAIN_ID`: L1 chain id (default `11155111`)\r\n- `L1_RPC_KIND`: The type of RPC provider (default `standard`)\r\n- `L1_RPC_URL`: L1 RPC endpoint (default `publicNode`)\r\n- `L1_BEACON_URL`: L1 Beacon endpoint (default `publicNode`)\r\n\r\n### L2 chain\r\n- `L2_CHAIN_ID`: Your L2 chain id\r\n- `L2_CHAIN_NAME`: Your L2 chain name\r\n- `L2_RPC_URL`: Your L2 RPC endpoint\r\n- `L2_SCAN_URL`: L2 Explore endpoint\r\n- `L2_BRIDGE_URL`: L2 Bridge endpoint\r\n- `ALT_DA_SERVER`: ALT DA server url; if empty, use eth DA\r\n\r\n### init node\r\n- `PRIORITY_GAS_PRICE`: Gas wei price using deploy contracts (default `10000`)\r\n- `FAUCET_ADDRESS`: Charging address\r\n- `FAUCET_PRIVATE_KEY`: Charging private key; Be careful about security\r\n- `FAUCET_AMOUNT_ADMIN`: Faucet amount eth to admin (default `0.5`)\r\n- `FAUCET_AMOUNT_BATCHER`: Faucet amount eth to batcher (default `0.2`)\r\n- `FAUCET_AMOUNT_PROPOSER`: Faucet amount eth to proposer (default `0.1`)\r\n- `GOVERNANCE_TOKEN_SYMBOL`: Governance token symbol\r\n\r\n### run node\r\n- `RUN_MODE`: Run mode ( sequencer or replica ) (default `sequencer`)\r\n- `MAX_CHANNEL_DURATION`: Batch time submitted to the L1 (default `1500`)\r\n- `SEQUENCER_HTTP`: Sequencer endpoint\r\n- `P2P_BOOTNODES`: Bootnode enr address\r\n- `DOWNLOAD_SNAPSHOT`: Download snapshot before run node","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgosunuts%2Fbuilderism","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgosunuts%2Fbuilderism","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgosunuts%2Fbuilderism/lists"}