initial commit

Author: zrt219

.env.example

@@ -0,0 +1,11 @@
+# ── Wallet ──────────────────────────────────────────────
+PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# ── RPC ─────────────────────────────────────────────────
+RPC_URL=https://rpc.evm.xrpl.org
+
+# ── Deployed contract (fill after deploy) ────────────────
+CONTRACT_ADDRESS=0x0000000000000000000000000000000000000000
+
+# ── Optional: block explorer verify ─────────────────────
+# ETHERSCAN_API_KEY=

.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: CI
+
+permissions: {}
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+env:
+  FOUNDRY_PROFILE: ci
+
+jobs:
+  check:
+    name: Foundry project
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+          submodules: recursive
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+
+      - name: Show Forge version
+        run: forge --version
+
+      - name: Run Forge fmt
+        run: forge fmt --check
+
+      - name: Run Forge build
+        run: forge build --sizes
+
+      - name: Run Forge tests
+        run: forge test -vvv

.gitignore

@@ -0,0 +1,16 @@
+# Foundry
+out/
+cache/
+broadcast/
+
+# Environment
+.env
+
+# Node (if any tooling added)
+node_modules/
+
+# OS
+.DS_Store
+Thumbs.db
+
+.vercel

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "lib/forge-std"]
+	path = lib/forge-std
+	url = https://github.com/foundry-rs/forge-std

README.md

@@ -0,0 +1,66 @@
+## Foundry
+
+**Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.**
+
+Foundry consists of:
+
+- **Forge**: Ethereum testing framework (like Truffle, Hardhat and DappTools).
+- **Cast**: Swiss army knife for interacting with EVM smart contracts, sending transactions and getting chain data.
+- **Anvil**: Local Ethereum node, akin to Ganache, Hardhat Network.
+- **Chisel**: Fast, utilitarian, and verbose solidity REPL.
+
+## Documentation
+
+https://book.getfoundry.sh/
+
+## Usage
+
+### Build
+
+```shell
+$ forge build
+```
+
+### Test
+
+```shell
+$ forge test
+```
+
+### Format
+
+```shell
+$ forge fmt
+```
+
+### Gas Snapshots
+
+```shell
+$ forge snapshot
+```
+
+### Anvil
+
+```shell
+$ anvil
+```
+
+### Deploy
+
+```shell
+$ forge script script/Counter.s.sol:CounterScript --rpc-url <your_rpc_url> --private-key <your_private_key>
+```
+
+### Cast
+
+```shell
+$ cast <subcommand>
+```
+
+### Help
+
+```shell
+$ forge --help
+$ anvil --help
+$ cast --help
+```

foundry.lock

@@ -0,0 +1,8 @@
+{
+  "lib/forge-std": {
+    "tag": {
+      "name": "v1.15.0",
+      "rev": "0844d7e1fc5e60d77b68e469bff60265f236c398"
+    }
+  }
+}

foundry.toml

@@ -0,0 +1,23 @@
+[profile.default]
+src        = "src"
+out        = "out"
+libs       = ["lib"]
+test       = "test"
+script     = "script"
+solc       = "0.8.24"
+optimizer  = true
+optimizer_runs = 200
+verbosity  = 2
+
+[profile.default.fuzz]
+runs = 512
+seed = "0xdeadbeef"
+
+[profile.default.invariant]
+runs   = 128
+depth  = 15
+
+[fmt]
+line_length    = 100
+tab_width      = 4
+bracket_spacing = true