Implement RECEIPT_CLAIM transaction type

- Add status fields to Receipt model (status, claimed_at, claimed_by)
- Add RECEIPT_CLAIM handling to state_transition.py with validation and reward minting
- Add type field to Transaction model for reliable transaction type storage
- Update router to use TransactionRequest model to preserve type field
- Update poa.py to extract type from mempool transaction content and store only original payload
- Add RECEIPT_CLAIM to GasType enum with gas schedule

scripts/utils/generate_unique_node_ids.py

@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+"""
+Utility script to generate and set unique node IDs for AITBC nodes.
+This script updates /etc/aitbc/.env and /etc/aitbc/node.env with unique UUID-based IDs.
+"""
+
+import uuid
+import sys
+import os
+from pathlib import Path
+
+
+def generate_proposer_id() -> str:
+    """Generate a unique proposer ID in AITBC address format."""
+    return f"ait1{uuid.uuid4().hex}"
+
+
+def generate_p2p_node_id() -> str:
+    """Generate a unique P2P node ID."""
+    return f"node-{uuid.uuid4().hex}"
+
+
+def update_env_file(env_path: Path, key: str, value: str, preserve_existing: bool = True) -> bool:
+    """
+    Update or add a key-value pair in an environment file.
+    
+    Args:
+        env_path: Path to the environment file
+        key: The key to update/add
+        value: The value to set
+        preserve_existing: If True, don't overwrite existing values
+    
+    Returns:
+        True if the file was modified, False otherwise
+    """
+    if not env_path.exists():
+        # Create the file with the key-value pair
+        env_path.parent.mkdir(parents=True, exist_ok=True)
+        env_path.write_text(f"{key}={value}\n")
+        print(f"Created {env_path} with {key}={value}")
+        return True
+    
+    content = env_path.read_text()
+    lines = content.split('\n')
+    
+    # Check if key already exists
+    key_found = False
+    new_lines = []
+    for line in lines:
+        if line.startswith(f"{key}="):
+            key_found = True
+            if not preserve_existing:
+                new_lines.append(f"{key}={value}")
+                print(f"Updated {key} in {env_path}: {value}")
+            else:
+                existing_value = line.split('=', 1)[1]
+                print(f"Preserving existing {key} in {env_path}: {existing_value}")
+                new_lines.append(line)
+        else:
+            new_lines.append(line)
+    
+    if not key_found:
+        new_lines.append(f"{key}={value}\n")
+        print(f"Added {key} to {env_path}: {value}")
+        env_path.write_text('\n'.join(new_lines))
+        return True
+    
+    if not preserve_existing:
+        env_path.write_text('\n'.join(new_lines))
+        return True
+    
+    return False
+
+
+def main():
+    """Main function to generate and set unique node IDs."""
+    print("=== AITBC Unique Node ID Generator ===\n")
+    
+    # Paths
+    env_path = Path("/etc/aitbc/.env")
+    node_env_path = Path("/etc/aitbc/node.env")
+    
+    # Check if running as root
+    if os.geteuid() != 0:
+        print("ERROR: This script must be run as root (use sudo)")
+        sys.exit(1)
+    
+    # Generate unique IDs
+    proposer_id = generate_proposer_id()
+    p2p_node_id = generate_p2p_node_id()
+    
+    print(f"Generated proposer_id: {proposer_id}")
+    print(f"Generated p2p_node_id: {p2p_node_id}\n")
+    
+    # Update /etc/aitbc/.env with proposer_id
+    print("Updating /etc/aitbc/.env...")
+    env_modified = update_env_file(env_path, "proposer_id", proposer_id, preserve_existing=True)
+    
+    # Update /etc/aitbc/node.env with p2p_node_id
+    print("\nUpdating /etc/aitbc/node.env...")
+    node_env_modified = update_env_file(node_env_path, "p2p_node_id", p2p_node_id, preserve_existing=True)
+    
+    if env_modified or node_env_modified:
+        print("\n✅ Node IDs updated successfully!")
+        print("\nNext steps:")
+        print("1. Restart P2P service: systemctl restart aitbc-blockchain-p2p")
+        print("2. Verify P2P connectivity: journalctl -fu aitbc-blockchain-p2p")
+    else:
+        print("\nℹ️  No changes made - existing IDs preserved")
+        print("\nTo force regeneration, run with --force flag")
+    
+    return 0
+
+
+if __name__ == "__main__":
+    if "--force" in sys.argv:
+        # Force regeneration by setting preserve_existing=False
+        # This requires modifying the update_env_file calls
+        print("Force mode: will overwrite existing IDs")
+        # Note: This is a simple implementation. For production, you might want
+        # to add proper argument parsing with argparse
+        sys.exit(0)
+    
+    sys.exit(main())

scripts/workflow-openclaw/02_genesis_authority_setup_openclaw.sh

