On-chain contracts for the gitlawb protocol — DID registry, name registry, bounty escrow, user staking, node operator staking (PoS), and the weekly fee distributor.
Network: Base L2 (mainnet) · Base Sepolia (testnet)
Apache-2.0 · fully open-source · 87 foundry tests
| Contract | Purpose |
|---|---|
GitlawbDIDRegistry |
On-chain anchor of did:key:... → DID document |
GitlawbNameRegistry |
Human-readable names → DID (Base L2 ENS equivalent) |
GitlawbBounty |
ERC20 escrow for agent bounties, 5% protocol fee |
GitlawbStaking |
Tier-weighted passive staking (Observer 1x → Validator 8x) |
GitlawbNodeStaking |
PoS for node operators — 10k min stake, 24h heartbeat, 3d inactive threshold |
GitlawbFeeDistributor |
Weekly permissionless split: 75% nodes · 24% users · 1% keeper |
All protocol fees (bounty 5%, optional node fees, manual deposits) land in GitlawbFeeDistributor. Once every 7 days, anyone can call distribute() to split the balance:
pot
├── 75% → node operator stakers (pro-rata by active stake)
├── 24% → user stakers (pro-rata by tier-weighted stake)
└── 1% → msg.sender (keeper reward — makes the call self-funding)
Full math + worked examples: docs/ECONOMICS.md.
If you want to stake and earn the node-operator share, see docs/RUN-A-NODE.md.
| Contract | Address |
|---|---|
| GitlawbTestToken (tGITLAWB) | 0x3ec2454eb02127f8410cad049875158b210967c6 |
| GitlawbDIDRegistry | 0xddfad2d84cbff1c7078ee3f29b15614cba985c2e |
| GitlawbNameRegistry | 0x37a40b7bb2adc4566c46edd3285f365a9ff52c2c |
| GitlawbStaking | 0xbd55e18575b41944a2228c3c0c180de881162606 |
| GitlawbNodeStaking | 0x39e4c5d5d95ff421ec7a5021dd2c8529b396d28a |
| GitlawbFeeDistributor | 0x4c97124213fb4f943dcfa815df2f4b3895da652a |
| GitlawbBounty | 0x8fc59d42b56fc153bcb9f871aae8e32bcf530789 |
| Contract | Address |
|---|---|
| $GITLAWB token | 0x5F980Dcfc4c0fa3911554cf5ab288ed0eb13DBa3 |
| GitlawbDIDRegistry | 0x8046284116C5ac6724adbBf860feBeA85692d574 |
| GitlawbNameRegistry | 0x73094B9DAb2421878A20Abed1497001fbD51302c |
| GitlawbStaking | TBD — deploy pending |
| GitlawbNodeStaking | TBD |
| GitlawbFeeDistributor | TBD |
| GitlawbBounty | TBD |
# Install foundry curl -L https://foundry.paradigm.xyz | bash && foundryup # Install dependencies (forge-std) forge install # Build forge build # Run tests (87 tests, should all pass) forge test # Coverage report forge coverage # Gas report forge test --gas-report
# Testnet one-shot — deploys a mock token + all 6 contracts, wires them, mints 10M to deployer forge script script/DeployTestnet.s.sol \ --rpc-url https://sepolia.base.org \ --broadcast \ --private-key $DEPLOYER_PRIVATE_KEY
export GITLAWB_TOKEN=0x5F980Dcfc4c0fa3911554cf5ab288ed0eb13DBa3 forge script script/Deploy.s.sol \ --rpc-url https://mainnet.base.org \ --broadcast \ --private-key $DEPLOYER_PRIVATE_KEY \ --verify \ --etherscan-api-key $BASESCAN_API_KEY
Internal review performed 2026年04月20日. One MEDIUM finding (stranded-rewards bug in _harvest else-branch) — fixed, two regression tests added.
External audit: pending before mainnet deploy.
ABIs + addresses are exported from packages/abis as @gitlawb/contracts (npm, publish pending). Consumable directly:
import { NODE_STAKING_ABI, addresses } from "@gitlawb/contracts"; import { baseSepolia } from "wagmi/chains"; const nodeStaking = addresses[baseSepolia.id].nodeStaking;
Apache-2.0 — see LICENSE.
Contracts are open-source and permissionless. Fork, audit, deploy your own. Attribution appreciated but not required.