push

Author: mAsyamJ

.docs/ChangesTarget.md

@@ -1,22 +1,34 @@
+# RPC endpoint for deployment chain (e.g. Base Sepolia)
 RPC_URL="https://sepolia.base.org"
+
+# Deployer private key (used to broadcast deployment tx)
 PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
+
+# Operator address - signs checkpoints for ChannelSettlement (derive from OPERATOR_PRIVATE_KEY)
 OPERATOR="0x0000000000000000000000000000000000000000"
+
+# ERC20 settlement token address (e.g. USDC on Base Sepolia: 0x036CbD53842c5426634e7929541eC2318f3dCF7e)
 SETTLEMENT_TOKEN="0x0000000000000000000000000000000000000000"
+
+# Chainlink CRE Forwarder address - from https://docs.chain.link/cre/guides/workflow/using-evm-client/forwarder-directory
 CHAINLINK_FORWARDER="0x0000000000000000000000000000000000000000"
 
-# Oracle validation
+# Oracle validation - min confidence in basis points (8000 = 80%)
 MIN_CONFIDENCE="8000"
 
-# Fee config
-PROTOCOL_FEE_BPS="100"
-LP_FEE_SHARE_BPS="2000"
+# Fee config (basis points)
+PROTOCOL_FEE_BPS="250"
+LP_FEE_SHARE_BPS="1750"
 CREATOR_FEE_SHARE_BPS="1000"
 
 # SettlementRouter controls
 USE_RECEIVER_ALLOWLIST="true"
 APPROVE_MARKET_REGISTRY_RECEIVER="true"
 
-# Optional ReceiverTemplate metadata checks
+# Optional: grant AI_ORACLE_ROLE on MarketDraftBoard for CRE-driven draft proposals (omit to use deployer)
+# AI_ORACLE_ADDRESS="0x0000000000000000000000000000000000000000"
+
+# Optional ReceiverTemplate metadata checks - restrict which CRE workflows can call receivers
 EXPECTED_WORKFLOW_AUTHOR="0x0000000000000000000000000000000000000000"
 EXPECTED_WORKFLOW_ID="0x0000000000000000000000000000000000000000000000000000000000000000"
 EXPECTED_WORKFLOW_NAME=""

.env.example

@@ -0,0 +1,39 @@
+# Network: Tenderly Virtual TestNet (Worldchain Sepolia)
+RPC_URL="https://virtual.worldchain-sepolia.eu.rpc.tenderly.co/11e8d92d-b8ae-4dcd-ae5a-4d82f447dd1a"
+CHAIN_ID="4801"
+NATIVE_SYMBOL="ETH"
+BLOCK_EXPLORER_URL="https://worldchain-sepolia-explorer.alchemy.com/"
+
+# Deployer key (wallet that deploys contracts)
+PRIVATE_KEY="redacted"
+OPERATOR="0xbeaA395506D02d20749d8E39ddb996ACe1C85Bfc"
+# Operator (signs checkpoints / session finalization depending on your relayer design)
+# If your relayer needs it (recommended to keep separate from deployer):
+OPERATOR_PRIVATE_KEY="redacted"
+
+# Settlement / collateral token
+# If you don't have an ERC20 on this VT yet, keep 0x0 only if your contracts allow native ETH settlement.
+# Otherwise deploy a MockERC20 and put its address here.
+SETTLEMENT_TOKEN="0x3183a80955d6922ec4b3fe0b2db593dfd67bfb2f"
+
+# Chainlink CRE forwarder
+# On a Tenderly Virtual TestNet, you usually won't have an official forwarder address unless you deployed/mocked it.
+# If your receivers enforce forwarder-only access, this must be a real address you control/deploy.
+CHAINLINK_FORWARDER="0xbeaA395506D02d20749d8E39ddb996ACe1C85Bfc"
+
+# Oracle validation
+MIN_CONFIDENCE="8000"
+
+# Fee config
+PROTOCOL_FEE_BPS="200"   # 2%
+LP_FEE_SHARE_BPS="2000"  # 20%
+CREATOR_FEE_SHARE_BPS="2000"  # 20%
+
+# SettlementRouter controls
+USE_RECEIVER_ALLOWLIST="true"
+APPROVE_MARKET_REGISTRY_RECEIVER="true"
+
+# Optional ReceiverTemplate metadata checks
+EXPECTED_WORKFLOW_AUTHOR="0x0000000000000000000000000000000000000000"
+EXPECTED_WORKFLOW_ID="0x0000000000000000000000000000000000000000000000000000000000000000"
+EXPECTED_WORKFLOW_NAME="retropickV1"

.env.world-sepolia.tenderly