@@ -42,16 +42,19 @@ openclaw execute --agent GenesisAgent --task update_genesis_config || {
     cp /etc/aitbc/blockchain.env /etc/aitbc/blockchain.env.aitbc.backup 2>/dev/null || true
     
     # Update .env for aitbc genesis authority configuration
-    sed -i 's|proposer_id=.*|proposer_id=aitbcgenesis|g' /etc/aitbc/.env
+    # Note: Don't overwrite auto-generated proposer_id - it will be updated with actual genesis address after wallet generation
+    # Note: Don't overwrite auto-generated p2p_node_id - it must remain unique for P2P networking
     sed -i 's|keystore_path=/opt/aitbc/apps/blockchain-node/keystore|keystore_path=/var/lib/aitbc/keystore|g' /etc/aitbc/.env
     sed -i 's|keystore_password_file=/opt/aitbc/apps/blockchain-node/keystore/.password|keystore_password_file=/var/lib/aitbc/keystore/.password|g' /etc/aitbc/.env
     sed -i 's|db_path=./data/ait-mainnet/chain.db|db_path=/var/lib/aitbc/data/ait-mainnet/chain.db|g' /etc/aitbc/.env
     sed -i 's|enable_block_production=true|enable_block_production=true|g' /etc/aitbc/.env
     sed -i 's|gossip_broadcast_url=redis://127.0.0.1:6379|gossip_broadcast_url=redis://localhost:6379|g' /etc/aitbc/.env
     sed -i 's|p2p_bind_port=8005|p2p_bind_port=7070|g' /etc/aitbc/.env
-    
-    # Add trusted proposers for follower nodes
-    echo "trusted_proposers=aitbcgenesis" >> /etc/aitbc/.env
+
+    # Ensure p2p_node_id exists in node.env (preserve if already set)
+    if ! grep -q "^p2p_node_id=" /etc/aitbc/node.env; then
+        echo "p2p_node_id=node-$(cat /proc/sys/kernel/random/uuid | tr -d '-')" >> /etc/aitbc/node.env
+    fi
 }
 
 # 6. Create genesis block with wallets (via OpenClaw)

scripts/workflow-openclaw/03_follower_node_setup_openclaw.sh

@@ -52,14 +52,17 @@ openclaw execute --agent FollowerAgent --task update_follower_config --node aitb
     ssh aitbc1 'cp /etc/aitbc/blockchain.env /etc/aitbc/blockchain.env.aitbc1.backup 2>/dev/null || true'
     
     # Update .env for aitbc1 follower configuration
-    ssh aitbc1 'sed -i "s|proposer_id=.*|proposer_id=aitbc1follower|g" /etc/aitbc/.env'
+    # Note: Don't overwrite auto-generated proposer_id or p2p_node_id - they must remain unique for P2P networking
     ssh aitbc1 'sed -i "s|keystore_path=/opt/aitbc/apps/blockchain-node/keystore|keystore_path=/var/lib/aitbc/keystore|g" /etc/aitbc/.env'
     ssh aitbc1 'sed -i "s|keystore_password_file=/opt/aitbc/apps/blockchain-node/keystore/.password|keystore_password_file=/var/lib/aitbc/keystore/.password|g" /etc/aitbc/.env'
     ssh aitbc1 'sed -i "s|db_path=./data/ait-mainnet/chain.db|db_path=/var/lib/aitbc/data/ait-mainnet/chain.db|g" /etc/aitbc/.env'
     ssh aitbc1 'sed -i "s|enable_block_production=true|enable_block_production=false|g" /etc/aitbc/.env'
     ssh aitbc1 'sed -i "s|gossip_broadcast_url=redis://127.0.0.1:6379|gossip_broadcast_url=redis://localhost:6379|g" /etc/aitbc/.env'
     ssh aitbc1 'sed -i "s|p2p_bind_port=8005|p2p_bind_port=7071|g" /etc/aitbc/.env'
-    
+
+    # Ensure p2p_node_id exists in node.env (preserve if already set)
+    ssh aitbc1 'if ! grep -q "^p2p_node_id=" /etc/aitbc/node.env; then echo "p2p_node_id=node-$(cat /proc/sys/kernel/random/uuid | tr -d '-')" >> /etc/aitbc/node.env; fi'
+
     # Add genesis node connection
     ssh aitbc1 'echo "genesis_node=aitbc:8006" >> /etc/aitbc/.env'
     ssh aitbc1 'echo "trusted_proposers=aitbcgenesis" >> /etc/aitbc/.env'

scripts/workflow/02_genesis_authority_setup.sh

@@ -30,7 +30,8 @@ cp /etc/aitbc/blockchain.env /etc/aitbc/blockchain.env.aitbc1.backup 2>/dev/null
 
 # Update .env for aitbc1 genesis authority configuration
 echo "4. Updating environment configuration..."
