Bce 8698 gal 445 create ton docker

.gitignore

@@ -5,3 +5,13 @@
 *.bak
 *.original
 custom.yml
+.idea/
+*.iml
+*.ipr
+*.iws
+.vscode/
+.DS_Store
+*.log
+*.tmp
+tmp/
+temp/

.pre-commit-config.yaml

@@ -10,14 +10,10 @@ repos:
       - id: check-shebang-scripts-are-executable
       - id: check-executables-have-shebangs
       - id: detect-private-key
-      - id: check-ast
-      - id: debug-statements
       - id: check-merge-conflict
       - id: check-added-large-files
       - id: mixed-line-ending
       - id: check-case-conflict
-      - id: requirements-txt-fixer
-      - id: check-toml
 
   - repo: https://github.com/jumanjihouse/pre-commit-hooks
     rev: 3.0.0
@@ -33,13 +29,7 @@ repos:
     rev: v2.4.1
     hooks:
       - id: codespell
-
-  # Dockerfiles
-  # Disabled bcs macOS Docker might not be installed
-  # - repo: https://github.com/hadolint/hadolint
-  #   rev: v2.13.1
-  #   hooks:
-  #     - id: hadolint-docker
+        args: ['-L', 'pyton']
 
   # YAML style (beyond syntax)
   - repo: https://github.com/adrienverge/yamllint

README.md

@@ -0,0 +1,114 @@
+# Overview
+
+Docker Compose for TON (The Open Network) liteserver nodes.
+
+`cp default.env .env`, then `nano .env` and adjust values for the right network (mainnet/testnet), particularly `GLOBAL_CONFIG_URL` and `SNAPSHOT`.
+
+Meant to be used with [central-proxy-docker](https://github.com/CryptoManufaktur-io/central-proxy-docker) for traefik and Prometheus remote write; use `:ext-network.yml` in `COMPOSE_FILE` inside `.env` in that case.
+
+`./ethd install` brings in docker-ce, if you don't have Docker installed already.
+
+`cp default.env .env`
+
+`nano .env` and adjust variables, particularly `GLOBAL_CONFIG_URL` and `SNAPSHOT`
+
+`./ethd up`
+
+To update the software, run `./ethd update` and then `./ethd up`
+
+Initial sync: ~10 hours (~4-5 hours with snapshot).
+
+# Configuration
+
+## Mainnet
+
+Basic setup:
+```properties
+TON_BRANCH=mainnet
+GLOBAL_CONFIG_URL=https://ton.org/global.config.json
+SNAPSHOT=latest
+```
+
+With HTTP API (Traefik):
+```properties
+COMPOSE_FILE=ton.yml:ton-http-api.yml
+```
+
+With HTTP API (direct port):
+```properties
+COMPOSE_FILE=ton.yml:ton-http-api.yml:ton-http-api-shared.yml
+TON_API_HTTP_PORT=8081
+```
+
+With local RPC access:
+```properties
+COMPOSE_FILE=ton.yml:ton-shared.yml
+```
+
+## Testnet
+
+```properties
+TON_BRANCH=testnet
+GLOBAL_CONFIG_URL=https://ton.org/testnet-global.config.json
+SNAPSHOT=latest_testnet
+```
+
+## HTTP API
+
+Test endpoints:
+```bash
+# masterchain info
+curl -H 'Content-Type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"getMasterchainInfo","params":[]}' \
+  http://localhost:8081
+
+# health check
+curl http://localhost:8081/healthcheck
+```
+
+# Operations
+
+## Check Sync Status
+```bash
+./scripts/check-sync.sh
+```
+Exit codes: 0=synced, 1=syncing, 2=error
+
+## Monitor Logs
+```bash
+./ethd logs -f ton
+```
+
+## Node Status
+```bash
+docker compose exec ton mytonctrl
+MyTonCtrl> status
+```
+
+# Hardware Requirements
+
+**Mainnet:**
+- 16 cores, 64GB RAM
+- 1TB SSD/NVMe (~250GB used, grows over time)
+- 1 Gbps, 10TB+ monthly traffic
+
+**Testnet:** Similar, ~100GB storage
+
+# Ports
+
+Default ports (customizable in `.env`):
+- `VALIDATOR_PORT` (30001/udp) - P2P networking
+- `LITESERVER_PORT` (30003/tcp) - Liteserver connections
+- `VALIDATOR_CONSOLE_PORT` (30002/tcp) - Console access
+
+Public IP auto-detected on startup. Override with `PUBLIC_IP` in `.env` if needed.
+
+# Customization
+
+Use `custom.yml` to override any settings (not tracked by git). Add to `COMPOSE_FILE` in `.env`.
+
+See `default.env` for all options.
+
+## Version
+
+This is TON Docker v1.0.0

default.env

@@ -0,0 +1,52 @@
+# copy to .env and adjust
+COMPOSE_FILE=ton.yml
+
+# uncomment to override public ip (kubernetes/special networks)
+#PUBLIC_IP=
+
+TON_BRANCH=mainnet
+
+# testnet: https://ton.org/testnet-global.config.json
+GLOBAL_CONFIG_URL=https://ton.org/global.config.json
+
+MYTONCTRL_VERSION=master
+TELEMETRY=true
+IGNORE_MINIMAL_REQS=true
+MODE=liteserver
+
+ARCHIVE_TTL=2592000
+STATE_TTL=86400
+VERBOSITY=1
+
+LITESERVER_PORT=30003
+VALIDATOR_PORT=30001
+VALIDATOR_CONSOLE_PORT=30002
+
+TON_HOST=ton
+TON_API_HOST=ton-api
+DOMAIN=example.com
+
+# faster sync (~200GB): latest | latest_testnet | https://dump.ton.org/dumps/latest.tar.lz
+SNAPSHOT=
+
+TON_DOCKERFILE=Dockerfile.binary
+TON_DOCKER_TAG=latest
+TON_DOCKER_REPO=ghcr.io/ton-blockchain/ton-docker-ctrl
+
+# add ton-http-api.yml to COMPOSE_FILE to enable
+TON_API_HTTP_PORT=8081
+TON_API_LOGS_LEVEL=INFO
+TON_API_GET_METHODS_ENABLED=1
+TON_API_JSON_RPC_ENABLED=1
+TON_API_WEBSERVERS_WORKERS=1
+TON_API_CACHE_ENABLED=0
+TON_API_ROOT_PATH=/
+TON_API_TONLIB_PARALLEL_REQUESTS_PER_LITESERVER=50
+TON_API_TONLIB_REQUEST_TIMEOUT=10
+TON_API_LOGS_JSONIFY=0
+TON_API_GUNICORN_FLAGS=
+
+SCRIPT_TAG=
+
+# do not adjust
+ENV_VERSION=1