Beş dakikada ilk imza

Hızlı başlangıç

Anahtar üretin, bir dosyayı imzalayın, doğrulayın. Özel anahtar makinenizden çıkmaz. Aynı anahtar metni de medyayı da imzalar.

# kurulum
npm install -g @jettymark/cli

# yayıncı anahtarı (açık kısmı stdout'a yazar)
jettymark keygen --issuer "Ege Haber Ajansı" --out ~/.jettymark/ege.json

# metin: her paragraf ayrı blok, abone 17 için kopya
jettymark sign --key ~/.jettymark/ege.json --doc-id haber-2026-11-01-42 \
  --recipient abone-17 --in haber.txt --out haber-imzali.txt

# görsel ya da video: aynı anahtar, aynı belge kimliği mantığı
jettymark sign-media --key ~/.jettymark/ege.json --doc-id foto-2026-11-01-7 \
  --recipient abone-17 --in foto.jpg --out foto-imzali.jpg

# doğrula (yayıncı anahtarı güven listesinde)
jettymark trust add-wellknown egehaber.example
jettymark verify --in haber-imzali.txt
✅ ORİJİNAL — Ege Haber Ajansı tarafından 01.11.2026 09:12 UTC tarihinde imzalanmış; 3 bloğun tamamı doğrulandı.
jettymark verify-media --in foto-imzali.jpg
✅ ORİJİNAL — Ege Haber Ajansı tarafından 01.11.2026 09:12 UTC tarihinde imzalanmış; içerik imzayla uyuşuyor

Node kütüphanesi

Bağımlılığı olmayan çekirdek: kanonikleştirme, taşıyıcı, çerçeve, Ed25519 imza ve doğrulama, rapor biçimlendirme. Medya için aynı paketin /media girişi (Node: sharp + ffmpeg) ve /media-web girişi (tarayıcı: canvas, kamera) vardır.

import { signText, verifyText, generateKeyPair, publicPart, formatReport } from "@jettymark/core";
import { signImage, verifyImage, signVideo, verifyVideo, formatMediaReport } from "@jettymark/core/media";

const key = generateKeyPair("Ege Haber Ajansı");
const { text, docId, blocks } = signText(article, key, { docId: "haber-42", recipient: "abone-17" });

const report = verifyText(text, [publicPart(key)]);
report.verdict      // "authentic" | "partial" | "modified" | "untrusted" | "damaged" | "unsigned"
report.frames       // blok başına: durum, belge, kid, zaman, kapsanan kelimeler
report.uncovered    // imza kapsamı dışındaki metin parçaları
formatReport(report, "tr");

// görsel: bytes | yol → imzalı dosya + rapor (güç, marjlar, işaret kimliği)
const signed = await signImage("foto.jpg", key, { docId: "foto-7", recipient: "abone-17", strength: 3 });
signed.markId       // 16 hex: kayıt defterinin anahtarı
const mr = await verifyImage(signed.bytes, [publicPart(key)]);
mr.verdict          // aynı altı sonuç; mr.reason: "cropped" | "id_only" | …
mr.content.cells    // 48 bölge (8×6): görünür mü, doygun mu, ton eğrisinden sapma (gri düzey), işaretli mi
formatMediaReport(mr, "tr");

// video: dosya yolları, 2 sn'lik parçalar, ffmpeg gerekir
await signVideo("klip.mp4", "klip-imzali.mp4", key, { docId: "video-3" });
(await verifyVideo("klip-imzali.mp4", [publicPart(key)])).video   // parça parça sonuç

Tarayıcıda import { verifyImageBlob, CameraSession } from "@jettymark/core/media-web": dosya cihazda çözülür, sunucuya yalnızca işaret kimliği ve özet değerler gider.

REST API

Sunucu tarafı imzalama ve kayıt defteri için. Doğrulama uç noktaları anonimdir ve kota gerektirmez; yüklenen dosya hiçbir zaman saklanmaz. Kimlik: Authorization: Bearer tm_live_… (kapsamlı API anahtarı). Tam sözleşme: apps/web/API.md.

Medya: hızlı başlangıç

Görseller (JPEG, PNG, WebP, en az 384 × 256 px, en fazla 50 MB) eşzamanlı imzalanır; videolar (MP4/H.264 (WebM VP9 girişi kabul edilir, çıkış MP4), en fazla 500 MB) bir iş olarak kuyruğa girer ve GET /api/v1/jobs/{id} ile izlenir. HDR, 10 bit, animasyonlu GIF/WebP, CMYK v1'de 415 ile reddedilir. Düz alanları çok geniş görseller (logo, form) öz denetimden geçemezse 422 döner: "görüntü filigran taşıyamıyor".

# 1. taslak yükle (multipart) → 201 { document }
curl -X POST https://jettymark.app/api/v1/media \
  -H "Authorization: Bearer tm_live_…" \
  -F "file=@foto.jpg" -F "title=Toplantı salonu" -F "docId=foto-2026-11-01-7"

# 2. imzala → görsel: 200 MediaSignResponse · video: 202 { jobId }
curl -X POST https://jettymark.app/api/v1/documents/doc_x/sign \
  -H "Authorization: Bearer tm_live_…" -H "Content-Type: application/json" \
  -d '{ "keyId": "key_x", "recipients": "all", "strength": 3, "maxStrength": 4 }'
# → { kind: "image", version: 1, master: { markId, url, report: { strengthUsed, marginF, marginC, fLayer } }, copies: [...] }

