Mitmachen

Vorlagen und eigene Bausteine liegen in zwei öffentlichen Repos auf GitHub. Jeder kann dort etwas beitragen:

Repo	Was drin ist	Was du beitragen kannst
bellchain-app/templates	Alle Vorlagen als JSON	Neue Vorlagen und Verbesserungen
bellchain-app/nodes	Eigene Bausteine mit Formeln, dazu die Beispiele aus dem Editor	Neue Bausteine für alle

Beide stehen unter der MIT-Lizenz. Wir sehen uns jeden Beitrag an: Eine Vorlage steht nach dem Merge mit dem nächsten Release in der Galerie der App, ein Baustein liegt im Repo für alle zum Importieren.

Du brauchst ein kostenloses Konto bei GitHub. Git und Node.js helfen, sind aber kein Muss: Alles geht auch im Browser.

Eine Vorlage beitragen

1. Chain bauen und testen. Bau die Chain im Editor und klick auf Replay starten. Gute Vorlagen melden im Replay über 90 Tage mindestens einmal und höchstens etwa 100-mal.

   

2. Exportieren. Exportieren in der Kopfzeile → Herunterladen speichert die Chain als JSON-Datei. Adressen von Webhooks und Discord bleiben dabei draußen.

   

3. Forken. Öffne bellchain-app/templates und klick oben rechts auf Fork. GitHub legt eine Kopie unter deinem Namen an.

4. Datei anlegen. In deinem Fork: Add file → Upload files, die Datei als templates/<name>.json hochladen, etwa templates/eth-rsi-rebound.json. Der Name hat Kleinbuchstaben, Ziffern und Bindestriche.

5. Texte ergänzen. Unter meta kommen Titel, Beschreibung, Schlagworte, Autor, der Text der Notiz, die Nachrichten und mindestens zwei Tipps, jeweils auf Deutsch und Englisch. Ein vollständiges Beispiel steht in der Anleitung im Repo (CONTRIBUTING.de.md). Kannst du eine Sprache nicht, schreib in beide dieselbe; beim Review übersetzen wir.

6. Prüfen. Mit Node.js 20 oder neuer im Ordner des Repos: node scripts/check.mjs templates/eth-rsi-rebound.json --lang de. Jede Meldung nennt Zeile, Stelle und was zu ändern ist. Ohne Node.js überspringst du das; der Pull Request prüft genauso.

7. Pull Request öffnen. In deinem Fork: Contribute → Open pull request. Das Formular fragt, was die Vorlage meldet und wie oft sie im Replay ausgelöst hat.

8. Prüfung auf GitHub. GitHub Actions prüft die Datei. Probleme erscheinen als Hinweise direkt in deiner Datei unter Files changed; Korrekturen auf denselben Branch, dann läuft die Prüfung neu.

9. Review. Wir testen die Vorlage mit den Beispielkursen, tragen „Im Test“ ein und mergen sie. Mit dem nächsten Release steht sie in der Galerie.

Was eine Vorlage braucht

• Märkte mit Beispielkursen, damit wir „Im Test“ ausrechnen können: BTC/USDT (15m, 1h, 4h, 1d, 1w), ETH/USDT (15m, 1h, 4h, 1d), SOL/USDT (1h, 1d) und XRP, BNB, DOGE, ADA, AVAX, LINK gegen USDT (1h), jeweils auf der Standard-Börse der Kerze.
• Eine Notiz auf dem Board, die die Idee erklärt, und eine Nachricht für jede Aktion.
• Mindestens ein Thema unter meta.tags, etwa dip, trend oder ausbruch, dazu einsteiger für Vorlagen zum Start.
• Keine Versprechen: Bellchain meldet, was du festlegst. Wörter wie „garantiert“, „Gewinn“ oder „Kaufsignal“ lehnt die Prüfung ab.
• Keine persönlichen Daten: Adressen, Tokens und Chat-IDs bleiben leer, die Notiz sagt, was einzutragen ist.

Einen eigenen Baustein beitragen

