# Calculatiks – Official Protocol v1.0
# The Art of Value Synchronization
# "Your capital remains yours. Governed by immutable code, protected by mathematics, validated by time."
# "Time is Value / Code is Law"
# "Delegation is on-chain."

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: "Brussels U.E., 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"
    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"

burn_schedule:
  vault_initial: 48888888
  vault_weekly: 2000000
  vault_monthly: 10000000
  vault_annual: 120000000
  booster_flash: 88888888
  booster_daily: 11111111
  transactional_buy_percent: 0.10
  transactional_sell_percent: 0.05
  transactional_send_percent: 0.01

liquidity_injection:
  periodicity_days: 111
  reinvest_percent: 100
  destination: "Weakest strategic pool"

golden_ratio:
  value: "1.83"
  bot_equation: "Profit = Price Difference - 0.68%"

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.
  Brussels, E.U. – Base Network.