# tek istekte (CMS): yükle + imzala
curl -X POST https://jettymark.app/api/v1/media/sign \
  -H "Authorization: Bearer tm_live_…" \
  -F "file=@klip.mp4" -F "docId=video-2026-11-01-3" -F 'recipients=["rcp_a","rcp_b"]'
# → 202 { documentId, jobId } · GET /api/v1/jobs/{jobId} → { status, progress, result }

# imzalı dosyayı indir (abone kopyası istek anında üretilir, önbelleklenir)
curl -H "Authorization: Bearer tm_live_…" -o foto-imzali.jpg \
  "https://jettymark.app/api/v1/documents/doc_x/media/1?recipient=rcp_a&download=1"

# 3. herkese açık doğrulama (anonim, dosya saklanmaz) → MediaVerifyResult
curl -X POST https://jettymark.app/api/v1/verify/media -F "file=@foto-imzali.jpg"
# → { kind, verdict: "authentic", summary, report: { sync, frame, content: { cells } }, registry: { matched, tileDiff }, via: "server" }
# video → 202 { jobId } · GET /api/v1/verify/media/jobs/{jobId}

Cihaz anahtarıyla (anahtar sunucuda değil) imzalıyorsanız: jettymark sign-media --key cihaz.json … --register https://jettymark.app --token tm_live_… dosyayı yerelde imzalar ve yalnızca 54 baytlık başlıkları POST /api/v1/marks ile kaydeder; ya da imzalı dosyayı POST /api/v1/documents/{id}/register-media ile yükleyin, sunucu imzayı yeniden doğrular.

Medya REST API

Yeni kapsam yok: imzalama sign, okuma documents:read, iz sürme trace. Webhook document.publish yükü kind, marks[] ve strengthUsed alanlarını da taşır. Hata sözlüğü (413 boyut, 415 tür, 422 öz denetim, 429 hız, 503 ffmpeg yok) Türkçe mesajlarla API.md'de.

Medya formatı (FORMAT-MEDIA.md)

Metin formatı gibi dondurulmuştur: bütün sabitler, fazlar ve eşikler uygunluk vektörleriyle birlikte sürüm 1'de sabitlenir; değişiklik yeni bir sürüm baytı demektir. Dayanıklılık rakamları ölçüm tamamlanana kadar tasarım hedefidir (hedef · ölçüm sürüyor).

Kayıt defteri ve mobil uygulama Yakında

Kamera yolu çevrimiçidir: telefon 64 bitlik işaret kimliğini okur ve kayıt defterine sorar; sonuç TANIMLANDI olarak etiketlenir, "doğrulandı" değil. Mobil uygulama planlandı; kayıt defteri API'si ve tarayıcı prototipi (/tara, deneysel) hazır. Aynı API'yi kendi uygulamanızda kullanabilirsiniz.

# anonim cihaz jetonu (isteğe bağlı; hız sınırını yükseltir)
curl -X POST https://jettymark.app/api/v1/devices       # → { deviceToken, expiresAt }

# işaret sorgusu: yalnızca kimlikler ve ≤ 128 bit özet gider; kare, görüntü, konum gitmez
curl -X POST https://jettymark.app/api/v1/marks/lookup \
  -H "Content-Type: application/json" -H "X-Jettymark-Device: …" \
  -d '{ "markIds": ["7c1e9a04b2d35f60"], "channel": "camera",
        "capture": { "regional": "a3f0…", "visibleCells": 65535 },
        "confidence": { "rho": 0.41, "frames": 12, "psr": 9.8 } }'
# → { marks: [{ markId, found: true, publisher: { issuer, domain, kid }, document: { kind, title?, publishedAt },
#      contentMatch: "match" | "mismatch" | "unknown", verifiedOnServer: false, statement: "Bu işaret … kayıtlı; …" }] }

# tek işaret, karşılaştırmasız
curl https://jettymark.app/api/v1/marks/7c1e9a04b2d35f60
# CLI karşılığı
jettymark lookup 7c1e9a04b2d35f60

MCP sunucusu

On bir araç: jettymark_verify, jettymark_inspect, jettymark_sign, jettymark_strip, jettymark_keygen, jettymark_trust_add, jettymark_trust_list, jettymark_sign_media, jettymark_verify_media, jettymark_inspect_media, jettymark_lookup_mark. Metin araca dosya, bağlantı ya da pano üzerinden verilir: modeller metni yeniden yazarken görünmez karakterleri düşürür, bu yüzden metin modelin elinden geçmeden araca ulaşmalıdır. Medya için aynı kural: dosya yolu ya da URL verilir; asla yeniden kodlanmış, küçültülmüş ya da ekran görüntüsü alınmış kopya değil.

Anahtar yayını

Doğrulayıcılar yayıncı anahtarını alan adınızdan alır. Panel bu dosyayı üretir; siz yalnızca barındırırsınız. Anahtar iptali de aynı dosyadan duyurulur. Aynı anahtarlar metin, görsel ve video için geçerlidir.

// https://egehaber.example/.well-known/jettymark.json
{ "version": 1, "issuer": "Ege Haber Ajansı",
  "keys": [ { "kid": "26911174", "alg": "ed25519", "publicKey": "iEcrt2Nf…bWY", "created": "2026-11-01T06:00:00Z" },
            { "kid": "b02a65a8", "alg": "ed25519", "publicKey": "Qm9…x3k", "created": "2025-03-10T00:00:00Z", "revoked": "2026-09-01T00:00:00Z" } ] }

Metin formatı (FORMAT.md)

SDK durumu