{"id":19252094,"url":"https://github.com/optimism-java/dispute-explorer","last_synced_at":"2025-11-14T06:31:19.535Z","repository":{"id":244617074,"uuid":"814572045","full_name":"optimism-java/dispute-explorer","owner":"optimism-java","description":"A dispute explorer for superchains","archived":false,"fork":false,"pushed_at":"2025-08-29T11:19:20.000Z","size":38113,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-29T14:56:05.569Z","etag":null,"topics":["fault-proofs","go","golang","op-stack","opstack","optimism"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/optimism-java.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-13T09:14:30.000Z","updated_at":"2025-08-29T11:19:28.000Z","dependencies_parsed_at":"2024-06-16T05:46:50.044Z","dependency_job_id":"b92c4915-16f7-4144-a899-070b7bbbd2d9","html_url":"https://github.com/optimism-java/dispute-explorer","commit_stats":null,"previous_names":["optimism-java/dispute-explorer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/optimism-java/dispute-explorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimism-java%2Fdispute-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimism-java%2Fdispute-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimism-java%2Fdispute-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimism-java%2Fdispute-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/optimism-java","download_url":"https://codeload.github.com/optimism-java/dispute-explorer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimism-java%2Fdispute-explorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284353057,"owners_count":26990132,"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-11-14T02:00:06.101Z","response_time":56,"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":["fault-proofs","go","golang","op-stack","opstack","optimism"],"created_at":"2024-11-09T18:25:27.929Z","updated_at":"2025-11-14T06:31:19.529Z","avatar_url":"https://github.com/optimism-java.png","language":"Go","readme":"# dispute-explorer\n\nThis is a dispute explorer for displaying information about dispute games that utilize the OP Stack.\n\nhttps://www.superproof.wtf/\n\nSuperproof is an convenient tool for blockchain developers working with the OP stack, as well as for individuals eager to engage in dispute games.\n\nFor developers, Superproof provides real-time data on dispute games, allowing them to monitor key metrics such as the total games played and win numbers for both \"Attackers\" and \"Defenders.\" This visibility is easy for understanding game dynamics on the blockchain.\n\nFor users, Superproof simplifies participation in the fault-proof module, making it easy to invoke game methods like \"attack\" and \"defend.\" It also facilitates obtaining honest claims, ensuring transparency in the gaming process. Additionally, the platform offers clear visualizations that detail each step in the dispute process, enhancing user comprehension.\n\nIn summary, Superproof not only helps developers easily access vital information but also streamlines user participation in dispute games, benefiting all involved in fault-proof interactions.\n\nYou can use Docker to run this.\n\n# Prerequisites\n\nDownload and install Docker.\n\n# 1. Run dispute-explorer-backend\n\n# Step 1. Config Environment file\n\n```\nmv .env.template .evn\n```\n\n```\n#log_format you can use console or json\nLOG_FORMAT=console   \n\n# config your mysql data source\nMYSQL_DATA_SOURCE=\u003cdata-source\u003e\n\n# config chain name to tag your block chain name\nBLOCKCHAIN=\u003cblock-chain-name\u003e\n\n# l1 rpc url example: eth json rpc url\nL1_RPC_URLS=\u003cl1-rpc\u003e\n# l2 rpc url example: op json rpc url\nL2_RPC_URLS=\u003cl2-rpc\u003e\n\nNODE_RPCURLS=\u003cop-node-rpc\u003e\n\nRPC_RATE_LIMIT=15\nRPC_RATE_BURST=5\n\n# the block number which before the first game has been created to make sure can not missing any game\nFROM_BLOCK_NUMBER=6034337\n\n# FROM_BLOCK_NUMBER block hash\nFROM_BLOCK_HASH=0xafc3e42c5899591501d29649ffef0bfdec68f8d77e6d44ee00ef88cfb1a2f163\n\n# the contract address of dispute game factory proxy\nDISPUTE_GAME_PROXY_CONTRACT=0x05F9613aDB30026FFd634f38e5C4dFd30a197Fa1\n\nAPI_PORT=8080\n```\n\n# Step 2. Start Dispute Game Explorer backend service\n\nuse docker-compose to run this service\n\n```\ncd deploy\ndocker-compose -f docker-compose.yml up -d\n```\n\nNow, this project is running now.\n\nTip: if you just need a backend service to collect all data, Run Step 1 and Step 2.\n\n# Step 3. Run the deployment script\n\nRun the script to launch the service\n\n```\ncd deploy\n./star.sh\n```\n\nNow, this project is running.\n\n# Step 4. Validate meiliSync Service\n\nWe can visit meiliSearch api to validate meiliSync service. more [meiliSearch docs](https://www.meilisearch.com/docs/reference/api/overview)\n\n```\ncurl -H \"Authorization: Bearer \u003cToken\u003e\" http://localhost:port/indexes\n```\n\nYou should get a result, similar to :\n\n```json\n{\n    \"results\": [\n        {\n            \"uid\": \"disputegame\",\n            \"createdAt\": \"2024-08-06T09:24:24.640693956Z\",\n            \"updatedAt\": \"2024-08-07T07:02:32.402360903Z\",\n            \"primaryKey\": \"id\"\n        },\n        {\n            \"uid\": \"gameclaim\",\n            \"createdAt\": \"2024-08-06T09:24:24.670117944Z\",\n            \"updatedAt\": \"2024-08-07T07:02:28.94487306Z\",\n            \"primaryKey\": \"id\"\n        },\n        {\n            \"uid\": \"gamecredit\",\n            \"createdAt\": \"2024-08-06T10:37:42.013472322Z\",\n            \"updatedAt\": \"2024-08-07T07:02:32.379350451Z\",\n            \"primaryKey\": \"id\"\n        },\n        {\n            \"uid\": \"syncevents\",\n            \"createdAt\": \"2024-08-06T09:24:24.696318772Z\",\n            \"updatedAt\": \"2024-08-07T07:02:30.382386632Z\",\n            \"primaryKey\": \"id\"\n        }\n    ],\n    \"offset\": 0,\n    \"limit\": 20,\n    \"total\": 4\n}\n```\n\nIf you get information like this, it means our deployment it`s success.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimism-java%2Fdispute-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foptimism-java%2Fdispute-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimism-java%2Fdispute-explorer/lists"}