Final cleanup: remove console.log leak, fix stale references, update mocks

- Remove console.log leaking contract config in contracts/util.ts
- Update gene_splicer.ts comment to reflect GitHub secrets workflow
- Update test mock (contract.ts): fix stale get_entropy, add batch methods
- Fix keepAlive.sh: default source to splicers-server, accept override arg
- Update .env.example: cleaner layout, document GitHub secret relationship
- Fix Home.tsx: remove Debugger reference from production text

Author: AshFrancis

.env.example

@@ -1,42 +1,25 @@
-# The environment to use `development`, `testing`, `staging`, `production`
+# Environment: development | staging | production
 STELLAR_SCAFFOLD_ENV=development
 
-# Location of the config files for this project for the scaffold stellar CLI.
-# Learn more at https://developers.stellar.org/docs/tools/cli/stellar-cli#stellar-config-dir
+# Stellar CLI config directory
 XDG_CONFIG_HOME=".config"
 
-# Prefix with "PUBLIC_" to make available in frontend files
-# Which Stellar network to use in the frontend: local, testnet, futurenet, or mainnet
-# More on Stellar networks: https://developers.stellar.org/docs/networks
+# Network configuration (uncomment ONE block)
 
+# --- Local development ---
 PUBLIC_STELLAR_NETWORK="LOCAL"
-# The Stellar network passphrase, this is local
 PUBLIC_STELLAR_NETWORK_PASSPHRASE="Standalone Network ; February 2017"
-# The Stellar network RPC URL. this is local
 PUBLIC_STELLAR_RPC_URL="http://localhost:8000/rpc"
-# The Stellar Horizon URL. this is local
 PUBLIC_STELLAR_HORIZON_URL="http://localhost:8000"
 
-# PUBLIC_STELLAR_NETWORK="TESTNET"
-# PUBLIC_STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
-# PUBLIC_STELLAR_RPC_URL="https://soroban-testnet.stellar.org"
-# PUBLIC_STELLAR_HORIZON_URL="https://horizon-testnet.stellar.org"
+# --- Testnet ---
+# PUBLIC_STELLAR_NETWORK=TESTNET
+# PUBLIC_STELLAR_NETWORK_PASSPHRASE=Test SDF Network ; September 2015
+# PUBLIC_STELLAR_RPC_URL=https://soroban-testnet.stellar.org
+# PUBLIC_STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org
 
-# PUBLIC_STELLAR_NETWORK="MAINNET"
-# PUBLIC_STELLAR_NETWORK_PASSPHRASE="Public Global Stellar Network ; September 2015"
-# PUBLIC_STELLAR_RPC_URL=
-# PUBLIC_STELLAR_HORIZON_URL=
-
-# ============================================================================
-# CONTRACT IDs - CRITICAL: MUST UPDATE AFTER EVERY DEPLOYMENT!
-# ============================================================================
-# After deploying contracts, you MUST manually update these IDs.
-# Check: cat .config/stellar/contract-ids/gene_splicer.json
-# Then copy the ID here and restart the dev server.
-#
-# ⚠️ If these IDs don't match the deployed contract, your frontend will fail
-# silently - transactions will simulate successfully but not actually execute!
-# ============================================================================
-
-# Gene Splicer contract ID
-PUBLIC_GENE_SPLICER_CONTRACT_ID="YOUR_CONTRACT_ID_HERE"
+# Contract ID — must match the deployed contract.
+# For local dev: auto-populated by `stellar scaffold watch`
+# For testnet/mainnet: update manually after deployment
+# Also stored as TESTNET_CONTRACT_ID GitHub secret for CI/CD
+PUBLIC_GENE_SPLICER_CONTRACT_ID=YOUR_CONTRACT_ID_HERE

scripts/keepAlive.sh

@@ -1,30 +1,26 @@
 #!/bin/bash
-# Keep-alive script for the Gene Splicer contract on Soroban testnet
+# Keep-alive script for the Gene Splicer contract on Soroban testnet.
 # Extends the TTL for the contract instance and WASM code to prevent expiration.
 #
 # Usage:
-#   bash scripts/keepAlive.sh
+#   bash scripts/keepAlive.sh [source-identity]
 #
-# Recommended: Run weekly via cron or GitHub Actions scheduled workflow.
-# Soroban testnet minimum persistent TTL is ~24 hours (4096 ledgers).
+# The source identity defaults to "splicers-server" (the funded server wallet).
 # The contract's extend_ttl() sets TTL to ~30 days (432,000 ledgers).
 
 set -euo pipefail
 
-# Load contract ID from .env
 CONTRACT_ID=$(grep PUBLIC_GENE_SPLICER_CONTRACT_ID .env | cut -d= -f2)
 NETWORK="testnet"
