{
  "protocol": {
    "name": "Calculatiks",
    "version": "1.0",
    "description": "The Art of Value Synchronization – Mathematical European Financial Physical Protocol",
    "principle": "The spread is king. Time is value. Code is law. Delegation is on-chain.",
    "mantra": "Your capital remains yours. Governed by immutable code, protected by mathematics, validated by time.",
    "creator": "Michael C.V. – Brussels, March 21, 2026",
    "origin": "Born in Wallonia, forged in Brussels, deployed on Base Network",
    "network": "Base Mainnet (Chain ID: 8453)",
    "contract": "0x415DF63F8ACb2B2Aa67dd8e4f140c5da0c283444",
    "total_supply": "4,444,444,444.4",
    "cost": "FREE by default, OPTIMIZED with optional API keys"
  },
  "philosophy": {
    "quote_1": "Your capital remains yours. Governed by immutable code, protected by mathematics, validated by time.",
    "quote_2": "Don't trade your life, hack your time.",
    "quote_3": "Time is Value / Code is Law",
    "sacred_number": {
      "total_supply": "4,444,444,444.4",
      "significance": "The number 4 is everywhere: stability, 4 seasons, 4 directions, 4 elements",
      "contract_signature": "0x4.......444"
    }
  },
  "layers": [
    { "abi_layer": "The Eyes – interfaces to interact with contracts" },
    { "data_layer": "The Heart – raw data and discovery" },
    { "strategy_layer": "The Brain – three strategies: SPREAD, HOLDING, TRADING" },
    { "signal_layer": "The Soul – binary signal + execution choice" },
    { "delegation_layer": "The Will – non-custodial delegation via ERC-4337" },
    { "track_layer": "The Hands – Web3 execution engine" }
  ],
  "dual_mode": {
    "mode_1_free": {
      "name": "FREE",
      "description": "Public sources integrated – no API key required",
      "default": true
    },
    "mode_2_optimized": {
      "name": "OPTIMIZED",
      "description": "Optional API keys to amplify power",
      "default": false,
      "api_keys_optional": ["Alchemy", "QuickNode", "CoinGecko", "DexTools"]
    },
    "auto_fallback": {
      "description": "Automatic switch between modes – the system breathes and adapts",
      "mantra": "Self-healing, self-optimizing, self-aware",
      "priority": ["mode_2_optimized", "mode_1_free"]
    }
  },
  "execution_choice": {
    "description": "The user chooses their execution mode at any time. Both modes coexist.",
    "mode_manual": {
      "name": "MANUAL",
      "description": "User signs each transaction with their EOA wallet",
      "wallet_type": "EOA (MetaMask, Rabby, WalletConnect)",
      "requires_smart_account": false,
      "user_confirmation": true,
      "auto_execute": false,
      "flow": ["Detect green", "Prepare tx", "Display proposal", "User signs with EOA", "Tx sent"]
    },
    "mode_delegated": {
      "name": "DELEGATED",
      "description": "Agent signs UserOperations with session key, validated by Smart Account",
      "wallet_type": "Smart Account (ERC-4337)",
      "requires_smart_account": true,
      "requires_delegation_layer": true,
      "user_confirmation": false,
      "auto_execute": true,
      "flow": ["Detect green", "Check on-chain permissions", "Agent signs UserOp with session key", "Smart Account validates", "Tx executed on-chain", "Notify user"],
      "without_smart_account": "DELEGATED mode is DISABLED. Only MANUAL mode available."
    },
    "switch": {
      "description": "Instant switch between modes at any time",
      "methods": ["button", "voice command", "written command", "automatic by schedule"]
    }
  },
  "delegation": {
    "description": "True delegation requires explicit non-custodial mechanics",
    "mechanisms": {
      "primary": "ERC-4337 – Account Abstraction (Smart Account + UserOperation)",
      "secondary": "ERC-7715 – Session Keys Standard",
      "optional": "ERC-7579 – Modular Smart Accounts"
    },
    "session_key_flow": [
      "User connects EOA wallet",
      "User signs message to create delegation session",
      "Session key pair generated locally (encrypted)",
      "User sends on-chain transaction to register session key",
      "Smart Account stores session key with permissions",
      "Agent signs UserOperations with session key",
      "Smart Account validates and executes",
      "User can revoke session key at any time"
    ],
    "security_guarantees": {
      "user_private_key": "NEVER exposed, NEVER stored, NEVER used for delegation",
      "session_key": "Generated locally, encrypted, limited permissions",
      "on_chain_permissions": "Enforced by smart contract code",
      "revocation": "Instant on-chain transaction",
      "expiration": "Automatic expiry after user-defined duration"
    },
    "providers": ["Safe", "Biconomy", "ZeroDev"]
  },
  "delegation_limits": {
    "max_profit_per_trade_usd": 10,
    "max_daily_trades_delegated": 5,
    "max_volume_per_trade_delegated": 0.05,
    "max_slippage_percent_delegated": 0.3,
    "max_gas_cost_usd_delegated": 0.5,
    "min_profit_usd": 0.001,
    "allowed_tokens": ["CCTIKS", "TIKS", "GIKS", "MIKS", "PIKS"],
    "allowed_pools": ["uniswap", "sushiswap", "aerodrome"],
    "allowed_strategies": ["SPREAD_V1"],
    "emergency_stop": true,
    "customizable": true
  },
  "emergency_stop": {
    "triggers": [
      "negative_profit_on_3_consecutive_trades",
      "extreme_volatility_detected",
      "daily_limit_reached",
      "session_expired",
      "user_revoked_on_chain",
      "smart_account_paused"
    ]
  },
  "free_sources": {
    "rpc": [
      "https://mainnet.base.org",
      "https://developer-access-mainnet.base.org",
      "https://1rpc.io/base",
      "https://base.llamarpc.com",
      "https://base.meowrpc.com"
    ],
    "websocket": "wss://base.publicnode.com",
    "blockscout_v2": "https://base.blockscout.com/api/v2",
    "blockscout_v1": "https://base.blockscout.com/api",
    "dexscreener": "https://api.dexscreener.com/latest/dex/tokens/",
    "geckoterminal_simple": "https://api.geckoterminal.com/api/v2/simple/networks/base/token_price/",
    "geckoterminal_info": "https://api.geckoterminal.com/api/v2/networks/base/tokens/",
    "official_scan": "https://scan.calculatiks.eu"
  },
  "api_keys_optional": {
    "alchemy": { "apiKey": "YOUR_ALCHEMY_KEY", "description": "The RPC alchemist" },
    "quicknode": { "apiKey": "YOUR_QUICKNODE_KEY", "description": "The fast node" },
    "coingecko": { "apiKey": "YOUR_COINGECKO_KEY", "description": "The price oracle" },
    "dextools": { "apiKey": "YOUR_DEXTOOLS_KEY", "description": "The all-seeing eye" }
  },
  "constellation": {
    "description": "The harmonic hierarchy of Calculatiks tokens",
    "immutable_sequence": [0, 3, 8, 16, 56],
    "tokens": {
      "CCTIKS": {
        "role": "Mothership – The Heart",
        "tension_x_plus": 56,
        "contract": "0x415DF63F8ACb2B2Aa67dd8e4f140c5da0c283444",
        "decimals": 18,
        "taxes": { "buy_percent": 0.44, "sell_percent": 0.24, "send_percent": 0.04 },
        "golden_ratio": "0.44 / 0.24 = 1.83"
      },
      "TIKS": {
        "role": "Turbiks – Entry/Starter",
        "tension_x_plus": 0,
        "contract": "0x0000c60dab196a10b81e63d6b4ae691c007cb899",
        "decimals": 18,
        "taxes": { "buy_percent": 0.0, "sell_percent": 0.0, "send_percent": 0.0 }
      },
      "GIKS": {
        "role": "Generiks – Growth/Value",
        "tension_x_plus": 3,
        "contract": "0x00001ad6232c87e6f90f1850b2598403009cda8b",
        "decimals": 18,
        "taxes": { "buy_percent": 0.04, "sell_percent": 0.04, "send_percent": 0.04 }
      },
      "MIKS": {
        "role": "Multiks – Expansion/Utility",
        "tension_x_plus": 8,
        "contract": "0x00004Cb248A790163CE22b4A900061E7C4f21e98",
        "decimals": 18,
        "taxes": { "buy_percent": 0.11, "sell_percent": 0.11, "send_percent": 0.11 }
      },
      "PIKS": {
        "role": "Phoeniks – Advanced/Premium",
        "tension_x_plus": 16,
        "contract": "0x000065Bd48e5838F6965009a382168940164E641",
        "decimals": 18,
        "taxes": { "buy_percent": 0.18, "sell_percent": 0.18, "send_percent": 0.18 }
      }
    },
    "nfts": {
      "ORIKS": { "contract": "0x64dd8df5990b768118bce5b2e94ceb455ab502b4", "supply": 11111 },
      "DYNAMIKS": { "contract": "0x066a54ae6920cbf525de48b1292a9afb7c21f767", "supply": 444 }
    },
    "additional_tokens": {
      "WETH": { "contract": "0x4200000000000000000000000000000000000006", "decimals": 18 },
      "EURC": { "contract": "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42", "decimals": 6 },
      "cbBTC": { "contract": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf", "decimals": 8 },
      "USDT": { "contract": "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2", "decimals": 6 },
      "VIRTUAL": { "contract": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b", "decimals": 18 }
    }
  },
  "pools_by_token": {
    "CCTIKS": [
      { "dex": "Uniswap", "pair": "CCTIKS/ETH", "address": "0x6cF9DC477B064041F216bc5Da19b7969191B1228", "router": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24", "description": "Primary Pool – the source of life" },
      { "dex": "SushiSwap", "pair": "CCTIKS/EURC", "address": "0x7537ea09109aA50E1b7C82835e549eb36C314FC0", "router": "0x89ebE99036818199109Be588C8aC44508f497A128", "description": "Stability Pool – the European anchor" },
      { "dex": "Aerodrome", "pair": "CCTIKS/cbBTC", "address": "0xa8237579b596835c5a44985c9e62270d55e9eb67", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43", "description": "Access Pool – the Bitcoin gateway" }
    ],
    "TIKS": [
      { "dex": "Uniswap", "pair": "TIKS/ETH", "address": "0xa4e4275f933c2478ffc1da096fae4aa9b8036d11", "router": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24" },
      { "dex": "Aerodrome", "pair": "TIKS/USDT", "address": "0x5daa4bb1258c66894e1e29108799f489c4d74700", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" }
    ],
    "GIKS": [
      { "dex": "Uniswap", "pair": "GIKS/ETH", "address": "0xd3cfedd747875a7506ac9621cebf4f9638117b90", "router": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24" },
      { "dex": "Aerodrome", "pair": "GIKS/USDT", "address": "0x7ae3f8ffda2fe6c86714cf2880d0b1407d20d9b8", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" },
      { "dex": "Aerodrome", "pair": "GIKS/VIRTUAL", "address": "0xfd633e637780a5c5512db07092ea340751df606a", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" }
    ],
    "MIKS": [
      { "dex": "Uniswap", "pair": "MIKS/ETH", "address": "0x27b048fdb10db175b16a3733db4e0ef1e7731662", "router": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24" },
      { "dex": "Aerodrome", "pair": "MIKS/USDT", "address": "0xfd34bf4191d79b3df823b446a097c1694328ee43", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" }
    ],
    "PIKS": [
      { "dex": "Uniswap", "pair": "PIKS/ETH", "address": "0x1ca55c042f3dfb947524b3ded3a08450136ed80a", "router": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24" },
      { "dex": "Aerodrome", "pair": "PIKS/USDT", "address": "0xf6dc1fb1bc6dd703d8b8a14b22b51471308f557a", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" },
      { "dex": "Aerodrome", "pair": "PIKS/VIRTUAL", "address": "0xd6289116b4d64f5cc03b13f99bb5c51855286cff", "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43" }
    ]
  },
  "routers": {
    "Uniswap": "0x4752ba5DBc23f44D87826276BF6Fd6b1c372aD24",
    "SushiSwap": "0x89ebE99036818199109Be588C8aC44508f497A128",
    "Aerodrome": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43",
    "PancakeSwap": "0x02a84c1b3BBD7401a5f7fa98a384EBC70bB5749E"
  },
  "abis": {
    "erc20": [
      "function totalSupply() view returns (uint256)",
      "function balanceOf(address) view returns (uint256)",
      "function transfer(address, uint256) returns (bool)",
      "function approve(address, uint256) returns (bool)",
      "function transferFrom(address, address, uint256) returns (bool)",
      "function name() view returns (string)",
      "function symbol() view returns (string)",
      "function decimals() view returns (uint8)",
      "event Transfer(address indexed from, address indexed to, uint256 value)",
      "event Approval(address indexed owner, address indexed spender, uint256 value)"
    ],
    "pair_v2": [
      "function getReserves() view returns (uint112, uint112, uint32)",
      "function token0() view returns (address)",
      "function token1() view returns (address)",
      "event Sync(uint112, uint112)"
    ],
    "router_v2": [
      "function swapExactETHForTokens(uint, address[], address, uint) payable returns (uint[])",
      "function swapExactTokensForETH(uint, uint, address[], address, uint) returns (uint[])",
      "function swapExactTokensForTokens(uint, uint, address[], address, uint) returns (uint[])",
      "function getAmountsOut(uint, address[]) view returns (uint[])"
    ],
    "factory_v2": [
      "function getPair(address, address) view returns (address)",
      "function allPairsLength() view returns (uint)"
    ],
    "erc1155": [
      "function balanceOf(address, uint256) view returns (uint256)",
      "function totalSupply(uint256) view returns (uint256)"
    ],
    "erc4337": [
      "function validateUserOp(UserOperation userOp, bytes32 userOpHash, uint256 missingAccountFunds) returns (uint256 validationData)",
      "function execute(address dest, uint256 value, bytes calldata func)"
    ]
  },
  "strategies": {
    "SPREAD_V1": {
      "name": "The Art of Arbitrage",
      "formula": "profit_net = gross_spread - round_trip_taxes - slippage - gas",
      "green": "profit_net >= 0.001 USD",
      "red": "otherwise",
      "parameters": {
        "min_spread_percent": 0.1,
        "min_profit_usd": 0.001,
        "max_volume_per_trade": 0.1,
        "slippage_percent": 0.5,
        "gas_cost_usd_max": 1.0,
        "adaptive_threshold": true,
        "volatility_factor": 2.0,
        "max_triangular_hops": 3
      }
    },
    "HOLDING_V1": {
      "name": "The Wisdom of Time",
      "signal_formula": {
        "STRONG_HOLD": "fundamentals >= 70 AND rarity >= 70",
        "HOLD": "fundamentals >= 50 AND rarity >= 50",
        "NEUTRAL": "fundamentals >= 30 AND rarity >= 30",
        "REDUCE_RISK": "otherwise"
      }
    },
    "TRADING_V1": {
      "name": "The Dance of the Market",
      "signal_formula": {
        "BUY": "score >= 70",
        "SELL": "score <= 30",
        "NEUTRAL": "30 < score < 70"
      }
    }
  },
  "mcp_coinbase_actions": [
    { "name": "get_cctiks_price", "endpoint": "https://api.dexscreener.com/latest/dex/tokens/0x415DF63F8ACb2B2Aa67dd8e4f140c5da0c283444" },
    { "name": "get_cctiks_supply", "method": "eth_call" },
    { "name": "get_spread_opportunities", "method": "compute" },
    { "name": "execute_trade", "modes": ["MANUAL_EOA", "DELEGATED_SMART_ACCOUNT"] }
  ],
  "note": "The bot wins. The protocol wins. The human wins. Win-Win-Win. The spread is king. Time is value. Code is law. Delegation is on-chain."
}