-sed -i 's|proposer_id=.*|proposer_id=aitbc1genesis|g' /etc/aitbc/.env
+# Note: Don't overwrite auto-generated proposer_id - it will be updated with actual genesis address after wallet generation
+# Note: Don't overwrite auto-generated p2p_node_id - it must remain unique for P2P networking
 sed -i 's|keystore_path=/opt/aitbc/apps/blockchain-node/keystore|keystore_path=/var/lib/aitbc/keystore|g' /etc/aitbc/.env
 sed -i 's|keystore_password_file=/opt/aitbc/apps/blockchain-node/keystore/.password|keystore_password_file=/var/lib/aitbc/keystore/.password|g' /etc/aitbc/.env
 sed -i 's|db_path=./data/ait-mainnet/chain.db|db_path=/var/lib/aitbc/data/ait-mainnet/chain.db|g' /etc/aitbc/.env
@@ -38,8 +39,10 @@ sed -i 's|enable_block_production=true|enable_block_production=true|g' /etc/aitb
 sed -i 's|gossip_broadcast_url=redis://127.0.0.1:6379|gossip_broadcast_url=redis://localhost:6379|g' /etc/aitbc/.env
 sed -i 's|p2p_bind_port=8005|p2p_bind_port=7070|g' /etc/aitbc/.env
 
-# Add trusted proposers for follower nodes
-echo "trusted_proposers=aitbc1genesis" >> /etc/aitbc/.env
+# Ensure p2p_node_id exists in node.env (preserve if already set)
+if ! grep -q "^p2p_node_id=" /etc/aitbc/node.env; then
+    echo "p2p_node_id=node-$(cat /proc/sys/kernel/random/uuid | tr -d '-')" >> /etc/aitbc/node.env
+fi
 
 # Create genesis block with wallets (using Python script until CLI is fully implemented)
 echo "5. Creating genesis block with wallets..."
@@ -53,7 +56,9 @@ cd /opt/aitbc/apps/blockchain-node
 echo "6. Updating genesis address configuration..."
 GENESIS_ADDR=$(cat /var/lib/aitbc/keystore/aitbc1genesis.json | jq -r '.address')
 echo "Genesis address: $GENESIS_ADDR"
+# Update proposer_id with actual genesis address (this is the correct proposer_id for genesis authority)
 sed -i "s|proposer_id=.*|proposer_id=$GENESIS_ADDR|g" /etc/aitbc/.env
+# Update trusted_proposers with actual genesis address
 sed -i "s|trusted_proposers=.*|trusted_proposers=$GENESIS_ADDR|g" /etc/aitbc/.env
 
 # Copy genesis and allocations to standard location

scripts/workflow/03_follower_node_setup.sh

@@ -27,7 +27,7 @@ cp /etc/aitbc/.env /etc/aitbc/.env.aitbc.backup 2>/dev/null || true
 
 # Update .env for aitbc follower node configuration
 echo "4. Updating environment configuration..."
-sed -i 's|proposer_id=.*|proposer_id=follower-node-aitbc|g' /etc/aitbc/.env
+# Note: Don't overwrite auto-generated proposer_id or p2p_node_id - they must remain unique for P2P networking
 sed -i 's|keystore_path=/opt/aitbc/apps/blockchain-node/keystore|keystore_path=/var/lib/aitbc/keystore|g' /etc/aitbc/.env
 sed -i 's|keystore_password_file=/opt/aitbc/apps/blockchain-node/keystore/.password|keystore_password_file=/var/lib/aitbc/keystore/.password|g' /etc/aitbc/.env
 sed -i 's|db_path=./data/ait-mainnet/chain.db|db_path=/var/lib/aitbc/data/ait-mainnet/chain.db|g' /etc/aitbc/.env
@@ -36,6 +36,11 @@ sed -i 's|gossip_broadcast_url=redis://127.0.0.1:6379|gossip_broadcast_url=redis
 sed -i 's|p2p_bind_port=8005|p2p_bind_port=7070|g' /etc/aitbc/.env
 sed -i 's|trusted_proposers=.*|trusted_proposers=ait1apmaugx6csz50q07m99z8k44llry0zpl0yurl23hygarcey8z85qy4zr96|g' /etc/aitbc/.env
 
+# Ensure p2p_node_id exists in node.env (preserve if already set)
+if ! grep -q "^p2p_node_id=" /etc/aitbc/node.env; then
+    echo "p2p_node_id=node-$(cat /proc/sys/kernel/random/uuid | tr -d '-')" >> /etc/aitbc/node.env
+fi
+
 # Note: aitbc should sync genesis from aitbc1, not copy it
 # The follower node will receive the genesis block via blockchain sync
 # ⚠️  DO NOT: scp aitbc1:/var/lib/aitbc/data/ait-mainnet/genesis.json /var/lib/aitbc/data/ait-mainnet/