@@ -0,0 +1,125 @@
+# RetroPick Testnet Deployment
+
+Deployment guide for the CRE + Nitrolite Yellow checkpoint stack to **Tenderly Virtual TestNet** (Worldchain Sepolia).
+
+## Target Network
+
+| Property | Value |
+|----------|-------|
+| Network | Tenderly Virtual TestNet (Worldchain Sepolia) |
+| RPC URL | `https://virtual.worldchain-sepolia.eu.rpc.tenderly.co/41d3ff02-8fa1-4270-aa65-a652be2c6541` |
+| Chain ID | 4801 |
+| Native Token | ETH |
+| Block Explorer | https://worldchain-sepolia-explorer.alchemy.com/ |
+
+## Configuration (from .env)
+
+| Variable | Value | Description |
+|----------|-------|-------------|
+| `PRIVATE_KEY` | (deployer key) | Wallet that broadcasts deployment |
+| `OPERATOR` | `0xbeaA395506D02d20749d8E39ddb996ACe1C85Bfc` | Checkpoint signer for ChannelSettlement |
+| `OPERATOR_PRIVATE_KEY` | (same as deployer) | Used by relayer for signing |
+| `SETTLEMENT_TOKEN` | `0x0000000000000000000000000000000000000000` | ERC20 collateral; deploy MockERC20 if needed |
+| `CHAINLINK_FORWARDER` | `0x0000000000000000000000000000000000000000` | On VT, deploy/mock if receivers enforce it |
+| `MIN_CONFIDENCE` | `8000` | Oracle confidence (80% in bps) |
+| `PROTOCOL_FEE_BPS` | `250` | Protocol fee 2.5% |
+| `LP_FEE_SHARE_BPS` | `1750` | LP share 17.5% |
+| `CREATOR_FEE_SHARE_BPS` | `1000` | Creator share 10% |
+| `USE_RECEIVER_ALLOWLIST` | `true` | Enforce receiver allowlist |
+| `APPROVE_MARKET_REGISTRY_RECEIVER` | `true` | MarketRegistry approved for settlement |
+| `EXPECTED_WORKFLOW_NAME` | `retropickV1` | ReceiverTemplate workflow filter |
+
+## Pre-deploy
+
+1. Ensure `.env` is populated (copy from `.env.example`).
+2. **Required:** `SETTLEMENT_TOKEN` and `CHAINLINK_FORWARDER` must be non-zero. Deployment reverts otherwise:
+   - **SETTLEMENT_TOKEN** – CollateralVault requires a valid ERC20. Deploy a MockERC20 on the VT and mint tokens.
+   - **CHAINLINK_FORWARDER** – ReceiverTemplate requires a valid forwarder. On VT, deploy a mock (e.g. a simple contract you control) that can call `onReport` for testing.
+3. Fund the deployer wallet with native ETH on the VT for gas.
+
+## Deploy
+
+```bash
+cd packages/contracts
+source .env  # or export vars manually
+forge script script/DeployTestnet.s.sol:DeployTestnet \
+  --rpc-url "$RPC_URL" \
+  --broadcast \
+  --slow
+```
+
+# Export private key ke global
+export PRIVATE_KEY=$(cast wallet private-key --account rudeus33)
+# Deploy with script
+forge script script/DeployTestnet.s.sol \
+  --rpc-url https://sepolia.base.org/ \
+  --broadcast \
+  --account rudeus33
+
+`--slow` waits for each transaction to confirm before sending the next, avoiding "replacement transaction underpriced" errors when deploying many contracts.
+
+For a dry run (no broadcast):
+
+```bash
+forge script script/DeployTestnet.s.sol:DeployTestnet --rpc-url "$RPC_URL"
+```
+
+**"Replacement transaction underpriced"** – Use `--slow` (included above). If you have pending txs from a failed run, either wait for them to confirm or clear and retry.
+
+**Resume partial deployment:**
+
+```bash
+forge script script/DeployTestnet.s.sol:DeployTestnet --rpc-url "$RPC_URL" --broadcast --slow --resume
+```
+
+## Deployed Contracts
+
+After deployment, record addresses from the script output:
+
+| Contract | Address |
+|----------|---------|
+| ExecutionLedger | |
+| ChannelSettlement | |
+| MultiAssetVault | |
+| CollateralVault | |
+| MarketRegistry | |
+| FeeManager | |
+| FeePool | |
+| TreasuryPool | |
+| ReportValidator | |
+| CREReceiver | |
+| OracleCoordinator | |
+| SettlementRouter | |
+| MarketPolicy | |
+| MarketDraftBoard | |
+| DraftClaimManager | |
+| LiquidityVaultFactory | |
+| CREPublishReceiver | |
+| MarketFactory | |
+
+## Post-deploy
+
+### 1. Relayer (`apps/relayer/.env`)
+
+```
+CHANNEL_SETTLEMENT_ADDRESS=<ChannelSettlement address from deploy>
+OPERATOR_PRIVATE_KEY=<operator key>
+```
+
+### 2. CRE Workflows
+
+Configure workflows to use:
+
+- **CREReceiver** – outcome resolution + checkpoint submit
+- **CREPublishReceiver** – publish from draft
+- **MarketFactory** – CRE feed market creation
+
+### 3. Draft Proposals
+
+Deployer has `AI_ORACLE_ROLE`. Set `AI_ORACLE_ADDRESS` in `.env` and re-run deploy to grant the role to a CRE workflow for automated draft proposals.
+
+## Tenderly Notes
+
+- Virtual TestNets use ephemeral forked state; deployments are not persistent across sessions unless you use Tenderly persistence features.
+- No official Chainlink Forwarder on VT; use a mock or disable forwarder checks for testing.
+- Fund the deployer wallet with native ETH on the VT for gas.

