Upload go filler (#147)

* update

* update readme and remove test code

* remove

* add disclaimer to prover package

Author: maffinnn

services/go-filler/Makefile

@@ -0,0 +1,90 @@
+ORG := base-org
+PROJECT := RRC-7755-poc
+VERSION := $(shell git describe --tags)
+BUILD := $(shell git rev-parse --short HEAD)
+
+#
+# Tool Prerequisites Check
+# This ensures that you have the necessary executables installed to run this makefile.
+#
+GEN_PREREQUISITES = mockgen
+BUILD_PREREQUISITES = git go
+VALIDATION_PREREQUISITES = golangci-lint 
+
+#
+# Build Options
+# Typical inputs to the build targets found below.
+#
+TARGET=target
+BIN=$(TARGET)/bin
+LDFLAGS=-ldflags "-X=main.Version=$(VERSION) -X=main.Build=$(BUILD)"
+
+
+#
+# Informational Targets
+# These rarely change, and only serve to print out helpful details about this makefile.
+#
+.PHONY: usage
+usage:
+	@ echo "Usage: make [`cat Makefile | grep "^[A-z\%\-]*:" | awk '{print $$1}' | sed "s/://g" | sed "s/%/[1-3]/g" | xargs`]"
+
+.PHONY: info
+info:
+	@ echo ORG: $(ORG)
+	@ echo PROJECT: $(PROJECT)
+	@ echo VERSION: $(VERSION)
+	@ echo BUILD: $(BUILD)
+
+#
+# Build Targets
+# These are the primary developer workflow targets for building the software.
+#
+.PHONY: clean
+clean: info
+	@ rm -rf target
+	@ go mod tidy
+
+.PHONY: build_deps
+build_deps: info clean
+	@ printf $(foreach exec,$(BUILD_PREREQUISITES), \
+        $(if $(shell which $(exec)),"", \
+        $(error "No $(exec) in PATH. Prerequisites are: $(BUILD_PREREQUISITES)")))
+
+
+.PHONY: gen
+gen: info clean
+	@ echo "Generating mocks..."
+	@ mockgen -destination=internal/client/mocks/eth_client_mock.go -mock_names EthClient=MockEthClient -package=mocks github.com/base-org/RRC-7755-poc/internal/client EthClient
+	@ mockgen -destination=internal/prover/mocks/eth_rpc_client_mock.go -mock_names EthRPCClient=MockEthRPCClient -package=mocks github.com/base-org/RRC-7755-poc/internal/prover/storage_prover EthRPCClient
+	@ mockgen -destination=internal/prover/mocks/l1_client_mock.go -mock_names L1Client=MockL1Client -package=mocks github.com/base-org/RRC-7755-poc/internal/prover/l1_state_prover L1Client
+
+.PHONY: install_tools
+install_tools:
+	@echo "--- Installing tools..."
+	@go install github.com/golang/mock/mockgen@latest
+
+
+.PHONY: build
+build: info build_deps
+	@ printf "\nBuild app\n"
+	@ go build $(LDFLAGS) -o $(BIN)/$(PROJECT) cmd/main.go
+	@ cp -R cmd/config $(BIN)/
+
+run: build
+	@ printf "\nrunning main directory with go run..."
+	@ cd cmd && go run main.go
+
+.PHONY: build-contracts
+build-contracts:
+	@ echo "Building contracts..."
+	@ cd RRC-7755-poc/contracts \
+		&& forge install \
+		&& forge build
+
+.PHONY: generate-bindings
+generate-bindings:
+	@ echo "Generating bindings..."
+	@ go install github.com/ethereum/go-ethereum/cmd/abigen@v1.14.11
+	@ abigen --abi contracts/out/RRC7755Outbox.sol/RRC7755Outbox.abi.json --pkg rrc_7755_outbox --type RRC7755Outbox --out bindings/rrc_7755_outbox/rrc_7755_outbox.go
+	@ abigen --abi contracts/out/RRC7755Inbox.sol/RRC7755Inbox.abi.json --pkg rrc_7755_inbox --type RRC7755Inbox --out bindings/rrc_7755_inbox/rrc_7755_inbox.go
+	@ abigen --abi contracts/out/Entrypoint.sol/Entrypoint.abi.json --pkg entrypoint --type Entrypoint --out bindings/entrypoint/entrypoint.go

services/go-filler/README.md

@@ -0,0 +1,94 @@
+# RRC-7755 Go Filler Service
+
+> **DISCLAIMER:** This is a preliminary draft version of a Go implementation for the RRC-7755 filler. It contains experimental and hacky code that is not production-ready. Please do not use the code for any production purposes. This implementation is meant for demonstration and testing purposes only.
+> 
+> **⚠️ IMPORTANT:** Users should understand that:
+> - This code is still in early development
+> - It may contain bugs or failures.
+> - The implementation makes numerous assumptions that might not hold in other environments
+> - This code is highly imperfect and is generated in a hackathon-like development environment. It does not represent Base's engineering standards or best practices
+> - It is provided solely as a reference implementation for experimental purposes
+> - No warranty or official support is provided for this code
+>
+> Please use this implementation wisely and only for exploratory purposes. Do not deploy it in production environments.
+
+The Go Filler service is part of the RRC-7755 proof-of-concept implementation. It listens for message events from Outbox contracts on source chains and fulfills those messages on destination chains.
+
+## Features
+
+### What is included in the go-filler
+
+1. Outbox package:
+- Listen to requests from outbox
+- Validate request content
+- Send fulfillment to inbox
+
+2. Prover package:
+- Generate proof of fulfillment on arbitrum as a destination chain on devnet (disclaimer: unit tested but not E2E tested onchain)
+
+### What is not included yet
+
+- Usage of service frameworks
+- Storage for outbox requests
+- Submission of proof to the outbox to claim rewards
+- Mainnet storage proof
+
+
+## Prerequisites
+
+- Go 1.20 or later
+- Access to Ethereum RPC endpoints
+
+## Environment Setup
+
+Create a `.env` file in the project root directory with the following variables:
+
+```
+# RPC endpoints for different chains (examples)
+SEPOLIA_RPC=wss://ethereum-sepolia-rpc.publicnode.com
+BASE_SEPOLIA_RPC=wss://base-sepolia-rpc.publicnode.com
+ARBITRUM_SEPOLIA_RPC=wss://sepolia-rollup.arbitrum.io/feed
+
+# Wallet configuration
+from-address: .env//YOUR_WALLET_ADDR
+private-key: .env//YOUR_WALLET_PRIVATE_KEY
+recipient-address: .env//RECIPIENT_ADDR
+```
+
+## Configuration
+
+The service uses YAML configuration files located in `services/go-filler/cmd/config/`. The main configuration file is `local.yaml`, which includes:
+
+- Chain configurations (chain IDs, RPC URLs, contract addresses)
+- Wallet configuration
+- Outbox and Inbox address mappings
+
+## Building and Running
+
+### Using Make
+
+The project includes a Makefile with several useful commands:
+
+```bash
+# Run the service
+make run
+```
+
+### Manual Running
+
+If you prefer to run the service manually:
+
+```bash
+cd services/go-filler
+go build -o bin/filler cmd/main.go
+./bin/filler
+```
+
+## Troubleshooting
+
+### Common Issues
+
+- **Connection issues**: Check your RPC endpoint URLs and ensure they're accessible from your environment.
+- **Insufficient funds**: Ensure your wallet has enough funds on the destination chains to cover transaction costs.
+
+