1. Baustein bauen. In der Bausteinleiste unter Eigene Bausteine auf Neuer Baustein klicken, mit einem Beispiel anfangen oder leer. Der Probelauf rechnet jeden Ausgang über 500 Stunden BTC/USDT. Wie Formeln funktionieren, steht unter Eigener Baustein.

   

2. Exportieren. Exportieren unten links im Dialog speichert den Baustein als <name>.bellchain-node.json. Unter JSON siehst du denselben Text.

   

3. Forken. Öffne bellchain-app/nodes und klick oben rechts auf Fork.

4. Datei anlegen. In deinem Fork: Add file → Upload files, die Datei als community/<name>.json hochladen. Die Kennung in der Datei ist custom.<name>, etwa custom.hull-trend in community/hull-trend.json.

5. Ergänzen. author mit deinem Namen, Name und Beschreibung auf Deutsch und Englisch, eine Erklärung unter help und Tests mit Referenzwerten (unten).

6. Prüfen. node scripts/check.mjs community/hull-trend.json --lang de prüft wie der Editor, rechnet deine Tests über die Kursdaten nach und stellt sicher, dass der Baustein nie in die Zukunft schaut.

7. Pull Request, Prüfung auf GitHub, Review: wie bei einer Vorlage. Wir rechnen deine Werte nach; nach dem Merge liegt der Baustein in community/.

Referenzwerte

Jeder Baustein bringt Tests mit, wie die offiziellen Bausteine: Einstellungen, was an den Eingängen anliegt, und erwartete Werte an ausgewählten Kerzen. Die Prüfung rechnet den Baustein über 500 Stundenkerzen BTC/USDT, die im Repo unter fixtures/ liegen, und vergleicht.

"tests": [
  {
    "name": "EMA 50",
    "settings": { "length": 50 },
    "inputs": { "price": "close" },
    "expectAt": { "48": { "out": null }, "250": { "out": 0.9740385803 } },
    "expectLast": { "out": -0.4179154069 }
  }
]

Feld	Bedeutung
settings	Werte für diesen Test; fehlende behalten ihren Standard
inputs	Eine Spalte der Kurse (open, high, low, close, volume) oder eine Formel daraus, etwa close > open für einen Signal-Eingang
expectAt	Erwartete Werte an den Kerzen 0 bis 499; -1 ist die letzte
expectLast	Erwartete Werte an der letzten Kerze
tolerance	Erlaubte Abweichung bei Zahlen, Standard 0,000001

Jeder Ausgang braucht mindestens einen erwarteten Wert: eine Zahl, true oder false, oder null, wo es noch keinen Wert gibt.

Achtung

Bestimm die Werte unabhängig, mit einer Tabellenkalkulation, einem kurzen Skript oder einem anderen Chart-Programm auf denselben Kerzen. Aus Bellchain abgeschriebene Werte beweisen nur, dass Bellchain wie Bellchain rechnet. Zum Vergleichen zeigt node scripts/check.mjs community/hull-trend.json --values, was Bellchain an deinen Test-Kerzen rechnet.

Ideen ohne fertige Chain

Du hast eine Idee, aber noch keine Chain oder keinen Baustein? Beschreib sie als Issue: Idee für eine Vorlage oder Idee für einen Baustein. Dort meldest du auch Vorlagen oder Bausteine, die falsch rechnen. Fragen und Ideen zur App kannst du in der Telegram-Gruppe stellen, Fragen zu deinem Konto gehen an support@bellchain.app.

Was mit deinem Beitrag passiert

• Er erscheint unter der MIT-Lizenz, wie alles in den beiden Repos. Dein Name bleibt in der Datei unter author.
• Kleinigkeiten passen wir beim Review selbst an, bei größeren Änderungen fragen wir nach.
• Beide Repos werden mit Bellchain abgeglichen: Beiträge übernehmen wir von dort, alles andere (die Tabellen in den READMEs, die Prüfung, die Kursdaten) kommt von uns. Ändere deshalb nur Dateien in templates/ bzw. community/.