-SOURCE="testnet-user"
+SOURCE="${1:-splicers-server}"
 
 if [ -z "$CONTRACT_ID" ]; then
   echo "ERROR: CONTRACT_ID not found in .env"
   exit 1
 fi
 
-echo "Extending TTL for contract: $CONTRACT_ID"
+echo "Extending TTL for contract: $CONTRACT_ID (source: $SOURCE)"
 
-# Call the contract's extend_ttl() function
-# This extends both instance storage and WASM code TTL
 stellar contract invoke \
   --id "$CONTRACT_ID" \
   --network "$NETWORK" \

src/contracts/gene_splicer.ts

@@ -1,9 +1,8 @@
 import * as Client from 'gene_splicer';
 import { rpcUrl, networkPassphrase } from './util';
 
-// CRITICAL: Contract ID must be updated in .env after EVERY deployment!
-// The auto-generated TypeScript bindings cannot be relied upon for staging/production.
-// Always use PUBLIC_GENE_SPLICER_CONTRACT_ID from .env as the single source of truth.
+// Contract ID is read from PUBLIC_GENE_SPLICER_CONTRACT_ID in .env (local dev)
+// and from TESTNET_CONTRACT_ID GitHub secret (CI/CD deployments).
 const contractId = import.meta.env.PUBLIC_GENE_SPLICER_CONTRACT_ID;
 
 if (!contractId) {

src/contracts/util.ts

@@ -107,13 +107,6 @@ export async function createGeneSplicerClient(publicKey: string) {
     );
   }
 
-  console.log(
-    "[createGeneSplicerClient] Write client using contract ID:",
-    contractId,
-    "Network:",
-    stellarNetwork,
-  );
-
   return new GeneSplicerModule.Client({
     networkPassphrase,
     contractId,

src/test/mocks/contract.ts

@@ -1,6 +1,14 @@
 import { vi } from "vitest";
 import type { GenomeCartridge, Creature, Gene } from "gene_splicer";
 
+export function createMockGene(overrides?: Partial<Gene>): Gene {
+  return {
+    id: 6,
+    rarity: { tag: "Normal", values: undefined as never },
+    ...overrides,
+  };
+}
+
 export function createMockCartridge(
   overrides?: Partial<GenomeCartridge>,
 ): GenomeCartridge {
@@ -15,32 +23,26 @@ export function createMockCartridge(
   };
 }
 
-export function createMockGene(overrides?: Partial<Gene>): Gene {
-  return {
-    id: 3,
-    rarity: { tag: "Normal", values: undefined },
-    ...overrides,
-  };
-}
-
 export function createMockCreature(overrides?: Partial<Creature>): Creature {
   return {
     id: 1,
     owner: "GBZXN7PIRZGNMHGA7MUUUF4GWPY5AYPV6LY4UV2GL6VJGIQRXFDNMADI",
     skin_id: 5,
     entropy_round: 12345n,
     finalized_at: BigInt(Date.now()),
-    head_gene: createMockGene({ id: 2 }),
-    body_gene: createMockGene({ id: 4 }),
-    legs_gene: createMockGene({
-      id: 7,
-      rarity: { tag: "Rare", values: undefined },
+    head_gene: createMockGene({
+      id: 2,
+      rarity: { tag: "Rare", values: undefined as never },
     }),
+    body_gene: createMockGene({
+      id: 4,
+      rarity: { tag: "Legendary", values: undefined as never },
+    }),
+    legs_gene: createMockGene({ id: 7 }),
     ...overrides,
   };
 }
 
-// Mock contract client
 export function createMockContractClient() {
   return {
     splice_genome: vi.fn().mockResolvedValue({
@@ -55,17 +57,20 @@ export function createMockContractClient() {
     get_user_cartridges: vi.fn().mockResolvedValue({
       simulate: vi.fn().mockResolvedValue({ result: [1] }),
     }),
+    get_cartridges_batch: vi.fn().mockResolvedValue({
+      simulate: vi.fn().mockResolvedValue({ result: [createMockCartridge()] }),
+    }),
     get_user_creatures: vi.fn().mockResolvedValue({
       simulate: vi.fn().mockResolvedValue({ result: [1] }),
     }),
     get_creature: vi.fn().mockResolvedValue({
       simulate: vi.fn().mockResolvedValue({ result: createMockCreature() }),
     }),
-    get_entropy: vi.fn().mockResolvedValue({
-      simulate: vi.fn().mockResolvedValue({ result: null }),
+    get_creatures_batch: vi.fn().mockResolvedValue({
+      simulate: vi.fn().mockResolvedValue({ result: [createMockCreature()] }),
+    }),
+    extend_ttl: vi.fn().mockResolvedValue({
+      simulate: vi.fn().mockResolvedValue({}),
     }),
   };
 }
-
-// Mock GeneSplicer default export
-export const mockGeneSplicerClient = createMockContractClient();