DEPLOYMENT.md

@@ -1,13 +1,20 @@
 [profile.default]
 src = "src"
 fuzz = { runs = 10000 }
-
+use_literal_content = true # use source code
 out = "out"
 libs = ["lib"]
 via_ir = true
+
+# Reduce bytecode size for EIP-170 limit (24KB); ChannelSettlement was over limit
+optimizer = true
+optimizer_runs = 200
 remappings = [
     "@openzeppelin/=lib/openzeppelin-contracts/"
 ]
 fs_permissions = [
     { access = "read-write", path = "/home/asyam321/Project/RetroPick/RetroPick/.cursor/debug.log" }
 ]
+
+eth-rpc-url = "https://sepolia.base.org"
+chain_id = 84532

broadcast/DeployTestnet.s.sol/84532/run-1771484789778.json

@@ -1,6 +1,11 @@
 // SPDX-License-Identifier: MIT
 pragma solidity 0.8.24;
 
+/// @title DeployTestnet
+/// @notice Deploys the CRE + Nitrolite Yellow checkpoint production stack.
+/// @dev Uses MarketRegistry + ChannelSettlement. Does NOT deploy PoolMarketLegacy or SessionFinalizer.
+///      For relayer: set CHANNEL_SETTLEMENT_ADDRESS and OPERATOR_PRIVATE_KEY in apps/relayer/.env.
+
 import {Script, console2} from "forge-std/Script.sol";
 
 import {ExecutionLedger} from "../src/execution/ExecutionLedger.sol";
@@ -130,6 +135,10 @@ contract DeployTestnet is Script {
 
         d.draftBoard.setDraftClaimManager(address(d.draftClaimManager));
         d.draftBoard.grantPublishCaller(address(d.marketFactory));
+        address aiOracle = vm.envOr("AI_ORACLE_ADDRESS", address(0));
+        if (aiOracle != address(0)) {
+            d.draftBoard.grantRole(d.draftBoard.AI_ORACLE_ROLE(), aiOracle);
+        }
         d.draftClaimManager.setLiquidityVaultFactory(address(d.liquidityVaultFactory));
 
         d.marketFactory.setMarketRegistry(address(d.marketRegistry));
@@ -192,8 +201,17 @@ contract DeployTestnet is Script {
         console2.log("MarketFactory", address(d.marketFactory));
         console2.log("CREPublishReceiver", address(d.crePublishReceiver));
         console2.log("");
-        console2.log("For relayer checkpoint path, set in apps/relayer/.env:");
-        console2.log("  CHANNEL_SETTLEMENT_ADDRESS=%s", address(d.channelSettlement));
-        console2.log("  OPERATOR=<same as OPERATOR env used here>");
+        console2.log("--- Post-deploy checklist ---");
+        console2.log("");
+        console2.log("1. Relayer (apps/relayer/.env):");
+        console2.log("   CHANNEL_SETTLEMENT_ADDRESS=%s", address(d.channelSettlement));
+        console2.log("   OPERATOR_PRIVATE_KEY=<same operator key as OPERATOR env>");
+        console2.log("");
+        console2.log("2. CRE workflows: configure receivers:");
+        console2.log("   CREReceiver (outcome resolution + checkpoint submit): %s", address(d.creReceiver));
+        console2.log("   CREPublishReceiver (publish from draft): %s", address(d.crePublishReceiver));
+        console2.log("   MarketFactory (CRE feed market creation): %s", address(d.marketFactory));
+        console2.log("");
+        console2.log("3. Draft proposals: deployer has AI_ORACLE_ROLE. Set AI_ORACLE_ADDRESS to grant to CRE workflow.");
     }
 }